/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to bzrlib/api.py

  • Committer: Robert Collins
  • Date: 2007-09-19 05:14:14 UTC
  • mto: (2835.1.1 ianc-integration)
  • mto: This revision was merged to the branch mainline in revision 2836.
  • Revision ID: robertc@robertcollins.net-20070919051414-2tgjqteg7k3ps4h0
* ``pull``, ``merge`` and ``push`` will no longer silently correct some
  repository index errors that occured as a result of the Weave disk format.
  Instead the ``reconcile`` command needs to be run to correct those
  problems if they exist (and it has been able to fix most such problems
  since bzr 0.8). Some new problems have been identified during this release
  and you should run ``bzr check`` once on every repository to see if you
  need to reconcile. If you cannot ``pull`` or ``merge`` from a remote
  repository due to mismatched parent errors - a symptom of index errors -
  you should simply take a full copy of that remote repository to a clean
  directory outside any local repositories, then run reconcile on it, and
  finally pull from it locally. (And naturally email the repositories owner
  to ask them to upgrade and run reconcile).
  (Robert Collins)

* ``VersionedFile.fix_parents`` has been removed as a harmful API.
  ``VersionedFile.join`` will no longer accept different parents on either
  side of a join - it will either ignore them, or error, depending on the
  implementation. See notes when upgrading for more information.
  (Robert Collins)

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/api.py
12
12
#
13
13
# You should have received a copy of the GNU General Public License
14
14
# along with this program; if not, write to the Free Software
15
 
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
16
16
 
17
17
"""Library API versioning support.
18
18
 
70
70
        version. See get_minimum_api_version and get_current_api_version for
71
71
        details.
72
72
    :param wanted_api: The API version for which support is required.
73
 
    :return: None
 
73
    :return None:
74
74
    :raises IncompatibleAPI: When the wanted_api is not supported by
75
75
        object_with_api.
76
76
 
80
80
    minimum = get_minimum_api_version(object_with_api)
81
81
    if wanted_api < minimum or wanted_api > current:
82
82
        raise IncompatibleAPI(object_with_api, wanted_api, minimum, current)
83
 
 
84
 
 
85
 
def require_any_api(object_with_api, wanted_api_list):
86
 
    """Check if object_with_api supports the api version wanted_api.
87
 
 
88
 
    :param object_with_api: An object which exports an API minimum and current
89
 
        version. See get_minimum_api_version and get_current_api_version for
90
 
        details.
91
 
    :param wanted_api: A list of API versions, any of which being available is
92
 
        sufficent.
93
 
    :return: None
94
 
    :raises IncompatibleAPI: When the wanted_api is not supported by
95
 
        object_with_api.
96
 
 
97
 
    Added in bzrlib 1.9.
98
 
    """
99
 
    for api in wanted_api_list[:-1]:
100
 
        try:
101
 
            return require_api(object_with_api, api)
102
 
        except IncompatibleAPI:
103
 
            pass
104
 
    require_api(object_with_api, wanted_api_list[-1])