asanypath 2.0.0__tar.gz

asanypath-2.0.0/.copilot/skills/async-python-lib/SKILL.md

@@ -0,0 +1,52 @@
+# Copilot Skill: Async Python Library Development
+
+## Purpose
+Guide development of async Python libraries with clean APIs, proper typing, and thorough testing.
+
+## Technical Stack
+- **Python**: 3.10+ with full async/await
+- **Package Manager**: uv (sync, run, build)
+- **Build**: hatchling
+- **Lint/Format**: ruff
+- **Type Checking**: mypy with strict settings
+- **Testing**: pytest + pytest-asyncio (asyncio_mode = "auto")
+
+## Development Commands
+- Install: `uv sync --all-extras`
+- Test: `uv run pytest tests/ -x -q`
+- Lint: `uvx ruff check --fix && uvx ruff format`
+- Type check: `uv run mypy src/`
+- Build wheel: `uv build --wheel`
+
+## Code Conventions
+- All I/O operations must be async (`async def`)
+- Use `anyio` over raw `asyncio` where available for backend-agnostic code
+- Type every function signature — no `Any` unless unavoidable
+- Public API lives in `__init__.py` via `__all__`
+- Use `src/` layout (`src/<package>/`)
+- Exceptions go in `exceptions.py`, inherit from a single base error
+
+## Async Patterns
+- Never call blocking I/O in async functions — use `anyio.to_thread.run_sync()` if needed
+- Prefer `async with` for resource management (connections, sessions, file handles)
+- Use `asynccontextmanager` for custom async context managers
+- Avoid `asyncio.get_event_loop()` — let the framework manage the loop
+
+## Testing
+- All async tests use bare `async def test_*()` (pytest-asyncio auto mode)
+- Use fixtures for shared setup (`@pytest.fixture`)
+- Mock external services (S3, DB) — never hit real infra in unit tests
+- Use `tmp_path` for filesystem tests
+- Run with `-x -q` for fast feedback, `-v` for debugging
+
+## Library Design
+- Keep dependencies minimal — use optional extras for heavy backends
+- Expose a clean `__all__` — implementation details stay private
+- Prefer composition over inheritance for mixins
+- Document breaking changes in commit messages
+
+## What NOT to Do
+- Don't add sync wrappers unless the user asks
+- Don't add CLI features unless the user asks
+- Don't change `__all__` exports without discussing
+- Don't add new dependencies without mentioning it

asanypath-2.0.0/.copilot/skills/gitguro/SKILL.md

@@ -0,0 +1,37 @@
+# Copilot Skill: gitguro
+
+## Purpose
+Create clean, focused local commits for completed work.
+
+## Trigger
+Use this skill when the user asks to commit, finalize, or prepare local changes.
+
+## Local Commit Workflow
+1. Confirm the current directory is a Git repository with `git rev-parse --is-inside-work-tree`.
+2. Inspect the working tree with `git status --short` and `git diff --name-only`.
+3. Leave unrelated user changes unstaged and unmodified.
+4. Run the relevant validation. Pre-commit hooks enforce Ruff formatting and linting when installed; run `uvx ruff check --fix && uvx ruff format` before committing Python changes when practical.
+5. Group related files into one logical concern and stage only those paths.
+6. Commit with a concise imperative subject. Split unrelated work into separate commits.
+7. Confirm the remaining working tree state and report the commit hash and any intentionally uncommitted files.
+
+## Push Policy
+
+**Never push commits, create or update a pull request, fetch, pull, rebase, or
+change branches unless the user explicitly requests that exact remote action.**
+
+Do not infer consent to publish from a request to commit or finalize work.
+Report that commits remain local unless the user has specifically asked to push.
+
+## Good Commit Message Examples
+- feat: add HTTP backend with async streaming
+- fix: handle trailing slash in S3 glob patterns
+- test: add integration tests for GCS path operations
+- docs: document protocol registration API
+
+## Guardrails
+- Never use destructive git commands unless explicitly requested.
+- If there are unrelated workspace changes, avoid committing them.
+- Prefer non-interactive git commands.
+- Never amend, rebase, or rewrite commits unless explicitly requested.
+- Never commit credentials, generated noise, or unreviewed changes.

asanypath-2.0.0/.github/CODEOWNERS

@@ -0,0 +1 @@
+* @hoshimura @hannabjorgvins

asanypath-2.0.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,22 @@
+---
+name: Bug report
+about: Report unexpected behavior
+labels: bug
+---
+
+## Summary
+
+## Steps to reproduce
+
+## Expected behavior
+
+## Actual behavior
+
+## Environment
+
+- AsAnyPath version:
+- Python version:
+- Operating system:
+
+Do not include credentials, tokens, private endpoints, or customer data. Report
+security vulnerabilities privately as described in `SECURITY.md`.

