GSEGUtils 0.5.2__tar.gz

gsegutils-0.5.2/.git_archival.txt

@@ -0,0 +1,3 @@
+node:         $Format:%H$
+node-date:    $Format:%cI$
+describe-name:$Format:%(describe:tags=true,match=v*,match=release-*)$

gsegutils-0.5.2/.gitattributes

@@ -0,0 +1 @@
+.git_archival.txt export-subst

gsegutils-0.5.2/.github/actions/setup-python-deps/action.yml

@@ -0,0 +1,23 @@
+name: Setup Python + deps (GSEGUtils)
+description: >
+  Set up Python 3.12, restore pip cache, and install GSEGUtils[dev]. The
+  caller MUST run `actions/checkout` BEFORE invoking this composite —
+  GitHub needs the repo on the runner filesystem to find this action.yml.
+  Intentionally asymmetric with the pchandler variant — omits the
+  deploy-key SSH step (no cross-repo git+ssh dep). See pchandler workspace
+  Phase 8 CONTEXT.md Claude's Discretion §Composite action scope.
+
+runs:
+  using: composite
+  steps:
+    - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
+      with:
+        python-version: "3.12"
+
+    - uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae  # v5.0.5
+      with:
+        path: ~/.cache/pip
+        key: pip-${{ runner.os }}-3.12-${{ hashFiles('pyproject.toml') }}
+
+    - shell: bash
+      run: pip install .[dev]

gsegutils-0.5.2/.github/workflows/ci.yml

@@ -0,0 +1,88 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: [main, refactor/gsd]
+
+jobs:
+  lint:
+    name: Lint (pre-commit)
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          # On PRs, check out the head branch so pushes work
+          ref: ${{ github.event_name == 'pull_request' && github.head_ref || '' }}
+          token: ${{ secrets.GITHUB_TOKEN }}
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Run pre-commit on PRs
+        if: github.event_name == 'pull_request'
+        uses: pre-commit/action@v3.0.1
+        with:
+          extra_args: --all-files
+
+      - name: Run pre-commit on push
+        if: github.event_name == 'push'
+        uses: pre-commit/action@v3.0.1
+        with:
+          extra_args: --all-files
+
+  tests:
+    name: Tests (pytest)
+    needs: [lint]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Cache pip
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: pip-${{ runner.os }}-3.12-${{ hashFiles('pyproject.toml') }}
+
+      - name: Install dev deps
+        run: pip install .[dev]
+
+      - name: Pyright (informational)
+        id: pyright
+        continue-on-error: true
+        uses: jakebailey/pyright-action@v3
+        with:
+          annotate: warnings
+          # NOTE: leave the `warnings` input UNSET — setting it to `true` would
+          # ESCALATE warnings to exit 1 (Pitfall 2 in 01-RESEARCH.md). The
+          # warn-only semantics come from the step-level continue-on-error flag.
+          working-directory: .
+
+      - name: Upload pyright report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: pyright-report-${{ github.run_id }}
+          path: .pyright-report.json
+          if-no-files-found: ignore
+
+      - name: Run tests
+        run: pytest -m "not benchmark" --cov=GSEGUtils --cov-report=xml
+
+      - name: Upload coverage to Codecov
+        if: success()
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}

gsegutils-0.5.2/.github/workflows/publish-pypi.yml

@@ -0,0 +1,53 @@
+name: Publish to PyPI
+
+"on":
+  release:
+    types: [published]
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd  # v5.0.1
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+
+      - uses: ./.github/actions/setup-python-deps
+
+      - name: Build wheel and sdist
+        run: |
+          pip install build
+          python -m build --wheel --sdist
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a  # v7.0.1
+        with:
+          name: dist-${{ github.run_id }}
+          path: dist/
+          retention-days: 1
+
+  publish-to-pypi:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/GSEGUtils
+    permissions:
+      id-token: write      # OIDC token for trusted publisher + Sigstore signing
+      attestations: write  # per PYPI-01 locked spec
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c  # v8.0.1
+        with:
+          name: dist-${{ github.run_id }}
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b  # v1.14.0
+        # attestations: true is the default — PEP 740 attestation auto-produced by the action
+        # No repository-url override (defaults to https://upload.pypi.org/legacy/)

gsegutils-0.5.2/.github/workflows/publish-testpypi.yml

@@ -0,0 +1,53 @@
+name: Publish to TestPyPI
+
+"on":
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Build distribution (TestPyPI)
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd  # v5.0.1
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+
+      - uses: ./.github/actions/setup-python-deps
+
+      - name: Build wheel and sdist
+        run: |
+          pip install build
+          python -m build --wheel --sdist
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a  # v7.0.1
+        with:
+          name: dist-testpypi-${{ github.run_id }}
+          path: dist/
+          retention-days: 1
+
+  publish-to-testpypi:
+    name: Publish to TestPyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/GSEGUtils
+    permissions:
+      id-token: write  # OIDC token for trusted publisher (D-09: no attestations:write)
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c  # v8.0.1
+        with:
+          name: dist-testpypi-${{ github.run_id }}
+          path: dist/
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b  # v1.14.0
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          attestations: false   # D-09: TestPyPI PEP 740 support inconsistent; dry-run proves pipeline not signing
+          skip-existing: true   # allow repeat dispatches from same HEAD without failure (RESEARCH Pitfall 2)

gsegutils-0.5.2/.github/workflows/release-please.yml

@@ -0,0 +1,55 @@
+name: release-please
+on:
+  workflow_run:
+    workflows:
+      - CI
+    types: [completed]
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pull-requests: write
+  issues: write
+
+jobs:
+  release-please:
+    if: ${{ github.event.workflow_run.conclusion == 'success' }}
+    runs-on: ubuntu-latest
+    steps:
+      - id: app-token
+        uses: actions/create-github-app-token@bcd2ba49218906704ab6c1aa796996da409d3eb1  # v3.2.0
+        with:
+          app-id: ${{ secrets.APP_ID }}
+          private-key: ${{ secrets.APP_PRIVATE_KEY }}
+
+      - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd  # v5.0.1
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+          token: ${{ steps.app-token.outputs.token }}
+
+      - uses: googleapis/release-please-action@45996ed1f6d02564a971a2fa1b5860e934307cf7  # v5.0.0
+        id: release
+        with:
+          token: ${{ steps.app-token.outputs.token }}
+          config-file: release-please-config.json
+#          release-type: python
+
+      - name: Tag major and minor versions
+        if: ${{ steps.release.outputs.release_created == 'true' }}
+        run: |
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+
+          # Clean up old tags if they exist
+          git tag -d v${{ steps.release.outputs.major }} || true
+          git tag -d v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }} || true
+          git push origin :refs/tags/v${{ steps.release.outputs.major }} || true
+          git push origin :refs/tags/v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }} || true
+
+          # Create and push new tags
+          git tag -a v${{ steps.release.outputs.major }} -m "Release v${{ steps.release.outputs.major }}"
+          git tag -a v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }} -m "Release v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }}"
+          git push origin v${{ steps.release.outputs.major }}
+          git push origin v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }}

gsegutils-0.5.2/.gitignore

@@ -0,0 +1,199 @@
+# Actions
+src/**/_version.py
+
+# Old files
+_old/
+_scrap/
+_future/
+
+
+# BAK files
+**/*.bak
+
+# Created by .ignore support plugin (hsz.mobi)
+### Python template
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*,cover
+.hypothesis/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# IPython Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# dotenv
+.env
+
+# virtualenv
+venv/
+ENV/
+
+# Spyder project settings
+.spyderproject
+
+# Rope project settings
+.ropeproject
+### VirtualEnv template
+# Virtualenv
+# http://iamzed.com/2009/05/07/a-primer-on-virtualenv/
+[Bb]in
+[Ii]nclude
+[Ll]ib
+[Ll]ib64
+[Ll]ocal
+[Ss]cripts
+pyvenv.cfg
+.venv
+pip-selfcheck.json
+
+### JetBrains template
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
+
+# User-specific stuff
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/dictionaries
+.idea/**/shelf
+
+# AWS User-specific
+.idea/**/aws.xml
+
+# Generated files
+.idea/**/contentModel.xml
+
+# Sensitive or high-churn files
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+.idea/**/dbnavigator.xml
+
+# Gradle
+.idea/**/gradle.xml
+.idea/**/libraries
+
+# Gradle and Maven with auto-import
+# When using Gradle or Maven with auto-import, you should exclude module files,
+# since they will be recreated, and may cause churn.  Uncomment if using
+# auto-import.
+# .idea/artifacts
+# .idea/compiler.xml
+# .idea/jarRepositories.xml
+# .idea/modules.xml
+# .idea/*.iml
+# .idea/modules
+# *.iml
+# *.ipr
+
+# CMake
+cmake-build-*/
+
+# Mongo Explorer plugin
+.idea/**/mongoSettings.xml
+
+# File-based project format
+*.iws
+
+# IntelliJ
+out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Cursive Clojure plugin
+.idea/replstate.xml
+
+# SonarLint plugin
+.idea/sonarlint/
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+
+# Editor-based Rest Client
+.idea/httpRequests
+
+# Android studio 3.1+ serialized cache file
+.idea/caches/build_file_checksums.ser
+
+# idea folder, uncomment if you don't need it
+.idea/
+
+.vscode/

