Skip to main content

Linux bash alias generator

Project description

topalias

Build Status Coverage GitLab pipeline Python Version

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

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

generated bash aliases

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 usage statistic
  • add any acronym algorithm
  • more statistics & analytics (used dir, utils, parameters, time)
  • 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/

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

topalias-1.2.12.tar.gz (14.0 kB view details)

Uploaded Source

Built Distributions

topalias-1.2.12-py3-none-any.whl (13.6 kB view details)

Uploaded Python 3

topalias-1.2.12-py2.py3-none-any.whl (8.4 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file topalias-1.2.12.tar.gz.

File metadata

  • Download URL: topalias-1.2.12.tar.gz
  • Upload date:
  • Size: 14.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.24.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.8.6

File hashes

Hashes for topalias-1.2.12.tar.gz
Algorithm Hash digest
SHA256 f776f58d06f8e91723cc02dc7b41c0ec5190e5ffc330482ce3069c64f965202f
MD5 98fd75351858a41e21be049c61d1a9fb
BLAKE2b-256 2606d2f22bfa3b0081700b66319ed7383939ab36159dcee158723f40f183b39c

See more details on using hashes here.

File details

Details for the file topalias-1.2.12-py3-none-any.whl.

File metadata

  • Download URL: topalias-1.2.12-py3-none-any.whl
  • Upload date:
  • Size: 13.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.24.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.8.6

File hashes

Hashes for topalias-1.2.12-py3-none-any.whl
Algorithm Hash digest
SHA256 382b72e41a15c0c52bb9bd6872fa9960f0f1926eae746c581c2852db8df94370
MD5 697ec5bc3b0c354921a1739618eaf1d7
BLAKE2b-256 4a555fa1ee3ab818781bc79b13b48cec1b0f42d7b6266c413c515c1ccc5c1cc0

See more details on using hashes here.

File details

Details for the file topalias-1.2.12-py2.py3-none-any.whl.

File metadata

  • Download URL: topalias-1.2.12-py2.py3-none-any.whl
  • Upload date:
  • Size: 8.4 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.24.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.8.6

File hashes

Hashes for topalias-1.2.12-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 ef2e248ad58aa92b714a9906834b20cf93ec597d849304780536cd494570183e
MD5 8ddbb91344825668d3583797296df38f
BLAKE2b-256 96d8e304d1531a77578e379fd647fb99fb93a906d2a7c8f978b021c4742a450a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page