netpath 0.1.0__py3-none-any.whl

netpath-0.1.0.dist-info/METADATA

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: netpath
+Version: 0.1.0
+Summary: Network path analyzer: throughput, latency, and packet loss across AS paths
+Project-URL: Homepage, https://github.com/holynakamoto/netpath
+Project-URL: Bug Tracker, https://github.com/holynakamoto/netpath/issues
+Author-email: Nick Moore <nickm@dave.io>
+License: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+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 :: System :: Networking :: Monitoring
+Requires-Python: >=3.9
+Requires-Dist: requests>=2.28
+Requires-Dist: rich>=13.0
+Requires-Dist: typer>=0.9
+Description-Content-Type: text/markdown
+
+# netpath
+
+Network path analyzer: probe throughput, latency, and packet loss across Autonomous System (AS) paths. Runs mtr/traceroute to a target ASN, measures bidirectional iperf3 throughput to servers inside that ASN, and optionally overlays Cloudflare Radar RUM data for comparison.
+
+## Installation
+
+```bash
+pip install netpath
+```
+
+```bash
+uvx netpath
+```
+
+```bash
+uv tool install netpath
+```
+
+## System Prerequisites
+
+netpath relies on two external tools for path probing and throughput measurement. Install them before running:
+
+- **mtr** — primary path prober (falls back to traceroute if unavailable)
+- **iperf3** — bidirectional throughput measurement (falls back to Cloudflare HTTP speedtest if unavailable)
+
+```bash
+# macOS
+brew install mtr iperf3
+
+# Debian / Ubuntu
+sudo apt install mtr-tiny iperf3
+
+# Fedora / RHEL
+sudo dnf install mtr iperf3
+```
+
+## Usage
+
+### Probe a specific ASN
+
+```bash
+netpath asn AS15169
+```
+
+Options:
+
+```
+-n, --count INTEGER       Max servers to test (default: 3)
+-d, --duration INTEGER    iperf3 seconds per direction (default: 5)
+-c, --cycles INTEGER      mtr probe cycles (default: 10)
+--no-throughput           Skip throughput test, trace path only
+--cf-token TEXT           Cloudflare API token (or set NETPATH_CF_TOKEN)
+--json                    Output results as JSON
+```
+
+### Probe top ASNs for a country
+
+```bash
+netpath country US
+```
+
+Options:
+
+```
+-t, --top INTEGER         Number of top ASNs to test (default: 10)
+-n, --count INTEGER       Max servers per ASN (default: 3)
+-d, --duration INTEGER    iperf3 seconds per direction (default: 5)
+-c, --cycles INTEGER      mtr probe cycles (default: 10)
+--no-throughput           Skip throughput test
+--cf-token TEXT           Cloudflare API token (or set NETPATH_CF_TOKEN)
+```
+
+### Examples
+
+```bash
+# Probe Google's ASN
+netpath asn AS15169
+
+# Probe top 5 UK ISPs
+netpath country GB --top 5
+
+# Path-only probe (no throughput test)
+netpath asn AS7018 --no-throughput
+
+# JSON output for scripting
+netpath asn AS15169 --json | jq .verdict
+```
+
+## Cloudflare Radar RUM Overlay
+
+netpath can overlay Cloudflare Radar Real User Monitoring (RUM) quality metrics for each ASN, showing real-world HTTP performance data alongside your own measurements.
+
+To enable it, pass a Cloudflare API token with `radar:read` permission:
+
+```bash
+export NETPATH_CF_TOKEN=your_token_here
+netpath asn AS15169
+```
+
+Or pass it inline:
+
+```bash
+netpath asn AS15169 --cf-token your_token_here
+```
+
+Tokens are free. Create one in the [Cloudflare dashboard](https://dash.cloudflare.com/profile/api-tokens) with the `radar:read` permission scope.
+
+## License
+
+MIT

netpath-0.1.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+netpath/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+netpath/__main__.py,sha256=O7gesm5VkMQ65kHiFV8s52RkcKplMxRJ4nbFJTXxjaY,35
+netpath/asn.py,sha256=7TFIjMVnyl-MUxJPeyqg1KHTsgna1_0ScwF9q7mxFWA,3327
+netpath/cli.py,sha256=1vdvrn0kF81V91rxFf0CsyUOtQF02C7ja4jiA4w8nMc,21712
+netpath/country.py,sha256=LG8PppIOXcGy7mYNVwzB899G4Tr_SUfnwj4ICBc1h4M,4622
+netpath/diagnosis.py,sha256=iAqdOP95Nan-TYG3b9yS9N0Qcc9NNPl4vxZxfArK1YQ,3818
+netpath/display.py,sha256=tiZ-Nw4Ptc4g7gf6u9aF7MLbDdSsySf_DuuMcyc_5I0,16505
+netpath/globe.py,sha256=7a9f_Ink7AkhTKO2uDd8Hz591VFLj5tVFJi_TF8s4ME,6924
+netpath/iperf.py,sha256=w7IZCzcbRjsi-HndM-GdEEoUzq3NybUFBQU8qq2uZf4,1869
+netpath/mtr.py,sha256=Nf5HKrm1cdwX0FURbBTStlPs3QZFRJXpkYYKrxUkjyk,6298
+netpath/rum.py,sha256=eFYgXvlzUplQc0EtXNe5BxGJmbGJ_FbQHznzqBXs2cw,1678
+netpath/servers.py,sha256=45wTNyCnw12Sf2-gJngDu6ZVCh95MyvupKTh0tYXxjY,2102
+netpath/speedtest.py,sha256=muVLXt4w81CE_0GMNq8rhZzpbB5b_zpyJ177V2LZrRs,3369
+netpath-0.1.0.dist-info/METADATA,sha256=0torS0_wf5VpZnKSPO3as7v7Zm_UCceOUnCO04oRdT0,3627
+netpath-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+netpath-0.1.0.dist-info/entry_points.txt,sha256=NMuWiG1KEZIdFYL_ocRBE3WGFnQsVonfiS78WtYzuXU,44
+netpath-0.1.0.dist-info/licenses/LICENSE,sha256=iA0PlTyHGQVbvbs5Ik49HKKV3zRpCKjH1YSJxt48y5g,1067
+netpath-0.1.0.dist-info/RECORD,,

netpath-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

netpath-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+netpath = netpath.cli:run

netpath-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nick Moore
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.