krz/yoshi-cli

Archived

A password manager for the command line. cli password-manager terminal

Commit 45a19f18e9

45a19f18e9fc707ce7c5e289ef37ce3c598a7498

parent: fd957ba8f5

Unregistered key

Christian Cleberg <156287552+ccleberg@users.noreply.github.com> · 2024-11-07 18:33 UTC
committer: <noreply@github.com>

enhance user docs

Layout: unified · split

README.md +18 −21
@@ -5,10 +5,7 @@ allows you to manage accounts and generate random passwords containing ASCII
55letters, numbers, and punctuation (min. 8 characters) or XKCD-like passphrases
66(min. 3 words).
77
8Please note that the script is written in Python 3 - you may need to run the
9script with the `python3` command instead of `python` if your system uses a
10default of Python 2. See the Installation & Usage sections below for more
11information.
8See the Installation & Usage sections below for more information.
129
1310# Table of Contents
1411
@@ -24,7 +21,7 @@ information.
2421## PyPi
2522
2623```bash
27pip install yoshi-cli
24pipx install yoshi-cli
2825```
2926
3027## Manual
@@ -33,8 +30,8 @@ To run the script locally, run the following commands:
3330
3431```bash
3532git clone REPO_URL
36cd yoshi
37pip install .
33cd yoshi-cli
34pipx install .
3835```
3936
4037# Usage
@@ -42,7 +39,7 @@ pip install .
4239[(Back to top)](#table-of-contents)
4340
4441All commands can be passed to the program with the following template:
45`python3 src/yoshi/cli.py <COMMAND> <FLAG> <PARAMETER>`
42`yoshi <COMMAND> <FLAG> <PARAMETER>`
4643
4744![Yoshi CLI Help](./examples/yoshi-help.png)
4845
@@ -60,42 +57,42 @@ All commands can be passed to the program with the following template:
6057 </thead>
6158 <tbody>
6259 <tr>
63 <td>help</td>
64 <td>h</td>
60 <td>--help</td>
61 <td>-h</td>
6562 <td>Print the welcome message</td>
6663 </tr>
6764 <tr>
68 <td>new</td>
69 <td>n</td>
65 <td>--new</td>
66 <td>-n</td>
7067 <td>Create a new account</td>
7168 </tr>
7269 <tr>
73 <td>list</td>
74 <td>l</td>
70 <td>--list</td>
71 <td>-l</td>
7572 <td>List all saved accounts</td>
7673 </tr>
7774 <tr>
78 <td>edit</td>
79 <td>e</td>
75 <td>--edit</td>
76 <td>-e</td>
8077 <td>Edit a saved account (see below for required flags)</td>
8178 </tr>
8279 <tr>
83 <td>delete</td>
84 <td>d</td>
80 <td>--delete</td>
81 <td>-d</td>
8582 <td>Delete a saved account (see below for required flags)</td>
8683 </tr>
8784 <tr>
88 <td>purge</td>
85 <td>--purge</td>
8986 <td>N/A</td>
9087 <td>Purge all accounts and delete the vault</td>
9188 </tr>
9289 <tr>
93 <td>encrypt</td>
90 <td>--encrypt</td>
9491 <td>N/A</td>
9592 <td>Encrypt the vault database (see below for required flags)</td>
9693 </tr>
9794 <tr>
98 <td>decrypt</td>
95 <td>--decrypt</td>
9996 <td>N/A</td>
10097 <td>Decrypt the vault database (see below for required flags)</td>
10198 </tr>