maxminddb-polars 0.1.0__tar.gz

maxminddb_polars-0.1.0/.cargo/audit.toml

@@ -0,0 +1,13 @@
+[advisories]
+# The Polars 1.43 plugin ABI requires pyo3-polars 0.27 and PyO3 0.28. The
+# affected PyList/PyTuple iterator nth methods and PyCFunction closure API are
+# not called by this project. Bincode is a required Polars 0.54 transitive
+# dependency. Revisit all exceptions with the Polars 0.55 / pyo3-polars 0.28
+# compatibility update, or by 2026-09-30.
+ignore = [
+  "RUSTSEC-2025-0141",
+  "RUSTSEC-2026-0176",
+  "RUSTSEC-2026-0177",
+  "RUSTSEC-2026-0194",
+  "RUSTSEC-2026-0195",
+]

maxminddb_polars-0.1.0/.githooks/pre-commit

@@ -0,0 +1,7 @@
+#!/bin/bash
+
+set -euo pipefail
+
+echo "Running Precious on staged files..."
+precious lint --staged
+

maxminddb_polars-0.1.0/.github/ISSUE_TEMPLATE/bug.yml

@@ -0,0 +1,44 @@
+name: Bug report
+description: Report incorrect behavior, a crash, or a compatibility problem
+title: ""
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: >-
+        Do not report security vulnerabilities here. Use private vulnerability
+        reporting as described in SECURITY.md.
+  - type: input
+    id: version
+    attributes:
+      label: maxminddb-polars version
+      placeholder: 0.1.0a1
+    validations:
+      required: true
+  - type: input
+    id: environment
+    attributes:
+      label: Environment
+      description: Include Python, Polars, operating system, and architecture.
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Minimal reproduction
+      description: Use a public test database or describe the schema without sharing licensed data.
+      render: python
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior
+    validations:
+      required: true

maxminddb_polars-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security report
+    url: https://github.com/oschwald/maxminddb-polars/security/advisories/new
+    about: Report suspected vulnerabilities privately.

maxminddb_polars-0.1.0/.github/ISSUE_TEMPLATE/feature.yml

@@ -0,0 +1,26 @@
+name: Feature request
+description: Propose a new lookup capability, schema, or integration
+title: ""
+labels: [enhancement]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What use case cannot be handled cleanly today?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed API or behavior
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+  - type: textarea
+    id: performance
+    attributes:
+      label: Performance or compatibility considerations

maxminddb_polars-0.1.0/.github/dependabot.yml

@@ -0,0 +1,56 @@
+version: 2
+updates:
+  - package-ecosystem: cargo
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+      time: "14:00"
+    open-pull-requests-limit: 5
+    cooldown:
+      default-days: 4
+    groups:
+      polars-rust:
+        patterns:
+          - polars
+          - pyo3-polars
+
+  - package-ecosystem: pip
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+      time: "14:00"
+    open-pull-requests-limit: 5
+    cooldown:
+      default-days: 4
+
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+      time: "14:00"
+    open-pull-requests-limit: 5
+    cooldown:
+      default-days: 4
+
+  - package-ecosystem: npm
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+      time: "14:00"
+    open-pull-requests-limit: 5
+    cooldown:
+      default-days: 4
+
+  - package-ecosystem: gitsubmodule
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+      time: "14:00"
+    open-pull-requests-limit: 2
+    cooldown:
+      default-days: 4

maxminddb_polars-0.1.0/.github/pull_request_template.md

@@ -0,0 +1,13 @@
+## Summary
+
+<!-- Explain the problem and the chosen solution. -->
+
+## Validation
+
+<!-- List tests, compatibility checks, and benchmarks that actually ran. -->
+
+- [ ] `scripts/check`
+- [ ] User-visible changes are documented in `CHANGELOG.md`
+- [ ] Public API changes include docs and type hints
+- [ ] Performance-sensitive changes include a same-machine comparison
+- [ ] No licensed or locally installed MMDB database is included

maxminddb_polars-0.1.0/.github/workflows/artifacts.yml

