This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Continuous integration server for Github and MediaWiki.

Project Description

Generic continuous integration server for interfacing with github and publishing results to a Media Wiki. The basic idea is that continuous integration just requires three things:

  • A repo to monitor for changes.
  • Unit tests to run.
  • A place to publish the results of the tests.

Py-CI interfaces with github using the pygithub API wrapper for interfacing with github’s API. It monitors the pull requests for a set of repos. When a new or untested pull request is found:

  • Create a local copy of the repo; merge the proposed changes from the pull request into a working branch.
  • Run all the unit tests specified in the repo.xml configuration file.
  • Post the results of running the unit tets to a media wiki.

Quickstart

If you already have a virtualenv installed as well as virtualenvwrapper, skip this next code block. However, be sure to add the VENV variable to the global configuration file.

pip install virtualenv
pip install virtualenvwrapper
mkvirtualenv ci

Next, copy the `global.xml <https://github.com/rosenbrockc/ci/wiki>`__ file and put it somewhere on you local disk (say ~/.ci.global.xml). Be sure to edit the values. Then:

export PYCI_XML="~/.ci.global.xml"
workon ci
pip install py-ci
sudo ci.py -setup

If you don’t see any errors, your server is ready to have repositories installed. This configures the server cron to run every minute. Use -cronfreq [int minutes] to change that frequency (see cron settings for details). You don’t need to use sudo for anything except setting the server up initially (or uninstalling it later with the -rollback switch). Next, create a `repo.xml <https://github.com/rosenbrockc/ci/wiki/Repository-Level-Settings>`__ file for repository you want to monitor. Suppose it exists at ~/repos/myrepo/ci.xml, then:

ci.py -install ~/repos/myrepo/ci.xml

Your repository will now be monitored for new pull requests forever untill you either -uninstall the repo.xml file or you -disable the CI server to temporarily suspend all requests. To understand the behavior of the CI server, read through the repository level settings page.

IMPORTANT: if your unit tests require environment variables to be set, they need to be added to a file called ~/.cron_profile that will be loaded by the CI server whenever the cron is run. See cron environment variables for more details.

Release History

Release History

This version
History Node

0.0.4

History Node

0.0.3

History Node

0.0.2

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
pyci-0.0.4-py2.py3-none-any.whl (41.0 kB) Copy SHA256 Checksum SHA256 2.7 Wheel Apr 20, 2015
pyci-0.0.4.tar.gz (29.6 kB) Copy SHA256 Checksum SHA256 Source Apr 20, 2015

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