astroapi-io-client 0.2.3__tar.gz → 0.2.4__tar.gz

{astroapi_io_client-0.2.3 → astroapi_io_client-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: astroapi-io-client
-Version: 0.2.3
+Version: 0.2.4
 Summary: Synchronous Python client for the AstroAPI.io calculation gateway
 License-Expression: ISC
 Classifier: Programming Language :: Python :: 3
@@ -14,11 +14,11 @@ Dynamic: license-file
 
 # AstroAPI.io Python client
 
-The R196 source version `astroapi-io-client==0.2.3` covers all forty-four calculation routes: forty-three standard operations plus the separate Pro Nakshatra Timeline. Minor-body calculations are not part of the contract.
+The R197 source version `astroapi-io-client==0.2.4` covers all forty-five calculation routes: forty-four 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.2 is the published R195 package; 0.2.3 is source-only and package availability never implies deployed API capabilities.
+`astroapi-io-client`. Version 0.2.2 is the published R195 package; 0.2.4 is source-only and package availability never implies deployed API capabilities.
 
 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
@@ -97,6 +97,7 @@ Type hints describe the server contract and do not perform response validation.
 | `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 |
 | `civil_time_audit` **beta** | `calculateCivilTimeAudit` | pinned place, local date/time, one explicit profile | both repeated-time chart candidates and exact 22-fact differences, or no shifted gap time |
+| `chart_input_readiness` **beta** | `calculateChartInputReadiness` | pinned place, exact/approximate/unknown time quality, explicit profile | route readiness plus resolved, candidate, or sampled evidence for 22 facts |
 | `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.3 → astroapi_io_client-0.2.4}/README.md

@@ -1,10 +1,10 @@
 # AstroAPI.io Python client
 
-The R196 source version `astroapi-io-client==0.2.3` covers all forty-four calculation routes: forty-three standard operations plus the separate Pro Nakshatra Timeline. Minor-body calculations are not part of the contract.
+The R197 source version `astroapi-io-client==0.2.4` covers all forty-five calculation routes: forty-four 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.2 is the published R195 package; 0.2.3 is source-only and package availability never implies deployed API capabilities.
+`astroapi-io-client`. Version 0.2.2 is the published R195 package; 0.2.4 is source-only and package availability never implies deployed API capabilities.
 
 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
@@ -83,6 +83,7 @@ Type hints describe the server contract and do not perform response validation.
 | `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 |
 | `civil_time_audit` **beta** | `calculateCivilTimeAudit` | pinned place, local date/time, one explicit profile | both repeated-time chart candidates and exact 22-fact differences, or no shifted gap time |
+| `chart_input_readiness` **beta** | `calculateChartInputReadiness` | pinned place, exact/approximate/unknown time quality, explicit profile | route readiness plus resolved, candidate, or sampled evidence for 22 facts |
 | `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.3 → astroapi_io_client-0.2.4}/pyproject.toml

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

{astroapi_io_client-0.2.3 → astroapi_io_client-0.2.4}/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, ChartRobustnessInput, CivilTimeAuditInput,
+    EventRule, EventRuleSearchInput, ConventionProfile, ConventionCompareInput, ReleaseCompareInput, ChartRobustnessInput, CivilTimeAuditInput, ChartInputReadinessExactTime, ChartInputReadinessApproximateTime, ChartInputReadinessUnknownTime, ChartInputReadinessBirthTime, ChartInputReadinessInput,
     NatalAnalysisAspectName, NatalAnalysisAspectOption, NatalAnalysisInput,
     AshtakootaInput, AshtakavargaInput, NumerologyInput, PlanetaryHoursInput,
     FixedStar, FixedStarsInput,
@@ -30,7 +30,7 @@ from .types import (
     PlaceSearchInput, TimezoneResolveInput, NatalContextInput,
 )
 
-__version__ = "0.2.3"
+__version__ = "0.2.4"
 __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", "ChartRobustnessInput", "CivilTimeAuditInput",
+    "EventRule", "EventRuleSearchInput", "ConventionProfile", "ConventionCompareInput", "ReleaseCompareInput", "ChartRobustnessInput", "CivilTimeAuditInput", "ChartInputReadinessExactTime", "ChartInputReadinessApproximateTime", "ChartInputReadinessUnknownTime", "ChartInputReadinessBirthTime", "ChartInputReadinessInput",
     "NatalAnalysisAspectName", "NatalAnalysisAspectOption", "NatalAnalysisInput",
     "AshtakootaInput", "AshtakavargaInput", "PlanetaryHoursInput",
     "FixedStar", "FixedStarsInput",

