Rualdi

Rust Aliasing Directory

Table of contents

• Introduction
• Examples
• Getting started
  • Installing rualdi
  • Adding rualdi to your shell
  • bash
  • zsh
• Configuration
  • init flags
  • Environment variables

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

```sh 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

sh cargo install rualdi -f

From source

sh cargo build --release cp target/release/rualdi <path> Where <path> is the path where you store your binaries.

On Debian

From source

sh 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:

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

Other (via precompiled binary)

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:

sh eval "$(rualdi init bash)"

zsh

Add the following line to your ~/.zshrc:

sh 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.