roxy-sdk 0.1.1__tar.gz

roxy_sdk-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RoxyAPI
+
+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.

roxy_sdk-0.1.1/PKG-INFO

@@ -0,0 +1,246 @@
+Metadata-Version: 2.4
+Name: roxy-sdk
+Version: 0.1.1
+Summary: Python SDK for RoxyAPI. Astrology, tarot, numerology, and more.
+Keywords: astrology,tarot,numerology,api,sdk,vedic,horoscope
+Author: RoxyAPI
+Author-email: RoxyAPI <hi@roxyapi.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+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: Typing :: Typed
+Requires-Dist: httpx>=0.27.0
+Requires-Python: >=3.10
+Project-URL: Homepage, https://roxyapi.com
+Project-URL: Repository, https://github.com/RoxyAPI/sdk-python
+Project-URL: Documentation, https://roxyapi.com/docs
+Description-Content-Type: text/markdown
+
+# roxy-sdk
+
+[![PyPI](https://img.shields.io/pypi/v/roxy-sdk)](https://pypi.org/project/roxy-sdk/)
+[![Python](https://img.shields.io/pypi/pyversions/roxy-sdk)](https://pypi.org/project/roxy-sdk/)
+[![Docs](https://img.shields.io/badge/docs-roxyapi.com-blue)](https://roxyapi.com/docs)
+[![API Reference](https://img.shields.io/badge/api%20reference-roxyapi.com-blue)](https://roxyapi.com/api-reference)
+[![License](https://img.shields.io/github/license/RoxyAPI/sdk-python)](https://github.com/RoxyAPI/sdk-python/blob/main/LICENSE)
+
+Python SDK for [RoxyAPI](https://roxyapi.com). Astrology, tarot, numerology, I Ching, crystals, angel numbers, dream interpretation, biorhythm, and more. One API key, 11 domains, 120+ endpoints.
+
+## Install
+
+```bash
+pip install roxy-sdk
+```
+
+## Quickstart
+
+```python
+from roxy_sdk import create_roxy
+
+roxy = create_roxy("your-api-key")
+horoscope = roxy.astrology.get_daily_horoscope(sign="aries")
+print(horoscope)
+```
+
+Get your API key at [roxyapi.com/pricing](https://roxyapi.com/pricing). Free test keys available on the [interactive docs](https://roxyapi.com/api-reference).
+
+## Recipes
+
+### Dating app: zodiac compatibility
+
+```python
+person1 = {"date": "1990-01-15", "time": "14:30:00", "latitude": 28.61, "longitude": 77.20}
+person2 = {"date": "1992-07-22", "time": "09:00:00", "latitude": 19.07, "longitude": 72.87}
+
+score = roxy.astrology.calculate_compatibility(person1=person1, person2=person2)
+print(f"Compatibility: {score}")
+```
+
+### Wellness app: daily tarot card
+
+```python
+card = roxy.tarot.get_daily_card()
+print(f"Today: {card}")
+```
+
+### Journaling app: dream interpretation
+
+```python
+symbol = roxy.dreams.get_dream_symbol(id="flying")
+print(f"Flying in dreams: {symbol}")
+```
+
+### Numerology calculator: life path number
+
+```python
+result = roxy.numerology.calculate_life_path(year=1990, month=1, day=15)
+print(f"Life Path: {result}")
+
+chart = roxy.numerology.generate_numerology_chart(full_name="Jane Smith", year=1990, month=1, day=15)
+print(f"Full chart: {chart}")
+```
+
+### Crystal healing: zodiac crystals
+
+```python
+crystals = roxy.crystals.get_crystals_by_zodiac(sign="scorpio")
+print(f"Scorpio crystals: {crystals}")
+```
+
+### I Ching: daily reading
+
+```python
+reading = roxy.iching.cast_daily_reading()
+print(f"I Ching: {reading}")
+```
+
+## Domain reference
+
+| Domain | Property | What it covers |
+|--------|----------|----------------|
+| Western Astrology | `roxy.astrology` | Natal charts, horoscopes, synastry, compatibility, transits, moon phases |
+| Vedic Astrology | `roxy.vedic_astrology` | Birth charts, dashas, nakshatras, panchang, KP system, doshas, yogas |
+| Tarot | `roxy.tarot` | Spreads, daily pulls, yes/no oracle, Celtic Cross, custom layouts |
+| Numerology | `roxy.numerology` | Life path, expression, soul urge, personal year, karmic analysis |
+| I Ching | `roxy.iching` | Hexagrams, trigrams, coin casting, daily readings |
+| Crystals | `roxy.crystals` | Healing properties, zodiac/chakra pairings, birthstones, search |
+| Angel Numbers | `roxy.angel_numbers` | Number meanings, pattern analysis, daily guidance |
+| Dreams | `roxy.dreams` | Symbol dictionary, interpretations, daily guidance |
+| Biorhythm | `roxy.biorhythm` | Physical, emotional, intellectual cycles, forecasts, compatibility |
+| Location | `roxy.location` | City geocoding for birth chart coordinates |
+| Usage | `roxy.usage` | API usage stats and subscription info |
+
+## Async support
+
+Every method has an `_async` suffix variant for use with asyncio:
+
+```python
+import asyncio
+from roxy_sdk import create_roxy
+
+async def main():
+    roxy = create_roxy("your-api-key")
+    horoscope = await roxy.astrology.get_daily_horoscope_async(sign="aries")
+    card = await roxy.tarot.get_daily_card_async()
+    print(horoscope, card)
+
+asyncio.run(main())
+```
+
+## Framework examples
+
+The SDK is framework-agnostic. It works with Django, Flask, FastAPI, or any Python project.
+
+### FastAPI
+
+```python
+from fastapi import FastAPI
+from roxy_sdk import create_roxy
+
+app = FastAPI()
+roxy = create_roxy("your-api-key")
+
+@app.get("/horoscope/{sign}")
+async def horoscope(sign: str):
+    return await roxy.astrology.get_daily_horoscope_async(sign=sign)
+```
+
+### Flask
+
+```python
+from flask import Flask, jsonify
+from roxy_sdk import create_roxy
+
+app = Flask(__name__)
+roxy = create_roxy("your-api-key")
+
+@app.route("/horoscope/<sign>")
+def horoscope(sign):
+    return jsonify(roxy.astrology.get_daily_horoscope(sign=sign))
+```
+
+### Django (views.py)
+
+```python
+from django.http import JsonResponse
+from roxy_sdk import create_roxy
+
+roxy = create_roxy("your-api-key")
+
+def horoscope(request, sign):
+    return JsonResponse(roxy.astrology.get_daily_horoscope(sign=sign))
+```
+
+## Error handling
+
+All API errors raise `RoxyAPIError` with `error` (human-readable message), `code` (machine-readable, stable), and `status_code` attributes:
+
+```python
+from roxy_sdk import create_roxy, RoxyAPIError
+
+roxy = create_roxy("your-api-key")
+
+try:
+    result = roxy.astrology.get_daily_horoscope(sign="invalid")
+except RoxyAPIError as e:
+    print(f"Error: {e.error}")
+    print(f"Code: {e.code}")
+    print(f"Status: {e.status_code}")
+```
+
+Error codes:
+
+| Status | Code | When |
+|--------|------|------|
+| 400 | `validation_error` | Missing or invalid parameters |
+| 401 | `api_key_required` | No API key provided |
+| 401 | `invalid_api_key` | Key format invalid or tampered |
+| 429 | `rate_limit_exceeded` | Monthly quota reached |
+| 404 | `not_found` | Resource not found |
+| 500 | `internal_error` | Server error |
+
+## Environment variable
+
+Store your API key in an environment variable for production use:
+
+```python
+import os
+from roxy_sdk import create_roxy
+
+roxy = create_roxy(os.environ["ROXY_API_KEY"])
+```
+
+## Configuration
+
+`create_roxy` accepts optional parameters for advanced usage:
+
+```python
+roxy = create_roxy(
+    api_key="your-api-key",
+    base_url="https://roxyapi.com/api/v2",  # default, override for local development
+    timeout=30.0,                            # request timeout in seconds (default: 30)
+)
+```
+
+The client reuses HTTP connections for performance. For explicit cleanup, use the context manager:
+
+```python
+with create_roxy("your-api-key") as roxy:
+    horoscope = roxy.astrology.get_daily_horoscope(sign="aries")
+# connections closed automatically
+```
+
+## Links
+
+- [API Documentation](https://roxyapi.com/docs)
+- [Interactive API Reference](https://roxyapi.com/api-reference)
+- [Pricing](https://roxyapi.com/pricing)
+- [MCP for AI Agents](https://roxyapi.com/docs/mcp)
+- [Starter Apps](https://roxyapi.com/starters)
+- [TypeScript SDK](https://www.npmjs.com/package/@roxyapi/sdk)

roxy_sdk-0.1.1/README.md

@@ -0,0 +1,222 @@
+# roxy-sdk
+
+[![PyPI](https://img.shields.io/pypi/v/roxy-sdk)](https://pypi.org/project/roxy-sdk/)
+[![Python](https://img.shields.io/pypi/pyversions/roxy-sdk)](https://pypi.org/project/roxy-sdk/)
+[![Docs](https://img.shields.io/badge/docs-roxyapi.com-blue)](https://roxyapi.com/docs)
+[![API Reference](https://img.shields.io/badge/api%20reference-roxyapi.com-blue)](https://roxyapi.com/api-reference)
+[![License](https://img.shields.io/github/license/RoxyAPI/sdk-python)](https://github.com/RoxyAPI/sdk-python/blob/main/LICENSE)
+
+Python SDK for [RoxyAPI](https://roxyapi.com). Astrology, tarot, numerology, I Ching, crystals, angel numbers, dream interpretation, biorhythm, and more. One API key, 11 domains, 120+ endpoints.
+
+## Install
+
+```bash
+pip install roxy-sdk
+```
+
+## Quickstart
+
+```python
+from roxy_sdk import create_roxy
+
+roxy = create_roxy("your-api-key")
+horoscope = roxy.astrology.get_daily_horoscope(sign="aries")
+print(horoscope)
+```
+
+Get your API key at [roxyapi.com/pricing](https://roxyapi.com/pricing). Free test keys available on the [interactive docs](https://roxyapi.com/api-reference).
+
+## Recipes
+
+### Dating app: zodiac compatibility
+
+```python
+person1 = {"date": "1990-01-15", "time": "14:30:00", "latitude": 28.61, "longitude": 77.20}
+person2 = {"date": "1992-07-22", "time": "09:00:00", "latitude": 19.07, "longitude": 72.87}
+
+score = roxy.astrology.calculate_compatibility(person1=person1, person2=person2)
+print(f"Compatibility: {score}")
+```
+
+### Wellness app: daily tarot card
+
+```python
+card = roxy.tarot.get_daily_card()
+print(f"Today: {card}")
+```
+
+### Journaling app: dream interpretation
+
+```python
+symbol = roxy.dreams.get_dream_symbol(id="flying")
+print(f"Flying in dreams: {symbol}")
+```
+
+### Numerology calculator: life path number
+
+```python
+result = roxy.numerology.calculate_life_path(year=1990, month=1, day=15)
+print(f"Life Path: {result}")
+
+chart = roxy.numerology.generate_numerology_chart(full_name="Jane Smith", year=1990, month=1, day=15)
+print(f"Full chart: {chart}")
+```
+
+### Crystal healing: zodiac crystals
+
+```python
+crystals = roxy.crystals.get_crystals_by_zodiac(sign="scorpio")
+print(f"Scorpio crystals: {crystals}")
+```
+
+### I Ching: daily reading
+
+```python
+reading = roxy.iching.cast_daily_reading()
+print(f"I Ching: {reading}")
+```
+
+## Domain reference
+
+| Domain | Property | What it covers |
+|--------|----------|----------------|
+| Western Astrology | `roxy.astrology` | Natal charts, horoscopes, synastry, compatibility, transits, moon phases |
+| Vedic Astrology | `roxy.vedic_astrology` | Birth charts, dashas, nakshatras, panchang, KP system, doshas, yogas |
+| Tarot | `roxy.tarot` | Spreads, daily pulls, yes/no oracle, Celtic Cross, custom layouts |
+| Numerology | `roxy.numerology` | Life path, expression, soul urge, personal year, karmic analysis |
+| I Ching | `roxy.iching` | Hexagrams, trigrams, coin casting, daily readings |
+| Crystals | `roxy.crystals` | Healing properties, zodiac/chakra pairings, birthstones, search |
+| Angel Numbers | `roxy.angel_numbers` | Number meanings, pattern analysis, daily guidance |
+| Dreams | `roxy.dreams` | Symbol dictionary, interpretations, daily guidance |
+| Biorhythm | `roxy.biorhythm` | Physical, emotional, intellectual cycles, forecasts, compatibility |
+| Location | `roxy.location` | City geocoding for birth chart coordinates |
+| Usage | `roxy.usage` | API usage stats and subscription info |
+
+## Async support
+
+Every method has an `_async` suffix variant for use with asyncio:
+
+```python
+import asyncio
+from roxy_sdk import create_roxy
+
+async def main():
+    roxy = create_roxy("your-api-key")
+    horoscope = await roxy.astrology.get_daily_horoscope_async(sign="aries")
+    card = await roxy.tarot.get_daily_card_async()
+    print(horoscope, card)
+
+asyncio.run(main())
+```
+
+## Framework examples
+
+The SDK is framework-agnostic. It works with Django, Flask, FastAPI, or any Python project.
+
+### FastAPI
+
+```python
+from fastapi import FastAPI
+from roxy_sdk import create_roxy
+
+app = FastAPI()
+roxy = create_roxy("your-api-key")
+
+@app.get("/horoscope/{sign}")
+async def horoscope(sign: str):
+    return await roxy.astrology.get_daily_horoscope_async(sign=sign)
+```
+
+### Flask
+
+```python
+from flask import Flask, jsonify
+from roxy_sdk import create_roxy
+
+app = Flask(__name__)
+roxy = create_roxy("your-api-key")
+
+@app.route("/horoscope/<sign>")
+def horoscope(sign):
+    return jsonify(roxy.astrology.get_daily_horoscope(sign=sign))
+```
+
+### Django (views.py)
+
+```python
+from django.http import JsonResponse
+from roxy_sdk import create_roxy
+
+roxy = create_roxy("your-api-key")
+
+def horoscope(request, sign):
+    return JsonResponse(roxy.astrology.get_daily_horoscope(sign=sign))
+```
+
+## Error handling
+
+All API errors raise `RoxyAPIError` with `error` (human-readable message), `code` (machine-readable, stable), and `status_code` attributes:
+
+```python
+from roxy_sdk import create_roxy, RoxyAPIError
+
+roxy = create_roxy("your-api-key")
+
+try:
+    result = roxy.astrology.get_daily_horoscope(sign="invalid")
+except RoxyAPIError as e:
+    print(f"Error: {e.error}")
+    print(f"Code: {e.code}")
+    print(f"Status: {e.status_code}")
+```
+
+Error codes:
+
+| Status | Code | When |
+|--------|------|------|
+| 400 | `validation_error` | Missing or invalid parameters |
+| 401 | `api_key_required` | No API key provided |
+| 401 | `invalid_api_key` | Key format invalid or tampered |
+| 429 | `rate_limit_exceeded` | Monthly quota reached |
+| 404 | `not_found` | Resource not found |
+| 500 | `internal_error` | Server error |
+
+## Environment variable
+
+Store your API key in an environment variable for production use:
+
+```python
+import os
+from roxy_sdk import create_roxy
+
+roxy = create_roxy(os.environ["ROXY_API_KEY"])
+```
+
+## Configuration
+
+`create_roxy` accepts optional parameters for advanced usage:
+
+```python
+roxy = create_roxy(
+    api_key="your-api-key",
+    base_url="https://roxyapi.com/api/v2",  # default, override for local development
+    timeout=30.0,                            # request timeout in seconds (default: 30)
+)
+```
+
+The client reuses HTTP connections for performance. For explicit cleanup, use the context manager:
+
+```python
+with create_roxy("your-api-key") as roxy:
+    horoscope = roxy.astrology.get_daily_horoscope(sign="aries")
+# connections closed automatically
+```
+
+## Links
+
+- [API Documentation](https://roxyapi.com/docs)
+- [Interactive API Reference](https://roxyapi.com/api-reference)
+- [Pricing](https://roxyapi.com/pricing)
+- [MCP for AI Agents](https://roxyapi.com/docs/mcp)
+- [Starter Apps](https://roxyapi.com/starters)
+- [TypeScript SDK](https://www.npmjs.com/package/@roxyapi/sdk)

roxy_sdk-0.1.1/pyproject.toml

@@ -0,0 +1,63 @@
+[build-system]
+requires = ["uv_build>=0.11.6,<0.12"]
+build-backend = "uv_build"
+
+[project]
+name = "roxy-sdk"
+version = "0.1.1"
+description = "Python SDK for RoxyAPI. Astrology, tarot, numerology, and more."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.10"
+dependencies = [
+    "httpx>=0.27.0",
+]
+authors = [
+    { name = "RoxyAPI", email = "hi@roxyapi.com" },
+]
+keywords = ["astrology", "tarot", "numerology", "api", "sdk", "vedic", "horoscope"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://roxyapi.com"
+Repository = "https://github.com/RoxyAPI/sdk-python"
+Documentation = "https://roxyapi.com/docs"
+
+[tool.uv.build-backend]
+module-name = "roxy_sdk"
+module-root = "src"
+source-exclude = ["**/_generated/**", "**/__pycache__/**"]
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "mypy>=1.9",
+    "ruff>=0.4",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+exclude = ["src/roxy_sdk/factory.py", "codegen.py"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

roxy_sdk-0.1.1/src/roxy_sdk/__init__.py

@@ -0,0 +1,7 @@
+"""RoxyAPI Python SDK."""
+
+from roxy_sdk.factory import Roxy, RoxyAPIError, create_roxy
+from roxy_sdk.version import VERSION
+
+__version__ = VERSION
+__all__ = ["Roxy", "RoxyAPIError", "create_roxy", "__version__"]