topalias 1.2.9

Linux bash alias generator

topalias

topalias - Linux bash/zsh alias generator and statistics from command history, written on Python.

Features

• Generate short alias for popular command from bash/zsh shell history
• Command history statistics & analytics
• Parametrised input
• Console help for all commands, options and arguments
• Shell workflow hints
• Fully typed with annotations and checked with mypy, PEP561 compatible

Installation

From pypi.org repository:

pip3 install -U --user topalias

From source:

git clone https://github.com/CSRedRat/topalias
python3 topalias/setup.py install --user

Run as python script without install:

git clone https://github.com/CSRedRat/topalias
python3 topalias/topalias/cli.py -h

Install requirements

sudo apt install python3 python3-pip -y

Usage

Showcase how your project can be used:

topalias # check if you uses aliases in ~/.bash_aliases - analyze and print usage statistics, offers to find new simple aliases
topalias -h # print help
topalias history # analyze local bash history
topalias h --acr=2 # set minimal length for generated acronym filter, so that exclude some short command and find long, hard, usable command

File path search order:

• .bash_history in current . directory
• .bash_history in home ~ directory
• example development files in topalias/data

Run as python module:

python3 -m topalias

Also you can use topalias utility in Bash for Git on Windows and in WSL.

TODO

• zsh support
• exclude used alias from command chart
• alias use statistic
• only util in command without parameters usage statistic
• history file path parameter
• top command count parameter
• alias max length parameter

Please add you feature requests: https://github.com/CSRedRat/topalias/issues/new

License

GPLv3

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Sergey Chudakov 💻 🚇 🤔 🚧 📦 🧑‍🏫 💡

GitLab repository mirror with CI/CD: https://gitlab.com/CSRedRat/topalias

GitHub Pages: https://csredrat.github.io/topalias/