rastr 0.1.0__tar.gz

rastr-0.1.0/.copier-answers.yml

@@ -0,0 +1,17 @@
+# Changes here will be overwritten by Copier
+_commit: v0.5.6
+_src_path: git+https://bitbucket.org/tonkintaylor/python-template
+is_advanced: true
+is_confluence_used: false
+is_doc_used: false
+is_jira_used: false
+is_projectwide_config_used: false
+is_rstyle_config_used: false
+is_sonarqube_used: false
+is_ttpy_namespace: false
+max_line_length: '88'
+name_slug: rastr
+project_name: rastr
+project_short_description: Geospatial Raster datatype library for Python.
+py_version: 3.12.11
+tt_job_num: YYYTTNZ.0700

rastr-0.1.0/.github/ISSUE_TEMPLATE/bug-report.md

@@ -0,0 +1,20 @@
+---
+name: Bug Report
+about: Describe a bug or anything else that seems wrong
+title: ''
+labels: 'bug'
+
+---
+
+**Background**
+Give some context for how you encountered the problem. What were you doing?
+
+**Summary of the problem**
+A clear and concise description of the problem that seems to be happening.
+
+**Expected behaviour**
+What did you expect to happen instead?
+
+**Reproduction**
+Are you able to reproduce the error or is it intermittent? Which version of rastr
+are you using? Which operating system are you using?

rastr-0.1.0/.github/ISSUE_TEMPLATE/enhancement.md

@@ -0,0 +1,12 @@
+---
+name: Enhancement Request
+about: A high-level description of a feature or other enhancement you'd like
+title: ''
+labels: ''
+---
+
+**Motivation**
+A clear and concise description of what benefit you would get from this enhancement.
+
+**Summary**
+A clear and concise description of what you want to happen, at a high level.

rastr-0.1.0/.github/copilot-instructions.md

