Metadata-Version: 2.5
Name: tarrotsimplified
Version: 0.1.0
Summary: Offline tarot card interpretations as a Python library.
Project-URL: Homepage, https://github.com/yourname/tarrotsimplified
Author: Vikkas Pareek
License-Expression: MIT
License-File: LICENSE
Keywords: cards,divination,tarot
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# tarrotsimplified

Offline tarot card interpretations as a Python library. No server, no API — the card data ships inside the package.

**Status:** early release. Only a handful of sample cards are included so far (The Fool, The Magician, Ace of Cups, Two of Wands) — the full 78-card deck is coming in a follow-up release.

## Install

```bash
pip install tarrotsimplified
```

## Use

```python
import tarrotsimplified as tw

# look up a card
card = tw.get_card("The Fool")
print(card.upright)
print(card.keywords)

# draw random cards (some may be reversed)
for item in tw.draw(3):
    c = item["card"]
    print(c.name, "(reversed)" if item["reversed"] else "", "-", c.meaning(item["reversed"]))

# do a named spread
for item in tw.spread("three_card"):
    print(item["position"], "->", item["card"].name)

# search meanings
print([c.name for c in tw.search("new beginnings")])
```

Spreads available: `single`, `three_card`, `celtic_cross`.

## Publish to PyPI (one time)

```bash
pip install build twine
python -m build          # creates dist/*.whl and *.tar.gz
twine upload dist/*      # asks for your PyPI token
```

After that, anyone can `pip install tarrotsimplified`. Bump `version` in `pyproject.toml` and `__init__.py` for each new release.
