pylunar 0.7.4__tar.gz → 0.9.0__tar.gz

{pylunar-0.7.4 → pylunar-0.9.0}/.pre-commit-config.yaml

@@ -1,6 +1,6 @@
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.6.0
+    rev: v5.0.0
     hooks:
       - id: check-merge-conflict
       - id: check-toml
@@ -8,21 +8,21 @@ repos:
       - id: trailing-whitespace
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.6.8
+    rev: v0.8.2
     hooks:
       - id: ruff
         args: [--fix, --exit-non-zero-on-fix]
       - id: ruff-format
 
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.11.2
+    rev: v1.13.0
     hooks:
       - id: mypy
         args: [--strict]
         additional_dependencies: [types-pytz==2024.2.0.20240913]
 
   - repo: https://github.com/numpy/numpydoc
-    rev: v1.6.0
+    rev: v1.8.0
     hooks:
       - id: numpydoc-validation
 

{pylunar-0.7.4 → pylunar-0.9.0}/CONTRIBUTING.rst

@@ -93,9 +93,8 @@ Pull Request Guidelines
 Before you submit a pull request, check that it meets these guidelines:
 
 #. The pull request should include tests.
-#. If the pull request adds functionality, the docs should be updated. Put
-   your new functionality into a function with a docstring, and add the
-   feature to the list in HISTORY.rst.
+#. If the pull request adds functionality, put your new functionality into a
+   function with a docstring. Run ``scriv create`` to add a changelog fragment and fill out the appropriate section for the change. Add that to the commits for the pull request.
 #. The pull request should work for the supported range of Python versions.
    The pull request will run GitHub actions to perform those checks.
    Check https://github.com/mareuter/pylunar/pulls

{pylunar-0.7.4 → pylunar-0.9.0}/HISTORY.rst

@@ -2,6 +2,46 @@
 
 History
 -------
+.. scriv-insert-here
+
+.. _changelog-0.9.0:
+
+0.9.0 (2024-12-10)
+++++++++++++++++++
+
+Changed
+^^^^^^^
+
+- Remove Python 3.8 support.
+- Add Python 3.13 support.
+
+Fixed
+^^^^^
+
+- Issues from pre-commit config version updates.
+
+.. _changelog-0.8.0:
+
+0.8.0 (2024-11-09)
+++++++++++++++++++
+
+Added
+^^^^^
+
+- Solar altitude over lunar feature calculation
+- AltitudeDict class to provide solar altitude for Lunar II features
+- Use scriv for history generation
+
+Changed
+^^^^^^^
+
+- OS version for readthedocs build
+- Updated CONTRIBUTING.rst to add scriv usage
+
+Fixed
+^^^^^
+
+- Internal class cross-references in docs
 
 0.7.4 (2024-10-27)
 ++++++++++++++++++

{pylunar-0.7.4 → pylunar-0.9.0}/Makefile

@@ -17,6 +17,7 @@ help:
 init:
 	pip install --editable .[dev]
 	pre-commit install
+	mkdir changelog.d
 
 clean: clean-build clean-docs clean-pyc
 

