Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mitchjeitani/catacomb
A minimalistic CLI tool for storing shell commands.
https://github.com/mitchjeitani/catacomb
cli command-line command-line-tool productivity python shell terminal
Last synced: about 2 months ago
JSON representation
A minimalistic CLI tool for storing shell commands.
- Host: GitHub
- URL: https://github.com/mitchjeitani/catacomb
- Owner: mitchjeitani
- License: mit
- Created: 2017-11-06T12:31:59.000Z (about 7 years ago)
- Default Branch: develop
- Last Pushed: 2018-07-14T05:46:51.000Z (over 6 years ago)
- Last Synced: 2024-11-02T02:05:36.079Z (2 months ago)
- Topics: cli, command-line, command-line-tool, productivity, python, shell, terminal
- Language: Python
- Homepage:
- Size: 4.62 MB
- Stars: 27
- Watchers: 2
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# catacomb
[](https://travis-ci.org/mitchjeitani/catacomb)
[](https://travis-ci.org/mitchjeitani/catacomb)
> A minimalistic CLI tool for storing shell commands.
Remembering useful commands is difficult, and typing out long commands is frustrating. Relieve these pain points with catacomb, a simple CLI tool for storing, retrieving and executing commands. Just type out the command once, and then execute it through catacomb, with an alias of your choice.
### Setup
```
$ pip3 install catacomb
```
### Usage
Two entry points are used to separate organisation of tombs and their contents. The `catacomb` entry point provides commands to deal with organisation of tombs within the catacomb. Having seperate tombs for seperate projects, as an example, would allow isolated environments - so that you're not forced to come up with new aliases that execute different commands for different projects.
```
Usage: catacomb [OPTIONS] COMMAND [ARGS]...
For handling the tombs within your catacomb. Add the flags -h or --help to
any of the commands for more information, e.g. catacomb COMMAND -h.
Options:
-h, --help Show this message and exit.
Commands:
bury Permanently buries a tomb, preventing any further use.
create Creates a new tomb in the catacomb.
list Lists the tombs currently available in the catacomb.
open Opens an existing tomb.
```
The `tomb` entry point provides commands to deal with the contents of a single tomb. Tombs act as a store for all your commands, allowing you to use and manage them by simply specifying the alias.
```
Usage: tomb [OPTIONS] COMMAND [ARGS]...
For handling the contents within a tomb. Add the flags -h or --help to any
of the commands for more information, e.g. tomb COMMAND -h.
Options:
-h, --help Show this message and exit.
Commands:
add Stores a new command in the tomb.
clean Obliterates the contents of the active tomb.
edit Opens an editor to edit a command that's already stored in the
active tomb.
list Displays all the commands available in the active tomb.
rm Removes a command from the tomb.
status Shows some general information about the active tomb.
use Executes a command, specified by its alias.
```
### Examples
Detailed usage has been documented for each command and can be viewed at the following directories:
* [Examples](examples/catacomb) for the `catacomb` entry point
* [Examples](examples/tomb) for the `tomb` entry point
### Contributing
This project is still in its infancy, so feel free to contribute by reporting issues or suggesting some new features. Pull requests are definitely welcomed!
Please be sure that any contributions follow [PEP8](https://www.python.org/dev/peps/pep-0008/) standards.