abbtr comes as an option to the default "alias" command and it's a simple program to abbreviate long prompts in GNU/Linux terminal. You can easily set rules, delete them, list them and update them with a clear list of parameters. It should be functional in any GNU/Linux distribution.
⭐ FEATURES
-
Simplify your long commands in terminal
-
Improve your times at making repetitive tasks
-
You don't need to open any config file
-
Store, list, update and delete rules
-
Run your rules in bulk, i.e.
abbtr <rule1> <rule2> -
Import rules from a local file
-
Backup your rules to a local file
-
Feeding bottles (adding variables inside a command)
✅ PROGRAMMING LANGUAGE
abbtr is completly writen in Golang.
☑️ COMPILE YOURSELF
If you preffer to compile yourself the source code run the following commands:
git clone https://github.com/manuwarfare/abbtr.git
cd abbtr
go build -o abbtr
sudo cp abbtr /usr/bin/
Previous requirements to compile: golang ('gcc-go', 'golang-bin')
To install Golang in your system run
sudo dnf install golang or sudo apt install golang depending on your GNU/Linux distribution.
❓ HOW IT FUNCTIONS?
When you create a new rule it is saved as a bash script in ~/.local/bin and is executed every time you invoke it by its name.
📁 AFFECTED LOCATIONS
~/.config/abbtr: this directory is used to store the config file "abbtr.conf".
~/.local/share/abbtr: this directory is used to store the registry log "abbtr.log".
~/.local/bin: this directory is used to store the rule-scripts.
📝 CREATING RULES
First step after install the program is run abbtr -h to know about how the script functions. Some examples to create rules in a Fedora system terminal:
abbtr -n update "sudo dnf update -y && sudo dnf upgrade -y" this long command will run after with only type update.
abbtr -n ssh "ssh user@example.com" will connect to your SSH server only typing ssh
Running a block of rules is as easy as run abbtr <name1> <name2>. This command will run two rules continuously but you can set as many as your implementation let.
📝 IMPORTING RULES
abbtr -i <file path> will import rules from a local file.
The path must to point to a file extension, i.e: .txt, .md, .html, etc.
The stored rules must follow this syntax: b:<rule> = <command>:b
📝 EXPORTING RULES
abbtr -e will start the backup assistant.
📝 LISTING RULES
There are two options to list the rules stored in abbtr.conf file.
abbtr -l will list all the rules stored in abbtr.conf file.
abbtr -ln <name> will list an specific rule.
📝 REMOVING RULES
abbtr -r <name> will remove an specific rule.
abbtr -r a will remove all rules stored in abbtr.conf.
📝 FEEDING BOTTLES
The feeding bottles help you adding a variable inside a command. Use only one bottle for command.
The feeding bottle syntax is this b%('bottle_name')%b and you can add it into any part of the command.
Usage examples: abbtr -n ssh "ssh -p 2222 b%('username')%b@example.com"
Execute the rule with: ssh and the system will prompt this:
The username is?:
If the credentials are valid, you will get connection via ssh to example.com.
You can also predefine the value of a bottle at any time, this value will be automatically applied to all the rules when you run them in bulk, to do this use the next argument -b=<variable:value>.
Usage examples: abbtr -b=username:user1 ssh
This will run the next command: ssh -p 2222 user1@example.com
🟢 Debian
🟢 Ubuntu
🟢 Linux Mint
🟢 MX Linux
🟢 Fedora
🟢 Almalinux
🟢 RockyLinux