arity 0.2.0__tar.gz

arity-0.2.0/.gitattributes

@@ -0,0 +1,14 @@
+# Let Git auto-detect text files
+* text=auto
+
+# R fixtures should use LF by default for consistent snapshots
+tests/fixtures/**/*.R eol=lf
+
+# Snapshot files should always use LF
+tests/**/snapshots/**/* eol=lf
+
+# Preserve line ending fixtures as-is (CRLF/LF)
+tests/fixtures/parser/crlf_*/* -text
+tests/fixtures/parser/lf_*/* -text
+tests/fixtures/parser/*_crlf_*/* -text
+tests/fixtures/parser/*_lf_*/* -text

arity-0.2.0/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: jolars

arity-0.2.0/.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: "cargo"
+    directory: "/"
+    schedule:
+      interval: "weekly"

arity-0.2.0/.github/workflows/build-and-test.yml

@@ -0,0 +1,108 @@
+name: Build and Test
+
+on:
+  workflow_dispatch:
+  workflow_call:
+  pull_request:
+  push:
+    branches:
+      - main
+  schedule:
+    - cron: "0 3 * * *"
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  test:
+    if: github.event_name != 'schedule'
+    name: Test
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        rust: [stable]
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@master
+        with:
+          toolchain: ${{ matrix.rust }}
+          targets: wasm32-unknown-unknown
+
+      - name: Cache cargo registry
+        uses: actions/cache@v5
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-
+
+      - name: Build
+        run: cargo build --verbose
+
+      - name: Run tests
+        run: cargo test --verbose
+
+  cargo-audit:
+    name: Cargo Audit
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      checks: write
+    steps:
+      - uses: actions/checkout@v6
+      - uses: rustsec/audit-check@v2
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+  cargo-deny:
+    name: Cargo Deny
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      checks: write
+    steps:
+      - uses: actions/checkout@v6
+      - uses: EmbarkStudios/cargo-deny-action@v2
+
+  versionary:
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    needs: [test, cargo-audit, cargo-deny]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+      issues: write
+    outputs:
+      release_created: ${{ steps.versionary.outputs.release_created }}
+      tag_name: ${{ steps.versionary.outputs.tag_name }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+          token: ${{ secrets.RELEASE_TOKEN }}
+
+      - uses: dtolnay/rust-toolchain@stable
+
+      - id: versionary
+        uses: jolars/versionary@v0
+        with:
+          github-token: ${{ secrets.RELEASE_TOKEN }}
+
+  build-release-assets:
+    name: Build & Upload Release Assets
+    needs: versionary
+    if: ${{ needs.versionary.outputs.release_created == 'true' }}
+    uses: ./.github/workflows/packages.yml
+    with:
+      upload: "true"
+      tag: ${{ needs.versionary.outputs.tag_name }}
+    permissions:
+      contents: write

arity-0.2.0/.github/workflows/cran-symbols.yml

@@ -0,0 +1,91 @@
+name: Refresh CRAN symbols
+
+# Regenerates the bundled CRAN export lists (src/semantic/cran/exports.txt) that
+# back the `BundledPackages` symbol provider, then opens a PR with the changes.
+#
+# Ranking comes from the RStudio/Posit CRAN download logs (top-N by downloads);
+# the listed packages are installed from Posit Public Package Manager binaries
+# and their exported names dumped. Installs are best-effort: a package that
+# can't be installed or loaded is skipped (the build still works, that package
+# just stays unresolved until next time).
+
+on:
+  workflow_dispatch:
+    inputs:
+      top_n:
+        description: "Number of top packages to bundle"
+        default: "500"
+      days:
+        description: "Number of recent CRAN-log days to rank over"
+        default: "7"
+  schedule:
+    # Weekly, Monday 04:00 UTC.
+    - cron: "0 4 * * 1"
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  refresh:
+    name: Refresh bundled exports
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Setup R
+        uses: r-lib/actions/setup-r@v2
+        with:
+          use-public-rspm: true # Posit PPM: precompiled binaries, fast installs
+
+      - name: Install pak
+        uses: r-lib/actions/setup-r-dependencies@v2
+        with:
+          packages: pak
+
+      - name: Rank top packages from CRAN logs
+        run: scripts/rank_cran_downloads.sh "${{ inputs.top_n || '500' }}" "${{ inputs.days || '7' }}"
+
+      - name: Install the top packages (best-effort, with system requirements)
+        run: |
+          Rscript - <<'EOF'
+          lines <- trimws(readLines("scripts/cran_top_packages.txt", warn = FALSE))
+          pkgs <- lines[nzchar(lines) & !startsWith(lines, "#")]
+          pkgs <- setdiff(pkgs, rownames(installed.packages()))
+          # pak resolves dependencies + apt system requirements and uses PPM
+          # binaries. Install in chunks for speed; if a chunk fails as a whole
+          # (one unsatisfiable package aborts pak's transaction), retry its
+          # packages individually so the other 24 aren't dropped with it.
+          install <- function(p) pak::pkg_install(p, ask = FALSE, dependencies = TRUE)
+          for (chunk in split(pkgs, ceiling(seq_along(pkgs) / 25))) {
+            tryCatch(install(chunk), error = function(e) {
+              message("chunk failed, retrying individually: ", conditionMessage(e))
+              for (p in chunk) {
+                tryCatch(install(p), error = function(e2) message("  skip ", p, ": ", conditionMessage(e2)))
+              }
+            })
+          }
+          EOF
+
+      - name: Dump exported names
+        run: Rscript scripts/dump_cran_symbols.R
+
+      - name: Open PR
+        uses: peter-evans/create-pull-request@v7
+        with:
+          branch: chore/refresh-cran-symbols
+          commit-message: "chore(symbols): refresh bundled CRAN export lists"
+          title: "chore(symbols): refresh bundled CRAN export lists"
+          body: |
+            Automated refresh of the bundled CRAN export lists.
+
+            - Package set: top-N by downloads from the RStudio/Posit CRAN logs
+              (`scripts/cran_top_packages.txt`).
+            - Exports dumped from PPM-binary installs
+              (`src/semantic/cran/exports.txt`).
+
+            Installs are best-effort; any package skipped this run will be
+            picked up once it installs cleanly. Generated by
+            `.github/workflows/cran-symbols.yml`.
+          labels: dependencies
+          delete-branch: true

arity-0.2.0/.github/workflows/docs.yml

@@ -0,0 +1,70 @@
+name: Documentation
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+    tags:
+      - "v*"
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  docs:
+    name: Build Documentation
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+
+      - uses: r-lib/actions/setup-r@v2
+        with:
+          use-public-rspm: true
+
+      - name: Set up Quarto
+        uses: quarto-dev/quarto-actions/setup@v2
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Restore timestamps
+        uses: chetan/git-restore-mtime-action@v2
+
+      - name: Render Quarto Project
+        uses: quarto-dev/quarto-actions/render@v2
+        with:
+          path: docs
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v6
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v5
+        with:
+          path: docs/_site
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v5
+
+  lighthouse:
+    name: Lighthouse Audit
+    needs: docs
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Audit URLs using Lighthouse
+        run: npx unlighthouse-ci --site https://arity.cc --build-static

arity-0.2.0/.github/workflows/lint.yml

@@ -0,0 +1,58 @@
+name: Lint
+
+on:
+  workflow_dispatch:
+  workflow_call:
+  pull_request:
+  push:
+    branches:
+      - main
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  clippy:
+    name: Clippy
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@master
+        with:
+          components: rustfmt, clippy
+          toolchain: stable
+
+      - name: Cache cargo registry
+        uses: actions/cache@v5
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-
+
+      - name: Build
+        run: cargo build --verbose
+
+      - name: Run clippy
+        run: cargo clippy -- -D warnings
+
+      - name: Check formatting
+        run: cargo fmt -- --check
+
+  panache:
+    name: Panache
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: jolars/panache-action@v1

arity-0.2.0/.github/workflows/packages.yml

@@ -0,0 +1,180 @@
+name: Build Release Binaries
+
+on:
+  workflow_call:
+    inputs:
+      upload:
+        description: "Upload to release (requires a release to exist)"
+        required: false
+        default: "false"
+        type: string
+      tag:
+        description: "Release tag to upload to (only if upload is true)"
+        required: false
+        type: string
+  workflow_dispatch:
+    inputs:
+      upload:
+        description: "Upload to release (requires a release to exist)"
+        required: false
+        default: "false"
+        type: choice
+        options:
+          - "true"
+          - "false"
+      tag:
+        description: "Release tag to upload to (only if upload is true)"
+        required: false
+        type: string
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  build-binaries:
+    name: Build ${{ matrix.target }}
+    runs-on: ${{ matrix.os }}
+    permissions:
+      contents: write
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          # Linux x86_64 (glibc) — built with cargo-zigbuild against an old
+          # glibc floor so the binary runs on distros older than the runner.
+          - target: x86_64-unknown-linux-gnu
+            os: ubuntu-latest
+            glibc: "2.17"
+
+          # Linux ARM64 (glibc)
+          - target: aarch64-unknown-linux-gnu
+            os: ubuntu-24.04-arm
+            glibc: "2.17"
+
+          # Linux x86_64 (musl)
+          - target: x86_64-unknown-linux-musl
+            os: ubuntu-latest
+
+          # Linux ARM64 (musl)
+          - target: aarch64-unknown-linux-musl
+            os: ubuntu-24.04-arm
+
+          # macOS x86_64
+          - target: x86_64-apple-darwin
+            os: macos-15-intel
+
+          # macOS ARM64 (Apple Silicon)
+          - target: aarch64-apple-darwin
+            os: macos-latest
+
+          # Windows x86_64
+          - target: x86_64-pc-windows-msvc
+            os: windows-latest
+
+          # Windows ARM64
+          - target: aarch64-pc-windows-msvc
+            os: windows-11-arm
+
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ inputs.tag || github.ref }}
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: ${{ matrix.target }}
+
+      - name: Cache Rust artifacts
+        uses: Swatinem/rust-cache@v2
+        with:
+          cache-bin: "false"
+          prefix-key: "v1-rust"
+
+      - name: Install musl toolchain
+        if: endsWith(matrix.target, '-unknown-linux-musl')
+        run: sudo apt-get update && sudo apt-get install -y musl-tools
+
+      # Pin the glibc symbol-version floor (link-time only; the binary still
+      # uses the host's glibc at runtime) so it runs on distros older than the
+      # CI runner.
+      - name: Install Zig
+        if: matrix.glibc
+        uses: mlugg/setup-zig@v2
+        with:
+          version: 0.14.1
+
+      - name: Install cargo-zigbuild
+        if: matrix.glibc
+        run: cargo install --locked cargo-zigbuild
+
+      - name: Build release binary (zigbuild)
+        if: matrix.glibc
+        run: cargo zigbuild --release --target ${{ matrix.target }}.${{ matrix.glibc }}
+
+      - name: Build release binary
+        if: ${{ !matrix.glibc }}
+        run: cargo build --release --target ${{ matrix.target }}
+
+      # Regression guard: fail if the binary ever requires a glibc newer than
+      # the declared floor.
+      - name: Verify glibc floor
+        if: matrix.glibc
+        run: |
+          set -euo pipefail
+          bin="target/${{ matrix.target }}/release/arity"
+          max=$(objdump -T "$bin" 2>/dev/null \
+            | grep -oE 'GLIBC_[0-9]+(\.[0-9]+)+' \
+            | sed 's/GLIBC_//' | sort -V | tail -n1 || true)
+          echo "Highest required glibc symbol: ${max:-none}"
+          if [ -n "$max" ] && [ "$(printf '%s\n%s\n' "$max" "${{ matrix.glibc }}" | sort -V | tail -n1)" != "${{ matrix.glibc }}" ]; then
+            echo "::error::arity requires glibc $max, above the ${{ matrix.glibc }} floor"
+            exit 1
+          fi
+
+      - name: Strip binary (Unix)
+        if: runner.os != 'Windows'
+        run: strip target/${{ matrix.target }}/release/arity
+
+      - name: Create archive (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          mkdir -p dist
+          cp target/${{ matrix.target }}/release/arity dist/
+          cp LICENSE dist/
+          cp README.md dist/
+          tar czf arity-${{ matrix.target }}.tar.gz -C dist .
+          rm -rf dist
+
+      - name: Create archive (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          New-Item -ItemType Directory -Path dist -Force
+          Copy-Item target/${{ matrix.target }}/release/arity.exe dist/
+          Copy-Item LICENSE dist/
+          Copy-Item README.md dist/
+          Compress-Archive -Path dist/* -DestinationPath arity-${{ matrix.target }}.zip
+          Remove-Item -Recurse -Force dist
+
+      - name: Upload archive artifact
+        uses: actions/upload-artifact@v7
+        with:
+          name: arity-${{ matrix.target }}
+          path: |
+            arity-${{ matrix.target }}.tar.gz
+            arity-${{ matrix.target }}.zip
+
+      - name: Upload binary to release
+        if: inputs.upload == 'true'
+        shell: bash
+        run: |
+          TAG="${{ inputs.tag }}"
+          if [ -f arity-${{ matrix.target }}.tar.gz ]; then
+            gh release upload --clobber "$TAG" arity-${{ matrix.target }}.tar.gz
+          fi
+          if [ -f arity-${{ matrix.target }}.zip ]; then
+            gh release upload --clobber "$TAG" arity-${{ matrix.target }}.zip
+          fi
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

arity-0.2.0/.github/workflows/publish-pypi.yml

@@ -0,0 +1,127 @@
+name: Publish PyPI
+
+on:
+  workflow_dispatch:
+    inputs:
+      repository:
+        description: "Target repository"
+        required: true
+        default: "pypi"
+        type: choice
+        options:
+          - pypi
+          - testpypi
+  push:
+    tags:
+      - "v*"
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  build-wheels:
+    name: Build wheel ${{ matrix.target }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - target: x86_64-unknown-linux-gnu
+            os: ubuntu-latest
+            manylinux: auto
+          - target: aarch64-unknown-linux-gnu
+            os: ubuntu-24.04-arm
+            manylinux: auto
+          - target: x86_64-unknown-linux-musl
+            os: ubuntu-latest
+            manylinux: musllinux_1_2
+          - target: aarch64-unknown-linux-musl
+            os: ubuntu-24.04-arm
+            manylinux: musllinux_1_2
+          - target: x86_64-apple-darwin
+            os: macos-15-intel
+            manylinux: ""
+          - target: aarch64-apple-darwin
+            os: macos-latest
+            manylinux: ""
+          - target: x86_64-pc-windows-msvc
+            os: windows-latest
+            manylinux: ""
+          - target: aarch64-pc-windows-msvc
+            os: windows-11-arm
+            manylinux: ""
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install Rust (non-Linux)
+        if: runner.os != 'Linux'
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: ${{ matrix.target }}
+
+      - name: Cache Rust artifacts
+        if: runner.os != 'Linux'
+        uses: Swatinem/rust-cache@v2
+        with:
+          key: ${{ matrix.target }}
+          cache-bin: "false"
+          prefix-key: "v1-rust"
+
+      - name: Build wheel
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          manylinux: ${{ matrix.manylinux }}
+          args: --release --out dist
+
+      - name: Upload wheel artifact
+        uses: actions/upload-artifact@v7
+        with:
+          name: wheel-${{ matrix.target }}
+          path: dist/*.whl
+
+  build-sdist:
+    name: Build sdist
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+
+      - name: Upload sdist artifact
+        uses: actions/upload-artifact@v7
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+
+  publish:
+    name: Publish to ${{ github.event.inputs.repository || 'pypi' }}
+    needs: [build-wheels, build-sdist]
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v8
+        with:
+          path: dist
+          merge-multiple: true
+
+      - name: Publish to PyPI
+        if: github.event.inputs.repository != 'testpypi'
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+      - name: Publish to TestPyPI
+        if: github.event.inputs.repository == 'testpypi'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/