icesat2db 2026.4.13__tar.gz

icesat2db-2026.4.13/.codecov.yml

@@ -0,0 +1,38 @@
+codecov:
+  require_ci_to_pass: true
+
+coverage:
+  status:
+    project:
+      default:
+        # Require 1% coverage, i.e., always succeed
+        target: 1%
+        flags:
+          - unittests
+        paths:
+          - "!icesat2db/tests/"
+      unittests:
+        target: 90%
+        flags:
+          - unittests
+        paths:
+          - "!icesat2db/tests/"
+      mypy:
+        target: 20%
+        flags:
+          - mypy
+    patch: false
+    changes: false
+
+comment: false
+
+flags:
+  unittests:
+    paths:
+      - "icesat2db"
+      - "!icesat2db/tests"
+    carryforward: false
+  mypy:
+    paths:
+      - "icesat2db"
+    carryforward: false

icesat2db-2026.4.13/.github/CONTRIBUTING.md

@@ -0,0 +1,2 @@
+Please see the contributing guide on our Docs:
+https://icesat2db.readthedocs.io/en/latest/user/contributing.html#

icesat2db-2026.4.13/.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,59 @@
+name: Bug report
+description: Report a bug. For security vulnerabilities see Report a security vulnerability in the templates.
+title: "BUG: <Please write a comprehensive title after the 'BUG: ' prefix>"
+labels: [00 - Bug]
+
+body:
+- type: markdown
+  attributes:
+    value: >
+      Thank you for taking the time to file a bug report. Before creating a new
+      issue, please make sure to take a few minutes to check the issue tracker
+      for existing issues about the bug.
+    
+- type: textarea
+  attributes: 
+    label: "Describe the issue:"
+  validations:
+    required: true
+
+- type: textarea
+  attributes:
+    label: "Reproduce the code example:"
+    description: >
+      A short code example that reproduces the problem/missing feature. It
+      should be self-contained, i.e., can be copy-pasted into the Python
+      interpreter or run as-is via `python myproblem.py`.
+    placeholder: |
+      import icesat2db as gdb
+      << your code here >>
+    render: python
+  validations:
+    required: true
+  
+- type: textarea
+  attributes:
+    label: "Error message:"
+    description: >
+      Please include full error message, if any.
+    placeholder: |
+      << Full traceback starting from `Traceback: ...` >>
+    render: shell
+
+- type: textarea
+  attributes:
+    label: "Python and icesat2db Versions:"
+    description: >
+      Output from `import sys, icesat2db; print(icesat2db.__version__); print(sys.version)`.
+  validations:
+    required: true
+
+- type: textarea
+  attributes:
+    label: "Context for the issue:"
+    description: |
+      Please explain how this issue affects your work or why it should be prioritized.
+    placeholder: |
+      << your explanation here >>
+  validations:
+    required: false

icesat2db-2026.4.13/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: ❓ Usage question
+    url: https://github.com/simonbesnard1/icesat2db/discussions
+    about: |
+      Ask questions and discuss with other community members here.
+      If you have a question like "How do I concatenate a list of datasets?" then
+      please include a self-contained reproducible example if possible.

icesat2db-2026.4.13/.github/ISSUE_TEMPLATE/documentation.yml

@@ -0,0 +1,19 @@
+name: Documentation
+description: Report an issue related to the icesat2db documentation.
+title: "DOC: <Please write a comprehensive title after the 'DOC: ' prefix>"
+labels: [04 - Documentation]
+
+body:
+- type: textarea
+  attributes: 
+    label: "Issue with current documentation:"
+    description: >
+      Please make sure to leave a reference to the document/code you're
+      referring to.
+
+- type: textarea
+  attributes:
+    label: "Idea or request for content:"
+    description: >
+      Please describe as clearly as possible what topics you think are missing
+      from the current documentation. 

icesat2db-2026.4.13/.github/ISSUE_TEMPLATE/misc.yml

