nblade 0.1.2__tar.gz

nblade-0.1.2/.github/workflows/ci.yml

@@ -0,0 +1,104 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test-rust:
+    name: Rust Tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+      
+      - name: Cache cargo
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-
+      
+      - name: Run Rust tests
+        run: cargo test --lib --all-features
+
+  test-python:
+    name: Python Tests (${{ matrix.python-version }}, ${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    needs: test-rust
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.8", "3.10", "3.12"]
+        exclude:
+          - os: macos-latest
+            python-version: "3.8"
+          - os: windows-latest
+            python-version: "3.8"
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+      
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      
+      - name: Install maturin
+        run: pip install maturin pytest numpy
+      
+      - name: Build wheel (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          python -m venv .venv
+          source .venv/bin/activate
+          maturin develop --release
+      
+      - name: Build wheel (Windows)
+        if: runner.os == 'Windows'
+        shell: bash
+        run: |
+          python -m venv .venv
+          source .venv/Scripts/activate
+          maturin develop --release
+      
+      - name: Run Python tests (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          source .venv/bin/activate
+          pytest python/test_nblade.py -v
+      
+      - name: Run Python tests (Windows)
+        if: runner.os == 'Windows'
+        shell: bash
+        run: |
+          source .venv/Scripts/activate
+          pytest python/test_nblade.py -v
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+      
+      - name: Check formatting
+        run: cargo fmt -- --check
+      
+      - name: Clippy
+        run: cargo clippy --all-features -- -D warnings

nblade-0.1.2/.github/workflows/publish-crates.yml

@@ -0,0 +1,24 @@
+name: Publish to Crates.io
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  publish:
+    name: Publish to Crates.io
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+      
+      - name: Publish to Crates.io
+        run: cargo publish --token ${{ secrets.CARGO_REGISTRY_TOKEN }}
+      
+      - name: Verify publication
+        run: |
+          sleep 30
+          cargo search nblade | head -5

nblade-0.1.2/.github/workflows/publish-pypi.yml

@@ -0,0 +1,95 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]  # Trigger on GitHub Release published
+  workflow_dispatch:  # Manual trigger with input
+    inputs:
+      version:
+        description: 'Version to publish (e.g., 0.1.1)'
+        required: false
+
+jobs:
+  build-wheels:
+    name: Build wheels on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.8", "3.10", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+      
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          command: build
+          args: --release --out dist
+          manylinux: auto
+      
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}-${{ matrix.python-version }}
+          path: dist
+
+  build-sdist:
+    name: Build source distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+      
+      - name: Build sdist
+        run: |
+          pip install maturin
+          maturin sdist --out dist
+      
+      - name: Upload sdist
+        uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist
+
+  publish:
+    name: Publish to PyPI
+    needs: [build-wheels, build-sdist]
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    environment:
+      name: pypi
+      url: https://pypi.org/project/nblade/
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          path: dist
+          merge-multiple: true
+      
+      - name: Download sdist
+        uses: actions/download-artifact@v4
+        with:
+          name: sdist
+          path: dist
+      
+      - name: List distributions
+        run: ls -la dist/
+      
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        # Uses trusted publishing, no token needed

nblade-0.1.2/.github/workflows/publish-test.yml

@@ -0,0 +1,90 @@
+name: Publish to TestPyPI
+
+on:
+  push:
+    tags:
+      - 'v*-test'  # Only test tags like v0.1.1-test
+  workflow_dispatch:  # Manual trigger
+
+jobs:
+  build-wheels:
+    name: Build wheels on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+      
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+      
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          command: build
+          args: --release --out dist
+          manylinux: auto
+      
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}
+          path: dist
+
+  build-sdist:
+    name: Build source distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+      
+      - name: Build sdist
+        run: |
+          pip install maturin
+          maturin sdist --out dist
+      
+      - name: Upload sdist
+        uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist
+
+  publish:
+    name: Publish to TestPyPI
+    needs: [build-wheels, build-sdist]
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - name: Download wheels
+        uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          path: dist
+          merge-multiple: true
+      
+      - name: Download sdist
+        uses: actions/download-artifact@v4
+        with:
+          name: sdist
+          path: dist
+      
+      - name: List distributions
+        run: ls -la dist/
+      
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          skip-existing: true

nblade-0.1.2/.github/workflows/release-please.yml

@@ -0,0 +1,30 @@
+name: Release Please
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: googleapis/release-please-action@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          release-type: rust
+          package-name: nblade
+          changelog-types: |
+            [
+              {"type":"feat","section":"Features","hidden":false},
+              {"type":"fix","section":"Bug Fixes","hidden":false},
+              {"type":"chore","section":"Miscellaneous","hidden":false},
+              {"type":"docs","section":"Documentation","hidden":false},
+              {"type":"perf","section":"Performance","hidden":false},
+              {"type":"refactor","section":"Refactoring","hidden":false},
+              {"type":"test","section":"Tests","hidden":false}
+            ]

nblade-0.1.2/.gitignore

@@ -0,0 +1,60 @@
+# Rust build artifacts
+/target/
+
+# 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
+
+# Virtual environments
+venv/
+ENV/
+env/
+.venv/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+lcov.info
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Linter/formatter caches
+.ruff_cache/
+.mypy_cache/
+
+# Project-specific
+.sisyphus/
+.lingma/
+.archive/
+
+# Development notes
+full_zh.md
+summary.md
+
+# OS
+.DS_Store
+Thumbs.db

nblade-0.1.2/.readthedocs.yaml

@@ -0,0 +1,20 @@
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+# Set the OS, Python version, and other tools you might need
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.13"
+
+# Build documentation with Mkdocs
+mkdocs:
+  configuration: mkdocs.yml
+
+# Python requirements for building documentation
+python:
+  install:
+    - requirements: docs/requirements.txt

nblade-0.1.2/.release-please-config.json

@@ -0,0 +1,10 @@
+{
+  "packages": {
+    ".": {
+      "release-type": "rust",
+      "package-name": "nblade",
+      "changelog-path": "CHANGELOG.md"
+    }
+  },
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json"
+}

nblade-0.1.2/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.2"
+}

