twisted.internet.tcp.Client(_BaseTCPClient, BaseClient) class documentationtwisted.internet.tcp
          View Source
          (View In Hierarchy)
        
      Known subclasses: twisted.internet.ssl.Client
A transport for a TCP protocol; either TCPv4 or TCPv6.
Do not create these directly; use IReactorTCP.connectTCP.
Inherited from _BaseTCPClient:
| Instance Variable | connector | The Connector which is driving this _BaseTCPClient's connection attempt. | 
  
| Instance Variable | addr | The address that this socket will be connecting to. | 
| Instance Variable | createInternetSocket | Subclasses must implement this as a method to create a python socket object of the appropriate address family and socket type. | 
| Method | __init__ | Undocumented | 
| Instance Variable | addressFamily | Undocumented | 
| Method | getHost | Returns an IPv4Address or IPv6Address. | 
  
| Method | getPeer | Returns an IPv4Address or IPv6Address. | 
  
| Method | __repr__ | Undocumented | 
| Instance Variable | _addressType | The Twisted _IPAddress implementation for this client | 
| Instance Variable | _requiresResolution | Undocumented | 
Inherited from BaseClient:
| Instance Variable | realAddress | The address object that will be used for socket.connect; this address is an address tuple (the number of elements dependent upon the address family) which does not contain any names which need to be resolved. | 
| Method | createInternetSocket | (internal) Create a non-blocking socket using self.addressFamily, self.socketType. | 
| Method | doConnect | Initiate the outgoing connection attempt. | 
| Instance Variable | doWrite | Undocumented | 
| Instance Variable | doRead | Undocumented | 
| Instance Variable | protocol | Undocumented | 
| Instance Variable | connected | Undocumented | 
| Instance Variable | logstr | Undocumented | 
| Instance Variable | _base | Connection, which is the base class of this class which has all of the useful file descriptor methods.  This is used by _TLSServerMixin to call the right methods to directly manipulate the transport, as is necessary for writing TLS-encrypted bytes (whereas those methods on Server will go through another layer of TLS if it has been enabled). | 
  
| Method | _stopReadingAndWriting | Implement the POSIX-ish (i.e. twisted.internet.interfaces.IReactorFDSet) method of detaching this socket from the reactor for _BaseBaseClient. | 
  
| Method | _collectSocketDetails | Clean up references to the socket and its file descriptor. | 
| Method | _connectDone | This is a hook for when a connection attempt has succeeded. | 
Inherited from _BaseBaseClient (via BaseClient):
| Instance Variable | addressFamily | The address family constant (socket.AF_INET, socket.AF_INET6, socket.AF_UNIX) of the underlying socket of this client connection. | 
  
| Instance Variable | socketType | The socket type constant (socket.SOCK_STREAM or socket.SOCK_DGRAM) of the underlying socket. | 
  
| Instance Variable | reactor | The class pointed to by _commonConnection should set this attribute in its constructor. | 
  
| Method | resolveAddress | No summary | 
| Method | failIfNotConnected | Generic method called when the attempts to connect failed. It basically cleans everything it can: call connectionFailed, stop read and write, delete socket related members. | 
| Method | stopConnecting | If a connection attempt is still outstanding (i.e. no connection is yet established), immediately stop attempting to connect. | 
| Method | connectionLost | No summary | 
| Instance Variable | _requiresResolution | A flag indicating whether the address of this client will require name resolution.  True if the hostname of said address indicates a name that must be resolved by hostname lookup, False if it indicates an IP address literal. | 
  
| Class Variable | _commonConnection | Subclasses must provide this attribute, which indicates the Connection-alike class to invoke __init__ and connectionLost on. | 
  
| Instance Variable | _closeSocket | Subclasses must implement in order to close the socket in response to a terminated connection attempt. | 
| Method | _finishInit | Called by subclasses to continue to the stage of initialization where the socket connect attempt is made. | 
| Method | _setRealAddress | Set the resolved address of this _BaseBaseClient and initiate the connection attempt. | 
  