@@ -0,0 +1,17 @@
+name: 📝 Issue
+description: General issue, that's not a bug report.
+labels: ["needs triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please describe your issue here.
+  - type: textarea
+    id: issue-description
+    attributes:
+      label: What is your issue?
+      description: |
+        Thank you for filing an issue! Please give us further information on how we can help you.
+      placeholder: Please describe your issue.
+    validations:
+      required: true

icesat2db-2026.4.13/.github/ISSUE_TEMPLATE/new-feature.yml

@@ -0,0 +1,35 @@
+name: 💡 Feature Request
+description: Suggest an idea for icesat2db
+labels: [enhancement]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Is your feature request related to a problem?
+      description: |
+        Please do a quick search of existing issues to make sure that this has not been asked before.
+        Please provide a clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Describe the solution you'd like
+      description: |
+        A clear and concise description of what you want to happen.
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Describe alternatives you've considered
+      description: |
+        A clear and concise description of any alternative solutions or features you've considered.
+    validations:
+      required: false
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional context
+      description: |
+        Add any other context about the feature request here.
+    validations:
+      required: false

icesat2db-2026.4.13/.github/ISSUE_TEMPLATE/post-install.yml

@@ -0,0 +1,28 @@
+name: Post-install/importing issue
+description: Report an issue if you have trouble importing or using icesat2db after installation.
+title: "<Please write a comprehensive title here>"
+labels: [32 - Installation]
+
+body:
+- type: textarea
+  attributes:
+    label: "Steps to reproduce:"
+    description: >
+      Please describe the installation method (e.g. building from source,
+      Anaconda, pip), your OS and icesat2db/Python version information.
+  validations:
+    required: true
+
+- type: textarea
+  attributes:
+    label: "Error message:"
+    description: >
+      Please include full error message, if any.
+    placeholder: |
+      << Full traceback starting from `Traceback: ...` >>
+    render: shell
+
+- type: textarea
+  attributes:
+    label: "Additional information:"
+    description: Please add any additional information that could help us diagnose the problem better.

icesat2db-2026.4.13/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,5 @@
+<!-- Feel free to remove check-list items aren't relevant to your change -->
+
+- [ ] Closes #xxxx
+- [ ] Tests added
+- [ ] New functions/methods are listed in `api.rst`

icesat2db-2026.4.13/.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: daily
+    commit-message:
+      prefix: "MAINT"
+    labels:
+      - "03 - Maintenance"

icesat2db-2026.4.13/.github/pr-prefix-labeler.yml

@@ -0,0 +1,16 @@
+"API": "30 - API"
+"BENCH": "28 - Benchmark"
+"BLD": "36 - Build"
+"BUG": "00 - Bug"
+"DEP": "07 - Deprecation"
+"DEV": "16 - Development"
+"DOC": "04 - Documentation"
+"ENH": "01 - Enhancement"
+"MAINT": "03 - Maintenance"
+"MNT": "03 - Maintenance"
+"REL": "14 - Release"
+"REV": "34 - Reversion"
+"STY": "03 - Maintenance"
+"TST": "05 - Testing"
+"TYP": "41 - Static typing"
+"WIP": "25 - WIP"

icesat2db-2026.4.13/.github/release.yml

@@ -0,0 +1,5 @@
+changelog:
+  exclude:
+    authors:
+      - dependabot
+      - pre-commit-ci

icesat2db-2026.4.13/.github/workflows/ci.yaml

@@ -0,0 +1,147 @@
+name: CI
+on:
+  push:
+    branches:
+      - "main"
+  pull_request:
+    branches:
+      - "main"
+  workflow_dispatch: # Allows manual trigger
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  FORCE_COLOR: 3
+
+jobs:
+  detect-ci-trigger:
+    name: Detect CI Trigger
+    runs-on: ubuntu-latest
+    if: |
+      github.repository == 'simonbesnard1/icesat2db'
+      && (github.event_name == 'push' || github.event_name == 'pull_request')
+    outputs:
+      triggered: ${{ steps.detect-trigger.outputs.trigger-found }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 2
+      - uses: xarray-contrib/ci-trigger@v1
+        id: detect-trigger
+        with:
+          keyword: "[skip-ci]"
+
+  test:
+    name: "Ubuntu-latest Python 3.10"
+    runs-on: ubuntu-latest
+    needs: detect-ci-trigger
+    if: needs.detect-ci-trigger.outputs.triggered == 'false'
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Setup micromamba
+        uses: mamba-org/setup-micromamba@v3
+        with:
+          environment-file: ci/requirements/environment.yml
+          environment-name: icesat2db-tests
+          cache-environment: true
+          cache-environment-key: "ubuntu-latest-py3.10-${{ hashFiles('ci/requirements/environment.yml') }}"
+          create-args: >-
+            python=3.10
+
+      - name: Activate Conda & Install icesat2db
+        shell: bash -l {0}
+        run: |
+          micromamba activate icesat2db-tests
+          python -m pip install --no-deps -e .
+
+      - name: Check Installed Packages
+        shell: bash -l {0}
+        run: |
+          micromamba activate icesat2db-tests
+          python -c "import pkg_resources; print([d.project_name for d in pkg_resources.working_set])"
+
+      - name: Verify icesat2db Import
+        shell: bash -l {0}
+        run: |
+          micromamba activate icesat2db-tests
+          python -c "import icesat2db"
+
+      - name: Version info
+        shell: bash -l {0}
+        run: |
+          micromamba activate icesat2db-tests
+          python icesat2db/utils/print_versions.py
+
+      - name: Restore Hypothesis Cache
+        id: cache-hypothesis
+        uses: actions/cache/restore@v5
+        with:
+          path: .hypothesis/
+          key: cache-hypothesis
+          enableCrossOsArchive: true
+
+      - name: Create .netrc
+        run: |
+          echo "machine urs.earthdata.nasa.gov" > ~/.netrc
+          echo "login $EARTHDATA_USERNAME" >> ~/.netrc
+          echo "password $EARTHDATA_PASSWORD" >> ~/.netrc
+          chmod 600 ~/.netrc
+          
+          ls -la $HOME/.netrc
+          echo $HOME
+        env:
+          EARTHDATA_USERNAME: ${{ secrets.EARTHDATA_USERNAME }}
+          EARTHDATA_PASSWORD: ${{ secrets.EARTHDATA_PASSWORD }}
+
+      - name: Run tests
+        shell: bash -l {0}
+        run: |
+          micromamba activate icesat2db-tests
+          python -m pytest -n 4 --timeout 180 \
+          --cov=icesat2db --cov-report=xml --junitxml=pytest.xml
+
+      - name: Save Hypothesis Cache
+        if: always()
+        uses: actions/cache/save@v5
+        with:
+          path: .hypothesis/
+          key: cache-hypothesis
+          enableCrossOsArchive: true
+
+      - name: Upload test results
+        if: always()
+        uses: actions/upload-artifact@v7
+        with:
+          name: Test results for ${{ runner.os }}-${{ matrix.python-version }} ${{ matrix.env }}
+          path: pytest.xml
+
+      - name: Upload code coverage to Codecov
+        uses: codecov/codecov-action@v6.0.0
+        env:
+          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+        with:
+          file: ./coverage.xml
+          flags: unittests
+          env_vars: RUNNER_OS,PYTHON_VERSION
+          name: codecov-umbrella
+          fail_ci_if_error: false
+
+  event_file:
+    name: "Event File"
+    runs-on: ubuntu-latest
+    if: github.repository == 'simonbesnard1/icesat2db'
+    steps:
+      - name: Upload
+        uses: actions/upload-artifact@v7
+        with:
+          name: Event File
+          path: ${{ github.event_path }}
+
+

icesat2db-2026.4.13/.github/workflows/pylint.yaml

@@ -0,0 +1,50 @@
+name: Code Quality
+
+on: [push, pull_request]
+
+jobs:
+  detect-ci-trigger:
+    name: Detect CI Trigger
+    runs-on: ubuntu-latest
+    if: |
+      github.repository == 'simonbesnard1/icesat2db'
+      && (github.event_name == 'push' || github.event_name == 'pull_request')
+    outputs:
+      triggered: ${{ steps.detect-trigger.outputs.trigger-found }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 2
+      - uses: xarray-contrib/ci-trigger@v1
+        id: detect-trigger
+        with:
+          keyword: "[skip-ci]"
+
+  lint:
+    name: "Linting with Pylint, Black, and Isort"
+    runs-on: ubuntu-latest
+    needs: detect-ci-trigger
+    if: needs.detect-ci-trigger.outputs.triggered == 'false'
+    strategy:
+      matrix:
+        python-version: ["3.12"]
+        
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install pylint black
+          python -m pip install --no-deps -e .
+
+      - name: Run Black (Check Code Formatting)
+        run: black --check --diff .
+
+      - name: Run Pylint (Check Code Quality)
+        run: pylint icesat2db/ --disable=C0301 --exit-zero

icesat2db-2026.4.13/.github/workflows/pypi-release.yaml

@@ -0,0 +1,115 @@
+name: Build and Upload icesat2DB to PyPI
+on:
+  release:
+    types:
+      - published
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build-artifacts:
+    runs-on: ubuntu-latest
+    if: github.repository == 'simonbesnard1/icesat2db'
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v6
+        name: Install Python
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build twine
+
+      - name: Build tarball and wheels
+        run: |
+          git clean -xdf
+          git restore -SW .
+          python -m build
+
+      - name: Check built artifacts
+        run: |
+          python -m twine check --strict dist/*
+          pwd
+          if [ -f dist/icesat2db-0.0.0.tar.gz ]; then
+            echo "❌ INVALID VERSION NUMBER"
+            exit 1
+          else
+            echo "✅ Looks good"
+          fi
+      - uses: actions/upload-artifact@v7
+        with:
+          name: releases
+          path: dist
+
+  test-built-dist:
+    needs: build-artifacts
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/setup-python@v6
+        name: Install Python
+        with:
+          python-version: "3.12"
+      - uses: actions/download-artifact@v8
+        with:
+          name: releases
+          path: dist
+      - name: List contents of built dist
+        run: |
+          ls -ltrh
+          ls -ltrh dist
+
+      - name: Verify the built dist/wheel is valid
+        if: github.event_name == 'push'
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install dist/icesat2db*.whl
+          python -m icesat2db.utils.print_versions
+
+  upload-to-test-pypi:
+    needs: test-built-dist
+    if: github.event_name == 'push'
+    runs-on: ubuntu-latest
+
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/icesat2db
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: releases
+          path: dist
+      - name: Publish package to TestPyPI
+        if: github.event_name == 'push'
+        uses: pypa/gh-action-pypi-publish@v1.14.0
+        with:
+          repository_url: https://test.pypi.org/legacy/
+          verbose: true
+
+  upload-to-pypi:
+    needs: test-built-dist
+    if: github.event_name == 'release'
+    runs-on: ubuntu-latest
+
+    environment:
+      name: pypi
+      url: https://pypi.org/p/icesat2db
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: releases
+          path: dist
+      - name: Publish package to PyPI
+        uses: pypa/gh-action-pypi-publish@v1.14.0
+        with:
+          verbose: true

icesat2db-2026.4.13/.gitignore

@@ -0,0 +1,122 @@
+output/
+data/
+
+# Byte-compiled / optimized / DLL files
+*.py[cod]
+__pycache__
+.env
+.venv
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+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/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+doc/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+LICENSE
+
+# misc
+/config_files/
+/testing
+.idea
+/scripts/
+
+# Sphinx doc
+_build/
+
+# Ignore generated PDFs
+paper/paper.pdf