gsegutils-0.5.2/.license-header.txt

@@ -0,0 +1,12 @@
+GSEGUtils – General utility functions and classes for GSEG research/projects
+
+Copyright (c) 2025–2026 ETH Zurich
+Department of Civil, Environmental and Geomatic Engineering (D-BAUG)
+Institute of Geodesy and Photogrammetry
+Geosensors and Engineering Geodesy
+
+Authors:
+  Nicholas Meyer
+  Jon Allemand
+
+SPDX-License-Identifier: BSD-3-Clause

gsegutils-0.5.2/.pre-commit-config.yaml

@@ -0,0 +1,61 @@
+repos:
+  - repo: https://github.com/Lucas-C/pre-commit-hooks
+    rev: v1.5.4
+    hooks:
+      - id: insert-license
+        name: Insert project banner into Python files
+        files: ^src/.*\.(py|pyi)$
+        exclude: ^(?:tests/|examples/|\.venv/|venv/|\.git/|build/|dist/|docs/_build/|\.mypy_cache/|\.pytest_cache/|\.ruff_cache/|\.tox/|\.eggs/|site-packages/)
+        args:
+          - --license-filepath=.license-header.txt
+          - --comment-style=#
+          - --use-current-year
+          - --allow-past-years
+          - --detect-license-in-X-top-lines=30
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-added-large-files
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.12
+    hooks:
+      - id: ruff-check
+        args: ["--fix"]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.17.1
+    hooks:
+      - id: mypy
+        args: ["--config-file", "mypy.ini"]
+        pass_filenames: false
+        # The pydantic.mypy plugin is loaded by mypy at startup (see mypy.ini
+        # `plugins = pydantic.mypy`). mirrors-mypy runs in an isolated venv,
+        # so plugin packages must be declared as additional_dependencies here.
+        additional_dependencies:
+          - "pydantic~=2.11"
+          - "numpy>=2.0,<2.4"
+          - "numpydantic~=1.10"
+
+  - repo: local
+    hooks:
+      - id: pyright-informational
+        name: pyright (informational, never blocks)
+        # language: python + additional_dependencies so the hook works in CI
+        # (lint job installs only `pre-commit` — no system pyright). The pip
+        # `pyright` package fetches its Node binary at install time. Local dev
+        # already has pyright via `pip install -e .[dev]`, so this is a no-op
+        # there. The `|| true` keeps the hook non-blocking regardless.
+        entry: bash -c 'pyright "$@" || true' --
+        language: python
+        additional_dependencies: ["pyright~=1.1"]
+        types: [python]
+        require_serial: true
+        pass_filenames: false
+        verbose: true

gsegutils-0.5.2/.readthedocs.yaml

@@ -0,0 +1,24 @@
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+# Set the OS, Python version, and other tools you might need
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.12"
+  jobs:
+    post_build:
+      - if [ -f "$READTHEDOCS_OUTPUT/html/LICENSE" ]; then mv "$READTHEDOCS_OUTPUT/html/LICENSE" "$READTHEDOCS_OUTPUT/html/LICENSE.txt"; fi
+
+sphinx:
+  configuration: docs/source/conf.py
+
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - doc

gsegutils-0.5.2/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.5.2"
+}