~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/smart/medium.py

  • Committer: Martin Pool
  • Date: 2010-04-01 04:41:18 UTC
  • mto: This revision was merged to the branch mainline in revision 5128.
  • Revision ID: mbp@sourcefrog.net-20100401044118-shyctqc02ob08ngz
ignore .testrepository

Show diffs side-by-side

added added

removed removed

Lines of Context:
28
28
import sys
29
29
import urllib
30
30
 
31
 
import bzrlib
32
31
from bzrlib.lazy_import import lazy_import
33
32
lazy_import(globals(), """
 
33
import atexit
34
34
import socket
35
35
import thread
36
36
import weakref
494
494
class _DebugCounter(object):
495
495
    """An object that counts the HPSS calls made to each client medium.
496
496
 
497
 
    When a medium is garbage-collected, or failing that when
498
 
    bzrlib.global_state exits, the total number of calls made on that medium
499
 
    are reported via trace.note.
 
497
    When a medium is garbage-collected, or failing that when atexit functions
 
498
    are run, the total number of calls made on that medium are reported via
 
499
    trace.note.
500
500
    """
501
501
 
502
502
    def __init__(self):
503
503
        self.counts = weakref.WeakKeyDictionary()
504
504
        client._SmartClient.hooks.install_named_hook(
505
505
            'call', self.increment_call_count, 'hpss call counter')
506
 
        bzrlib.global_state.cleanups.add_cleanup(self.flush_all)
 
506
        atexit.register(self.flush_all)
507
507
 
508
508
    def track(self, medium):
509
509
        """Start tracking calls made to a medium.
607
607
            # which is newer than a previously supplied older-than version.
608
608
            # This indicates that some smart verb call is not guarded
609
609
            # appropriately (it should simply not have been tried).
610
 
            trace.mutter(
 
610
            raise AssertionError(
611
611
                "_remember_remote_is_before(%r) called, but "
612
612
                "_remember_remote_is_before(%r) was called previously."
613
 
                , version_tuple, self._remote_version_is_before)
614
 
            if 'hpss' in debug.debug_flags:
615
 
                ui.ui_factory.show_warning(
616
 
                    "_remember_remote_is_before(%r) called, but "
617
 
                    "_remember_remote_is_before(%r) was called previously."
618
 
                    % (version_tuple, self._remote_version_is_before))
619
 
            return
 
613
                % (version_tuple, self._remote_version_is_before))
620
614
        self._remote_version_is_before = version_tuple
621
615
 
622
616
    def protocol_version(self):
715
709
    """A client medium using simple pipes.
716
710
 
717
711
    This client does not manage the pipes: it assumes they will always be open.
 
712
 
 
713
    Note that if readable_pipe.read might raise IOError or OSError with errno
 
714
    of EINTR, it must be safe to retry the read.  Plain CPython fileobjects
 
715
    (such as used for sys.stdin) are safe.
718
716
    """
719
717
 
720
718
    def __init__(self, readable_pipe, writeable_pipe, base):
733
731
 
734
732
    def _read_bytes(self, count):
735
733
        """See SmartClientStreamMedium._read_bytes."""
736
 
        bytes_to_read = min(count, _MAX_READ_SIZE)
737
 
        bytes = self._readable_pipe.read(bytes_to_read)
 
734
        bytes = osutils.until_no_eintr(self._readable_pipe.read, count)
738
735
        self._report_activity(len(bytes), 'read')
739
736
        return bytes
740
737
 
741
738
 
742
 
class SSHParams(object):
743
 
    """A set of parameters for starting a remote bzr via SSH."""
 
739
class SmartSSHClientMedium(SmartClientStreamMedium):
 
740
    """A client medium using SSH."""
744
741
 
745
742
    def __init__(self, host, port=None, username=None, password=None,
746
 
            bzr_remote_path='bzr'):
747
 
        self.host = host
748
 
        self.port = port
749
 
        self.username = username
750
 
        self.password = password
751
 
        self.bzr_remote_path = bzr_remote_path
752
 
 
753
 
 
754
 
class SmartSSHClientMedium(SmartClientStreamMedium):
755
 
    """A client medium using SSH.
756
 
    
757
 
    It delegates IO to a SmartClientSocketMedium or
758
 
    SmartClientAlreadyConnectedSocketMedium (depending on platform).
759
 
    """
760
 
 
761
 
    def __init__(self, base, ssh_params, vendor=None):
 
743
            base=None, vendor=None, bzr_remote_path=None):
