Official command-line client for RIPE Atlas
Python Shell
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
dev-scripts Support --resolve-on-probe Oct 12, 2017
docs
ripe Fix incorrect raise NotImplemented May 25, 2018
scripts
tests Merge pull request #192 from RIPE-NCC/sync-options Oct 12, 2017
.gitignore TLS report, first draft (aka Sslcert) Sep 21, 2015
.travis.yml change to travis to use their new faster way of building projects Nov 6, 2015
CHANGES.rst New release because the previous one had non-functioning scripts Jan 17, 2018
CONTRIBUTING.rst Fixt typo Nov 18, 2015
LICENSE
MANIFEST.in
PACKAGING.md Added status for Voidlinux Dec 15, 2016
README.rst Added a newline to trigger Travis CI Jul 15, 2016
ripe-atlas-bash-completion.sh Fixes partially #113, as it adds auto-completion for bash shell Mar 28, 2016
setup.cfg
setup.py
tox.ini add py3 proper syntax checking Dec 14, 2015

README.rst

RIPE Atlas Tools (Magellan)

Documentation Status Build Status PYPI Version Python Versions Python Implementations Python Format Requirements Status

The official command-line client for RIPE Atlas.

Full Documentation

Everything is up on ReadTheDocs

How Does it Work?

Presently, the setup is pretty crude. You can create a ping or traceroute measurement with limited options from the command line:

$ ripe-atlas measure ping --target example.com
$ ripe-atlas measure ping --packets 7 --size 42 --target example.com
$ ripe-atlas measure traceroute --target example.com
$ ripe-atlas measure traceroute --packets 2 --target example.com
$ ripe-atlas measure dns --query-argument example.com
$ ripe-atlas measure dns --use-probe-resolver --query-type AAAA --query-argument example.com

This will create a one-off measurement and then wait for the results to roll in, formatting them as they do.

You can also use it to connect to a stream of formatted data. This command will start streaming out all of the results from one of our oldest measurements:

$ ripe-atlas stream 1001

Or you can generate a simple report:

$ ripe-atlas report 1001

Configuration is done by way of a config file, and modifying it can be done from the command line:

$ ripe-atlas configure --set authorisation.create=MY_API_KEY

Can I Contribute?

Absolutely. Please read our guide on how to contribute.

Colophon

This project was code-named by means of a poll. In order to conform to the RIPE Atlas theme, it had to be named for an explorer, and so the winning suggestion was for Magellan, "in memory of those times when RTT was ~3 years".