command-storage 0.1.0

A command line tool to store CLI commands for quick access and usage.

command-storage [WIP]

• command-storage [WIP]
  • About
  • Features
  • Installation
  • Examples
  • Usage
    • cmds delete
    • cmds export
    • cmds init
    • cmds list
    • cmds store
    • cmds update
  • Credits

About

cmds is a command-line tool designed to store CLI commands for quick access and usage. Think of it as a simple notes app specifically tailored for storing commands using customizable keys.

Oftentimes, we find ourselves needing to store certain commands for later use. These may be commands that are not easily remembered or ones that we find useful but don't want to keep looking up. Traditionally, we might store these commands in a file and then copy and paste them into the terminal when needed. Recognizing the need for a more efficient solution, I decided to create a CLI application to streamline this process.

Features

• Store CLI commands with custom keys for easy retrieval.
• Quickly access stored commands with fuzzy search without the need to search through files.
• Organize commands based on your workflow or preferences.
• Export all commands into a JSON file.

Installation

• Using pip: pip install command-storage

Examples

Seeking help.

cmds --help

Storing some commands into the cmds.

cmds store --key "count no of files" --command "ls | wc -l" --description "count no of files in a directory"
cmds store --key "run python test with cov" --command "pytest --cov --cov-report term --cov-report xml:coverage.xml" --description "pytest with cov"

Viewing all commands stored in cmds.

cmds list

Usage

cmds [OPTIONS] COMMAND [ARGS]...

Options:

• -v, --version: Show cmds version.
• --help: Show this message and exit.

Commands:

• delete: Allows deletion of stored command by key
• export: Exports all stored commands into a JSON file.
• init: Initialize the application.
• list: Show list of all stored commands.
• store: Store a new command into cmds.
• update: Allows updating a stored command by its key.

cmds delete

Allows deletion of stored command by key

Usage:

cmds delete [OPTIONS] [KEY]

Arguments:

• [KEY]

Options:

• -a, --all: Delete all commands
• --help: Show this message and exit.

cmds export

Exports all stored commands into a JSON file.

Usage:

cmds export [OPTIONS]

Options:

• -f, --file TEXT: Export file address with extension [default: command_storage_export_2024-02-28 19:37:47.575256.json]
• --help: Show this message and exit.

cmds init

Initialize the application. One time process and overwrites existing config and data files.

Args: db_path (str, optional): --db-path argument. Defaults to_INITIAL_DB_PATH.

Raises: typer.Exit: If error in app initialization typer.Exit: if error in database file initialization

Usage:

cmds init [OPTIONS]

Options:

• -db, --db-path TEXT: [default: /Users/ashutosh/.ashutosh_cmds.json]
• --help: Show this message and exit.

cmds list

Show list of all stored commands. Also supports fuzzy matching on key. Run 'cmds list --help' to see how.

Usage:

cmds list [OPTIONS]

Options:

• -k, --key TEXT: Key for the command.
• --help: Show this message and exit.

cmds store

Store a new command into cmds by giving a helpful key name to refer to.

Usage:

cmds store [OPTIONS]

Options:

• -k, --key TEXT: Key for the command. [required]
• -c, --command TEXT: Command to be stored. [required]
• -des, --description TEXT: Description of command to be stored.
• --help: Show this message and exit.

cmds update

Allows updating a stored command by its key. Also supports changing the key.

Usage:

cmds update [OPTIONS] ORIG_KEY

Arguments:

• ORIG_KEY: [required]

Options:

• -k, --key TEXT: Key for the command.
• -c, --command TEXT: Command to be stored.
• -des, --description TEXT: Description of command to be stored.
• --help: Show this message and exit.

Credits

• This is my first CLI based application and Real Python's article helped a lot.
• Built with ❤️ using Typer.
• Fuzzy Matching logic: TheFuzz.
• Printing in tabular format: tabulate