pidiff

pidiff - Python接口差异工具

• 文档
• 源代码
• PyPI

pidiff 是一个用于检测和报告Python模块多个版本之间API变化的工具。它可以作为一个测试工具，帮助项目遵循 语义版本控制 规范。

示例

使用 pidiff 命令可以从PyPI安装旧的和新的包版本，并在版本之间比较模块，如果没有适当使用SemVer，则会失败。

以下是diff找到一些问题的示例

$ pidiff more-executors==1.15.0 more-executors==1.16.0
more_executors/_wrap.py:6: N220 function added: flat_bind
more_executors/retry.py:46: N450 ExceptionRetryPolicy now accepts unlimited keyword arguments
more_executors/retry.py:46: B330 argument in ExceptionRetryPolicy can no longer be passed positionally: max_attempts (was position 0)
more_executors/retry.py:133: N450 RetryExecutor now accepts unlimited keyword arguments
more_executors/retry.py:133: B130 method removed: new_default

---------------------------------------------------------------------
Major API changes were found; inappropriate for 1.15.0 => 1.16.0
New version should be equal or greater than 2.0.0

在没有增加包版本的主版本的情况下移除了公共API；pidiff将其视为错误，并建议设置新的最小版本号以接受这些更改。

以下是diff报告成功结果的示例

$ pidiff more-executors==1.11.0 more-executors==1.12.0
more_executors/flat_map.py:0: N210 module added: flat_map
more_executors/_executors.py:84: N230 method added: with_flat_map

---------------------------------------------------------------------
Minor API changes were found; appropriate for 1.11.0 => 1.12.0

添加了公共API；由于增加了包版本的小版本，这是可以的。

许可协议

本程序是免费软件：您可以按照自由软件基金会发布的GNU通用公共许可证的条款重新分发和/或修改它，许可证版本为3，或（根据您的选择）任何后续版本。