twisted.internet.udp.Port : API documentation

class documentation

class twisted.internet.udp.Port(base.BasePort): (source)

Known subclasses: twisted.internet.udp.MulticastPort, twisted.internet.unix.DatagramPort

Implements interfaces: twisted.internet.interfaces.IListeningPort, twisted.internet.interfaces.ISystemHandle, twisted.internet.interfaces.IUDPTransport

View In Hierarchy

UDP port, listening for packets.

Instance Variable	maxThroughput	Maximum number of bytes read in one event loop iteration.
Instance Variable	addressFamily	`socket.AF_INET` or `socket.AF_INET6`, depending on whether this port is listening on an IPv4 address or an IPv6 address.
Method	__init__
Instance Variable	port	Undocumented
Instance Variable	protocol	Undocumented
Instance Variable	maxPacketSize	Undocumented
Instance Variable	interface	Undocumented
Method	__repr__	Undocumented
Method	getHandle	Return a socket object.
Method	startListening	Create and bind my socket, and begin listening on it.
Instance Variable	connected	Undocumented
Instance Variable	socket	Undocumented
Method	doRead	Called when my socket is ready for reading.
Method	write	Write a datagram.
Method	writeSequence	Write a datagram constructed from an iterable of `bytes`.
Method	connect	'Connect' to remote server.
Method	stopListening	Stop listening on this port.
Instance Variable	d	Undocumented
Method	loseConnection	Close the connection at the next available opportunity.
Method	connectionLost	Cleans up my socket.
Method	setLogStr	Initialize the `logstr` attribute to be used by `logPrefix`.
Instance Variable	logstr	Undocumented
Method	logPrefix	Return the prefix to log with.
Method	getHost	Return the local address of the UDP connection
Method	setBroadcastAllowed	Set whether this port may broadcast. This is disabled by default.
Method	getBroadcastAllowed	Checks if broadcast is currently allowed on this port.
Instance Variable	_realPortNumber	Actual port number being listened on. The value will be `None` until this `Port` is listening.
Instance Variable	_preexistingSocket	If not `None`, a `socket.socket` instance which was created and initialized outside of the reactor and will be used to listen for connections (instead of a new socket being created by this `Port`).
Instance Variable	_connectedAddr	Undocumented
Class Method	_fromListeningDescriptor	Create a new `Port` based on an existing listening SOCK_DGRAM socket.
Method	_bindSocket	Prepare and assign a `socket.socket` instance to `self.socket`.
Method	_connectToProtocol	Undocumented
Method	_loseConnection	Undocumented
Method	_setAddressFamily	Resolve address family for the socket.

Inherited from BasePort:

Class Variable	socketType	Undocumented
Method	createInternetSocket	Undocumented
Method	doWrite	Raises a RuntimeError

Inherited from FileDescriptor (via BasePort):

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
Method	writeSomeData	Write as much as possible of the given data, immediately.
Instance Variable	producerPaused	Undocumented
Method	writeConnectionLost	Undocumented
Method	readConnectionLost	Undocumented
Method	getPeer	Undocumented
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	Undocumented
Method	pauseProducing	Undocumented
Method	stopProducing	Undocumented
Method	fileno	File Descriptor number for select().
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	_closeWriteConnection	Undocumented
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 BasePort, 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 BasePort, FileDescriptor):

Method _getLogPrefix Determine the log prefix to use for messages related to applicationObject, which may or may not be an interfaces.ILoggingContext provider.

maxThroughput = (source)

Maximum number of bytes read in one event loop iteration.

(type: int)

addressFamily = (source)

overrides twisted.internet.base.BasePort.addressFamily

socket.AF_INET or socket.AF_INET6, depending on whether this port is listening on an IPv4 address or an IPv6 address.

_realPortNumber = (source)

Actual port number being listened on. The value will be None until this Port is listening.

_preexistingSocket = (source)

If not None, a socket.socket instance which was created and initialized outside of the reactor and will be used to listen for connections (instead of a new socket being created by this Port).

def __init__(self, port, proto, interface='', maxPacketSize=8192, reactor=None): (source)

overrides twisted.internet.abstract.FileDescriptor.__init__

overridden in twisted.internet.udp.MulticastPort, twisted.internet.unix.DatagramPort

Parameters	port	A port number on which to listen. (type: `int`)
	proto	A `DatagramProtocol` instance which will be connected to the given `port`. (type: `twisted.internet.protocol.DatagramProtocol`)
	interface	The local IPv4 or IPv6 address to which to bind; defaults to '', ie all IPv4 addresses. (type: `str`)
	maxPacketSize	The maximum packet size to accept. (type: `int`)
	reactor	A reactor which will notify this `Port` when its socket is ready for reading or writing. Defaults to `None`, ie the default global reactor. (type: `interfaces.IReactorFDSet`)

