asterwise 0.2.4__tar.gz → 0.3.0__tar.gz

asterwise-0.3.0/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: asterwise
+Version: 0.3.0
+Summary: Official Python SDK for the Asterwise API: Vedic and Western astrology, numerology, tarot. 118 endpoints, generated from the OpenAPI document; positions checked against NASA JPL Horizons; MCP server for Claude and Cursor.
+Author-email: Asterwise <support@asterwise.com>
+License: MIT
+Project-URL: Homepage, https://asterwise.com/?utm_source=pypi&utm_medium=package&utm_campaign=asterwise-python
+Project-URL: Documentation, https://docs.asterwise.com
+Project-URL: Repository, https://github.com/asterwise/asterwise-python
+Project-URL: Bug Tracker, https://github.com/asterwise/asterwise-python/issues
+Project-URL: Changelog, https://github.com/asterwise/asterwise-python/blob/main/CHANGELOG.md
+Keywords: vedic-astrology,jyotish,astrology,kundli,horoscope,numerology,tarot,panchanga,dasha,matchmaking,western-astrology,natal-chart,astrology-api,mcp,swiss-ephemeris,kundali-matching
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: urllib3<3.0.0,>=2.1.0
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: pydantic>=2.11
+Requires-Dist: typing-extensions>=4.7.1
+Dynamic: license-file
+
+<p align="center">
+  <img src="https://asterwise.com/public/logo.svg" alt="Asterwise" width="120" />
+</p>
+
+# asterwise-python
+
+[![PyPI version](https://img.shields.io/pypi/v/asterwise)](https://pypi.org/project/asterwise/)
+[![Python versions](https://img.shields.io/pypi/pyversions/asterwise)](https://pypi.org/project/asterwise/)
+
+The official Python library for **[Asterwise](https://asterwise.com)** — Vedic + Western astrology, numerology, tarot, crystals, and dreams. 118 endpoints, generated from the API's OpenAPI document so the types match what the server sends. Every position is [checked against NASA JPL Horizons](https://asterwise.com/accuracy/), median 0.046 arcseconds over 80 positions from 1950 to 2050. Compared row by row with seven other astrology APIs, every claim sourced, at [asterwise.com/compare](https://asterwise.com/compare/).
+
+[Documentation](https://docs.asterwise.com) · [API Reference](https://docs.asterwise.com) · [Pricing](https://asterwise.com/pricing/) · [MCP server](https://asterwise.com/mcp/) · [Postman collection](https://documenter.getpostman.com/view/58005543/2sBYAvwr1u)
+
+## Installation
+
+```bash
+pip install asterwise
+```
+
+## Quickstart
+
+```python
+import asterwise
+from asterwise.api.astrology_api import AstrologyApi
+
+configuration = asterwise.Configuration(
+    host="https://api.asterwise.com",
+    access_token="YOUR_API_KEY",
+)
+
+with asterwise.ApiClient(configuration) as client:
+    api = AstrologyApi(client)
+    result = api.natal_chart(
+        asterwise.NatalRequest(
+            date="1985-11-12",
+            time="06:45",
+            location="Mumbai, India",
+            ayanamsa="lahiri",
+        )
+    )
+    print(result)
+```
+
+Get a free API key at [asterwise.com](https://asterwise.com).
+
+## What you can build
+
+| Domain | Operations |
+|--------|------------|
+| Vedic astrology | 40 |
+| Matchmaking | 5 |
+| Western astrology | 17 |
+| Horoscope | 8 |
+| Numerology | 24 |
+| KP + Lal Kitab | 5 |
+| Tarot | 9 |
+| Crystals & dreams | 7 |
+| Utilities | 2 |
+
+*118 typed SDK methods across 13 API classes covering **118 REST endpoints**.*
+
+## What makes Asterwise different
+
+- **Classical interpretation text** alongside the calculations on chart endpoints (natal chart, dasha, yogas, doshas)
+- **5-level Vimshottari Dasha** (Maha → Antar → Pratyantar → Sookshma → Prana) — most APIs return two
+- **Rajju and Vedha as hard vetoes** in matchmaking — not just point scores
+- **HMAC-signed responses** for auditability
+- **Panchanga as printed panchangs show it**: every tithi, nakshatra, yoga and karana of the day with start and end times, the festival and vrat calendar, and muhurta search with exact ISO times
+- **Typed responses**: every method returns a model generated from the OpenAPI document (`.to_dict()` gives a plain dict)
+- **MCP server** with **104 tools** for Claude and Cursor integration
+
+## Examples
+
+```python
+from datetime import date
+from asterwise.api.western_astrology_api import WesternAstrologyApi
+from asterwise.api.numerology_api import NumerologyApi
+from asterwise.api.tarot_api import TarotApi
+
+with asterwise.ApiClient(configuration) as client:
+    western = WesternAstrologyApi(client)
+    chart = western.western_natal_chart(
+        asterwise.WesternNatalRequest(
+            date="1985-11-12",
+            time="06:45",
+            location="Mumbai, India",
+        )
+    )
+
+    numerology = NumerologyApi(client)
+    path = numerology.life_path(var_date=date(1985, 11, 12))
+
+    tarot = TarotApi(client)
+    spread = tarot.tarot_three_card(
+        asterwise.SpreadRequest(question="What should I focus on this month?")
+    )
+```
+
+## Requirements
+
+Python 3.9+. An API key from [asterwise.com](https://asterwise.com).
+
+## Documentation
+
+Full API reference: [docs.asterwise.com](https://docs.asterwise.com)
+
+## Development
+
+Regenerate from `https://api.asterwise.com/openapi-sdk.json` (see `asterwise-api/_docs/SDK_CONTRACT.md`).
+
+**Requirements:** Node.js/npm (for `npx`), **Java 11+** for OpenAPI Generator.
+
+```bash
+bash scripts/generate.sh
+```
+
+**Releasing:** bump `version` in `pyproject.toml` (the only place it is set) → `bash scripts/generate.sh` (writes that version into `__version__` and the User-Agent) → update `CHANGELOG.md` → `pytest` → commit → push a `python-v<version>` tag. The publish workflow checks the tag against `pyproject.toml`, runs the tests, builds, runs `twine check` and uploads to PyPI.
+
+## Support
+
+support@asterwise.com
+
+## License
+
+Commercial. See [LICENSE](LICENSE).

asterwise-0.3.0/README.md

@@ -0,0 +1,125 @@
+<p align="center">
+  <img src="https://asterwise.com/public/logo.svg" alt="Asterwise" width="120" />
+</p>
+
+# asterwise-python
+
+[![PyPI version](https://img.shields.io/pypi/v/asterwise)](https://pypi.org/project/asterwise/)
+[![Python versions](https://img.shields.io/pypi/pyversions/asterwise)](https://pypi.org/project/asterwise/)
+
+The official Python library for **[Asterwise](https://asterwise.com)** — Vedic + Western astrology, numerology, tarot, crystals, and dreams. 118 endpoints, generated from the API's OpenAPI document so the types match what the server sends. Every position is [checked against NASA JPL Horizons](https://asterwise.com/accuracy/), median 0.046 arcseconds over 80 positions from 1950 to 2050. Compared row by row with seven other astrology APIs, every claim sourced, at [asterwise.com/compare](https://asterwise.com/compare/).
+
+[Documentation](https://docs.asterwise.com) · [API Reference](https://docs.asterwise.com) · [Pricing](https://asterwise.com/pricing/) · [MCP server](https://asterwise.com/mcp/) · [Postman collection](https://documenter.getpostman.com/view/58005543/2sBYAvwr1u)
+
+## Installation
+
+```bash
+pip install asterwise
+```
+
+## Quickstart
+
+```python
+import asterwise
+from asterwise.api.astrology_api import AstrologyApi
+
+configuration = asterwise.Configuration(
+    host="https://api.asterwise.com",
+    access_token="YOUR_API_KEY",
+)
+
+with asterwise.ApiClient(configuration) as client:
+    api = AstrologyApi(client)
+    result = api.natal_chart(
+        asterwise.NatalRequest(
+            date="1985-11-12",
+            time="06:45",
+            location="Mumbai, India",
+            ayanamsa="lahiri",
+        )
+    )
+    print(result)
+```
+
+Get a free API key at [asterwise.com](https://asterwise.com).
+
+## What you can build
+
+| Domain | Operations |
+|--------|------------|
+| Vedic astrology | 40 |
+| Matchmaking | 5 |
+| Western astrology | 17 |
+| Horoscope | 8 |
+| Numerology | 24 |
+| KP + Lal Kitab | 5 |
+| Tarot | 9 |
+| Crystals & dreams | 7 |
+| Utilities | 2 |
+
+*118 typed SDK methods across 13 API classes covering **118 REST endpoints**.*
+
+## What makes Asterwise different
+
+- **Classical interpretation text** alongside the calculations on chart endpoints (natal chart, dasha, yogas, doshas)
+- **5-level Vimshottari Dasha** (Maha → Antar → Pratyantar → Sookshma → Prana) — most APIs return two
+- **Rajju and Vedha as hard vetoes** in matchmaking — not just point scores
+- **HMAC-signed responses** for auditability
+- **Panchanga as printed panchangs show it**: every tithi, nakshatra, yoga and karana of the day with start and end times, the festival and vrat calendar, and muhurta search with exact ISO times
+- **Typed responses**: every method returns a model generated from the OpenAPI document (`.to_dict()` gives a plain dict)
+- **MCP server** with **104 tools** for Claude and Cursor integration
+
+## Examples
+
+```python
+from datetime import date
+from asterwise.api.western_astrology_api import WesternAstrologyApi
+from asterwise.api.numerology_api import NumerologyApi
+from asterwise.api.tarot_api import TarotApi
+
+with asterwise.ApiClient(configuration) as client:
+    western = WesternAstrologyApi(client)
+    chart = western.western_natal_chart(
+        asterwise.WesternNatalRequest(
+            date="1985-11-12",
+            time="06:45",
+            location="Mumbai, India",
+        )
+    )
+
+    numerology = NumerologyApi(client)
+    path = numerology.life_path(var_date=date(1985, 11, 12))
+
+    tarot = TarotApi(client)
+    spread = tarot.tarot_three_card(
+        asterwise.SpreadRequest(question="What should I focus on this month?")
+    )
+```
+
+## Requirements
+
+Python 3.9+. An API key from [asterwise.com](https://asterwise.com).
+
+## Documentation
+
+Full API reference: [docs.asterwise.com](https://docs.asterwise.com)
+
+## Development
+
+Regenerate from `https://api.asterwise.com/openapi-sdk.json` (see `asterwise-api/_docs/SDK_CONTRACT.md`).
+
+**Requirements:** Node.js/npm (for `npx`), **Java 11+** for OpenAPI Generator.
+
+```bash
+bash scripts/generate.sh
+```
+
+**Releasing:** bump `version` in `pyproject.toml` (the only place it is set) → `bash scripts/generate.sh` (writes that version into `__version__` and the User-Agent) → update `CHANGELOG.md` → `pytest` → commit → push a `python-v<version>` tag. The publish workflow checks the tag against `pyproject.toml`, runs the tests, builds, runs `twine check` and uploads to PyPI.
+
+## Support
+
+support@asterwise.com
+
+## License
+
+Commercial. See [LICENSE](LICENSE).