divineapi 1.0.0__tar.gz

divineapi-1.0.0/PKG-INFO

@@ -0,0 +1,280 @@
+Metadata-Version: 2.4
+Name: divineapi
+Version: 1.0.0
+Summary: Official Python SDK for the Divine API - Astrology, Numerology, Tarot & more
+Author-email: Divine API <support@divineapi.com>
+License: MIT
+Project-URL: Homepage, https://divineapi.com
+Project-URL: Documentation, https://divineapi.com/docs
+Project-URL: Repository, https://github.com/niceDevelopers/divine-api-python
+Keywords: astrology,horoscope,numerology,tarot,kundli,divineapi
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.20.0
+
+# DivineAPI Python SDK
+
+Official Python SDK for the [Divine API](https://divineapi.com) -- Astrology, Horoscopes, Numerology, Tarot, Kundli, and more.
+
+## Installation
+
+```bash
+pip install divineapi
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/niceDevelopers/divine-api-python.git
+cd divine-api-python
+pip install -e .
+```
+
+## Quick Start
+
+```python
+from divineapi import DivineApi
+
+client = DivineApi(api_key="your-api-key", auth_token="your-bearer-token")
+
+# Daily Horoscope
+result = client.horoscope.daily(
+    sign="aries", day=10, month=3, year=2024, tzone=5.5
+)
+print(result)
+```
+
+## API Categories
+
+### Horoscope & Tarot
+
+```python
+# Daily / Weekly / Monthly / Yearly Horoscope
+client.horoscope.daily(sign="aries", day=10, month=3, year=2024, tzone=5.5)
+client.horoscope.weekly(sign="leo", week="thisweek", tzone=5.5)
+client.horoscope.monthly(sign="cancer", month=3, tzone=5.5)
+client.horoscope.yearly(sign="virgo", year=2024, tzone=5.5)
+
+# Chinese & Numerology Horoscope
+client.horoscope.chinese(sign="rat", h_day="today", tzone=5.5)
+client.horoscope.numerology(number=7, day=10, month=3, year=2024, tzone=5.5)
+
+# Tarot & Readings
+client.horoscope.yes_or_no_tarot()
+client.horoscope.daily_tarot()
+client.horoscope.fortune_cookie()
+client.horoscope.coffee_cup_reading()
+client.horoscope.love_compatibility(sign_1="aries", sign_2="leo")
+```
+
+### Indian Astrology - Panchang
+
+```python
+# Panchang, Nakshatra, Tithi, Yoga, Karana
+client.indian.panchang.find_panchang(
+    day=10, month=3, year=2024,
+    place="Delhi", lat=28.6139, lon=77.2090, tzone=5.5
+)
+client.indian.panchang.find_nakshatra(
+    day=10, month=3, year=2024,
+    place="Mumbai", lat=19.076, lon=72.8777, tzone=5.5
+)
+client.indian.panchang.auspicious_timings(
+    day=10, month=3, year=2024,
+    place="Delhi", lat=28.6139, lon=77.2090, tzone=5.5
+)
+
+# Planetary transits
+client.indian.panchang.grah_gochar(
+    planet="jupiter", month=3, year=2024,
+    place="Delhi", lat=28.6139, lon=77.2090, tzone=5.5
+)
+```
+
+### Indian Astrology - Kundli
+
+```python
+birth = dict(
+    full_name="John Doe", day=1, month=1, year=1990,
+    hour=10, min=30, sec=0, gender="male",
+    place="Mumbai", lat=19.076, lon=72.8777, tzone=5.5,
+)
+
+client.indian.kundli.basic_astro_details(**birth)
+client.indian.kundli.planetary_positions(**birth)
+client.indian.kundli.manglik_dosha(**birth)
+client.indian.kundli.vimshottari_dasha(**birth)
+client.indian.kundli.sadhe_sati(**birth)
+client.indian.kundli.yogas(**birth)
+client.indian.kundli.horoscope_chart("D1", **birth)
+
+# Dasha analysis (no birth data needed)
+client.indian.kundli.maha_dasha_analysis(maha_dasha="Sun")
+```
+
+### Indian Astrology - Match Making
+
+```python
+client.indian.match_making.ashtakoot_milan(
+    p1_full_name="Groom", p1_day=1, p1_month=1, p1_year=1990,
+    p1_hour=10, p1_min=0, p1_sec=0, p1_gender="male",
+    p1_place="Delhi", p1_lat=28.6, p1_lon=77.2, p1_tzone=5.5,
+    p2_full_name="Bride", p2_day=5, p2_month=5, p2_year=1992,
+    p2_hour=14, p2_min=0, p2_sec=0, p2_gender="female",
+    p2_place="Mumbai", p2_lat=19.07, p2_lon=72.87, p2_tzone=5.5,
+)
+```
+
+### Indian Astrology - Festivals
+
+```python
+client.indian.festival.chaitra_festivals(
+    year=2024, place="Delhi", lat=28.6, lon=77.2, tzone=5.5
+)
+client.indian.festival.english_calendar(
+    year=2024, month=3, place="Delhi", lat=28.6, lon=77.2, tzone=5.5
+)
+client.indian.festival.find_festival(
+    festival="diwali", year=2024,
+    place="Delhi", lat=28.6, lon=77.2, tzone=5.5
+)
+```
+
+### Western Astrology - Natal
+
+```python
+birth_w = dict(
+    full_name="Jane Smith", day=15, month=6, year=1995,
+    hour=8, min=0, sec=0, gender="female",
+    place="New York", lat=40.7128, lon=-74.0060, tzone=-5.0,
+)
+
+client.western.natal.planetary_positions(**birth_w)
+client.western.natal.house_cusps(**birth_w)
+client.western.natal.aspect_table(**birth_w)
+client.western.natal.natal_wheel_chart(**birth_w)
+client.western.natal.natal_insights(**birth_w)
+client.western.natal.dominants(method="traditional", **birth_w)
+```
+
+### Western Astrology - Synastry
+
+```python
+client.western.synastry.planetary_positions(
+    p1_full_name="Person A", p1_day=1, p1_month=1, p1_year=1990,
+    p1_hour=10, p1_min=0, p1_sec=0, p1_gender="male",
+    p1_place="London", p1_lat=51.5, p1_lon=-0.12, p1_tzone=0,
+    p2_full_name="Person B", p2_day=15, p2_month=6, p2_year=1992,
+    p2_hour=14, p2_min=0, p2_sec=0, p2_gender="female",
+    p2_place="Paris", p2_lat=48.85, p2_lon=2.35, p2_tzone=1,
+)
+client.western.synastry.emotional_compatibility(...)
+```
+
+### Western Astrology - Transit
+
+```python
+client.western.transit.daily(**birth_w)
+client.western.transit.planet_retrograde(
+    planet="mercury", month=3, year=2024,
+    place="New York", lat=40.71, lon=-74.0, tzone=-5.0,
+)
+```
+
+### Numerology
+
+```python
+# Chaldean numerology
+client.numerology.loshu_grid(fname="John", lname="Doe", day=1, month=1, year=1990)
+client.numerology.name_number(fname="John", lname="Doe", day=1, month=1, year=1990)
+
+# Core numbers
+client.numerology.core_numbers(
+    full_name="John Doe", day=1, month=1, year=1990,
+    gender="male", method="pythagorean",
+)
+
+# Mobile number analysis
+client.numerology.new_mobile_number(fname="John", lname="Doe", day=1, month=1, year=1990)
+client.numerology.analyze_mobile_number(
+    fname="John", lname="Doe", day=1, month=1, year=1990,
+    mobile_number="9876543210",
+)
+```
+
+### Lifestyle
+
+```python
+client.lifestyle.zodiac_gift_guru(sign="aries", h_day="today", tzone=5.5)
+client.lifestyle.beauty_by_the_stars(sign="leo", h_day="today", tzone=5.5)
+client.lifestyle.astro_chic_picks(sign="virgo", h_day="today", tzone=5.5)
+```
+
+### Calculators
+
+```python
+client.calculators.flames(full_name="John", partner_name="Jane")
+client.calculators.love_calculator(
+    your_name="John", partner_name="Jane",
+    your_gender="male", partner_gender="female",
+)
+```
+
+### PDF Reports
+
+```python
+client.pdf.kundali_sampoorna(
+    full_name="John", day=1, month=1, year=1990,
+    hour=10, min=30, sec=0, gender="male",
+    place="Mumbai", lat=19.07, lon=72.87, tzone=5.5,
+    company_name="AstroCo", company_url="https://example.com",
+)
+```
+
+## Error Handling
+
+```python
+from divineapi import DivineApi, AuthenticationError, ValidationError, RateLimitError
+
+client = DivineApi(api_key="...", auth_token="...")
+
+try:
+    result = client.horoscope.daily(sign="aries", day=10, month=3, year=2024, tzone=5.5)
+except AuthenticationError as e:
+    print(f"Auth failed: {e}")
+except ValidationError as e:
+    print(f"Bad request: {e}")
+except RateLimitError as e:
+    print(f"Rate limited: {e}")
+```
+
+## Context Manager
+
+```python
+with DivineApi(api_key="...", auth_token="...") as client:
+    result = client.horoscope.daily(sign="aries", day=10, month=3, year=2024, tzone=5.5)
+```
+
+## Configuration
+
+| Parameter | Default | Description |
+|-----------|---------|-------------|
+| `api_key` | required | Your Divine API key |
+| `auth_token` | required | Bearer token for Authorization header |
+| `timeout` | 30 | Request timeout in seconds |
+| `max_retries` | 2 | Number of retry attempts on failure |
+
+## License
+
+MIT

divineapi-1.0.0/README.md

@@ -0,0 +1,255 @@
+# DivineAPI Python SDK
+
+Official Python SDK for the [Divine API](https://divineapi.com) -- Astrology, Horoscopes, Numerology, Tarot, Kundli, and more.
+
+## Installation
+
+```bash
+pip install divineapi
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/niceDevelopers/divine-api-python.git
+cd divine-api-python
+pip install -e .
+```
+
+## Quick Start
+
+```python
+from divineapi import DivineApi
+
+client = DivineApi(api_key="your-api-key", auth_token="your-bearer-token")
+
+# Daily Horoscope
+result = client.horoscope.daily(
+    sign="aries", day=10, month=3, year=2024, tzone=5.5
+)
+print(result)
+```
+
+## API Categories
+
+### Horoscope & Tarot
+
+```python
+# Daily / Weekly / Monthly / Yearly Horoscope
+client.horoscope.daily(sign="aries", day=10, month=3, year=2024, tzone=5.5)
+client.horoscope.weekly(sign="leo", week="thisweek", tzone=5.5)
+client.horoscope.monthly(sign="cancer", month=3, tzone=5.5)
+client.horoscope.yearly(sign="virgo", year=2024, tzone=5.5)
+
+# Chinese & Numerology Horoscope
+client.horoscope.chinese(sign="rat", h_day="today", tzone=5.5)
+client.horoscope.numerology(number=7, day=10, month=3, year=2024, tzone=5.5)
+
+# Tarot & Readings
+client.horoscope.yes_or_no_tarot()
+client.horoscope.daily_tarot()
+client.horoscope.fortune_cookie()
+client.horoscope.coffee_cup_reading()
+client.horoscope.love_compatibility(sign_1="aries", sign_2="leo")
+```
+
+### Indian Astrology - Panchang
+
+```python
+# Panchang, Nakshatra, Tithi, Yoga, Karana
+client.indian.panchang.find_panchang(
+    day=10, month=3, year=2024,
+    place="Delhi", lat=28.6139, lon=77.2090, tzone=5.5
+)
+client.indian.panchang.find_nakshatra(
+    day=10, month=3, year=2024,
+    place="Mumbai", lat=19.076, lon=72.8777, tzone=5.5
+)
+client.indian.panchang.auspicious_timings(
+    day=10, month=3, year=2024,
+    place="Delhi", lat=28.6139, lon=77.2090, tzone=5.5
+)
+
+# Planetary transits
+client.indian.panchang.grah_gochar(
+    planet="jupiter", month=3, year=2024,
+    place="Delhi", lat=28.6139, lon=77.2090, tzone=5.5
+)
+```
+
+### Indian Astrology - Kundli
+
+```python
+birth = dict(
+    full_name="John Doe", day=1, month=1, year=1990,
+    hour=10, min=30, sec=0, gender="male",
+    place="Mumbai", lat=19.076, lon=72.8777, tzone=5.5,
+)
+
+client.indian.kundli.basic_astro_details(**birth)
+client.indian.kundli.planetary_positions(**birth)
+client.indian.kundli.manglik_dosha(**birth)
+client.indian.kundli.vimshottari_dasha(**birth)
+client.indian.kundli.sadhe_sati(**birth)
+client.indian.kundli.yogas(**birth)
+client.indian.kundli.horoscope_chart("D1", **birth)
+
+# Dasha analysis (no birth data needed)
+client.indian.kundli.maha_dasha_analysis(maha_dasha="Sun")
+```
+
+### Indian Astrology - Match Making
+
+```python
+client.indian.match_making.ashtakoot_milan(
+    p1_full_name="Groom", p1_day=1, p1_month=1, p1_year=1990,
+    p1_hour=10, p1_min=0, p1_sec=0, p1_gender="male",
+    p1_place="Delhi", p1_lat=28.6, p1_lon=77.2, p1_tzone=5.5,
+    p2_full_name="Bride", p2_day=5, p2_month=5, p2_year=1992,
+    p2_hour=14, p2_min=0, p2_sec=0, p2_gender="female",
+    p2_place="Mumbai", p2_lat=19.07, p2_lon=72.87, p2_tzone=5.5,
+)
+```
+
+### Indian Astrology - Festivals
+
+```python
+client.indian.festival.chaitra_festivals(
+    year=2024, place="Delhi", lat=28.6, lon=77.2, tzone=5.5
+)
+client.indian.festival.english_calendar(
+    year=2024, month=3, place="Delhi", lat=28.6, lon=77.2, tzone=5.5
+)
+client.indian.festival.find_festival(
+    festival="diwali", year=2024,
+    place="Delhi", lat=28.6, lon=77.2, tzone=5.5
+)
+```
+
+### Western Astrology - Natal
+
+```python
+birth_w = dict(
+    full_name="Jane Smith", day=15, month=6, year=1995,
+    hour=8, min=0, sec=0, gender="female",
+    place="New York", lat=40.7128, lon=-74.0060, tzone=-5.0,
+)
+
+client.western.natal.planetary_positions(**birth_w)
+client.western.natal.house_cusps(**birth_w)
+client.western.natal.aspect_table(**birth_w)
+client.western.natal.natal_wheel_chart(**birth_w)
+client.western.natal.natal_insights(**birth_w)
+client.western.natal.dominants(method="traditional", **birth_w)
+```
+
+### Western Astrology - Synastry
+
+```python
+client.western.synastry.planetary_positions(
+    p1_full_name="Person A", p1_day=1, p1_month=1, p1_year=1990,
+    p1_hour=10, p1_min=0, p1_sec=0, p1_gender="male",
+    p1_place="London", p1_lat=51.5, p1_lon=-0.12, p1_tzone=0,
+    p2_full_name="Person B", p2_day=15, p2_month=6, p2_year=1992,
+    p2_hour=14, p2_min=0, p2_sec=0, p2_gender="female",
+    p2_place="Paris", p2_lat=48.85, p2_lon=2.35, p2_tzone=1,
+)
+client.western.synastry.emotional_compatibility(...)
+```
+
+### Western Astrology - Transit
+
+```python
+client.western.transit.daily(**birth_w)
+client.western.transit.planet_retrograde(
+    planet="mercury", month=3, year=2024,
+    place="New York", lat=40.71, lon=-74.0, tzone=-5.0,
+)
+```
+
+### Numerology
+
+```python
+# Chaldean numerology
+client.numerology.loshu_grid(fname="John", lname="Doe", day=1, month=1, year=1990)
+client.numerology.name_number(fname="John", lname="Doe", day=1, month=1, year=1990)
+
+# Core numbers
+client.numerology.core_numbers(
+    full_name="John Doe", day=1, month=1, year=1990,
+    gender="male", method="pythagorean",
+)
+
+# Mobile number analysis
+client.numerology.new_mobile_number(fname="John", lname="Doe", day=1, month=1, year=1990)
+client.numerology.analyze_mobile_number(
+    fname="John", lname="Doe", day=1, month=1, year=1990,
+    mobile_number="9876543210",
+)
+```
+
+### Lifestyle
+
+```python
+client.lifestyle.zodiac_gift_guru(sign="aries", h_day="today", tzone=5.5)
+client.lifestyle.beauty_by_the_stars(sign="leo", h_day="today", tzone=5.5)
+client.lifestyle.astro_chic_picks(sign="virgo", h_day="today", tzone=5.5)
+```
+
+### Calculators
+
+```python
+client.calculators.flames(full_name="John", partner_name="Jane")
+client.calculators.love_calculator(
+    your_name="John", partner_name="Jane",
+    your_gender="male", partner_gender="female",
+)
+```
+
+### PDF Reports
+
+```python
+client.pdf.kundali_sampoorna(
+    full_name="John", day=1, month=1, year=1990,
+    hour=10, min=30, sec=0, gender="male",
+    place="Mumbai", lat=19.07, lon=72.87, tzone=5.5,
+    company_name="AstroCo", company_url="https://example.com",
+)
+```
+
+## Error Handling
+
+```python
+from divineapi import DivineApi, AuthenticationError, ValidationError, RateLimitError
+
+client = DivineApi(api_key="...", auth_token="...")
+
+try:
+    result = client.horoscope.daily(sign="aries", day=10, month=3, year=2024, tzone=5.5)
+except AuthenticationError as e:
+    print(f"Auth failed: {e}")
+except ValidationError as e:
+    print(f"Bad request: {e}")
+except RateLimitError as e:
+    print(f"Rate limited: {e}")
+```
+
+## Context Manager
+
+```python
+with DivineApi(api_key="...", auth_token="...") as client:
+    result = client.horoscope.daily(sign="aries", day=10, month=3, year=2024, tzone=5.5)
+```
+
+## Configuration
+
+| Parameter | Default | Description |
+|-----------|---------|-------------|
+| `api_key` | required | Your Divine API key |
+| `auth_token` | required | Bearer token for Authorization header |
+| `timeout` | 30 | Request timeout in seconds |
+| `max_retries` | 2 | Number of retry attempts on failure |
+
+## License
+
+MIT

divineapi-1.0.0/divineapi/__init__.py

@@ -0,0 +1,137 @@
+"""DivineAPI Python SDK.
+
+Usage::
+
+    from divineapi import DivineApi
+
+    client = DivineApi(api_key="your-api-key", auth_token="your-bearer-token")
+    result = client.horoscope.daily(sign="aries", day=10, month=3, year=2024, tzone=5.5)
+    print(result)
+"""
+
+from typing import Any
+
+from .calculators import CalculatorApi
+from .client import BaseClient
+from .exceptions import (
+    AuthenticationError,
+    DivineApiError,
+    NetworkError,
+    NotFoundError,
+    RateLimitError,
+    ServerError,
+    ValidationError,
+)
+from .horoscope import HoroscopeApi
+from .indian import IndianApi
+from .lifestyle import LifestyleApi
+from .numerology import NumerologyApi
+from .pdf import PdfReportApi
+from .western import WesternApi
+
+__version__ = "1.0.0"
+
+__all__ = [
+    "DivineApi",
+    "DivineApiError",
+    "AuthenticationError",
+    "RateLimitError",
+    "ValidationError",
+    "NotFoundError",
+    "ServerError",
+    "NetworkError",
+]
+
+
+class DivineApi:
+    """Top-level client for the Divine API.
+
+    Args:
+        api_key: Your Divine API key (sent as ``api_key`` in every request body).
+        auth_token: Bearer token for the ``Authorization`` header.
+        timeout: HTTP request timeout in seconds (default 30).
+        max_retries: Number of retry attempts on transient failures (default 2).
+
+    Example::
+
+        client = DivineApi(api_key="...", auth_token="...")
+
+        # Horoscope & Tarot
+        client.horoscope.daily(sign="aries", day=10, month=3, year=2024, tzone=5.5)
+
+        # Indian Panchang
+        client.indian.panchang.find_panchang(
+            day=10, month=3, year=2024,
+            place="Delhi", lat=28.6, lon=77.2, tzone=5.5,
+        )
+
+        # Indian Kundli
+        client.indian.kundli.basic_astro_details(
+            full_name="John", day=1, month=1, year=1990,
+            hour=10, min=30, sec=0, gender="male",
+            place="Mumbai", lat=19.07, lon=72.87, tzone=5.5,
+        )
+
+        # Indian Match Making
+        client.indian.match_making.ashtakoot_milan(
+            p1_full_name="A", p1_day=1, p1_month=1, p1_year=1990,
+            p1_hour=10, p1_min=0, p1_sec=0, p1_gender="male",
+            p1_place="Delhi", p1_lat=28.6, p1_lon=77.2, p1_tzone=5.5,
+            p2_full_name="B", p2_day=5, p2_month=5, p2_year=1992,
+            p2_hour=14, p2_min=0, p2_sec=0, p2_gender="female",
+            p2_place="Mumbai", p2_lat=19.07, p2_lon=72.87, p2_tzone=5.5,
+        )
+
+        # Western Natal
+        client.western.natal.planetary_positions(
+            full_name="Jane", day=15, month=6, year=1995,
+            hour=8, min=0, sec=0, gender="female",
+            place="New York", lat=40.71, lon=-74.0, tzone=-5.0,
+        )
+
+        # Numerology
+        client.numerology.core_numbers(
+            full_name="John Doe", day=1, month=1, year=1990,
+            gender="male", method="pythagorean",
+        )
+
+        # PDF Reports
+        client.pdf.kundali_sampoorna(
+            full_name="John", day=1, month=1, year=1990,
+            hour=10, min=30, sec=0, gender="male",
+            place="Mumbai", lat=19.07, lon=72.87, tzone=5.5,
+            company_name="MyCompany",
+        )
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        auth_token: str,
+        timeout: int = 30,
+        max_retries: int = 2,
+    ) -> None:
+        self._client = BaseClient(
+            api_key=api_key,
+            auth_token=auth_token,
+            timeout=timeout,
+            max_retries=max_retries,
+        )
+
+        self.horoscope = HoroscopeApi(self._client)
+        self.indian = IndianApi(self._client)
+        self.western = WesternApi(self._client)
+        self.pdf = PdfReportApi(self._client)
+        self.numerology = NumerologyApi(self._client)
+        self.lifestyle = LifestyleApi(self._client)
+        self.calculators = CalculatorApi(self._client)
+
+    def close(self) -> None:
+        """Close the underlying HTTP session."""
+        self._client.close()
+
+    def __enter__(self) -> "DivineApi":
+        return self
+
+    def __exit__(self, *args: Any) -> None:
+        self.close()

divineapi-1.0.0/divineapi/calculators.py

@@ -0,0 +1,33 @@
+"""Calculator endpoints (astroapi-7)."""
+
+from typing import Any, Dict
+
+from .client import BaseClient
+
+HOST = "astroapi-7"
+
+
+class CalculatorApi:
+    """Fun calculator endpoints (FLAMES, Love Calculator)."""
+
+    def __init__(self, client: BaseClient) -> None:
+        self._c = client
+
+    def flames(self, full_name: str, partner_name: str) -> Dict[str, Any]:
+        """FLAMES Calculator."""
+        return self._c.post(HOST, "/calculator/v1/flames-calculator", {
+            "full_name": full_name, "partner_name": partner_name,
+        })
+
+    def love_calculator(
+        self,
+        your_name: str,
+        partner_name: str,
+        your_gender: str,
+        partner_gender: str,
+    ) -> Dict[str, Any]:
+        """Love Calculator."""
+        return self._c.post(HOST, "/calculator/v1/love-calculator", {
+            "your_name": your_name, "partner_name": partner_name,
+            "your_gender": your_gender, "partner_gender": partner_gender,
+        })