port = (source)

Undocumented

protocol = (source)

Undocumented

maxPacketSize = (source)

Undocumented

interface = (source)

Undocumented

_connectedAddr = (source)

Undocumented

@classmethod
def _fromListeningDescriptor(cls, reactor, fd, addressFamily, protocol, maxPacketSize): (source)

Create a new Port based on an existing listening SOCK_DGRAM socket.

Parameters	reactor	A reactor which will notify this `Port` when its socket is ready for reading or writing. Defaults to `None`, ie the default global reactor. (type: `interfaces.IReactorFDSet`)
	fd	An integer file descriptor associated with a listening socket. The socket must be in non-blocking mode. Any additional attributes desired, such as FD_CLOEXEC, must also be set already. (type: `int`)
	addressFamily	The address family (sometimes called domain) of the existing socket. For example, `socket.AF_INET`. (type: `int`)
	protocol	A `DatagramProtocol` instance which will be connected to the `port`. (type: `twisted.internet.protocol.DatagramProtocol`)
	maxPacketSize	The maximum packet size to accept. (type: `int`)
Returns	A new instance of `cls` wrapping the socket given by `fd`. (type: `Port`)

def __repr__(self): (source)

overridden in twisted.internet.unix.DatagramPort

Undocumented

Returns Undocumented (type: str)

def getHandle(self): (source)

from twisted.internet.interfaces.ISystemHandle

Return a socket object.

def startListening(self): (source)

from twisted.internet.interfaces.IListeningPort

overridden in twisted.internet.unix.ConnectedDatagramPort

Create and bind my socket, and begin listening on it.

This is called on unserialization, and must be called after creating a server to begin listening on the specified port.

def _bindSocket(self): (source)

overridden in twisted.internet.unix.DatagramPort

Prepare and assign a socket.socket instance to self.socket.

Either creates a new SOCK_DGRAM socket.socket bound to self.interface and self.port or takes an existing socket.socket provided via the interfaces.IReactorSocket.adoptDatagramPort interface.

connected = (source)

overrides twisted.internet.abstract.FileDescriptor.connected

overridden in twisted.internet.unix.DatagramPort

Undocumented

(type: int)

socket = (source)

overridden in twisted.internet.unix.DatagramPort

Undocumented

def _connectToProtocol(self): (source)

Undocumented

def doRead(self): (source)

overrides twisted.internet.abstract.FileDescriptor.doRead

overridden in twisted.internet.unix.ConnectedDatagramPort

Called when my socket is ready for reading.

def write(self, datagram, addr=None): (source)

from twisted.internet.interfaces.IUDPTransport

overrides twisted.internet.abstract.FileDescriptor.write

overridden in twisted.internet.unix.DatagramPort

Write a datagram.

Parameters	datagram	The datagram to be sent. (type: `bytes`)
	addr	A tuple of (stringified IPv4 or IPv6 address, integer port number); can be `None` in connected mode. (type: `tuple` containing `str` as first element and `int` as second element, or `None`)

def writeSequence(self, seq, addr): (source)

overrides twisted.internet.abstract.FileDescriptor.writeSequence

Write a datagram constructed from an iterable of bytes.

Parameters	seq	The data that will make up the complete datagram to be written. (type: an iterable of `bytes`)
	addr	A tuple of (stringified IPv4 or IPv6 address, integer port number); can be `None` in connected mode. (type: `tuple` containing `str` as first element and `int` as second element, or `None`)

def connect(self, host, port): (source)

from twisted.internet.interfaces.IUDPTransport

'Connect' to remote server.

def _loseConnection(self): (source)

Undocumented

def stopListening(self): (source)

from twisted.internet.interfaces.IListeningPort

Stop listening on this port.

If it does not complete immediately, will return Deferred that fires upon completion.

d = (source)

Undocumented

def loseConnection(self): (source)

overrides twisted.internet.abstract.FileDescriptor.loseConnection

Close the connection at the next available opportunity.

Call this to cause this FileDescriptor to lose its connection. It will first write any data that it has buffered.

If there is data buffered yet to be written, this method will cause the transport to lose its connection as soon as it's done flushing its write buffer. If you have a producer registered, the connection won't be closed until the producer is finished. Therefore, make sure you unregister your producer when it's finished, or the connection will never close.

def connectionLost(self, reason=None): (source)

overrides twisted.internet.abstract.FileDescriptor.connectionLost

overridden in twisted.internet.unix.DatagramPort

Cleans up my socket.

def setLogStr(self): (source)

overridden in twisted.internet.unix.DatagramPort

Initialize the logstr attribute to be used by logPrefix.

logstr = (source)

overridden in twisted.internet.unix.DatagramPort

Undocumented

def _setAddressFamily(self): (source)

Resolve address family for the socket.