cards

Project task tracking / todo list

A Teaching Project

This project is used for teaching the concepts of software testing. Specifically, testing with the pytest test framework.

The project appears in:

The Complete pytest Course
- uses cards version 2.0.0
Python Testing with pytest, 2nd edition
- uses cards version 1.0.1 - approximately

Can be used as a simple todo list

Even though the primary goal of the project is for teaching about software testing, I also use it as a simple command line task tracker for myself and my team.

Usage

Here's a demo of how it works:

$ cards add a todo
$ cards add -o Brian another task
$ cards list

ID   state   owner   summary
───────────────────────────────────
1    todo            a todo
2    todo    Brian   another task

$ cards update 1 -o Brian

. $ cards

ID   state   owner   summary       
─────────────────────────────────── 
  1    todo    Brian   a todo        
  2    todo    Brian   another task  
                                  
$ cards start 1
$ cards
                                   
  ID   state     owner   summary       
 ───────────────────────────────────── 
  1    in prog   Brian   a todo        
  2    todo      Brian   another task 

$ cards finish 1
$ cards

  ID   state   owner   summary
 ───────────────────────────────────
  1    done    Brian   a todo
  2    todo    Brian   another task


$ cards delete 1
$ cards

  ID   state   owner   summary
 ───────────────────────────────────
  2    todo    Brian   another task

$ cards --help

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

 Cards is a small command line task tracking application.

╭─ Options ────────────────────────────────────────────────────────╮
│ --help          Show this message and exit.                      │
╰──────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────╮
│ add       Add a card to db.                                      │
│ config    List the path to the Cards db.                         │
│ count     Return number of cards in db.                          │
│ delete    Remove card in db with given id.                       │
│ finish    Set a card state to 'done'.                            │
│ list      List cards in db.                                      │
│ start     Set a card state to 'in prog'.                         │
│ update    Modify a card in db with given id with new info.       │
│ version   Return version of cards application                    │
╰──────────────────────────────────────────────────────────────────╯

Metadata

Release files for cards 2.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cards 2.0.2
File	Size	Uploaded	Provenance
cards-2.0.2.tar.gz	4.7 kB	Oct 24, 2026	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for cards 2.0.2
File	Interpreter	ABI	Platform	Reset
cards-2.0.2-py3-none-any.whl 6.0 kB Oct 24, 2026 Without provenance	Python 3	none	any	Details

Total release size: 10.7 kB

Release files / cards-2.0.2.tar.gz

Download URL	cards-2.0.2.tar.gz
Size	4.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`dd53d2465b520688f57a503ba419d8e57c45b55e354fd62c85bc44198259ceb3`
BLAKE2b-256 checksum How to use checksums	`7684acc75fd742d61d13c7f4411ff22e1a7a9a12f4ac7f30c2ac603b57849213`
Upload date	Oct 24, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`python-requests/2.34.2`

Release files / cards-2.0.2-py3-none-any.whl

Download URL	cards-2.0.2-py3-none-any.whl
Size	6.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`586e6e1c393dd5ed795cbd25bc92c4a92c385b2bd451c12cd57bc0163ef1fb3c`
BLAKE2b-256 checksum How to use checksums	`10d640113c39bfebd66825c316f61b2a74e8344e91e1546fdef32f786830cfee`
Upload date	Oct 24, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`python-requests/2.34.2`

Security for cards 2.0.2

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.