GeoRacoon 1.0.0__tar.gz

georacoon-1.0.0/.github/workflows/crossPRcoverage.yml

@@ -0,0 +1,29 @@
+name: Post coverage comment (cross-repo PRs)
+
+on:
+  workflow_run:
+    workflows: ["Run Tests"]
+    types:
+      - completed
+
+jobs:
+  coverage-comment:
+    name: Post coverage comment
+    runs-on: ubuntu-24.04
+    if: github.event.workflow_run.event == 'pull_request' && github.event.workflow_run.conclusion == 'success'
+    permissions:
+      # Necessary for publishing new comments in pull requests
+      pull-requests: write
+      # Necessary for editing existing comments
+      contents: write
+      # Necessary for looking up the workflow that launched this one
+      # and downloading the related artifact
+      actions: read
+    steps:
+      # DO NOT checkout here, for security reasons
+      # See: https://securitylab.github.com/research/github-actions-preventing-pwn-requests/
+      - name: Post comment
+        uses: py-cov-action/python-coverage-comment-action@v3
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_PR_RUN_ID: ${{ github.event.workflow_run.id }}

georacoon-1.0.0/.github/workflows/deploy.yml

@@ -0,0 +1,144 @@
+name: Deployment Smoke Test
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+    branches:
+      - main
+
+env:
+  PYTHON_VERSION: "3.13"
+
+jobs:
+  smoke-test:
+    if: github.event.pull_request.draft == false
+    runs-on: ${{ matrix.runner }}
+    container: ${{ matrix.container || '' }}
+    strategy:
+      matrix:
+        include:
+          - runner: ubuntu-latest
+            os: ubuntu
+            badge-label: Ubuntu
+            container: ""
+          - runner: ubuntu-latest
+            os: fedora
+            badge-label: Fedora
+            container: fedora:latest
+          - runner: macos-latest
+            os: macos
+            badge-label: macOS
+            container: ""
+          - runner: windows-latest
+            os: windows
+            badge-label: Windows
+            container: ""
+      fail-fast: false
+    steps:
+    - name: Install system dependencies (Fedora)
+      if: matrix.os == 'fedora'
+      run: |
+        dnf install -y python3 python3-pip python3-devel gcc gcc-c++ gdal gdal-devel git git-lfs
+
+    - uses: actions/checkout@v5
+      with:
+        lfs: 'true'
+        submodules: recursive
+
+    - name: Set up Python ${{ env.PYTHON_VERSION }}
+      if: matrix.os != 'fedora'
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ env.PYTHON_VERSION }}
+
+    - name: Install GeoRacoon
+      shell: bash
+      run: |
+        git config --global --add safe.directory '*'
+        python3 -m venv .venv
+        # Windows venv uses Scripts/, Unix uses bin/
+        if [[ -f .venv/bin/activate ]]; then
+          source .venv/bin/activate
+        else
+          source .venv/Scripts/activate
+        fi
+        pip install --upgrade pip
+        pip install .
+
+    - name: Debug Python path
+      shell: bash
+      run: |
+        # Windows venv uses Scripts/, Unix uses bin/
+        if [[ -f .venv/bin/activate ]]; then
+          source .venv/bin/activate
+        else
+          source .venv/Scripts/activate
+        fi
+        echo "which python:  $(which python)"
+        echo "which python3: $(which python3 2>/dev/null || echo 'not found')"
+        python -c "import sys; print(f'sys.executable: {sys.executable}'); print(f'sys.prefix: {sys.prefix}')"
+
+    - name: Smoke test
+      shell: bash
+      run: |
+        # Windows venv uses Scripts/, Unix uses bin/
+        if [[ -f .venv/bin/activate ]]; then
+          source .venv/bin/activate
+        else
+          source .venv/Scripts/activate
+        fi
+        python -c "
+        import os, tempfile
+        import numpy as np
+        from riogrande.io import Source, Band, write_band
+        from convster.processing import select_category
+        from coonfit.inference import get_optimal_weights
+
+        # -- riogrande: write a GeoTIFF via Source, then read it back via Band
+        with tempfile.TemporaryDirectory() as tmp:
+            path = os.path.join(tmp, 'smoke.tif')
+            data = np.array([[42.0]], dtype='float32')
+            profile = dict(
+                driver='GTiff', dtype='float32',
+                width=1, height=1, count=1,
+                crs='EPSG:4326',
+            )
+            src = Source(path, profile=profile)
+            with src.open(mode='w') as dst:
+                write_band(dst, data, bidx=1, name='smoke')
+            band = Band(source=src, bidx=1, tags={'name': 'smoke'})
+            result = band.get_data()
+            assert result[0, 0] == 42.0, f'Expected 42.0, got {result[0, 0]}'
+        print('riogrande: Source write + Band read OK')
+
+        # -- convster: select_category on a tiny categorical array
+        cat = np.array([[2]], dtype='uint8')
+        sel = select_category(cat, category=2)
+        assert sel[0, 0] == np.iinfo(sel.dtype).max, f'select_category failed: {sel[0, 0]}'
+        print('convster: select_category OK')
+
+        # -- coonfit: get_optimal_weights on trivial regression
+        X = np.array([[1.0]])
+        y = np.array([2.0])
+        w = get_optimal_weights(X, y)
+        assert abs(w[0] - 2.0) < 1e-6, f'get_optimal_weights failed: {w}'
+        print('coonfit: get_optimal_weights OK')
+
+        print('All smoke tests passed')
+        "
+
+    # Update OS badge in gist (only on push to main)
+    - name: Update ${{ matrix.badge-label }} status badge
+      if: always() && github.ref == 'refs/heads/main'
+      # pinned to v1.8.0
+      uses: schneegans/dynamic-badges-action@0e50b8bad39e7e1afd3e4e9c2b7dd145fad07501
+      with:
+        auth: ${{ secrets.GIST_SECRET }}
+        gistID: ${{ vars.STATUS_GIST_ID }}
+        filename: deploy-${{ matrix.os }}.json
+        label: ${{ matrix.badge-label }}
+        message: ${{ job.status == 'success' && 'passing' || 'failing' }}
+        color: ${{ job.status == 'success' && 'brightgreen' || 'red' }}

