navtk 2.1.0.post6.dev0__tar.gz

navtk-2.1.0.post6.dev0/.clang-format

@@ -0,0 +1,19 @@
+Language: Cpp
+BasedOnStyle: Google
+BreakBeforeBraces: Custom
+IndentWidth: 4
+UseTab: ForIndentation
+TabWidth: 4
+ColumnLimit: 100
+IndentCaseLabels: false
+MaxEmptyLinesToKeep: 3
+AccessModifierOffset: -4
+KeepEmptyLinesAtTheStartOfBlocks: true
+BinPackArguments: false
+BinPackParameters: false
+AllowShortFunctionsOnASingleLine: All
+AllowShortIfStatementsOnASingleLine: true
+AlignConsecutiveAssignments: true
+AlignTrailingComments: true
+IndentPPDirectives: AfterHash
+IncludeBlocks: Preserve

navtk-2.1.0.post6.dev0/.editorconfig

@@ -0,0 +1,29 @@
+# https://editorconfig.org
+
+root = true
+
+[*.{h,c}{,pp}]
+end_of_line = lf
+insert_final_newline = true
+indent_style = tab
+trim_trailing_whitespace = true
+
+[*.py]
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+trim_trailing_whitespace = true
+
+[meson.build]
+end_of_line = lf
+indent_style = space
+indent_size = 4
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.yml]
+end_of_line = lf
+indent_size = 2
+indent_style = space
+trim_trailing_whitespace = true
+insert_final_newline = true

navtk-2.1.0.post6.dev0/.flake8

@@ -0,0 +1,8 @@
+[flake8]
+ignore =
+    # Ignores line breaks around operators. This helps with formatting long lines.
+    W503, W504
+    # Ignores space before ":", which conflicts with black.
+    E203
+    # Ignores error from math-variables, like "I".
+    E741

navtk-2.1.0.post6.dev0/.github/actions/setup/action.yml

@@ -0,0 +1,72 @@
+name: 'Set up Docker'
+description: 'Pulls docker image from registry, or builds if not available'
+runs:
+  using: "composite"
+  steps:
+    - name: Log in to GitHub Container Registry
+      uses: docker/login-action@v3
+      with:
+        registry: ghcr.io
+        username: ${{ github.actor }}
+        password: ${{ github.token }}
+
+    - name: Compute Dockerfile hash
+      id: dockerfile-hash
+      shell: bash
+      run: |
+        HASH=$(sha256sum docker/${{ inputs.dockerfile }} | cut -d' ' -f1 | cut -c1-12)
+        echo "hash=$HASH" >> $GITHUB_OUTPUT
+        echo "Dockerfile hash: $HASH"
+
+    - name: Convert owner to lowercase
+      id: repo
+      shell: bash
+      run: |
+        echo "owner=$(echo '${{ github.repository_owner }}' | tr '[:upper:]' '[:lower:]')" >> $GITHUB_OUTPUT
+
+    - name: Try to pull Docker image from registry
+      id: pull
+      shell: bash
+      continue-on-error: true
+      run: docker pull ghcr.io/${{ steps.repo.outputs.owner }}/navtoolkit:${{ inputs.tag }}-${{ steps.dockerfile-hash.outputs.hash }}
+
+    - name: Set up Docker Buildx
+      if: steps.pull.outcome == 'failure'
+      uses: docker/setup-buildx-action@v3
+
+    - name: Build and Push Docker Image
+      if: steps.pull.outcome == 'failure'
+      id: docker_build
+      uses: docker/build-push-action@v5
+      with:
+          context: docker/
+          file: docker/${{ inputs.dockerfile }}
+          push: true
+          tags: ghcr.io/${{ steps.repo.outputs.owner }}/navtoolkit:${{ inputs.tag }}-${{ steps.dockerfile-hash.outputs.hash }}
+      env:
+        SOURCE_DATE_EPOCH: 0
+
+    - name: Create iidfile
+      shell: bash
+      run: |
+          set -xe
+          mkdir -p docker/build/iidfiles/
+          echo ghcr.io/${{ steps.repo.outputs.owner }}/navtoolkit:${{ inputs.tag }}-${{ steps.dockerfile-hash.outputs.hash }} > docker/build/iidfiles/${{ inputs.platform }}
+
+    - name: Ensure ccache directory exists
+      shell: bash
+      run: mkdir -p ~/.ccache
+
+inputs:
+  platform:
+    description: 'Docker image name'
+    required: false
+    default: ubuntu-noble
+  dockerfile:
+    description: 'Dockerfile filename'
+    required: false
+    default: Dockerfile.ubuntu
+  tag:
+    description: 'Docker image tag'
+    required: false
+    default: ubuntu-noble