asanypath-2.0.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,13 @@
+---
+name: Feature request
+about: Propose an improvement
+labels: enhancement
+---
+
+## Problem
+
+## Proposed solution
+
+## Alternatives considered
+
+## Additional context

asanypath-2.0.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,9 @@
+## Summary
+
+## Validation
+
+## Checklist
+
+- [ ] Tests cover the changed behavior.
+- [ ] Documentation reflects user-visible changes.
+- [ ] No credentials, private endpoints, or confidential data are included.

asanypath-2.0.0/.github/dependabot.yml

@@ -0,0 +1,27 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 1
+    cooldown:
+      default-days: 14
+    groups:
+      github-actions:
+        patterns:
+          - "*"
+  - package-ecosystem: pip
+    directory: /
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 3
+    cooldown:
+      default-days: 14
+  - package-ecosystem: cargo
+    directory: /rust
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 3
+    cooldown:
+      default-days: 14

asanypath-2.0.0/.github/workflows/publish.yml

@@ -0,0 +1,182 @@
+name: Publish Python and native Package to pypi
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  release-version:
+    runs-on: ubuntu-latest
+    outputs:
+      value: ${{ steps.version.outputs.value }}
+    steps:
+      - name: Validate release tag
+        id: version
+        env:
+          TAG: ${{ github.event.release.tag_name }}
+        run: |
+          case "$TAG" in
+            v[0-9]*.[0-9]*.[0-9]*) ;;
+            *) echo "Release tag must be v<major>.<minor>.<patch>." >&2; exit 1 ;;
+          esac
+          echo "value=${TAG#v}" >> "$GITHUB_OUTPUT"
+
+  build-native:
+    needs: release-version
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: x86_64
+            manylinux: auto
+          - os: macos-13
+            target: x86_64
+            manylinux: off
+          - os: macos-14
+            target: aarch64
+            manylinux: off
+          - os: windows-latest
+            target: x64
+            manylinux: off
+    runs-on: ${{ matrix.os }}
+    steps:
+      - name: Checkout release
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          ref: ${{ github.event.release.tag_name }}
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Set native package version
+        shell: bash
+        env:
+          VERSION: ${{ needs.release-version.outputs.value }}
+        run: |
+          sed -i.bak -E "s/^version = \".*\"$/version = \"${VERSION}\"/" rust/Cargo.toml
+          rm rust/Cargo.toml.bak
+
+      - name: Build native wheels
+        uses: PyO3/maturin-action@e83996d129638aa358a18fbd1dfb82f0b0fb5d3b # v1
+        with:
+          working-directory: rust
+          target: ${{ matrix.target }}
+          manylinux: ${{ matrix.manylinux }}
+          args: --release --out dist --interpreter 3.10 3.11 3.12 3.13 3.14
+
+      - name: Upload native wheels
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: native-${{ matrix.os }}-${{ matrix.target }}
+          path: rust/dist/*.whl
+          if-no-files-found: error
+
+  build-native-sdist:
+    needs: release-version
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout release
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          ref: ${{ github.event.release.tag_name }}
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Set native package version
+        shell: bash
+        env:
+          VERSION: ${{ needs.release-version.outputs.value }}
+        run: |
+          sed -i.bak -E "s/^version = \".*\"$/version = \"${VERSION}\"/" rust/Cargo.toml
+          rm rust/Cargo.toml.bak
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+        with:
+          enable-cache: false
+
+      - name: Build native source distribution
+        run: uvx maturin sdist --manifest-path rust/Cargo.toml --out dist
+
+      - name: Upload native source distribution
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: native-sdist
+          path: dist/*.tar.gz
+          if-no-files-found: error
+
+  build-python:
+    needs: [release-version, build-native, build-native-sdist]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout release
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          ref: ${{ github.event.release.tag_name }}
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+        with:
+          enable-cache: false
+
+      - name: Build Python distributions
+        run: uv build --out-dir dist
+
+      - name: Verify native dependency version
+        env:
+          VERSION: ${{ needs.release-version.outputs.value }}
+        run: |
+          unzip -p dist/*.whl '*/METADATA' | grep -Fx "Requires-Dist: asanypath-native~=${VERSION}.0"
+
+      - name: Upload Python distributions
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: python-distributions
+          path: dist/*
+          if-no-files-found: error
+
+  publish-native:
+    needs: [build-native, build-native-sdist, build-python]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi-native
+      url: https://pypi.org/p/asanypath-native
+    permissions:
+      id-token: write
+    steps:
+      - name: Download native distributions
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        with:
+          pattern: native-*
+          path: dist
+          merge-multiple: true
+
+      - name: Publish native distribution
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # release/v1
+        with:
+          packages-dir: dist
+
+  publish-python:
+    needs: [publish-native, build-python]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/asanypath
+    permissions:
+      id-token: write
+    steps:
+      - name: Download Python distributions
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        with:
+          name: python-distributions
+          path: dist
+
+      - name: Publish Python distribution
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # release/v1
+        with:
+          packages-dir: dist

asanypath-2.0.0/.github/workflows/unittests.yml

@@ -0,0 +1,61 @@
+name: Unit test, lint and coverage
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  rust:
+    name: Rust checks
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          persist-credentials: false
+
+      - name: Check formatting
+        run: cargo fmt --manifest-path rust/Cargo.toml --check
+
+      - name: Check crate
+        run: cargo check --manifest-path rust/Cargo.toml --locked
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: true
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Set up Python
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+
+      - name: Ruff checks
+        run: uvx ruff check src tests && uvx ruff format --check src tests
+
+      - name: Create virtual environment
+        run: uv venv --python "${{ matrix.python-version }}"
+
+      - name: Install project and native extension
+        run: uv pip install -e ".[dev]"
+
+      - name: Test with pytest and coverage
+        env:
+          PYTHONUNBUFFERED: 1
+        run: uv run --no-sync python -m pytest --cov=src --cov-report=term-missing --cov-fail-under=90 tests

asanypath-2.0.0/.gitignore

@@ -0,0 +1,26 @@
+# ignore all files
+*
+# allow listing directory contents
+!*/
+# venv directories
+.venv/
+rust/.venv/
+__pycache__
+# except for the following files and directories
+!pyproject.toml
+!*.md
+!LICENSE
+!.*ignore
+!.copilot/**/SKILL.md
+!.github/**
+!*.py
+!*.pyi
+!asanypath.png
+# auto-generated by hatch-vcs
+_version.py
+!compose.yml
+!uv.lock
+!rust/Cargo.toml
+!rust/Cargo.lock
+!rust/src/**/*.rs
+

