Feature rustler precompiled

[ocean]

Summary by CodeRabbit

• New Features

  • Deliver precompiled native libraries for macOS and Linux (x86_64, aarch64), built automatically on tags and via manual dispatch.

• Chores

  • Added CI workflow to build, upload and publish precompiled artifacts on release.
  • Introduced a release build profile with LTO for optimized binaries.
  • Added an environment toggle to force local native builds and improved cross-compilation support.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Walkthrough

Adds precompiled NIF distribution: GitHub Actions workflow to build and publish precompiled Rust NIFs, switches Elixir loader to RustlerPrecompiled, adjusts build/config for cross-compilation, and exposes ECTO_LIBSQL_BUILD to CI to optionally force local NIF builds.

Changes

Cohort / File(s)	Summary
GitHub Actions Workflows .github/workflows/ci.yml, .github/workflows/release.yml	Adds ECTO_LIBSQL_BUILD env in CI and a release.yml workflow ("Build Precompiled NIFs") to build NIFs on tag/manual dispatch using a target matrix, validate mix.exs version vs tag, install Rust toolchains, run rustler-precompiled-action, upload artifacts, and publish archives on tag builds.
Elixir NIF loader & mix config lib/ecto_libsql/native.ex, mix.exs	Replaces Rustler with RustlerPrecompiled and configures otp_app, crate, version, base_url (GitHub releases), targets, nif_versions, mode (dev/test => :debug, else :release), and force_build driven by ECTO_LIBSQL_BUILD. Makes rustler optional, adds rustler_precompiled dependency, introduces @dev? and @force_build? attributes, and expands package files list.
Workspace & Rust build config Cargo.toml, native/ecto_libsql/Cargo.toml, native/ecto_libsql/.cargo/config.toml	Enables thin LTO in workspace release profile. Updates rustler dependency to 0.37.1 with default-features = false and features derive and nif_version_2_15. Adds per-target rustflags for macOS (allow undefined symbols) and musl targets (disable crt-static) to support cross-compilation for BEAM loading.

Sequence Diagram(s)

sequenceDiagram
  rect rgba(135,206,250,0.5)
    participant Dev
    participant GH_Actions as "GitHub Actions (release.yml)"
    participant Rust_Toolchain as "Rust toolchain"
    participant Rustler_Action as "rustler-precompiled-action"
    participant GH_Releases as "GitHub Releases"
  end

  rect rgba(144,238,144,0.5)
    participant Elixir_App as "Elixir app runtime"
    participant GH as "GitHub (download)"
    participant NIF as "Precompiled NIF artifact"
  end

  Dev->>GH_Actions: Push tag / manual dispatch
  GH_Actions->>Rust_Toolchain: Install target toolchains
  GH_Actions->>Rustler_Action: Build NIFs for matrix targets
  Rustler_Action->>GH_Releases: Upload artifacts
  GH_Releases-->>GH_Actions: Release published

  Note over Elixir_App,GH: At runtime
  Elixir_App->>GH: Request precompiled NIF (base_url)
  GH->>Elixir_App: Serve artifact
  Elixir_App->>NIF: Load precompiled NIF via RustlerPrecompiled

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

🐰 I hopped through CI with a tiny cheer,
I fetched prebuilt NIFs from releases near,
Tags set the pace, targets wide,
Cross-built crates now at my side,
🥕 — a rabbit's nibble of deploy-time cheer.

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarises the main change: introducing Rustler Precompiled support across the codebase, which is evident from the modifications to NIF loading, workflow automation, and build configuration.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feature-rustler-precompiled

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In @.github/workflows/release.yml:
- Around line 40-50: The workflow currently extracts mix.exs into the VERSION
variable and writes PROJECT_VERSION to GITHUB_ENV but doesn’t check the git tag
— add a guard that derives the pushed tag (from GITHUB_REF or GITHUB_REF_NAME)
and compares it to VERSION; if they differ, emit an error and exit non‑zero so
the job fails fast, and only export PROJECT_VERSION when the tag matches the
extracted VERSION. Reference the existing VERSION variable, the environment ref
(GITHUB_REF / GITHUB_REF_NAME), and PROJECT_VERSION in your fix.

[coderabbitai]

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In @.github/workflows/release.yml:
- Around line 32-55: The version check fails for workflow_dispatch because
GITHUB_REF_NAME is a branch name; update the validation to first detect tags by
checking GITHUB_REF (e.g., only run the tag-vs-mix.exs comparison when
GITHUB_REF starts with "refs/tags/"). In the shell block that extracts VERSION,
add a conditional using GITHUB_REF to skip the tag comparison when not a tag
(keep setting PROJECT_VERSION and printing a message), otherwise proceed with
the existing GIT_TAG/TAG_VERSION comparison logic (variables VERSION, GIT_TAG,
TAG_VERSION) and error/exit on mismatch.