georacoon-1.0.0/.github/workflows/develop.yml

@@ -0,0 +1,80 @@
+name: Run Tests
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, edited, ready_for_review]
+    branches:
+      - main
+permissions:
+  pull-requests: write
+  contents: write
+
+jobs:
+  unit-tests:
+    if: github.event.pull_request.draft == false
+    runs-on: ubuntu-24.04
+    strategy:
+      matrix:
+        pythonV: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+      fail-fast: false
+    steps:
+    - uses: actions/checkout@v5
+      with:
+        lfs: 'true'
+        submodules: recursive
+
+    - name: Set up Python ${{ matrix.pythonV }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.pythonV }}
+
+    - name: Install dependencies
+      run: |
+        python -m venv .venv
+        source .venv/bin/activate
+        pip install --upgrade pip
+        pip install -e .[testing]
+
+    - name: Run tests with coverage
+      run: |
+        source .venv/bin/activate
+        python -c "import multiprocessing; print(multiprocessing.cpu_count())"
+        python -m pytest -s -vvv --timeout 300 --cov
+      env:
+        COVERAGE_FILE: ".coverage.unittests"
+
+    # NOTE: we report the coverage only for the oldest python version supported
+    - name: Store coverage file
+      if: matrix.pythonV == '3.10'
+      uses: actions/upload-artifact@v4
+      with:
+        name: coverage-unittests
+        path: .coverage.unittests
+        include-hidden-files: true
+
+  coverage:
+    name: coverage-comment
+    runs-on: ubuntu-24.04
+    needs: [unit-tests]
+    if: needs.unit-tests.result == 'success' || needs.unit-tests.result == 'failure'
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/download-artifact@v4
+        id: download
+        with:
+          pattern: coverage-*
+          merge-multiple: true
+
+      - name: Coverage comment
+        id: coverage_comment
+        uses: py-cov-action/python-coverage-comment-action@v3
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          MERGE_COVERAGE_FILES: true
+
+      - name: Store Pull Request comment to be posted
+        uses: actions/upload-artifact@v4
+        if: steps.coverage_comment.outputs.COMMENT_FILE_WRITTEN == 'true'
+        with:
+          name: python-coverage-comment-action
+          path: python-coverage-comment-action.txt

