/fzf-make

A command line tool that executes make target using fuzzy finder with preview window.

Primary LanguageRustMIT LicenseMIT

fzf-make is a command line tool that executes make target using fuzzy finder with preview window.

License:MIT Latest Release crates.io

[English] [Deutsch]

🛠️ Features

  • Select and execute a make target using fzf
  • Support include directive
  • (Scheduled to be developed) Support config file
  • (Scheduled to be developed) Command history

👓 Prerequisites

  • bat (In the future, we intend to make it work with cat as well, but currently it only works with bat.)

📦 Installation

macOS

Homebrew

You don't need to install bat because fzf-make will install it automatically via Homebrew.

# install
brew tap kyu08/tap
brew install kyu08/tap/fzf-make
# update 
brew update
brew upgrade fzf-make

Arch Linux

fzf-make can be installed from the AUR using an AUR helper. For example:

paru -S fzf-make

NixOS / Nix (package manager)

fzf-make can be run from the repository (latest version)

nix run github:kyu08/fzf-make

Or from the nixpkgs (channel >= 23.05)

nix run nixpkgs#fzf-make

Note You may need to enable experimental feature. In that case, execute the following command to enable them echo "experimental-features = nix-command flakes" | tee ~/.config/nix/nix.conf

OS-independent method

Cargo

cargo install fzf-make

💡 Usage

Run fzf-make

  1. Execute fzf-make in the directory include makefile(file name should be one of GNUmakefile, makefile, Makefile)
  2. Select make command you want to execute

Commands

Command Output
fzf-make help.png
fzf-make --help / fzf-make -h / fzf-make help help.png
fzf-make --version / fzf-make -v / fzf-make version version.png
fzf-make --old / fzf-make -o / fzf-make old version.png
fzf-make ${some_invalid_command} invalid-arg.png

💻 Development

  1. Clone this repository
  2. Change the codes
  3. Run make run

To execute test, run make test(needs nextest). Or just run cargo test.

nix

Or you can use nix to create a developement shell with the project dependencies.

Within the repo root, execute the following command:

nix develop

👥 Contribution

  • Contributions are welcome!
  • If you have a Feature request, please create an issue first.
  • If you have added fzf-make to some package manager, please let me know. (or please send a PR to add how to install via the package manager in the README.md)
  • If you have any questions, feel free to create an issue and ask.

🗒 Related Article(s)