ipry 0.1.0

CLI tool for inspecting IP addresses

---

🚀 Features

• IP lookup with optional City & ASN info
• Raw or pretty-printed output
• Local DB support (DB-IP Free Lite)
• Easy settings toggle via CLI
• Cross-platform (Linux / Windows / macOS)

---

📦 Installation

ipry requires Python 3.10+ to run. Recommended installation via pipx.

🪟 Windows

pip install ipry

Or optionally via pipx:

pipx install ipry

🐧 Linux

pipx install ipry

If pipx is not installed:

sudo pacman -S python-pipx         # Arch-based
sudo apt install pipx              # Debian/Ubuntu
sudo dnf install pipx              # Fedora
apk add py3-pipx                   # Alpine Linux
sudo xbps-install -S python3-pipx  # Void Linux
nix-env -iA nixpkgs.pipx           # NixOS
sudo zypper install pipx           # OpenSUSE

🍎 macOS

pipx install ipry

If pipx is not installed:

brew install pipx && pipx ensurepath

By default, ipry uses ip-api.com to fetch public IP geolocation data.

---

🧪 Usage

Lookup any IP:

ipry 8.8.8.8

Raw output (compact JSON):

ipry 8.8.8.8 --raw

Change settings:

ipry --settings

Update all databases:

ipry --update

Show help:

ipry --help

---

🔧 Available Flags

Flag	Description
--raw	Outputs plain JSON (no colors or formatting)
--local-db	Use local geolocation database (from DB-IP.com, licensed under CC BY 4.0)
--settings	Open interactive settings menu
--update	Force update of all local DB files
--help	Show help message

---

🌐 Local DB Mode (Optional)

When --local-db is enabled, ipry will download and use local geolocation datasets from DB-IP.com:

• IP-to-City Lite
• IP-to-ASN Lite

These files are free for personal and open-source use under the
Creative Commons Attribution 4.0 License (CC BY 4.0).