georacoon-1.0.0/.github/workflows/docs_deploy.yml

@@ -0,0 +1,38 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  build-and-deploy-docs:
+    runs-on: ubuntu-24.04
+    steps:
+    - uses: actions/checkout@v3
+      with:
+        submodules: recursive
+    
+    - name: Set up Python 3.10
+      uses: actions/setup-python@v3
+      with:
+        python-version: '3.10'
+    
+    - name: Install documentation dependencies
+      run: |
+        python -m venv .venv
+        source .venv/bin/activate
+        pip install --upgrade pip
+        pip install -r docs/requirements.txt
+        pip install -e .
+    
+    - name: Generate API docs and build documentation
+      run: |
+        source .venv/bin/activate
+        sphinx-build -b html docs public
+    
+    # TODO: change to proper deployment
+    # - name: Deploy to GitHub Pages
+    #   uses: peaceiris/actions-gh-pages@v3
+    #   with:
+    #     github_token: ${{ secrets.GITHUB_TOKEN }}
+    #     publish_dir: ./public

georacoon-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,105 @@
+# Release workflow: builds sdist, creates a GitHub Release with
+# auto-generated notes, and publishes to PyPI via OIDC trusted publishing.
+# The PyPI publish step is gated on the ``pypi`` GitHub environment, which
+# is configured (in repo settings) to require manual reviewer approval.
+#
+# Tag conventions (no ``v`` prefix; SemVer-style):
+#   1.2.3            -- final release
+#   1.2.3-rc1        -- pre-releases (alpha / beta / rc; PEP 440 normalises
+#                       ``1.2.3-rc1`` to ``1.2.3rc1`` for the wheel version)
+#
+# Prerequisites (configured outside this workflow):
+#   * PyPI trusted publisher: workflow=release.yml, environment=pypi
+#   * GitHub environment ``pypi`` with required reviewers
+#   * Tag protection rule for the patterns below
+
+name: Release
+
+on:
+  push:
+    tags:
+      - '[0-9]+.[0-9]+.[0-9]+'
+      - '[0-9]+.[0-9]+.[0-9]+-[abr]*'
+
+permissions:
+  contents: read
+
+jobs:
+  guard_main:
+    # Refuse to release from a tag that does not point at a commit on main.
+    # Prevents accidental releases from feature branches or stale tags.
+    name: Verify tag is on main
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Check tag commit is an ancestor of origin/main
+        run: |
+          git fetch origin main
+          if ! git merge-base --is-ancestor "$GITHUB_SHA" origin/main; then
+            echo "::error::Tag commit $GITHUB_SHA is not on origin/main; refusing to release."
+            exit 1
+          fi
+
+  build:
+    name: Build artifacts
+    needs: guard_main
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          # hatch-vcs needs the full history (or at least tags) to resolve
+          # the version dynamically.
+          fetch-depth: 0
+
+      - name: Build wheel and sdist
+        run: pipx run build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist-${{ github.ref_name }}
+          path: dist/*
+
+  create_github_release:
+    name: Create GitHub Release
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: dist-*
+          path: dist
+          merge-multiple: true
+
+      - name: Create release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: dist/*
+          # Mark pre-releases (anything with a/b/rc in the tag) appropriately
+          # so PyPI/users see the right channel.
+          prerelease: ${{ contains(github.ref_name, 'a') || contains(github.ref_name, 'b') || contains(github.ref_name, 'rc') }}
+
+  publish_pypi:
+    name: Publish to PyPI
+    needs: create_github_release
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/tempnet
+    permissions:
+      id-token: write       # OIDC for trusted publishing
+      attestations: write   # sigstore provenance attestations
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: dist-*
+          path: dist
+          merge-multiple: true
+
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          attestations: true

georacoon-1.0.0/.github/workflows/status.yml

@@ -0,0 +1,82 @@
+name: Status
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  unit-tests:
+    runs-on: ubuntu-24.04
+    strategy:
+      matrix:
+        pythonV: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+      fail-fast: false
+    steps:
+    - uses: actions/checkout@v5
+      with:
+        lfs: 'true'
+        submodules: recursive
+
+    - name: Set up Python ${{ matrix.pythonV }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.pythonV }}
+
+    - name: Install dependencies
+      run: |
+        python -m venv .venv
+        source .venv/bin/activate
+        pip install --upgrade pip
+        pip install -e .[testing]
+
+    - name: Run tests with coverage
+      run: |
+        source .venv/bin/activate
+        python -c "import multiprocessing; print(multiprocessing.cpu_count())"
+        python -m pytest -s -vvv --timeout 600 --cov
+      env:
+        COVERAGE_FILE: ".coverage.unittests"
+
+    # NOTE: we report the coverage only for the oldest python version supported
+    - name: Store coverage file
+      if: matrix.pythonV == '3.10'
+      uses: actions/upload-artifact@v4
+      with:
+        name: coverage-unittests
+        path: .coverage.unittests
+        include-hidden-files: true
+
+    # Update per-version pass/fail badge in gist
+    - name: Update Python ${{ matrix.pythonV }} status badge
+      if: always()
+      # pinned to v1.8.0
+      uses: schneegans/dynamic-badges-action@0e50b8bad39e7e1afd3e4e9c2b7dd145fad07501
+      with:
+        auth: ${{ secrets.GIST_SECRET }}
+        gistID: ${{ vars.STATUS_GIST_ID }}
+        filename: python-${{ matrix.pythonV }}.json
+        label: "Python ${{ matrix.pythonV }}"
+        message: ${{ job.status == 'success' && 'passing' || 'failing' }}
+        color: ${{ job.status == 'success' && 'brightgreen' || 'red' }}
+
+  coverage-badge:
+    name: coverage-badge
+    runs-on: ubuntu-24.04
+    needs: [unit-tests]
+    if: always()
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/download-artifact@v4
+        id: download
+        with:
+          pattern: coverage-*
+          merge-multiple: true
+
+      - name: Update coverage badge
+        uses: py-cov-action/python-coverage-comment-action@v3
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          MERGE_COVERAGE_FILES: true

georacoon-1.0.0/.github/workflows/test_release.yml

@@ -0,0 +1,62 @@
+# Manual TestPyPI dry-run. Trigger via the Actions tab; the branch picker
+# in the workflow_dispatch UI selects which ref to build from. Useful for
+# validating the build and publish pipeline before cutting a real release tag.
+#
+# Prerequisites (configured outside this workflow):
+#   * TestPyPI trusted publisher: workflow=test_release.yml, environment=testpypi
+#   * GitHub environment ``testpypi`` (no reviewers required)
+
+name: Test release (TestPyPI)
+
+on:
+  workflow_dispatch: {}
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build artifacts
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Build wheel and sdist
+        # TestPyPI rejects PEP 440 local version segments (the ``+gSHA``
+        # suffix hatch-vcs appends on non-tag commits). Strip it here --
+        # and only here -- so PyPI releases and local dev installs are
+        # unaffected.
+        env:
+          SETUPTOOLS_SCM_LOCAL_SCHEME: no-local-version
+        run: pipx run build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist-testrelease
+          path: dist/*
+
+  publish_testpypi:
+    name: Publish to TestPyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/tempnet
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: dist-*
+          path: dist
+          merge-multiple: true
+
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          # TestPyPI rejects re-uploads of an existing version; allow the
+          # workflow to succeed when the version already exists so repeated
+          # dry-runs from the same commit don't fail noisily.
+          skip-existing: true

georacoon-1.0.0/.gitignore

@@ -0,0 +1,159 @@
+# ignore api folder for docs
+docs/api/
+public/
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# 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/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+docs/auto_examples/
+docs/sg_execution_times.rst
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Pycharm project settings
+.idea
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# vim
+*.swp
+
+# any slurm output file
+*.out
+
+# exclude local configurations
+locals.py
+
+# generally exclude results and input data
+data/
+results/
+*.png
+*.pdf
+*.tif
+
+# nixos
+shell.nix
+
+*.revision