ipatel 0.1.1

A Python IP enrichment library

🌐 ipatel — IP Enrichment Library & CLI

---

🔍 What is ipatel?

ipatel is a lightweight Python library and CLI tool that enriches IP addresses and ASNs with useful metadata:

• 🛰️ ASN (Autonomous System Number)
• 🏢 AS Owner / Organization
• 🌎 Country Code
• 🧭 IP Type — Public / Private / Reserved
• 📶 IP Ranges for ASN

---

✨ Key Features

• ⚡ Fast and works offline after initial DB download
• 🔄 Auto-updates the enrichment database
• 💻 Simple and intuitive Python API & CLI
• 🧪 Fully tested, clean, and modular codebase
• 📦 Easy to install via pip

---

🚀 Quickstart Guide

🔧 Installation

pip install ipatel

---

🧩 Basic Setup

import ipatel as ip

test_ip = "8.8.8.8"
test_asn = 15169

---

🌐 IP Enrichment

🔹 Enrich IP with full metadata

ip.enrich_ip("8.8.8.8")

Returns:

{
    'ip': '8.8.8.8',
    'asn': 15169,
    'country_code': 'US',
    'owner': 'GOOGLE',
    'ip_type': 'Public'
}

---

🧠 ASN Lookup Functions

Function	Description	Example
ip.get_record(ip)	Full ASN record	ip.get_record("8.8.8.8")
ip.get_asn(ip)	Get ASN only	15169
ip.get_country_code(ip)	Get country code	"US"
ip.get_owner(ip)	Get AS owner	"GOOGLE"
ip.get_ip_ranges_for_asn(asn)	List of IP ranges for ASN	ip.get_ip_ranges_for_asn(15169)

---

🛠️ Utilities

Function	Description	Output
ip.ip_to_int("8.8.8.8")	IP → Integer	134744072
ip.int_to_ip(134744072)	Integer → IP	"8.8.8.8"
ip.get_ip_type("127.0.0.1")	Detect IP type	"Loopback"

---

🔄 Database Management

Task	Function	Description
📥 Download DB	ip.download_ip2asn_db()	Manually fetch latest DB
🔁 Ensure Fresh DB	ip.ensure_ip2asn_db()	Checks & auto-downloads if outdated

---

🧪 Test Script

def run_tests():
    ip.ensure_ip2asn_db()
    print(ip.enrich_ip("8.8.8.8"))

if __name__ == "__main__":
    run_tests()

---

📝 Notes

• IPv4 only (IPv6 support planned)
• Handles loopback, private, and reserved IPs safely
• CLI and API produce consistent outputs

---

📚 Learn More

• 📌 CLI Usage
• 🧾 Detailed API Reference
• 🔁 Database Update Guide
• 📂 GitHub Repository

---