Skip to main content

A WHOIS lookup tool

Project description

Owl-Eye

Owl-Eye is a Python package that allows users to perform WHOIS lookups for domains or IP addresses. It parses and displays essential information such as registration details, name servers, ownership details, and more.

This package is based on the original script by LaviruD and has been modularized and packaged for ease of use and distribution.


Features

  • Retrieve WHOIS information for any domain or IP address.
  • Parse data such as:
    • Domain ownership.
    • Registration dates.
    • Name servers.
    • Administrative and technical contact details (if available).
  • Simple command-line interface (CLI).
  • Displays results in a well-organized format.

Installation

Install Owl-Eye using pip:

pip install owl-eye

Usage

Command-Line Usage

After installation, you can use Owl-Eye directly from the terminal:

owl-eye
Enter Website URL or IP Address: ishanoshada.com

WHOIS Information:

        Domain Name: ishanoshada.com
        Registry Domain ID: 2941423617_DOMAIN_COM-VRSN
        Registrar WHOIS Server: whois.tucows.com
        Registrar URL: http://www.tucows.com
        Updated Date: 2024-12-11T18:35:00Z
        Creation Date: 2024-12-11T18:35:00Z
        Expiry Date: 2025-12-11T18:35:00Z
        Registrar IANA ID: 69
        Registrar Abuse Email: domainabuse@tucows.com
        Registrar Abuse Phone: +1.4165350123
        Name Servers:
          - NS1.VERCEL-DNS.COM
          - NS2.VERCEL-DNS.COM
        DNSSEC: unsigned

Follow the on-screen prompts to provide a domain or IP address for the WHOIS lookup.


Programmatic Usage

You can also use Owl-Eye in your Python scripts:

from owl_eye import display_banner, check_network, fetch_whois_data, extract_topics, extract_details

# Display banner
display_banner()

# Check network connectivity
if check_network():
    domain = "example.com"
    get_data(domain)


"""

WHOIS Information:

        Domain Name: ishanoshada.com
        Registry Domain ID: 2941423617_DOMAIN_COM-VRSN
        Registrar WHOIS Server: whois.tucows.com
        Registrar URL: http://www.tucows.com
        Updated Date: 2024-12-11T18:35:00Z
        Creation Date: 2024-12-11T18:35:00Z
        Expiry Date: 2025-12-11T18:35:00Z
        Registrar IANA ID: 69
        Registrar Abuse Email: domainabuse@tucows.com
        Registrar Abuse Phone: +1.4165350123
        Name Servers:
          - NS1.VERCEL-DNS.COM
          - NS2.VERCEL-DNS.COM
        DNSSEC: unsigned

"""

Requirements

The following Python packages are required:

  • colorama
  • pyfiglet
  • requests
  • beautifulsoup4

These will be installed automatically when you install Owl-Eye via pip.


Project Structure

owl-eye/
├── owl_eye/
│   ├── __init__.py
│   ├── banner.py
│   ├── utils.py
│   ├── whois_lookup.py
│   ├── main.py
├── tests/
│   ├── test_banner.py
│   ├── test_utils.py
│   ├── test_whois_lookup.py
├── setup.py
├── README.md
├── LICENSE
├── requirements.txt

Contribution

We welcome contributions to improve Owl-Eye! To contribute:

  1. Fork the repository.
  2. Create a new branch for your feature or bugfix.
  3. Commit your changes.
  4. Open a pull request describing your changes.

Acknowledgments

This package is based on the original Owl-Eye tool developed by LaviruD. Special thanks for their fantastic work on the original script.


License

Owl-Eye is licensed under the MIT License. Feel free to use, modify, and distribute this software as per the license.


Support

For issues or feature requests, please open an issue in the GitHub repository.

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

owl_eye-0.1.6.tar.gz (5.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

owl_eye-0.1.6-py3-none-any.whl (7.2 kB view details)

Uploaded Python 3

File details

Details for the file owl_eye-0.1.6.tar.gz.

File metadata

  • Download URL: owl_eye-0.1.6.tar.gz
  • Upload date:
  • Size: 5.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.21

File hashes

Hashes for owl_eye-0.1.6.tar.gz
Algorithm Hash digest
SHA256 6bbc5faa8e169883ab3a11910e41d136e9c4695e22c31b9e53a45a4898228a14
MD5 2a7d004c2be899c4db4c366cea30c6d5
BLAKE2b-256 c6551664f0f0c1ddf4b8b68cbd8eae84a7244b853c43d001709c8a3b45743355

See more details on using hashes here.

File details

Details for the file owl_eye-0.1.6-py3-none-any.whl.

File metadata

  • Download URL: owl_eye-0.1.6-py3-none-any.whl
  • Upload date:
  • Size: 7.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.21

File hashes

Hashes for owl_eye-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 87d5c6d9f035b2025bfa6c1e1c13013877963ef136a5521c4ffcf9384a317121
MD5 e0d25039d9aad1562a029263a813e979
BLAKE2b-256 455e39cda8aad48dbfa70c1776256b31f04410c0d6c1c1e8b052666539a4878b

See more details on using hashes here.

Supported by

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