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

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2011-05-17 12:44:55 UTC
  • mfrom: (5853.2.8 lossy-argument)
  • Revision ID: pqm@pqm.ubuntu.com-20110517124455-8mzoceddh4wjmtgp
(jelmer) Make lossy an argument to Branch.pull. (Jelmer Vernooij)

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/inter.py
12
12
#
13
13
# You should have received a copy of the GNU General Public License
14
14
# along with this program; if not, write to the Free Software
15
 
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16
16
 
17
17
 
18
18
"""Inter-object utility class."""
19
19
 
20
20
 
 
21
from bzrlib.errors import NoCompatibleInter
 
22
 
 
23
 
21
24
class InterObject(object):
22
25
    """This class represents operations taking place between two objects.
23
26
 
24
27
    Its instances have methods like join or copy_content or fetch, and contain
25
 
    references to the source and target objects these operations can be 
 
28
    references to the source and target objects these operations can be
26
29
    carried out between.
27
30
 
28
31
    Often we will provide convenience methods on the objects which carry out
29
32
    operations with another of similar type - they will always forward to
30
 
    a subclass of InterObject - i.e. 
 
33
    a subclass of InterObject - i.e.
31
34
    InterVersionedFile.get(other).method_name(parameters).
 
35
 
 
36
    If the source and target objects implement the locking protocol -
 
37
    lock_read, lock_write, unlock, then the InterObject's lock_read,
 
38
    lock_write and unlock methods may be used (optionally in conjunction with
 
39
    the needs_read_lock and needs_write_lock decorators.)
 
40
 
 
41
    When looking for an inter, the most recently registered types are tested
 
42
    first.  So typically the most generic and slowest InterObjects should be
 
43
    registered first.
32
44
    """
33
45
 
34
 
    # _optimisers = set()
35
 
    # Each concrete InterObject type should have its own optimisers set.
 
46
    # _optimisers = list()
 
47
    # Each concrete InterObject type should have its own optimisers list.
36
48
 
37
49
    def __init__(self, source, target):
38
50
        """Construct a default InterObject instance. Please use 'get'.
39
 
        
40
 
        Only subclasses of InterObject should call 
 
51
 
 
52
        Only subclasses of InterObject should call
41
53
        InterObject.__init__ - clients should call InterFOO.get where FOO
42
54
        is the base type of the objects they are interacting between. I.e.
43
55
        InterVersionedFile or InterRepository.
47
59
        self.source = source
48
60
        self.target = target
49
61
 
 
62
    def _double_lock(self, lock_source, lock_target):
 
63
        """Take out two locks, rolling back the first if the second throws."""
 
64
        lock_source()
 
65
        try:
 
66
            lock_target()
 
67
        except Exception:
 
68
            # we want to ensure that we don't leave source locked by mistake.
 
69
            # and any error on target should not confuse source.
 
70
            self.source.unlock()
 
71
            raise
 
72
 
50
73
    @classmethod
51
74
    def get(klass, source, target):
52
75
        """Retrieve a Inter worker object for these objects.
58
81
        If an optimised worker exists it will be used otherwise
59
82
        a default Inter worker instance will be created.
60
83
        """
61
 
        for provider in klass._optimisers:
 
84
        for provider in reversed(klass._optimisers):
62
85
            if provider.is_compatible(source, target):
63
86
                return provider(source, target)
64
 
        return klass(source, target)
 
87
        raise NoCompatibleInter(source, target)
 
88
 
 
89
    def lock_read(self):
 
90
        """Take out a logical read lock.
 
91
 
 
92
        This will lock the source branch and the target branch. The source gets
 
93
        a read lock and the target a read lock.
 
94
        """
 
95
        self._double_lock(self.source.lock_read, self.target.lock_read)
 
96
 
 
97
    def lock_write(self):
 
98
        """Take out a logical write lock.
 
99
 
 
100
        This will lock the source branch and the target branch. The source gets
 
101
        a read lock and the target a write lock.
 
102
        """
 
103
        self._double_lock(self.source.lock_read, self.target.lock_write)
65
104
 
66
105
    @classmethod
67
106
    def register_optimiser(klass, optimiser):
68
107
        """Register an InterObject optimiser."""
69
 
        klass._optimisers.add(optimiser)
 
108
        klass._optimisers.append(optimiser)
 
109
 
 
110
    def unlock(self):
 
111
        """Release the locks on source and target."""
 
112
        try:
 
113
            self.target.unlock()
 
114
        finally:
 
115
            self.source.unlock()
70
116
 
71
117
    @classmethod
72
118
    def unregister_optimiser(klass, optimiser):