Package buildbot :: Module sourcestamp :: Class SourceStamp

Class SourceStamp

              util.ComparableMixin --+
                                     |
twisted.persisted.styles.Versioned --+
                                     |
                                    SourceStamp

This is a tuple of (branch, revision, patchspec, changes, project, repository).

branch is always valid, although it may be None to let the Source step use its default branch. There are three possibilities for the remaining elements:

(revision=REV, patchspec=None, changes=None): build REV. If REV is None, build the HEAD revision from the given branch. Note that REV must always be a string: SVN, Perforce, and other systems which use integers should provide a string here, but the Source checkout step will integerize it when making comparisons.
(revision=REV, patchspec=(LEVEL, DIFF), changes=None): checkout REV, then apply a patch to the source, with patch -pPATCHLEVEL <DIFF. If REV is None, checkout HEAD and patch it.
(revision=None, patchspec=None, changes=[CHANGES]): let the Source step check out the latest revision indicated by the given Changes. CHANGES is a tuple of buildbot.changes.changes.Change instances, and all must be on the same branch.

Instance Methods

__init__(self, branch=None, revision=None, patch=None, patch_info=None, changes=None, project='', repository='', _fromSsdict=False, _ignoreChanges=False) source code

canBeMergedWith(self, other)

source code

mergeWith(self, others)
Generate a SourceStamp for the merger of me and all the other SourceStamps.

source code

getAbsoluteSourceStamp(self, got_revision)

source code

getText(self)

source code

asDict(self)

source code

__setstate__(self, d)

source code

upgradeToVersion1(self)

source code

upgradeToVersion2(self)

source code

getSourceStampSetId(*args, **kwargs)
temporary; do not use widely!

source code

__provides__(...)
Special descriptor for class __provides__

Inherited from util.ComparableMixin: __cmp__, __hash__, __providedBy__

Inherited from twisted.persisted.styles.Versioned: __getstate__, versionUpgrade

Class Methods

fromSsdict(cls, master, ssdict)
Class method to create a SourceStamp from a dictionary as returned by SourceStampConnectorComponent.getSourceStamp. source code

Class Variables
	persistenceVersion = `2`
	persistenceForgets = `('wasUpgraded')`
	sourcestampsetid = `None` hash(x)
	compare_attrs = `('branch', 'revision', 'patch', 'patch_info', ...`
	__implemented__ = `<implementedBy buildbot.sourcestamp.SourceSt...`

Instance Variables
	branch = `None` branch name or None
	revision = `None` revision string or None
	patch = `None` tuple (patch level, patch body) or None
	patch_info = `None` tuple (patch author, patch comment) or None
	changes = `()` tuple of changes that went into this source stamp, sorted by number
	project = `''` project name
	repository = `''` repository URL
	ssid = `None` sourcestamp ID, or None if this sourcestamp has not yet been added to the database

Method Details

fromSsdict(cls, master, ssdict)
Class Method

source code

Class method to create a SourceStamp from a dictionary as returned by SourceStampConnectorComponent.getSourceStamp.

Parameters:

master - build master instance
ssdict - source stamp dictionary

Returns:

SourceStamp via Deferred

mergeWith(self, others)

source code

Generate a SourceStamp for the merger of me and all the other SourceStamps. This is called by a Build when it starts, to figure out what its sourceStamp should be.

setstate(self, d)

source code

Overrides: twisted.persisted.styles.Versioned.__setstate__

getSourceStampSetId(*args, **kwargs)

source code

temporary; do not use widely!

Decorators:

@util.deferredLocked('_getSourceStampSetId_lock')

provides(...)

Special descriptor for class __provides__

The descriptor caches the implementedBy info, so that
we can get declarations for objects without instance-specific
interfaces a bit quicker.

For example:

  >>> from zope.interface import Interface
  >>> class IFooFactory(Interface):
  ...     pass
  >>> class IFoo(Interface):
  ...     pass
  >>> class C(object):
  ...     implements(IFoo)
  ...     classProvides(IFooFactory)
  >>> [i.getName() for i in C.__provides__]
  ['IFooFactory']

  >>> [i.getName() for i in C().__provides__]
  ['IFoo']

Overrides: twisted.persisted.styles.Versioned.__provides__

Class Variable Details

compare_attrs

Value:

('branch',
 'revision',
 'patch',
 'patch_info',
 'changes',
 'project',
 'repository')

implemented

Value:

<implementedBy buildbot.sourcestamp.SourceStamp>

Class SourceStamp

fromSsdict(cls, master, ssdict) Class Method

mergeWith(self, others)

__setstate__(self, d)

getSourceStampSetId(*args, **kwargs)

__provides__(...)

compare_attrs

__implemented__

fromSsdict(cls, master, ssdict)
Class Method

setstate(self, d)

provides(...)

implemented