@@ -0,0 +1,93 @@
+# Custom Instructions
+
+## General Guidelines
+
+- We are using Windows for development and Linux for deployment/CI. When running commands in terminal, use Windows commands for local development (like ";" instead of "&&" to separate commands) and Linux commands when running in CI environments.
+- Every time I ask you to fix linter errors and provide the error messages, update the Linter section in `.github/copilot-instructions.md` accordingly. Use concise, oneliner instruction. Ensure your future responses avoid repeating the same errors.
+- Never create notebooks (ipynb files) unless asked explicitly.
+
+## Testing  
+
+- Write unit tests using `pytest` inside `tests/`, structured based on `src/`.  
+  - Example: `src/x/y/z` → `tests/x/y/test_z.py`  
+- Use test fixtures and group tests into classes when appropriate.  
+- After modifying a function, run its unit tests using pytest.
+- Run tests in virtual environment: `.\.venv\Scripts\activate; python -m pytest tests/path/to/test_file.py -v`
+
+## Python
+
+- We use Python 3.12, so ensure that the code is compatible and up to date with this version.
+- When adding a new package that requires installation, list it under dependencies in `pyproject.toml`, then run `tasks\dev_sync.ps1`.
+- Limit line length to 100 characters.
+- We are using uv to install packages.
+- Never create functions that return more than one output value.
+- Never return tuples; use dictionaries for multiple return values.
+- Do not add exceptions to functions unless explicitly requested.
+- Prefer to type hint strictly with the likes of `Literal["a", "b"]` instead of hinting broader types like `str`. This means the constraints on the input arguments to a function can reside in the type annotation rather than the docstring. Consider @validate_call (from pydantic import validate_call) to avoid boilerplate case-checking in such cases.
+- Refrain from backslash unescaping in raw strings (e.g., `r"\\path"` should be `r"\path"`).
+- When writing scripts, always use "Scripting Style" (Top-Level Code) unless stated otherwise. Write code directly at the module level instead of wrapping in functions or `if __name__ == "__main__":` blocks.
+- For scripts that need to access package files (e.g., templates, data files):
+
+  ```python
+  from importlib.resources import files
+  
+  # Define package path as a module-level constant
+  PACKAGE_PATH = files('package.subpackage.module')
+  
+  # Use joinpath for accessing files
+  file_path = Path(str(PACKAGE_PATH.joinpath('filename')))
+  ```
+
+  This ensures consistent path resolution in both interactive and script modes.
+
+## Documenting Functions
+
+- Remove dtype specifications from all `Args:` sections (e.g., `text (str):` → `text:`)
+- Use "Args:" instead of "Parameters:" for consistency
+
+## Code Structure & Data Handling
+
+- Use value objects stored in `src/<package_name>/domain/value_object.py`, implemented using Pandera > v0.2 and Pydantic. Prefer passing DataFrame when possible.  
+- Use Pandera > v0.2 syntax, such as `DataFrameModel` when possible.
+- When importing internal modules, do not include the "src" folder in the import path as it is already defined in pyproject.toml
+
+## Linter
+
+- For file-level linter suppressions, use `# ruff: noqa: RULE1, RULE2` format (not `# ruff noqa:`)
+- For line-level suppressions, use `# noqa: RULE1, RULE2` format
+- Use `pathlib.Path` for all filesystem operations instead of `os.path`. Path objects provide a more readable and maintainable object-oriented interface (e.g., `Path('dir') / 'file.txt'` instead of `os.path.join()`, `path.exists()` instead of `os.path.exists()`, etc.)
+- Exception messages must not use string literals directly, assign to variables first
+- Try-except patterns: Use bare `raise` in except blocks to preserve the original traceback, put return statements in the `else` block when using try-except (e.g., `try: result = process() except Exception: raise else: return result`)
+- Remove trailing whitespace from blank lines (W293)
+- Move statements after try blocks into else blocks when the statements depend on the try block's success (TRY300)
+- Use logging.exception instead of logging.error in except blocks (TRY400)
+- Do not include the exception object in logging.exception calls (TRY401)
+- Use keyword arguments for boolean parameters (FBT003) instead of positional arguments
+- Make boolean default arguments keyword-only using `*` to prevent positional passing (FBT002)
+- Avoid variable names that shadow Python builtins (A001)
+- Use snake_case for all variables in global scope (N816), not camelCase or mixedCase
+- Remove unused code instead of commenting it out (ERA001)
+- Break long docstring lines at logical points to stay under the 88 character limit (E501)
+- Include a blank line between docstring summary and description (D205)
+- Add type annotations to function signatures (ANN201, ANN204)
+- Add `# noqa: N806` comment for scikit-learn convention of uppercase X in tests
+- Use `dict` instead of `Dict` for type annotation (UP006)
+- Avoid importing deprecated types like `typing.Dict` (UP035)
+- Remove unused code instead of commenting it out (ERA001)
+- Never use `from __future__ import annotations` in any file; Python 3.11+ does not require it.
+
+## Testing
+
+- Use `pytest` for testing, and ensure all tests are passing before committing changes.
+- Do not perform equality checks with floating point values; instead, use `pytest.approx`.
+- Use only one assert statement per test function to ensure clarity and simplicity.
+
+## Documentation & Workflow Management
+
+- Document reusable knowledge (e.g., library versions, fixes, corrections) in the `Lessons` section of `.github/scratchpad.md`.  
+- Use `.github/scratchpad.md` to organise tasks:  
+  - Clear old tasks when starting a new one.  
+  - Plan steps and track progress using TODO markers:  
+    - [X] Task 1  
+    - [ ] Task 2  
+  - Update task progress, especially after milestones.

