Python CLI Stub - PROJECT_FULLNAME is a command-line interface application built with Typer to help you start a new CLI app with some basic functionality quickly
To run PROJECT_FULLNAME, you need to run the following steps:
- Download the application's source code to a
PROJECT_SHORTNAME
directory - Run sh rename.sh "Projects Full Name" "project-executable-name"
- Create a Python virtual environment and activate it
$ cd PROJECT_SHORTNAME/
$ python -m venv ./venv
$ source venv/bin/activate
(venv) $
- Install the dependencies
(venv) $ python -m pip install -r requirements.txt
- Initialize the application
(venv) $ python -m PROJECT_SHORTNAME init
This command asks you to introduce the file path to store the application's database. You can also accept the default file path by pressing enter.
Once you've download the source code and run the installation steps, you can run the following command to access the application's usage description:
$ python -m PROJECT_SHORTNAME --help
Usage: PROJECT_SHORTNAME [OPTIONS] COMMAND [ARGS]...
Options:
-v, --version Show the application's version and exit.
--install-completion Install completion for the current shell.
--show-completion Show completion for the current shell, to copy it or
customize the installation.
--help Show this message and exit.
Commands:
add Add a new to-do with a DESCRIPTION.
clear Remove all to-dos.
complete Complete a to-do by setting it as done using its TODO_ID.
init Initialize the to-do database.
list List all to-dos.
remove Remove a to-do using its TODO_ID.
You can also access the help message for specific commands by typing the command and then --help
. For example, to display the help content for the add
command, you can run the following:
$ python -m PROJECT_SHORTNAME add --help
Usage: PROJECT_SHORTNAME add [OPTIONS] DESCRIPTION...
Add a new to-do with a DESCRIPTION.
Arguments:
DESCRIPTION... [required]
Options:
-p, --priority INTEGER RANGE [default: 2]
--help Show this message and exit.
Calling --help
on each command provides specific and useful information about how to use the command at hand.
PROJECT_FULLNAME has the following features:
Command | Description |
---|---|
init |
Initializes the application's to-do database. |
add DESCRIPTION |
Adds a new to-do to the database with a DESCRIPTION . |
list |
Lists all the to-dos in the database. |
complete TODO_ID |
Completes a to-do by setting it as done using its TODO_ID . |
remove TODO_ID |
Removes a to-do from the database using its TODO_ID . |
clear |
Removes all the to-dos by clearing the database. |
- 0.1.0
- A work in progress
Leodanis Pozo Ramos - Email: leodanis@realpython.com