README 1.7 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364
  1. Cuirass is a continuous integration tool using GNU Guix. It is intended as a
  2. replacement for Hydra.
  3. Requirements
  4. ============
  5. Cuirass currently depends on the following packages:
  6. - GNU Guile 2.0.9 or later
  7. - GNU Guix (and all its development dependencies)
  8. - GNU Make
  9. - Guile-JSON
  10. - Guile-SQLite3
  11. - Git
  12. A convenient way to install those dependencies is to install Guix and execute
  13. the following command:
  14. $ guix environment -l build-aux/guix.scm
  15. This will build and enter an environment which provides all the necessary
  16. dependencies.
  17. Build Instructions
  18. ==================
  19. When all the dependencies are available on you system, in order to build and
  20. install Cuirass, you can proceed with the usual:
  21. $ ./configure && sudo make install
  22. An alternative way is to directly install Cuirass in your Guix profile, using:
  23. $ guix package -f build-aux/guix.scm
  24. To build it, but not install it, run:
  25. $ guix build -f build-aux/guix.scm
  26. Example
  27. =======
  28. A quick way to manually test Cuirass is to execute:
  29. ./pre-inst-env cuirass --specifications=examples/hello-singleton.scm --database=test.db
  30. This will read the file "examples/hello-singleton.scm" which contains a list of
  31. specifications and add them to the database "test.db" which is created if it
  32. doesn't already exist.
  33. 'cuirass' then loops evaluating/building the specs. The database keeps track
  34. of the specifications in order to allow users to accumulate specifications.
  35. To resume the evaluation/build process you can execute the same command
  36. without the '--specifications' option:
  37. ./pre-inst-env cuirass --database=test.db
  38. Contributing
  39. ============
  40. See the manual for useful hacking informations, by running
  41. info -f doc/cuirass.info "Contributing"