Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

The official command line client for RIPE Atlas

Project Description

RIPE Atlas Tools (Magellan)

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

2.2.2 (released 2017-10-12)

Features and changes

2.1 (released 2016-04-21)

New Features

  • Add a simple NTP renderer

Changes

  • Use new cousteau (1.4) & sagan(1.2) versions.

Bug Fixes

  • Fix for some unicode problems when using colors
  • Fix issue #177, with gdbm problem.

2.0.2 (released 2016-10-21)

New Features

  • Add aliases to measurements IDs
  • Add –traceroute-show-asns to traceroute renderer

Bug Fixes

  • Stream command was not passing the correct API key. After API became stricter this command started failing.
  • Handle missing geometry for probes.
  • Fix issues for AS-paths with only 1 probe
  • Various fixes for tests

2.0.1 (released 2016-04-20)

Changes

  • Corrected references in the docs to obsolete command names.
  • Fixed broken 2.0.0 egg.

2.0.0 (released 2016-04-20)

Changes

  • Renamed and merged some commands for clarity, preserving the old names as deprecated aliases.
  • Improved help text and usage output.
  • Support for bash auto-completion.

1.2.3 (released 2016-03-08)

Changes

  • Usage of newest Cousteau/Sagan library.
  • Support of API keys for fetching results on report command.
  • Default radius for probes filtering is changed to 15.
  • Several changes for supporting Windows.

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.
Release History

Release History

This version
History Node

2.2.2

History Node

2.2.1

History Node

2.2

History Node

2.1

History Node

2.0.2

History Node

2.0.1

History Node

1.2.3

History Node

1.2.2

History Node

1.2.1

History Node

1.2.0

History Node

1.1.1

History Node

1.1.0

History Node

1.0.0

History Node

0.0.5

History Node

0.0.4

History Node

0.0.3

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
ripe.atlas.tools-2.2.2-py2.py3-none-any.whl (102.1 kB) Copy SHA256 Checksum SHA256 py2.py3 Wheel Oct 12, 2017
ripe.atlas.tools-2.2.2.tar.gz (101.2 kB) Copy SHA256 Checksum SHA256 Source Oct 12, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting