Go to the latest version of this document.
search in docstrings

Search bar offers the following options:

- Term presence. The below example searches for documents that must contain “foo”, might contain “bar” and must not contain “baz”: `+foo bar -baz`
- Wildcards. The below example searches for documents with words beginning with “foo”: `foo*`
- Search in specific fields. The following search matches all objects in "twisted.mail" that matches “search”: `+qname:twisted.mail.* +search`

  Possible fields: 'name', 'qname' (fully qualified name), 'docstring', and 'kind'. Last two fields are only applicable if "search in docstrings" is enabled.

- Fuzzy matches. The following search matches all documents that have a word within 1 edit distance of “foo”: `foo~1`

Results provided by Lunr.js

# ``twisted`.`internet`.`endpoints`.`HostnameEndpoint``

class documentation

`class HostnameEndpoint: (source)`

Implements interfaces: `twisted.internet.interfaces.IStreamClientEndpoint`

View In Hierarchy

A name-based endpoint that connects to the fastest amongst the resolved host addresses.

Method | `__init__` | Create a `HostnameEndpoint`.
Method | `__repr__` | Produce a string representation of the `HostnameEndpoint`.
Method | `connect` | Attempts a connection to each resolved address, and returns a connection which is established first.
Static Method | `_hostAsBytesAndText` | For various reasons (documented in the `@ivar`'s in the class docstring) we need both a textual and a binary representation of the hostname given to the constructor. For compatibility and convenience, we accept both textual and binary representations of the hostname, save the form that was passed, and convert into the other form...
Method | `_fallbackNameResolution` | Resolve the hostname string into a tuple containing the host address. This is method is only used when the reactor does not provide `IReactorPluggableNameResolver`.
Method | `_getNameResolverAndMaybeWarn` | Retrieve a `nameResolver` callable and warn the caller's caller that using a reactor which doesn't provide `IReactorPluggableNameResolver` is deprecated.
Constant | `_DEFAULT_ATTEMPT_DELAY` | The default time to use between attempts, in seconds, when no `attemptDelay` is given to `HostnameEndpoint.__init__`.
Class Variable | `_deferToThread` | Undocumented
Class Variable | `_getaddrinfo` | Undocumented
Instance Variable | `_attemptDelay` | Undocumented
Instance Variable | `_badHostname` | a flag - hopefully false! - indicating that an invalid hostname was passed to the constructor. This might be a textual hostname that isn't valid IDNA, or non-ASCII bytes.
Instance Variable | `_bindAddress` | Undocumented
Instance Variable | `_hostBytes` | the encoded bytes-representation of the hostname passed to the constructor. Used to construct the `HostnameAddress` associated with this endpoint.
Instance Variable | `_hostStr` | the native-string representation of the hostname passed to the constructor, used for exception construction
Instance Variable | `_hostText` | the textual representation of the hostname passed to the constructor. Used to pass to the reactor's hostname resolver.
Instance Variable | `_nameResolver` | Undocumented
Instance Variable | `_port` | Undocumented
Instance Variable | `_reactor` | Undocumented
Instance Variable | `_timeout` | Undocumented

def __init__(self, reactor, host, port, timeout=30, bindAddress=None, attemptDelay=None): (source)

Create a `HostnameEndpoint`.

Parameters
reactor:provider of `IReactorTCP`, `IReactorTime` and either `IReactorPluggableNameResolver` or `IReactorPluggableResolver`. | The reactor to use for connections and delayed calls.
host:`bytes` or `unicode` | A hostname to connect to.
port:`int` | The port number to connect to.
timeout:`float` or `int` | For each individual connection attempt, the number of seconds to wait before assuming the connection has failed.
bindAddress:`bytes` | the local address of the network interface to make the connections from.
attemptDelay:`float` | The number of seconds to delay between connection attempts.
See Also
`twisted.internet.interfaces.IReactorTCP.connectTCP`

def __repr__(self): (source)

Produce a string representation of the `HostnameEndpoint`.

Returns
`str` | A `str`

def connect(self, protocolFactory): (source)
from `twisted.internet.interfaces.IStreamClientEndpoint`

Attempts a connection to each resolved address, and returns a connection which is established first.

Parameters
protocolFactory:`IProtocolFactory` | The protocol factory whose protocol will be connected.
Returns
A `Deferred` that fires with the connected protocol or fails a connection-related error.

@staticmethod
def _hostAsBytesAndText(host): (source)

For various reasons (documented in the `@ivar`'s in the class docstring) we need both a textual and a binary representation of the hostname given to the constructor. For compatibility and convenience, we accept both textual and binary representations of the hostname, save the form that was passed, and convert into the other form. This is mostly just because `HostnameAddress` chose somewhat poorly to define its attribute as bytes; hopefully we can find a compatible way to clean this up in the future and just operate in terms of text internally.

Parameters
host:`bytes` or `str` | A hostname to convert.
Returns
a 3-tuple of `(invalid, bytes, text)` where `invalid` is a boolean indicating the validity of the hostname, `bytes` is a binary representation of `host`, and `text` is a textual representation of `host`.

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

Resolve the hostname string into a tuple containing the host address. This is method is only used when the reactor does not provide `IReactorPluggableNameResolver`.

Parameters
host | A unicode hostname to resolve.
port | The port to include in the resolution.
Returns
A `Deferred` that fires with `_getaddrinfo`'s return value.

def _getNameResolverAndMaybeWarn(self, reactor): (source)

Retrieve a `nameResolver` callable and warn the caller's caller that using a reactor which doesn't provide `IReactorPluggableNameResolver` is deprecated.

Parameters
reactor | The reactor to check.
Returns
A `IHostnameResolver` provider.

_DEFAULT_ATTEMPT_DELAY: `float` = (source)

The default time to use between attempts, in seconds, when no `attemptDelay` is given to `HostnameEndpoint.__init__`.

Value

    0.3

_deferToThread = (source)

Undocumented

_getaddrinfo = (source)

Undocumented

_attemptDelay = (source)

Undocumented

_badHostname: `bool` = (source)

a flag - hopefully false! - indicating that an invalid hostname was passed to the constructor. This might be a textual hostname that isn't valid IDNA, or non-ASCII bytes.

_bindAddress = (source)

Undocumented

_hostBytes: `bytes` = (source)

the encoded bytes-representation of the hostname passed to the constructor. Used to construct the `HostnameAddress` associated with this endpoint.

_hostStr: native `str` = (source)

the native-string representation of the hostname passed to the constructor, used for exception construction

_hostText: `unicode` = (source)

the textual representation of the hostname passed to the constructor. Used to pass to the reactor's hostname resolver.

_nameResolver = (source)

Undocumented

_port = (source)

Undocumented

_reactor = (source)

Undocumented

_timeout = (source)

Undocumented