iprad - modular Python-based CLI utility designed for IP Lookup. Built with scalability in mind, it separates core logic into distinct modules for easier maintenance and expansion.

❗️IP Type

iprad supports only Ipv4 addresses. Also you can write domain, like google.com when using iprad.

💻 Architecture

• Modular Design: Core functionality is encapsulated within the iprad/core package.
• Package Management: Uses pyproject.toml for modern dependency management and entry point configuration.
• Data Persistence: Includes a local .cache directory for caching results.

🚀 Installation

Project uses pyproject.toml, you can install it as a package directly from the source.

Standard installation

iprad can be installed with pip

Windows

pip install iprad

Linux/macOS

pip3 install iprad

Also you can install it via git clone

git clone https://github.com/deltaaa00/iprad.git
cd iprad
pip install .

For Developers (Editable Mode)

If you plan to modify the code and want changes to take effect immediately:

git clone https://github.com/deltaaa00/iprad.git
cd iprad
pip install -e .

API Keys 🔑

Some modules use API Keys. For example AbuseIPDB need it. Go to iprad directory (can be user folder). And run this:

cp .env.example .env

Then, open it in your text editor and replace YOUR_KEY with your API KEY for module.

ABUSEIPDB_API_KEY="YOUR KEY" <-- replace this

Examples 💾

Let`s try

iprad check 1.1.1.1

And you`ll get this iprad has some modules, that require sudo mode, for opening raw socket, for example:

sudo iprad check 1.1.1.1 -pt

Also, you can check own IP with this command:

iprad check myip

-pt Enables ping and traceroute module. Here is output:

If you don't want to use API Keys you can run with --nokeys

iprad check 1.1.1.1 --nokeys

Cache 🧹

iprad has cache function. If you want to clean cache run this:

iprad cache rm

You will get this message

Cache removed successfully

Also you can check cache size via this command:

iprad cache info

You will get this message similar to this:

Cache Size:  0.07MB