nblade-0.1.2/AGENTS.md

@@ -0,0 +1,159 @@
+# NBLADE PROJECT KNOWLEDGE BASE
+
+**Generated:** 2026-03-22T12:00:00+08:00
+**Stack:** Rust 2021 Edition + Python 3.8+ (PyO3/maturin)
+
+## OVERVIEW
+
+nblade (N-dimensional Blade) - High-performance Geometric Algebra library for arbitrary dimensions (up to 64D). Supports any metric signature G(p,q,r) with dense/sparse multivector representations and parallel computation via rayon.
+
+## STRUCTURE
+
+```
+nblade/
+├── src/
+│   ├── lib.rs              # Entry point, public API, prelude
+│   ├── signature.rs        # Metric signature (p,q,r)
+│   ├── algebra_config.rs   # Algebra configuration (Arc-shared)
+│   ├── multiplication_table.rs  # Precomputed tables (rayon parallel)
+│   ├── basis/              # Bitwise basis index operations
+│   ├── multivector/        # Dense/Sparse multivector types (CORE)
+│   ├── products/           # Geometric, outer, inner products
+│   ├── operations/         # Involution, dual, inverse, norm
+│   ├── geometry/           # Projection, rotation, reflection
+│   └── python/             # PyO3 bindings (feature-gated)
+├── tests/                  # Integration tests
+├── benches/                # Criterion benchmarks
+├── python/                 # Python package (nblade)
+├── examples/               # Tutorial and application examples
+│   ├── tutorials/          # Basic tutorials
+│   ├── physics/            # Physics applications
+│   └── cg/                 # Computer graphics examples
+└── docs/                   # MkDocs documentation
+    ├── zh/                 # Chinese documentation
+    └── en/                 # English documentation
+```
+
+## WHERE TO LOOK
+
+| Task | Location | Notes |
+|------|----------|-------|
+| Create multivector | `src/multivector/mod.rs` | `MultiVector::basis_vector()`, `from_coefficients()` |
+| Geometric product | `src/products/geometric.rs` | Uses precomputed tables |
+| Basis operations | `src/basis/index.rs` | Bitwise encoding, sign calculations |
+| Metric signatures | `src/signature.rs` | Euclidean, spacetime, custom |
+| Thread sharing | `src/algebra_config.rs` | `AlgebraConfigRef = Arc<AlgebraConfig>` |
+| Python bindings | `src/python/mod.rs` | Feature `python` required |
+| Tests | `tests/test_arbitrary_dimension.rs` | 19 tests, 1D-16D coverage |
+| Benchmarks | `benches/geometric_product.rs` | Criterion, 3D and 5D |
+| Volume element | `src/algebra_config.rs` | `volume_element()`, `volume_element_squared()`, `volume_element_inverse()` |
+| Reciprocal frame | `src/basis/frame.rs` | `reciprocal_frame()`, `verify_reciprocal_frame()`, `metric_tensor()` |
+| Basis expansion | `src/basis/frame.rs` | `basis_expansion()`, `basis_reconstruction()` |
+| Dual operations | `src/operations/dual.rs` | `dual()`, `inverse_dual()` |
+
+## CODE MAP
+
+| Symbol | Type | Location | Role |
+|--------|------|----------|------|
+| `MultiVector` | Enum | `src/multivector/mod.rs` | Core type, 40+ operations |
+| `DenseMultiVector` | Struct | `src/multivector/dense.rs` | ndarray-backed, all 2^n coeffs |
+| `SparseMultiVector` | Struct | `src/multivector/sparse.rs` | HashMap-backed, <10% density |
+| `Signature` | Struct | `src/signature.rs` | Metric (p,q,r), basis squares |
+| `AlgebraConfig` | Struct | `src/algebra_config.rs` | Dimension, signature, metric factors |
+| `BasisIndex` | Type | `src/basis/index.rs` | `u64` for up to 64 dimensions |
+| `MultiplicationTables` | Struct | `src/multiplication_table.rs` | Precomputed lookup tables |
+| `reciprocal_frame` | Function | `src/basis/frame.rs` | Compute reciprocal frame vectors |
+| `verify_reciprocal_frame` | Function | `src/basis/frame.rs` | Verify aⁱ⌋aⱼ = δⁱⱼ |
+| `metric_tensor` | Function | `src/basis/frame.rs` | Compute metric tensor g_ij |
+| `basis_expansion` | Function | `src/basis/frame.rs` | Expand multivector in basis |
+| `basis_reconstruction` | Function | `src/basis/frame.rs` | Reconstruct from coefficients |
+
+## CONVENTIONS
+
+**Basis Index Encoding:**
+```rust
+// Bitwise: bit i set = includes e_i
+// 0b00101 = e1∧e3, 0b111 = e1∧e2∧e3
+let index: BasisIndex = 0b101;  // e1∧e3
+```
+
+**Auto Dense/Sparse Selection:**
+```rust
+// Density < 10% → Sparse, else Dense
+const SPARSE_THRESHOLD: f64 = 0.1;
+```
+
+**Zero Tolerance:**
+```rust
+const EPSILON: f64 = 1e-15;  // Used throughout for is_zero(), filtering
+```
+
+**Test Config Pattern (repeated in 13 files):**
+```rust
+fn test_config() -> AlgebraConfigRef {
+    Arc::new(AlgebraConfig::euclidean(3))
+}
+```
+
+**Float Assertions:**
+```rust
+assert!((value - expected).abs() < 1e-10);  // Never assert_eq! for floats
+```
+
+## ANTI-PATTERNS (THIS PROJECT)
+
+- **No traits** — Uses concrete types and enum dispatch (MultiVector)
+- **Chinese comments** — Docstrings in Chinese throughout
+- **Manual Send/Sync** — `unsafe impl Send/Sync for AlgebraConfig` (lines 144-145 in algebra_config.rs)
+- **No CI/CD** — Zero workflow files, Makefile, or justfile
+
+## UNIQUE STYLES
+
+**Module Re-exports:**
+```rust
+// basis/mod.rs - wildcard re-export pattern
+pub use index::*;
+pub use grade::*;
+```
+
+**Prelude Module:**
+```rust
+pub mod prelude {
+    pub use crate::Signature;
+    pub use crate::AlgebraConfig;
+    pub use crate::MultiVector;
+    pub use crate::basis::grade_of_index;
+    pub use crate::basis::index::index_to_string;
+}
+```
+
+**Dual Crate Type:**
+```toml
+# Cargo.toml
+crate-type = ["cdylib", "rlib"]  # Python extension + Rust library
+```
+
+## COMMANDS
+
+```bash
+# Build
+cargo build [--release]
+
+# Test
+cargo test --all-features
+
+# Benchmark
+cargo bench
+
+# Python wheel (requires maturin)
+maturin develop
+maturin build --release
+```
+
+## NOTES
+
+- **Max dimension: 64** (BasisIndex = u64)
+- **No git history** — Fresh repo or squashed
+- **Empty `src/utils/`** directory exists but unused
+- **Python feature default ON** — `default = ["python"]`
+- **Release profile:** LTO enabled, single codegen unit for optimization

nblade-0.1.2/CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.2] - 2026-03-23
+
+### Features
+- Added comprehensive examples: spacetime algebra, conformal GA, electromagnetism, rotor interpolation
+- Added Chinese documentation (zh-cn)
+- Added CONTRIBUTING.md with bilingual guidelines
+- Added separate CI workflows for TestPyPI, PyPI, and Crates.io publishing
+
+### Documentation
+- Reorganized docs structure for i18n support
+- Added zh-cn/index.md as Chinese landing page
+
+### Bug Fixes
+- Fixed ReadTheDocs build configuration
+- Fixed mkdocs i18n language code (zh → zh-cn)
+
+## [0.1.1] - 2026-03-22
+
+### Features
+- Initial release with core geometric algebra operations
+- Python bindings via PyO3
+- Support for arbitrary dimensions (up to 64D)
+- Support for arbitrary metric signatures G(p, q, r)
+- Dense and sparse multivector representations
+- NumPy integration
+
+[Unreleased]: https://github.com/UynajGI/nblade/compare/v0.1.2...HEAD
+[0.1.2]: https://github.com/UynajGI/nblade/compare/v0.1.1...v0.1.2
+[0.1.1]: https://github.com/UynajGI/nblade/releases/tag/v0.1.1