roto-api-native 0.2.1__tar.gz

roto_api_native-0.2.1/.github/workflows/pkg.yml

@@ -0,0 +1,84 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  checks:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Install tooling
+        run: python -m pip install --upgrade pip maturin pytest
+
+      - name: Rust check
+        run: cargo check
+
+      - name: Python tests
+        run: pytest
+
+      - name: Build wheel
+        run: maturin build --release --out dist
+
+      - name: Smoke test wheel
+        run: |
+          python -m pip install dist/*.whl
+          python -c "import roto_api; print(roto_api.__version__)"
+
+  wheels:
+    name: ${{ matrix.os }} / ${{ matrix.target }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: x86_64-unknown-linux-gnu
+          - os: windows-latest
+            target: x86_64-pc-windows-msvc
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build wheel
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --out dist
+          manylinux: auto
+          sccache: true
+
+      - name: Upload wheel
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.target }}
+          path: dist/*.whl
+
+  sdist:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+
+      - name: Upload sdist
+        uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/*.tar.gz

roto_api_native-0.2.1/.github/workflows/publish.yml

@@ -0,0 +1,75 @@
+name: Publish To PyPI
+
+on:
+  push:
+    tags:
+      - v*
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: ${{ matrix.os }} / ${{ matrix.target }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: x86_64-unknown-linux-gnu
+          - os: windows-latest
+            target: x86_64-pc-windows-msvc
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build wheel
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --out dist
+          manylinux: auto
+          sccache: true
+
+      - name: Upload wheel
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.target }}
+          path: dist/*.whl
+
+  sdist:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+
+      - name: Upload sdist
+        uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+
+  publish:
+    needs:
+      - build
+      - sdist
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    environment:
+      name: pypi
+      url: https://pypi.org/p/roto-api-native
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: dist
+          pattern: "*"
+          merge-multiple: true
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

roto_api_native-0.2.1/.gitignore

@@ -0,0 +1,81 @@
+## File system
+.DS_Store
+desktop.ini
+
+## Editor
+*.swp
+*.swo
+Session.vim
+.cproject
+.idea
+*.iml
+.vscode
+.project
+.favorites.json
+.settings/
+
+## Tool
+.valgrindrc
+.cargo
+
+## Configuration
+/config.toml
+/Makefile
+config.mk
+config.stamp
+no_llvm_build
+
+## Build
+/dl/
+/doc/
+/inst/
+/llvm/
+/mingw-build/
+/build/
+/dist/
+/unicode-downloads
+/target
+/src/tools/x/target
+# Generated by compiletest for incremental
+/tmp/
+# Created by default with `src/ci/docker/run.sh`
+/obj/
+
+## Temporary files
+*~
+\#*
+\#*\#
+.#*
+
+## Tags
+tags
+tags.*
+TAGS
+TAGS.*
+
+## Python
+__pycache__/
+*.py[cod]
+*$py.class
+.pkgtest/
+.tmp/
+tests/.work/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+.coverage.*
+htmlcov/
+.venv/
+venv/
+*.egg-info/
+
+## Node
+**node_modules
+
+## This repo 
+/data
+/downloads
+/dist
+/target/wheels
+/*.whl

roto_api_native-0.2.1/API.md

@@ -0,0 +1,141 @@
+# API Reference
+
+## Package
+
+Install name:
+- `roto-api-native`
+
+Import name:
+- `roto_api`
+
+## Public Symbols
+
+### `roto_api.__version__`
+
+String package version.
+
+## Functions
+
+### `roto_api.load_lookup(data_dir)`
+
+Loads the Rust lookup engine from an already prepared data directory.
+
+Parameters:
+- `data_dir`: directory containing generated CSV files
+
+Returns:
+- `RotoLookup`
+
+Example:
+
+```python
+from roto_api import load_lookup
+
+lookup = load_lookup("./data")
+```
+
+### `roto_api.open_lookup(data_dir)`
+
+Alias for `load_lookup(data_dir)`.
+
+Parameters:
+- `data_dir`: directory containing a prepared local dataset snapshot
+
+Returns:
+- `RotoLookup`
+
+Example:
+
+```python
+from roto_api import open_lookup
+
+lookup = open_lookup("./data")
+```
+
+## Class `roto_api.RotoLookup`
+
+### `RotoLookup(prefixes_file, ris_files, timestamps_dir=None)`
+
+Build a lookup object from explicit file paths.
+
+Parameters:
+- `prefixes_file`: path to `delegated_all.csv`
+- `ris_files`: list of RIS Whois CSV paths, usually IPv4 and IPv6
+- `timestamps_dir`: optional directory containing timestamp CSV files; defaults to the prefix file's parent
+
+### `RotoLookup.from_data_dir(data_dir)`
+
+Convenience constructor that expects:
+
+- `delegated_all.csv`
+- one or both of `pfx_asn_dfz_v4.csv` and `pfx_asn_dfz_v6.csv`
+
+Optional metadata files:
+
+- `del_ext.timestamps.json`
+- `riswhois.timestamps.json`
+
+If those metadata files are absent, the lookup still loads and `source_status()` returns an empty list.
+
+Returns:
+- `RotoLookup`
+
+### `RotoLookup.lookup_ip(ip)`
+
+Run a single-IP longest-prefix lookup.
+
+Parameters:
+- `ip`: string IPv4 or IPv6 address
+
+Returns:
+- dict with:
+  - `ip`: original input IP
+  - `prefix`: matched prefix string or `None`
+  - `origin_asns`: list of origin ASN strings like `["AS15169"]`
+  - `match_type`: match type string
+
+Example:
+
+```python
+result = lookup.lookup_ip("8.8.8.8")
+```
+
+### `RotoLookup.lookup_ips(ips)`
+
+Run longest-prefix lookup for many IPs in one Rust call.
+
+Parameters:
+- `ips`: list of string IPv4/IPv6 addresses
+
+Returns:
+- list of result dicts with the same schema as `lookup_ip`
+
+Example:
+
+```python
+results = lookup.lookup_ips(["8.8.8.8", "1.1.1.1"])
+```
+
+### `RotoLookup.source_status()`
+
+Return metadata about the currently loaded sources.
+
+Returns:
+- list of dicts containing:
+  - `type`: `rir-alloc` or `bgp`
+  - `id`: source identifier
+  - `serial`: source serial/timestamp integer
+  - `last_updated`: RFC3339 timestamp string
+
+If the loaded snapshot does not include timestamp metadata files, this returns an empty list.
+
+## Dump Preparation
+
+Dump download and transformation are intentionally outside the published package.
+
+Use `scripts/bootstrap_data.py` or your own application code to prepare:
+
+- `delegated_all.csv`
+- `pfx_asn_dfz_v4.csv`
+- `pfx_asn_dfz_v6.csv`
+- optional timestamp metadata files