astroapi-io-client 0.2.0__tar.gz → 0.2.2__tar.gz

{astroapi_io_client-0.2.0 → astroapi_io_client-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: astroapi-io-client
-Version: 0.2.0
+Version: 0.2.2
 Summary: Synchronous Python client for the AstroAPI.io calculation gateway
 License-Expression: ISC
 Classifier: Programming Language :: Python :: 3
@@ -14,14 +14,14 @@ Dynamic: license-file
 
 # AstroAPI.io Python client
 
-The R194 version 0.2.0 publication candidate covers all forty-two calculation routes: forty-one standard operations plus the separate Pro Nakshatra Timeline. Minor-body calculations are not part of the contract. The latest registry release remains `astroapi-io-client==0.1.0` until the 0.2.0 publication gate completes.
+The R195 release version `astroapi-io-client==0.2.2` covers all forty-three calculation routes: forty-two standard operations plus the separate Pro Nakshatra Timeline. Minor-body calculations are not part of the contract.
 
 A synchronous client for Python 3.10+, with no runtime dependencies.
 The package import is `astroapi_client`; the distribution name is
-`astroapi-io-client`. Version 0.2.0 is the next PyPI publication candidate; package publication does not imply
+`astroapi-io-client`. Version 0.2.2 is the R195 release version; package availability does not imply
 new deployed API capabilities.
 
-Install from PyPI with `python -m pip install astroapi-io-client==0.2.0`, or from a local checkout using `python -m pip install ./clients/python`.
+Install from PyPI with `python -m pip install astroapi-io-client==0.2.2`, or from a local checkout using `python -m pip install ./clients/python`.
 Building needs setuptools and wheel; the installed client uses only the standard
 library. Keep API credentials in trusted server or command-line environments.
 
@@ -96,6 +96,7 @@ Type hints describe the server contract and do not perform response validation.
 | `event_calendar` **beta** | `calculateEventCalendar` | whole-second UTC interval and selected event families | `result["result"]["events"]`; optional iCalendar, strict opt-in fixed-column CSV, and opt-in deduplicated pass groups |
 | `event_rule_search` **beta** | `calculateEventRuleSearch` | bounded versioned AND/OR/NOT rules, location, and interval | validation/cost analysis plus sampled matches and windows |
 | `convention_compare` **beta** | `calculateConventionCompare` | two profiles with one birth, or two trusted signed responses | field-level differences without ranking or interpretation |
+| `chart_robustness` **beta** | `calculateChartRobustness` | unknown or approximate birth time plus 2–3 convention profiles | sampled stability classifications without rectification, ranking, or prediction |
 | `synastry_svg` **beta** | `calculateSynastrySvg` | two births; optional zodiac/houses/theme/aspects/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `transit_svg` **beta** | `calculateTransitSvg` | birth and transit date; optional display controls/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `natal_report` **beta** | `calculateNatalReport` | birth; optional zodiac/houses/theme/SVG/download | `result["html"]`, source-linked `result["facts"]`, optional `result["download"]` |

{astroapi_io_client-0.2.0 → astroapi_io_client-0.2.2}/README.md

@@ -1,13 +1,13 @@
 # AstroAPI.io Python client
 
-The R194 version 0.2.0 publication candidate covers all forty-two calculation routes: forty-one standard operations plus the separate Pro Nakshatra Timeline. Minor-body calculations are not part of the contract. The latest registry release remains `astroapi-io-client==0.1.0` until the 0.2.0 publication gate completes.
+The R195 release version `astroapi-io-client==0.2.2` covers all forty-three calculation routes: forty-two standard operations plus the separate Pro Nakshatra Timeline. Minor-body calculations are not part of the contract.
 
 A synchronous client for Python 3.10+, with no runtime dependencies.
 The package import is `astroapi_client`; the distribution name is
-`astroapi-io-client`. Version 0.2.0 is the next PyPI publication candidate; package publication does not imply
+`astroapi-io-client`. Version 0.2.2 is the R195 release version; package availability does not imply
 new deployed API capabilities.
 
-Install from PyPI with `python -m pip install astroapi-io-client==0.2.0`, or from a local checkout using `python -m pip install ./clients/python`.
+Install from PyPI with `python -m pip install astroapi-io-client==0.2.2`, or from a local checkout using `python -m pip install ./clients/python`.
 Building needs setuptools and wheel; the installed client uses only the standard
 library. Keep API credentials in trusted server or command-line environments.
 
@@ -82,6 +82,7 @@ Type hints describe the server contract and do not perform response validation.
 | `event_calendar` **beta** | `calculateEventCalendar` | whole-second UTC interval and selected event families | `result["result"]["events"]`; optional iCalendar, strict opt-in fixed-column CSV, and opt-in deduplicated pass groups |
 | `event_rule_search` **beta** | `calculateEventRuleSearch` | bounded versioned AND/OR/NOT rules, location, and interval | validation/cost analysis plus sampled matches and windows |
 | `convention_compare` **beta** | `calculateConventionCompare` | two profiles with one birth, or two trusted signed responses | field-level differences without ranking or interpretation |
+| `chart_robustness` **beta** | `calculateChartRobustness` | unknown or approximate birth time plus 2–3 convention profiles | sampled stability classifications without rectification, ranking, or prediction |
 | `synastry_svg` **beta** | `calculateSynastrySvg` | two births; optional zodiac/houses/theme/aspects/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `transit_svg` **beta** | `calculateTransitSvg` | birth and transit date; optional display controls/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `natal_report` **beta** | `calculateNatalReport` | birth; optional zodiac/houses/theme/SVG/download | `result["html"]`, source-linked `result["facts"]`, optional `result["download"]` |

{astroapi_io_client-0.2.0 → astroapi_io_client-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "astroapi-io-client"
-version = "0.2.0"
+version = "0.2.2"
 description = "Synchronous Python client for the AstroAPI.io calculation gateway"
 readme = "README.md"
 license = "ISC"

{astroapi_io_client-0.2.0 → astroapi_io_client-0.2.2}/src/astroapi_client/__init__.py

@@ -17,7 +17,7 @@ from .types import (
     GeographicLocation, RelocationChartInput, AstrocartographyBody, AstrocartographyInput,
     EclipseType, EclipseGeometryInput, EclipseObserverSnapshot, EclipseEvent, EclipseGeometryResponse, MoonPhaseSector, ElectionalAspectFilter,
     ElectionalFilters, ElectionalSearchInput,
-    EventRule, EventRuleSearchInput, ConventionProfile, ConventionCompareInput, ReleaseCompareInput,
+    EventRule, EventRuleSearchInput, ConventionProfile, ConventionCompareInput, ReleaseCompareInput, ChartRobustnessInput,
     NatalAnalysisAspectName, NatalAnalysisAspectOption, NatalAnalysisInput,
     AshtakootaInput, AshtakavargaInput, NumerologyInput, PlanetaryHoursInput,
     FixedStar, FixedStarsInput,
@@ -30,7 +30,7 @@ from .types import (
     PlaceSearchInput, TimezoneResolveInput, NatalContextInput,
 )
 
-__version__ = "0.2.0"
+__version__ = "0.2.2"
 __all__ = [
     "NumerologyInput", "verify_calculation_receipt",
     "AstroAPIClient", "AstroAPIError", "ClientBusyError", "HTTPError", "DavisonInput",
@@ -45,7 +45,7 @@ __all__ = [
     "GeographicLocation", "RelocationChartInput", "AstrocartographyBody", "AstrocartographyInput",
     "EclipseType", "EclipseGeometryInput", "EclipseObserverSnapshot", "EclipseEvent", "EclipseGeometryResponse", "MoonPhaseSector", "ElectionalAspectFilter",
     "ElectionalFilters", "ElectionalSearchInput",
-    "EventRule", "EventRuleSearchInput", "ConventionProfile", "ConventionCompareInput", "ReleaseCompareInput",
+    "EventRule", "EventRuleSearchInput", "ConventionProfile", "ConventionCompareInput", "ReleaseCompareInput", "ChartRobustnessInput",
     "NatalAnalysisAspectName", "NatalAnalysisAspectOption", "NatalAnalysisInput",
     "AshtakootaInput", "AshtakavargaInput", "PlanetaryHoursInput",
     "FixedStar", "FixedStarsInput",

{astroapi_io_client-0.2.0 → astroapi_io_client-0.2.2}/src/astroapi_client/_validation.py

@@ -664,6 +664,37 @@ def encode_request(route: str, payload: Any) -> bytes:
         if (type(location["lat"]) not in (int, float) or not math.isfinite(location["lat"]) or abs(location["lat"]) >= 90 or type(location["lon"]) not in (int, float) or not math.isfinite(location["lon"]) or abs(location["lon"]) > 180): _invalid("event rule coordinates are outside supported bounds.")
         if "sample_minutes" in data and data["sample_minutes"] not in (15, 30, 60): _invalid("sample_minutes must be 15, 30, or 60.")
         if "validate_only" in data and type(data["validate_only"]) is not bool: _invalid("validate_only must be a boolean.")
+    elif route == "chart-robustness":
+        _object(data, {"birth_time", "lat", "lon", "profiles"}, {"birth_time", "lat", "lon", "profiles"})
+        workflow = _object(data["birth_time"], {"status", "date", "time", "timezone", "uncertainty_minutes"}, {"status"})
+        if workflow["status"] == "unknown":
+            _object(workflow, {"status", "date", "timezone"}, {"status", "date", "timezone"})
+            _date(workflow["date"]); _timezone(workflow["timezone"])
+        elif workflow["status"] == "approximate":
+            _object(workflow, {"status", "date", "time", "timezone", "uncertainty_minutes"}, {"status", "date", "time", "timezone", "uncertainty_minutes"})
+            _date(workflow["date"]); _time(workflow["time"]); _timezone(workflow["timezone"])
+            uncertainty = workflow["uncertainty_minutes"]
+            if type(uncertainty) is not int or not 10 <= uncertainty <= 120 or uncertainty % 10:
+                _invalid("chart robustness uncertainty_minutes must be a multiple of 10 from 10 through 120.")
+        else:
+            _invalid("birth_time status must be unknown or approximate.")
+        if (type(data["lat"]) not in (int, float) or not math.isfinite(data["lat"]) or abs(data["lat"]) > 90
+                or type(data["lon"]) not in (int, float) or not math.isfinite(data["lon"]) or abs(data["lon"]) > 180):
+            _invalid("chart robustness coordinates are outside supported bounds.")
+        if type(data["profiles"]) is not list or not 2 <= len(data["profiles"]) <= 3:
+            _invalid("profiles must contain two or three entries.")
+        normalized_profiles = []
+        for profile in data["profiles"]:
+            _object(profile, {"zodiac", "ayanamsa", "house_system"}, {"zodiac", "house_system"})
+            _enum(profile["zodiac"], {"tropical", "sidereal"}, "zodiac must be tropical or sidereal.")
+            _enum(profile["house_system"], {"equal", "whole_sign", "placidus"}, "house_system is unsupported.")
+            if profile["zodiac"] == "tropical" and "ayanamsa" in profile:
+                _invalid("tropical profiles cannot include ayanamsa.")
+            if profile["zodiac"] == "sidereal" and ("ayanamsa" not in profile or profile["ayanamsa"] not in _AYANAMSAS):
+                _invalid("sidereal profiles require a supported ayanamsa.")
+            normalized_profiles.append(json.dumps(profile, sort_keys=True, separators=(",", ":")))
+        if len(set(normalized_profiles)) != len(normalized_profiles):
+            _invalid("profiles must be different.")
     elif route == "convention-compare":
         if set(data) == {"releases"}:
             if type(data["releases"]) is not list or len(data["releases"]) != 2 \

{astroapi_io_client-0.2.0 → astroapi_io_client-0.2.2}/src/astroapi_client/client.py

@@ -32,7 +32,7 @@ from .types import (
     MoonPhaseInput, MoonPhaseResponse, DavisonInput, PlanetaryEventsInput, PlanetaryEventsResponse,
     HouseIngressesInput, HouseIngressesResponse,
     AspectWindowsInput, AspectWindowsResponse,
-    EventRuleSearchInput, ConventionCompareInput, ReleaseCompareInput,
+    EventRuleSearchInput, ConventionCompareInput, ReleaseCompareInput, ChartRobustnessInput,
     EventCalendarInput, SynastrySvgInput, TransitSvgInput, NatalReportInput,
     BirthTimeSensitivityInput, RelocationChartInput, AstrocartographyInput,
     PlaceSearchInput, TimezoneResolveInput, NatalContextInput,
@@ -181,7 +181,7 @@ def _perform(
             "Content-Type": "application/json",
             "Accept": "application/json",
             "Accept-Encoding": "identity",
-            "User-Agent": "astroapi-io-client/0.2.0",
+            "User-Agent": "astroapi-io-client/0.2.2",
             "Connection": "close",
             **({"X-AstroAPI-Receipt": "v1"} if request_receipt else {}),
         })
@@ -285,7 +285,7 @@ class AstroAPIClient:
 
     def _request(self, route: str, payload: object) -> JSONResponse:
         body = encode_request(route, payload)
-        timeout = (self._timeline_timeout if route in {"nakshatra-timeline", "birth-time-sensitivity"}
+        timeout = (self._timeline_timeout if route in {"nakshatra-timeline", "birth-time-sensitivity", "chart-robustness"}
                    else self._planetary_events_timeout if route in {"planetary-events", "house-ingresses", "eclipse-geometry", "electional-search", "event-rule-search"}
                    else self._aspect_windows_timeout if route == "aspect-windows"
                    else self._timeout)
@@ -424,6 +424,10 @@ class AstroAPIClient:
         """BETA: compare conventions or two trusted signed release responses."""
         return self._request("convention-compare", payload)
 
+    def chart_robustness(self, payload: ChartRobustnessInput) -> JSONResponse:
+        """BETA: separate sampled birth-time and convention sensitivity."""
+        return self._request("chart-robustness", payload)
+
     def synastry_svg(self, payload: SynastrySvgInput) -> JSONResponse:
         """BETA: original deterministic double-wheel relationship SVG."""
         return self._request("synastry-svg", payload)

{astroapi_io_client-0.2.0 → astroapi_io_client-0.2.2}/src/astroapi_client/types.py

@@ -382,6 +382,14 @@ class ConventionCompareInput(TypedDict):
     birth: BirthInput
     profiles: list[ConventionProfile]
 
+
+class ChartRobustnessInput(TypedDict):
+    birth_time: BirthTimeWorkflowInput
+    lat: float
+    lon: float
+    profiles: list[ConventionProfile]
+
+
 NatalAnalysisAspectName = Literal[
     "conjunction", "semisextile", "semisquare", "sextile", "quintile",
     "square", "trine", "sesquiquadrate", "biquintile", "quincunx", "opposition",

{astroapi_io_client-0.2.0 → astroapi_io_client-0.2.2}/src/astroapi_io_client.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: astroapi-io-client
-Version: 0.2.0
+Version: 0.2.2
 Summary: Synchronous Python client for the AstroAPI.io calculation gateway
 License-Expression: ISC
 Classifier: Programming Language :: Python :: 3
@@ -14,14 +14,14 @@ Dynamic: license-file
 
 # AstroAPI.io Python client
 
-The R194 version 0.2.0 publication candidate covers all forty-two calculation routes: forty-one standard operations plus the separate Pro Nakshatra Timeline. Minor-body calculations are not part of the contract. The latest registry release remains `astroapi-io-client==0.1.0` until the 0.2.0 publication gate completes.
+The R195 release version `astroapi-io-client==0.2.2` covers all forty-three calculation routes: forty-two standard operations plus the separate Pro Nakshatra Timeline. Minor-body calculations are not part of the contract.
 
 A synchronous client for Python 3.10+, with no runtime dependencies.
 The package import is `astroapi_client`; the distribution name is
-`astroapi-io-client`. Version 0.2.0 is the next PyPI publication candidate; package publication does not imply
+`astroapi-io-client`. Version 0.2.2 is the R195 release version; package availability does not imply
 new deployed API capabilities.
 
-Install from PyPI with `python -m pip install astroapi-io-client==0.2.0`, or from a local checkout using `python -m pip install ./clients/python`.
+Install from PyPI with `python -m pip install astroapi-io-client==0.2.2`, or from a local checkout using `python -m pip install ./clients/python`.
 Building needs setuptools and wheel; the installed client uses only the standard
 library. Keep API credentials in trusted server or command-line environments.
 
@@ -96,6 +96,7 @@ Type hints describe the server contract and do not perform response validation.
 | `event_calendar` **beta** | `calculateEventCalendar` | whole-second UTC interval and selected event families | `result["result"]["events"]`; optional iCalendar, strict opt-in fixed-column CSV, and opt-in deduplicated pass groups |
 | `event_rule_search` **beta** | `calculateEventRuleSearch` | bounded versioned AND/OR/NOT rules, location, and interval | validation/cost analysis plus sampled matches and windows |
 | `convention_compare` **beta** | `calculateConventionCompare` | two profiles with one birth, or two trusted signed responses | field-level differences without ranking or interpretation |
+| `chart_robustness` **beta** | `calculateChartRobustness` | unknown or approximate birth time plus 2–3 convention profiles | sampled stability classifications without rectification, ranking, or prediction |
 | `synastry_svg` **beta** | `calculateSynastrySvg` | two births; optional zodiac/houses/theme/aspects/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `transit_svg` **beta** | `calculateTransitSvg` | birth and transit date; optional display controls/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `natal_report` **beta** | `calculateNatalReport` | birth; optional zodiac/houses/theme/SVG/download | `result["html"]`, source-linked `result["facts"]`, optional `result["download"]` |

{astroapi_io_client-0.2.0 → astroapi_io_client-0.2.2}/tests/test_client.py

@@ -62,9 +62,11 @@ ROUTES += [
 
 RULE_INPUT = {"rule_version": 1, "start_utc": "2026-01-01T00:00:00Z", "end_utc": "2026-01-02T00:00:00Z", "location": {"lat": 0, "lon": 0}, "sample_minutes": 60, "rule": {"all": [{"fact": "planet_sign", "body": "moon", "value": "Taurus"}]}}
 CONVENTION_INPUT = {"birth": BIRTH, "profiles": [{"zodiac": "tropical", "house_system": "equal"}, {"zodiac": "sidereal", "ayanamsa": "lahiri", "house_system": "whole_sign"}]}
+CHART_ROBUSTNESS_INPUT = {"birth_time": {"status": "approximate", "date": "2000-01-01", "time": "12:00", "timezone": "UTC", "uncertainty_minutes": 30}, "lat": 0, "lon": 0, "profiles": [{"zodiac": "tropical", "house_system": "equal"}, {"zodiac": "sidereal", "ayanamsa": "lahiri", "house_system": "whole_sign"}]}
 ROUTES += [
     ("event_rule_search", "event-rule-search", RULE_INPUT, {"type": "event_rule_search", "status": "beta", "rule_analysis": {}, "matching_samples": [], "sampled_candidate_windows": [], "metadata": {}}),
     ("convention_compare", "convention-compare", CONVENTION_INPUT, {"type": "convention_compare", "status": "beta", "profiles": [{}, {}], "differences": {}, "metadata": {}}),
+    ("chart_robustness", "chart-robustness", CHART_ROBUSTNESS_INPUT, {"type": "chart_robustness", "status": "beta", "profiles": [{}, {}], "facts": [{} for _ in range(22)], "summary": {}, "evidence": {}, "metadata": {}}),
 ]
 
 @contextmanager
@@ -147,9 +149,11 @@ def local_client(url, **options):
 
 RULE_INPUT = {"rule_version": 1, "start_utc": "2026-01-01T00:00:00Z", "end_utc": "2026-01-02T00:00:00Z", "location": {"lat": 0, "lon": 0}, "sample_minutes": 60, "rule": {"all": [{"fact": "planet_sign", "body": "moon", "value": "Taurus"}]}}
 CONVENTION_INPUT = {"birth": BIRTH, "profiles": [{"zodiac": "tropical", "house_system": "equal"}, {"zodiac": "sidereal", "ayanamsa": "lahiri", "house_system": "whole_sign"}]}
+CHART_ROBUSTNESS_INPUT = {"birth_time": {"status": "approximate", "date": "2000-01-01", "time": "12:00", "timezone": "UTC", "uncertainty_minutes": 30}, "lat": 0, "lon": 0, "profiles": [{"zodiac": "tropical", "house_system": "equal"}, {"zodiac": "sidereal", "ayanamsa": "lahiri", "house_system": "whole_sign"}]}
 ROUTES += [
     ("event_rule_search", "event-rule-search", RULE_INPUT, {"type": "event_rule_search", "status": "beta", "rule_analysis": {}, "matching_samples": [], "sampled_candidate_windows": [], "metadata": {}}),
     ("convention_compare", "convention-compare", CONVENTION_INPUT, {"type": "convention_compare", "status": "beta", "profiles": [{}, {}], "differences": {}, "metadata": {}}),
+    ("chart_robustness", "chart-robustness", CHART_ROBUSTNESS_INPUT, {"type": "chart_robustness", "status": "beta", "profiles": [{}, {}], "facts": [{} for _ in range(22)], "summary": {}, "evidence": {}, "metadata": {}}),
 ]
 
 @contextmanager
@@ -401,6 +405,10 @@ class ClientTests(unittest.TestCase):
                 client.convention_compare({"birth": BIRTH, "profiles": [{"zodiac": "tropical", "house_system": "equal"}] * 2})
             with self.assertRaises(ValidationError):
                 client.convention_compare({"birth": BIRTH, "profiles": [{"zodiac": "sidereal", "house_system": "whole_sign"}, {"zodiac": "tropical", "house_system": "equal"}]})
+            with self.assertRaises(ValidationError):
+                client.chart_robustness({**CHART_ROBUSTNESS_INPUT, "birth_time": {**CHART_ROBUSTNESS_INPUT["birth_time"], "time": "noon"}})
+            with self.assertRaises(ValidationError):
+                client.chart_robustness({**CHART_ROBUSTNESS_INPUT, "profiles": [CHART_ROBUSTNESS_INPUT["profiles"][0]] * 2})
 
 
     def test_request_body_limit(self):