navtk-2.1.0.post6.dev0/.github/workflows/build_wheels.yml

@@ -0,0 +1,66 @@
+name: Build wheels
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  source:
+    name: Build source distribution
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install dependencies
+        run: sudo apt update && sudo apt install libopenblas-dev -y
+
+      - name: Build sdist
+        run: pipx run build --sdist
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: cibw-sdist
+          path: dist/*.tar.gz
+
+  unix:
+    name: ${{ matrix.os }} | ${{ matrix.arch }} | ${{ matrix.python }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-24.04, ubuntu-24.04-arm, macos-14]
+        arch: [auto, armv7l]
+        python: [cp310-*, cp311-*, cp312-*, cp313-*, cp314-*]
+        include:
+          - os: macos-14
+            macos_deployment_target: 14
+        exclude:
+          - os: ubuntu-24.04
+            arch: armv7l
+          - os: macos-14
+            arch: armv7l
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up QEMU
+        if: runner.os == 'Linux'
+        uses: docker/setup-qemu-action@v3
+        with:
+          platforms: all
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v3.2.1
+        env:
+          MACOSX_DEPLOYMENT_TARGET: ${{ matrix.macos_deployment_target }}
+          CIBW_ARCHS: ${{ matrix.arch }}
+          CIBW_BUILD: ${{ matrix.python }}
+          CIBW_SKIP: "*-musllinux*"
+          CIBW_TEST_REQUIRES: pytest
+          # TODO: why does this test fail with pytest but not with unittest?
+          CIBW_TEST_COMMAND: "pytest {project} --ignore={project}/test/python/error_mode_test.py"
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: cibw-wheels-${{ matrix.os }}-${{ strategy.job-index }}
+          path: ./wheelhouse/*.whl

navtk-2.1.0.post6.dev0/.github/workflows/check.yml

@@ -0,0 +1,105 @@
+name: Check
+
+on: [push, pull_request]
+
+jobs:
+    format:
+        runs-on: ubuntu-24.04
+        steps:
+        - uses: actions/checkout@v4
+
+        - name: Set up
+          uses: ./.github/actions/setup
+
+        - name: Run formatters
+          run: |
+              set -xe
+              docker/docker_interface.py format
+              git diff --exit-code
+
+    flake8:
+        runs-on: ubuntu-24.04
+        steps:
+        - uses: actions/checkout@v4
+
+        - name: Set up
+          uses: ./.github/actions/setup
+
+        - name: Run flake8
+          run: docker/docker_interface.py flake8
+
+    copyright-year:
+        runs-on: ubuntu-24.04
+        steps:
+        - uses: actions/checkout@v4
+
+        - name: Check copyright year
+          run: (! grep --color -i "copyright.*$(( $(date +%Y) - 1 ))" $(git ls-files))
+
+    documentation:
+        runs-on: ubuntu-24.04
+        env:
+          BUILD_DIR: docker/build/ubuntu_noble
+        steps:
+        - uses: actions/checkout@v4
+
+        - name: Set up
+          uses: ./.github/actions/setup
+
+        - name: Build documentation
+          run: |
+            set -xe;
+            docker/docker_interface.py check_documentation
+            docker/docker_interface.py setup
+            docker/docker_interface.py debug ubuntu-noble "ninja -C $BUILD_DIR docs"
+            docker/docker_interface.py debug ubuntu-noble "linkchecker -r 3 $BUILD_DIR/docs/index.html"
+
+        - name: Archive Docs
+          uses: actions/upload-artifact@v4
+          with:
+            name: archived-docs
+            path: ${{ env.BUILD_DIR }}/docs
+
+    external-link:
+        runs-on: ubuntu-24.04
+        needs: documentation
+        env:
+          BUILD_DIR: docker/build/ubuntu_noble
+        steps:
+        - uses: actions/checkout@v4
+
+        - name: Set up
+          uses: ./.github/actions/setup
+
+        - name: Download documentation artifacts
+          uses: actions/download-artifact@v4
+          with:
+            name: archived-docs
+            path: ${{ env.BUILD_DIR }}/docs
+
+        - name: Check external links
+          run: |
+            set -xe;
+            docker/docker_interface.py debug ubuntu-noble "\
+            linkchecker $BUILD_DIR/docs/index.html --check-extern -r 3 \
+                --ignore-url=RobotoSlab \
+                --ignore-url=py-modindex \
+                --ignore-url=sphinx-doc \
+                --ignore-url=http://schema.org/Article \
+                --ignore-url=https://about.readthedocs.com?ref=readthedocs.org \
+                --ignore-url=https://readthedocs.org"
+
+    naming-rules:
+        runs-on: ubuntu-24.04
+        steps:
+        - uses: actions/checkout@v4
+
+        - name: Set up
+          uses: ./.github/actions/setup
+
+        - name: Check Naming
+          run: |
+            set -xe;
+            docker/docker_interface.py setup ubuntu-noble
+            docker/docker_interface.py debug ubuntu-noble "meson subprojects download"
+            docker/docker_interface.py debug ubuntu-noble "./util/check_naming.py"

navtk-2.1.0.post6.dev0/.github/workflows/deploy_docs.yml

@@ -0,0 +1,37 @@
+name: deploy_docs
+
+on:
+  push:
+    branches: [ "main" ]
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+  packages: write
+
+jobs:
+  docs:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-24.04
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up
+      uses: ./.github/actions/setup
+
+    - name: Build documentation
+      run: |
+        set -xe;
+        docker/docker_interface.py setup
+        docker/docker_interface.py debug ubuntu-noble "ninja -C docker/build/ubuntu_noble docs"
+
+    - name: Upload artifact
+      uses: actions/upload-pages-artifact@v3
+      with:
+        path: docker/build/ubuntu_noble/docs
+    - name: Deploy to GitHub Pages
+      id: deployment
+      uses: actions/deploy-pages@v4

navtk-2.1.0.post6.dev0/.github/workflows/test.yml

@@ -0,0 +1,141 @@
+name: Test
+
+on: [push, pull_request]
+
+jobs:
+    linux:
+      name: ${{ matrix.platform }}
+      runs-on: ubuntu-24.04
+      strategy:
+        fail-fast: false
+        matrix:
+          platform: [ubuntu-noble, ubuntu-noble-debug, cross-armv7, fedora-gcc, fedora-clang, ubuntu-jammy]
+          include:
+            - platform: ubuntu-noble
+              dockerfile: Dockerfile.ubuntu
+              tag: ubuntu-noble
+            - platform: ubuntu-noble-debug
+              dockerfile: Dockerfile.ubuntu
+              tag: ubuntu-noble
+            - platform: ubuntu-jammy
+              dockerfile: Dockerfile.ubuntu
+              tag: ubuntu-jammy
+            - platform: cross-armv7
+              dockerfile: Dockerfile.ubuntu-cross
+              tag: ubuntu-cross
+            - platform: fedora-gcc
+              dockerfile: Dockerfile.fedora
+              tag: fedora
+            - platform: fedora-clang
+              dockerfile: Dockerfile.fedora
+              tag: fedora
+
+      steps:
+          - uses: actions/checkout@v4
+
+          # GitHub runners don't come with enough free space to build NavToolkit. Delete some stuff
+          # we don't need.
+          - name: Free up space
+            run: sudo rm -rf /usr/share/dotnet /usr/local/lib/android /opt/ghc /opt/hostedtoolcache/CodeQL
+
+          - name: Set up
+            uses: ./.github/actions/setup
+            with:
+              platform: ${{ matrix.platform }}
+              dockerfile: ${{ matrix.dockerfile }}
+              tag: ${{ matrix.tag }}
+
+          - name: Restore ccache cache before building
+            uses: actions/cache/restore@v4
+            with:
+              path: ~/.ccache
+              key: ccache--${{ matrix.platform }}--${{ github.run_id }}
+              restore-keys: ccache--${{ matrix.platform }}--
+
+          - name: Build
+            run: docker/docker_interface.py build ${{ matrix.platform }}
+
+          - name: Save ccache cache
+            uses: actions/cache/save@v4
+            with:
+              path: ~/.ccache
+              key: ccache--${{ matrix.platform }}--${{ github.run_id }}
+
+          - name: Test
+            run: docker/docker_interface.py test ${{ matrix.platform }}
+
+    arm64:
+      name: cross-arm64
+      runs-on: ubuntu-24.04-arm
+      steps:
+          - uses: actions/checkout@v4
+
+          # GitHub runners don't come with enough free space to build NavToolkit. Delete some stuff
+          # we don't need.
+          - name: Free up space
+            run: sudo rm -rf /usr/share/dotnet /usr/local/lib/android /opt/ghc /opt/hostedtoolcache/CodeQL
+
+          - name: Set up
+            uses: ./.github/actions/setup
+            with:
+              platform: ubuntu-noble
+              dockerfile: Dockerfile.ubuntu
+              tag: ubuntu-noble-arm64
+
+          - name: Restore ccache cache before building
+            uses: actions/cache/restore@v4
+            with:
+              path: ~/.ccache
+              key: ccache--arm64-ubuntu-noble--${{ github.run_id }}
+              restore-keys: ccache--arm64-ubuntu-noble--
+
+          - name: Build
+            run: docker/docker_interface.py build ubuntu-noble
+
+          - name: Save ccache cache
+            uses: actions/cache/save@v4
+            with:
+              path: ~/.ccache
+              key: ccache--arm64-ubuntu-noble--${{ github.run_id }}
+
+          - name: Test
+            run: docker/docker_interface.py test ubuntu-noble
+
+    macos:
+        runs-on: macos-15
+        steps:
+        - uses: actions/checkout@v4
+
+        - name: Install dependencies
+          run: brew install ccache gdal
+
+        - name: Set up ccache
+          run: |
+            set -xe
+            mkdir -p /Users/runner/.ccache
+            ccache --set-config=cache_dir=/Users/runner/.ccache
+
+        - name: Restore ccache cache before building
+          uses: actions/cache/restore@v4
+          with:
+            path: /Users/runner/.ccache
+            key: ccache--macos--${{ github.run_id }}
+            restore-keys: ccache--macos--
+
+        - name: Set up and build
+          run: |
+            set -xe
+            python3 -m venv .venv --system-site-packages
+            source .venv/bin/activate
+            pip install -r docker/requirements.txt
+            meson setup build -Db_lundef=false --warnlevel 3 -Dwerror=true -Dbuildtype=release
+            ninja -C build
+
+        - name: Save ccache cache
+          uses: actions/cache/save@v4
+          with:
+            path: /Users/runner/.ccache
+            key: ccache--macos--${{ github.run_id }}
+
+        - name: Test
+          run: ninja -C build test

navtk-2.1.0.post6.dev0/.gitignore

@@ -0,0 +1,36 @@
+# NOTE: Avoid using the ** syntax in this file where at all possible. Some
+# tools which parse your .gitignore file (such as `ag`) don't support it.
+
+# OSX-specific things
+.DS_Store
+
+# Windows-specific things
+Thumbs.db
+
+# Ignore temporary files
+*~
+*.autosave
+*.swp
+
+# Ignore meson artifacts
+/build*/
+/subprojects/*/
+!subprojects/packagefiles
+docker/build/
+
+# Symbolic link to build directory
+build
+
+# Ignore documentation generation files
+docs/api-exhale
+docs/doxygen_output
+
+# Local Python virtual environment
+.venv/
+
+# Miscellaneous
+.vscode
+__pycache__
+.idea
+util/asan_tests/bin
+.cache

navtk-2.1.0.post6.dev0/.lldbinit

@@ -0,0 +1,2 @@
+command script import extra/lldbinit.py
+settings set target.load-cwd-lldbinit true