planetarypy 0.76.1__tar.gz → 0.76.2__tar.gz

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

@@ -5,6 +5,12 @@ 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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: planetarypy
-Version: 0.76.1
+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

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "planetarypy"
-version = "0.76.1"
+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"
@@ -201,7 +201,7 @@ DEP003 = [
 ]
 
 [tool.bumpversion]
-current_version = "0.76.1"
+current_version = "0.76.2"
 commit = true
 tag = true
 

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

@@ -2,7 +2,7 @@
 
 __author__ = """PlanetaryPy Developers"""
 __email__ = "kmichael.aye@gmail.com"
-__version__ = "0.76.1"
+__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.1 → 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.1 → 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)