Skip to main content

Async-compatible Python module for retrieving WHOIS information.

Project description

Async-compatible Python module for retrieving WHOIS information of domains.

Installation

pip install asyncwhois

Dependencies

tldextract==2.2.2
aiodns==2.0.0

QuickStart

Extracting Outputs

result = asyncwhois.lookup('google.com')
result.query_output  # raw output from the whois server
result.parser_output  # dictionary of key/values extracted from query_output

More Examples

normal

import time

import asyncwhois


def main():
    urls = [
        'https://www.google.co.uk',
        'en.wikipedia.org/wiki/Pi',
        'https://www.urbandictionary.com/define.php?term=async',
        'twitch.tv',
        'reuters.com',
        'https://www.pcpartpicker.com',
        'https://packaging.python.org/',
        'imgur.com',
        'https://www.amazon.co.jp',
        'github.com/explore',
        '172.217.3.110'
    ]
    for url in urls:
        asyncwhois.lookup(url)


if __name__ == '__main__':
    start = time.time()
    main()
    print(f'Done! [{round(time.time() - start, 4)}] seconds.')

asyncio

import asyncio
import time

import asyncwhois


async def main():
    urls = [
        'https://www.google.co.uk',
        'en.wikipedia.org/wiki/Pi',
        'https://www.urbandictionary.com/define.php?term=async',
        'twitch.tv',
        'reuters.com',
        'https://www.pcpartpicker.com',
        'https://packaging.python.org/',
        'imgur.com'
    ]
    tasks = []
    for url in urls:
        awaitable = asyncwhois.aio_lookup(url)
        tasks.append(awaitable)

    await asyncio.gather(*tasks)


if __name__ == '__main__':
    start = time.time()
    asyncio.run(main())
    print(f'Done! [{round(time.time() - start, 4)}] seconds.')

aiohttp

from aiohttp import web
import asyncwhois



async def whois_handler(request):
    domain = request.match_info.get('domain', 'google.com')
    result = await asyncwhois.aio_lookup(domain)
    return web.Response(
        text=f'WhoIs Query Parsed:\n{result.parser_output} Query Output:\n{result.query_output}'
    )



app = web.Application()
app.add_routes([web.get('/whois/{domain}', whois)])
web.run_app(app)

Contributions

Parsers located in asyncwhois/parser.py are based on those found in richardpenman/pywhois .

For additional TLD support, simply created a new Regex Class containing:
  • “self.server” or the whois server for this TLD

  • “_<tld>_expressions” or the regexes that can extract and parse the output from this server

class RegexORG(BaseParser):

   _org_expressions = {}

   def __init__(self):
       super().__init__()
       self.server = 'whois.pir.org'
       self.update_reg_expressions(self._org_expressions)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

asyncwhois-0.1.7.tar.gz (14.8 kB view hashes)

Uploaded Source

Built Distribution

asyncwhois-0.1.7-py3-none-any.whl (88.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page