Home | Trees | Indices | Help |
---|
|
object --+ | NamespaceObject --+ | RevisionIterable --+ | VersionIterable --+ | BranchIterable --+ | CategoryIterable --+ | Archive
Arch archive namespace object. In the Arch revision control system, archives are the units of storage. They store revisions organized in categories, branches and versions, and are associated to a `name` and a `location`. :see: `Category`, `Branch`, `Version`, `Revision`
Instance Methods | |||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
Inherited from Inherited from Inherited from Inherited from Inherited from |
Properties | |
categories Deprecated. |
|
fullname Fully qualfied name of this namespace object. |
|
has_listings Deprecated. |
|
is_mirror Deprecated. |
|
is_signed Deprecated. |
|
library_categories Deprecated. |
|
location Deprecated. |
|
name Logical name of the archive. |
|
official_name Deprecated. |
|
version_string Deprecated. |
|
Inherited from |
Method Details |
Instanciate a Category belonging to this archive. :param category: unqualified category name :type category: str :rtype: `Category` |
Create an archive object from its registered name. :param name: archive name, like "jdoe@example.com--2003" :type name: str :raise errors.NamespaceError: invalid archive name.
|
All registered locations for this archive. :rtype: list of `ArchiveLocation` |
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.
|
Deprecated. Categories in this archive. :rtype: tuple of `Category` :see: `iter_categories` |
Deprecated Fully qualified name of this namespace object. :rtype: str :see: `NamespaceObject.fullname`
|
Deprecated. Does the archive provide .listing file for http access? :see: `ArchiveLocation._meta_info_present` :rtype: bool |
Deprecated. Is this archive registration a mirror? :see: `ArchiveLocation._meta_info_present` :rtype: bool |
Deprecated. Is the archive GPG-signed? :see: `ArchiveLocation._meta_info_present` :rtype: bool |
Deprecated. Categories in this archive present in the library. :rtype: tuple of `Category` :see: `iter_library_categories` |
Deprecated. URI of the archive, specifies location and access method. :rtype: str :see: `Archive.all_locations` |
Deprecated. Logical name of the archive. :rtype: str :see: `Archive.name` |
Deprecated. Official archive name of this archive registration. :see: `ArchiveLocation._meta_info_present` :rtype: str |
Is this archive registered? :return: Whether the location associated to this registration name is known. :rtype: bool :see: `register_archive`, `Archive.unregister` |
Iterate over archive categories. :return: all existing categories in this namespace. :rtype: iterable of `Category` :precondition: `self.exists()` returns ``True``.
|
Iterate over library categories. :return: categories in this namespace which are present in the revision library. :rtype: iterable of `Category`
|
Revisions present in the 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. |
Versions present in the 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. |
Deprecated. :see: `ArchiveLocation.create_mirror` :param name: name of the new mirror (for example 'david@allouche.net--2003b-MIRROR'). :type name: str :param location: writeable URI were to create the archive mirror. :type location: str :param signed: create GPG signatures for the mirror contents :type signed: bool :param listing: maintains ''.listing'' files to enable HTTP access. :type listing: bool :param tla: create a tla archive instead of a baz archive. :type tla: bool :return: object for the newly created archive mirror. :rtype: `Archive` :precondition: `self.is_registered()` :precondition: ``name`` is not a registered archive name :precondition: ``location`` does not exist and can be created :postcondition: Archive(name).is_registered() :raise errors.NamespaceError: ``name`` is not a valid archive name. |
Deprecated. :see: `ArchiveLocation.make_mirrorer` :param limit: restrict mirrorring to those archive items. All items must belong to this archive. :type limit: iterable of at least one ArchiveItem or str :param fromto: update the mirror specified by the second item with the contents of the archive specified by the first item. :type fromto: sequence of exactly two Archive or str. :precondition: If ``fromto`` is provided, both items must be registered archives names whose official name is this archive. :param no_cached: do not copy cached revisions. :type no_cached: bool :param cached_tags: copy only cachedrevs for tags to other archives. :type cached_tags: bool |
Unregister this archive. :precondition: `self.is_registered()` :postcondition: not `self.is_registered()` :see: `register_archive` |
Property Details |
categoriesDeprecated. Categories in this archive. :type: tuple of `Category` :see: `iter_categories`
|
fullnameFully qualfied name of this namespace object. :type: str
|
has_listingsDeprecated. :see: `ArchiveLocation._meta_info_present` :type: bool
|
is_mirrorDeprecated. :see: `ArchiveLocation._meta_info_present` :type: bool
|
is_signedDeprecated. :see: `ArchiveLocation._meta_info_present` :type: bool
|
library_categoriesDeprecated. Categories in this archive present in the library. :type; tuple of `Category` :see: `iter_library_categories`
|
locationDeprecated. For example 'http://ddaa.net/arch/2004', or 'sftp://user@sourcecontrol.net/public_html/2004'. :see: `Archive.all_locations` :type: str
|
nameLogical name of the archive. :type: str
|
official_nameDeprecated. :see: `ArchiveLocation._meta_info_present` :type: str
|
version_stringDeprecated. Contents of the ``.archive-version`` file at the root of the archive. :see: `ArchiveLocation._version_string` :type: str
|
Home | Trees | Indices | Help |
---|
Generated by Epydoc 3.0beta1 on Wed Sep 5 09:53:13 2007 | http://epydoc.sourceforge.net |