ries-rs 1.0.1__tar.gz

ries_rs-1.0.1/.github/release-template.md

@@ -0,0 +1,18 @@
+## Downloads
+
+This release includes:
+
+- Native CLI binaries for Linux, macOS, and Windows
+- WebAssembly packages for browser, bundler, and Node.js targets
+- Python wheels built from `ries-py/`
+
+## Notes
+
+- For deterministic research workflows, prefer `--deterministic` together with
+  `--json` and `--emit-manifest`.
+- Citation metadata lives in `CITATION.cff`.
+- Zenodo will mint a DOI for the release after publication.
+
+## Full Changelog
+
+See `CHANGELOG.md` in the repository for the full version history.

ries_rs-1.0.1/.github/workflows/benchmark.yml

@@ -0,0 +1,46 @@
+name: Benchmarks
+
+on:
+  workflow_dispatch:
+    inputs:
+      baseline:
+        description: "Baseline name to compare against (leave empty to just save as 'main')"
+        required: false
+        default: ""
+
+jobs:
+  bench:
+    name: Run benchmarks
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache cargo registry
+        uses: Swatinem/rust-cache@v2
+
+      - name: Run benchmarks (compare against baseline)
+        if: inputs.baseline != ''
+        env:
+          BASELINE: ${{ inputs.baseline }}
+        run: |
+          cargo bench --bench evaluation -- --baseline "$BASELINE"
+          cargo bench --bench search    -- --baseline "$BASELINE"
+          cargo bench --bench generation -- --baseline "$BASELINE"
+
+      - name: Run benchmarks (save as 'main' baseline)
+        if: inputs.baseline == ''
+        run: |
+          cargo bench --bench evaluation -- --save-baseline main
+          cargo bench --bench search    -- --save-baseline main
+          cargo bench --bench generation -- --save-baseline main
+
+      - name: Upload criterion report
+        uses: actions/upload-artifact@v4
+        with:
+          name: criterion-report-${{ github.sha }}
+          path: target/criterion/
+          retention-days: 90

ries_rs-1.0.1/.github/workflows/ci.yml

