z3rs 0.0.6

A pure-Rust port of the Z3 theorem prover, free of third-party and native dependencies
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

//! # `util` — Foundation: numerals, containers, hashtables, symbols, vectors, params infra, rlimit, memory, sexpr
//!
//! **Port phase 0.** Ported from the Z3 C++ `util` component.
//! See [`ROADMAP.md`](../../ROADMAP.md) for the porting plan and status.
//!
//! ## Numerals
//!
//! Z3's **entire** `util` numeral stack is provided by our first-party,
//! dependency-free [`puremp`](https://github.com/KarpelesLab/puremp) crate, used
//! directly throughout z3rs (also re-exported as [`crate::puremp`]) — no wrapper
//! layer. The mapping from Z3's numeral types:
//!
//! | Z3 `util`                     | `puremp`               |
//! |-------------------------------|------------------------|
//! | `mpn` / `mpz`                 | `Nat` / `Int`          |
//! | `mpq` / `rational`            | `Rational`             |
//! | `inf_rational` (ε-augmented)  | `InfRational`          |
//! | `mpbq` (dyadic `n·2^-k`)      | `Dyadic`               |
//! | `mpf` (software IEEE-754)     | `Float`                |
//! | `mpff` / `mpfx` (fixed prec.) | `FixedFloat`           |
//!
//! ## Upstream C++ components to port
//! - [x] `z3/src/util/{mpn,mpz,mpq,rational,inf_rational,mpbq,mpf,mpff,mpfx}`
//!   → all provided by `puremp`
//! - [x] `z3/src/util/hash.{h,cpp}` → [`hash`]
//! - [x] `z3/src/util/lbool.{h,cpp}` → [`lbool`]
//! - [x] `z3/src/util/symbol.{h,cpp}` → [`symbol`] (+ `no_std` [`sync`])
//! - [x] `z3/src/util/bit_vector.{h,cpp}` → [`bit_vector`]
//! - [x] `z3/src/util/params.{h,cpp}` → [`params`]
//! - [x] `z3/src/util/rlimit.{h,cpp}` → [`rlimit`]
//! - [x] containers/hashtables/vector (`obj_map`, `ptr_vector`, `hashtable`,
//!   `vector`, …) → provided natively by Rust's `alloc` (`BTreeMap`,
//!   `BTreeSet`, `Vec`, `String`); no port needed
//!
//! ## Status: DONE (foundation complete — numerals via `puremp`, hashing,
//! symbols, bit vectors, zstrings, params, resource limits; Rust `alloc`
//! supplies the container/vector/hashtable layer)

pub mod bit_vector;
pub mod hash;
pub mod lbool;
pub mod params;
pub mod rlimit;
pub mod symbol;
pub mod sync;
pub mod zstring;

pub use bit_vector::BitVector;
pub use lbool::LBool;
pub use params::{ParamValue, Params};
pub use rlimit::Rlimit;
pub use symbol::Symbol;
pub use zstring::Zstring;