pydynox 0.5.0__tar.gz

pydynox-0.5.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,40 @@
+---
+name: Bug Report
+about: Report a bug to help us improve
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## Description
+
+A clear description of the bug.
+
+## Steps to Reproduce
+
+```python
+# Minimal code to reproduce the issue
+from pydynox import DynamoDBClient
+
+client = DynamoDBClient()
+# ...
+```
+
+## Expected Behavior
+
+What you expected to happen.
+
+## Actual Behavior
+
+What actually happened. Include error messages if any.
+
+## Environment
+
+- **pydynox version**: (e.g., 0.1.0)
+- **Python version**: (e.g., 3.12)
+- **OS**: (e.g., macOS 14, Ubuntu 22.04, Windows 11)
+- **AWS Region**: (if relevant)
+
+## Additional Context
+
+Any other info that might help (logs, screenshots, etc).

pydynox-0.5.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Documentation
+    url: https://pydynox.readthedocs.io
+    about: Check the docs before opening an issue

pydynox-0.5.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,30 @@
+---
+name: Feature Request
+about: Suggest a new feature or improvement
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+---
+
+## Problem
+
+What problem does this feature solve? 
+
+## Proposed Solution
+
+How would you like it to work?
+
+```python
+# Example of how you'd use this feature
+from pydynox import ...
+
+# ...
+```
+
+## Alternatives Considered
+
+Any other solutions you've thought about.
+
+## Additional Context
+
+Any other info (links, examples from other libraries, etc).

pydynox-0.5.0/.github/workflows/ci.yml

