Metadata-Version: 2.4
Name: ip-to-country
Version: 0.1.2
Summary: Convert IP addresses to countries using delegated registry data
Author: Pieter-Jan Coenen
Author-email: pieterjan.coenen@gmail.com
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: description-content-type
Dynamic: license-file
Dynamic: requires-python
Dynamic: summary

# ip-to-country

**ip-to-country** is a blazing-fast, offline Python library that determines the country for any given IP address (IPv4 or IPv6) using pre-parsed regional internet registry data.

No internet access or third-party APIs required: everything runs **locally and instantly**.

---

## ⚡ Features

- 🌍 **Offline IP Geolocation** – no network calls or external services
- ⚡ **Super Fast Lookup** – optimized with binary search for IPv4
- ✅ **Supports IPv4 and IPv6**
- 📦 **Uses Official RIR Data** – from AFRINIC, RIPE, ARIN, APNIC, and LACNIC
- 🌐 **Country Code + Name Output** – based on ISO 3166
- 🕵️ Supports special codes like `A1` (Anonymous Proxy), `A2`, `O1`, etc.


---

## 📦 Installation

```bash
pip install ip-to-country
```

## 🛠️ Usage

```python
from ip_to_country import IpToCountry

ip_lookup = IpToCountry()
country_info = ip_lookup.ip_to_country("8.8.8.8")
print(country_info)
# Output: {'country_code': 'US', 'country_name': 'United States'}
```