762
744
        """Creates a client that will connect on the first use.
763
745
 
764
 
        :param ssh_params: A SSHParams instance.
765
746
        :param vendor: An optional override for the ssh vendor to use. See
766
747
            bzrlib.transport.ssh for details on ssh vendors.
767
748
        """
768
 
        self._real_medium = None
769
 
        self._ssh_params = ssh_params
 
749
        self._connected = False
 
750
        self._host = host
 
751
        self._password = password
 
752
        self._port = port
 
753
        self._username = username
770
754
        # for the benefit of progress making a short description of this
771
755
        # transport
772
756
        self._scheme = 'bzr+ssh'
774
758
        # _DebugCounter so we have to store all the values used in our repr
775
759
        # method before calling the super init.
776
760
        SmartClientStreamMedium.__init__(self, base)
 
761
        self._read_from = None
 
762
        self._ssh_connection = None
777
763
        self._vendor = vendor
778
 
        self._ssh_connection = None
 
764
        self._write_to = None
 
765
        self._bzr_remote_path = bzr_remote_path
779
766
 
780
767
    def __repr__(self):
781
 
        if self._ssh_params.port is None:
 
768
        if self._port is None:
782
769
            maybe_port = ''
783
770
        else:
784
 
            maybe_port = ':%s' % self._ssh_params.port
 
771
            maybe_port = ':%s' % self._port
785
772
        return "%s(%s://%s@%s%s/)" % (
786
773
            self.__class__.__name__,
787
774
            self._scheme,
788
 
            self._ssh_params.username,
789
 
            self._ssh_params.host,
 
775
            self._username,
 
776
            self._host,
790
777
            maybe_port)
791
778
 
792
779
    def _accept_bytes(self, bytes):
793
780
        """See SmartClientStreamMedium.accept_bytes."""
794
781
        self._ensure_connection()
795
 
        self._real_medium.accept_bytes(bytes)
 
782
        self._write_to.write(bytes)
 
783
        self._report_activity(len(bytes), 'write')
796
784
 
797
785
    def disconnect(self):
798
786
        """See SmartClientMedium.disconnect()."""
799
 
        if self._real_medium is not None:
800
 
            self._real_medium.disconnect()
801
 
            self._real_medium = None
802
 
        if self._ssh_connection is not None:
803
 
            self._ssh_connection.close()
804
 
            self._ssh_connection = None
 
787
        if not self._connected:
 
788
            return
 
789
        self._read_from.close()
 
790
        self._write_to.close()
 
791
        self._ssh_connection.close()
 
792
        self._connected = False
805
793
 
806
794
    def _ensure_connection(self):
807
795
        """Connect this medium if not already connected."""
808
 
        if self._real_medium is not None:
 
796
        if self._connected:
809
797
            return
810
798
        if self._vendor is None:
811
799
            vendor = ssh._get_ssh_vendor()
812
800
        else:
813
801
            vendor = self._vendor
