StageSAT
A floating-point constraint solver via staged optimization. MIT licensed.
Install
Release targets: CPython 3.11–3.13 on Linux x86-64 (glibc) and macOS Apple Silicon. See PACKAGING.md for validation status and release checks.
# From the repository root:
python -m pip install ./pypi
Solving requires Clang and the running Python's development headers, including
when installed from a wheel. On macOS install Xcode Command Line Tools with
xcode-select --install. On Linux install Clang and the development package
matching your Python version (for example, python3.11-dev). Conda Python
installations normally include their headers.
Solve
stagesat input.smt2 --bench --time
# Equivalent module invocation:
python -m stagesat input.smt2 --bench --time
The command generates and compiles the objectives automatically in a private temporary directory, passes their paths to spawned optimizer processes, and removes temporary files on completion. It works outside the source checkout and allows concurrent invocations from the same directory.
--bench suppresses debug output. Standard output contains the sat/unsat
verdict followed by solver wall time in seconds when --time is present.
Compilation and verification time are excluded from this solver timing, as in
the original workflow. Diagnostics go to standard error.
stagesat input.smt2 --bench --time --jobs 4
stagesat --help
stagesat --version
--jobs defaults to the CPU count. Select a particular compiler with
--clang /path/to/clang or STAGESAT_CLANG. Compilation errors exit with status
2 and an explanation; interruption exits with status 130.
The original optimizer, thresholds, and verdict rule are preserved: a zero best
residual reports sat; otherwise the solver reports unsat. The original
verification checks produce diagnostics without changing that verdict.
Develop and release
This directory is the complete Python packaging project. The original repository's
source files are unchanged. Package metadata is in pyproject.toml, and the
single version source is src/stagesat/_version.py.
cd pypi
python -m pip install build twine
python tools/check_release.py --dependencies minimum
python tools/check_release.py --dependencies latest
These commands build distributions and test wheel and source installations in fresh environments outside the checkout. See PACKAGING.md for the dependency audit, native platform CI, and PyPI publishing instructions.
Metadata
Release files for stagesat 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| stagesat-0.1.0.tar.gz | 40.2 kB | Without provenance | Details for stagesat-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| stagesat-0.1.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl | CPython 3.11 | CPython 3.11 | Linux glibc 2.17+ x86-64 | Details for stagesat-0.1.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
Total release size: 148.8 kB
Release files / stagesat-0.1.0.tar.gz
| Download URL | stagesat-0.1.0.tar.gz |
|---|---|
| Size | 40.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
76bd8ed6070256d5b8815c01eefb9a522a0164427b7c14ffa1ca291e7efc3b98
|
|
BLAKE2b-256 checksum How to use checksums |
bb0f98726f9e6e228c784445d7c55133d48881f4207e8aa13e6567f060c8e78f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.18
|
Release files / stagesat-0.1.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
| Download URL | stagesat-0.1.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
|---|---|
| Size | 108.6 kB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
2e09b12ba3e72098369e24a9bea5331a3571d72d71491f8f0065c339c3f462ad
|
|
BLAKE2b-256 checksum How to use checksums |
43bf63b3af798630ba050a79019671005d0fc208c0171cfa9f51c086fdeafe29
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.18
|
Security for stagesat 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.