← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/inter.py

  • Committer: Alexander Belchenko
  • Date: 2006-07-30 16:43:12 UTC
  • mto: (1711.2.111 jam-integration)
  • mto: This revision was merged to the branch mainline in revision 1906.
  • Revision ID: bialix@ukr.net-20060730164312-b025fd3ff0cee59e
rename  gpl.txt => COPYING.txt

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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
16
16
 
17
17
 
18
18
"""Inter-object utility class."""
22
22
    """This class represents operations taking place between two objects.
23
23
 
24
24
    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
 
25
    references to the source and target objects these operations can be 
26
26
    carried out between.
27
27
 
28
28
    Often we will provide convenience methods on the objects which carry out
29
29
    operations with another of similar type - they will always forward to
30
 
    a subclass of InterObject - i.e.
 
30
    a subclass of InterObject - i.e. 
31
31
    InterVersionedFile.get(other).method_name(parameters).
32
32
 
33
 
    If the source and target objects implement the locking protocol -
 
33
    If the source and target objects implement the locking protocol - 
34
34
    lock_read, lock_write, unlock, then the InterObject's lock_read,
35
35
    lock_write and unlock methods may be used (optionally in conjunction with
36
36
    the needs_read_lock and needs_write_lock decorators.)
37
 
 
38
 
    When looking for an inter, the most recently registered types are tested
39
 
    first.  So typically the most generic and slowest InterObjects should be
40
 
    registered first.
41
37
    """
42
38
 
43
 
    # _optimisers = list()
44
 
    # Each concrete InterObject type should have its own optimisers list.
 
39
    # _optimisers = set()
 
40
    # Each concrete InterObject type should have its own optimisers set.
45
41
 
46
42
    def __init__(self, source, target):
47
43
        """Construct a default InterObject instance. Please use 'get'.
48
 
 
49
 
        Only subclasses of InterObject should call
 
44
        
 
45
        Only subclasses of InterObject should call 
50
46
        InterObject.__init__ - clients should call InterFOO.get where FOO
51
47
        is the base type of the objects they are interacting between. I.e.
52
48
        InterVersionedFile or InterRepository.
78
74
        If an optimised worker exists it will be used otherwise
79
75
        a default Inter worker instance will be created.
80
76
        """
81
 
        for provider in reversed(klass._optimisers):
 
77
        for provider in klass._optimisers:
82
78
            if provider.is_compatible(source, target):
83
79
                return provider(source, target)
84
80
        return klass(source, target)
102
98
    @classmethod
103
99
    def register_optimiser(klass, optimiser):
104
100
        """Register an InterObject optimiser."""
105
 
        klass._optimisers.append(optimiser)
 
101
        klass._optimisers.add(optimiser)
106
102
 
107
103
    def unlock(self):
108
104
        """Release the locks on source and target."""