<html lang="en">
<head>
<title>Build Factories - BuildBot Manual - 0.8.4p1</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="BuildBot Manual - 0.8.4p1">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Configuration.html#Configuration" title="Configuration">
<link rel="prev" href="Builders.html#Builders" title="Builders">
<link rel="next" href="Build-Steps.html#Build-Steps" title="Build Steps">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
This is the BuildBot manual for Buildbot version 0.8.4p1.
Copyright (C) 2005, 2006, 2009, 2010 Brian Warner
Copying and distribution of this file, with or without
modification, are permitted in any medium without royalty
provided the copyright notice and this notice are preserved.-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
<a name="Build-Factories"></a>
<p>
Next: <a rel="next" accesskey="n" href="Build-Steps.html#Build-Steps">Build Steps</a>,
Previous: <a rel="previous" accesskey="p" href="Builders.html#Builders">Builders</a>,
Up: <a rel="up" accesskey="u" href="Configuration.html#Configuration">Configuration</a>
<hr>
</div>
<h3 class="section">4.11 Build Factories</h3>
<p>Each Builder is equipped with a “build factory”, which is
responsible for producing the actual <code>Build</code> objects that perform
each build. This factory is created in the configuration file, and
attached to a Builder through the <code>factory</code> element of its
dictionary.
<p>The standard <code>BuildFactory</code> object creates <code>Build</code> objects
by default. These Builds will each execute a collection of BuildSteps
in a fixed sequence. Each step can affect the results of the build,
but in general there is little intelligence to tie the different steps
together.
<p>The steps used by these builds are all subclasses of <code>BuildStep</code>.
The standard ones provided with Buildbot are documented later,
See <a href="Build-Steps.html#Build-Steps">Build Steps</a>. You can also write your own subclasses to use in
builds.
<p>The basic behavior for a <code>BuildStep</code> is to:
<ul>
<li>run for a while, then stop
<li>possibly invoke some RemoteCommands on the attached build slave
<li>possibly produce a set of log files
<li>finish with a status described by one of four values defined in
buildbot.status.builder: SUCCESS, WARNINGS, FAILURE, SKIPPED
<li>provide a list of short strings to describe the step
</ul>
<ul class="menu">
<li><a accesskey="1" href="BuildFactory.html#BuildFactory">BuildFactory</a>
<li><a accesskey="2" href="GNUAutoconf.html#GNUAutoconf">GNUAutoconf</a>
<li><a accesskey="3" href="BasicBuildFactory.html#BasicBuildFactory">BasicBuildFactory</a>
<li><a accesskey="4" href="BasicSVN.html#BasicSVN">BasicSVN</a>
<li><a accesskey="5" href="QuickBuildFactory.html#QuickBuildFactory">QuickBuildFactory</a>
<li><a accesskey="6" href="CPAN.html#CPAN">CPAN</a>
<li><a accesskey="7" href="Distutils.html#Distutils">Distutils</a>
<li><a accesskey="8" href="Trial-_0028Factory_0029.html#Trial-_0028Factory_0029">Trial (Factory)</a>
<li><a accesskey="9" href="Build-Factory-Index.html#Build-Factory-Index">Build Factory Index</a>
</ul>
</body></html>
