Metadata-Version: 2.4
Name: cards-against-coffee
Version: 0.1.1
Summary: A small terminal client for the Cards Against Coffee API
Project-URL: Homepage, https://github.com/BytesAndCoffee/cards-against-coffee
Project-URL: Documentation, https://github.com/BytesAndCoffee/cards-against-coffee#readme
Author: Cards Against Coffee contributors
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# Cards Against Coffee terminal client

`cards-against-coffee` is a dependency-free terminal client for the Cards
Against Coffee API. It includes no card corpus and does not cache rounds.

```bash
python -m pip install cards-against-coffee
coffee-cards
coffee-cards --packs base,maha
coffee-cards --black-packs maha --white-packs base,maha
coffee-cards --list-packs
coffee-cards --json
```

The default API is `https://bytes.coffee/cah`. Override it with `--api-url` to
use any compatible private or local deployment.

Card-data licensing and adult-content constraints are set by the service and
its packs, not by this client.

## Release to PyPI

The published client is available as
[`cards-against-coffee`](https://pypi.org/project/cards-against-coffee/). The
server/runtime is separately published as
[`cards-against-coffee-server`](https://pypi.org/project/cards-against-coffee-server/).
Recheck the intended version immediately before publishing an update.

```bash
cd client
python -m pip install --upgrade build twine
python -m build
twine check dist/*
twine upload dist/*
```

Use a PyPI API token through `TWINE_USERNAME=__token__` and `TWINE_PASSWORD`,
or configure a keyring/token locally. Do not commit credentials or `.pypirc`.
