jmeph-ffi 1.0.0__tar.gz

jmeph_ffi-1.0.0/.gitignore

@@ -0,0 +1,19 @@
+__pycache__/
+*.py[cod]
+*$py.class
+
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+
+.venv/
+venv/
+env/
+
+build/
+dist/
+*.egg-info/
+
+.env

jmeph_ffi-1.0.0/CONTRIBUTING.md

@@ -0,0 +1,93 @@
+# Contributing to JPL Moshier Ephemeris Python
+
+This package is a raw `ctypes` wrapper over the native JME C API. Contributions should preserve that low-level, lossless contract.
+
+## Requirements
+
+- Python 3.10 or newer
+- Git
+- Bundled JME/CALCEPH runtimes, or explicit `JME_LIBRARY_PATH` and `JME_CALCEPH_LIBRARY_PATH`
+- Optional local native source tree for surface-audit tests via `JME_SOURCE_PATH`
+
+## Development Setup
+
+```bash
+git clone https://github.com/YOUR_USERNAME/jpl-moshier-ephemeris-python.git
+cd jpl-moshier-ephemeris-python
+python -m pip install -e ".[dev]"
+python scripts/fetch_prebuilt.py
+python -m pytest
+```
+
+## Quality Checks
+
+```bash
+python -m ruff check .
+python -m ruff format . --check
+python -m pyright
+python -m pytest
+python -m build
+python -m twine check dist/*
+```
+
+## Raw API Rules
+
+Do not:
+
+- rename `jme_*` functions;
+- rename or alter `JME_*` constant values;
+- reorder arguments;
+- reshape output buffers in the raw layer;
+- hide return codes;
+- drop error buffer arguments;
+- reimplement astronomy inside Python;
+- silently normalize or round outputs.
+
+Do:
+
+- keep the wrapper aligned with `include/jme/jme.h` and `include/jme/jme_extended.h`;
+- keep the generated surface at `204` functions and `462` constants unless the native API changes;
+- add or update tests when bindings or loader behavior change;
+- use the PHP wrapper as the prebuilt runtime source of truth.
+
+## Prebuilt Runtimes
+
+Development can source runtimes from:
+
+```text
+Copy from a local checkout of jpl-moshier-ephemeris-php/libs
+```
+
+Published runtime source:
+
+```text
+https://github.com/jayeshmepani/jpl-moshier-ephemeris-php/releases/tag/prebuilt-libs
+```
+
+Refresh bundled runtimes with:
+
+```bash
+python scripts/fetch_prebuilt.py
+```
+
+Useful environment overrides:
+
+- `JME_PHP_LIBS_PATH`
+- `JME_PHP_REPO`
+- `JME_PHP_TAG`
+- `JME_PHP_ARCHIVE_URL`
+
+## Reporting Bugs
+
+Include:
+
+- Python version
+- OS and CPU architecture
+- package version
+- whether you used bundled libraries or env overrides
+- exact traceback or native error text
+- minimal reproduction
+
+## License
+
+MIT.

jmeph_ffi-1.0.0/LICENSE

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

