tarrotsimplified 0.1.0__tar.gz

tarrotsimplified-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vikkas Pareek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tarrotsimplified-0.1.0/PKG-INFO

@@ -0,0 +1,60 @@
+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.

tarrotsimplified-0.1.0/README.md

@@ -0,0 +1,46 @@
+# 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.

tarrotsimplified-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "tarrotsimplified"
+version = "0.1.0"
+description = "Offline tarot card interpretations as a Python library."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [{ name = "Vikkas Pareek" }]
+keywords = ["tarot", "divination", "cards"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+]
+
+[project.urls]
+Homepage = "https://github.com/yourname/tarrotsimplified"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/tarrotsimplified"]

tarrotsimplified-0.1.0/src/tarrotsimplified/__init__.py

@@ -0,0 +1,91 @@
+"""tarrotsimplified — offline tarot card interpretations as a Python library."""
+from __future__ import annotations
+
+import json
+import random
+from importlib import resources
+from dataclasses import dataclass
+
+__version__ = "0.1.0"
+
+
+@dataclass
+class Card:
+    name: str
+    number: int
+    arcana: str
+    suit: str | None
+    keywords: list[str]
+    upright: str
+    reversed: str
+    element: str | None = None
+    astrology: str | None = None
+
+    def meaning(self, reversed: bool = False) -> str:
+        return self.reversed if reversed else self.upright
+
+
+def _load() -> list[Card]:
+    raw = json.loads(
+        resources.files("tarrotsimplified.data").joinpath("cards.json").read_text("utf-8")
+    )
+    return [Card(**c) for c in raw["cards"]]
+
+
+_CARDS: list[Card] = _load()
+
+
+def all_cards() -> list[Card]:
+    """Return every card in the deck."""
+    return list(_CARDS)
+
+
+def get_card(name: str) -> Card:
+    """Look up one card by name (case-insensitive)."""
+    for c in _CARDS:
+        if c.name.lower() == name.lower():
+            return c
+    raise KeyError(f"No card named {name!r}")
+
+
+def draw(n: int = 1, allow_reversed: bool = True) -> list[dict]:
+    """Draw n random cards. Each result is {'card': Card, 'reversed': bool}."""
+    if n > len(_CARDS):
+        raise ValueError(f"Deck only has {len(_CARDS)} cards")
+    picked = random.sample(_CARDS, n)
+    return [
+        {"card": c, "reversed": allow_reversed and random.random() < 0.5}
+        for c in picked
+    ]
+
+
+SPREADS = {
+    "single": ["Focus"],
+    "three_card": ["Past", "Present", "Future"],
+    "celtic_cross": [
+        "Present", "Challenge", "Past", "Future", "Above", "Below",
+        "Advice", "External", "Hopes/Fears", "Outcome",
+    ],
+}
+
+
+def spread(name: str = "three_card", allow_reversed: bool = True) -> list[dict]:
+    """Draw a named spread. Each result adds a 'position' label."""
+    if name not in SPREADS:
+        raise KeyError(f"Unknown spread {name!r}. Try: {', '.join(SPREADS)}")
+    positions = SPREADS[name]
+    cards = draw(len(positions), allow_reversed)
+    for pos, item in zip(positions, cards):
+        item["position"] = pos
+    return cards
+
+
+def search(keyword: str) -> list[Card]:
+    """Find cards whose keywords or meanings mention a term."""
+    k = keyword.lower()
+    return [
+        c for c in _CARDS
+        if any(k in kw.lower() for kw in c.keywords)
+        or k in c.upright.lower()
+        or k in c.reversed.lower()
+    ]

tarrotsimplified-0.1.0/src/tarrotsimplified/data/cards.json

@@ -0,0 +1,48 @@
+{
+  "cards": [
+    {
+      "name": "The Fool",
+      "number": 0,
+      "arcana": "major",
+      "suit": null,
+      "keywords": ["beginnings", "innocence", "spontaneity", "free spirit"],
+      "upright": "New beginnings, a leap of faith, and openness to whatever comes. The Fool asks you to trust the journey even without knowing the destination.",
+      "reversed": "Recklessness, hesitation, or fear of taking the first step. A warning to look before you leap, or a nudge to stop over-thinking and finally move.",
+      "element": "Air",
+      "astrology": "Uranus"
+    },
+    {
+      "name": "The Magician",
+      "number": 1,
+      "arcana": "major",
+      "suit": null,
+      "keywords": ["manifestation", "willpower", "resourcefulness", "power"],
+      "upright": "You have every tool you need. Focus, intention, and skill combine to turn ideas into reality.",
+      "reversed": "Manipulation, untapped potential, or scattered energy. Talent going to waste, or power used for the wrong ends.",
+      "element": "Air",
+      "astrology": "Mercury"
+    },
+    {
+      "name": "Ace of Cups",
+      "number": 1,
+      "arcana": "minor",
+      "suit": "cups",
+      "keywords": ["new love", "emotion", "intuition", "compassion"],
+      "upright": "An overflowing heart — new love, deep feeling, or spiritual awakening. An emotional fresh start.",
+      "reversed": "Blocked emotions, emptiness, or repressed feelings. Love withheld, from others or from yourself.",
+      "element": "Water",
+      "astrology": null
+    },
+    {
+      "name": "Two of Wands",
+      "number": 2,
+      "arcana": "minor",
+      "suit": "wands",
+      "keywords": ["planning", "decisions", "discovery", "future"],
+      "upright": "Standing at the edge of what you've built, planning the next bold move. The world is wider than your comfort zone.",
+      "reversed": "Fear of the unknown, playing it too safe, or plans that never leave the drawing board.",
+      "element": "Fire",
+      "astrology": "Mars in Aries"
+    }
+  ]
+}