Skip to content

rnet.dns

DNS resolution settings and custom nameservers.

rnet.dns

DNS resolution types and utilities.

LookupIpStrategy

Bases: Enum

IP lookup strategy for DNS resolution.

Determines the order and types of IP addresses to resolve.

Source code in rnet/dns.py 
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
@final
class LookupIpStrategy(Enum):
    """IP lookup strategy for DNS resolution.

    Determines the order and types of IP addresses to resolve.
    """

    IPV4_ONLY = auto()
    """Only resolve IPv4 addresses."""

    IPV6_ONLY = auto()
    """Only resolve IPv6 addresses."""

    IPV4_AND_IPV6 = auto()
    """Resolve both IPv4 and IPv6 addresses."""

    IPV6_THEN_IPV4 = auto()
    """Prefer IPv6, fall back to IPv4."""

    IPV4_THEN_IPV6 = auto()
    """Prefer IPv4, fall back to IPv6."""

IPV4_ONLY class-attribute instance-attribute 

IPV4_ONLY = auto()

Only resolve IPv4 addresses.

IPV6_ONLY class-attribute instance-attribute 

IPV6_ONLY = auto()

Only resolve IPv6 addresses.

IPV4_AND_IPV6 class-attribute instance-attribute 

IPV4_AND_IPV6 = auto()

Resolve both IPv4 and IPv6 addresses.

IPV6_THEN_IPV4 class-attribute instance-attribute 

IPV6_THEN_IPV4 = auto()

Prefer IPv6, fall back to IPv4.

IPV4_THEN_IPV6 class-attribute instance-attribute 

IPV4_THEN_IPV6 = auto()

Prefer IPv4, fall back to IPv6.

ResolverOptions

DNS resolver options for customizing DNS resolution behavior.

Parameters:

Name Type Description Default
lookup_ip_strategy LookupIpStrategy

The IP lookup strategy to use. Defaults to IPV4_AND_IPV6.

 IPV4_AND_IPV6
Example

from rnet import ResolverOptions, LookupIpStrategy from ipaddress import IPv4Address options = ResolverOptions(LookupIpStrategy.Ipv4Only) options.add_resolve("example.com", [IPv4Address("127.0.0.1")])

Source code in rnet/dns.py 
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
class ResolverOptions:
    """DNS resolver options for customizing DNS resolution behavior.

    Args:
        lookup_ip_strategy: The IP lookup strategy to use. Defaults to IPV4_AND_IPV6.

    Example:
        >>> from rnet import ResolverOptions, LookupIpStrategy
        >>> from ipaddress import IPv4Address
        >>> options = ResolverOptions(LookupIpStrategy.Ipv4Only)
        >>> options.add_resolve("example.com", [IPv4Address("127.0.0.1")])
    """

    def __init__(
        self,
        lookup_ip_strategy: LookupIpStrategy = LookupIpStrategy.IPV4_AND_IPV6,
    ) -> None:
        """Create a new ResolverOptions with the given lookup IP strategy.

        Args:
            lookup_ip_strategy: The IP lookup strategy to use.
        """
        ...

    def add_resolve(
        self,
        domain: str,
        addrs: Sequence[IPv4Address | IPv6Address],
    ) -> None:
        """Add a custom DNS resolve mapping.

        Maps a domain name to a list of IP addresses, bypassing normal DNS resolution.

        Args:
            domain: The domain name to map.
            addrs: List of IP addresses to resolve the domain to.

        Example:
            >>> from ipaddress import IPv4Address, IPv6Address
            >>> options = ResolverOptions()
            >>> options.add_resolve("api.example.com", [IPv4Address("192.168.1.1")])
            >>> options.add_resolve("cdn.example.com", [
            ...     IPv6Address("2001:db8::1"),
            ...     IPv4Address("203.0.113.1"),
            ... ])
        """
        ...

__init__ 

__init__(lookup_ip_strategy=LookupIpStrategy.IPV4_AND_IPV6)

Create a new ResolverOptions with the given lookup IP strategy.

Parameters:

Name Type Description Default
lookup_ip_strategy LookupIpStrategy

The IP lookup strategy to use.

 IPV4_AND_IPV6
Source code in rnet/dns.py 
49
50
51
52
53
54
55
56
57
58
def __init__(
    self,
    lookup_ip_strategy: LookupIpStrategy = LookupIpStrategy.IPV4_AND_IPV6,
) -> None:
    """Create a new ResolverOptions with the given lookup IP strategy.

    Args:
        lookup_ip_strategy: The IP lookup strategy to use.
    """
    ...

add_resolve 

add_resolve(domain, addrs)

Add a custom DNS resolve mapping.

Maps a domain name to a list of IP addresses, bypassing normal DNS resolution.

Parameters:

Name Type Description Default
domain str

The domain name to map.

 required
addrs Sequence[IPv4Address | IPv6Address]

List of IP addresses to resolve the domain to.

 required
Example

from ipaddress import IPv4Address, IPv6Address options = ResolverOptions() options.add_resolve("api.example.com", [IPv4Address("192.168.1.1")]) options.add_resolve("cdn.example.com", [ ... IPv6Address("2001:db8::1"), ... IPv4Address("203.0.113.1"), ... ])

Source code in rnet/dns.py 
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
def add_resolve(
    self,
    domain: str,
    addrs: Sequence[IPv4Address | IPv6Address],
) -> None:
    """Add a custom DNS resolve mapping.

    Maps a domain name to a list of IP addresses, bypassing normal DNS resolution.

    Args:
        domain: The domain name to map.
        addrs: List of IP addresses to resolve the domain to.

    Example:
        >>> from ipaddress import IPv4Address, IPv6Address
        >>> options = ResolverOptions()
        >>> options.add_resolve("api.example.com", [IPv4Address("192.168.1.1")])
        >>> options.add_resolve("cdn.example.com", [
        ...     IPv6Address("2001:db8::1"),
        ...     IPv4Address("203.0.113.1"),
        ... ])
    """
    ...