jmeph_ffi-1.0.0/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: jmeph-ffi
+Version: 1.0.0
+Summary: Pure Python ctypes FFI wrapper for the JPL Moshier Ephemeris native library with direct jme_* API access and bundled jme plus calceph runtimes
+Project-URL: Homepage, https://github.com/jayeshmepani/jpl-moshier-ephemeris-python
+Project-URL: Source, https://github.com/jayeshmepani/jpl-moshier-ephemeris-python
+Project-URL: Issues, https://github.com/jayeshmepani/jpl-moshier-ephemeris-python/issues
+Author-email: Jayesh Mepani <jayeshmepani777@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: astrology,astronomy,ayanamsa,birth-chart,calceph,cross-platform,ctypes,eclipse,ephemeris,ffi,horoscope,houses,jpl,jyotish,kundli,moshier,planetary-positions,python-ffi,sidereal,tropical,vedic-astrology,zero-abstraction,zero-setup
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+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: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Provides-Extra: dev
+Requires-Dist: build>=1.0.0; extra == 'dev'
+Requires-Dist: pre-commit>=4.0.0; extra == 'dev'
+Requires-Dist: pyright>=1.1.390; extra == 'dev'
+Requires-Dist: pytest>=8.3.0; extra == 'dev'
+Requires-Dist: ruff>=0.9.0; extra == 'dev'
+Requires-Dist: twine>=4.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# JPL Moshier Ephemeris Python
+
+[![PyPI version](https://img.shields.io/pypi/v/jmeph-ffi.svg?style=flat-square)](https://pypi.org/project/jmeph-ffi/)
+[![Downloads](https://static.pepy.tech/badge/jmeph-ffi)](https://pepy.tech/projects/jmeph-ffi)
+[![Python Versions](https://img.shields.io/pypi/pyversions/jmeph-ffi.svg?style=flat-square)](https://pypi.org/project/jmeph-ffi/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![Wheel](https://img.shields.io/pypi/wheel/jmeph-ffi?style=flat-square)](https://pypi.org/project/jmeph-ffi/)
+[![Status](https://img.shields.io/pypi/status/jmeph-ffi?style=flat-square)](https://pypi.org/project/jmeph-ffi/)
+
+Pure Python `ctypes` runtime FFI binding for the project-owned JPL Moshier Ephemeris C library.
+
+This package wraps the native `jme_*` API directly. It is intended to be a true raw I/O surface: no recalculation, no normalization, no rounding, no reshaping, no dropped buffers, and no hidden status conversion.
+
+## Contract
+
+- Primary public functions: `jme_*`
+- Primary public constants: `JME_*`
+- Current wrapper target: all `204` public `jme_*` functions tracked by the native API inventory
+- Current constant target: all `462` public `JME_*` constants from the native headers
+- Native runtimes bundled in the wheel: `jme` plus `calceph`
+- No CPython extension module; pure Python loader plus bundled native libraries
+- Argument order, pointer ownership, output buffers, and return values are kept as-is from the native C API
+
+## Installation
+
+```bash
+pip install jmeph-ffi
+```
+
+End users do not need to download native binaries manually. The package ships its bundled `jme` and `calceph` runtimes inbuilt inside the wheel.
+
+## Native Libraries
+
+The package bundles the same prebuilt runtimes as the PHP wrapper:
+
+- `linux-x64/libjme.so`
+- `linux-x64/libcalceph.so`
+- `linux-arm64/libjme.so`
+- `linux-arm64/libcalceph.so`
+- `macos-x64/libjme.dylib`
+- `macos-x64/libcalceph.dylib`
+- `macos-arm64/libjme.dylib`
+- `macos-arm64/libcalceph.dylib`
+- `windows-x64/jme.dll`
+- `windows-x64/calceph.dll`
+
+The local/PHP release source below is for maintainers and package build refresh only, not for normal users.
+
+Local source for those prebuilt runtimes during development:
+
+```text
+Copy from a local checkout of jpl-moshier-ephemeris-php/libs
+```
+
+Published runtime source:
+
+```text
+https://github.com/jayeshmepani/jpl-moshier-ephemeris-php/releases/tag/prebuilt-libs
+```
+
+You can override discovery with:
+
+- `JME_LIBRARY_PATH`
+- `JME_CALCEPH_LIBRARY_PATH`
+
+Search order:
+
+1. explicit environment override
+2. bundled `src/jpl_moshier_ephemeris/libs/<platform>/`
+3. common system library paths
+
+## Quick Start
+
+```python
+from jpl_moshier_ephemeris import (
+    JME_BODY_SUN,
+    JME_CALC_SPEED,
+    JME_CALENDAR_GREGORIAN,
+    JmeEph,
+    c_double,
+    create_string_buffer,
+)
+
+jme = JmeEph()
+
+jd = jme.jme_julian_day(2000, 1, 1, 12.0, JME_CALENDAR_GREGORIAN)
+xx = (c_double * 6)()
+err = create_string_buffer(256)
+
+rc = jme.jme_calc_ut(jd, JME_BODY_SUN, JME_CALC_SPEED, xx, err)
+print(rc, list(xx), err.value.decode())
+```
+
+## Development
+
+```bash
+python -m pip install -e ".[dev]"
+python scripts/fetch_prebuilt.py
+python -m ruff check .
+python -m ruff format . --check
+python -m pyright
+python -m pytest
+python -m build
+python -m twine check dist/*
+```
+
+The test suite verifies:
+
+- `204/204` configured ctypes function signatures
+- `462/462` generated `JME_*` constants
+- import and runtime loading
+- basic native contract calls such as version, Julian day conversion, calculation, houses, ayanamsa, Delta-T, split-degree, body naming, and refraction
+- optional source-surface audit against the local native `jpl-ephemeris-` tree
+
+## License
+
+MIT. The Python package and the project-owned JME native library are intended to remain under MIT-compatible distribution.

jmeph_ffi-1.0.0/README.md

@@ -0,0 +1,117 @@
+# JPL Moshier Ephemeris Python
+
+[![PyPI version](https://img.shields.io/pypi/v/jmeph-ffi.svg?style=flat-square)](https://pypi.org/project/jmeph-ffi/)
+[![Downloads](https://static.pepy.tech/badge/jmeph-ffi)](https://pepy.tech/projects/jmeph-ffi)
+[![Python Versions](https://img.shields.io/pypi/pyversions/jmeph-ffi.svg?style=flat-square)](https://pypi.org/project/jmeph-ffi/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![Wheel](https://img.shields.io/pypi/wheel/jmeph-ffi?style=flat-square)](https://pypi.org/project/jmeph-ffi/)
+[![Status](https://img.shields.io/pypi/status/jmeph-ffi?style=flat-square)](https://pypi.org/project/jmeph-ffi/)
+
+Pure Python `ctypes` runtime FFI binding for the project-owned JPL Moshier Ephemeris C library.
+
+This package wraps the native `jme_*` API directly. It is intended to be a true raw I/O surface: no recalculation, no normalization, no rounding, no reshaping, no dropped buffers, and no hidden status conversion.
+
+## Contract
+
+- Primary public functions: `jme_*`
+- Primary public constants: `JME_*`
+- Current wrapper target: all `204` public `jme_*` functions tracked by the native API inventory
+- Current constant target: all `462` public `JME_*` constants from the native headers
+- Native runtimes bundled in the wheel: `jme` plus `calceph`
+- No CPython extension module; pure Python loader plus bundled native libraries
+- Argument order, pointer ownership, output buffers, and return values are kept as-is from the native C API
+
+## Installation
+
+```bash
+pip install jmeph-ffi
+```
+
+End users do not need to download native binaries manually. The package ships its bundled `jme` and `calceph` runtimes inbuilt inside the wheel.
+
+## Native Libraries
+
+The package bundles the same prebuilt runtimes as the PHP wrapper:
+
+- `linux-x64/libjme.so`
+- `linux-x64/libcalceph.so`
+- `linux-arm64/libjme.so`
+- `linux-arm64/libcalceph.so`
+- `macos-x64/libjme.dylib`
+- `macos-x64/libcalceph.dylib`
+- `macos-arm64/libjme.dylib`
+- `macos-arm64/libcalceph.dylib`
+- `windows-x64/jme.dll`
+- `windows-x64/calceph.dll`
+
+The local/PHP release source below is for maintainers and package build refresh only, not for normal users.
+
+Local source for those prebuilt runtimes during development:
+
+```text
+Copy from a local checkout of jpl-moshier-ephemeris-php/libs
+```
+
+Published runtime source:
+
+```text
+https://github.com/jayeshmepani/jpl-moshier-ephemeris-php/releases/tag/prebuilt-libs
+```
+
+You can override discovery with:
+
+- `JME_LIBRARY_PATH`
+- `JME_CALCEPH_LIBRARY_PATH`
+
+Search order:
+
+1. explicit environment override
+2. bundled `src/jpl_moshier_ephemeris/libs/<platform>/`
+3. common system library paths
+
+## Quick Start
+
+```python
+from jpl_moshier_ephemeris import (
+    JME_BODY_SUN,
+    JME_CALC_SPEED,
+    JME_CALENDAR_GREGORIAN,
+    JmeEph,
+    c_double,
+    create_string_buffer,
+)
+
+jme = JmeEph()
+
+jd = jme.jme_julian_day(2000, 1, 1, 12.0, JME_CALENDAR_GREGORIAN)
+xx = (c_double * 6)()
+err = create_string_buffer(256)
+
+rc = jme.jme_calc_ut(jd, JME_BODY_SUN, JME_CALC_SPEED, xx, err)
+print(rc, list(xx), err.value.decode())
+```
+
+## Development
+
+```bash
+python -m pip install -e ".[dev]"
+python scripts/fetch_prebuilt.py
+python -m ruff check .
+python -m ruff format . --check
+python -m pyright
+python -m pytest
+python -m build
+python -m twine check dist/*
+```
+
+The test suite verifies:
+
+- `204/204` configured ctypes function signatures
+- `462/462` generated `JME_*` constants
+- import and runtime loading
+- basic native contract calls such as version, Julian day conversion, calculation, houses, ayanamsa, Delta-T, split-degree, body naming, and refraction
+- optional source-surface audit against the local native `jpl-ephemeris-` tree
+
+## License
+
+MIT. The Python package and the project-owned JME native library are intended to remain under MIT-compatible distribution.

jmeph_ffi-1.0.0/UPSTREAM_SYNC.md

@@ -0,0 +1,44 @@
+# JPL Moshier Ephemeris Python Sync Notes
+
+**Generated**: May 25, 2026
+
+## Source of Truth
+
+This Python package is synchronized against two local/project sources:
+
+1. Native C library source:
+   `jpl-ephemeris-`
+2. PHP wrapper prebuilt runtime source:
+   `jpl-moshier-ephemeris-php`
+
+## Current Sync Targets
+
+| Area | Target |
+| --- | --- |
+| Public functions | `204` `jme_*` entries from `docs/API_REFERENCE.md` |
+| Public constants | `462` `JME_*` constants from `include/jme/jme.h` and `include/jme/jme_extended.h` |
+| Bundled runtimes | same platform runtime set as the PHP wrapper |
+| JME runtime names | `libjme.so`, `libjme.dylib`, `jme.dll` |
+| CALCEPH runtime names | `libcalceph.so`, `libcalceph.dylib`, `calceph.dll` |
+| Python wrapper rule | lossless raw I/O only; no Python-side normalization, rounding, or reshaping |
+
+## Runtime Source
+
+Local development source:
+
+```text
+Copy from a local checkout of jpl-moshier-ephemeris-php/libs
+```
+
+Published runtime source:
+
+```text
+https://github.com/jayeshmepani/jpl-moshier-ephemeris-php/releases/tag/prebuilt-libs
+```
+
+## Required Checks
+
+- regenerate `bindings.py` and `constants.py` from the native headers when the C API changes
+- keep the Python export surface aligned with the generated files
+- keep runtime packaging aligned with the PHP wrapper release assets or repo archive tag
+- verify tests still pass on Linux, macOS, and Windows

jmeph_ffi-1.0.0/VERSION.md

@@ -0,0 +1,48 @@
+# JPL Moshier Ephemeris Python Version Tracking
+
+**Last verified**: May 25, 2026
+
+## Current Package State
+
+| Attribute | Value |
+| --- | --- |
+| Python package | `jmeph-ffi` |
+| Package version | `1.0.0` |
+| Python requirement | `>=3.10` |
+| Binding model | Pure Python `ctypes` runtime FFI |
+| Native API target | `204` public `jme_*` functions |
+| Native constant target | `462` public `JME_*` constants |
+| Native source tree | `jpl-ephemeris-` |
+| Runtime binary source | `jpl-moshier-ephemeris-php` prebuilt libs |
+| License | MIT |
+| Binding contract | Lossless raw I/O; native argument order, types, buffers, and return values preserved |
+
+## Bundled Runtime Files
+
+| Platform | JME | CALCEPH |
+| --- | --- | --- |
+| Linux x64 | `libjme.so` | `libcalceph.so` |
+| Linux ARM64 | `libjme.so` | `libcalceph.so` |
+| macOS x64 | `libjme.dylib` | `libcalceph.dylib` |
+| macOS ARM64 | `libjme.dylib` | `libcalceph.dylib` |
+| Windows x64 | `jme.dll` | `calceph.dll` |
+
+## Verification Targets
+
+- `204/204` ctypes signatures generated from native headers and API inventory
+- `462/462` `JME_*` constants generated from native headers
+- runtime loader covers both JME and CALCEPH
+- wheel/source package includes bundled runtime directories
+
+## Update Workflow
+
+```bash
+python scripts/fetch_prebuilt.py
+JME_SOURCE_PATH=/path/to/jpl-ephemeris- php scripts/generate_bindings.php
+python -m ruff check .
+python -m ruff format . --check
+python -m pyright
+python -m pytest
+python -m build
+python -m twine check dist/*
+```

jmeph_ffi-1.0.0/pyproject.toml

@@ -0,0 +1,132 @@
+[build-system]
+requires = ["hatchling>=1.24"]
+build-backend = "hatchling.build"
+
+[project]
+name = "jmeph-ffi"
+version = "1.0.0"
+description = "Pure Python ctypes FFI wrapper for the JPL Moshier Ephemeris native library with direct jme_* API access and bundled jme plus calceph runtimes"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+    { name = "Jayesh Mepani", email = "jayeshmepani777@gmail.com" }
+]
+keywords = [
+    "astrology",
+    "astronomy",
+    "ephemeris",
+    "ffi",
+    "ctypes",
+    "python-ffi",
+    "jpl",
+    "moshier",
+    "calceph",
+    "vedic-astrology",
+    "jyotish",
+    "horoscope",
+    "kundli",
+    "birth-chart",
+    "planetary-positions",
+    "ayanamsa",
+    "sidereal",
+    "tropical",
+    "houses",
+    "eclipse",
+    "zero-abstraction",
+    "zero-setup",
+    "cross-platform",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "License :: OSI Approved :: MIT License",
+    "Topic :: Scientific/Engineering :: Astronomy",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = []
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.3.0",
+    "ruff>=0.9.0",
+    "pyright>=1.1.390",
+    "pre-commit>=4.0.0",
+    "build>=1.0.0",
+    "twine>=4.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/jayeshmepani/jpl-moshier-ephemeris-python"
+Source = "https://github.com/jayeshmepani/jpl-moshier-ephemeris-python"
+Issues = "https://github.com/jayeshmepani/jpl-moshier-ephemeris-python/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/jpl_moshier_ephemeris"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/jpl_moshier_ephemeris",
+    "tests",
+    "scripts",
+    "README.md",
+    "VERSION.md",
+    "UPSTREAM_SYNC.md",
+    "CONTRIBUTING.md",
+    "LICENSE",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+src = ["src/jpl_moshier_ephemeris", "tests", "scripts"]
+
+[tool.ruff.lint]
+select = [
+    "E", "W",
+    "F",
+    "I",
+    "N",
+    "UP",
+    "B",
+    "C4",
+    "SIM",
+    "RET",
+    "RUF",
+]
+fixable = ["ALL"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+line-ending = "auto"
+
+[tool.ruff.lint.per-file-ignores]
+"src/jpl_moshier_ephemeris/__init__.py" = ["F401", "F403"]
+"src/jpl_moshier_ephemeris/bindings.py" = ["E501", "RUF022"]
+"src/jpl_moshier_ephemeris/constants.py" = ["E501", "N816"]
+"tests/*" = ["S101"]
+
+[tool.pyright]
+pythonVersion = "3.10"
+typeCheckingMode = "standard"
+reportMissingImports = true
+reportMissingTypeStubs = false
+reportUnknownMemberType = false
+reportUnknownVariableType = false
+reportUnknownArgumentType = false
+include = ["src/jpl_moshier_ephemeris", "tests", "scripts"]
+exclude = ["**/__pycache__", ".venv", "build", "dist"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py", "*_test.py"]
+python_functions = ["test_*"]
+addopts = "-v --tb=short"