Cuirass continuous integration tool https://git.savannah.gnu.org/cgit/guix/guix-cuirass.git
Go to file
Ludovic Courtès b4400bc989 build: Install .go files to $(libdir)/guile.
* Makefile.am (guileobjectdir): New variable.
(nodist_guilesite_DATA): Rename to...
(nodist_guileobject_DATA): ... this.
(pkgobjectdir): New variable.
(nodist_pkgmodule_DATA): Rename to...
(nodist_pkgobject_DATA): ... this.
2017-05-10 16:42:05 +02:00
bin evaluate: Use specification #:name in evaluation alists. 2017-02-24 19:32:20 +01:00
build-aux build: Add '%aux-dir' variable. 2017-01-24 20:11:55 +01:00
doc doc: Do not use "path" when a file name is meant. 2017-05-05 21:16:52 +02:00
examples maint: Move examples from 'tests' to 'examples' directory. 2016-12-16 13:20:49 +01:00
src base: Provide 'build-derivations' with the full list of derivations. 2017-02-24 19:33:41 +01:00
tests tests: Compare JSON objects instead of JSON strings. 2017-05-10 16:28:56 +02:00
.dir-locals.el doc: Add Cuirass manual. 2016-12-04 22:31:03 +01:00
.gitignore build: Don't generate ".version" since it has no use. 2017-01-23 02:41:53 +01:00
COPYING Initial commit. 2016-05-29 19:53:17 +02:00
Makefile.am build: Install .go files to $(libdir)/guile. 2017-05-10 16:42:05 +02:00
README maint: Add a pointer to the manual in the README. 2017-01-29 17:56:44 +01:00
bootstrap build: Add 'bootstrap' script. 2016-08-02 19:04:53 +02:00
configure.ac build: Prefer building with Guile 2.2. 2017-05-10 16:32:26 +02:00

README

Cuirass is a continuous integration tool using GNU Guix.  It is intended as a
replacement for Hydra.

Requirements
============

Cuirass currently depends on the following packages:

  - GNU Guile 2.0.9 or later
  - GNU Guix (and all its development dependencies)
  - GNU Make
  - Guile-JSON
  - Guile-SQLite3
  - Git

A convenient way to install those dependencies is to install Guix and execute
the following command:

   $ guix environment -l build-aux/guix.scm

This will build and enter an environment which provides all the necessary
dependencies.

Build Instructions
==================

When all the dependencies are available on you system, in order to build and
install Cuirass, you can proceed with the usual:

   $ ./configure && sudo make install

An alternative way is to directly install Cuirass in your Guix profile, using:

   $ guix package -f build-aux/guix.scm

To build it, but not install it, run:

   $ guix build -f build-aux/guix.scm

Example
=======

A quick way to manually test Cuirass is to execute:

  ./pre-inst-env cuirass --specifications=examples/hello-singleton.scm --database=test.db

This will read the file "examples/hello-singleton.scm" which contains a list of
specifications and add them to the database "test.db" which is created if it
doesn't already exist.

'cuirass' then loops evaluating/building the specs.  The database keeps track
of the specifications in order to allow users to accumulate specifications.
To resume the evaluation/build process you can execute the same command
without the '--specifications' option:

  ./pre-inst-env cuirass --database=test.db

Contributing
============

See the manual for useful hacking informations, by running

  info -f doc/cuirass.info "Contributing"