← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/store.py

  • Committer: Martin Pool
  • Date: 2005-04-15 01:31:21 UTC
  • Revision ID: mbp@sourcefrog.net-20050415013121-b18f1be12a735066
- Doc cleanups from Magnus Therning

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/store.py
1
 
# Copyright (C) 2005 by Canonical Development Ltd
 
1
 
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
14
14
# along with this program; if not, write to the Free Software
15
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
16
16
 
17
 
"""
18
 
Stores are the main data-storage mechanism for Bazaar-NG.
 
17
"""Stores are the main data-storage mechanism for Bazaar-NG.
19
18
 
20
19
A store is a simple write-once container indexed by a universally
21
 
unique ID.
22
 
"""
 
20
unique ID, which is typically the SHA-1 of the content."""
 
21
 
 
22
__copyright__ = "Copyright (C) 2005 Canonical Ltd."
 
23
__author__ = "Martin Pool <mbp@canonical.com>"
23
24
 
24
25
import os, tempfile, types, osutils, gzip, errno
25
26
from stat import ST_SIZE
33
34
    pass
34
35
 
35
36
 
36
 
class ImmutableStore(object):
 
37
class ImmutableStore:
37
38
    """Store that holds files indexed by unique names.
38
39
 
39
40
    Files can be added, but not modified once they are in.  Typically
58
59
 
59
60
    TODO: Atomic add by writing to a temporary file and renaming.
60
61
 
61
 
    In bzr 0.0.5 and earlier, files within the store were marked
62
 
    readonly on disk.  This is no longer done but existing stores need
63
 
    to be accomodated.
 
62
    TODO: Perhaps automatically transform to/from XML in a method?
 
63
           Would just need to tell the constructor what class to
 
64
           use...
 
65
 
 
66
    TODO: Even within a simple disk store like this, we could
 
67
           gzip the files.  But since many are less than one disk
 
68
           block, that might not help a lot.
 
69
 
64
70
    """
65
71
 
66
72
    def __init__(self, basedir):
 
73
        """ImmutableStore constructor."""
67
74
        self._basedir = basedir
68
75
 
69
76
    def _path(self, id):
70
 
        if '\\' in id or '/' in id:
71
 
            raise ValueError("invalid store id %r" % id)
72
77
        return os.path.join(self._basedir, id)
73
78
 
74
79
    def __repr__(self):
78
83
        """Add contents of a file into the store.
79
84
 
80
85
        f -- An open file, or file-like object."""
81
 
        # FIXME: Only works on files that will fit in memory
82
 
        
83
 
        from bzrlib.atomicfile import AtomicFile
84
 
        
 
86
        # FIXME: Only works on smallish files
 
87
        # TODO: Can be optimized by copying at the same time as
 
88
        # computing the sum.
85
89
        mutter("add store entry %r" % (fileid))
86
90
        if isinstance(f, types.StringTypes):
87
91
            content = f
88
92
        else:
89
93
            content = f.read()
90
 
            
 
94
 
91
95
        p = self._path(fileid)
92
96
        if os.access(p, os.F_OK) or os.access(p + '.gz', os.F_OK):
93
 
            raise BzrError("store %r already contains id %r" % (self._basedir, fileid))
 
97
            bailout("store %r already contains id %r" % (self._basedir, fileid))
94
98
 
95
 
        fn = p
96
99
        if compressed:
97
 
            fn = fn + '.gz'
98
 
            
99
 
        af = AtomicFile(fn, 'wb')
100
 
        try:
101
 
            if compressed:
102
 
                gf = gzip.GzipFile(mode='wb', fileobj=af)
103
 
                gf.write(content)
104
 
                gf.close()
105
 
            else:
106
 
                af.write(content)
107
 
            af.commit()
108
 
        finally:
109
 
            af.close()
110
 
 
111
 
 
112
 
    def copy_multi(self, other, ids):
113
 
        """Copy texts for ids from other into self.
114
 
 
115
 
        If an id is present in self, it is skipped.  A count of copied
116
 
        ids is returned, which may be less than len(ids).
117
 
        """
118
 
        from bzrlib.progress import ProgressBar
119
 
        pb = ProgressBar()
120
 
        pb.update('preparing to copy')
121
 
        to_copy = [id for id in ids if id not in self]
122
 
        if isinstance(other, ImmutableStore):
123
 
            return self.copy_multi_immutable(other, to_copy, pb)
124
 
        count = 0
125
 
        for id in to_copy:
126
 
            count += 1
127
 
            pb.update('copy', count, len(to_copy))
128
 
            self.add(other[id], id)
129
 
        assert count == len(to_copy)
130
 
        pb.clear()
131
 
        return count
132
 
 
133
 
 
134
 
    def copy_multi_immutable(self, other, to_copy, pb):
135
 
        from shutil import copyfile
136
 
        count = 0
137
 
        for id in to_copy:
138
 
            p = self._path(id)
139
 
            other_p = other._path(id)
140
 
            try:
141
 
                copyfile(other_p, p)
142
 
            except IOError, e:
143
 
                if e.errno == errno.ENOENT:
144
 
                    copyfile(other_p+".gz", p+".gz")
145
 
                else:
146
 
                    raise
147
 
            
148
 
            count += 1
149
 
            pb.update('copy', count, len(to_copy))
150
 
        assert count == len(to_copy)
151
 
        pb.clear()
152
 
        return count
153
 
    
 
100
            f = gzip.GzipFile(p + '.gz', 'wb')
 
101
            os.chmod(p + '.gz', 0444)
 
102
        else:
 
103
            f = file(p, 'wb')
 
104
            os.chmod(p, 0444)
 
105
            
 
106
        f.write(content)
 
107
        f.close()
 
108
 
154
109
 
155
110
    def __contains__(self, fileid):
156
111
        """"""
206
161
    """Self-destructing test subclass of ImmutableStore.
207
162
 
208
163
    The Store only exists for the lifetime of the Python object.
209
 
 Obviously you should not put anything precious in it.
 
164
    Obviously you should not put anything precious in it.
210
165
    """
211
166
    def __init__(self):
212
167
        ImmutableStore.__init__(self, tempfile.mkdtemp())