{pylunar-0.7.4 → pylunar-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pylunar
-Version: 0.7.4
+Version: 0.9.0
 Summary: Information for completing the Astronomical League's Lunar and Lunar II observing programs.
 Author-email: Michael Reuter <mareuternh@gmail.com>
 Project-URL: Documentation, http://pylunar.readthedocs.io
@@ -10,11 +10,11 @@ Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: BSD License
 Classifier: Natural Language :: English
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 License-File: AUTHORS.rst
@@ -24,20 +24,19 @@ Requires-Dist: typing-extensions==4.12.2; python_version < "3.10"
 Requires-Dist: pytz==2024.2
 Provides-Extra: dev
 Requires-Dist: pylunar[build,docs,lint,test]; extra == "dev"
+Requires-Dist: scriv==1.5.1; extra == "dev"
 Requires-Dist: tox==4.23.2; extra == "dev"
 Provides-Extra: test
-Requires-Dist: coverage[toml]==7.6.1; python_version < "3.9" and extra == "test"
-Requires-Dist: coverage[toml]==7.6.4; python_version >= "3.9" and extra == "test"
+Requires-Dist: coverage[toml]==7.6.9; extra == "test"
 Requires-Dist: pytest==8.3.3; extra == "test"
 Provides-Extra: lint
-Requires-Dist: pre-commit==3.5.0; python_version < "3.9" and extra == "lint"
-Requires-Dist: pre-commit==3.8.0; python_version >= "3.9" and extra == "lint"
+Requires-Dist: pre-commit==4.0.1; extra == "lint"
 Provides-Extra: build
 Requires-Dist: build==1.2.2.post1; extra == "build"
 Requires-Dist: twine==5.1.1; extra == "build"
 Provides-Extra: docs
 Requires-Dist: sphinx~=7.1; extra == "docs"
-Requires-Dist: sphinx_rtd_theme==2.0.0; extra == "docs"
+Requires-Dist: sphinx_rtd_theme==3.0.2; extra == "docs"
 
 =============================
 Python Lunar

{pylunar-0.7.4 → pylunar-0.9.0}/docs/usage.rst

@@ -22,22 +22,22 @@ API requires UTC, so add 4 hours since on Daylight Savings (changes day)
     >>> mi.phase_name()
     'WAXING_GIBBOUS'
 
-This package also contains the :py:class:`.LunarFeatureContainer` class which holds features on the moon for the Astronomical League's Lunar Club and Lunar II observing programs. To create a container for the Lunar Club program, do.
+This package also contains the :py:class:`pylunar.LunarFeatureContainer` class which holds features on the moon for the Astronomical League's Lunar Club and Lunar II observing programs. To create a container for the Lunar Club program, do.
 
 	>>> lc = pylunar.LunarFeatureContainer("Lunar")
 	>>> lc.load()
 	>>> len(lc)
 	90
 
-There are 90 features available to this observing program. The container allows one to filter those features based on the position of the lunar terminator with respect to a given feature. The :py:meth:`.LunarFeatureContainer.load` method can be passed a :py:class:`.MoonInfo` instance to perform that filtering.
+There are 90 features available to this observing program. The container allows one to filter those features based on the position of the lunar terminator with respect to a given feature. The :py:meth:`pylunar.LunarFeatureContainer.load` method can be passed a :py:class:`pylunar.MoonInfo` instance to perform that filtering.
 
 	>>> lc.load(mi)
 	>>> len(lc)
 	12
 
-A container for Lunar II can be created by passing the `LunarII` string to the constructor of :py:class:`.LunarFeatureContainer`.
+A container for Lunar II can be created by passing the `LunarII` string to the constructor of :py:class:`pylunar.LunarFeatureContainer`.
 
-Feature instances (:py:class:`.LunarFeature`) can be obtained from the container in usual manner.
+Feature instances (:py:class:`pylunar.LunarFeature`) can be obtained from the container in usual manner.
 
 	>>> for feature in lc:
 	...     print(feature)

{pylunar-0.7.4 → pylunar-0.9.0}/pyproject.toml

@@ -20,11 +20,11 @@ classifiers = [
     "License :: OSI Approved :: BSD License",
     "Natural Language :: English",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
 ]
 dependencies = [
     "ephem==4.1.6",
@@ -40,16 +40,15 @@ Repository = "https://github.com/mareuter/pylunar"
 [project.optional-dependencies]
 dev = [
     "pylunar[build,docs,lint,test]",
+    "scriv==1.5.1",
     "tox==4.23.2"
 ]
 test = [
-    "coverage[toml]==7.6.1;python_version<'3.9'",
-    "coverage[toml]==7.6.4;python_version>='3.9'",
+    "coverage[toml]==7.6.9",
     "pytest==8.3.3",
 ]
 lint = [
-    "pre-commit==3.5.0;python_version<'3.9'",
-    "pre-commit==3.8.0;python_version>='3.9'"
+    "pre-commit==4.0.1"
 ]
 build = [
     "build==1.2.2.post1",
@@ -57,7 +56,7 @@ build = [
 ]
 docs = [
     "sphinx~=7.1",
-    "sphinx_rtd_theme==2.0.0"
+    "sphinx_rtd_theme==3.0.2"
 ]
 
 [tool.setuptools_scm]
@@ -68,11 +67,11 @@ exclude = [
     "scripts/startup.py"
 
 ]
-ignore = [
+lint.ignore = [
     "D104"
 ]
 line-length = 110
-select = [
+lint.select = [
     "B",
     "D",
     "E",
@@ -83,7 +82,7 @@ select = [
     "W"
 ]
 
-[tool.ruff.per-file-ignores]
+[tool.ruff.lint.per-file-ignores]
 "src/pylunar/__init__.py" = [
     "E402",
     "F401",
@@ -95,7 +94,7 @@ select = [
     "D103",
 ]
 
-[tool.ruff.isort]
+[tool.ruff.lint.isort]
 force-sort-within-sections = true
 
 [tool.ruff.lint.pydocstyle]
@@ -122,3 +121,8 @@ exclude = [
     "conf",
     "startup"
 ]
+
+[tool.scriv]
+entry_title_template = "{{ version }} ({{ date.strftime('%Y-%m-%d') }})"
+output_file = "HISTORY.${config:format}"
+rst_header_chars = "+^"

{pylunar-0.7.4 → pylunar-0.9.0}/src/pylunar/__init__.py

@@ -9,6 +9,7 @@
 # license that can be found in the LICENSE file.
 
 __all__ = [
+    "AltitudeDict",
     "__author__",
     "__email__",
     "__version__",
@@ -36,6 +37,7 @@ version_info = __version__.split(".")
 Use this for version comparison.
 """
 
+from .altitude_dict import AltitudeDict
 from .helpers import mjd_to_date_tuple, tuple_to_string
 from .lunar_feature import LunarFeature
 from .lunar_feature_container import LunarFeatureContainer

pylunar-0.9.0/src/pylunar/altitude_dict.py

@@ -0,0 +1,56 @@
+# This file is part of pylunar.
+#
+# Developed by Michael Reuter.
+#
+# See the LICENSE file at the top-level directory of this distribution
+# for details of code ownership.
+#
+# Use of this source code is governed by a 3-clause BSD-style
+# license that can be found in the LICENSE file.
+
+"""Module for the AltitudeDict class."""
+
+from __future__ import annotations
+
+import sys
+
+if sys.version_info >= (3, 10):
+    from importlib.resources import files
+else:
+    from importlib_resources import files
+
+import sqlite3
+
+from .lunar_feature import LunarFeature
+from .moon_info import MoonInfo
+
+__all__ = ["AltitudeDict"]
+
+
+class AltitudeDict(dict[str, float]):
+    """Dictionary for the Lunar II features requiring solar altitude."""
+
+    def load(self, moon_info: MoonInfo) -> None:
+        """Provide solar altitude for the Lunar II features.
+
+        Parameters
+        ----------
+        moon_info : :class:`pylunar.MoonInfo`
+            Instance of the Lunar information class.
+        """
+        features = ["Byrgius A", "Proclus", "Rupes Recta", "Tycho"]
+        dbname = str(files("pylunar.data").joinpath("lunar.db"))
+        conn = sqlite3.connect(dbname)
+        cur = conn.cursor()
+
+        sql = f"select * from Features where Name in {str(tuple(features))}"
+        cur.execute(sql)
+
+        feature_list = []
+        for row in cur:
+            feature_list.append(LunarFeature.from_row(row))
+
+        for feature in sorted(feature_list, key=lambda x: x.name):
+            self[feature.name] = moon_info.solar_altitude(feature)
+
+        cur.close()

{pylunar-0.7.4 → pylunar-0.9.0}/src/pylunar/lunar_feature.py

@@ -108,7 +108,7 @@ class LunarFeature:
 
         Returns
         -------
-        :class:`.LunarFeature`
+        :class:`pylunar.LunarFeature`
             Class initialized from database row.
         """
         return cls(*row[1:])

{pylunar-0.7.4 → pylunar-0.9.0}/src/pylunar/lunar_feature_container.py

@@ -15,8 +15,8 @@ from __future__ import annotations
 __all__ = ["LunarFeatureContainer"]
 
 import collections
+from collections.abc import Generator
 import sys
-from typing import Generator
 
 if sys.version_info >= (3, 10):
     from importlib.resources import files
@@ -52,7 +52,7 @@ class LunarFeatureContainer:
 
         Yields
         ------
-        :class:`.LunarFeature`
+        :class:`pylunar.LunarFeature`
             The current lunar feature.
         """
         yield from self.features.values()
@@ -72,7 +72,7 @@ class LunarFeatureContainer:
 
         Parameters
         ----------
-        moon_info : :class:`.MoonInfo`, optional
+        moon_info : :class:`pylunar.MoonInfo`, optional
             Instance of the Lunar information class.
         limit : int, optional
             Restrict the number of features read to the given value.

{pylunar-0.7.4 → pylunar-0.9.0}/src/pylunar/moon_info.py

@@ -266,7 +266,7 @@ class MoonInfo:
 
         Parameters
         ----------
-        feature : :class:`.LunarFeature`
+        feature : :class:`pylunar.LunarFeature`
             The lunar feature instance to check.
 
         Returns
@@ -291,7 +291,7 @@ class MoonInfo:
 
         Parameters
         ----------
-        feature : :class:`.LunarFeature`
+        feature : :class:`pylunar.LunarFeature`
             The lunar feature instance to check.
 
         Returns
@@ -556,6 +556,29 @@ class MoonInfo:
 
         return sorted_times
 
+    def solar_altitude(self, feature: LunarFeature) -> float:
+        """Find the altitude of the sun over a given feature.
+
+        Sunrise is near zero degrees, noon is near 90 degrees and sunset is
+        near 180 degrees.
+
+        Parameters
+        ----------
+        feature : :class:`pylunar.LunarFeature`
+            Feature to calculate solar altitude.
+
+        Returns
+        -------
+        float
+            Solar altitude over feature in degrees.
+        """
+        rad_ss_lat = math.radians(self.subsolar_lat())
+        rad_feature_lat = math.radians(feature.latitude)
+        term1 = math.sin(rad_ss_lat) * math.sin(rad_feature_lat)
+        term2a = math.cos(rad_ss_lat) * math.cos(rad_feature_lat)
+        term2b = math.sin(math.radians(self.colong() + feature.longitude))
+        return math.degrees(math.asin(term1 + term2a * term2b))
+
     def subsolar_lat(self) -> float:
         """Latitude in degress on the moon where the sun is overhead.
 

{pylunar-0.7.4 → pylunar-0.9.0}/src/pylunar/pkg_types.py

@@ -19,13 +19,13 @@ if sys.version_info >= (3, 10):
 else:
     from typing_extensions import TypeAlias
 
-from typing import List, Tuple, Union
+from typing import Union
 
-DateTimeTuple: TypeAlias = Tuple[int, int, int, int, int, Union[int, float]]
-MoonPhases: TypeAlias = List[Tuple[str, Union[DateTimeTuple, str]]]
-DmsCoordinate: TypeAlias = Tuple[int, int, int]
-Range: TypeAlias = Tuple[float, float]
-LunarFeatureList: TypeAlias = Tuple[
+DateTimeTuple: TypeAlias = Union[tuple[int, ...], tuple[int, int, int, int, int, float]]
+MoonPhases: TypeAlias = list[tuple[str, Union[DateTimeTuple, str]]]
+DmsCoordinate: TypeAlias = tuple[int, int, int]
+Range: TypeAlias = tuple[float, float]
+LunarFeatureList: TypeAlias = tuple[
     str, float, float, float, float, float, str, str, str, str, Union[str, None]
 ]
-FeatureRow: TypeAlias = Tuple[int, str, float, float, float, float, float, str, str, str, str, str]
+FeatureRow: TypeAlias = tuple[int, str, float, float, float, float, float, str, str, str, str, str]

{pylunar-0.7.4 → pylunar-0.9.0}/src/pylunar.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pylunar
-Version: 0.7.4
+Version: 0.9.0
 Summary: Information for completing the Astronomical League's Lunar and Lunar II observing programs.
 Author-email: Michael Reuter <mareuternh@gmail.com>
 Project-URL: Documentation, http://pylunar.readthedocs.io
@@ -10,11 +10,11 @@ Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: BSD License
 Classifier: Natural Language :: English
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 License-File: AUTHORS.rst
@@ -24,20 +24,19 @@ Requires-Dist: typing-extensions==4.12.2; python_version < "3.10"
 Requires-Dist: pytz==2024.2
 Provides-Extra: dev
 Requires-Dist: pylunar[build,docs,lint,test]; extra == "dev"
+Requires-Dist: scriv==1.5.1; extra == "dev"
 Requires-Dist: tox==4.23.2; extra == "dev"
 Provides-Extra: test
-Requires-Dist: coverage[toml]==7.6.1; python_version < "3.9" and extra == "test"
-Requires-Dist: coverage[toml]==7.6.4; python_version >= "3.9" and extra == "test"
+Requires-Dist: coverage[toml]==7.6.9; extra == "test"
 Requires-Dist: pytest==8.3.3; extra == "test"
 Provides-Extra: lint
-Requires-Dist: pre-commit==3.5.0; python_version < "3.9" and extra == "lint"
-Requires-Dist: pre-commit==3.8.0; python_version >= "3.9" and extra == "lint"
+Requires-Dist: pre-commit==4.0.1; extra == "lint"
 Provides-Extra: build
 Requires-Dist: build==1.2.2.post1; extra == "build"
 Requires-Dist: twine==5.1.1; extra == "build"
 Provides-Extra: docs
 Requires-Dist: sphinx~=7.1; extra == "docs"
-Requires-Dist: sphinx_rtd_theme==2.0.0; extra == "docs"
+Requires-Dist: sphinx_rtd_theme==3.0.2; extra == "docs"
 
 =============================
 Python Lunar

{pylunar-0.7.4 → pylunar-0.9.0}/src/pylunar.egg-info/SOURCES.txt

@@ -20,6 +20,7 @@ docs/make.bat
 docs/usage.rst
 scripts/startup.py
 src/pylunar/__init__.py
+src/pylunar/altitude_dict.py
 src/pylunar/helpers.py
 src/pylunar/lunar_feature.py
 src/pylunar/lunar_feature_container.py
@@ -32,6 +33,7 @@ src/pylunar.egg-info/requires.txt
 src/pylunar.egg-info/top_level.txt
 src/pylunar/data/lunar.db
 tests/__init__.py
+tests/test_altitude_dict.py
 tests/test_helpers.py
 tests/test_lunar_feature.py
 tests/test_lunar_feature_container.py

{pylunar-0.7.4 → pylunar-0.9.0}/src/pylunar.egg-info/requires.txt

@@ -11,25 +11,16 @@ twine==5.1.1
 
 [dev]
 pylunar[build,docs,lint,test]
+scriv==1.5.1
 tox==4.23.2
 
 [docs]
 sphinx~=7.1
-sphinx_rtd_theme==2.0.0
+sphinx_rtd_theme==3.0.2
 
 [lint]
-
-[lint:python_version < "3.9"]
-pre-commit==3.5.0
-
-[lint:python_version >= "3.9"]
-pre-commit==3.8.0
+pre-commit==4.0.1
 
 [test]
+coverage[toml]==7.6.9
 pytest==8.3.3
-
-[test:python_version < "3.9"]
-coverage[toml]==7.6.1
-
-[test:python_version >= "3.9"]
-coverage[toml]==7.6.4

pylunar-0.9.0/tests/test_altitude_dict.py

@@ -0,0 +1,31 @@
+# This file is part of pylunar.
+#
+# Developed by Michael Reuter.
+#
+# See the LICENSE file at the top-level directory of this distribution
+# for details of code ownership.
+#
+# Use of this source code is governed by a 3-clause BSD-style
+# license that can be found in the LICENSE file.
+
+"""Tests for AltitudeDict class."""
+
+from pylunar import AltitudeDict, MoonInfo
+
+
+class TestAltitudeDict:
+    def setup_class(self) -> None:
+        self.ad = AltitudeDict()
+
+    def test_basic_information_after_creation(self) -> None:
+        assert len(self.ad) == 0
+
+    def test_information_after_load(self) -> None:
+        location = ((35, 58, 10), (-84, 19, 0))
+        mi = MoonInfo(location[0], location[1])
+        mi.update((2013, 10, 12, 18, 0, 0))
+
+        self.ad.load(mi)
+        assert len(self.ad) == 4
+        assert list(self.ad.keys()) == ["Byrgius A", "Proclus", "Rupes Recta", "Tycho"]
+        assert self.ad["Rupes Recta"] == 1.3038753306292297

{pylunar-0.7.4 → pylunar-0.9.0}/tests/test_moon_info.py

@@ -251,3 +251,20 @@ class TestMoonInfo:
         assert self.mi.is_libration_ok(feature1) is False
         assert self.mi.is_libration_ok(feature2) is False
         assert self.mi.is_libration_ok(feature3) is True
+
+    def test_solar_altitude(self) -> None:
+        self.mi.update((1992, 4, 12, 0, 0, 0))
+        feature = LunarFeature(
+            "Copernicus",
+            96.0699,
+            9.62094521642403,
+            -20.078620508253,
+            3.1684722900391,
+            3.21326828003004,
+            "Crater",
+            "Copernicus",
+            "LAC-58",
+            "Lunar",
+            "Binocular",
+        )
+        assert self.mi.solar_altitude(feature) == 1.9649120982751562