The Rosette solver-aided host language, sample solver-aided DSLs, and demos
Rosette is a solver-aided programming language that extends Racket with language constructs for program synthesis, verification, and more. This repository includes the source code for Rosette, as well as several example solver-aided DSLs.
The easiest way to install Rosette is from Racket's package manager:
Download and install Racket 7.0 or later from http://racket-lang.org
Use Racket's
racotool to install Rosette:
$ raco pkg install rosette
Alternatively, you can install Rosette from source:
Download and install Racket 7.0 or later from http://racket-lang.org
Clone the rosette repository:
$ git clone https://github.com/emina/rosette.git
$ raco pkg remove rosette
racotool to install Rosette:
$ cd rosette
$ raco pkg install
Open the target program in DrRacket (e.g.,
rosette/sdsl/fsm/demo.rkt) and hit run!
DrRacket is the preferred way to execute Rosette programs. If you need to use the command line, make sure to first compile the program:
$ raco make
$ racket
Rosette ships with two languages:
#lang rosette/safeand
#lang rosette.
The
rosette/safelanguage includes only constructs that are safe to use with symbolic values. This (for now) excludes some nice Racket features, such as iteration constructs. The semantics of these constructs can be expressed in the core language, however, so no expressiveness is lost (just convenience). It is recommended for new users of Rosette to start with the
rosette/safelanguage. To see the list of syntactic forms and procedures provided by
rosette/safe, type the following into the Rosette REPL:
> (rosette)
'(define assert let let* ...)
The
rosettelanguage includes all of Racket. This places the burden on the programmer to decide whether a given Racket construct (which is not overriden by Rosette) is safe to use in a given context. Rosette provides no guarantees or checks for programs that use unsafe constructs. In the best case, such a program will fail with an exception if a symbolic value flows to a construct that does not support it. In the worst case, it will continue executing with incorrect semantics or cause more serious problems (e.g., data loss if it writes to a file).
For more on using Rosette, see The Rosette Guide. Rosette's internals are described in this PLDI'14 paper.