Metadata-Version: 2.4
Name: brave-trace
Version: 0.1.0
Summary: A CLI tool for Route Intelligence, traceroute parsing, and AS/Geo lookups.
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: ipwhois>=1.2.0
Requires-Dist: requests>=2.25.0
Requires-Dist: rich>=12.0.0
Dynamic: license-file

# Brave Route Intelligence

Brave Route Intelligence (package `brave-trace`) is a professional Python CLI application that performs traceroutes, parses the hop latencies, performs reverse DNS/Geo/ASN lookups, classifies hops, and renders results in clean, colorized terminal tables.

## Features

- **Traceroute Parsing**: Converts raw traceroute results to structured hop information cross-platform (Windows & Unix-like).
- **Reverse DNS Lookup**: Resolves hostname entries.
- **AS Lookup**: Fetches autonomous system information using RDAP lookup.
- **Geo-location Identification**: Queries geography and coordinates from standard APIs.
- **Route Classification**: Identifies hop roles such as gateways, Google/AWS/Azure backbone, and ISP routes.
- **Beautiful Output**: Renders output inside dynamic Rich tables.

## Installation

Install the package in editable mode:

```bash
pip install -e .
```

This registers the CLI script command `brave-trace` in your environment.

## Usage

Run the trace command followed by the IP address or hostname target:

```bash
brave-trace trace 8.8.8.8
```

Or target a domain name:

```bash
brave-trace trace google.com
```

Alternatively, you can run it as a package module directly with Python:

```bash
python -m brave_trace trace 1.1.1.1
```

## Programmatic Example

You can import `brave_trace` to trigger scans from within your own Python programs:

```python
from brave_trace.core.engine import run_trace

run_trace("8.8.8.8")
```

See [examples/sample_trace.py](file:///c:/Users/Brave/OneDrive/Documents/Brave%20Trace/brave-route-intelligence/examples/sample_trace.py) for details.

## Running Tests

Verify the codebase functionality using the standard library's unittest framework:

```bash
python -m unittest discover tests
```

## Contributing

See [CONTRIBUTING.md](file:///c:/Users/Brave/OneDrive/Documents/Brave%20Trace/brave-route-intelligence/CONTRIBUTING.md) for local development workflows.
