Package: ripe.atlas.tools
RIPE Atlas Tools (Magellan)The official command-line client for RIPE Atlas.Full DocumentationEverything is up onReadTheDocsExamplesConfigure API key for creating measurements:$ ripe-atlas configure --set authorisation.create=MY_API_KEYPing an IP address from five probes:$ ripe-atlas measure ping ping.ripe.net --probes 5Search for connected probes in Germany, grouping by ASN:$ ripe-atlas probe-search --country de --aggregate-by asn_v4 --limit 10Search for NTP measurement metadata and process the results with awk:$ ripe-atlas measurement-search --type ntp --format tab --no-header --limit 5 \
  | awk -Ft '{printf "#%s (%s)\n", $1, $3}'Can I Contribute?Absolutely.  Please read ourguideon how to contribute.ColophonThis project was code-named by means of apoll.  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 History3.1.0 (release 2023-02-06)Improved probe-search and measurement-search, including “csv” and “tab” output–stream-timeout and –stream-limit added to measure commandUse the latest stream API (cousteau update) and add –timeout to stream command3.0.3 (release 2022-11-18)Fix issue where the measure command would continue to stream results after all probes have responded3.0.2 (release 2022-05-23)Fix “measure spec” command which was broken due to cousteau issue3.0.1 (release 2022-02-24)Updated cousteau dependency to the non-alpha release3.0.0 (release 2022-02-23)API keys can now be passed in environment variablesprobe-search by –location now works, as long as the user specifies their own Google Geocoding API keyModernized tests and switched to GitHub actionsThe default renderer for ping measurements is now more consistent and more similar to other ping tools, including having a statistical summary at the endmeasure, report and stream commands now all use the same set of renderers“measure spec” command which takes a JSON blob to create measurementsAllow measure –target to be specified as a positional arg (or –query-argument for DNS)Move to latest cousteau version (python-socketio)Various other fixes to code and documentationOfficial supported Python versions changed to 3.6, 3.7, 3.8, 3.9 and 3.102.3.0 (released 2018-11-23)Features and changesAdd result date and time to traceroute, NTP and SSL renderersAdd support for specifying measurement tags on measurement creationAdd option (–go-web) to open measurement URL in browserNicer presentation of 403 errors from the APIOfficial supported Python versions changed to 2.7, 3.4, 3.5, 3.6 and 3.7Bug FixesFix cousteau/sagan dependencies2.2.3 (released 2017-01-17)Bug FixesFix for distribution issues that prevented the command-line scripts from working2.2.2 (released 2017-10-12)Features and changesAlign various option defaults, minimums and maximums with API reality, including…… allow the set of options necessary for “TCP ping” measurementshttps://labs.ripe.net/Members/wilhelm/measuring-your-web-server-reachability-with-tcp-pingAdd compact DNS results rendererFix some unicode output issues2.1 (released 2016-04-21)New FeaturesAdd a simple NTP rendererChangesUse new cousteau (1.4) & sagan(1.2) versions.Bug FixesFix for some unicode problems when using colorsFix issue #177, withgdbmproblem.2.0.2 (released 2016-10-21)New FeaturesAdd aliases to measurements IDsAdd –traceroute-show-asns to traceroute rendererBug FixesStream 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 probeVarious fixes for tests2.0.1 (released 2016-04-20)ChangesCorrected references in the docs to obsolete command names.Fixed broken 2.0.0 egg.2.0.0 (released 2016-04-20)ChangesRenamed 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)ChangesUsage 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 FeaturesCleaner and more consistent implementation of the renderer plugable
architecture.Usage of newest Cousteau library.1.2.1 (released 2015-12-15)Bug FixesRestored 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 thereportcommand.Bug Fixes#105: Measurement report and stream broken on Python3.4.1.1.0 (released 2015-11-12)New featuresSupport 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 FixesVarious fixes.ChangesBetter testing.Additional documentation.1.0.0 (released 2015-11-02)Initial release.