wwvb 4.0.0__tar.gz → 4.1.0a0__tar.gz

{wwvb-4.0.0 → wwvb-4.1.0a0}/.github/workflows/release.yml

@@ -2,7 +2,7 @@
 #
 # SPDX-License-Identifier: CC0-1.0
 
-name: Release wwvbgen
+name: Release leapseconddata
 
 on:
   release:
@@ -11,7 +11,7 @@ on:
 jobs:
   release:
 
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-latest
     steps:
     - name: Dump GitHub context
       env:
@@ -23,15 +23,10 @@ jobs:
     - name: Set up Python
       uses: actions/setup-python@v5
       with:
-        python-version: 3.9
+        python-version: "3.x"
 
     - name: Install deps
-      run: |
-        python -mpip install wheel
-        python -mpip install -r requirements-dev.txt
-
-    - name: Test
-      run: make coverage
+      run: python -mpip install -r requirements-dev.txt
 
     - name: Build release
       run: python -mbuild

{wwvb-4.0.0 → wwvb-4.1.0a0}/.github/workflows/test.yml

@@ -2,7 +2,7 @@
 #
 # SPDX-License-Identifier: CC0-1.0
 
-name: Test wwvbgen
+name: Test leapseconddata
 
 on:
   push:
@@ -19,7 +19,7 @@ jobs:
     - name: Set up Python
       uses: actions/setup-python@v5
       with:
-        python-version: '3.12'
+        python-version: '3.10'
 
     - uses: actions/checkout@v4
 
@@ -31,7 +31,6 @@ jobs:
 
   test:
     strategy:
-      fail-fast: false
       matrix:
         python-version:
         - '3.9'
@@ -39,21 +38,17 @@ jobs:
         - '3.11'
         - '3.12'
         - '3.13.0-alpha.0 - 3.13'
+        - 'pypy-3.9'
         os-version:
         - 'ubuntu-latest'
-        coverage-core:
-        - 'ctrace'
         include:
           - os-version: 'macos-latest'
             python-version: '3.x'
           - os-version: 'windows-latest'
             python-version: '3.x'
-          - os-version: 'ubuntu-latest'
-            python-version: '3.12'
-            coverage-core: 'sysmon'
-          - os-version: 'ubuntu-latest'
-            python-version: 'pypy-3.10'
-            coverage-core: 'pytrace'
+
+    env:
+      PYTHON: ${{ matrix.python-version }}
 
     runs-on: ${{ matrix.os-version }}
     steps:
@@ -65,33 +60,17 @@ jobs:
         python-version: ${{ matrix.python-version }}
 
     - name: Install deps
-      run: |
-        python -mpip install wheel
-        python -mpip install -r requirements-dev.txt
+      run: python -mpip install -r requirements-dev.txt
 
     - name: Check stubs
-      if: (! startsWith(matrix.python-version, 'pypy-'))
-      run: make mypy PYTHON=python
+      if: (startsWith(matrix.python-version, '3.12') && startswith(matrix.os-version, 'ubuntu-'))
+      run: make mypy
 
     - name: Test
-      run: make coverage PYTHON=python COVERAGE_CORE=${{ matrix.coverage-core }}
-
-    - name: Upload Coverage as artifact
-      if: always()
-      uses: actions/upload-artifact@v4
-      with:
-        name: coverage for ${{ matrix.python-version }} on ${{ matrix.os-version }} ${{ matrix.coverage-core }}
-        path: coverage.xml
+      run: python -mcoverage run --branch -m unittest testleapseconddata.py && python -mcoverage report --fail-under=100 && python -mcoverage xml
 
   pre-commit:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v4
-
-    - name: Set up Python
-      uses: actions/setup-python@v5
-      with:
-        python-version: '3.x'
-
-    - name: pre-commit
-      run: pip install pre-commit && pre-commit run --all
+    - uses: pre-commit/action@v3.0.1

{wwvb-4.0.0 → wwvb-4.1.0a0}/.gitignore

@@ -2,15 +2,13 @@
 #
 # SPDX-License-Identifier: CC0-1.0
 
-*,cover
-*.egg-info
-/.coverage*
-/.reuse
 /build
 /_build
-/coverage.xml
+/.coverage
 /dist
