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 history
  • 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

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 use statistic
  • only util in command without parameters usage statistic
  • history file path parameter
  • top command count parameter
  • alias max length parameter
  • snap package
  • flatpak package

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.6.tar.gz (13.4 kB view details)

Uploaded Source

Built Distributions

topalias-1.2.6-py3-none-any.whl (13.4 kB view details)

Uploaded Python 3

topalias-1.2.6-py2.py3-none-any.whl (7.9 kB view details)

Uploaded Python 2 Python 3

File details

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

File metadata

  • Download URL: topalias-1.2.6.tar.gz
  • Upload date:
  • Size: 13.4 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.6.tar.gz
Algorithm Hash digest
SHA256 56c7af958073fa8d436ce84be66eafbbdf8cc80b6b9ad203c8d53a8edf13278f
MD5 bcf422fc0917a3ba529758f7c131f3a1
BLAKE2b-256 f874a868568f228b9a3aaa66481595060df8d05d1e8795b708ad5781a73ae0c8

See more details on using hashes here.

File details

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

File metadata

  • Download URL: topalias-1.2.6-py3-none-any.whl
  • Upload date:
  • Size: 13.4 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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 8e95193d923068b9449e5f376fb65fedc81f902342da72d4cfd6349e093e9a87
MD5 4657f93eb83bbba7929a26543b605a83
BLAKE2b-256 09ecd23b7cb9f0d767d98ab3f5f9c8b2dac3208806f61914b89f8559991968df

See more details on using hashes here.

File details

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

File metadata

  • Download URL: topalias-1.2.6-py2.py3-none-any.whl
  • Upload date:
  • Size: 7.9 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.6-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 f9b2091ea1e83a8408766a98a473dc343b0c5522c95fd683f5cf2a60c3fd046e
MD5 d162b0906228392eae88dc9e284b0349
BLAKE2b-256 bf86f946023ea084bdb2392d01890557bf39b31b6c56424b90035b75f9037ebc

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