Skip to main content

RIPE Atlas 的官方命令行客户端

项目描述

RIPE Atlas 工具(麦哲伦)

文件状态 构建状态 PYPI 版本 Python 版本 Python 实现 Python 格式 需求状态

RIPE Atlas 的官方命令行客户端。

完整文档

一切都在ReadTheDocs上

它是如何工作的?

目前,设置相当粗糙。您可以从命令行使用有限选项创建 ping 或 traceroute 测量:

$ ripe-atlas measure ping --target example.com

# or you can omit --target for most measurement types
$ ripe-atlas measure ping 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

# or you can omit --query-argument for DNS measuremetns
$ ripe-atlas measure dns example.com

$ ripe-atlas measure dns --use-probe-resolver --query-type AAAA --query-argument example.com

这将创建一次性测量,然后等待结果滚入,按原样进行格式化。

您还可以使用它连接到格式化数据流。此命令将开始输出我们最古老的测量之一的所有结果:

$ ripe-atlas stream 1001

或者您可以生成一个简单的报告:

$ ripe-atlas report 1001

配置是通过配置文件完成的,可以从命令行进行修改:

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

我可以贡献吗?

绝对地。请阅读我们关于如何贡献的指南。

版权所有

这个项目是通过民意调查代号的。为了符合 RIPE Atlas 主题,它必须以探险家的名字命名,因此获胜的建议是麦哲伦,“以纪念 RTT 大约 3 年的那些时代”。

发布历史

3.0.2(2022-05-23 发布)

  • 修复因库斯托问题而损坏的“测量规格”命令

3.0.1(2022-02-24 发布)

  • 将库斯托依赖项更新到非 alpha 版本

3.0.0(2022-02-23 发布)

  • API 密钥现在可以在环境变量中传递

  • 只要用户指定自己的 Google 地理编码 API 密钥,现在可以通过 –location 进行探测搜索

  • 现代化测试并切换到 GitHub 操作

  • ping 测量的默认渲染器现在更一致,更类似于其他 ping 工具,包括在末尾有一个统计摘要

  • 测量、报告和流命令现在都使用相同的渲染器集

  • “measure spec”命令,它采用 JSON blob 来创建测量值

  • 允许将 measure –target 指定为位置参数(或 DNS 的 –query-argument)

  • 移动到最新的库斯托版本(python-socketio)

  • 对代码和文档的各种其他修复

  • 官方支持的 Python 版本更改为 3.6、3.7、3.8、3.9 和 3.10

2.3.0(2018-11-23发布)

特点和变化

  • 将结果日期和时间添加到 traceroute、NTP 和 SSL 渲染器

  • 添加对在创建测量时指定测量标签的支持

  • 添加选项 (-go-web) 以在浏览器中打开测量 URL

  • 更好地展示 API 中的 403 错误

  • 官方支持的 Python 版本更改为 2.7、3.4、3.5、3.6 和 3.7

Bug修复

  • 修复库斯托/萨根依赖项

2.2.3(2017-01-17发布)

Bug修复

  • 修复了阻止命令行脚本工作的分发问题

2.2.2(2017-10-12发布)

特点和变化

2.1(2016-04-21发布)

新的功能

  • 添加一个简单的 NTP 渲染器

变化

  • 使用新的库斯托(1.4)和萨根(1.2)版本。

Bug修复

  • 修复了使用颜色时的一些 unicode 问题

  • 修复问题 #177,与gdbm问题。

2.0.2(2016-10-21 发布)

新的功能

  • 为测量 ID 添加别名

  • 将 –traceroute-show-asns 添加到 traceroute 渲染器

Bug修复

  • Stream 命令未传递正确的 API 密钥。在 API 变得更严格之后,这个命令开始失败。

  • 处理探针的缺失几何。

  • 仅用 1 个探针修复 AS 路径的问题

  • 各种测试修复

2.0.1(2016-04-20发布)

变化

  • 更正了文档中对过时命令名称的引用。

  • 修复了损坏的 2.0.0 鸡蛋。

2.0.0(2016-04-20 发布)

变化

  • 为了清楚起见,重命名并合并了一些命令,将旧名称保留为不推荐使用的别名。

  • 改进的帮助文本和使用输出。

  • 支持 bash 自动完成。

1.2.3(2016-03-08发布)

变化

  • 使用最新的 Cousteau/Sagan 图书馆。

  • 支持获取报告命令结果的 API 密钥。

  • 探针过滤的默认半径更改为 15。

  • 支持 Windows 的一些更改。

1.2.2(2016-01-13发布)

新的功能

  • 渲染器可插入架构的更清晰和更一致的实现。

  • 使用最新的 Cousteau 库。

1.2.1(2015-12-15发布)

Bug修复

  • 恢复了一些必需的模板文件。

1.2.0(2015-12-15发布)

输出变化

  • #119 : 支持 HTTP 结果。

  • #122 : 允许打包者设置用户代理。

1.1.1(2015-11-25发布)

输出变化

Bug修复

  • #105 : Python3.4 上的测量报告和流中断。

1.1.0(2015-11-12 发布)

新的功能

  • 支持创建 NTP、SSLCert 和 HTTP 测量。

  • 报告命令中的附加参数,用于按探测 ASN 过滤结果。

  • 显示不同目标 ASN 和一些关于它们的附加统计信息的附加渲染器。

Bug修复

  • 各种修复。

变化

  • 更好的测试。

  • 附加文件。

1.0.0(2015-11-02 发布)

  • 初始发行。

项目详情


下载文件

下载适用于您平台的文件。如果您不确定要选择哪个,请了解有关安装包的更多信息。

内置分布

成熟的.atlas.tools-3.0.2-py3-none-any.whl (119.6 kB 查看哈希)

已上传 py3