buildout - siggame/discuss GitHub Wiki

We use buildout to make our development environment more portable. Instead of installing packages system-wide, buildout will install all packages within the project. Additionally, we can pin down the versions of packages that we're using to ensure that we're not affected by package upgrades.

Getting started with Buildout

Prerequisites

  • Instal packages
    • Make (Probably already installed)
      • Try running make. If it doesn't work, sudo apt-get install make
    • Packages listed in buildout.cfg's comment header

Setting up

  • Change into your discuss/ directory
  • Run make
    • Downloads bootstrap.py, which can install Buildout for us
    • Runs buildout, which sets up your environment

Whenever there are changes to buildout.cfg or versions.cfg, you'll need to rerun make. This will put your development environment in the same place as everyone else.