Metadata-Version: 2.5
Name: tarrotsimplified
Version: 0.2.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 readings as a Python library. All 78 cards with a Yes/No answer and personal guidance ship inside the package — no server, no API.

## Install

```bash
pip install tarrotsimplified
```

## Use

```python
import tarrotsimplified as tw

# look up a card
c = tw.get_card("The Tower")
print(c.yes_no)      # "no"
print(c.guidance)

# yes/no question
r = tw.ask("Should I take the job?")
print(r["card"].name, "->", r["answer"])
print(r["guidance"])

# draw random cards
for c in tw.draw(3):
    print(c.name, "-", c.yes_no)

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

# search guidance text
print([c.name for c in tw.search("fertility")])

# whole suit
print([c.name for c in tw.by_suit("cups")])
```

Spreads: `single`, `three_card`, `situation`.
Each `Card` has: `name`, `arcana`, `suit`, `number`, `yes_no`, `guidance`.

## 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.
