Metadata-Version: 2.3
Name: iplooker
Version: 0.1.1
Summary: Look up location, ISP, and more about an IP address from multiple sources
License: MIT
Author: Danny Stewart
Author-email: danny@stewart.cc
Requires-Python: >=3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Description-Content-Type: text/markdown

# iplookup

This script will perform a lookup for an IP address using multiple sources. It can be used to get more information about an IP address, including the country, region, city, ISP, and any organization that may be associated to it. It collates the information and combines identical sources.

## Installation

Install from `pip` with:

```bash
pip install ds-iplookup
```

## Usage

The script's primary purpose is for looking up another IP address, but as a bonus feature, it can also tell you your current public IP address. You can even combine the two features to get a lookup for your public IP to see what other people might see if they were to look you up.

Here are the commands you can use:

```bash

# Running with no arguments will prompt for an IP
iplookup

# You can specify an IP as part of the command
iplookup 12.34.56.78

# You can use `-m` or `--me` to check your public IP
iplookup -m
iplookup --me

# You can do both with `-l` or `--lookup`
iplookup -l
iplookup --lookup
```

## Sources

It retrieves information from the following sources:

- ip2location
- ipinfo
- dbip
- ipregistry
- ipgeolocation
- ipapico
- ipbase

