<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>Buildbot Development — Buildbot 0.8.5 documentation</title> <link rel="stylesheet" href="../_static/agogo.css" type="text/css" /> <link rel="stylesheet" href="../_static/pygments.css" type="text/css" /> <script type="text/javascript"> var DOCUMENTATION_OPTIONS = { URL_ROOT: '../', VERSION: '0.8.5', COLLAPSE_INDEX: false, FILE_SUFFIX: '.html', HAS_SOURCE: true }; </script> <script type="text/javascript" src="../_static/jquery.js"></script> <script type="text/javascript" src="../_static/underscore.js"></script> <script type="text/javascript" src="../_static/doctools.js"></script> <link rel="shortcut icon" href="../_static/buildbot.ico"/> <link rel="top" title="Buildbot 0.8.5 documentation" href="../index.html" /> <link rel="next" title="Buildbot Coding Style" href="style.html" /> <link rel="prev" title="Resources" href="../manual/resources.html" /> </head> <body> <div class="header-wrapper"> <div class="header"> <p class="logo"><a href="../index.html"> <img class="logo" src="../_static/header-text-transparent.png" alt="Logo"/> </a></p> <div class="headertitle"><a href="../index.html">Buildbot 0.8.5 documentation</a></div> <div class="rel"> <a href="../manual/resources.html" title="Resources" accesskey="P">previous</a> | <a href="style.html" title="Buildbot Coding Style" accesskey="N">next</a> | <a href="../py-modindex.html" title="Python Module Index" >modules</a> | <a href="../genindex.html" title="General Index" accesskey="I">index</a> </div> </div> </div> <div class="content-wrapper"> <div class="content"> <div class="document"> <div class="documentwrapper"> <div class="bodywrapper"> <div class="body"> <div class="section" id="buildbot-development"> <span id="id1"></span><h1>Buildbot Development<a class="headerlink" href="#buildbot-development" title="Permalink to this headline">ΒΆ</a></h1> <p>This chapter is the official repository for the collected wisdom of the Buildbot hackers.</p> <p>It contains some sparse documentation of the inner workings of Buildbot, but of course, the final reference for that is the source itself.</p> <p>More importantly, this chapter represents the official repository of all agreed-on patterns for use in Buildbot. In this case, the source is a <em>terrible</em> reference, because much of it is old and crusty. But we are trying to do things the new, better way, and those new, better ways are described here.</p> <div class="toctree-wrapper compound"> <ul> <li class="toctree-l1"><a class="reference internal" href="style.html">Buildbot Coding Style</a><ul> <li class="toctree-l2"><a class="reference internal" href="style.html#twisted-idioms">Twisted Idioms</a></li> <li class="toctree-l2"><a class="reference internal" href="style.html#writing-buildbot-tests">Writing Buildbot Tests</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="master-overview.html">Master Organization</a><ul> <li class="toctree-l2"><a class="reference internal" href="master-overview.html#buildmaster-service-hierarchy">Buildmaster Service Hierarchy</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="config.html">Buildbot Configuration</a><ul> <li class="toctree-l2"><a class="reference internal" href="config.html#access-to-configuration">Access to Configuration</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="utils.html">Utilities</a><ul> <li class="toctree-l2"><a class="reference internal" href="utils.html#buildbot-util-bbcollections">buildbot.util.bbcollections</a></li> <li class="toctree-l2"><a class="reference internal" href="utils.html#buildbot-util-eventual">buildbot.util.eventual</a></li> <li class="toctree-l2"><a class="reference internal" href="utils.html#buildbot-util-json">buildbot.util.json</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="database.html">The Buildbot Database</a><ul> <li class="toctree-l2"><a class="reference internal" href="database.html#database-overview">Database Overview</a></li> <li class="toctree-l2"><a class="reference internal" href="database.html#api">API</a></li> <li class="toctree-l2"><a class="reference internal" href="database.html#writing-database-connector-methods">Writing Database Connector Methods</a></li> <li class="toctree-l2"><a class="reference internal" href="database.html#modifying-the-database-schema">Modifying the Database Schema</a></li> <li class="toctree-l2"><a class="reference internal" href="database.html#database-compatibility-notes">Database Compatibility Notes</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="results.html">Build Result Codes</a></li> <li class="toctree-l1"><a class="reference internal" href="formats.html">File Formats</a><ul> <li class="toctree-l2"><a class="reference internal" href="formats.html#log-file-format">Log File Format</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="webstatus.html">Web Status</a><ul> <li class="toctree-l2"><a class="reference internal" href="webstatus.html#jinja-web-templates">Jinja Web Templates</a></li> <li class="toctree-l2"><a class="reference internal" href="webstatus.html#web-authorization-framework">Web Authorization Framework</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="master-slave.html">Master-Slave API</a><ul> <li class="toctree-l2"><a class="reference internal" href="master-slave.html#connection">Connection</a></li> <li class="toctree-l2"><a class="reference internal" href="master-slave.html#build-slaves">Build Slaves</a></li> <li class="toctree-l2"><a class="reference internal" href="master-slave.html#setup">Setup</a></li> <li class="toctree-l2"><a class="reference internal" href="master-slave.html#pinging">Pinging</a></li> <li class="toctree-l2"><a class="reference internal" href="master-slave.html#building">Building</a></li> <li class="toctree-l2"><a class="reference internal" href="master-slave.html#slave-builders">Slave Builders</a></li> <li class="toctree-l2"><a class="reference internal" href="master-slave.html#commands">Commands</a></li> <li class="toctree-l2"><a class="reference internal" href="master-slave.html#updates">Updates</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="encodings.html">String Encodings</a><ul> <li class="toctree-l2"><a class="reference internal" href="encodings.html#inputs">Inputs</a></li> <li class="toctree-l2"><a class="reference internal" href="encodings.html#outputs">Outputs</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="metrics.html">Metrics</a><ul> <li class="toctree-l2"><a class="reference internal" href="metrics.html#metric-events">Metric Events</a></li> <li class="toctree-l2"><a class="reference internal" href="metrics.html#metric-handlers">Metric Handlers</a></li> <li class="toctree-l2"><a class="reference internal" href="metrics.html#metric-watchers">Metric Watchers</a></li> <li class="toctree-l2"><a class="reference internal" href="metrics.html#metric-helpers">Metric Helpers</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="classes.html">Classes</a><ul> <li class="toctree-l2"><a class="reference internal" href="cls-buildfactory.html">BuildFactory</a></li> <li class="toctree-l2"><a class="reference internal" href="cls-remotecommands.html">RemoteCommands</a></li> <li class="toctree-l2"><a class="reference internal" href="cls-buildsteps.html">BuildSteps</a></li> </ul> </li> </ul> </div> </div> </div> </div> </div> </div> <div class="sidebar"> <h3>Table Of Contents</h3> <ul class="current"> <li class="toctree-l1"><a class="reference internal" href="../tutorial/index.html">Buildbot Tutorial</a></li> <li class="toctree-l1"><a class="reference internal" href="../manual/index.html">Buildbot Manual</a></li> <li class="toctree-l1 current"><a class="current reference internal" href="">Buildbot Development</a><ul> <li class="toctree-l2"><a class="reference internal" href="style.html">Buildbot Coding Style</a></li> <li class="toctree-l2"><a class="reference internal" href="master-overview.html">Master Organization</a></li> <li class="toctree-l2"><a class="reference internal" href="config.html">Buildbot Configuration</a></li> <li class="toctree-l2"><a class="reference internal" href="utils.html">Utilities</a></li> <li class="toctree-l2"><a class="reference internal" href="database.html">The Buildbot Database</a></li> <li class="toctree-l2"><a class="reference internal" href="results.html">Build Result Codes</a></li> <li class="toctree-l2"><a class="reference internal" href="formats.html">File Formats</a></li> <li class="toctree-l2"><a class="reference internal" href="webstatus.html">Web Status</a></li> <li class="toctree-l2"><a class="reference internal" href="master-slave.html">Master-Slave API</a></li> <li class="toctree-l2"><a class="reference internal" href="encodings.html">String Encodings</a></li> <li class="toctree-l2"><a class="reference internal" href="metrics.html">Metrics</a></li> <li class="toctree-l2"><a class="reference internal" href="classes.html">Classes</a></li> </ul> </li> </ul> <h3 style="margin-top: 1.5em;">Search</h3> <form class="search" action="../search.html" method="get"> <input type="text" name="q" /> <input type="submit" value="Go" /> <input type="hidden" name="check_keywords" value="yes" /> <input type="hidden" name="area" value="default" /> </form> <p class="searchtip" style="font-size: 90%"> Enter search terms or a module, class or function name. </p> </div> <div class="clearer"></div> </div> </div> <div class="footer-wrapper"> <div class="footer"> <div class="left"> <a href="../manual/resources.html" title="Resources" >previous</a> | <a href="style.html" title="Buildbot Coding Style" >next</a> | <a href="../py-modindex.html" title="Python Module Index" >modules</a> | <a href="../genindex.html" title="General Index" >index</a> <br/> <a href="../_sources/developer/index.txt" rel="nofollow">Show Source</a> </div> <div class="right"> <div class="footer"> © Copyright Buildbot Team Members. Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1. </div> </div> <div class="clearer"></div> </div> </div> </body> </html>