/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/urlutils.py

  • Committer: Ian Clatworthy
  • Date: 2009-07-13 06:58:49 UTC
  • mto: (4527.1.1 integration)
  • mto: This revision was merged to the branch mainline in revision 4529.
  • Revision ID: ian.clatworthy@canonical.com-20090713065849-n7g2rsjyl6dt1mgv
Apply review feedback

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2006-2010 Canonical Ltd
 
1
# Copyright (C) 2006, 2008 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
75
75
    This assumes that both paths are already fully specified file:// URLs.
76
76
    """
77
77
    if len(base) < MIN_ABS_FILEURL_LENGTH:
78
 
        raise ValueError('Length of base (%r) must equal or'
 
78
        raise ValueError('Length of base must be equal or'
79
79
            ' exceed the platform minimum url length (which is %d)' %
80
 
            (base, MIN_ABS_FILEURL_LENGTH))
 
80
            MIN_ABS_FILEURL_LENGTH)
81
81
    base = local_path_from_url(base)
82
82
    path = local_path_from_url(path)
83
83
    return escape(osutils.relpath(base, path))
217
217
# jam 20060502 Sorted to 'l' because the final target is 'local_path_from_url'
218
218
def _posix_local_path_from_url(url):
219
219
    """Convert a url like file:///path/to/foo into /path/to/foo"""
220
 
    file_localhost_prefix = 'file://localhost/'
221
 
    if url.startswith(file_localhost_prefix):
222
 
        path = url[len(file_localhost_prefix) - 1:]
223
 
    elif not url.startswith('file:///'):
224
 
        raise errors.InvalidURL(
225
 
            url, 'local urls must start with file:/// or file://localhost/')
226
 
    else:
227
 
        path = url[len('file://'):]
 
220
    if not url.startswith('file:///'):
 
221
        raise errors.InvalidURL(url, 'local urls must start with file:///')
228
222
    # We only strip off 2 slashes
229
 
    return unescape(path)
 
223
    return unescape(url[len('file://'):])
230
224
 
231
225
 
232
226
def _posix_local_path_to_url(path):
278
272
    # on non-win32 platform
279
273
    # FIXME: It turns out that on nt, ntpath.abspath uses nt._getfullpathname
280
274
    #       which actually strips trailing space characters.
281
 
    #       The worst part is that on linux ntpath.abspath has different
 
275
    #       The worst part is that under linux ntpath.abspath has different
282
276
    #       semantics, since 'nt' is not an available module.
283
277
    if path == '/':
284
278
        return 'file:///'
469
463
    return url_base + head, tail
470
464
 
471
465
 
472
 
def split_segment_parameters_raw(url):
473
 
    """Split the subsegment of the last segment of a URL.
474
 
 
475
 
    :param url: A relative or absolute URL
476
 
    :return: (url, subsegments)
477
 
    """
478
 
    (parent_url, child_dir) = split(url)
479
 
    subsegments = child_dir.split(",")
480
 
    if len(subsegments) == 1:
481
 
        return (url, [])
482
 
    return (join(parent_url, subsegments[0]), subsegments[1:])
483
 
 
484
 
 
485
 
def split_segment_parameters(url):
486
 
    """Split the segment parameters of the last segment of a URL.
487
 
 
488
 
    :param url: A relative or absolute URL
489
 
    :return: (url, segment_parameters)
490
 
    """
491
 
    (base_url, subsegments) = split_segment_parameters_raw(url)
492
 
    parameters = {}
493
 
    for subsegment in subsegments:
494
 
        (key, value) = subsegment.split("=", 1)
495
 
        parameters[key] = value
496
 
    return (base_url, parameters)
497
 
 
498
 
 
499
 
def join_segment_parameters_raw(base, *subsegments):
500
 
    """Create a new URL by adding subsegments to an existing one. 
501
 
 
502
 
    This adds the specified subsegments to the last path in the specified
503
 
    base URL. The subsegments should be bytestrings.
504
 
 
505
 
    :note: You probably want to use join_segment_parameters instead.
506
 
    """
507
 
    if not subsegments:
508
 
        return base
509
 
    for subsegment in subsegments:
510
 
        if type(subsegment) is not str:
511
 
            raise TypeError("Subsegment %r is not a bytestring" % subsegment)
512
 
        if "," in subsegment:
513
 
            raise errors.InvalidURLJoin(", exists in subsegments",
514
 
                                        base, subsegments)
515
 
    return ",".join((base,) + subsegments)
516
 
 
517
 
 
518
 
def join_segment_parameters(url, parameters):
519
 
    """Create a new URL by adding segment parameters to an existing one.
520
 
 
521
 
    The parameters of the last segment in the URL will be updated; if a
522
 
    parameter with the same key already exists it will be overwritten.
523
 
 
524
 
    :param url: A URL, as string
525
 
    :param parameters: Dictionary of parameters, keys and values as bytestrings
526
 
    """
527
 
    (base, existing_parameters) = split_segment_parameters(url)
528
 
    new_parameters = {}
529
 
    new_parameters.update(existing_parameters)
530
 
    for key, value in parameters.iteritems():
531
 
        if type(key) is not str:
532
 
            raise TypeError("parameter key %r is not a bytestring" % key)
533
 
        if type(value) is not str:
534
 
            raise TypeError("parameter value %r for %s is not a bytestring" %
535
 
                (key, value))
536
 
        if "=" in key:
537
 
            raise errors.InvalidURLJoin("= exists in parameter key", url,
538
 
                parameters)
539
 
        new_parameters[key] = value
540
 
    return join_segment_parameters_raw(base, 
541
 
        *["%s=%s" % item for item in sorted(new_parameters.items())])
542
 
 
543
 
 
544
466
def _win32_strip_local_trailing_slash(url):
545
467
    """Strip slashes after the drive letter"""
546
468
    if len(url) > WIN32_MIN_ABS_FILEURL_LENGTH: