Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

continuum is a minimalist continuous integration tool

Project Description

Continuum is a lightweight continuous integration tool: no web interface, no scheduler. It runs on command line and is triggered by cron.


You can install it using PIP, typing pip install continuum. This will install the continuum script in you PATH. You may also download the archive, expand it and type in the created directory sudo python install.

While calling continuum, you must pass the configuration file name on the command line:

continuum config.yml


Configuration is in YAML format:

directory:  /tmp
  success:   false

    command: |
      set -e
      virtualenv env --no-site-packages
      . env/bin/activate
      pip install -r etc/requirements.txt
      bee test
    command: |
      set -e
      commands to run the test

The first part indicates:

  • directory: the directory where modules will be checked out. Currently only GIT projects are supported.
  • email: put ~ if you don’t want any email.

If you wait to receive email reports, provide following fields:

  • smtp_host: the hostname of your SMTP server.
  • recipient: the email of the recipient of the build report.
  • sender: the email address if the sender of the report.
  • success: tells if continuum should send an email on success. If false, it will only send an email on build error.

The second one is the list of modules, with, for each module:

  • url: the URL of the module that GIT will use to get the sources.
  • command: the command to run tests, must return 0 on success and a different value on error (as any Unix script should). Note the pipe character (that is |) after the command: declaration.

The most important thing to remember about editting YAML is that Tab characters are forbidden (and should be replaced with spaces to properly indent). Please see YAML specification (at for more details.


This script is triggered using cron, with as configuration as follows (in file /etc/crontab):

# run continuum at 4 every night
0   4 * * *  me    continuum /home/me/etc/continuum.yml

Please make sure that the PATH to continuum is defined in your cron configuration. You may add the right PATH at the beginning of your crontab file as following:


# run continuum at 4 every night
0   4 * * *  me    continuum /home/me/etc/continuum.yml


  • 0.1.2 (2014-04-15): Fixed documentation.
  • 0.1.1 (2014-04-11): Improved email reporting.
  • 0.1.0 (2014-04-08): First public release.


Release History

Release History

This version
History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
continuum-0.1.2.tar.gz (8.6 kB) Copy SHA256 Checksum SHA256 Source Apr 15, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting