废弃至

该软件包引入了一个新的 deprecate_until 属性，帮助软件包作者在达到某个版本时不要删除过时的项目。当指定的 semver 条件得到验证时，软件包将无法编译，并希望这能被 CI 或 cargo install 在实际发布之前捕获。

用法

deprecate_until 属性支持与 deprecate 相同的参数，即 note 和 since。它还需要一个 remove 参数，这是一个字符串中的 semver 要求表达式。

示例

以下代码

use deprecate_until::deprecate_until;

#[deprecate_until(remove = ">= 4.x", note = "use `some_new_function` instead")]
fn old_function() {
    todo!()
}

当在项目中使用软件包的版本 3.8 时将给出警告

warning: use of deprecated function `old_function`: use `some_new_function` instead (removal scheduled for version >= 4.x)
  |
4 | fn old_function() {
  |    ^^^^^^^^^^^^

如果忘记移除它，它将导致软件包版本 4.0.0 中的编译错误

error: version `4.0.0` matches `>= 4.x`, item should be removed
  |
3 | #[deprecate_until(remove = ">= 4.x", note = "use `some_new_function` instead")]
  | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^