2 releases

0.1.1 Nov 22, 2020
0.1.0 Sep 24, 2020

#1428 in Command line utilities

28 downloads per month
Used in rualdi

AGPL-3.0-or-later

27KB
712 lines

Rualdi

Rust Aliasing Directory

Table of contents

Introduction

Rualdi allows you to create aliases on directories and to provide an encapsulation of the built-in cd command function for easy change of working directory.

Inspired by zoxide code.

Examples

rada workdir                     # Add current directory with workdir as alias
rada www /var/www                # Add /var/www directory with www as alias
rada stuff ~/stuff               # Works with home tild alias

rad www/some-site                # Perform cd in /var/www/some-site
rad -                            # Go back to previous directory as cd do it

radr workdir                     # Remove workdir alias
radr www stuff                   # Works with multiple aliases at same time

radl                             # List aliases

Getting started

Step 1: Installing rualdi

From Cargo registry

cargo install rualdi -f

From source

cargo build --release
cp target/release/rualdi <path>

Where <path> is the path where you store your binaries.

On Debian

From source
cargo install cargo-deb
cargo deb
sudo dpkg -i /target/debian/rualdi_<version>_<arch>.deb
From .deb prebuilt released

You can download a precompiled .deb package from the releases page and add run:

sudo dpkg -i /target/debian/rualdi_<version>_<arch>.deb

Other (via precompiled binary) GitHub releases

Alternatively, you can also download a precompiled binary from the releases page and add it to your PATH.

Step 2: Adding rualdi to your shell

Currently only bash and zsh are supported.

bash

Add the following line to your ~/.bashrc:

eval "$(rualdi init bash)"

zsh

Add the following line to your ~/.zshrc:

eval "$(rualdi init zsh)"

Configuration

init flags

  • --cmd: change the rad command (and corresponding aliases) to something else.

Environment variables

  • $_RAD_ALIASES_DIR: directory where rualdi will store its aliases configuration file (default: platform-specific; see the dirs documentation for more information)
  • $_RAD_NO_ECHO: when set to 1, rad will not print the matched directory before navigating to it
  • $_RAD_RESOLVE_SYMLINKS: when set to 1, rad will resolve symlinks before print the matched directory.

Dependencies

~1–1.6MB
~36K SLoC