814
 
        self._ssh_connection = vendor.connect_ssh(self._ssh_params.username,
815
 
                self._ssh_params.password, self._ssh_params.host,
816
 
                self._ssh_params.port,
817
 
                command=[self._ssh_params.bzr_remote_path, 'serve', '--inet',
 
802
        self._ssh_connection = vendor.connect_ssh(self._username,
 
803
                self._password, self._host, self._port,
 
804
                command=[self._bzr_remote_path, 'serve', '--inet',
818
805
                         '--directory=/', '--allow-writes'])
819
 
        io_kind, io_object = self._ssh_connection.get_sock_or_pipes()
820
 
        if io_kind == 'socket':
821
 
            self._real_medium = SmartClientAlreadyConnectedSocketMedium(
822
 
                self.base, io_object)
823
 
        elif io_kind == 'pipes':
824
 
            read_from, write_to = io_object
825
 
            self._real_medium = SmartSimplePipesClientMedium(
826
 
                read_from, write_to, self.base)
827
 
        else:
828
 
            raise AssertionError(
829
 
                "Unexpected io_kind %r from %r"
830
 
                % (io_kind, self._ssh_connection))
 
806
        self._read_from, self._write_to = \
 
807
            self._ssh_connection.get_filelike_channels()
 
808
        self._connected = True
831
809
 
832
810
    def _flush(self):
833
811
        """See SmartClientStreamMedium._flush()."""
834
 
        self._real_medium._flush()
 
812
        self._write_to.flush()
835
813
 
836
814
    def _read_bytes(self, count):
837
815
        """See SmartClientStreamMedium.read_bytes."""
838
 
        if self._real_medium is None:
 
816
        if not self._connected:
839
817
            raise errors.MediumNotConnected(self)
840
 
        return self._real_medium.read_bytes(count)
 
818
        bytes_to_read = min(count, _MAX_READ_SIZE)
 
819
        bytes = self._read_from.read(bytes_to_read)
 
820
        self._report_activity(len(bytes), 'read')
 
821
        return bytes
841
822
 
842
823
 
843
824
# Port 4155 is the default port for bzr://, registered with IANA.
845
826
BZR_DEFAULT_PORT = 4155
846
827
 
847
828
 
848
 
class SmartClientSocketMedium(SmartClientStreamMedium):
849
 
    """A client medium using a socket.
850
 
    
851
 
    This class isn't usable directly.  Use one of its subclasses instead.
852
 
    """
 
829
class SmartTCPClientMedium(SmartClientStreamMedium):
 
830
    """A client medium using TCP."""
853
831
 
854
 
    def __init__(self, base):
 
832
    def __init__(self, host, port, base):
 
833
        """Creates a client that will connect on the first use."""
855
834
        SmartClientStreamMedium.__init__(self, base)
 
835
        self._connected = False
 
836
        self._host = host
 
837
        self._port = port
856
838
        self._socket = None
857
 
        self._connected = False
858
839
 
859
840
    def _accept_bytes(self, bytes):
860
841
        """See SmartClientMedium.accept_bytes."""
861
842
        self._ensure_connection()
862
843
        osutils.send_all(self._socket, bytes, self._report_activity)
863
844
 
864
 
    def _ensure_connection(self):
865
 
        """Connect this medium if not already connected."""
866
 
        raise NotImplementedError(self._ensure_connection)
867
 
 
868
 
    def _flush(self):
869
 
        """See SmartClientStreamMedium._flush().
870
 
 
871
 
        For sockets we do no flushing. For TCP sockets we may want to turn off
872
 
        TCP_NODELAY and add a means to do a flush, but that can be done in the
873
 
        future.
874
 
        """
875
 
 
876
 
    def _read_bytes(self, count):
877
 
        """See SmartClientMedium.read_bytes."""
878
 
        if not self._connected:
879
 
            raise errors.MediumNotConnected(self)
880
 
        return osutils.read_bytes_from_socket(
881
 
            self._socket, self._report_activity)
882
 
 
883
845
    def disconnect(self):
884
846
        """See SmartClientMedium.disconnect()."""
885
847
        if not self._connected:
888
850
        self._socket = None
889
851
        self._connected = False
890
852
 
891
 
 
892
 
class SmartTCPClientMedium(SmartClientSocketMedium):
893
 
    """A client medium that creates a TCP connection."""
894
 
 
895
 
    def __init__(self, host, port, base):
896
 
        """Creates a client that will connect on the first use."""
897
 
        SmartClientSocketMedium.__init__(self, base)
898
 
        self._host = host
899
 
        self._port = port
900
 
 
901
853
    def _ensure_connection(self):
902
854
        """Connect this medium if not already connected."""
903
855
        if self._connected:
937
889
                    (self._host, port, err_msg))
938
890
        self._connected = True
939
891
 
940
 
 
941
 
class SmartClientAlreadyConnectedSocketMedium(SmartClientSocketMedium):
942
 
    """A client medium for an already connected socket.
943
 
    
944
 
    Note that this class will assume it "owns" the socket, so it will close it
945
 
    when its disconnect method is called.
946
 
    """
947
 
 
948
 
    def __init__(self, base, sock):
949
 
        SmartClientSocketMedium.__init__(self, base)
950
 
        self._socket = sock
951
 
        self._connected = True
952
 
 
953
 
    def _ensure_connection(self):
954
 
        # Already connected, by definition!  So nothing to do.
955
 
        pass
 
892
    def _flush(self):
 
893
        """See SmartClientStreamMedium._flush().
 
894
 
 
895
        For TCP we do no flushing. We may want to turn off TCP_NODELAY and
 
896
        add a means to do a flush, but that can be done in the future.
 
897
        """
 
898
 
 
899
    def _read_bytes(self, count):
 
900
        """See SmartClientMedium.read_bytes."""
 
901
        if not self._connected:
 
902
            raise errors.MediumNotConnected(self)
 
903
        return osutils.read_bytes_from_socket(
 
904
            self._socket, self._report_activity)
956
905
 
957
906
 
958
907
class SmartClientStreamMediumRequest(SmartClientMediumRequest):