← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/transport/__init__.py

  • Committer: John Arbash Meinel
  • Date: 2006-09-05 21:20:24 UTC
  • mto: (1946.2.8 reduce-knit-churn)
  • mto: This revision was merged to the branch mainline in revision 1988.
  • Revision ID: john@arbash-meinel.com-20060905212024-39f58d0f5acd74a4
Deprecate 'Transport.append' in favor of Transport.append_file or Transport.append_bytes

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/transport/__init__.py
569
569
            self.mkdir(path, mode=mode)
570
570
        return len(self._iterate_over(relpaths, mkdir, pb, 'mkdir', expand=False))
571
571
 
 
572
    @deprecated_method(zero_eleven)
572
573
    def append(self, relpath, f, mode=None):
573
574
        """Append the text in the file-like object to the supplied location.
574
575
 
576
577
        
577
578
        If the file does not exist, it is created with the supplied mode.
578
579
        """
579
 
        raise NotImplementedError(self.append)
 
580
        return self.append_file(relpath, f, mode=mode)
 
581
 
 
582
    def append_file(self, relpath, f, mode=None):
 
583
        """Append the text in the file-like object to the supplied location.
 
584
 
 
585
        returns the length of relpath before the content was written to it.
 
586
        
 
587
        If the file does not exist, it is created with the supplied mode.
 
588
        """
 
589
        symbol_versioning.warn('Transport %s should implement append_file,'
 
590
                               ' rather than implementing append() as of'
 
591
                               ' version 0.11.'
 
592
                               % (self.__class__.__name__,),
 
593
                               DeprecationWarning)
 
594
        return self.append(relpath, f, mode=mode)
580
595
 
581
596
    def append_bytes(self, relpath, bytes, mode=None):
582
597
        """Append the text in the string object to the supplied location.
587
602
        """
588
603
        assert isinstance(bytes, str), \
589
604
            'bytes must be a plain string, not %s' % type(bytes)
590
 
        return self.append(relpath, StringIO(bytes), mode=mode)
 
605
        return self.append_file(relpath, StringIO(bytes), mode=mode)
591
606
 
592
607
    def append_multi(self, files, pb=None):
593
608
        """Append the text in each file-like or string object to
596
611
        :param files: A set of (path, f) entries
597
612
        :param pb:  An optional ProgressBar for indicating percent done.
598
613
        """
599
 
        return self._iterate_over(files, self.append, pb, 'append', expand=True)
 
614
        return self._iterate_over(files, self.append_file, pb, 'append', expand=True)
600
615
 
601
616
    def copy(self, rel_from, rel_to):
602
617
        """Copy the item at rel_from to the location at rel_to.