Dhop 2.0.2: Command-line completion (finally!) πŸ”—

Dhop has been updated 2.0.2 and finally gets command-line completion!

Way back in 2013, I logged an issue for Dhop requesting command-line completion. 13 years and some months later, it finally arrives in Dhop 2.0.2!

Now that I've ported Dhop to Rust, I'm also finally getting around to fixing some things that I've left for too long...

Setting up completion πŸ”—

Once you have installed dhop, you can set up command-line completion for your shell in two steps:

  1. Run the shell-completion command:

    dhop shell-completion

    When you run the command, it will install the shell completion script, report what it did, and give you the next step:

    Generating completion script: '/home/username/.local/share/dhop/dhop.bash'
To use it, 'source' the file in your current session, or from your shell
initialization script:

source "/home/username/.local/share/dhop/dhop.bash"

  2. As the output suggests, source the file from your shell initialization script (.bashrc, .zshrc, etc.) by editing the file and adding the printed source line to it. You'll need to restart your shell to see the completions in action.

    You can also just run the source command in your current shell session, but the completions won't be available after you close it unless you also add them to your shell init script.

Other updates πŸ”—

Additional updates have been made since my initial Rust port, which are included in this version:

  • The list command now prints the list of locations, the marked path, and the stack as it used to beβ€”in plain text. If you want the JSON-formatted version of this info, you can use the new --json flag to do it.

  • Help text has been improved overall to be easier to understand, more complete, and more helpful.

  • The versions of all dependencies has been updated. Version/dependency information is now provided in the Cargo.lock <https://github.com/Abstrys/dhop/blob/main/Cargo.lock> file.

  • Under the hood, I've fixed a number of issues with my original Rust code to make it more "rusty", including better error handling throughout, and replaced use of the json crate with serde_json, which allows me to use strongly-typed values instead of the original implementation's text-only representation of the data.

Official archives for Linux πŸ”—

I've also made some "official" (meaning that I built, packaged, and am serving) archives for Dhop in .tar.gz, .tar.bz2, and .zip format for Linux. Here are the latest versions as of today:

Information about how to install using these archives is in the Dhop project README, here:

Installing Dhop on other platforms πŸ”—

To install Dhop on platforms for which there's no official archive, it can be built from source using the information on the Dhop project README, here:

Previous: Dhop reimplemented in Rust