Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/firefighterduck/kissat-rs
Rust bindings for the Kissat SAT solver.
https://github.com/firefighterduck/kissat-rs
Last synced: about 1 month ago
JSON representation
Rust bindings for the Kissat SAT solver.
- Host: GitHub
- URL: https://github.com/firefighterduck/kissat-rs
- Owner: firefighterduck
- License: mit
- Created: 2021-04-25T19:21:42.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2023-02-22T10:09:42.000Z (over 1 year ago)
- Last Synced: 2024-02-10T13:09:43.668Z (5 months ago)
- Language: Rust
- Homepage: http://fmv.jku.at/kissat/
- Size: 23.4 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-rust-formalized-reasoning - Kissat-rs - bindings for the Kissat SAT solver. (Projects / Libraries)
README
# Kissat-rs: High-level Rust bindings to the Kissat SAT solver
This crate provides high-level access to the [Kissat SAT solver](http://fmv.jku.at/kissat/).
It builds directly on the lower-level crate [kissat-sys](https://github.com/firefighterduck/kissat-rs/tree/main/kissat-sys).
# Usage
Add the folling lines to your Cargo.toml:
```toml
[dependencies]
kissat-rs = { git = "https://github.com/firefighterduck/kissat-rs", branch = "main", version = "0.1" }
```
## API Usage
Kissat-rs exposes a subset of the provided functionalities of Kissat through safe Rust functions on a `Solver` type that wraps the actual Kissat solver.
`Solver` encodes the internal Kissat solver state in accordance to the IPASIR interface as type-checked state objects that are passed between function calls and guarantee that no function call can lead to undefined states.
For example, it is not possible to access the assigned value of a literal when the solver hasn't found a satisfying assignment for a call to solve.
The `Solver` type also provides convenience methods to solve whole formulae without dealing with the solver state.
## Example
```rust
// Define three literals used in both formulae.
let x = 1;
let y = 2;
let z = 3;
// Construct a formula from clauses (i.e. an iterator over literals).
// (~x || y) && (~y || z) && (x || ~z) && (x || y || z)
let formula1 = vec![vec![-x, y], vec![-y, z], vec![x, -z], vec![x, y, z]];
let satisfying_assignment = Solver::solve_formula(formula1).unwrap();
// The formula from above is satisfied by the assignment: x -> True, y -> True, z -> True
if let Some(assignments) = satisfying_assignment {
assert_eq!(assignments.get(&x).unwrap(), &Some(Assignment::True));
assert_eq!(assignments.get(&y).unwrap(), &Some(Assignment::True));
assert_eq!(assignments.get(&z).unwrap(), &Some(Assignment::True));
}
// (x || y || ~z) && ~x && (x || y || z) && (x || ~y)
let formula2 = vec![vec![x, y, -z], vec![-x], vec![x, y, z], vec![x, -y]];
let unsat_result = Solver::solve_formula(formula2).unwrap();
// The second formula is unsatisfiable.
// This can for example be proved by resolution.
assert_eq!(unsat_result, None);
```
# Scope and Development
This crate is supposed to be a simple example of how a Rust interface for Kissat could be implemented.
It doesn't aim at covering all of Kissats API for now.
# Known Problems
Kissat does not build with mold.
If you use mold to build your rust projects you have to disable it for building kissat-rs and any crates using it.
Unfortunately, a crate local rustflag that would set a different linker does not help.
# License
Kissat-rs is licensed under the [MIT license](./LICENSE) in the same way as Kissat is.