NetworkService

class NetworkService(**properties: Any)

Superclasses: Object

Implemented Interfaces: SocketConnectable

Like NetworkAddress does with hostnames, GNetworkService provides an easy way to resolve a SRV record, and then attempt to connect to one of the hosts that implements that service, handling service priority/weighting, multiple IP addresses, and multiple address families.

See SrvTarget for more information about SRV records, and see SocketConnectable for an example of using the connectable interface.

Constructors

class NetworkService

classmethod new(service: str, protocol: str, domain: str) → NetworkService

Creates a new NetworkService representing the given service, protocol, and domain. This will initially be unresolved; use the SocketConnectable interface to resolve it.

Added in version 2.22.

Parameters:

• service – the service type to look up (eg, “ldap”)

• protocol – the networking protocol to use for service (eg, “tcp”)

• domain – the DNS domain to look up the service in

Methods

class NetworkService

get_domain() → str

Gets the domain that srv serves. This might be either UTF-8 or ASCII-encoded, depending on what srv was created with.

Added in version 2.22.

get_protocol() → str

Gets srv’s protocol name (eg, “tcp”).

Added in version 2.22.

get_scheme() → str

Gets the URI scheme used to resolve proxies. By default, the service name is used as scheme.

Added in version 2.26.

get_service() → str

Gets srv’s service name (eg, “ldap”).

Added in version 2.22.

set_scheme(scheme: str) → None

Set’s the URI scheme used to resolve proxies. By default, the service name is used as scheme.

Added in version 2.26.

Parameters:

scheme – a URI scheme

Properties

class NetworkService

props.domain: str

Network domain, for example example.com.

Added in version 2.22.

props.protocol: str

Network protocol, for example tcp.

Added in version 2.22.

props.scheme: str

Network scheme (default is to use service).

Added in version 2.22.

props.service: str

Service name, for example ldap.

Added in version 2.22.

Fields

class NetworkService

parent_instance

priv