You are looking at historical revision 3261 of this page. It may differ significantly from its current revision.

Salmonella -- the Eggs-Tester

Salmonella is a tool for testing Chicken eggs from the official repository.

Salmonella fetches the eggs repository listing from http://www.call-with-current-continuation.org/eggs and tries to install each egg, reporting failure or success. Each egg is individually tested, that is, salmonella sets the local destination repository empty before testing an egg (it's like installing an egg on a fresh repository, so broken dependencies can be spotted).

Some salmonella features:

• Automatic eggs fetching and installation testing
• Resuming
• Possibility of hooking system's package manager (e.g., apt, rpm) for installing OS packages eggs might depend on
• Logging and verbosity control

Requirements

• http egg

Usage

Salmonella is a command line tool. Salmonella's command line arguments' syntax is like Scheme's.

 Usage: salmonella -h | -help | --help | -?
           salmonella <conf-file>
           salmonella <options>

 <options> are Scheme expressions. <conf-file> is a file which may
 contain the same Scheme expressions as <options>'s. The following
 expressions are recognized:

              == Expression ==                   == Default ==
  (chicken-setup "<path to chicken-setup>")    chicken-setup
  (chicken-setup-args "<args>"                 -d
  (env-vars "<environment variables settings>" CHICKEN_REPOSITORY=(repo-test-dir) CHICKEN_INCLUDE_PATH=(repo-test-dir)
  (repo-test-dir "<path to repo-test-dir>")    `pwd`/salmonella-repo
  (skip-eggs (list "egg1" "egg2" ...))         '()
  (verbose <bool>)                             #f
  (logfile "filename")                         salmonella.log
  (eggs (lambda () ...))                       a procedure which fetches eggs list from call/cc.org
  (system-deps "filename")                     #f
  (pkg-manager "system pkg manager & args")    #f
  (resume <bool>)                              #f
  (progress-file "filename")                   salmonella.progress
 
 Example:
 
  salmonella '(chicken-setup "/usr/local/chicken/bin/chicken-setup") (verbose #t)'
 

Options

• chicken-setup: full path to the chicken-setup program. Default is "chicken-setup".
• chicken-setup-args: arguments to be passed to chicken-setup. Default is -d.
• env-vars: environment variable settings to be applied when chicken-setup is invoked. Default is CHICKEN_REPOSITORY=(repo-test-dir) CHICKEN_INCLUDE_PATH=(repo-test-dir) (where (repo-test-dir) is a salmonella parameter).
• repo-test-dir: full path to the the directory salmonella will use for testing the installation og eggs. Default is "salmonella-repo".
• skip-eggs: list of eggs to skip from testing. Default is '().
• eggs: a zero-argument procedure which should return a list of egg names (strings).
• verbose: controls if salmonella should be verbose. Default is #f.
• system-deps: path to a file indicating which OS packages should be installed when testing eggs. The file format is:

  (egg1 package1 package2 ... packagen)
  (egg2 package1 package2 ... packagen)

This option should be used with the pkg-manager option. Default is #f.

• pkg-manager: path to the system package manager and its arguments. It's used with the system-deps option to install system packages which some eggs depend on. Default is #f.
• logfile: path to the file where logging information is stored. Default is "salmonella.log".
• resume: tells salmonella that it should continue from the point it last stopped. Salmonella uses information from the file indicated by the progress-file. Default is #f.
• progress-file: keeps track of which eggs were already tested (useful for resumming -- see the resume option). Default is "salmonella.progress".