buildbot.master.BotPerspective

Package buildbot :: Module master :: Class BotPerspective

Class BotPerspective

        Avatar --+    
                 |    
NewCredPerspective --+
                     |
                    BotPerspective

This is the master-side representative for a remote buildbot slave. There is exactly one for each slave described in the config file (the c['bots'] list). When buildbots connect in (.attach), they get a reference to this instance. The BotMaster object is stashed as the .service attribute.

Method Summary
	`__init__(self, name, botmaster)`
	`__repr__(self)`
	`attached(self, bot)` This is called when the slave connects.
	`detached(self, mind)`
	`disconnect(self)` Forcibly disconnect the slave.
	`perspective_keepalive(self)`
	`sendBuilderList(self)`
	`updateSlave(self)` Called to add or remove builders after the slave has connected.
Inherited from Avatar
	`perspectiveMessageReceived(self, broker, message, args, kw)` This method is called when a network message is received.

Class Variable Summary
Inherited from NewCredPerspective
`Implements`	`__implemented__` = `<implementedBy buildbot.pbutil.NewCred...`
`ClassProvides`	`__provides__` = `<zope.interface.declarations.ClassProvide...`
Inherited from Avatar
`ClassProvides`	`__providedBy__` = `<zope.interface.declarations.ClassProvi...`

Method Details

attached(self, bot)

This is called when the slave connects.

Returns:: a Deferred that fires with a suitable pb.IPerspective to give to the slave (i.e. 'self')

Overrides:: buildbot.pbutil.NewCredPerspective.attached

disconnect(self)

Forcibly disconnect the slave.

This severs the TCP connection and returns a Deferred that will fire (with None) when the connection is probably gone.

If the slave is still alive, they will probably try to reconnect again in a moment.

This is called in two circumstances. The first is when a slave is removed from the config file. In this case, when they try to reconnect, they will be rejected as an unknown slave. The second is when we wind up with two connections for the same slave, in which case we disconnect the older connection.

updateSlave(self)

Called to add or remove builders after the slave has connected.

Returns:: a Deferred that indicates when an attached slave has accepted the new builders and/or released the old ones.

Generated by Epydoc 2.1 on Sun Dec 10 22:04:45 2006

http://epydoc.sf.net