whois21 1.3.0

A simple and easy to use Python package that lets you query whois/RDAP information of a domain/IP.

whois21

WHOIS21 is a simple and easy to use python package that lets you easily query whois information of a domain.

Features

WHOIS

• Query whois information of a TLD from various whois servers and parse the results.
• Get the Registration Information of a domain from different RDAP servers and parse the results.
• Get IP information from ip-api.com.
• Any idea? Feel free to open an issue or submit a pull request.

Installation

Well, this is a python package so the first thing you need is python.

If you don't have python installed, please visit Python.org and install the latest version of python based on your OS.

Then you can install whois21 using pip module:

# Use this command to get the latest version from pypi.org and install it automatically
python -m pip install whois21 -U

# OR
# Download the release file from GitHub: https://github.com/MPCodeWriter21/whois21/releases
# And install it using this command
pip install whois21-x.x.x.tar.gz

Or you can clone the repository and run:

python -m build .

Dependencies

• requests: Used for:
  • Downloading list of whois and RDAP servers.
  • Downloading RDAP information.
• importlib_resources: Used for:
  • Getting the path to the whois21 package installation directory(for saving server lists).
• chardet: Used for:
  • Detecting the encoding of the whois response.
• log21: Used for:
  • Colorized Logging.
  • Printing collected data in pprint or tree format.
• os (A core python module): Used for:
  • Working with files and directories.
• socket (A core python module): Used for:
  • Establishing TCP connection to the whois server.
• json (A core python module): Used for:
  • Parsing JSON data from RDAP servers.
  • Parsing RDAP server list.
  • Saving collected whois or/and RDAP data to a file.
  • Loading some package data from a file.
• datetime (A core python module): Used for:
  • Converting Creation/Updated/Expiration date to a usable python datetime object.
• ipaddress (A core python module): Used for:
  • Validating IPv4 and IPv6 addresses.
• typing (A core python module): Used for:
  • Type checking.
  • Type hinting.
• re (A core python module): Used for:
  • Matching date-time strings with regular expressions.

Changes

1.3.0

• Added the option to specify the encoding to use for encoding and decoding the data in in WHOIS class.
• Added the option to customize the behavior of the WHOIS class when it encounters an error while encoding or decoding data.
• Added the feature to automatically detect the encoding of whois response to solve decoding issues, such as the one mentioned in issue #2. This is done with the help of chardet package.

Usage Examples:

CLI Examples

• Example 1: Query whois information of google.com

# -v : verbose mode
whois21 -v results google.com

• Example 2: Query whois information of 3 domains and save the results to a directory

# -R : saves the results as raw text
# -np: avoids printing the results to the screen
# -o results: saves the results to `./results` directory 
whois21 -R -np -o results google.com facebook.com pinterest.com

• Example 3: Query whois information of 3 IPs and save the results to a directory

# Options explained in the examples above
whois21 -R -np -v -o results 1.1.1.1 157.240.20.174 64.91.226.82

• Example 4: Query RDAP information of domains and IPs and save the results to a file

# -r: Gets the RDAP information of the queried domains and IPs
whois21 -np -o results -o results -r microsoft.com python.org 140.82.121.3 185.147.178.13

Python Code Examples

• Example 1: Query whois information of GitHub.com using WHOIS class.

# First step is to import the package
import whois21

query = 'github.com'

# Second step is to create an instance of the WHOIS class
whois = whois21.WHOIS(query)

# Third step is to check if the operation was successful
if not whois.success:
    print(whois.error)
    exit()

# And basically you are done!
# Now you can print the results
import log21  # I use log21 to print the results in a cool way 8D

# Print the results in a nice way
# PPrint the dictionary
log21.pprint(whois.whois_data)
# Tree-Print the dictionary
log21.tree_print(whois.whois_data)

# Or you can print the results in as raw text
print(whois.raw.decode('utf-8'))

# Or you can access each part of the results individually
print(f'Creation date   : {whois.creation_date}')
print(f'Expiration date : {whois.expires_date}')
print(f'Updated date    : {whois.updated_date}')

About

Author: CodeWriter21 (Mehrad Pooryoussof)

GitHub: MPCodeWriter21

Telegram Channel: @CodeWriter21

Aparat Channel: CodeWriter21

License

apache-2.0

Donate

In order to support this project you can donate some crypto of your choice 8D

Donate Addresses

Or if you can't, give this project a star on GitHub :)

References

• WHOIS (Wikipedia): https://en.wikipedia.org/wiki/WHOIS
• Domains: https://www.iana.org/domains/root/db/
• Registration Data Access Protocol (RDAP) ( Wikipedia): https://en.wikipedia.org/wiki/Registration_Data_Access_Protocol
• RDAP Response Profile ( PDF): https://www.icann.org/en/system/files/files/rdap-response-profile-15feb19-en.pdf
• Registration Data Access Protocol (RDAP) Query Format: https://www.rfc-editor.org/rfc/rfc7482.html
• Registration Data Access Protocol (RDAP) Object Tagging: https://www.rfc-editor.org/rfc/rfc8521.html
• Finding the Authoritative Registration Data (RDAP) Service: https://www.rfc-editor.org/rfc/rfc7484.html
• JSON Responses for the Registration Data Access Protocol (RDAP): https://www.rfc-editor.org/rfc/rfc7483
• Registration Data Access Protocol (RDAP) Partial Response: https://www.rfc-editor.org/rfc/rfc8982.html
• vCard Format Specification: https://www.rfc-editor.org/rfc/rfc6350.txt
• vCard (Wikipedia): https://en.wikipedia.org/wiki/VCard
• Notes on vCard, LDIF and mappings to RDF: https://www.w3.org/2002/12/cal/vcard-notes.html