Skip to main content

The official command line client for RIPE Atlas

Project description

RIPE Atlas Tools (Magellan)

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

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

Release History

1.2.2 (released 2016-01-13)

New Features

  • Cleaner and more consistent implementation of the renderer plugable architecture.

  • Usage of newest Cousteau library.

1.2.1 (released 2015-12-15)

Bug Fixes

  • Restored some required template files.

1.2.0 (released 2015-12-15)

Output Changes

  • #119: Support HTTP results.

  • #122: Allow packagers to set the user agent.

1.1.1 (released 2015-11-25)

Output Changes

  • #103: Removed header from the report command.

Bug Fixes

  • #105: Measurement report and stream broken on Python3.4.

1.1.0 (released 2015-11-12)

New features

  • Support for the creation of NTP, SSLCert, and HTTP measurements.

  • Additional argument in report command to filter results by probe ASN.

  • Additional renderer that shows the different destination ASNs and some additional stats about them.

Bug Fixes

  • Various fixes.

Changes

  • Better testing.

  • Additional documentation.

1.0.0 (released 2015-11-02)

  • Initial release.

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.2.2.tar.gz (84.2 kB view details)

Uploaded Source

Built Distribution

ripe.atlas.tools-1.2.2-py2.py3-none-any.whl (88.6 kB view details)

Uploaded Python 2 Python 3

File details

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

File metadata

File hashes

Hashes for ripe.atlas.tools-1.2.2.tar.gz
Algorithm Hash digest
SHA256 93f86d1177b3dc4dd9ac89f08b77d808f093150a5b0afb0351b30a628251a2a0
MD5 d1f78bfc70e88043f7b84b5dc65816be
BLAKE2b-256 175155d88d166f6b7e007083af51274eed1d37c49c06c763424b87eac06e1dfd

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for ripe.atlas.tools-1.2.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 db47828eedd580fdf9a30eb383bb1a5eeb699964c81d0940bfd13fc54e5972fc
MD5 5ae97318098215d0851554440dc93980
BLAKE2b-256 7b68dd5fc052f644476d3e08ef2417271c3120ae672b4e70afb7a92eca83aab5

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