~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/serializer.py

  • Committer: John Arbash Meinel
  • Date: 2009-07-29 21:35:05 UTC
  • mfrom: (4576 +trunk)
  • mto: This revision was merged to the branch mainline in revision 4577.
  • Revision ID: john@arbash-meinel.com-20090729213505-tkqsvy1zfpocu75w
Merge bzr.dev 4576 in prep for NEWS

Show diffs side-by-side

added added

removed removed

Lines of Context:
27
27
    squashes_xml_invalid_characters = False
28
28
 
29
29
    def write_inventory(self, inv, f):
30
 
        """Write inventory to a file.
31
 
 
32
 
        Note: this is a *whole inventory* operation, and should only be used
33
 
        sparingly, as it does not scale well with large trees.
34
 
        """
 
30
        """Write inventory to a file"""
35
31
        raise NotImplementedError(self.write_inventory)
36
32
 
37
33
    def write_inventory_to_string(self, inv):
38
 
        """Produce a simple string representation of an inventory.
39
 
 
40
 
        Note: this is a *whole inventory* operation, and should only be used
41
 
        sparingly, as it does not scale well with large trees.
42
 
 
43
 
        The requirement for the contents of the string is that it can be passed
44
 
        to read_inventory_from_string and the result is an identical inventory
45
 
        in memory.
46
 
 
47
 
        (All serializers as of 2009-07-29 produce XML, but this is not mandated
48
 
        by the interface.)
49
 
        """
50
34
        raise NotImplementedError(self.write_inventory_to_string)
51
35
 
52
36
    def read_inventory_from_string(self, string, revision_id=None,
68
52
        raise NotImplementedError(self.read_inventory_from_string)
69
53
 
70
54
    def read_inventory(self, f, revision_id=None):
71
 
        """See read_inventory_from_string."""
72
55
        raise NotImplementedError(self.read_inventory)
73
56
 
74
57
    def write_revision(self, rev, f):