Metadata-Version: 2.4
Name: cartomancy
Version: 0.1.0
Summary: a tarot and minchiate LCI
Author-email: sailorfe <sailorf@proton.me>
License-Expression: MIT
Project-URL: Repository, https://codeberg.org/sailorfe/cartomancy
Keywords: tarot,cartomancy,divination,minchiate,fortunetelling
Classifier: Development Status :: 3 - Alpha
Classifier: Topic :: Games/Entertainment :: Fortune Cookies
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.0
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# cartomancy

a CLI for drawing tarot and minchiate cards, for quick, portable readings right in your terminal


## features

- supports two decks: **tarot** and **minchiate**
- draw any number of cards: 1-78 for tarot and 1-97 for minchiate
- optional reversals


## installation

cartomancy can be installed directly from [pypi](https://pypi.org/project/cartomancy).

### with `pipx`

```sh
pipx install cartomancy
```

### with `pip`

```sh
pip install --user cartomancy
```

### build from source

```sh
git clone https://codeberg.org/sailorfe/cartomancy
cd cartomancy
pip install -e .
```

## usage

```sh
usage: cards [-h] [-r] {tarot,minchiate} N

cartomancy in the terminal 🃏

positional arguments:
  {tarot,minchiate}  pick a deck
  N                  # of cards to draw

options:
  -h, --help         show this help message and exit
  -r, --reversals    allow reversals
```