rastr-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,125 @@
+name: CI
+permissions:
+  contents: read
+  pull-requests: write
+on:
+  workflow_dispatch:
+  push:
+    branches: ['master', 'develop']
+    paths-ignore:
+      - 'docs/**'
+      - '**/*.md'
+      - 'mkdocs.yml'
+  pull_request:
+    branches: ['master', 'develop']
+    paths-ignore:
+      - 'docs/**'
+      - '**/*.md'
+      - 'mkdocs.yml'
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  tests:
+    runs-on: ${{ matrix.os }}
+    env:
+      PYTHONIOENCODING: utf-8
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+
+      - name: Setup git user config
+        run: |
+          git config --global user.name placeholder
+          git config --global user.email placeholder@example.com
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@f94ec6bedd8674c4426838e6b50417d36b6ab231 # v5.3.1
+        with:
+          version: "0.8.3" # Sync with pyproject.toml
+          enable-cache: true
+
+      - name: Set up Python
+        uses: actions/setup-python@0b93645e9fea7318ecaed2b359559ac225c90a2b # v5.3.0
+        with:
+          python-version: ${{ matrix.python-version }}
+        
+      - name: Setup dependencies
+        run: |
+          uv python pin ${{ matrix.python-version }}
+          uv export --no-managed-python --no-group doc --resolution ${{ matrix.resolution }} > ci-requirements.txt 
+          uv pip install --system -r ci-requirements.txt
+
+      - name: Run pre-commit
+        if: matrix.pre-commit
+        run: |
+          uv run --frozen pre-commit run --all-files
+
+      - name: Run pytest
+        uses: pavelzw/pytest-action@510c5e90c360a185039bea56ce8b3e7e51a16507 # v2.2.0
+        if: matrix.pytest
+        with:
+          custom-arguments: --cov --junitxml=junit.xml -o junit_family=legacy --cov-report=xml
+
+      - name: Create test reports directory
+        if: matrix.pytest && matrix.os == 'ubuntu-latest' && matrix.python-version == '3.13'
+        run: mkdir -p ./test-reports
+
+      - name: Upload coverage reports
+        if: matrix.pytest && matrix.os == 'ubuntu-latest' && matrix.python-version == '3.13'
+        uses: actions/upload-artifact@b4b15b8c7c6ac21ea08fcf65892d2ee8f75cf882 # v4.4.3
+        with:
+          name: coverage-reports
+          path: test-reports/coverage.xml
+
+    strategy:
+      matrix:
+        os: ["ubuntu-latest", "macos-latest", "windows-latest"]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        resolution: ["highest"]
+        pre-commit: [true]
+        pytest: [true]
+        include:
+          - os: "ubuntu-latest"
+            python-version: "3.10"
+            resolution: "lowest-direct"
+            pre-commit: false
+            pytest: true
+
+  code-analysis:
+    name: Analyse Code Quality
+    runs-on: ubuntu-latest
+    needs: tests
+    if: always() && needs.tests.result == 'success'
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        with:
+          fetch-depth: 0  # Shallow clones should be disabled for better relevancy of analysis
+      
+      - name: Download coverage reports
+        uses: actions/download-artifact@fa0a91b85d4f404e444e00e005971372dc801d16 # v4.1.8
+        with:
+          name: coverage-reports
+          path: test-reports/
+        continue-on-error: true
+      
+      - name: Create SonarQube properties
+        run: |
+          cat > sonar-project.properties << EOF
+          sonar.projectKey=${{ vars.SONAR_PROJECT_KEY }}
+          sonar.language=py
+          sonar.python.version=3.13
+          sonar.sources=./src
+          sonar.tests=./tests
+          sonar.python.coverage.reportPaths=./test-reports/coverage.xml
+          sonar.exclusions=**/Dockerfile,**/notebooks/**,**/scripts/**
+          sonar.verbose=false
+          EOF
+      
+      - name: Run SonarQube analysis
+        uses: SonarSource/sonarqube-scan-action@884b79409bbd464b2a59edc326a4b77dc56b2195 # v3.1.0
+        env:
+          SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
+          SONAR_HOST_URL: ${{ vars.SONAR_HOST_URL }}

rastr-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,32 @@
+
+name: Release to PyPI
+permissions:
+  contents: read
+on:
+  push:
+    tags:
+      - 'v*'
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write
+    steps:
+        - name: Checkout code
+          uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+
+        - name: Set up uv
+          uses: astral-sh/setup-uv@3b9817b1bf26186f03ab8277bab9b827ea5cc254 # v3.2.0
+          with:
+            version: "0.8.3" # Sync with pyproject.toml
+
+        - name: "Set up Python"
+          uses: actions/setup-python@0b93645e9fea7318ecaed2b359559ac225c90a2b # v5.3.0
+          with:
+            python-version: 3.13
+
+        - name: Release
+          run: |
+            uv build
+            uv publish --trusted-publishing always

rastr-0.1.0/.gitignore

@@ -0,0 +1,241 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+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/
+cover/
+
+# 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/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .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
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Profiling output
+*.prof
+
+# Black formatter temp files
+*.py.*.tmp
+
+# Draw.io temp files
+~drawio~*~*.drawio.tmp
+
+# VS Code config
+.vscode/
+!.vscode/settings.template.json
+
+# Windows thumbnail cache files
+Thumbs.db
+
+# Project Configuration file
+.config.yaml
+
+# Cached datasets
+.datasetcache
+
+# Microsoft Office lock files
+~$*.xlsx
+
+# Automatically generated version file
+src/**/_version.py
+
+# Automatically generated Sphinx API documentation
+doc/source/_apidoc/
+
+# GitHub Copilot scratchpad
+.github/scratchpad.md