-/finals2000A.all.csv
+/*.egg-info
 /htmlcov
-/src/wwvb/__version__.py
 __pycache__
+*,cover
+/.reuse
+__version__.py

{wwvb-4.0.0 → wwvb-4.1.0a0}/.pre-commit-config.yaml

@@ -15,12 +15,12 @@ repos:
   -   id: trailing-whitespace
       exclude: tests
 - repo: https://github.com/fsfe/reuse-tool
-  rev: v4.0.3
+  rev: v3.0.2
   hooks:
   - id: reuse
 - repo: https://github.com/astral-sh/ruff-pre-commit
   # Ruff version.
-  rev: v0.5.1
+  rev: v0.4.3
   hooks:
     # Run the linter.
     - id: ruff

wwvb-4.1.0a0/.pylintrc

@@ -0,0 +1,9 @@
+#SPDX-FileCopyrightText: 2021 Jeff Epler
+#
+#SPDX-License-Identifier: GPL-3.0-only
+[MESSAGES CONTROL]
+disable=duplicate-code,line-too-long
+
+[BASIC]
+argument-rgx=[a-z][a-z0-9_]*
+variable-naming-style=any

wwvb-4.1.0a0/.readthedocs.yaml

@@ -0,0 +1,17 @@
+# SPDX-FileCopyrightText: 2024 Jeff Epler
+#
+# SPDX-License-Identifier: GPL-3.0-only
+
+version: 2
+
+build:
+  os: ubuntu-lts-latest
+  tools:
+    python: "3"
+
+sphinx:
+  configuration: docs/conf.py
+
+python:
+  install:
+    - requirements: requirements-dev.txt

wwvb-4.1.0a0/LICENSES/Unlicense.txt

@@ -0,0 +1,10 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.
+
+In jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and all copyright interest in the software to the public domain. We make this dedication for the benefit of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of relinquishment in perpetuity of all present and future rights to this software under copyright law.
+
+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 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.
+
+For more information, please refer to <http://unlicense.org/>

wwvb-4.1.0a0/Makefile

@@ -0,0 +1,47 @@
+VENV_BIN = _env/bin
+VENV_PYTHON = $(VENV_BIN)/python3
+
+.PHONY: all
+all: coverage mypy
+
+COVERAGE_INCLUDE=--omit '/usr/**/*.py'
+.PHONY: coverage
+coverage: $(VENV_PYTHON)
+	$(VENV_PYTHON) -mcoverage run --branch -m unittest testleapseconddata.py
+	$(VENV_PYTHON) -mcoverage html $(COVERAGE_INCLUDE)
+	$(VENV_PYTHON) -mcoverage report $(COVERAGE_INCLUDE) --fail-under=100
+
+.PHONY: mypy
+mypy: $(VENV_PYTHON)
+	$(VENV_BIN)/mypy --strict leapseconddata testleapseconddata.py
+
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?= -a -E -j auto
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = docs
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+.PHONY: help
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+
+# Route particular targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+.PHONY: html
+html: $(VENV_PYTHON)
+	@$(VENV_PYHTON) $(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+$(VENV_PYTHON):
+	python -mvenv _env
+	_env/bin/pip install -r requirements-dev.txt
+
+# Copyright (C) 2021 Jeff Epler <jepler@gmail.com>
+# SPDX-FileCopyrightText: 2021 Jeff Epler
+#
+# SPDX-License-Identifier: GPL-3.0-only

wwvb-4.1.0a0/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.1
+Name: wwvb
+Version: 4.1.0a0
+Summary: Use the list of known and scheduled leap seconds
+Author-email: Jeff Epler <jepler@gmail.com>
+Project-URL: Source, https://github.com/jepler/leapseconddata
+Project-URL: Documentation, https://leapseconddata.readthedocs.io/en/latest/
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: click
+
+<!--
+SPDX-FileCopyrightText: 2021 Jeff Epler
+
+SPDX-License-Identifier: GPL-3.0-only
+-->
+[![Test leapseconddata](https://github.com/jepler/leapseconddata/actions/workflows/test.yml/badge.svg)](https://github.com/jepler/leapseconddata/actions/workflows/test.yml)
+[![PyPI](https://img.shields.io/pypi/v/leapseconddata)](https://pypi.org/project/leapseconddata)
+[![Documentation Status](https://readthedocs.org/projects/leapseconddata/badge/?version=latest)](https://leapseconddata.readthedocs.io/en/latest/?badge=latest)
+
+# Python Leap Second List
+
+Leap seconds are corrections applied irregularly so that the UTC day stays
+fixed to the earth's rotation.
+
+This module provides a class for parsing and validating the standard
+`leap-seconds.list` file.  Once parsed, it is possible to retrieve the
+full list of leap seconds, or find the TAI-UTC offset for any UTC time.
+
+# `leapsecond` program
+
+Access leap second data from the command line.
+
+```
+Usage: leapsecond [OPTIONS] COMMAND [ARGS]...
+
+  Access leap second database information
+
+Options:
+  --url TEXT            URL for leap second data (unspecified to use default
+                        source)
+  --debug / --no-debug
+  --help                Show this message and exit.
+
+Commands:
+  convert              Convert timestamps between TAI and UTC
+  info                 Show information about leap second database
+  next-leapsecond      Get the next leap second after a given UTC timestamp
+  offset               Get the UTC offset for a given moment, in seconds
+  previous-leapsecond  Get the last leap second before a given UTC timestamp
+  table                Print information about leap seconds
+```

wwvb-4.1.0a0/README.md

@@ -0,0 +1,41 @@
+<!--
+SPDX-FileCopyrightText: 2021 Jeff Epler
+
+SPDX-License-Identifier: GPL-3.0-only
+-->
+[![Test leapseconddata](https://github.com/jepler/leapseconddata/actions/workflows/test.yml/badge.svg)](https://github.com/jepler/leapseconddata/actions/workflows/test.yml)
+[![PyPI](https://img.shields.io/pypi/v/leapseconddata)](https://pypi.org/project/leapseconddata)
+[![Documentation Status](https://readthedocs.org/projects/leapseconddata/badge/?version=latest)](https://leapseconddata.readthedocs.io/en/latest/?badge=latest)
+
+# Python Leap Second List
+
+Leap seconds are corrections applied irregularly so that the UTC day stays
+fixed to the earth's rotation.
+
+This module provides a class for parsing and validating the standard
+`leap-seconds.list` file.  Once parsed, it is possible to retrieve the
+full list of leap seconds, or find the TAI-UTC offset for any UTC time.
+
+# `leapsecond` program
+
+Access leap second data from the command line.
+
+```
+Usage: leapsecond [OPTIONS] COMMAND [ARGS]...
+
+  Access leap second database information
+
+Options:
+  --url TEXT            URL for leap second data (unspecified to use default
+                        source)
+  --debug / --no-debug
+  --help                Show this message and exit.
+
+Commands:
+  convert              Convert timestamps between TAI and UTC
+  info                 Show information about leap second database
+  next-leapsecond      Get the next leap second after a given UTC timestamp
+  offset               Get the UTC offset for a given moment, in seconds
+  previous-leapsecond  Get the last leap second before a given UTC timestamp
+  table                Print information about leap seconds
+```

{wwvb-4.0.0 → wwvb-4.1.0a0/docs}/conf.py

@@ -13,38 +13,27 @@
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 #
 import os
-import re
-import subprocess
 import sys
+import pathlib
 
-sys.path.insert(0, os.path.abspath("."))
+sys.path.insert(0, str(pathlib.Path(__file__).parent.parent))
 
+# Define the canonical URL if you are using a custom domain on Read the Docs
+html_baseurl = os.environ.get("READTHEDOCS_CANONICAL_URL", "")
+
+html_context = {}
+# Tell Jinja2 templates the build is running on Read the Docs
+if os.environ.get("READTHEDOCS", "") == "True":
+    html_context["READTHEDOCS"] = True
 
 # -- Project information -----------------------------------------------------
 
-project = "wwvb"
-copyright = "2021, Jeff Epler"
-author = "Jeff Epler"
+project = 'leapseconddata'
+copyright = '2021, Jeff Epler'
+author = 'Jeff Epler'
 
 # The full version, including alpha/beta/rc tags
-final_version = ""
-git_describe = subprocess.run(
-    ["git", "describe", "--tags", "--dirty"],
-    stdout=subprocess.PIPE,
-    stderr=subprocess.STDOUT,
-    encoding="utf-8", check=False,
-)
-if git_describe.returncode == 0:
-    git_version = re.search(
-        r"^\d(?:\.\d){0,2}(?:\-(?:alpha|beta|rc)\.\d+){0,1}",
-        str(git_describe.stdout),
-    )
-    if git_version:
-        final_version = git_version[0]
-else:
-    print("Failed to retrieve git version:", git_describe.stdout)
-
-version = release = final_version
+release = '1.1.0'
 
 
 # -- General configuration ---------------------------------------------------
@@ -53,16 +42,16 @@ version = release = final_version
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
-    "sphinx.ext.autodoc",
+    'sphinx.ext.autodoc',
 ]
 
 # Add any paths that contain templates here, relative to this directory.
-templates_path = ["_templates"]
+templates_path = ['_templates']
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This pattern also affects html_static_path and html_extra_path.
-exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
+exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
 
 
 # -- Options for HTML output -------------------------------------------------
@@ -70,12 +59,12 @@ exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = "sphinx_rtd_theme"
+html_theme = 'sphinx_rtd_theme'
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ["_static"]
+html_static_path = ['_static']
 
 autodoc_typehints = "description"
 autodoc_class_signature = "separated"

wwvb-4.1.0a0/docs/index.rst

@@ -0,0 +1,22 @@
+.. SPDX-FileCopyrightText: 2021 Jeff Epler
+..
+.. SPDX-License-Identifier: GPL-3.0-only
+
+leapseconddata
+==============
+
+.. image:: https://github.com/jepler/leapseconddata/actions/workflows/test.yml/badge.svg
+    :target: https://github.com/jepler/leapseconddata/actions/workflows/test.yml
+    :alt: Test leapseconddata
+
+.. image:: https://img.shields.io/pypi/v/leapseconddata
+    :target: https://pypi.org/project/leapseconddata
+    :alt: PyPI
+
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+.. automodule:: leapseconddata
+   :members: