<html lang="en">
<head>
<title>Status Targets - 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="Interlocks.html#Interlocks" title="Interlocks">
<link rel="next" href="Configuration-Index.html#Configuration-Index" title="Configuration Index">
<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="Status-Targets"></a>
<p>
Next: <a rel="next" accesskey="n" href="Configuration-Index.html#Configuration-Index">Configuration Index</a>,
Previous: <a rel="previous" accesskey="p" href="Interlocks.html#Interlocks">Interlocks</a>,
Up: <a rel="up" accesskey="u" href="Configuration.html#Configuration">Configuration</a>
<hr>
</div>
<h3 class="section">4.14 Status Targets</h3>
<p>The Buildmaster has a variety of ways to present build status to
various users. Each such delivery method is a “Status Target” object
in the configuration's <code>status</code> list. To add status targets, you
just append more objects to this list:
<p><a name="index-c_005b_0027status_0027_005d-139"></a>
<pre class="example"> c['status'] = []
from buildbot.status import html
c['status'].append(html.Waterfall(http_port=8010))
from buildbot.status import mail
m = mail.MailNotifier(fromaddr="buildbot@localhost",
extraRecipients=["builds@lists.example.com"],
sendToInterestedUsers=False)
c['status'].append(m)
from buildbot.status import words
c['status'].append(words.IRC(host="irc.example.com", nick="bb",
channels=[{"channel": "#example1"},
{"channel": "#example2",
"password": "somesecretpassword"}]))
</pre>
<p>Most status delivery objects take a <code>categories=</code> argument, which
can contain a list of “category” names: in this case, it will only
show status for Builders that are in one of the named categories.
<h3 class="heading">Implementation Note</h3>
<p>Each of these objects should be a service.MultiService which will be attached
to the BuildMaster object when the configuration is processed. They should use
<code>self.parent.getStatus()</code> to get access to the top-level IStatus object,
either inside <code>startService</code> or later. They may call
<code>status.subscribe()</code> in <code>startService</code> to receive notifications of
builder events, in which case they must define <code>builderAdded</code> and related
methods. See the docstrings in <samp><span class="file">buildbot/interfaces.py</span></samp> for full details.
<ul class="menu">
<li><a accesskey="1" href="WebStatus.html#WebStatus">WebStatus</a>
<li><a accesskey="2" href="MailNotifier.html#MailNotifier">MailNotifier</a>
<li><a accesskey="3" href="IRC-Bot.html#IRC-Bot">IRC Bot</a>
<li><a accesskey="4" href="PBListener.html#PBListener">PBListener</a>
<li><a accesskey="5" href="StatusPush.html#StatusPush">StatusPush</a>
<li><a accesskey="6" href="HttpStatusPush.html#HttpStatusPush">HttpStatusPush</a>
<li><a accesskey="7" href="GerritStatusPush.html#GerritStatusPush">GerritStatusPush</a>
<li><a accesskey="8" href="Writing-New-Status-Plugins.html#Writing-New-Status-Plugins">Writing New Status Plugins</a>
<li><a accesskey="9" href="Status-Target-Index.html#Status-Target-Index">Status Target Index</a>
</ul>
</body></html>
