Metadata-Version: 2.4
Name: astrotools-cli
Version: 1.0.0
Summary: Network reconnaissance, security, diagnostics and cryptography CLI toolkit
Author: CINEFy
License-Expression: MIT
Project-URL: Homepage, https://github.com/CINEFy/astrotools
Project-URL: Repository, https://github.com/CINEFy/astrotools
Project-URL: Issues, https://github.com/CINEFy/astrotools/issues
Keywords: network,security,reconnaissance,cryptography,cli,port-scanner,geoip,dns,pentesting
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Security
Classifier: Topic :: System :: Networking
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28
Requires-Dist: questionary>=1.10
Requires-Dist: rich>=12.0
Dynamic: license-file

# AstroTools CLI

> **PyPI name:** `astrotools-cli` · **Command:** `astrotools`

AstroTools is an interactive network reconnaissance, security, diagnostics and
cryptography CLI toolkit. It bundles 20+ tools into a single menu-driven
terminal application built with `rich` and `questionary`.

> **Disclaimer:** Use only against systems you own or are explicitly
> authorized to test. Unauthorized scanning/sniffing may be illegal.

## Installation

```bash
pip install astrotools-cli
```

## Usage

Run the interactive menu:

```bash
astrotools
```

Or as a module:

```bash
python -m astrotools
```

## Included Tools

| # | Tool | Description |
|---|------|-------------|
| 1  | Password Generator | Create strong passwords and estimate strength |
| 2  | Hash Generator & Verifier | Generate or verify MD5/SHA hashes |
| 3  | My Network Info | Show local/public IP and geolocation summary |
| 4  | Domain IP Lookup | Resolve domains and reverse DNS records |
| 5  | GeoIP Tracker | Locate an IP or domain by public GeoIP data |
| 6  | MAC Vendor Lookup | Identify manufacturer from a MAC/OUI prefix |
| 7  | Subnet Calculator & Sweep | Calculate CIDR details and find live hosts |
| 8  | Port Scanner | Scan TCP ports and identify common services |
| 9  | Subdomain Finder | Resolve common subdomains for a target domain |
| 10 | Web Directory Fuzzer | Check common web paths and endpoints |
| 11 | HTTP Header Inspector | View headers and audit security headers |
| 12 | Packet Sniffer | Capture and summarize live raw IP packets |
| 13 | SSL/TLS Inspector | Read certificate issuer, validity, and SANs |
| 14 | RDAP / WHOIS Lookup | Fetch domain registration intelligence |
| 15 | Traceroute | Trace network path hops to a target |
| 16 | Interfaces & ARP | Show local adapters and ARP/neighbor table |
| 17 | DNS Record Lookup | Query A, AAAA, MX, NS, TXT, SOA, and CNAME |
| 18 | HTTP Status Checker | Show status, redirects, timing, and server info |
| 19 | TCP Ping | Measure TCP connection latency to a host and port |
| 20 | Listening Ports | List local services listening on network ports |
| 21 | Tech Stack Detector | Fingerprint web frameworks, CDN/WAF, and cookies |
| 22 | Web Endpoint Auditor | Check common web metadata and exposure paths |

## Requirements

- Python 3.9+
- `requests`, `questionary`, `rich`
- Packet sniffer on Windows requires running as Administrator

## Development

Build the distribution:

```bash
pip install build
python -m build
```

Publish:

```bash
twine upload dist/*
```

## License

[MIT](LICENSE)