{astroapi_io_client-0.2.3 → astroapi_io_client-0.2.4}/src/astroapi_client/_validation.py

@@ -676,6 +676,32 @@ def encode_request(route: str, payload: Any) -> bytes:
             _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.")
+    elif route == "chart-input-readiness":
+        _object(data, {"place_id", "birth_time", "profile"}, {"place_id", "birth_time", "profile"})
+        if type(data["place_id"]) is not str or re.fullmatch(r"geonames:[1-9][0-9]{0,11}:2026-10-02", data["place_id"]) is None:
+            _invalid("place_id must be a current versioned AstroAPI GeoNames place ID.")
+        workflow = _object(data["birth_time"], {"status", "date", "time", "uncertainty_minutes"}, {"status", "date"})
+        if workflow["status"] == "exact":
+            _object(workflow, {"status", "date", "time"}, {"status", "date", "time"})
+            _date(workflow["date"]); _time(workflow["time"])
+        elif workflow["status"] == "approximate":
+            _object(workflow, {"status", "date", "time", "uncertainty_minutes"}, {"status", "date", "time", "uncertainty_minutes"})
+            _date(workflow["date"]); _time(workflow["time"])
+            uncertainty = workflow["uncertainty_minutes"]
+            if type(uncertainty) is not int or not 5 <= uncertainty <= 180 or uncertainty % 5:
+                _invalid("chart input readiness uncertainty_minutes must be a multiple of 5 from 5 through 180.")
+        elif workflow["status"] == "unknown":
+            _object(workflow, {"status", "date"}, {"status", "date"})
+            _date(workflow["date"])
+        else:
+            _invalid("birth_time status must be exact, approximate, or unknown.")
+        profile = _object(data["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.")
     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"})

{astroapi_io_client-0.2.3 → astroapi_io_client-0.2.4}/src/astroapi_client/client.py

@@ -32,7 +32,7 @@ from .types import (
     MoonPhaseInput, MoonPhaseResponse, DavisonInput, PlanetaryEventsInput, PlanetaryEventsResponse,
     HouseIngressesInput, HouseIngressesResponse,
     AspectWindowsInput, AspectWindowsResponse,
-    EventRuleSearchInput, ConventionCompareInput, ReleaseCompareInput, ChartRobustnessInput, CivilTimeAuditInput,
+    EventRuleSearchInput, ConventionCompareInput, ReleaseCompareInput, ChartRobustnessInput, CivilTimeAuditInput, ChartInputReadinessInput,
     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.3",
+            "User-Agent": "astroapi-io-client/0.2.4",
             "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", "chart-robustness"}
+        timeout = (self._timeline_timeout if route in {"nakshatra-timeline", "birth-time-sensitivity", "chart-robustness", "chart-input-readiness"}
                    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)
@@ -432,6 +432,10 @@ class AstroAPIClient:
         """BETA: never guess a repeated or nonexistent local civil time."""
         return self._request("civil-time-audit", payload)
 
+    def chart_input_readiness(self, payload: ChartInputReadinessInput) -> JSONResponse:
+        """BETA: gate exact chart workflows against birth-time data quality."""
+        return self._request("chart-input-readiness", 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.3 → astroapi_io_client-0.2.4}/src/astroapi_client/types.py

@@ -382,6 +382,33 @@ class CivilTimeAuditInput(TypedDict):
     profile: ConventionProfile
 
 
+class ChartInputReadinessExactTime(TypedDict):
+    status: Literal["exact"]
+    date: str
+    time: str
+
+
+class ChartInputReadinessApproximateTime(TypedDict):
+    status: Literal["approximate"]
+    date: str
+    time: str
+    uncertainty_minutes: int
+
+
+class ChartInputReadinessUnknownTime(TypedDict):
+    status: Literal["unknown"]
+    date: str
+
+
+ChartInputReadinessBirthTime = ChartInputReadinessExactTime | ChartInputReadinessApproximateTime | ChartInputReadinessUnknownTime
+
+
+class ChartInputReadinessInput(TypedDict):
+    place_id: str
+    birth_time: ChartInputReadinessBirthTime
+    profile: ConventionProfile
+
+
 class ReleaseCompareInput(TypedDict):
     releases: list[JSONResponse]
 

{astroapi_io_client-0.2.3 → astroapi_io_client-0.2.4}/src/astroapi_io_client.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: astroapi-io-client
-Version: 0.2.3
+Version: 0.2.4
 Summary: Synchronous Python client for the AstroAPI.io calculation gateway
 License-Expression: ISC
 Classifier: Programming Language :: Python :: 3
@@ -14,11 +14,11 @@ Dynamic: license-file
 
 # AstroAPI.io Python client
 
-The R196 source version `astroapi-io-client==0.2.3` covers all forty-four calculation routes: forty-three standard operations plus the separate Pro Nakshatra Timeline. Minor-body calculations are not part of the contract.
+The R197 source version `astroapi-io-client==0.2.4` covers all forty-five calculation routes: forty-four 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.2 is the published R195 package; 0.2.3 is source-only and package availability never implies deployed API capabilities.
+`astroapi-io-client`. Version 0.2.2 is the published R195 package; 0.2.4 is source-only and package availability never implies deployed API capabilities.
 
 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
@@ -97,6 +97,7 @@ Type hints describe the server contract and do not perform response validation.
 | `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 |
 | `civil_time_audit` **beta** | `calculateCivilTimeAudit` | pinned place, local date/time, one explicit profile | both repeated-time chart candidates and exact 22-fact differences, or no shifted gap time |
+| `chart_input_readiness` **beta** | `calculateChartInputReadiness` | pinned place, exact/approximate/unknown time quality, explicit profile | route readiness plus resolved, candidate, or sampled evidence for 22 facts |
 | `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.3 → astroapi_io_client-0.2.4}/tests/test_client.py

