General-purpose command-line interface with plugins support
Project description
Multitool is a general-purpose command-line interface with plugins support.
Usage: multitool [OPTIONS] COMMAND [ARGS]...
Welcome to the Multitool command-line interface!
PyPI: https://pypi.org/project/multitool/
GitHub: https://github.com/mdelotavo/multitool
Options:
-V, --version Show the version and exit.
-h, --help Show this message and exit.
Commands:
plugins Simple plugins manager for distributing commands.
Why does this exist?
I use it to quickly create and distribute command-line tools for consulting work and personal use. The plugins manager uses Git to promote GitOps practices. Git is used to manage plugins installed from remote Git repositories. If Git is unavailable, then the plugins commands will not be available. However, it is possible to manually install plugins by dragging them into the correct locations.
Managing plugins
The simple plugins manager uses Git to install commands from remote sources, thus you will need to have Git installed for installation to work. However, it is possible to install plugins manually by storing plugins in the correct location (to be documented).
Currently, only the commands shown below are supported. More commands will be added to improve automation and user experience.
The steps below show how to install commands from a public plugins repository.
Configuring
To configure remote sources for installing plugins, run:
multitool plugins configure -a
This will open a text editor so that you can specify the remote sources.
If you don’t want changes to be automatically applied, then you can drop the -a option.
When the editor opens, copy and paste the following example configuration:
[sources] public = https://github.com/mdelotavo/multitool-plugins.git
After saving the changes, the CLI will attempt to install the plugins from the specified Git URI. Here we use the HTTPS URI but you can also use SSH if you have configured it.
You can also specify multiple sources, as long as the key (public in this case) is unique. The key will be the name of the repository on your local machine under ~/.multitool/plugins/.
If installation is successful, you should now see additional commands when you run multitool -h
Updating
If you specified the -a option when running multitool plugins configure then install will occur automatically. Otherwise you can run:
multitool plugins update
This will install and update plugins.
Pruning
If you specified the -a option when running multitool plugins configure then the removal of plugins will occur automatically. Otherwise you can run:
multitool plugins prune
Showing
To show the plugins you have configured, run:
multitool plugins show
You can also run the following commands if you specify the plugin name:
multitool plugins show -n PLUGIN_NAME --show-commit-only multitool plugins show -n PLUGIN_NAME --show-dependencies-only
Some plugins will not load if dependencies are not installed. You can run the following command to install them. In order for this to work, the plugin needs to have the Requires key in the JSON body of the multitool-info.json file. More details coming soon.:
pip3 install $(multitool plugins show -n PLUGIN_NAME --show-dependencies-only)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for multitool-0.3.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 12ac509b9528f7ac7a26d512f585a37dcae0e96a1bbb23b4cb1433b615a6213f |
|
MD5 | 5dfe4447d18ef581d9ae1ecaf5439534 |
|
BLAKE2b-256 | 97a2c89f22f4de8b6dd33afb08ab9832626662eef864c3b84a368e3d38c3488d |