Package buildbot :: Package changes :: Module changes :: Class Change
[frames | no frames]

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.
Method Summary
  __init__(self, who, files, comments, isdir, links, revision, when, branch)
  asHTML(self)
  asText(self)
  get_HTML_box(self, url)
Return the contents of a TD cell for the waterfall display.
  getColor(self)
  getFileContents(self)
  getLogs(self)
  getShortAuthor(self)
  getText(self)
  getTime(self)
  getTimes(self)

Class Variable Summary
Implements __implemented__ = <implementedBy buildbot.changes.change...
ClassProvides __providedBy__ = <zope.interface.declarations.ClassProvi...
ClassProvides __provides__ = <zope.interface.declarations.ClassProvide...
NoneType branch = None                                                                  
list links = []
NoneType number = None                                                                  
NoneType revision = None                                                                  

Method Details

get_HTML_box(self, url)

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

__implemented__

Type:
Implements
Value:
<implementedBy buildbot.changes.changes.Change>                        

__providedBy__

Type:
ClassProvides
Value:
<zope.interface.declarations.ClassProvides object at 0x2b91780c1b50>   

__provides__

Type:
ClassProvides
Value:
<zope.interface.declarations.ClassProvides object at 0x2b91780c1b50>   

branch

Type:
NoneType
Value:
None                                                                  

links

Type:
list
Value:
[]                                                                     

number

Type:
NoneType
Value:
None                                                                  

revision

Type:
NoneType
Value:
None                                                                  

Generated by Epydoc 2.1 on Tue Sep 16 09:16:00 2008 http://epydoc.sf.net