Home | Trees | Index | Help |
---|
Package pybaz :: Class Version |
|
object
--+ |NamespaceObject
--+ |ArchiveItem
--+ |CategoryItem
--+ |BranchItem
--+ |object
--+ | | |NamespaceObject
--+ | | |RevisionIterable
--+ | | |object
--+ | | | | |NamespaceObject
--+ | | | | |ArchiveItem
--+ | | | | |Setupable
--+ | | |Package
--+ |object
--+ | | |NamespaceObject
--+ | | |RevisionIterable
--+ | Version
Arch version namespace object. :see: `Archive`, `Category`, `Branch`, `Revision`
Method Summary | |
---|---|
Create a Version object from its name. | |
Instanciate a revision belonging to this version. | |
Deprecated. | |
Does this namespace exists? Within the Arch model, history cannot be changed: created archive entries cannot be deleted. | |
Construct a project tree for this version. | |
Deprecated. | |
Deprecated. | |
Iterate over the cached revisions in this version. | |
Iterate over library revisions. | |
Revisions present in this version at specified archive location. | |
Iterate over merge points in this version. | |
Iterate over archive revisions. | |
Inherited from BranchItem | |
Deprecated. | |
Inherited from CategoryItem | |
Deprecated. | |
Inherited from Package | |
Deprecated. | |
Latest revision in this package. | |
Inherited from Setupable | |
Deprecated. | |
Inherited from ArchiveItem | |
Deprecated. | |
Deprecated Fully qualified name of this namespace object. | |
Deprecated. | |
Inherited from NamespaceObject | |
Compare types and fully-qualified names. | |
Compare types and fully-qualified names. | |
Fully-qualified name in angle brackets. | |
Fully-qualified name. | |
Inherited from object | |
x.__delattr__('name') <==> del x.name... | |
x.__getattribute__('name') <==> x.name... | |
x.__hash__() <==> hash(x)... | |
T.__new__(S, ...) -> a new object with type S, a subtype of T... | |
helper for pickle... | |
helper for pickle... | |
x.__setattr__('name', value) <==> x.name = value... |
Property Summary | |
---|---|
library_revisions : Deprecated. | |
revisions : Deprecated. | |
Inherited from BranchItem | |
branch : Branch which contains this namespace object. | |
Inherited from CategoryItem | |
category : Category which contains this object. | |
Inherited from ArchiveItem | |
archive : Archive which contains this namespace object. | |
fullname : Fully qualfied name of this namespace object. | |
nonarch : Non-arch part of this namespace name. |
Method Details |
---|
__init__(self,
name)
|
__getitem__(self,
idx)
|
as_version(self)Deprecated. This version. :rtype: `Version` |
exists(self)Does this namespace exists? Within the Arch model, history cannot be changed: created archive entries cannot be deleted. However, it is possible to ``unregister`` an archive, or to find references to archives whose location is not known. Thus, existence cannot always be decided. Testing for the existence of a name in a non-registered archive raises `errors.ArchiveNotRegistered`. :return: whether this namespace object exists. :rtype: bool :raise errors.ArchiveNotRegistered: the archive name is not registered, so existence cannot be decided. :raise errors.ExecProblem: there was a problem accessing the archive.
|
get(self, dir, link=False)Construct a project tree for this version. Extract the latest revision for this version from the archive. That is a shortcut for ``version.latest_revision.get(dir)``. It can be susceptible to race conditions when a concurrent transaction occurs on the same version, yielding a latter revision that what you may have meant. :param dir: path of the project tree to create. Must not already exist. :type dir: str :param link: hardlink files to revision library instead of copying :type link: bool :return: newly created project tree. :rtype: `WorkingTree` |
get_library_revisions(self, reverse=False)Deprecated. Revisions in this version present in the library. :rtype: tuple of `Revision` :see: `iter_library_revisions` |
get_revisions(self, reverse=False)Deprecated. Revisions in this version. :rtype: tuple of `Revision` :see: `iter_revisions` |
iter_cachedrevs(self)Iterate over the cached revisions in this version. :rtype: iterator of `Revision` |
iter_library_revisions(self, reverse=False)Iterate over library revisions. :param reverse: reverse order, recent revisions first. :type reverse: bool :return: revisions in this namespace which are present in the revision library. :rtype: iterable of `Revision`
|
iter_location_revisions(self, location)Revisions present in this version at specified archive location. :warning: This is a temporary facility that does no sanity checking. It will be removed shortly after bound namespace objects are properly implemented. |
iter_merges(self, other=None, reverse=False, metoo=True)Iterate over merge points in this version. This method is mostly useful to save multiple invocations of the command-line tool and multiple connection to a remote archives when building an ancestry graph. Ideally, it would not be present and the desired merge graph traversal would be done using the new_patches and merges properties of Patchlog objects. :param other: list merges with that version. :type other: `Version` :param reverse: reverse order, recent revisions first. :type reverse: bool :param metoo: do not report the presence of a patch within itself :type metoo: bool :return: Iterator of tuples (R, T) where R are revisions in this version and T are iterable of revisions in the ``other`` version. :rtype: iterable of `Revision` |
iter_revisions(self, reverse=False)Iterate over archive revisions. :param reverse: reverse order, recent revisions first. :type reverse: bool :return: all existing revisions in this namespace. :rtype: iterable of `Revision` :precondition: `self.exists()` returns ``True``.
|
Property Details |
---|
library_revisionsDeprecated. Revisions in this version present in the library. :type: tuple of `Revision` :see: `iter_library_revisions` |
revisionsDeprecated. Revisions in this version. :type: tuple of `Revision` :see: `iter_revisions` |
Home | Trees | Index | Help |
---|
Generated by Epydoc 2.1 on Tue Jul 18 16:30:58 2006 | http://epydoc.sf.net |