Part of bzrlib.remote View In Hierarchy
Method | __init__ | Construct a RemoteBzrDir. |
Method | __repr__ | Undocumented |
Method | break_lock | Invoke break_lock on the first object in the bzrdir. |
Method | cloning_metadir | Produce a metadir suitable for cloning or sprouting with. |
Method | create_repository | Create a new repository in this control directory. |
Method | destroy_repository | See BzrDir.destroy_repository |
Method | create_branch | Create a branch in this ControlDir. |
Method | destroy_branch | See BzrDir.destroy_branch |
Method | create_workingtree | Create a working tree at this ControlDir. |
Method | find_branch_format | Find the branch 'format' for this bzrdir. |
Method | get_branch_reference | See BzrDir.get_branch_reference(). |
Method | open_branch | Open the branch object at this ControlDir if one is present. |
Method | open_repository | Open the repository object at this ControlDir if one is present. |
Method | has_workingtree | Tell if this controldir contains a working tree. |
Method | open_workingtree | Open the workingtree object at this ControlDir if one is present. |
Method | get_branch_transport | Get the transport for use by branch format in this BzrDir. |
Method | get_repository_transport | Get the transport for use by repository format in this BzrDir. |
Method | get_workingtree_transport | Get the transport for use by workingtree format in this BzrDir. |
Method | can_convert_format | Upgrading of remote bzrdirs is not supported yet. |
Method | needs_format_conversion | Upgrading of remote bzrdirs is not supported yet. |
Method | clone | Clone this controldir and its contents to url verbatim. |
Method | _probe_bzrdir | Undocumented |
Method | _rpc_open_2_1 | Undocumented |
Method | _rpc_open | Undocumented |
Method | _ensure_real | Ensure that there is a _real_bzrdir set. |
Method | _translate_error | Undocumented |
Method | _vfs_cloning_metadir | Undocumented |
Method | _get_branch_reference | Undocumented |
Method | _get_tree_branch | See BzrDir._get_tree_branch(). |
Method | _open_repo_v1 | Undocumented |
Method | _open_repo_v2 | Undocumented |
Method | _open_repo_v3 | Undocumented |
Method | _path_for_remote_call | Return the path to be used for this bzrdir in a remote call. |
Method | _get_config | By default, no configuration is available. |
Inherited from BzrDir:
Method | check_conversion_target | Check that a bzrdir as a whole can be converted to a new format. |
Method | clone_on_transport | Clone this bzrdir and its contents to transport verbatim. |
Method | determine_repository_policy | Return an object representing a policy to use. |
Method | sprout | Create a copy of this controldir prepared for use as a new line of |
Method | generate_backup_name | Undocumented |
Method | backup_bzrdir | Backup this bzr control directory. |
Method | retire_bzrdir | Permanently disable the bzrdir. |
Method | find_repository | Find the repository that should be used. |
Method | get_config | Get configuration for this BzrDir. |
Method | user_transport | Undocumented |
Method | control_transport | Undocumented |
Method | is_control_filename | True if filename is the name of a path which is reserved for bzrdir's. |
Class Method | create | Create a new BzrDir at the url 'base'. |
Method | _make_tail | Undocumented |
Method | _find_or_create_repository | Create a new repository if needed, returning the repository. |
Method | _find_source_repo | Find the source branch and repo for a sprout operation. |
Method | _sprout | Undocumented |
Method | _available_backup_name | Find a non-existing backup file name based on base. |
Method | _find_containing | Find something in a containing control directory. |
Method | _find_creation_modes | Determine the appropriate modes for files and directories. |
Method | _get_file_mode | Return Unix mode for newly created files, or None. |
Method | _get_dir_mode | Return Unix mode for newly created directories, or None. |
Method | _cloning_metadir | Produce a metadir suitable for cloning with. |
Inherited from ControlDir (via BzrDir):
Method | list_branches | Return a sequence of all branches local to this control directory. |
Method | destroy_workingtree | Destroy the working tree at this ControlDir. |
Method | destroy_workingtree_metadata | Destroy the control files for the working tree at this ControlDir. |
Method | has_branch | Tell if this controldir contains a branch. |
Method | checkout_metadir | Produce a metadir suitable for checkouts of this controldir. |
Method | push_branch | Push the source branch into this ControlDir. |
Class Method | find_bzrdirs | Find control dirs recursively from current location. |
Class Method | find_branches | Find all branches under a transport. |
Class Method | create_branch_and_repo | Create a new ControlDir, Branch and Repository at the url 'base'. |
Class Method | create_branch_convenience | Create a new ControlDir, Branch and Repository at the url 'base'. |
Class Method | create_standalone_workingtree | Create a new ControlDir, WorkingTree, Branch and Repository at 'base'. |
Class Method | open_unsupported | Open a branch which is not supported. |
Class Method | open | Open an existing controldir, rooted at 'base' (url). |
Class Method | open_from_transport | Open a controldir within a particular directory. |
Class Method | open_containing | Open an existing branch which contains url. |
Class Method | open_containing_from_transport | Open an existing branch which contains a_transport.base. |
Class Method | open_tree_or_branch | Return the branch and working tree at a location. |
Class Method | open_containing_tree_or_branch | Return the branch and working tree contained by a location. |
Class Method | open_containing_tree_branch_or_repository | Return the working tree, branch and repo contained by a location. |
Method | _get_selected_branch | Return the name of the branch selected by the user. |
Inherited from ControlComponent (via BzrDir, ControlDir):
Method | control_url | Undocumented |
Method | user_url | Undocumented |
Inherited from _RpcHelper:
Method | _call | Undocumented |
Method | _call_expecting_body | Undocumented |
Method | _call_with_body_bytes | Undocumented |
Method | _call_with_body_bytes_expecting_body | Undocumented |
Parameters | _client | Private parameter for testing. Disables probing and the use of a real bzrdir. |
Used before calls to self._real_bzrdir.
If there is a tree, the tree is opened and break_lock() called. Otherwise, branch is tried, and finally repository.
These operations may produce workingtrees (yes, even though they're "cloning" something that doesn't have a tree), so a viable workingtree format must be selected.
Returns | a ControlDirFormat with all component formats either set appropriately or set to None if that component should not be created. | |
Unknown Field: require_stacking | If True, non-stackable formats will be upgraded to similar stackable formats. |
Parameters | shared | If a shared repository should be created |
Returns | The newly created repository |
The controldirs format will control what branch format is created. For more control see BranchFormatXX.create(a_controldir).
Parameters | name | Name of the colocated branch to create, None for the default branch. |
append_revisions_only | Whether this branch should only allow appending new revisions to its history. |
Parameters | revision_id | create it as of this revision id. |
from_branch | override controldir branch (for lightweight checkouts) | |
accelerator_tree | A tree which can be used for retrieving file contents more quickly than the revision tree, i.e. a workingtree. The revision tree will be used for cases where accelerator_tree's content is different. |
This might be a synthetic object for e.g. RemoteBranch and SVN.
If unsupported is True, then no longer supported branch formats can still be opened.
TODO: static convenience version of this?
This will not follow the Branch object pointer - it's strictly a direct open facility. Most client code should use open_branch().repository to get at a repository.
TODO: static convenience version of this?
Parameters | _unsupported | a private parameter, not part of the api. |
This will still raise an exception if the controldir has a workingtree that is remote & inaccessible.
Note: if you're going to open the working tree, you should just go ahead and try, and not ask permission first. (This method just opens the workingtree and discards it, and that's somewhat expensive.)
Parameters | recommend_upgrade | Optional keyword parameter, when True (the default), emit through the ui module a recommendation that the user upgrade the working tree when the workingtree being opened is old (but still fully supported). |
from_branch | override controldir branch (for lightweight checkouts) |
Note that bzr dirs that do not support format strings will raise IncompatibleFormat if the branch format they are given has a format string, and vice versa.
If branch_format is None, the transport is returned with no checking. If it is not None, then the returned transport is guaranteed to point to an existing directory ready for use.
Note that bzr dirs that do not support format strings will raise IncompatibleFormat if the repository format they are given has a format string, and vice versa.
If repository_format is None, the transport is returned with no checking. If it is not None, then the returned transport is guaranteed to point to an existing directory ready for use.
Note that bzr dirs that do not support format strings will raise IncompatibleFormat if the workingtree format they are given has a format string, and vice versa.
If workingtree_format is None, the transport is returned with no checking. If it is not None, then the returned transport is guaranteed to point to an existing directory ready for use.
Parameters | url | The url create the clone at. If url's last component does not exist, it will be created. |
revision_id | The tip revision-id to use for any branch or working tree. If not None, then the clone operation may tune itself to download less data. | |
force_new_repo | Do not use a shared repository for the target even if one is available. | |
preserve_stacking | When cloning a stacked branch, stack the new branch on top of the other branch's stacked-on branch. |