@@ -0,0 +1,127 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Rust fmt
+        run: cargo fmt --all -- --check
+
+      - name: Rust clippy
+        run: cargo clippy --all-targets -- -D warnings
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python
+        run: uv python install 3.11
+
+      - name: Python lint
+        run: |
+          uv venv
+          uv pip install ruff
+          uv run ruff check python/ tests/
+
+  test:
+    name: Test (${{ matrix.os }} / py${{ matrix.python }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python: ["3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+          allow-prereleases: true
+
+      - name: Create venv
+        run: python -m venv .venv
+
+      - name: Build wheel
+        uses: PyO3/maturin-action@v1
+        with:
+          command: build
+          args: --release --out dist
+          sccache: true
+
+      - name: Install wheel and dependencies (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          source .venv/bin/activate
+          pip install dist/*.whl
+          pip install pytest pytest-asyncio hypothesis "moto[dynamodb,server]" boto3 pydantic
+
+      - name: Install wheel and dependencies (Windows)
+        if: runner.os == 'Windows'
+        run: |
+          .venv\Scripts\activate
+          pip install (Get-ChildItem dist\*.whl)
+          pip install pytest pytest-asyncio hypothesis "moto[dynamodb,server]" boto3 pydantic
+
+      - name: Run tests (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          source .venv/bin/activate
+          pytest tests/ -v --ignore=tests/benchmark
+
+      - name: Run tests (Windows)
+        if: runner.os == 'Windows'
+        run: |
+          .venv\Scripts\activate
+          pytest tests/ -v --ignore=tests/benchmark
+
+  coverage:
+    name: Coverage
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Create venv
+        run: python -m venv .venv
+
+      - name: Build wheel
+        uses: PyO3/maturin-action@v1
+        with:
+          command: build
+          args: --release --out dist
+          sccache: true
+
+      - name: Install wheel and dependencies
+        run: |
+          source .venv/bin/activate
+          pip install dist/*.whl
+          pip install pytest pytest-asyncio pytest-cov hypothesis "moto[dynamodb,server]" boto3 pydantic
+
+      - name: Run tests with coverage
+        run: |
+          source .venv/bin/activate
+          pytest tests/ -v --cov=pydynox --cov-report=xml --ignore=tests/benchmark
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+        with:
+          files: coverage.xml
+          fail_ci_if_error: false

pydynox-0.5.0/.github/workflows/codspeed.yml

@@ -0,0 +1,59 @@
+name: CodSpeed
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+env:
+  CARGO_TERM_COLOR: always
+  UV_FROZEN: "1"
+
+jobs:
+  codspeed:
+    name: Run benchmarks
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+
+      - name: Cache cargo
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/bin/
+            ~/.cargo/registry/index/
+            ~/.cargo/registry/cache/
+            ~/.cargo/git/db/
+            target/
+          key: ${{ runner.os }}-cargo-codspeed-${{ hashFiles('**/Cargo.lock') }}
+
+      - name: Set up Python 3.12
+        run: uv python install 3.12
+
+      - name: Build wheel
+        run: |
+          uv venv --python 3.12
+          uv pip install maturin
+          uv run maturin build --release --interpreter python3.12 --out dist
+
+      - name: Install dependencies and wheel
+        run: |
+          uv pip install pytest pytest-asyncio pytest-codspeed hypothesis "moto[dynamodb,server]" boto3 pydantic pynamodb
+          uv pip install dist/pydynox-*.whl --force-reinstall --no-deps
+
+      - name: Run benchmarks
+        uses: CodSpeedHQ/action@v4.5.1
+        with:
+          mode: simulation
+          run: uv run pytest --ignore=tests/benchmark --codspeed

pydynox-0.5.0/.github/workflows/docs.yml

@@ -0,0 +1,61 @@
+name: Documentation
+
+on:
+    push:
+        branches: [main]
+        paths:
+            - "docs/**"
+            - "zensical.toml"
+            - ".github/workflows/docs.yml"
+    pull_request:
+        paths:
+            - "docs/**"
+            - "zensical.toml"
+    workflow_dispatch:
+
+permissions:
+    contents: read
+    pages: write
+    id-token: write
+
+concurrency:
+    group: "pages"
+    cancel-in-progress: false
+
+jobs:
+    build:
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v4
+
+            - name: Install uv
+              uses: astral-sh/setup-uv@v4
+
+            - name: Setup Python
+              run: uv python install 3.12
+
+            - name: Install dependencies
+              run: |
+                  uv venv
+                  uv pip install zensical
+
+            - name: Build docs
+              run: uv run zensical build
+
+            - name: Upload artifact
+              uses: actions/upload-pages-artifact@v3
+              with:
+                  path: site
+
+    # Only deploy on push to main, not on PRs
+    deploy:
+        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+        environment:
+            name: github-pages
+            url: ${{ steps.deployment.outputs.page_url }}
+        runs-on: ubuntu-latest
+        needs: build
+        steps:
+            - name: Deploy to GitHub Pages
+              id: deployment
+              uses: actions/deploy-pages@v4

pydynox-0.5.0/.github/workflows/release.yml

@@ -0,0 +1,147 @@
+name: Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Version to release (e.g., 0.1.0)"
+        required: true
+        type: string
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  build-linux-x86:
+    name: Build manylinux x86_64 cp${{ matrix.python }}
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python: ["3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: x86_64
+          args: --release --out dist -i python${{ matrix.python }}
+          manylinux: auto
+          sccache: true
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: pydynox-${{ inputs.version }}-cp${{ matrix.python }}-manylinux-x86_64
+          path: dist/*.whl
+
+  build-linux-arm:
+    name: Build manylinux aarch64 cp${{ matrix.python }}
+    runs-on: ubuntu-24.04-arm
+    strategy:
+      matrix:
+        python: ["3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: aarch64
+          args: --release --out dist -i python${{ matrix.python }}
+          manylinux: auto
+          sccache: true
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: pydynox-${{ inputs.version }}-cp${{ matrix.python }}-manylinux-aarch64
+          path: dist/*.whl
+
+  build-macos:
+    name: Build macOS ${{ matrix.target }} cp${{ matrix.python }}
+    runs-on: macos-latest
+    strategy:
+      matrix:
+        python: ["3.11", "3.12", "3.13", "3.14"]
+        target: [x86_64-apple-darwin, aarch64-apple-darwin]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --out dist -i python${{ matrix.python }}
+          sccache: true
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: pydynox-${{ inputs.version }}-cp${{ matrix.python }}-macos-${{ matrix.target }}
+          path: dist/*.whl
+
+  build-sdist:
+    name: Build 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: pydynox-${{ inputs.version }}-sdist
+          path: dist/*.tar.gz
+
+  publish:
+    name: Publish to PyPI
+    needs: [build-linux-x86, build-linux-arm, build-macos, build-sdist]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/pydynox
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          pattern: pydynox-${{ inputs.version }}-*
+          path: dist
+          merge-multiple: true
+
+      - name: List artifacts
+        run: ls -la dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  # github-release:
+  #   name: Create GitHub Release
+  #   needs: [build-linux, build-musllinux, build-macos, build-sdist]
+  #   runs-on: ubuntu-latest
+  #   steps:
+  #     - uses: actions/checkout@v4
+
+  #     - name: Download all artifacts
+  #       uses: actions/download-artifact@v4
+  #       with:
+  #         pattern: wheels-*
+  #         path: dist
+  #         merge-multiple: true
+
+  #     - name: List artifacts
+  #       run: ls -la dist/
+
+  #     - name: Create Release
+  #       uses: softprops/action-gh-release@v2
+  #       with:
+  #         tag_name: v${{ inputs.version }}
+  #         name: Release v${{ inputs.version }}
+  #         files: dist/*
+  #         generate_release_notes: true

pydynox-0.5.0/.gitignore

@@ -0,0 +1,84 @@
+# Rust
+/target/
+**/*.rs.bk
+
+/site/
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.env
+.venv/
+env/
+venv/
+ENV/
+.python-version
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+.hypothesis/
+*.cover
+
+# IDE - VSCode
+.vscode/
+*.code-workspace
+
+# IDE - Kiro
+.kiro/
+
+# IDE - JetBrains
+.idea/
+*.iml
+
+# IDE - Other
+*.swp
+*.swo
+*~
+.project
+.pydevproject
+.settings/
+
+# OS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# maturin
+*.whl
+
+# Logs
+*.log
+logs/
+
+# Local config
+.env.local
+.env.*.local

pydynox-0.5.0/AGENTS.md

@@ -0,0 +1,143 @@
+# AI Agent Instructions
+
+This file helps AI coding assistants understand the pydynox project.
+
+## What is pydynox?
+
+A fast DynamoDB ORM for Python. The core is written in Rust for speed, with Python bindings via PyO3.
+
+## Project Structure
+
+This is an example of the structure. The project may have more files. Follow this pattern when adding new ones.
+
+```
+pydynox/
+├── src/                    # Rust code
+│   ├── lib.rs             # Main module, exports to Python
+│   ├── client.rs          # DynamoDB client
+│   ├── basic_operations.rs # put, get, delete, update, query
+│   ├── batch_operations.rs # batch_write, batch_get
+│   └── transaction_operations.rs # transact_write
+├── python/pydynox/        # Python wrappers
+│   ├── __init__.py        # Public API exports
+│   ├── client.py          # DynamoDBClient wrapper
+│   ├── query.py           # QueryResult wrapper
+│   └── transaction.py     # Transaction wrapper
+├── tests/
+│   ├── integration/       # Integration tests (need moto server)
+│   └── python/            # Unit tests
+└── Cargo.toml             # Rust dependencies
+```
+
+## Critical: How to Build
+
+**NEVER use `cargo build`**. This is a PyO3 project. Use maturin:
+
+```bash
+# Development build
+uv run maturin develop
+
+# Release build (faster)
+uv run maturin develop --release
+
+# Build wheel for distribution
+uv run maturin build --release
+```
+
+## How to Run Tests
+
+```bash
+# All tests
+uv run pytest tests/ -v
+
+# Specific test file
+uv run pytest tests/integration/operations/test_get_item.py -v
+
+# Skip benchmarks
+uv run pytest tests/ -v --ignore=tests/benchmark
+```
+
+Tests use moto server (DynamoDB mock). The conftest.py starts it automatically.
+
+## Code Style
+
+### Rust
+
+- Run `cargo fmt` before committing
+- Run `cargo clippy -- -D warnings` to check for issues
+- Add doc comments (`///`) to all public items
+- Use `PyResult<T>` for functions that can fail
+
+### Python
+
+- Follow PEP 8
+- Use type hints everywhere
+- Use Google-style docstrings
+- Use plain functions for tests, not classes
+- Use `pytest.mark.parametrize` for multiple test cases
+
+## Adding a New Feature
+
+1. Write Rust code in `src/`
+2. Export in `src/lib.rs`
+3. Create Python wrapper in `python/pydynox/`
+4. Export in `python/pydynox/__init__.py`
+5. Write tests in `tests/`
+
+## Python ↔ Rust Mapping
+
+| Python | Rust |
+|--------|------|
+| `client.py` | `client.rs` |
+| `query.py` | `basic_operations.rs` |
+| `transaction.py` | `transaction_operations.rs` |
+
+## Importing Rust from Python
+
+```python
+from pydynox import pydynox_core
+
+# Use Rust classes
+client = pydynox_core.DynamoDBClient(...)
+```
+
+Never import from `_rust` or other private modules.
+
+## Common Mistakes to Avoid
+
+1. **Using `cargo build`** - Won't produce a usable Python module
+2. **Forgetting to export in `__init__.py`** - Users can't import it
+3. **Using test classes** - Use plain functions instead
+4. **Missing type hints** - Add them to all Python code
+5. **Missing doc comments** - Add them to all public Rust items
+
+## Writing Style
+
+- Write simple English
+- Short sentences
+- No buzzwords (don't say "leverage", "utilize", "robust", etc.)
+- Be direct and clear
+
+## Useful Commands
+
+```bash
+# Format Rust code
+cargo fmt
+
+# Check Rust code
+cargo clippy -- -D warnings
+
+# Lint Python code
+uv run ruff check python/ tests/
+
+# Run specific test
+uv run pytest tests/integration/operations/test_get_item.py -v
+
+# Build release
+uv run maturin develop --release
+```
+
+## Dependencies
+
+- Rust: aws-sdk-dynamodb, pyo3, tokio
+- Python: pytest, moto, boto3, hypothesis