A set of utilities to handle various file operations like
- file backup and restore
- archive extraction
- file cleaning
- copying and pasting from and to the shell
Two distribution method are available, either:
- standalone bash scripts
- rust CLI tool
Please refer to the wiki for information on building and running the standalone bash scripts; Alternatively you can find a pre-built tarball in the releases page.
A unix binary named as dsu-X-Y-Z can be found in the releases page
where X-Y-Z is the version number. Alternatively you can build it on your own.
Ensure that the utility is executable by running the following command:
chmod +x dsu-X-Y-ZRun the utility with the --help flag to see the available options and how to use them:
./dsu-X-Y-Z --helpEach utility has its own set of options and arguments that you can see running the --help flag with the utility name:
./dsu-X-Y-Z <utility> --helpFor a breakdown of all the utilities, their options and what do they do please refer to the wiki
There are several different ways to install the utility on your system:
- copy|install the binary to a directory in your PATH
- create a symbolic link to the binary in a directory in your PATH
- install it globally to
/opt/dsuand make that directory part of your PATH
To install the utility you can copy the binary to a directory in your PATH. Common directories are:
- Single user:
~/.local/bin~/bin
- System-wide:
/usr/local/bin/usr/bin/opt
For single user:
install -Dm755 dsu-X-Y-Z ~/.local/bin/dsuOr
mkdir -p ~/.local/bin
cp dsu-X-Y-Z ~/.local/bin/dsu
chmod +x ~/.local/bin/dsuFor system-wide:
Note that you may need to run this command as root or with sudo.
install -Dm755 dsu-X-Y-Z /usr/local/bin/dsuOr
mkdir -p /usr/local/bin
cp dsu-X-Y-Z /usr/local/bin/dsu
chmod +x /usr/local/bin/dsuYou can also create a symbolic link to the binary in a directory in your PATH. This is useful if you want to keep the binary in a different directory than the one in your PATH.
For single user:
ln -s /path/to/dsu-X-Y-Z ~/.local/bin/dsuFor system-wide:
Note that you may need to run this command as root or with sudo.
ln -s /path/to/dsu-X-Y-Z /usr/local/bin/dsuAs a third option, you can install the utility globally to /opt/dsu and make that directory part of your PATH.
Note that you'll need sudo or root permissions to do this.
First, create the directory:
mkdir -p /opt/dsuThen copy the binary to the directory:
cp dsu-X-Y-Z /opt/dsu/dsu
chmod +x /opt/dsu/dsuAdd the directory to your PATH by adding the following line to your shell configuration file (e.g. ~/.bashrc, ~/.zshrc, etc.):
# Add diomeh's script utilities to PATH
export PATH="$PATH:/opt/dsu"Finally, source the shell configuration file to apply the changes:
source ~/.bashrcThis will ensure that the binary is always available at /opt/dsu/dsu no matter the version.
If you want to update the binary, simply replace the symbolic link with a new one pointing to the new one.
To uninstall the utility, simply remove the binary from the directory where you installed it.
- If you installed it to a directory in your PATH, remove the binary from that directory.
- If you created a symbolic link, remove the symbolic link.
- If you installed it to
/opt, remove the binary from/opt/dsu.- Also remove the directory from your PATH in your shell configuration file.
To build the rust CLI tool, you will need to have the rust toolchain installed on your system. Please refer to the rust website for instructions on how to install the rust toolchain.
bacon is used as the build tool for this project. To install bacon, run the following command:
cargo install baconAfterwards you can build the project by running the following command:
baconThis will build and watch for any changes in the source code and rebuild the project automatically.
For more information on how to use bacon, please refer to the bacon documentation
and the bacon config file.
Each utility is defined as a module in the src directory.
The main entry point for the CLI tool is in the src/main.rs file.
The module src/cli.rs contains the command line interface for dsu and defines
all options and arguments for both the tool itself and all the utilities.
As of now, testing has only been implemented for standalone bash scripts. Refer to the bash scripts wiki for more information on how to run the tests.
To deploy the rust CLI tool, you can run the following command:
cargo build --releaseThis will build the project in release mode and create a binary optimized for release in the target/release directory.
If you would like to contribute to this project, please fork the repository and submit a pull request.
This project is licensed under the MIT License - see the LICENSE file for details.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent