Getting Started with Verve
For now, the only way to install Verve is to build it from source.
Installing from Source
First, you'll need to clone the project:
$ git clone https://github.com/tadeuzagallo/verve-lang
Verve is written in Haskell and built using the Haskell Tool Stack, so you'll need to install it in order to build the project. You can refer to the Stack documentation, but the TL;DR is that you can install it using brew if you use macOS:
$ brew install stack
Before building the project for the first time, you'll need to use stack
to setup your environment:
$ stack setup
Once that's done, you should be all set to actually build verve:
$ stack build
You can try running all the tests to check that your build works (it should only take a few seconds):
$ make test
If everything is working fine, you should now be able to run your verve programs. There a few ways one can use it:
- Install it and just call
verve
:
# from within the verve repo
$ ln -s $(pwd)/verve /usr/local/bin
# then you can run a file
$ verve file.vrv
# or start the REPL:
$ verve
- Directly using the wrapper script that ships with Verve:
$ path/to/verve file.vrv
- Directly using
stack
$ stack exec verve -- file.vrv
(If you had any issues following these steps, it would be great if you could create an issue. Thanks!)
Contributing
The language is still constantly changing, but if you too would like hack on it, feel free to open an issue or send a pull request with your patch. Any contribution is welcome.
If you decide to contribute any code, please make sure that your change include at least one test that would not pass without your patch. Tests are written using LLVM lit and you can find a number of existing tests in the repo.