| Name | ipry JSON |
| Version |
1.1.0
JSON |
| download |
| home_page | None |
| Summary | CLI tool for inspecting IP addresses |
| upload_time | 2025-07-21 12:03:32 |
| maintainer | None |
| docs_url | None |
| author | カネキ |
| requires_python | >=3.10 |
| license | None |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
---
## 🚀 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`](https://pypa.github.io/pipx/).
### 🪟 Windows
```bash
pip install ipry
```
Or optionally via pipx:
```bash
pipx install ipry
```
### 🐧 Linux
```bash
pipx install ipry
```
If pipx is not installed:
```bash
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
```bash
pipx install ipry
```
If pipx is not installed:
```bash
brew install pipx && pipx ensurepath
```
By default, `ipry` uses [ip-api.com](https://ip-api.com) to fetch public IP geolocation data.
---
## 🧪 Usage
Lookup any IP:
```bash
ipry 8.8.8.8
```
Raw output (compact JSON):
```bash
ipry 8.8.8.8 --raw
```
Change settings:
```bash
ipry --settings
```
Update all databases:
```bash
ipry --update
```
Show help:
```bash
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](https://db-ip.com):
- [IP-to-City Lite](https://db-ip.com/db/download/ip-to-city-lite)
- [IP-to-ASN Lite](https://db-ip.com/db/download/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)](https://creativecommons.org/licenses/by/4.0/).
Raw data
{
"_id": null,
"home_page": null,
"name": "ipry",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": "\u30ab\u30cd\u30ad",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/85/f5/52771b38aadfe3343487d1f4daa06ff1ec78dd99b318b614375104b7e58c/ipry-1.1.0.tar.gz",
"platform": null,
"description": "---\n\n## \ud83d\ude80 Features\n\n- IP lookup with optional City & ASN info\n- Raw or pretty-printed output\n- Local DB support (DB-IP Free Lite)\n- Easy settings toggle via CLI\n- Cross-platform (Linux / Windows / macOS)\n\n---\n\n## \ud83d\udce6 Installation\n\n`ipry` requires **Python 3.10+** to run. Recommended installation via [`pipx`](https://pypa.github.io/pipx/).\n\n### \ud83e\ude9f Windows\n\n```bash\npip install ipry\n```\n\nOr optionally via pipx:\n```bash\npipx install ipry\n```\n\n\n### \ud83d\udc27 Linux\n\n```bash\npipx install ipry\n```\n\nIf pipx is not installed:\n```bash\nsudo pacman -S python-pipx # Arch-based\nsudo apt install pipx # Debian/Ubuntu\nsudo dnf install pipx # Fedora\napk add py3-pipx # Alpine Linux\nsudo xbps-install -S python3-pipx # Void Linux\nnix-env -iA nixpkgs.pipx # NixOS\nsudo zypper install pipx # OpenSUSE\n```\n\n\n### \ud83c\udf4e macOS\n\n```bash\npipx install ipry\n```\n\nIf pipx is not installed:\n```bash\nbrew install pipx && pipx ensurepath\n```\n\nBy default, `ipry` uses [ip-api.com](https://ip-api.com) to fetch public IP geolocation data.\n\n---\n\n## \ud83e\uddea Usage\n\nLookup any IP:\n```bash\nipry 8.8.8.8\n```\n\nRaw output (compact JSON):\n```bash\nipry 8.8.8.8 --raw\n```\n\nChange settings:\n```bash\nipry --settings\n```\n\nUpdate all databases:\n```bash\nipry --update\n```\n\nShow help:\n```bash\nipry --help\n```\n\n---\n\n### \ud83d\udd27 Available Flags\n\n| Flag | Description |\n| ------------ | ------------------------------------------------------------------------- |\n| `--raw` | Outputs plain JSON (no colors or formatting) |\n| `--local-db` | Use local geolocation database (from DB-IP.com, licensed under CC BY 4.0) |\n| `--settings` | Open interactive settings menu |\n| `--update` | Force update of all local DB files |\n| `--help` | Show help message |\n\n---\n\n## \ud83c\udf10 Local DB Mode (Optional)\n\nWhen `--local-db` is enabled, `ipry` will download and use local geolocation datasets from [DB-IP.com](https://db-ip.com):\n\n- [IP-to-City Lite](https://db-ip.com/db/download/ip-to-city-lite)\n- [IP-to-ASN Lite](https://db-ip.com/db/download/ip-to-asn-lite)\n\nThese files are free for personal and open-source use under the \n[Creative Commons Attribution 4.0 License (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/).\n",
"bugtrack_url": null,
"license": null,
"summary": "CLI tool for inspecting IP addresses",
"version": "1.1.0",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "9662840980c6d4fffc49d5987b80a44ee39ba237dcf99a5d9d830ae7774d6247",
"md5": "18eec3ce7d4d2256b6273b70d82b5b21",
"sha256": "2b397a4a42bb37f4f24fb86f9ecc364bfdcc4bdb527e2b14e4c9fb1267588732"
},
"downloads": -1,
"filename": "ipry-1.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "18eec3ce7d4d2256b6273b70d82b5b21",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 10552,
"upload_time": "2025-07-21T12:03:31",
"upload_time_iso_8601": "2025-07-21T12:03:31.825916Z",
"url": "https://files.pythonhosted.org/packages/96/62/840980c6d4fffc49d5987b80a44ee39ba237dcf99a5d9d830ae7774d6247/ipry-1.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "85f552771b38aadfe3343487d1f4daa06ff1ec78dd99b318b614375104b7e58c",
"md5": "84ca5fb43aa7ac1545911e820eea91d5",
"sha256": "d24302d2f2bc98b5331ca330f5c52744ae35f266f4d4918adeb6ef10a6cd2a2d"
},
"downloads": -1,
"filename": "ipry-1.1.0.tar.gz",
"has_sig": false,
"md5_digest": "84ca5fb43aa7ac1545911e820eea91d5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 9144,
"upload_time": "2025-07-21T12:03:32",
"upload_time_iso_8601": "2025-07-21T12:03:32.737582Z",
"url": "https://files.pythonhosted.org/packages/85/f5/52771b38aadfe3343487d1f4daa06ff1ec78dd99b318b614375104b7e58c/ipry-1.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-21 12:03:32",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "ipry"
}