asanypath-2.0.0/.pre-commit-config.yaml

@@ -0,0 +1,25 @@
+repos:
+- repo: https://github.com/astral-sh/ruff-pre-commit
+  # Ruff version.
+  rev: v0.15.4
+  hooks:
+    # Run the linter.
+    - id: ruff-check
+      args: [ --fix ]
+    # Run the formatter.
+    - id: ruff-format
+- repo: local
+  hooks:
+    # Mirror the CI Rust checks (.github/workflows/unittests.yml).
+    - id: cargo-fmt
+      name: cargo fmt (rust)
+      entry: cargo fmt --manifest-path rust/Cargo.toml --check
+      language: system
+      files: ^rust/.*\.rs$
+      pass_filenames: false
+    - id: cargo-check
+      name: cargo check (rust)
+      entry: cargo check --manifest-path rust/Cargo.toml --locked
+      language: system
+      files: ^rust/.*\.(rs|toml|lock)$
+      pass_filenames: false

asanypath-2.0.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,12 @@
+# Code of Conduct
+
+We are committed to a respectful, collaborative community. Participate in good
+faith, welcome different perspectives, and focus discussion on the work.
+
+Harassment, discrimination, personal attacks, and sharing private or
+confidential information are not acceptable.
+
+Project maintainers may remove, edit, or reject contributions and comments that
+do not follow this code of conduct. Report conduct concerns through the private
+security-reporting route in [SECURITY.md](SECURITY.md). Reports will be handled
+as confidentially as practical.

asanypath-2.0.0/CONTRIBUTING.md

@@ -0,0 +1,42 @@
+# Contributing to AsAnyPath
+
+Thank you for contributing to AsAnyPath.
+
+## Getting Started
+
+Use Python 3.10 or newer and install the development dependencies:
+
+```bash
+uv sync --extra dev
+uv pip install --reinstall --no-cache rust/
+```
+
+Optionally install the repository's pre-commit hooks to run formatting and
+linting checks before each commit:
+
+```bash
+uv run pre-commit install
+```
+
+Run the focused tests for your change, then the full suite before opening a pull
+request:
+
+```bash
+uv run --extra dev pytest -vx tests/
+uvx ruff check --fix
+uvx ruff format
+cargo check --manifest-path rust/Cargo.toml
+```
+
+## Pull Requests
+
+Keep pull requests focused and include tests for changed behavior. Preserve
+compatibility with Python 3.10 through 3.14. Describe user-visible changes and
+document new configuration, credentials, or backend behavior in the README.
+
+Do not include credentials, private endpoints, customer data, or other
+confidential information in issues, commits, tests, or pull requests. Report
+security issues privately as described in [SECURITY.md](SECURITY.md).
+
+By contributing, you agree that your contributions are licensed under the
+[MIT License](LICENSE).

asanypath-2.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Axis Communications AB
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.