mirror of
https://github.com/Z3Prover/z3
synced 2025-10-31 19:52:29 +00:00
31 lines
1.7 KiB
Markdown
31 lines
1.7 KiB
Markdown
# Julia bindings
|
|
|
|
The Julia package [Z3.jl](https://github.com/ahumenberger/Z3.jl) provides and interface to Z3 by exposing its C API.
|
|
|
|
A previous version exposed the C++ API via [CxxWrap.jl](https://github.com/JuliaInterop/CxxWrap.jl). The bindings therefore consisted of a [C++ part](z3jl.cpp) and a [Julia part](https://github.com/ahumenberger/Z3.jl). The C++ part defines the Z3 types/methods which are exposed. The resulting library is loaded in the Julia part via CxxWrap.jl which creates the corresponding Julia types/methods.
|
|
|
|
## Building the C++ part
|
|
|
|
In order to build the Julia bindings the build option `Z3_BUILD_JULIA_BINDINGS` has to be enabled via CMake and [libcxxwrap-julia](https://github.com/JuliaInterop/libcxxwrap-julia) has to be present. Infos about obtaining the libcxxwrap prefix can be found [here](https://github.com/JuliaInterop/CxxWrap.jl#compiling-the-c-code).
|
|
|
|
```
|
|
mkdir build && cd build
|
|
cmake -DCMAKE_BUILD_TYPE=Release -DZ3_BUILD_JULIA_BINDINGS=True -DCMAKE_PREFIX_PATH=/path/to/libcxxwrap-julia-prefix ..
|
|
make
|
|
```
|
|
|
|
## Julia part
|
|
|
|
The Z3 binaries are provided to [Z3.jl](https://github.com/ahumenberger/Z3.jl) via [z3_jll.jl](https://github.com/JuliaBinaryWrappers/z3_jll.jl).
|
|
That is, in order to propagate any C++ changes to the Julia side, one has to:
|
|
1. Release a new version of Z3.
|
|
2. Update the corresponding [build script](https://github.com/JuliaPackaging/Yggdrasil/tree/master/Z/z3) to use the new Z3 release.
|
|
|
|
### Using the compiled version of Z3
|
|
|
|
The binaries are managed via the JLL package z3_jll. To use your own binaries, you need to set up an overrides file, by default at `~/.julia/artifacts/Overrides.toml` with the following content:
|
|
|
|
```toml
|
|
[1bc4e1ec-7839-5212-8f2f-0d16b7bd09bc]
|
|
z3 = "/path/to/z3/build"
|
|
```
|