Skip to content

docs(contributing): explain running Z3-linking tests via nix develop - #5512

Merged
elezar merged 1 commit into
mainfrom
docs/contributing-nix-z3-tests
Nov 13, 2026
Merged

elezar merged 1 commit into
mainfrom
docs/contributing-nix-z3-tests

Conversation

@elezar

@elezar elezar commented Nov 12, 2026

Copy link
Copy Markdown
Member

Summary

Document how to run commands that link Z3 (for example cargo test -p openshell-server --lib) from a plain terminal, and a failure seen with the Nix shell on macOS.

Related Issue

None. Docs-only change from an author with write access.

Changes

  • Note that linking fails with ld: library 'z3' not found outside the Nix shell, and show nix develop --command cargo test ....
  • Explain that RUSTC_WRAPPER=sccache from mise.toml resolves to a mise shim with no installed sccache, which fails every crate compile with "Set a global default version with one of the following:". Suggest mise install or clearing RUSTC_WRAPPER for the command.

Testing

  • Docs-only change; no code affected

Signed-off-by: Evan Lezar <elezar@nvidia.com>
@github-actions github-actions Bot added the state:accepted A maintainer decided OpenShell should pursue this issue label Nov 12, 2026
@elezar elezar added the area:build CI/CD workflows, releases, build targets, packaging, and artifact publication. label Nov 12, 2026
@elezar
elezar added this pull request to the merge queue Nov 13, 2026
Merged via the queue into main with commit 8f3acec Nov 13, 2026
96 checks passed
@elezar
elezar deleted the docs/contributing-nix-z3-tests branch November 13, 2026 10:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:build CI/CD workflows, releases, build targets, packaging, and artifact publication. state:accepted A maintainer decided OpenShell should pursue this issue

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants