Package buildbot :: Package changes :: Module changes :: Class Change

Class Change

I represent a single change to the source tree. This may involve several files, but they are all changed by the same person, and there is a change comment for the group as a whole.

If the version control system supports sequential repository- (or branch-) wide change numbers (like SVN, P4, and Arch), then revision= should be set to that number. The highest such number will be used at checkout time to get the correct set of files.

If it does not (like CVS), when= should be set to the timestamp (seconds since epoch, as returned by time.time()) when the change was made. when= will be filled in for you (to the current time) if you omit it, which is suitable for ChangeSources which have no way of getting more accurate timestamps.

Changes should be submitted to ChangeMaster.addChange() in chronologically increasing order. Out-of-order changes will probably cause the html.Waterfall display to be corrupted.

Instance Methods

__init__(self, who, files, comments, isdir=0, links=None, revision=None, when=None, branch=None, category=None, revlink='', properties={}) source code

__setstate__(self, dict)

source code

asText(self)

source code

asHTML(self)

source code

get_HTML_box(self, url)
Return the contents of a TD cell for the waterfall display.

source code

getShortAuthor(self)

source code

getTime(self)

source code

getTimes(self)

source code

getText(self)

source code

getLogs(self)

source code

getFileContents(self)

source code

getProperties(self)

source code

__providedBy__(...)
Object Specification Descriptor

source code

Class Variables
	number = `None` hash(x)
	branch = `None` hash(x)
	category = `None` hash(x)
	revision = `None` hash(x)
	__implemented__ = `<implementedBy buildbot.changes.changes.Change>`
	__provides__ = `<zope.interface.declarations.ClassProvides obje...`

Method Details

get_HTML_box(self, url)

source code

Return the contents of a TD cell for the waterfall display.

Parameters:

url - the URL that points to an HTML page that will render using our asHTML method. The Change is free to use this or ignore it as it pleases.

Returns:

the HTML that will be put inside the table cell. Typically this is just a single href named after the author of the change and pointing at the passed-in 'url'.

Class Variable Details

provides

Value:

<zope.interface.declarations.ClassProvides object at 0x1565850>

Class Change

get_HTML_box(self, url)

__provides__

provides