@@ -0,0 +1,297 @@
+name: Artifacts
+
+on:
+  workflow_call:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths:
+      - Cargo.lock
+      - Cargo.toml
+      - LICENSE
+      - maxminddb_polars/**
+      - pyproject.toml
+      - scripts/inspect_artifacts.py
+      - src/**
+      - uv.lock
+      - .github/workflows/artifacts.yml
+  pull_request:
+    paths:
+      - Cargo.lock
+      - Cargo.toml
+      - LICENSE
+      - maxminddb_polars/**
+      - pyproject.toml
+      - scripts/inspect_artifacts.py
+      - src/**
+      - uv.lock
+      - .github/workflows/artifacts.yml
+
+permissions:
+  contents: read
+
+concurrency:
+  group: artifacts-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: ${{ github.event_name != 'release' }}
+
+jobs:
+  wheels:
+    name: Wheel (${{ matrix.platform }})
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 75
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - platform: manylinux-x86_64
+            os: ubuntu-latest
+            target: x86_64
+            manylinux: auto
+            smoke: true
+          - platform: manylinux-aarch64
+            os: ubuntu-latest
+            target: aarch64
+            manylinux: auto
+            smoke: false
+          - platform: musllinux-x86_64
+            os: ubuntu-latest
+            target: x86_64
+            manylinux: musllinux_1_2
+            smoke: false
+          - platform: musllinux-aarch64
+            os: ubuntu-latest
+            target: aarch64
+            manylinux: musllinux_1_2
+            smoke: false
+          - platform: macos-x86_64
+            os: macos-15-intel
+            target: x86_64
+            manylinux: auto
+            smoke: true
+          - platform: macos-aarch64
+            os: macos-latest
+            target: aarch64
+            manylinux: auto
+            smoke: true
+          - platform: windows-x86_64
+            os: windows-latest
+            target: x64
+            manylinux: auto
+            smoke: true
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+          submodules: recursive
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.13"
+      - uses: docker/setup-qemu-action@06116385d9baf250c9f4dcb4858b16962ea869c3 # v4.1.0
+        if: runner.os == 'Linux' && matrix.target == 'aarch64'
+        with:
+          platforms: arm64
+      - uses: PyO3/maturin-action@e83996d129638aa358a18fbd1dfb82f0b0fb5d3b # v1.51.0
+        with:
+          target: ${{ matrix.target }}
+          manylinux: ${{ matrix.manylinux }}
+          args: --release --locked --out dist
+      - name: Smoke-test native wheel
+        if: matrix.smoke
+        shell: bash
+        run: |
+          python -m pip install "polars>=1.43.2,<1.44"
+          python - <<'PY'
+          import glob
+          import subprocess
+          import sys
+
+          subprocess.check_call(
+              [
+                  sys.executable,
+                  "-m",
+                  "pip",
+                  "install",
+                  "--no-index",
+                  "--no-deps",
+                  *glob.glob("dist/*.whl"),
+              ]
+          )
+          PY
+          test_directory=$(mktemp -d)
+          cd "$test_directory"
+          python - <<'PY'
+          import importlib.metadata
+          import os
+          from pathlib import Path
+
+          import polars as pl
+
+          from maxminddb_polars import _maxminddb_polars
+          from maxminddb_polars import lookup_path
+
+          database = Path(os.environ["GITHUB_WORKSPACE"]) / "tests/data/test-data/GeoIP2-City-Test.mmdb"
+          result = pl.DataFrame({"ip": ["89.160.20.128"]}).lazy().select(
+              lookup_path("ip", database, ["country", "iso_code"]).alias("country")
+          ).collect()
+          assert result.to_dict(as_series=False) == {"country": ["SE"]}
+          assert _maxminddb_polars.__version__ == importlib.metadata.version("maxminddb-polars")
+          PY
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: wheel-${{ matrix.platform }}
+          path: dist/*.whl
+          if-no-files-found: error
+          retention-days: 30
+
+  abi3:
+    name: abi3 / Python ${{ matrix.python }} / Polars ${{ matrix.polars }}
+    needs: wheels
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - python: "3.10"
+            polars: "1.43.2"
+          - python: "3.14"
+            polars: "1.43.2"
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+          submodules: recursive
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: ${{ matrix.python }}
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: wheel-manylinux-x86_64
+          path: dist
+      - name: Install exact wheel
+        env:
+          POLARS_VERSION: ${{ matrix.polars }}
+        shell: bash
+        run: |
+          python -m pip install "polars==$POLARS_VERSION"
+          python -m pip install --no-index --no-deps dist/*.whl
+      - name: Smoke-test abi3 wheel
+        shell: bash
+        run: |
+          test_directory=$(mktemp -d)
+          cd "$test_directory"
+          python - <<'PY'
+          import importlib.metadata
+          import os
+          from pathlib import Path
+
+          import polars as pl
+
+          from maxminddb_polars import _maxminddb_polars
+          from maxminddb_polars import lookup
+
+          database = Path(os.environ["GITHUB_WORKSPACE"]) / "tests/data/test-data/GeoLite2-ASN-Test.mmdb"
+          result = pl.DataFrame({"ip": ["1.0.0.0"]}).lazy().select(
+              lookup("ip", database).alias("record")
+          ).collect(engine="streaming")
+          assert result["record"].struct.field("autonomous_system_number").item() == 15169
+          assert _maxminddb_polars.__version__ == importlib.metadata.version("maxminddb-polars")
+          PY
+
+  sdist:
+    name: Source distribution
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+          submodules: recursive
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.13"
+      - uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+      - run: uv sync --all-extras --locked --no-install-project
+      - run: uv run --no-sync maturin sdist --out dist
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+          if-no-files-found: error
+          retention-days: 30
+
+  validate:
+    name: Validate distributions
+    needs: [wheels, abi3, sdist]
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+          submodules: recursive
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.13"
+      - uses: dtolnay/rust-toolchain@6c977a6ca4077a0ceb28ffbe03f59d46e9ac8772 # master
+        with:
+          toolchain: stable
+      - uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          pattern: wheel-*
+          path: dist
+          merge-multiple: true
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: sdist
+          path: dist
+      - run: python scripts/inspect_artifacts.py dist/*
+      - name: Verify locked source state
+        run: |
+          cargo metadata --locked --format-version 1 --no-deps >/dev/null
+          uv lock --check
+          test "$(git -C tests/data rev-parse HEAD)" = "e1120013c4b5cbc830b958b2b7e73fba444d316d"
+          git diff --exit-code
+      - run: python -m pip install twine==6.2.0
+      - run: python -m twine check --strict dist/*
+      - name: Build and smoke-test from sdist
+        shell: bash
+        run: |
+          python -m pip install "polars>=1.43.2,<1.44"
+          python -m pip wheel --no-deps --wheel-dir sdist-wheel dist/*.tar.gz
+          python scripts/inspect_artifacts.py sdist-wheel/*.whl
+          python -m pip install --no-index --no-deps sdist-wheel/*.whl
+          test_directory=$(mktemp -d)
+          cd "$test_directory"
+          python - <<'PY'
+          import importlib.metadata
+          import os
+          from pathlib import Path
+
+          import polars as pl
+
+          from maxminddb_polars import _maxminddb_polars
+          from maxminddb_polars import lookup_path
+
+          database = Path(os.environ["GITHUB_WORKSPACE"]) / "tests/data/test-data/GeoIP2-City-Test.mmdb"
+          result = pl.DataFrame({"ip": ["89.160.20.128"]}).select(
+              lookup_path("ip", database, ["country", "iso_code"]).alias("country")
+          )
+          assert result.to_dict(as_series=False) == {"country": ["SE"]}
+          assert _maxminddb_polars.__version__ == importlib.metadata.version("maxminddb-polars")
+          PY
+      - name: Write checksums
+        run: sha256sum dist/* >SHA256SUMS
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: publishable-distributions
+          path: dist/*
+          if-no-files-found: error
+          retention-days: 30
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: distribution-checksums
+          path: SHA256SUMS
+          if-no-files-found: error
+          retention-days: 30

maxminddb_polars-0.1.0/.github/workflows/audit.yml

@@ -0,0 +1,64 @@
+name: Dependency audit
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    paths:
+      - .cargo/audit.toml
+      - Cargo.lock
+      - Cargo.toml
+      - fuzz/Cargo.lock
+      - pyproject.toml
+      - uv.lock
+      - .github/workflows/audit.yml
+  schedule:
+    - cron: "43 14 * * *"
+
+permissions:
+  contents: read
+
+concurrency:
+  group: audit-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  rust:
+    name: Cargo audit
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+      - uses: dtolnay/rust-toolchain@6c977a6ca4077a0ceb28ffbe03f59d46e9ac8772 # master
+        with:
+          toolchain: stable
+      - run: cargo install cargo-audit --version 0.22.2 --locked
+      - run: cargo audit --deny warnings
+      - run: cargo audit --deny warnings --file fuzz/Cargo.lock
+
+  python:
+    name: Python audit
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+      - run: uv export --locked --no-dev --no-emit-project --format requirements-txt --output-file requirements.txt
+      - run: uvx pip-audit==2.10.1 --strict --requirement requirements.txt
+
+  dependency-review:
+    name: Dependency review
+    if: github.event_name == 'pull_request'
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+      - uses: actions/dependency-review-action@3c4e3dcb1aa7874d2c16be7d79418e9b7efd6261 # v4.8.2

maxminddb_polars-0.1.0/.github/workflows/benchmark.yml

@@ -0,0 +1,57 @@
+name: Benchmark
+
+on:
+  workflow_dispatch:
+    inputs:
+      rows:
+        description: Rows per sample
+        required: true
+        default: "500000"
+      repeats:
+        description: Measured samples
+        required: true
+        default: "7"
+
+permissions:
+  contents: read
+
+concurrency:
+  group: benchmark-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lookups:
+    name: Lookup benchmark
+    runs-on: ubuntu-latest
+    timeout-minutes: 45
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+          submodules: recursive
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.13"
+      - uses: dtolnay/rust-toolchain@6c977a6ca4077a0ceb28ffbe03f59d46e9ac8772 # master
+        with:
+          toolchain: stable
+      - uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+      - run: uv sync --all-extras --locked --no-install-project
+      - run: uv run --no-sync maturin develop
+      - name: Run benchmark
+        env:
+          BENCHMARK_REPEATS: ${{ inputs.repeats }}
+          BENCHMARK_ROWS: ${{ inputs.rows }}
+        run: >-
+          uv run --no-sync python benchmarks/lookups.py
+          --rows "$BENCHMARK_ROWS"
+          --repeats "$BENCHMARK_REPEATS"
+          --json benchmark-results.json
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        if: always()
+        with:
+          name: benchmark-results
+          path: benchmark-results.json
+          if-no-files-found: error
+          retention-days: 30

maxminddb_polars-0.1.0/.github/workflows/codeql.yml

@@ -0,0 +1,42 @@
+name: CodeQL
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  schedule:
+    - cron: "59 18 * * 0"
+
+permissions: {}
+
+concurrency:
+  group: codeql-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  analyze:
+    name: Analyze Rust and Python
+    runs-on: ubuntu-latest
+    timeout-minutes: 60
+    permissions:
+      # Upload CodeQL results to the repository's code-scanning service.
+      security-events: write
+      contents: read
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+          submodules: recursive
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.13"
+      - uses: dtolnay/rust-toolchain@6c977a6ca4077a0ceb28ffbe03f59d46e9ac8772 # master
+        with:
+          toolchain: stable
+      - uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+      - uses: github/codeql-action/init@7211b7c8077ea37d8641b6271f6a365a22a5fbfa # v4.36.0
+        with:
+          languages: python, rust
+      - run: uv sync --all-extras --locked --no-install-project
+      - run: uv run --no-sync maturin build --release --locked
+      - uses: github/codeql-action/analyze@7211b7c8077ea37d8641b6271f6a365a22a5fbfa # v4.36.0

maxminddb_polars-0.1.0/.github/workflows/compatibility.yml

@@ -0,0 +1,61 @@
+name: Compatibility
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: "31 16 1 * *"
+  pull_request:
+    paths:
+      - Cargo.lock
+      - Cargo.toml
+      - pyproject.toml
+      - uv.lock
+      - .github/workflows/compatibility.yml
+
+permissions:
+  contents: read
+
+concurrency:
+  group: compatibility-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  supported:
+    name: Python ${{ matrix.python }} / Polars ${{ matrix.polars }}
+    runs-on: ubuntu-latest
+    timeout-minutes: 45
+    env:
+      POLARS_VERSION: ${{ matrix.polars }}
+      PYTHON_VERSION: ${{ matrix.python }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - python: "3.10"
+            polars: "1.43.2"
+          - python: "3.11"
+            polars: "1.43.2"
+          - python: "3.12"
+            polars: "1.43.2"
+          - python: "3.13"
+            polars: "1.43.2"
+          - python: "3.14"
+            polars: "1.43.2"
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+          submodules: recursive
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: ${{ matrix.python }}
+      - uses: dtolnay/rust-toolchain@6c977a6ca4077a0ceb28ffbe03f59d46e9ac8772 # master
+        with:
+          toolchain: stable
+      - uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+      - run: >-
+          uv sync --python "$PYTHON_VERSION" --all-extras --locked
+          --no-install-project
+      - run: uv pip install --python .venv/bin/python "polars==$POLARS_VERSION"
+      - run: uv run --no-sync maturin develop
+      - run: uv run --no-sync pytest