Skip to main content

The official command line client for RIPE Atlas

Project description

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

The official command-line client for RIPE Atlas.

Disclaimer

All of this is super-beta. If it breaks, you get to keep all the shiny pieces.

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”.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ripe.atlas.tools-1.0.0.tar.gz (111.3 kB view details)

Uploaded Source

Built Distribution

ripe.atlas.tools-1.0.0-py2.py3-none-any.whl (155.9 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file ripe.atlas.tools-1.0.0.tar.gz.

File metadata

File hashes

Hashes for ripe.atlas.tools-1.0.0.tar.gz
Algorithm Hash digest
SHA256 283f1c336ef9989276a3799cda21b902f89b6587036be8f6f5f5e380696b7eae
MD5 b8b5be6334c6940fa2a55f2d6656cfcf
BLAKE2b-256 caf4c9464198b986c71db7303cac58bcacf6af29cc2f4f1e763e3ec8ac7bcd06

See more details on using hashes here.

File details

Details for the file ripe.atlas.tools-1.0.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for ripe.atlas.tools-1.0.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 64be90f2ceee9b340d7dc1bf0c2008ea5a112123c6eb5156ffffae812ba565d7
MD5 55ca895bf8baa938d53e5d7c508400b1
BLAKE2b-256 b43964dd891895363eba1d0ae0db4ccb34d2aeb1f2ed4c86186cecf4540b4866

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page