跳转到主要内容

你做了一件事,但现在你希望它消失……废弃,一段爱情故事。

项目描述

PyPI version Supported Python versions Build status Codecov Code coverage ReadTheDocs status

regret 是一个用于在Python库和应用程序中废弃功能性的库。

它的文档位于 Read the Docs

废弃

regret 可以废弃

  • [x] 可调用对象
    • [x] 函数

    • [x] 类
      • [ ] 可子类化的类

  • [ ] 属性
    • [ ] 模块的

    • [ ] 类(与方法)的

    • [ ] 实例的

  • [ ] 描述符
    • [ ] 类方法

  • [ ] 模块
    • [ ] 当前模块

    • [ ] 其他模块

  • [ ] 可调用对象的参数
    • [x] 将被删除的先前必需参数

    • [x] 现在必需的可选参数

    • [ ] 参数的废弃值

    • [ ] 参数的类型更改

    • [ ] 互斥

  • [ ] 接口
    • [ ] PEP 544 协议

    • [ ] zope.interface

  • [x] 类的可继承性

设计目标

regret 旨在涵盖作者可能遇到的全部废弃。

它旨在

  • 应与版本控制系统无关(例如 SemVerCalVerHipsTer 等),因为弃用始于版本、一个时间点或两者。

  • 应了解文档系统(例如 SphinxepydocPlaintext 等),因为弃用需要沟通。

  • 自身应完全经过测试,因为弃用不能破坏它们所弃用的代码

  • 支持删除日期指示,以及可能“策略”,这些策略会自动化选择默认删除日期,因为弃用最终目的是实现某种最终变化

  • 使“清洁代码”轻松弃用,并使复杂代码 可能 弃用,因为弃用过程充满了边缘情况和不可预见的需求。

  • 尽可能减少作者所需的与弃用相关的代码量,因为弃用很无聊,我们都想专注于开发我们的库。

特别是,作为一个崇高的第一个里程碑,它旨在涵盖所有这些 jsonschema 问题,并且幸运的是,包含 twisted.python.deprecate 中的所有功能。

项目详情


发布历史 发布通知 | RSS 源

下载文件

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

源分发

regret-2024.2.2.tar.gz (32.9 kB 查看哈希值

上传时间

构建分发

regret-2024.2.2-py3-none-any.whl (20.4 kB 查看哈希值

上传于 Python 3

支持