@@ -63,12 +63,14 @@ 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"}]}
 CIVIL_TIME_AUDIT_INPUT = {"place_id": "geonames:5128581:2026-10-02", "date": "2024-11-03", "time": "01:30", "profile": {"zodiac": "tropical", "house_system": "equal"}}
+CHART_INPUT_READINESS_INPUT = {"place_id": "geonames:5128581:2026-10-02", "birth_time": {"status": "exact", "date": "2024-11-03", "time": "01:30"}, "profile": {"zodiac": "tropical", "house_system": "equal"}}
 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": {}}),
     ("civil_time_audit", "civil-time-audit", CIVIL_TIME_AUDIT_INPUT, {"type": "civil_time_audit", "status": "beta", "resolution": {}, "profile": {}, "calculation_ready": False, "requires_selection": True, "candidates": [], "comparison": {}, "metadata": {}}),
+    ("chart_input_readiness", "chart-input-readiness", CHART_INPUT_READINESS_INPUT, {"type": "chart_input_readiness", "status": "beta", "birth_time_status": "exact", "profile": {}, "resolution": {}, "exact_chart_ready": False, "next_action": "select_civil_time_candidate", "workflows": [{}, {}, {}, {}], "fact_evidence": [], "summary": {}, "evidence": {}, "metadata": {}}),
 ]
 
 @contextmanager
@@ -152,12 +154,14 @@ 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"}]}
 CIVIL_TIME_AUDIT_INPUT = {"place_id": "geonames:5128581:2026-10-02", "date": "2024-11-03", "time": "01:30", "profile": {"zodiac": "tropical", "house_system": "equal"}}
+CHART_INPUT_READINESS_INPUT = {"place_id": "geonames:5128581:2026-10-02", "birth_time": {"status": "exact", "date": "2024-11-03", "time": "01:30"}, "profile": {"zodiac": "tropical", "house_system": "equal"}}
 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": {}}),
     ("civil_time_audit", "civil-time-audit", CIVIL_TIME_AUDIT_INPUT, {"type": "civil_time_audit", "status": "beta", "resolution": {}, "profile": {}, "calculation_ready": False, "requires_selection": True, "candidates": [], "comparison": {}, "metadata": {}}),
+    ("chart_input_readiness", "chart-input-readiness", CHART_INPUT_READINESS_INPUT, {"type": "chart_input_readiness", "status": "beta", "birth_time_status": "exact", "profile": {}, "resolution": {}, "exact_chart_ready": False, "next_action": "select_civil_time_candidate", "workflows": [{}, {}, {}, {}], "fact_evidence": [], "summary": {}, "evidence": {}, "metadata": {}}),
 ]
 
 @contextmanager
@@ -415,6 +419,8 @@ class ClientTests(unittest.TestCase):
                 client.chart_robustness({**CHART_ROBUSTNESS_INPUT, "profiles": [CHART_ROBUSTNESS_INPUT["profiles"][0]] * 2})
             with self.assertRaises(ValidationError):
                 client.civil_time_audit({**CIVIL_TIME_AUDIT_INPUT, "place_id": "geonames:5128581:2020-01-01"})
+            with self.assertRaises(ValidationError):
+                client.chart_input_readiness({**CHART_INPUT_READINESS_INPUT, "birth_time": {"status": "approximate", "date": "2000-01-01", "time": "12:00"}})
 
 
     def test_request_body_limit(self):