ipmg 1.0.3

IP Management & Ping Monitoring CLI Tool

IPMG — IP Management & Ping Monitoring Tool

---

IPMG (IP Management Tool) is a modern, modular, enterprise-ready network scanner and monitoring utility. It replaces the legacy ip_pinger.py script with a clean package architecture, CLI tooling, and automated workflows.

Designed for:

• Network administrators
• Systems engineers
• Cybersecurity teams
• DevOps and SREs

IPMG supports:

• Subnet auto-discovery
• Parallel pinging with thread pools
• Hostname resolution
• Multi-format reporting (XLSX/CSV/JSON)
• Scheduled recurrent scans
• Auto-generated sample Excel input
• Colorized CLI output
• Modular testable architecture

---

⚠️ Security Disclaimer

Do NOT use this tool on networks without explicit authorization. Always obtain written approval from your organization's Cybersecurity / Network Security team. Unauthorized scanning may violate internal policies or law.

IPMG includes a built-in disclaimer shown at runtime (security.py).

---

Features

• Fully modular Python package (src/ipmg)
• System-wide CLI command: ipmg
• Test coverage via pytest
• Formatting and linting via ruff and black
• CI-friendly project structure

---

Installation

Option 1 — Install from PyPI (recommended for most users)

Install the latest stable release (ipmg 1.0.2) from PyPI:

pip install ipmg

Verify installation:

ipmg --help

---

Option 2 — Install via uv (recommended for isolated global install)

uv tool install git+https://github.com/sameeralam3127/ipmg.git

Test:

ipmg --help

---

Option 3 — Install via pip (editable, development mode)

git clone https://github.com/sameeralam3127/ipmg.git
cd IP_Management
pip install -e .

Verify:

ipmg --help

---

Option 4 — Install using curl installer

curl -sSL https://raw.githubusercontent.com/sameeralam3127/ipmg/main/install.sh | bash

This script:

• Installs uv if missing
• Installs ipmg globally using uv

Verify:

ipmg --help

---

Usage

Help

ipmg --help

---

Basic Example (using default input)

ipmg

If ip_list.xlsx does not exist → it will be created with sample IPs.

---

Scan a custom input file

ipmg --input network_devices.xlsx

---

Auto-discover LAN subnet

ipmg --discover

---

Export results to CSV + XLSX

ipmg --formats csv xlsx

---

Resolve hostnames (PTR)

ipmg --resolve

---

Run every 10 minutes

ipmg --interval 10

---

Testing

Run all tests:

uv run pytest

---

Formatting & Linting

Ruff (lint + autofix)

uv run ruff check . --fix

Ruff formatter (PEP-style formatting)

uv run ruff format .

Black (formatter)

uv run black .

---

Pre-commit Hooks (auto-format on commit)

Install:

uv run pre-commit install

Run manually:

uv run pre-commit run --all-files

---

Sample Output Summary

=== IPMG Summary ===
Active: 132
Inactive: 12
Unreachable: 4
Timeout: 2

Success Rate: 88.00%

---

Input File Format (Excel or CSV)

Example:

IP Address
192.168.1.1
10.0.0.1
8.8.8.8

---

Output File Format

IP Address	Status	Latency	Hostname	Timestamp
8.8.8.8	Active	12.5 ms	dns.google	2025-10-12 18:40:15

---

Troubleshooting

Command not found: ipmg

Solution:

pip install -e .

Permission denied output folder

Run inside a writeable directory or use:

sudo ipmg ...

Hostname Unresolvable

Likely missing DNS PTR records.

---

macOS GUI (PingMonitorApp – Beta)

A native macOS interface for IPMG is under active development.

Download Beta:

👉 https://github.com/sameeralam3127/IP_Management/releases/tag/macOS

---

License

MIT License — free for commercial and personal use.

---

Made with ❤️ using Python & uv.