pydynox 0.1.0__tar.gz

pydynox-0.1.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 DynamoClient
+
+client = DynamoClient()
+# ...
+```
+
+## 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.1.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.1.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.1.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, windows-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.1.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
+
+      - name: Install dependencies and wheel
+        run: |
+          uv pip install pytest pytest-asyncio pytest-codspeed hypothesis "moto[dynamodb,server]" boto3 pydantic pynamodb
+          uv pip install target/wheels/*.whl
+
+      - name: Run benchmarks
+        uses: CodSpeedHQ/action@v4.5.1
+        with:
+          mode: simulation
+          run: uv run pytest benchmark/ --codspeed

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

@@ -0,0 +1,169 @@
+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:
+  #   name: Build Linux (${{ matrix.target }})
+  #   runs-on: ubuntu-latest
+  #   strategy:
+  #     matrix:
+  #       target: [x86_64, aarch64]
+  #   steps:
+  #     - uses: actions/checkout@v4
+
+  #     - name: Build wheels
+  #       uses: PyO3/maturin-action@v1
+  #       with:
+  #         target: ${{ matrix.target }}
+  #         args: --release --out dist -i python3.11 -i python3.12 -i python3.13 -i python3.14
+  #         manylinux: 2014
+  #         sccache: true
+
+  #     - name: Upload wheels
+  #       uses: actions/upload-artifact@v4
+  #       with:
+  #         name: wheels-linux-${{ matrix.target }}
+  #         path: dist/*.whl
+
+  # build-musllinux:
+  #   name: Build musllinux (${{ matrix.target }})
+  #   runs-on: ubuntu-latest
+  #   strategy:
+  #     matrix:
+  #       target: [x86_64, aarch64]
+  #   steps:
+  #     - uses: actions/checkout@v4
+
+  #     - name: Build wheels
+  #       uses: PyO3/maturin-action@v1
+  #       with:
+  #         target: ${{ matrix.target }}
+  #         args: --release --out dist -i python3.11 -i python3.12 -i python3.13 -i python3.14
+  #         manylinux: musllinux_1_1
+  #         sccache: true
+
+  #     - name: Upload wheels
+  #       uses: actions/upload-artifact@v4
+  #       with:
+  #         name: wheels-musllinux-${{ matrix.target }}
+  #         path: dist/*.whl
+
+  # build-macos:
+  #   name: Build macOS (${{ matrix.target }})
+  #   runs-on: ${{ matrix.runner }}
+  #   strategy:
+  #     matrix:
+  #       include:
+  #         - runner: macos-13
+  #           target: x86_64-apple-darwin
+  #         - runner: macos-14
+  #           target: 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 python3.11 -i python3.12 -i python3.13 -i python3.14
+  #         sccache: true
+
+  #     - name: Upload wheels
+  #       uses: actions/upload-artifact@v4
+  #       with:
+  #         name: wheels-macos-${{ matrix.target }}
+  #         path: dist/*.whl
+
+  # build-windows:
+  #   name: Build Windows (${{ matrix.target }})
+  #   runs-on: windows-latest
+  #   strategy:
+  #     matrix:
+  #       target: [x64]
+  #   steps:
+  #     - uses: actions/checkout@v4
+
+  #     - name: Build wheels
+  #       uses: PyO3/maturin-action@v1
+  #       with:
+  #         target: ${{ matrix.target }}
+  #         args: --release --out dist -i python3.11 -i python3.12 -i python3.13 -i python3.14
+  #         sccache: true
+
+  #     - name: Upload wheels
+  #       uses: actions/upload-artifact@v4
+  #       with:
+  #         name: wheels-windows-${{ matrix.target }}
+  #         path: dist/*.whl
+
+  build-sdist:
+    name: Build source distribution
+    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: wheels-sdist
+          path: dist/*.tar.gz
+
+  publish:
+    name: Publish to PyPI
+    needs: [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: wheels-*
+          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: publish
+  #   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: 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.1.0/.gitignore

@@ -0,0 +1,82 @@
+# Rust
+/target/
+**/*.rs.bk
+
+# 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.1.0/CONTRIBUTING.md

@@ -0,0 +1,145 @@
+# Contributing to pydyno
+
+Thanks for your interest in pydyno! This guide will help you get started.
+
+## Setup
+
+### Requirements
+
+- Rust (latest stable)
+- Python 3.9+
+- maturin
+
+### Install Rust
+
+```bash
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+```
+
+### Clone and Setup
+
+```bash
+git clone https://github.com/yourusername/pydyno.git
+cd pydyno
+
+# Create virtual environment
+python -m venv .venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+
+# Install maturin and dev dependencies
+pip install maturin
+pip install -e ".[dev]"
+```
+
+### Build Locally
+
+```bash
+# Build and install in development mode
+maturin develop
+
+# Build release version
+maturin build --release
+```
+
+## Running Tests
+
+### Rust Tests
+
+```bash
+cargo test
+```
+
+### Python Tests
+
+```bash
+# Run all Python tests
+pytest
+
+# Run specific test file
+pytest tests/python/test_model.py
+
+# Run with verbose output
+pytest -v
+```
+
+### Property Tests
+
+Property tests use Hypothesis and run many random inputs:
+
+```bash
+pytest tests/python/property/
+```
+
+### Integration Tests
+
+Integration tests need moto or localstack:
+
+```bash
+pytest tests/integration/
+```
+
+## Code Style
+
+### Rust
+
+```bash
+# Format code
+cargo fmt
+
+# Check for issues
+cargo clippy
+```
+
+### Python
+
+Follow PEP 8. Use type hints everywhere.
+
+```python
+# Good
+def get_user(user_id: str) -> Optional[User]:
+    ...
+
+# Bad
+def get_user(user_id):
+    ...
+```
+
+## Pull Request Process
+
+1. Fork the repo
+2. Create a branch: `git checkout -b my-feature`
+3. Make your changes
+4. Run tests: `cargo test && pytest`
+5. Run formatters: `cargo fmt`
+6. Push and create a PR
+
+### PR Checklist
+
+- [ ] Tests pass
+- [ ] Code is formatted
+- [ ] New features have tests
+- [ ] Docs updated if API changed
+
+## Project Structure
+
+```
+pydyno/
+├── src/                    # Rust source code
+│   ├── lib.rs             # PyO3 module entry
+│   ├── client.rs          # DynamoDB client
+│   ├── serialization.rs   # Type conversion
+│   └── errors.rs          # Error types
+├── python/pydyno/         # Python source code
+│   └── __init__.py        # Python API
+├── tests/
+│   ├── python/            # Python unit tests
+│   │   └── property/      # Property-based tests
+│   ├── integration/       # Integration tests
+│   └── rust/              # Rust test notes
+├── Cargo.toml             # Rust dependencies
+└── pyproject.toml         # Python config
+```
+
+## Questions?
+
+Open an issue on GitHub if you have questions or need help.