Home | Trees | Indices | Help |
---|
|
object --+ | basestring --+ | str --+ | pathname.PathName --+ | pathname.DirName --+ | SourceTree --+ | ArchSourceTree --+ | WorkingTree
Working source tree, Arch source tree which can be modified.
Instance Methods | |||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|||
Inherited from Inherited from Inherited from Inherited from |
Static Methods | |
Inherited from |
Properties | |
tagging_method | |
tree_version Default version of the tree, also called tree-version. |
|
Inherited from Inherited from |
Method Details |
Create WorkingTree object with the given root path. Root must be a directory containing a valid Arch source tree outside of the revision library.
|
Ensure that the project tree has a particular pristine revision. :param revision: revision to add a pristine for. :type revision: `Revision` |
Uncommited changes in this tree. :param revision: produce the changeset between this revision and the tree. If ``revision`` is ``None``, use the tree-revision. :type revision: `Revision`, None :param output: absolute path of the changeset to produce. :type output: string :return: changeset between ``revision`` and the tree. :rtype: Changeset :raise errors.TreeVersionError: no valid default version set. :raise IOError: unable to read the ++default-version file. |
Archive a changeset-based revision. :keyword version: version in which to commit the revision. Defaults to the `tree_version`. :type version: `Version`, str :keyword log: Log message for this revision. Defaults to the log message file of the tree-version (the file created by ``tla make-log``. :type log: `LogMessage` :param strict: perform a strict tree-lint before commiting. :type strict: bool :param seal: create a ``version-0`` revision. :type seal: bool :param fix: create a ``versionfix`` revision. :type fix: bool :param out_of_date_ok: commit even if the tree is out of date. :type out_of_date_ok: bool :param file_list: Only commit changes to those files, specified relative to the tree-root. :type file_list: iterable of str, with at least one item. :param just_commit: only create new revision, do not add ancillary data like cachedrevs or ancestry files. :type just_commit: bool The --summary and --log-message options to tla are mere CLI convenience features and are not directly supported. :see: `WorkingTree.iter_commit` |
Path to a pristine tree for the given revision. :param revision: find a pristine for that revision. :type revision: `Revision` :rtype: `ArchSourceTree` :raise errors.NoPristineFoundError: no pristine tree was found for the given revision. |
Are there uncommited changes is this source tree? :rtype: bool |
Archive a full-source base-0 revision. If log is specified, it must be a LogMessage object or a file name as a string. If omitted, the default log message file of the tree is used. The --summary, --log-message and --setup options to tla are mere CLI convenience features and are not directly supported. |
Archive a changeset-based revision, returning an iterator. :keyword version: version in which to commit the revision. Defaults to the `tree_version`. :type version: `Version`, str :keyword log: Log message for this revision. Defaults to the log message file of the tree-version (the file created by ``tla make-log``. :type log: `LogMessage` :keyword strict: perform a strict tree-lint before commiting. :type strict: bool :keyword seal: create a ``version-0`` revision. :type seal: bool :keyword fix: create a ``versionfix`` revision. :type fix: bool :keyword out_of_date_ok: commit even if the tree is out of date. :type out_of_date_ok: bool :keyword file_list: Only commit changes to those files, specified relative to the tree-root. :type file_list: iterable of str, with at least one item. :param just_commit: only create new revision, do not add ancillary data like cachedrevs or ancestry files. :type just_commit: bool :param stderr_too: iterate over stderr output as well as stdout. :type stderr_too: bool :rtype: iterator of `TreeChange`, `Chatter` or str :warning: ``stderr_too=True`` is only supported with the PyArchSpawningStrategy. Using it will cause a ArgumentError with the TwistedSpawningStrategy. That will be fixed when the process handling subsystem is replaced by Gnarly. The --summary and --log-message options to tla are mere CLI convenience features and are not directly supported. :see: `WorkingTree.commit` |
Pristines present in that source tree. :return: Revisions which have pristine trees in that source tree. :rtype: iterable of `Revision` |
Merge mutually merged branches. :param `from_`: branch to merge changes from, ``None`` means the ``tree-version``. :type `from_`: None, `Version`, `Revision`, or str :param reference: reference version for the merge, ``None`` means the ``tree-version``. :type reference: None, `Version` or str :param forward: ignore already applied patch hunks. :type forward: bool :param diff3: produce inline conflict markers instead of ``.rej`` files. :type diff3: bool :raise errors.NamespaceError: ``from_`` or ``reference`` is not a valid version or revision name. :rtype: `ChangesetApplication` |
Standard arch log of newly merged patches. :rtype: str |
Default log-message object used by import and commit. If `create` is False, and the standard log file does not already exists, return None. If `create` is True, use ``tla make-log`` if needed. |
Redo changes in a project tree. Apply patch to the project tree and delete patch. If patch is provided, it must be a Changeset object. Else, the highest numbered ,,undo-N directory in the project tree root is used. If keep is true, the patch directory is not deleted. |
Merge mutually merged branches. :bug: if the merge causes a conflict, a RuntimeError is raised. You should not rely on this behaviour as it is likely to change in the future. If you want to support conflicting merges, use `iter_star_merge` instead. :param `from_`: branch to merge changes from, ``None`` means the ``tree-version``. :type `from_`: None, `Version`, `Revision`, or str :param reference: reference version for the merge, ``None`` means the ``tree-version``. :type reference: None, `Version` or str :param forward: ignore already applied patch hunks. :type forward: bool :param diff3: produce inline conflict markers instead of ``.rej`` files. :type diff3: bool :raise errors.NamespaceError: ``from_`` or ``reference`` is not a valid version or revision name. |
Adds the patchlogs in the given revision to the current tree. Create a temporary source tree for ``revision``, then add all the patchlogs present in that tree to the current tree. No content is touched besides the patchlogs. :param revision: revision to synchronize with. :type revision: `Version`, `Revision` or str :raise errors.NamespaceError: ``revision`` is not a valid version or revision name. |
Undo and save changes in a project tree. Remove local changes since revision and optionally save them as a changeset. :keyword revision: revision to revert to. Default to the last revision of the tree-version for which a patchlog is present. :type revision: `Revision`, str :keyword output: name of the output changeset directory. Must not already exist. Default to an automatic ,,undo-N name in the working tree. :type output: str :keyword quiet: OBSOLETE. Incremental output is always discarded. :type quiet: bool :keyword throw_away: discard the output changeset and return ``None``. Must not be used at the same time as ``output``. :type throw_away: bool :return: changeset restoring the undone changes, or None if ``throw_away``. :rtype: `Changeset`, None |
Apply delta of new revisions in the archive. Apply delta(A,B) on this working tree, where A and B are both revisions of the tree version, A is the latest whose patchlog is present in the tree and B is the latest present in the archive. |
Property Details |
tagging_method
|
tree_versionDefault version of the tree, also called tree-version. :raise errors.TreeVersionError: no valid default version set. :raise IOError: unable to read the ++default-version file.
|
Home | Trees | Indices | Help |
---|
Generated by Epydoc 3.0beta1 on Wed Sep 5 09:53:13 2007 | http://epydoc.sourceforge.net |