← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/transport/__init__.py

Various cosmetic changes.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/transport/__init__.py
189
189
    implementations can do pipelining.
190
190
    In general implementations should support having a generator or a list
191
191
    as an argument (ie always iterate, never index)
 
192
 
 
193
    :ivar base: Base URL for the transport; should always end in a slash.
192
194
    """
193
195
 
194
196
    # implementations can override this if it is more efficient
334
336
        Note that some transports MAY allow querying on directories, but this
335
337
        is not part of the protocol.  In other words, the results of 
336
338
        t.has("a_directory_name") are undefined.
 
339
 
 
340
        :rtype: bool
337
341
        """
338
342
        raise NotImplementedError(self.has)
339
343
 
516
520
        return len(self._iterate_over(relpaths, mkdir, pb, 'mkdir', expand=False))
517
521
 
518
522
    def append(self, relpath, f, mode=None):
519
 
        """Append the text in the file-like or string object to 
520
 
        the supplied location.
521
 
 
522
 
        returns the length of f before the content was written to it.
523
 
        
524
 
        If the file does not exist, it is created with the supplied mode.
 
523
        """Append bytes to a file.
 
524
 
 
525
        The file is created if it does not already exist.
 
526
 
 
527
        :param f: a file-like object or string of the bytes to append.
 
528
        :param mode: Unix mode for newly created files.  This is not used for
 
529
            existing files.
 
530
 
 
531
        :returns: the length of f before the content was written to it.
525
532
        """
526
533
        raise NotImplementedError(self.append)
527
534