planetarypy 0.76.0__tar.gz → 0.76.2__tar.gz

{planetarypy-0.76.0 → planetarypy-0.76.2}/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.76.2] - 2026-06-12
+
+### Fixed
+
+- **Graceful error when the optional `[spice]` extra is missing.** `spiceypy` and `scipy` ship in the `[spice]` extra rather than core, so a bare `pip install planetarypy` does not have them — yet importing `planetarypy.spice` (or `planetarypy.spice.spicer`) failed with a bare `ModuleNotFoundError: No module named 'spiceypy'` that gave no hint about the fix. SPICE imports now route through a small guard that raises a clear `ImportError` telling the user to `pip install 'planetarypy[spice]'` (the conda package ships SPICE by default). Core is unaffected — `planetarypy` itself never imports SPICE, and the `scipy` import in `spicer.py` stays lazy.
+
+## [0.76.1] - 2026-06-12
+
+### Fixed
+
+- **Declare `pyarrow` as a core dependency.** The PDS index cache writes and reads its parquet files through pandas (`to_parquet`/`read_parquet`), which needs a parquet engine that pandas does not bundle. `pyarrow` was never declared, so a clean `pip install planetarypy` raised `ImportError: Unable to find a usable engine` the first time any index was downloaded or read back. The gap went unnoticed because the CI test gate installs its dependencies from conda-forge, which pulls `pyarrow` in transitively and masked the missing declaration that pip-based installs — and real users — actually hit; the new pip-based daily PDS-download smoke canary surfaced it. Now declared in both the PyPI core dependencies and the conda recipe.
+
 ## [0.76.0] - 2026-06-11
 
 ### Added

{planetarypy-0.76.0 → planetarypy-0.76.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: planetarypy
-Version: 0.76.0
+Version: 0.76.2
 Summary: Core package for planetary data tools. Includes PDS index utilities, SPICE integrations, and more.
 Project-URL: Homepage, https://github.com/planetarypy/planetarypy
 Project-URL: Repository, https://github.com/planetarypy/planetarypy
@@ -29,6 +29,7 @@ Requires-Dist: pandas
 Requires-Dist: pdr[pillow]
 Requires-Dist: pooch
 Requires-Dist: pvl
+Requires-Dist: pyarrow
 Requires-Dist: pyproj
 Requires-Dist: python-dateutil
 Requires-Dist: rasterio

{planetarypy-0.76.0 → planetarypy-0.76.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "planetarypy"
-version = "0.76.0"
+version = "0.76.2"
 description = "Core package for planetary data tools. Includes PDS index utilities, SPICE integrations, and more."
 readme = "README.md"
 requires-python = ">= 3.11, <4"
@@ -29,6 +29,7 @@ dependencies = [
     "typer>=0.9",      # For command-line interface
     "numpy",           # For numerical operations
     "pandas",          # For data handling
+    "pyarrow",         # Parquet engine for the PDS index cache (pandas to_parquet/read_parquet)
     "pooch",           # For downloading and caching data files
     "pvl",             # For PDS label parsing
     "lxml",            # Runtime backend for pandas.read_html in spice/archived_kernels.py
@@ -200,7 +201,7 @@ DEP003 = [
 ]
 
 [tool.bumpversion]
-current_version = "0.76.0"
+current_version = "0.76.2"
 commit = true
 tag = true
 

{planetarypy-0.76.0 → planetarypy-0.76.2}/src/planetarypy/__init__.py

@@ -2,7 +2,7 @@
 
 __author__ = """PlanetaryPy Developers"""
 __email__ = "kmichael.aye@gmail.com"
-__version__ = "0.76.0"
+__version__ = "0.76.2"
 
 __all__ = [
     "enable_logging",

planetarypy-0.76.2/src/planetarypy/spice/_deps.py

@@ -0,0 +1,19 @@
+"""Friendly import guard for the optional SPICE dependency stack.
+
+``spiceypy`` and ``scipy`` ship in the ``[spice]`` extra rather than core, so a
+bare ``pip install planetarypy`` does not have them. Routing their imports
+through this module turns an otherwise cryptic ``ModuleNotFoundError`` into an
+actionable hint pointing at the extra.
+"""
+
+SPICE_INSTALL_HINT = (
+    "planetarypy SPICE support requires the optional 'spice' dependencies "
+    "(spiceypy, scipy), which are not installed. Install them with:\n\n"
+    "    pip install 'planetarypy[spice]'\n\n"
+    "(The conda package ships them by default.)"
+)
+
+try:
+    import spiceypy as spice  # noqa: F401
+except ImportError as exc:  # pragma: no cover - only without the [spice] extra
+    raise ImportError(SPICE_INSTALL_HINT) from exc

{planetarypy-0.76.0 → planetarypy-0.76.2}/src/planetarypy/spice/generic_kernels.py

@@ -18,8 +18,7 @@ __all__ = [
 
 from pathlib import Path
 
-import spiceypy as spice
-
+from ._deps import spice
 from ..utils import url_retrieve
 from .config import KERNEL_STORAGE, NAIF_URL
 

{planetarypy-0.76.0 → planetarypy-0.76.2}/src/planetarypy/spice/spicer.py

@@ -36,8 +36,8 @@ from math import tau
 
 import dateutil.parser as tparser
 import numpy as np
-import spiceypy as spice
 
+from ._deps import SPICE_INSTALL_HINT, spice
 from .generic_kernels import load_generic_kernels
 
 _kernels_loaded = False
@@ -64,7 +64,10 @@ def _rotate_vector(vector, axis, angle_rad):
     np.ndarray
         Rotated 3D vector.
     """
-    from scipy.spatial.transform import Rotation
+    try:
+        from scipy.spatial.transform import Rotation
+    except ImportError as exc:  # pragma: no cover - only without the [spice] extra
+        raise ImportError(SPICE_INSTALL_HINT) from exc
 
     axis = np.array(axis, dtype=np.float64)
     axis /= np.linalg.norm(axis)