rastr-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,138 @@
+ci:
+    autofix_prs: false
+repos:
+  - repo: local
+    hooks:
+      # Prevent committing .rej files from copier
+      - id: forbidden-copier-rej-files
+        name: forbidden copier rej files
+        entry: found Copier update rejection files; review them and remove them
+        language: fail
+        files: \.rej$
+
+  - repo: local
+    hooks:
+      # Prevent committing test.py files within the tests directory
+      - id: forbidden-testpy-files
+        name: forbidden testpy files
+        entry: found test.py file inside tests directory; rename or remove them
+        language: fail
+        files: ((./tests/.*/test.py)|(./tests/test.py))$
+
+  - repo: https://github.com/abravalheri/validate-pyproject
+    rev: v0.23
+    hooks:
+      - id: validate-pyproject
+
+  - repo: local
+    hooks:
+      - id: uv-lock
+        name: uv-lock
+        entry: uv lock --offline
+        files: ^(uv\.lock|pyproject\.toml|uv\.toml)$
+        additional_dependencies:
+          - uv==0.8.3
+        language: python
+        always_run: true
+        pass_filenames: false
+      - id: uv-sync
+        name: uv-sync
+        entry: uv sync --no-active --offline
+        args: [--locked]
+        additional_dependencies:
+          - uv==0.8.3
+        language: python
+        always_run: true
+        pass_filenames: false
+        stages: [manual, pre-commit, pre-push, post-checkout, post-merge, 
+                post-rewrite]
+      - id: uv-export
+        name: uv-export
+        files: ^uv\.lock|requirements.txt$
+        entry: uv export --frozen --offline --quiet --no-default-groups 
+            -o="requirements.txt"
+        additional_dependencies:
+          - uv==0.8.3
+        language: python
+        pass_filenames: false
+        require_serial: true
+
+  - repo: https://github.com/tox-dev/pyproject-fmt
+    rev: v2.6.0
+    hooks:
+      - id: pyproject-fmt
+  - repo: https://github.com/python-formate/flake8-dunder-all
+    rev: v0.4.1
+    hooks:
+      - id: ensure-dunder-all
+        files: .*/__init__\.py$
+        exclude: tests/assets/
+
+  - repo: local
+    hooks:
+      - id: ruff-format
+        name: ruff-format
+        always_run: true
+        entry: uv run --frozen --offline ruff format --force-exclude
+        types_or: [python, pyi, jupyter]
+        additional_dependencies:
+          - uv==0.8.3
+        language: python
+        pass_filenames: false
+      - id: ruff-check
+        name: ruff-check
+        always_run: true
+        entry: uv run --frozen --offline ruff check --fix  --force-exclude 
+            --ignore "FIX"
+        types_or: [python, pyi, jupyter]
+        additional_dependencies:
+          - uv==0.8.3
+        language: python
+        pass_filenames: false
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: check-added-large-files
+        args: [--maxkb=100000]
+      - id: trailing-whitespace
+        exclude: (.*\.sh|.*\.d2|.*\.md|.*\.drawio|.*egg-info.*|)$
+      - id: check-merge-conflict
+        args: [--assume-in-merge]
+
+  - repo: local
+    hooks:
+      - id: nbstripout
+        name: nbstripout
+        entry: uv run --frozen --offline nbstripout
+        additional_dependencies:
+          - uv==0.8.3
+        language: python
+        files: .*\.(ipynb)$
+        exclude: .*\.(example|template|keepoutput|)\.ipynb$
+
+  - repo: local
+    hooks:
+      - id: deptry
+        name: deptry
+        entry: uv run --frozen --offline deptry src
+        additional_dependencies:
+          - uv==0.8.3
+        language: python
+        always_run: true
+        pass_filenames: false
+  - repo: https://github.com/codespell-project/codespell
+    rev: v2.4.1
+    hooks:
+      - id: codespell
+        additional_dependencies:
+          - tomli
+default_install_hook_types:
+  - pre-commit
+  - pre-push
+  - post-checkout
+  - post-merge
+  - post-rewrite
+default_stages:
+  - pre-commit
+  - pre-push

rastr-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12.11