收割者
reaper的Python项目详细描述
一个简单的模块,当 库版本或需求更改
众所周知,跟踪不推荐使用的函数和 定期清除死掉的代码。尤其是当 将函数标记为已弃用,通常会忘记提到 贬损的时间线。
这迫使您通过一个简单的规范 应该发生不推荐,并删除死代码。
用例
不推荐您自己库的组件。
假设当前版本的reaper有坏api,我打算删除 0.5,但想暂时留下来。我可以用 以下内容:
fromreaperimportdeprecate@deprecate("reaper",">=0.5.0")defthrow_warnings(predicate,category,version,message):""" This is too hard to use ! """pass
这将向调用函数的用户显示DeprecationWarning。 从0.1.x到0.4.x的任何版本,并将DeprecationException提升到 任何使用0.5.0-dev或更高版本的用户。
未来计划
- 允许在持续集成系统上及早提出使用 在开发过程的早期不推荐使用的api,并且仍然允许您 在本地使用代码。
- 基于时间/日期执行相同操作的能力
- 不是装饰器/上下文管理器的版本
- 能够标记支持的依赖项的版本,并在 最小依赖项列表更改:
ifdeprecate(`tornado`,`<=4.3.1`):#do stuffelse:# do other stuff
第一个分支(或者实际上是谓词)应该尽快发出警告/引发 像tornado>=4.4这样的东西出现在requirements.txt中 找到了一些死代码。