diff --git a/CHANGELOG.md b/CHANGELOG.md index 55a95b7..24a1580 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,11 +6,12 @@ page. See [DEVELOPMENT_CYCLE.md](DEVELOPMENT_CYCLE.md) for more details. ## [Unreleased] - Add wallet subcommand `config` to save wallet configs - Add `wallets` command to list all wallets saved configs +- Added `completions` subcommand to generate shell completions ## [2.0.0] - Removed MSRV and bumped Rust Edition to 2024 -- Add `--pretty` flag for formatting outputs in human-readable form +- Added `--pretty` flag for formatting outputs in human-readable form - Updated `bdk_wallet ` to `2.1.0`, `bdk_bitcoind_rpc` to `0.21.0`, `bdk_esplora` to `0.22.1`, `bdk_kyoto` to `0.13.1` - Updated `tracing-subscriber` to 0.3.20 - Added `tr` script type to `compile` command to support creating taproot descriptors diff --git a/Cargo.lock b/Cargo.lock index 562d768..4fac7da 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -203,6 +203,7 @@ dependencies = [ "bdk_redb", "bdk_wallet", "clap", + "clap_complete", "cli-table", "dirs", "env_logger", @@ -721,6 +722,15 @@ dependencies = [ "strsim", ] +[[package]] +name = "clap_complete" +version = "4.5.64" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "4c0da80818b2d95eca9aa614a30783e42f62bf5fdfee24e68cfb960b071ba8d1" +dependencies = [ + "clap", +] + [[package]] name = "clap_derive" version = "4.5.49" diff --git a/Cargo.toml b/Cargo.toml index b7d610a..cf6bd78 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -14,6 +14,7 @@ license = "MIT" [dependencies] bdk_wallet = { version = "2.1.0", features = ["rusqlite", "keys-bip39", "compiler", "std"] } clap = { version = "4.5", features = ["derive","env"] } +clap_complete = "4.5" dirs = { version = "6.0.0" } env_logger = "0.11.6" log = "0.4" diff --git a/README.md b/README.md index d905197..e373722 100644 --- a/README.md +++ b/README.md @@ -228,6 +228,14 @@ cargo run -- --pretty -n signet wallet -w {wallet_name} balance ``` This is available for wallet, key, repl and compile features. When ommitted, outputs default to `JSON`. +## Shell Completions + +`bdk-cli` supports generating shell completions for Bash, Zsh, Fish, Elvish, and PowerShell. For setup instructions, run: + +```shell +bdk-cli completions --help +``` + ## Saving and using wallet configurations The `wallet config` sub-command allows you to save wallet settings to a `config.toml` file in the default directory (`~/.bdk-bitcoin/`) or custom directory specified with the `--datadir` flag. This eliminate the need to repeatedly specify descriptors, client types, and other parameters for each command. Once configured, you can use any wallet command by simply specifying the wallet name. All other parameters are automatically loaded from the saved configuration. diff --git a/src/commands.rs b/src/commands.rs index 14ad9ea..b45bae2 100644 --- a/src/commands.rs +++ b/src/commands.rs @@ -18,6 +18,7 @@ use bdk_wallet::bitcoin::{ bip32::{DerivationPath, Xpriv}, }; use clap::{Args, Parser, Subcommand, ValueEnum, value_parser}; +use clap_complete::Shell; #[cfg(any(feature = "electrum", feature = "esplora", feature = "rpc"))] use crate::utils::parse_proxy_auth; @@ -127,7 +128,62 @@ pub enum CliSubCommand { }, /// List all saved wallet configurations. Wallets, + /// Generate tab-completion scripts for your shell. + /// + /// The completion script is output on stdout, allowing you to redirect + /// it to a file of your choosing. Where you place the file will depend + /// on your shell and operating system. + /// + /// Here are common setups for supported shells: + /// + /// Bash: + /// + /// Completion files are commonly stored in + /// `~/.local/share/bash-completion/completions` for user-specific commands. + /// Run the commands: + /// + /// $ mkdir -p ~/.local/share/bash-completion/completions + /// $ bdk-cli completions bash > ~/.local/share/bash-completion/completions/bdk-cli + /// + /// Zsh: + /// + /// Completion files are commonly stored in a directory listed in your `fpath`. + /// Run the commands: + /// + /// $ mkdir -p ~/.zfunc + /// $ bdk-cli completions zsh > ~/.zfunc/_bdk-cli + /// + /// Make sure `~/.zfunc` is in your fpath by adding to your `.zshrc`: + /// + /// fpath=(~/.zfunc $fpath) + /// autoload -Uz compinit && compinit + /// + /// Fish: + /// + /// Completion files are commonly stored in + /// `~/.config/fish/completions`. Run the commands: + /// + /// $ mkdir -p ~/.config/fish/completions + /// $ bdk-cli completions fish > ~/.config/fish/completions/bdk-cli.fish + /// + /// PowerShell: + /// + /// $ bdk-cli completions powershell >> $PROFILE + /// + /// Elvish: + /// + /// $ bdk-cli completions elvish >> ~/.elvish/rc.elv + /// + /// After installing the completion script, restart your shell or source + /// the configuration file for the changes to take effect. + #[command(verbatim_doc_comment)] + Completions { + /// Target shell syntax + #[arg(value_enum)] + shell: Shell, + }, } + /// Wallet operation subcommands. #[derive(Debug, Subcommand, Clone, PartialEq)] pub enum WalletSubCommand { diff --git a/src/handlers.rs b/src/handlers.rs index 2138e4c..3f867dd 100644 --- a/src/handlers.rs +++ b/src/handlers.rs @@ -46,6 +46,7 @@ use bdk_wallet::{ descriptor::{Descriptor, Legacy, Miniscript}, miniscript::{Tap, descriptor::TapTree, policy::Concrete}, }; +use clap::CommandFactory; use cli_table::{Cell, CellStruct, Style, Table, format::Justify}; use serde_json::json; @@ -1423,6 +1424,16 @@ pub(crate) async fn handle_command(cli_opts: CliOpts) -> Result { let descriptor = handle_descriptor_command(cli_opts.network, desc_type, key, pretty)?; Ok(descriptor) } + CliSubCommand::Completions { shell } => { + clap_complete::generate( + shell, + &mut CliOpts::command(), + "bdk-cli", + &mut std::io::stdout(), + ); + + Ok("".to_string()) + } }; result }