Skip to content
main
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 

aiohttp-doh

DNS over HTTPS reslover for aiohttp

Installation

$ pip install aiohttp-doh

Manual Usage

If you want use manualy, you must import ClientSession in aiohttp.client module and TCPConnector in aiohttp.connector module and DNSOverHTTPSResolver in aiohttp_doh package.

from aiohttp.client import ClientSession
from aiohttp.connector import TCPConnector

from aiohttp_doh import DNSOverHTTPSResolver

def my_client_session(*args, **kwargs):
    resolver = DNSOverHTTPSResolver(endpoints=[
        'https://cloudflare-dns.com/dns-query',
    ])
    connector = TCPConnector(resolver=resolver)
    return ClientSession(*args, **kwargs, connector=connector)

 async def main():
    async with my_client_session() as session:
        async with session.get('http://example.com') as resp:
            data = await resp.text()

    print(data)

Shortcut

Manual usage is too board. So I make shortcut to use easily. You just replace aiohttp.ClientSession to aiohttp_doh.ClientSession.

from aiohttp_doh import ClientSession

async def main():
    async with ClientSession() as session:
        async with session.get('http://example.com') as resp:
            data = await resp.text()

    print(data)

Options

You can pass below parameter for configuration.

endpoints
List of str. DNS over HTTPS endpoints. Shortcut use 'https://dns.google.com/resolve' and 'https://cloudflare-dns.com/dns-query' both in default. You can also use others instead.
json_loads
Function for loads json. default is Python builtin json module's one. You can use third-party json library like simplejson or ujson.
resolver_class
Internal DNS resolver class. Using for connect to endpoint. default is aiohttp default.

License

MIT

About

DNS over HTTPS with aiohttp

Topics

Resources

Releases

No releases published

Packages

No packages published

Languages