@@ -0,0 +1,209 @@
+name: CI
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  fmt:
+    name: Format
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt
+
+      - name: Check formatting
+        run: cargo fmt -- --check
+
+  clippy:
+    name: Clippy
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy
+
+      - name: Cache cargo registry
+        uses: Swatinem/rust-cache@v2
+
+      - name: Install dependencies for rug (GMP/MPFR)
+        run: sudo apt-get update && sudo apt-get install -y libgmp-dev libmpfr-dev
+
+      - name: Run clippy (default features)
+        run: cargo clippy --all-targets --locked -- -D warnings
+
+      - name: Run clippy (no default features)
+        run: cargo clippy --all-targets --no-default-features --locked -- -D warnings
+
+      - name: Run clippy (highprec feature)
+        run: cargo clippy --all-targets --features highprec --locked -- -D warnings
+
+  check-features:
+    name: Feature coverage check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache cargo registry
+        uses: Swatinem/rust-cache@v2
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Check Python bindings crate
+        run: cargo check --manifest-path ries-py/Cargo.toml --locked
+
+      - name: Build wasm feature
+        run: cargo build --features wasm --locked
+
+      - name: Build wasm + parallel features
+        run: cargo build --features "wasm parallel" --locked
+
+  test:
+    name: Test (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    env:
+      CARGO_PROFILE_TEST_DEBUG: 0
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Install cargo-nextest
+        uses: taiki-e/install-action@nextest
+
+      - name: Cache cargo registry
+        uses: Swatinem/rust-cache@v2
+
+      - name: Run tests
+        run: cargo nextest run --tests --locked
+
+  test-highprec:
+    name: Test (highprec feature)
+    runs-on: ubuntu-latest
+    env:
+      CARGO_PROFILE_TEST_DEBUG: 0
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Install cargo-nextest
+        uses: taiki-e/install-action@nextest
+
+      - name: Cache cargo registry
+        uses: Swatinem/rust-cache@v2
+
+      - name: Install dependencies for rug (GMP/MPFR)
+        run: sudo apt-get update && sudo apt-get install -y libgmp-dev libmpfr-dev
+
+      - name: Run tests with highprec feature
+        run: cargo nextest run --tests --features highprec --locked
+
+  test-wasm:
+    name: Test (WASM)
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: wasm32-unknown-unknown
+
+      - name: Install wasm-pack
+        uses: jetli/wasm-pack-action@v0.4.0
+
+      - name: Run WASM tests
+        run: wasm-pack test --node -- --features wasm
+
+  audit:
+    name: Security Audit
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Install cargo-audit
+        uses: taiki-e/install-action@cargo-audit
+
+      - name: Run security audit
+        run: cargo audit
+
+  parity-check:
+    name: Parity Check (Original RIES)
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout ries-rs
+        uses: actions/checkout@v4
+
+      - name: Detect bundled original RIES source
+        id: has-original
+        run: |
+          if [ -f ries-original/ries.c ]; then
+            echo "present=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "present=false" >> "$GITHUB_OUTPUT"
+            echo "ries-original/ries.c not found; skipping parity-check job steps."
+          fi
+
+      - name: Setup C Compiler
+        if: steps.has-original.outputs.present == 'true'
+        run: sudo apt-get update && sudo apt-get install -y gcc
+
+      - name: Compile Original RIES
+        if: steps.has-original.outputs.present == 'true'
+        run: gcc ries-original/ries.c -lm -o ries-original/ries
+
+      - name: Setup Rust
+        if: steps.has-original.outputs.present == 'true'
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache cargo registry
+        if: steps.has-original.outputs.present == 'true'
+        uses: Swatinem/rust-cache@v2
+
+      - name: Build ries-rs
+        if: steps.has-original.outputs.present == 'true'
+        run: cargo build --release
+
+      - name: Run Parity Checks
+        if: steps.has-original.outputs.present == 'true'
+        run: |
+          chmod +x tests/compare_with_original.sh
+          # Test Pi
+          ./tests/compare_with_original.sh 3.1415926535 2 6 ./ries-original/ries
+          # Test e
+          ./tests/compare_with_original.sh 2.7182818284 2 6 ./ries-original/ries
+          # Test Golden Ratio
+          ./tests/compare_with_original.sh 1.6180339887 2 6 ./ries-original/ries

ries_rs-1.0.1/.github/workflows/coverage.yml

@@ -0,0 +1,37 @@
+name: Coverage
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  coverage:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Install tarpaulin
+        uses: taiki-e/install-action@cargo-tarpaulin
+
+      - name: Generate coverage
+        run: >-
+          cargo tarpaulin --locked --out Xml --output-dir ./coverage
+          --timeout 1200 --follow-exec --fail-under 50
+
+      - name: Report coverage summary
+        run: |
+          echo "## Coverage Report" >> $GITHUB_STEP_SUMMARY
+          echo "Coverage report generated and uploaded as artifact." >> $GITHUB_STEP_SUMMARY
+
+      - name: Upload coverage report
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: ./coverage/cobertura.xml
+          retention-days: 30

ries_rs-1.0.1/.github/workflows/release.yml

@@ -0,0 +1,259 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  build-binaries:
+    name: Build ${{ matrix.target }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - target: x86_64-unknown-linux-gnu
+            os: ubuntu-latest
+            artifact: ries-rs-linux-x86_64
+          - target: x86_64-apple-darwin
+            os: macos-latest
+            artifact: ries-rs-macos-x86_64
+          - target: aarch64-apple-darwin
+            os: macos-latest
+            artifact: ries-rs-macos-aarch64
+          - target: x86_64-pc-windows-msvc
+            os: windows-latest
+            artifact: ries-rs-windows-x86_64.exe
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: ${{ matrix.target }}
+
+      - name: Build
+        run: cargo build --release --locked --target ${{ matrix.target }}
+
+      - name: Package (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          cd target/${{ matrix.target }}/release
+          strip ries-rs || true
+          tar -czvf ${{ matrix.artifact }}.tar.gz ries-rs
+
+      - name: Package (Windows)
+        if: runner.os == 'Windows'
+        run: |
+          cd target/${{ matrix.target }}/release
+          7z a ${{ matrix.artifact }}.zip ries-rs.exe
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.artifact }}
+          path: target/${{ matrix.target }}/release/${{ matrix.artifact }}.*
+
+  build-wasm:
+    name: Build WASM
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Rust (nightly + wasm32)
+        uses: dtolnay/rust-toolchain@nightly
+        with:
+          targets: wasm32-unknown-unknown
+          components: rust-src
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install wasm-pack
+        run: curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh
+
+      - name: Install Node dependencies
+        run: npm install --no-fund --no-audit
+
+      - name: Build WASM
+        run: npm run build:all
+        env:
+          CI: true
+
+      - name: Package WASM
+        run: tar -czvf ries-rs-wasm.tar.gz pkg pkg-node pkg-bundler
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ries-rs-wasm
+          path: ries-rs-wasm.tar.gz
+
+  build-python:
+    name: Build Python Wheels
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: x86_64
+          - os: macos-latest
+            target: aarch64
+          - os: windows-latest
+            target: x86_64
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Build wheel
+        uses: PyO3/maturin-action@v1
+        with:
+          command: build
+          args: --release --locked --out dist
+          target: ${{ matrix.target }}
+          working-directory: ries-py
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-wheel-${{ matrix.os }}
+          path: ries-py/dist/*.whl
+
+  build-python-sdist:
+    name: Build Python sdist
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+          working-directory: ries-py
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-sdist
+          path: ries-py/dist/*.tar.gz
+
+  publish-crate:
+    name: Publish crate to crates.io
+    needs: [build-binaries, build-wasm, build-python, build-python-sdist]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Read crate version
+        id: crate_meta
+        shell: bash
+        run: |
+          VERSION=$(cargo metadata --no-deps --format-version 1 | python3 -c 'import json, sys; data=json.load(sys.stdin); print(next(pkg["version"] for pkg in data["packages"] if pkg["name"] == "ries"))')
+          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
+
+      - name: Check crates.io for existing version
+        id: crate_exists
+        shell: bash
+        run: |
+          if curl --fail --silent --show-error "https://crates.io/api/v1/crates/ries/${{ steps.crate_meta.outputs.version }}" > /dev/null; then
+            echo "exists=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "exists=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Publish crate
+        if: steps.crate_exists.outputs.exists != 'true'
+        run: cargo publish --locked
+        env:
+          CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
+
+      - name: Note skipped crate publish
+        if: steps.crate_exists.outputs.exists == 'true'
+        run: echo "ries ${{ steps.crate_meta.outputs.version }} is already published on crates.io; skipping upload."
+
+  publish-python:
+    name: Publish Python distributions to PyPI
+    needs: [build-python, build-python-sdist]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/ries-rs/
+    steps:
+      - name: Download wheel artifacts
+        uses: actions/download-artifact@v4
+        with:
+          pattern: python-wheel-*
+          path: python-dist
+          merge-multiple: true
+
+      - name: Download sdist artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: python-sdist
+          path: python-dist
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: python-dist
+          skip-existing: true
+
+  create-release:
+    name: Create Release
+    needs: [build-binaries, build-wasm, build-python, build-python-sdist, publish-crate, publish-python]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+
+      - name: Display structure of downloaded files
+        run: ls -la artifacts/
+
+      - name: Select release notes
+        id: release_notes
+        shell: bash
+        run: |
+          BODY_PATH=".github/release-template.md"
+          if [ -f "docs/releases/${GITHUB_REF_NAME}.md" ]; then
+            BODY_PATH="docs/releases/${GITHUB_REF_NAME}.md"
+          fi
+          echo "body_path=${BODY_PATH}" >> "$GITHUB_OUTPUT"
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: |
+            artifacts/**/*
+          body_path: ${{ steps.release_notes.outputs.body_path }}

ries_rs-1.0.1/.gitignore

@@ -0,0 +1,63 @@
+# Rust build artifacts
+/target/
+/ries-py/target/
+**/*.rs.bk
+
+# Python artifacts
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.pytest_cache/
+.coverage
+build/
+dist/
+.venv/
+venv/
+env/
+
+# Node.js and WASM artifacts
+node_modules/
+package-lock.json
+pkg/
+*.wasm
+test_wasm.js
+
+# IDE and editor files
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Debug and profiling
+*.dSYM/
+*.profraw
+
+# Temporary files
+*.tmp
+*.bak
+test-results/
+output/
+playwright-report/
+.playwright-mcp/
+.codex-playwright/
+
+# Local assistant config
+.claude/
+CLAUDE.md
+.claude/settings.local.json
+
+# Local cargo config
+.cargo/
+
+# Local binaries
+rust_out
+
+# Tool backups
+Cargo.toml.orig
+
+# Git worktrees
+.worktrees/
+repomix-output.xml

ries_rs-1.0.1/.zenodo.json

@@ -0,0 +1,78 @@
+{
+  "title": "ries-rs: A Rust Implementation of the RIES Inverse Equation Solver",
+  "description": "ries-rs is a Rust implementation of Robert Munafo's RIES (RILYBOT Inverse Equation Solver). Given a numeric target value, it searches for algebraic equations that have the target as a solution. Features include parallel search, automatic differentiation for Newton–Raphson refinement, user-defined constants and functions, multiple output formats, and domain-specific presets for mathematics, physics, and number theory.",
+  "license": {
+    "id": "MIT"
+  },
+  "keywords": [
+    "inverse symbolic calculator",
+    "equation solver",
+    "algebraic equations",
+    "experimental mathematics",
+    "mathematical constants",
+    "PSLQ",
+    "integer relations",
+    "Newton-Raphson",
+    "automatic differentiation",
+    "Rust"
+  ],
+  "creators": [
+    {
+      "name": "Santoro, Maxwell",
+      "orcid": "0009-0004-9354-0993",
+      "affiliation": "Independent"
+    }
+  ],
+  "contributors": [
+    {
+      "name": "Munafo, Robert",
+      "type": "Other",
+      "affiliation": "Author of original RIES"
+    },
+    {
+      "name": "Shoulson, Mark",
+      "type": "Other",
+      "affiliation": "Maintainer of the clsn/ries GitHub mirror + enhancements"
+    }
+  ],
+  "related_identifiers": [
+    {
+      "identifier": "https://github.com/maxwellsantoro/ries-rs",
+      "relation": "isSupplementTo",
+      "resource_type": "software",
+      "scheme": "url"
+    },
+    {
+      "identifier": "https://www.mrob.com/pub/ries/",
+      "relation": "isDerivedFrom",
+      "resource_type": "software",
+      "scheme": "url"
+    },
+    {
+      "identifier": "https://github.com/clsn/ries",
+      "relation": "isDerivedFrom",
+      "resource_type": "software",
+      "scheme": "url"
+    }
+  ],
+  "references": [
+    "Munafo, R. (2010). RIES - Find Algebraic Equations, Given Their Solution. https://www.mrob.com/pub/ries/",
+    "Ferguson, H.R.P., & Bailey, D.H. (1992). A Polynomial Time, Numerically Stable Integer Relation Algorithm. RNR-91-032.",
+    "Stoutemyer, D.R. (2024). Computing with No Machine Constants, Only Constructive Axioms. arXiv:2402.03304"
+  ],
+  "grants": [],
+  "subjects": [
+    {
+      "term": "Computer Science - Symbolic Computation",
+      "identifier": "cs.SC"
+    },
+    {
+      "term": "Mathematics - Number Theory",
+      "identifier": "math.NT"
+    }
+  ],
+  "language": "eng",
+  "access_right": "open",
+  "upload_type": "software",
+  "notes": "This software implements an inverse symbolic calculator similar to the original RIES by Robert Munafo. It can find algebraic equations given their numeric solutions, making it useful for experimental mathematics, physics, and number theory research. The implementation includes PSLQ integer relation detection, stability analysis for impostor detection, and high-precision verification."
+}