Skip to main content

Simple file-backed to-do CLI

Project description

To-Do List CLI (Python)

Minimal, file-backed to-do list CLI.

Install locally (editable) to get a todo command:

python -m pip install -e .

Then run:

todo add "Write report"
todo list
todo complete 0
todo remove 0
todo clear

Add with a due date:

todo add "Finish budget" --due 2026-02-15
todo add "Call client" --due tomorrow

If todo is not found, ensure your Python's Scripts directory is on your PATH (Windows) or use the same Python executable: python -m todo.

Run tests:

python -m pip install -r requirements.txt
python -m pytest -q

Publishing to PyPI

Quick outline to publish a release (recommended: use GitHub Actions):

  1. Create an account on https://pypi.org/ and generate an API token at https://pypi.org/manage/account/
  2. In your GitHub repo, add the token as a repository secret named PYPI_API_TOKEN.
  3. Create a git tag for the release (match pattern vX.Y.Z) and push it:
git tag v0.1.0
git push origin v0.1.0

The included GitHub Actions workflow .github/workflows/publish.yml will build and publish the package automatically when a tag is pushed or a release is created.

Local publish (if you prefer to upload from your machine):

Windows PowerShell:

setx PYPI_API_TOKEN "<token>"
.\.venv\Scripts\Activate.ps1
./scripts/publish_local.ps1

Linux / macOS:

export PYPI_API_TOKEN="<token>"
./scripts/publish_local.sh

Notes:

  • The GitHub Action expects a secret named PYPI_API_TOKEN containing a PyPI API token.
  • Publishing requires that the name and version in pyproject.toml are ready for release and not already on PyPI.
  • I cannot publish to PyPI for you without your PyPI token and pushing tags to a remote repo; I added automation so the upload is a single secure step once you provide the token in GitHub secrets.

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_scolhoun-0.1.5.tar.gz (4.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

todo_cli_scolhoun-0.1.5-py3-none-any.whl (4.6 kB view details)

Uploaded Python 3

File details

Details for the file todo_cli_scolhoun-0.1.5.tar.gz.

File metadata

  • Download URL: todo_cli_scolhoun-0.1.5.tar.gz
  • Upload date:
  • Size: 4.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for todo_cli_scolhoun-0.1.5.tar.gz
Algorithm Hash digest
SHA256 85caf8afd03473761407a35f1b9a4bc5f3554b8f09f62a6c2d1ed3fe2521d11e
MD5 552fe3e1d0de217ca66f9ed1159b4637
BLAKE2b-256 94f4f93d68796eb8d87812e75fada8acdbeb73aa414684601a5d10cc52cc2c08

See more details on using hashes here.

File details

Details for the file todo_cli_scolhoun-0.1.5-py3-none-any.whl.

File metadata

File hashes

Hashes for todo_cli_scolhoun-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 a1c94b39c69e53d120f5a9dc36cb2e4f35a14d7febf285504428df8b782423b5
MD5 31ff6c7f24819f22cc539edff5a28583
BLAKE2b-256 1ad4528cf5bb6b2c2be6488105610d0d3ccf7f82c4d00cffa4be14eca7ce04e8

See more details on using hashes here.

Supported by

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