```
_ _ _ _ _
___ _ __ ___ __| | ___| |__ ___ __ _| |_ ___| |__ ___ ___| |_
/ __| '_ ` _ \ / _` |/ __| '_ \ / _ \/ _` | __/ __| '_ \ / _ \/ _ \ __|
| (__| | | | | | (_| | (__| | | | __/ (_| | |_\__ \ | | | __/ __/ |_
\___|_| |_| |_|\__,_|\___|_| |_|\___|\__,_|\__|___/_| |_|\___|\___|\__|
```
Is a terminal command tool 🖥 that helps to store commands you don't want to keep in the head ðŸ§
#### Help command
```bash
cmdcheatsheet -h
```
or:
```bash
cmdcheatsheet --help
```
here is the output:
```
--commands, -c - Display all commands.
--commands-info, -ci - Display all commands, including all details such as ids, etc., all commands.
--commands-table, -ct - Display all commands using a table view.
--add <command> <description>, -a <command> <description> - Add new command to the list.
--update <id> <name> <description>, -u <id> <name> <description> - Update a <command> by id.
--delete <id>, -d <id> - Delete a <command> by id.
--find <command>, -f <command> - Search for a command.
--find-info <command>, -fi <command> - Search for a command and include all details, such as ids, etc.
--global-find <command>, -gf <command> - Global search.
--detailed-global-find <command>, -gfi <command> - Search globally for a command and include all details, such as ids, etc.
--find-table <command>, -ft <command> - Search for a command and show it using a table view.
--available-command-names <number_of_columns:optional>, -acn <number_of_columns:optional> - Show all stored command names.
--version, -v - Display version.
--help, -h - Show a program help notes.
--display-available-configs, -dac - Display available configurations.
--display-configs <key:optional>, -dc <key:optional> - Display configurations.
--remove-config <key>, -rc <key> - Remove a config.
--set-config <key> <value>, -sc <key> <value> - Set config.
--set-config-to-default, -sctd - Set the configuration to default.
--set-single-config-to-default <key>, -ssctd <key> - Set a single configuration to default.
--add-alternative-store <store_name> <store_location>, -aas <store_name> <store_location> - Add alternative commands store (JSON file) location.
--delete-alternative-store <store_name>, -das <store_name> - Delete alternative commands store (JSON file).
--display-applied-alternative-store-name, -daasn - Display the name of applied alternative store.
--display-available-alternative-stores, -daas - Display available alternative stores.
--switch-to-alternative-store <store_name>, -stas <store_name> - Switch to alternative store location.
--update-alternative-store <store_name> <store_location>, -uas <store_name> <store_location> - Update alternative commands store (JSON file).
```
#### Add command
```bash
cmdcheatsheet -a <command> <command_description>
```
for example:
```bash
cmdcheatsheet -a "ls" "List directory content"
```
#### Display commands
Display all commands:
```bash
cmdcheatsheet -c
```
or:
```bash
cmdcheatsheet
```
Display commands along with ids:
```
cmdcheatsheet -ci
```
Display commands using table view:
```bash
cmdcheatsheet -ct
```
#### Search for a command
```bash
cmdcheatsheet -f <command>
```
Search for a command and show it along with an id:
```bash
cmdcheatsheet -fi <command>
```
Search for a command and show it using the table view:
```bash
cmdcheatsheet -ft <command>
```
Global search includes search by command or description:
```bash
cmdcheatsheet -gf <query>
```
Global search and show it along with an id:
```bash
cmdcheatsheet -gfi <query>
```
#### Update command
```bash
cmdcheatsheet -u <command_id> <command> <command_description>
```
#### Remove command
```bash
cmdcheatsheet -d <command_id>
```
#### Show all command names
```bash
cmdcheatsheet -acn
```
# Configuration
cmdcheatsheet configuration folder is located at `~/.config/cmdcheatsheet`.\
The config is called `config.json`
#### Available configurations
* `currentStoreLocation` - Path to file in JSON format that consists of the command list.
* `alternativeStores` - Path list to JSON files that might be used as an alternative commands store location.
Every item in the list has a `storeName` property, which is just a store name and the second property is `storeLocation`, responsible for the path to the commands store (JSON file location).
Here is a `config.json` example:
```json
{
"currentStoreLocation": "/Users/myusername/.config/cmdcheatsheet/commands.json",
"alternativeStores": [
{
"storeName": "unix",
"storeLocation": "/Users/myusername/my-configs/cmdcheatsheet/unix_commands.json"
},
{
"storeName": "windows",
"storeLocation": "/Users/myusername/my-configs/cmdcheatsheet/windows_commands.json"
}
]
}
```
#### Display configuration
```bash
cmdcheatsheet -dc
```
or display configuration by key:
```bash
cmdcheatsheet -dc <config_key>
```
#### Display available configs
This command displays all available configurations. Each command consists of a key and an explanation.
```bash
cmdcheatsheet -dac
```
#### Set config
```bash
cmdcheatsheet -sc <configuration_key> <configuration_value>
```
#### Remove configuration by key
```bash
cmdcheatsheet -rc <config_key>
```
#### Set configuration to default
```bash
cmdcheatsheet -sctd
```
#### Set a single config value
```bash
cmdcheatsheet -ssctd <configuration_key>
```
# Alternative commands stores
It's possible to have multiple command stores and switch between them.
In this way, you'll be able to have separate configs for windows, Linux, and OSX, or in case you want to split the config in some other way.
This feature is called alternative command stores.
### Add alternative commands store
```bash
cmdcheatsheet -aas <store_name> <store_location>
```
### Update alternative commands store
```bash
cmdcheatsheet -uas <store_name> <store_location>
```
### Delete alternative commands store
```bash
cmdcheatsheet -das <store_name>
```
### Display available alternative stores
```bash
cmdcheatsheet -daas
```
### Switch to alternative commands store
```bash
cmdcheatsheet -stas <store_name>
```
### Display applied alternative store name
```bash
cmdcheatsheet -daasn
```
### Dependencies
**Note:** that will include **[Rich](https://rich.readthedocs.io/)**.
Rich is a library to display information on the terminal, it is required, and when installed, it's deeply integrated into **cmdcheatsheet** to display beautiful output.
### License
This project is licensed under the terms of the MIT license.
Raw data
{
"_id": null,
"home_page": "https://github.com/obaranovskyi/cmdcheatsheet",
"name": "cmdcheatsheet",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "python,command,terminal,console,utilities",
"author": "obaranovskyi (Oleh Baranovskyi)",
"author_email": "<oleh.baranovskyi.dev.acc@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/58/29/9665931e2096ecbefe51e90950fae4c921d5421fc945da255a33c607db4d/cmdcheatsheet-0.0.48.tar.gz",
"platform": null,
"description": "\n```\n _ _ _ _ _ \n ___ _ __ ___ __| | ___| |__ ___ __ _| |_ ___| |__ ___ ___| |_ \n / __| '_ ` _ \\ / _` |/ __| '_ \\ / _ \\/ _` | __/ __| '_ \\ / _ \\/ _ \\ __|\n| (__| | | | | | (_| | (__| | | | __/ (_| | |_\\__ \\ | | | __/ __/ |_ \n \\___|_| |_| |_|\\__,_|\\___|_| |_|\\___|\\__,_|\\__|___/_| |_|\\___|\\___|\\__|\n```\nIs a terminal command tool \ud83d\udda5 that helps to store commands you don't want to keep in the head \ud83e\udde0\n\n\n\n#### Help command\n```bash\ncmdcheatsheet -h\n```\nor:\n```bash\ncmdcheatsheet --help\n```\nhere is the output:\n```\n --commands, -c - Display all commands.\n --commands-info, -ci - Display all commands, including all details such as ids, etc., all commands.\n --commands-table, -ct - Display all commands using a table view.\n --add <command> <description>, -a <command> <description> - Add new command to the list.\n --update <id> <name> <description>, -u <id> <name> <description> - Update a <command> by id.\n --delete <id>, -d <id> - Delete a <command> by id.\n --find <command>, -f <command> - Search for a command.\n --find-info <command>, -fi <command> - Search for a command and include all details, such as ids, etc.\n --global-find <command>, -gf <command> - Global search.\n --detailed-global-find <command>, -gfi <command> - Search globally for a command and include all details, such as ids, etc.\n --find-table <command>, -ft <command> - Search for a command and show it using a table view.\n --available-command-names <number_of_columns:optional>, -acn <number_of_columns:optional> - Show all stored command names.\n --version, -v - Display version.\n --help, -h - Show a program help notes.\n --display-available-configs, -dac - Display available configurations.\n --display-configs <key:optional>, -dc <key:optional> - Display configurations.\n --remove-config <key>, -rc <key> - Remove a config.\n --set-config <key> <value>, -sc <key> <value> - Set config.\n --set-config-to-default, -sctd - Set the configuration to default.\n --set-single-config-to-default <key>, -ssctd <key> - Set a single configuration to default.\n --add-alternative-store <store_name> <store_location>, -aas <store_name> <store_location> - Add alternative commands store (JSON file) location.\n --delete-alternative-store <store_name>, -das <store_name> - Delete alternative commands store (JSON file).\n --display-applied-alternative-store-name, -daasn - Display the name of applied alternative store.\n --display-available-alternative-stores, -daas - Display available alternative stores.\n --switch-to-alternative-store <store_name>, -stas <store_name> - Switch to alternative store location.\n --update-alternative-store <store_name> <store_location>, -uas <store_name> <store_location> - Update alternative commands store (JSON file).\n```\n\n#### Add command\n```bash\ncmdcheatsheet -a <command> <command_description>\n```\nfor example:\n```bash\ncmdcheatsheet -a \"ls\" \"List directory content\"\n```\n\n#### Display commands\nDisplay all commands:\n```bash\ncmdcheatsheet -c\n```\nor:\n```bash\ncmdcheatsheet\n```\nDisplay commands along with ids:\n```\ncmdcheatsheet -ci\n```\nDisplay commands using table view:\n```bash\ncmdcheatsheet -ct\n```\n\n#### Search for a command\n```bash\ncmdcheatsheet -f <command>\n```\nSearch for a command and show it along with an id:\n```bash\ncmdcheatsheet -fi <command>\n```\nSearch for a command and show it using the table view:\n```bash\ncmdcheatsheet -ft <command>\n```\nGlobal search includes search by command or description:\n```bash\ncmdcheatsheet -gf <query>\n```\nGlobal search and show it along with an id:\n```bash\ncmdcheatsheet -gfi <query>\n```\n\n#### Update command\n```bash\ncmdcheatsheet -u <command_id> <command> <command_description>\n```\n\n#### Remove command\n```bash\ncmdcheatsheet -d <command_id>\n```\n\n#### Show all command names\n```bash\ncmdcheatsheet -acn\n```\n\n# Configuration\ncmdcheatsheet configuration folder is located at `~/.config/cmdcheatsheet`.\\\nThe config is called `config.json`\n\n#### Available configurations\n* `currentStoreLocation` - Path to file in JSON format that consists of the command list.\n* `alternativeStores` - Path list to JSON files that might be used as an alternative commands store location.\nEvery item in the list has a `storeName` property, which is just a store name and the second property is `storeLocation`, responsible for the path to the commands store (JSON file location).\n\nHere is a `config.json` example:\n```json\n{\n \"currentStoreLocation\": \"/Users/myusername/.config/cmdcheatsheet/commands.json\",\n \"alternativeStores\": [\n {\n \"storeName\": \"unix\",\n \"storeLocation\": \"/Users/myusername/my-configs/cmdcheatsheet/unix_commands.json\"\n },\n {\n \"storeName\": \"windows\",\n \"storeLocation\": \"/Users/myusername/my-configs/cmdcheatsheet/windows_commands.json\"\n }\n ]\n}\n```\n\n#### Display configuration\n```bash\ncmdcheatsheet -dc\n```\nor display configuration by key:\n```bash\ncmdcheatsheet -dc <config_key>\n```\n\n#### Display available configs\nThis command displays all available configurations. Each command consists of a key and an explanation.\n```bash\ncmdcheatsheet -dac\n```\n\n#### Set config\n```bash\ncmdcheatsheet -sc <configuration_key> <configuration_value>\n```\n\n#### Remove configuration by key\n```bash\ncmdcheatsheet -rc <config_key>\n```\n\n#### Set configuration to default\n```bash\ncmdcheatsheet -sctd\n```\n\n#### Set a single config value\n```bash\ncmdcheatsheet -ssctd <configuration_key>\n```\n\n# Alternative commands stores\nIt's possible to have multiple command stores and switch between them.\nIn this way, you'll be able to have separate configs for windows, Linux, and OSX, or in case you want to split the config in some other way.\nThis feature is called alternative command stores. \n\n### Add alternative commands store\n```bash\ncmdcheatsheet -aas <store_name> <store_location>\n```\n\n### Update alternative commands store \n```bash\ncmdcheatsheet -uas <store_name> <store_location>\n```\n\n### Delete alternative commands store\n```bash\ncmdcheatsheet -das <store_name>\n```\n\n### Display available alternative stores\n```bash\ncmdcheatsheet -daas\n```\n\n### Switch to alternative commands store\n```bash\ncmdcheatsheet -stas <store_name>\n```\n\n### Display applied alternative store name\n```bash\ncmdcheatsheet -daasn\n```\n\n### Dependencies\n**Note:** that will include **[Rich](https://rich.readthedocs.io/)**.\nRich is a library to display information on the terminal, it is required, and when installed, it's deeply integrated into **cmdcheatsheet** to display beautiful output.\n\n### License\n\nThis project is licensed under the terms of the MIT license.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Terminal commands cheat sheet helper",
"version": "0.0.48",
"split_keywords": [
"python",
"command",
"terminal",
"console",
"utilities"
],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "a1a753e144841daa09adcf5724069040",
"sha256": "1e4a6dd6160538f94b73b06854b1b38245d89fc7efb2026da63c1df3e57f654d"
},
"downloads": -1,
"filename": "cmdcheatsheet-0.0.48-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a1a753e144841daa09adcf5724069040",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 31185,
"upload_time": "2022-12-02T04:53:47",
"upload_time_iso_8601": "2022-12-02T04:53:47.418792Z",
"url": "https://files.pythonhosted.org/packages/8b/c5/b1c6b0d986ce960fa9ad12dff37c828f3e22b32a6f414301555ad39edd15/cmdcheatsheet-0.0.48-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "535b120b85dd26012fcde3886d197878",
"sha256": "222e923f2be95e3e737ab870bc69c8e59ef8bb3a1a7ab63baee060407ccdbd66"
},
"downloads": -1,
"filename": "cmdcheatsheet-0.0.48.tar.gz",
"has_sig": false,
"md5_digest": "535b120b85dd26012fcde3886d197878",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 17845,
"upload_time": "2022-12-02T04:53:49",
"upload_time_iso_8601": "2022-12-02T04:53:49.416547Z",
"url": "https://files.pythonhosted.org/packages/58/29/9665931e2096ecbefe51e90950fae4c921d5421fc945da255a33c607db4d/cmdcheatsheet-0.0.48.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-02 04:53:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "obaranovskyi",
"github_project": "cmdcheatsheet",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "cmdcheatsheet"
}
JSON
