director uses what is becoming a pretty standard and a quite simple toolset.

Required Tools

  1. python - The python programming language or an alternate implementation (see bellow).
  2. distutils - Python building and packaging library
  3. git - Source code management
  4. an editor or ide that doesn’t suck

Python Implementations

Implementation Status Reporter
CPython 2.3+ Works ashcrow
CPython 3.0 Works in Python3.0 branch ashcrow
Stackless 2.3+ Works ashcrow
Jython 2.5 Works ashcrow
IronPython 2.0 Works ashcrow
Pypy Works fijal

Optional Tools

  1. rpm-build - Should be packaged in your RPM distribution


You can clone the repo over http via git through the following command::

$ git clone


PEP 0008 should be followed. This outlines the highlights that we require above and beyond. Your code must follow this (or note why it can’t) before patches will be accepted.

  • Global variables should be in ALLCAPPS

  • attributes should be all lowercase

  • classes should be CamelCased? ... filenames should be lowercase.

  • functions and methods should be lowercase with spaces replaced with _’s:

    def a_test_method(self):
  • classes should subclass object unless it subclasses a different object:

    class Person(object):
    class Steve(Person):
  • 4 spaces per indent level

  • max length is 79 chars.

  • Single quotes preferred over double quotes.

  • avoid from x import * imports unless a must use

  • modules, functions, classes, and methods all must have docstrings - doc strings should be descriptive of what objects, functions, and methods do

  • document any potentially confusing sections of code

  • functions and methods should be broken down in such a way as to be easily understood and self contained

  • use descriptive variable names, only use things like x, y, etc.. when doing integer loops and even then see if you can use more descriptive names

  • Pull the interpreter from the environment like so::

    #!/usr/bin/env python
  • main should use the standard main structure like::

    if __name__ == '__main__':
        # Code goes here



The best way to develop on director is to branch feature sets. For instance, if you were to add xml deserialization you would want to branch locally and work on that branch.:

$  git branch
* master
$ git status
# On branch master
nothing to commit (working directory clean)
$ git branch xmldeserialization
$ git checkout xmldeserialization

Now we pretend you are all finished and have done at least one commit to the xmldeserialization branch.:

$ git-format-patch master

You now have patch sets which you can send in for perusal and acceptance. You can submit them via email. If you are interested in working directly on the project then submitting a few patches is the place to start. If, for some reason, you are unable to attach patches to the ticket system you can email the patches to

the user smilner+director at the domain red hat dot(.) com.

Running Unit Tests

Running the test suite is as simple as running test. The results look like::

$ ./ test
Ran 12 tests in 0.049s