brave-trace 0.1.0

A CLI tool for Route Intelligence, traceroute parsing, and AS/Geo lookups.

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:

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:

brave-trace trace 8.8.8.8

Or target a domain name:

brave-trace trace google.com

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

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:

from brave_trace.core.engine import run_trace

run_trace("8.8.8.8")

See examples/sample_trace.py for details.

Running Tests

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

python -m unittest discover tests

Contributing

See CONTRIBUTING.md for local development workflows.