Inherited from Connection (via BaseClient):
| Method | __init__ | |
| Instance Variable | socket | Undocumented | 
| Instance Variable | fileno | Undocumented | 
| Method | getHandle | Return the socket for this connection. | 
| Method | writeSomeData | Write as much as possible of the given data to this TCP connection. | 
| Method | readConnectionLost | Indicates read connection was lost. | 
| Method | connectionLost | See abstract.FileDescriptor.connectionLost(). | 
| Method | logPrefix | Return the prefix to log with when I own the logging thread. | 
| Method | getTcpNoDelay | Return if TCP_NODELAY is enabled. | 
  
| Method | setTcpNoDelay | Enable/disable TCP_NODELAY. | 
  
| Method | getTcpKeepAlive | Return if SO_KEEPALIVE is enabled. | 
  
| Method | setTcpKeepAlive | Enable/disable SO_KEEPALIVE. | 
  
| Method | _dataReceived | Undocumented | 
| Method | _closeWriteConnection | Undocumented | 
Inherited from _TLSConnectionMixin (via BaseClient, Connection):
| Class Variable | TLS | Undocumented | 
Inherited from FileDescriptor (via BaseClient, Connection):
| Instance Variable | disconnected | Undocumented | 
| Instance Variable | disconnecting | Undocumented | 
| Instance Variable | dataBuffer | Undocumented | 
| Instance Variable | offset | Undocumented | 
| Class Variable | SEND_LIMIT | Undocumented | 
| Instance Variable | reactor | Undocumented | 
| Instance Variable | producer | Undocumented | 
| Instance Variable | producerPaused | Undocumented | 
| Method | writeConnectionLost | Indicates write connection was lost. | 
| Method | write | Reliably write some data. | 
| Method | writeSequence | Reliably write a sequence of data. | 
| Method | loseConnection | Close the connection at the next available opportunity. | 
| Method | loseWriteConnection | Undocumented | 
| Method | stopReading | Stop waiting for read availability. | 
| Method | stopWriting | Stop waiting for write availability. | 
| Method | startReading | Start waiting for read availability. | 
| Method | startWriting | Start waiting for write availability. | 
| Class Variable | bufferSize | Undocumented | 
| Method | stopConsuming | Stop consuming data. | 
| Method | resumeProducing | Resume producing data. | 
| Method | pauseProducing | Pause producing data. | 
| Method | stopProducing | Stop producing data. | 
| Instance Variable | _writeDisconnecting | Undocumented | 
| Instance Variable | _writeDisconnected | Undocumented | 
| Instance Variable | _tempDataBuffer | Undocumented | 
| Instance Variable | _tempDataLen | Undocumented | 
| Method | _postLoseConnection | Called after a loseConnection(), when all data has been written. | 
| Method | _isSendBufferFull | Determine whether the user-space send buffer for this transport is full or not. | 
| Method | _maybePauseProducer | Possibly pause a producer, if there is one and the send buffer is full. | 
Inherited from _ConsumerMixin (via BaseClient, Connection, FileDescriptor):
| Instance Variable | streamingProducer | bool or int | 
  
| Method | registerProducer | Register to receive data from a producer. | 
| Method | unregisterProducer | Stop consuming data from a producer, without disconnecting. | 
Inherited from _LogOwner (via BaseClient, Connection, FileDescriptor):
| Method | _getLogPrefix | Determine the log prefix to use for messages related to applicationObject, which may or may not be an interfaces.ILoggingContext provider. | 
  
Inherited from _SocketCloser (via BaseClient, Connection):
| Instance Variable | _shouldShutdown | Set to True if shutdown should be called before calling close on the underlying socket. | 
  
| Method | _closeSocket | Undocumented | 
Inherited from _AbortingMixin (via BaseClient, Connection):
| Method | abortConnection | Aborts the connection immediately, dropping any buffered data. | 
| Instance Variable | _aborting | Set to True when abortConnection is called. |