README.md
November 16, 2024 ยท View on GitHub
This is ViperServer, an HTTP server that manages verification requests to different tools from the Viper tool stack.
The main two Viper tools (a.k.a verification backends) currently are:
- Carbon, a verification condition generation (VCG) backend for the Viper language.
- Silicon, a symbolic execution verification backend.
The Purpose of ViperServer
- Viper IDE: integration of Viper into Visual Studio Code (VS Code). Viper IDE provides the best user experience for Viper. More details here: http://viper.ethz.ch/downloads/
- Facilitate the development of verification IDEs for Viper frontends, such as:
- Avoid 1-3 second delays caused by JVM startup time. ViperServer offers a robust alternative to, e.g., Nailgun.
- Develop Viper encodings more efficiently with caching.
- Interact with Viper tools programmatically using the HTTP API. A reference client implementation (in Python) is available via viper_client.
For more details about using Viper, please visit: http://viper.ethz.ch/downloads/
Installation Instructions
-
Clone viperserver (this repository) in your computer.
-
Execute
git submodule update --init --recursivein the cloned directory to fetch thecarbon,silicon, and (transitively) thesilverrepositories. Note that bothcarbonandsiliconhave asilversubmodule. Even thoughsilicon'ssilverrepository is actually used for compilation of ViperServer, we assume that both reference the samesilvercommit. -
Compile by typing:
sbt compile -
Other supported SBT commands are:
sbt stage(produces fine-grained jar files),sbt assembly(produces a single fat jar file).
Running Tests
-
Set the environment variable
Z3_EXEto an executable of a recent version of Z3. -
Set the environment variable
BOOGIE_EXEto an executable of a recent version of Boogie -
Run the following command:
sbt test.
Who do I talk to?
- This repository is maintained by Linard Arquint.