Skip to main content

CLI Todo app made with typer, sqlite and a REST API

Project description

todo-cli-tddschn

A simple command-line Todo app made with typer, sqlite and a REST API.

Features

  • Creating, reading, updating, and deleting todos;
  • Nicely formatting the outputs (with color);
  • todo ls lists all todos, ordered by priority and due date, the todos without a due date are put last (nullslast).
  • Not only the command line interface - you can also CRUD your todos by making HTTP requests to the REST API.

Install

pipx (recommended)

pipx install todo-cli-tddschn

pip

pip install todo-cli-tddschn

Usage

todo

You can add, modify, or remove (all) todos with the todo command:

todo --help

Usage: todo [OPTIONS] COMMAND [ARGS]...

  tddschn's command line todo app

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:
  a        Add a new to-do with a DESCRIPTION.
  clear    Remove all to-dos.
  config   Getting and managing the config
  g        Get a to-do by ID.
  info     Get infos about todos
  init     Initialize the to-do database.
  ls       list all to-dos, ordered by priority and due date.
  m        Modify a to-do by setting it as done using its TODO_ID.
  re-init  Re-initialize the to-do database.
  rm       Remove a to-do using its TODO_ID.

todo ls

List and filter the todos.

todo ls --help

Usage: todo ls [OPTIONS] COMMAND [ARGS]...

  list all to-dos, ordered by priority and due date.

Options:
  -d, --description TEXT
  -p, --priority [low|medium|high]
  -s, --status [todo|done|deleted|cancelled|wip]
  -pr, --project TEXT
  -t, --tags TEXT
  -dd, --due-date [%Y-%m-%d|%Y-%m-%dT%H:%M:%S|%Y-%m-%d %H:%M:%S]
  --help                          Show this message and exit.

Commands:
  project  Filter to-dos by project.
  tag      Filter to-dos by tag.

todo serve

Serve the REST API (built with FastAPI)

todo serve --help
Usage: todo serve [OPTIONS]

  serve REST API. Go to /docs for interactive documentation on API usage.

Options:
  --host TEXT       [default: 127.0.0.1]
  --port INTEGER    [default: 5000]
  --log-level TEXT  [default: info]
  --help            Show this message and exit.

todo config

Get or edit the configurations

todo config --help

Usage: todo config [OPTIONS] COMMAND [ARGS]...

  Getting and managing the config

Options:
  --help  Show this message and exit.

Commands:
  db-path  Get the path to the to-do database.
  edit     Edit the config file. # Opens in default editor
  path     Get the path to the config file.

todo info

Get the info and stats about the todos.

todo info --help

Usage: todo info [OPTIONS] COMMAND [ARGS]...

  Get infos about todos

Options:
  --help  Show this message and exit.

Commands:
  count  Get todo counts

Why do you made this?

For practicing my python and SQL skills.

If you're looking for an awesome CLI todo app, try taskwarrior.

SQLite database schema

schema

Screenshots

screenshot

screenshot-2

todo-serve

api-docs

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

todo-cli-tddschn-1.0.1.tar.gz (12.7 kB view details)

Uploaded Source

Built Distribution

todo_cli_tddschn-1.0.1-py3-none-any.whl (14.7 kB view details)

Uploaded Python 3

File details

Details for the file todo-cli-tddschn-1.0.1.tar.gz.

File metadata

  • Download URL: todo-cli-tddschn-1.0.1.tar.gz
  • Upload date:
  • Size: 12.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.13 CPython/3.10.4 Darwin/21.5.0

File hashes

Hashes for todo-cli-tddschn-1.0.1.tar.gz
Algorithm Hash digest
SHA256 5daf79a9b9f3bdd906db201b02b6f7ab6d45760d5619fa84178edf8d815e66c8
MD5 2b517faf29698b909c0d9026e51a09e8
BLAKE2b-256 2c7d520cf994a4711c812e15aaa8b7767c590e5d772f3c472f9a384ddd5eb0ff

See more details on using hashes here.

File details

Details for the file todo_cli_tddschn-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: todo_cli_tddschn-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 14.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.13 CPython/3.10.4 Darwin/21.5.0

File hashes

Hashes for todo_cli_tddschn-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 77b1eca1f4a4378b728eabf371d5a2ec08f71f667c90579bae509415c16c17e3
MD5 b94a69abc5aae316701d5247ace44b15
BLAKE2b-256 be0ae8a8bd43856d25aced2812a334c2a1d7d68b75bda08852315ebf356ad799

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page