Part of bzrlib
Class | Convert | No class docstring; 2/3 methods documented |
Function | upgrade | Upgrade locations to format. |
Function | smart_upgrade | Convert control directories to a new format intelligently. |
Function | _smart_upgrade_one | Convert a control directory to a new format intelligently. |
Function | _get_object_and_label | Return the primary object and type label for a control directory. |
Function | _convert_items | Convert a sequence of control directories to the given format. |
This routine wraps the smart_upgrade() routine with a nicer UI. In particular, it ensures all URLs can be opened before starting and reports a summary at the end if more than one upgrade was attempted. This routine is useful for command line tools. Other bzrlib clients probably ought to use smart_upgrade() instead.
Parameters | url | a URL of the locations to upgrade. |
format | the format to convert to or None for the best default | |
clean-up | if True, the backup.bzr directory is removed if the upgrade succeeded for a given repo/branch/tree | |
dry_run | show what would happen but don't actually do any upgrades | |
Returns | the list of exceptions encountered |
If the control directory is a shared repository, dependent branches are also converted provided the repository converted successfully. If the conversion of a branch fails, remaining branches are still tried.
Parameters | control_dirs | the BzrDirs to upgrade |
format | the format to convert to or None for the best default | |
clean_up | if True, the backup.bzr directory is removed if the upgrade succeeded for a given repo/branch/tree | |
dry_run | show what would happen but don't actually do any upgrades | |
Returns | attempted-control-dirs, succeeded-control-dirs, exceptions |
See smart_upgrade for parameter details.
Return the primary object and type label for a control directory. :return: object, label where: * object is a Branch, Repository or WorkingTree and * label is one of: * branch - a branch * repository - a repository * tree - a lightweight checkout
Parameters | items | the control directories to upgrade |
format | the format to convert to or None for the best default | |
clean-up | if True, the backup.bzr directory is removed if the upgrade succeeded for a given repo/branch/tree | |
dry_run | show what would happen but don't actually do any upgrades | |
label | the label for these items or None to calculate one | |
Returns | items successfully upgraded, exceptions |