1.3.稳定性保证
稳定性与 SemVer
async-std
遵循 semver.org/。
简而言之,我们将软件版本分为MAJOR.MINOR.PATCH
。我们将会更新:
- MAJOR 版本当有不可兼容的 API 更改
- MINOR 版本当有向后兼容的功能更新
- PATCH 版本当有向后兼容的 bug 修复
我们将提供用于 major 版本之间的迁移文档。
未来展望
async-std
实现了以下 traits:
Read
Write
Seek
BufRead
Stream
为了与生态交互,所有实现了这些 traits 的类型都在futures-rs
库中实现了相应的接口。
我们的 SemVer 保证并不包含这些接口,这些接口将会保守地同步更新。
最低版本政策
当前的暂行政策是使用该 crate 的所需的最低 Rust 版本可能会随着 crate 的 minor 版本的提高而提高。假设async-std
1.0 所需的最低 Rust 版本为 1.37.0,则所有的async-std
1.0.z 所需的最低 Rust 版本都为 1.37.0,而使用async-std
1.y (y>0)所需的最低 Rust 版本可能会大于 1.37.0。
一般来说,本 crate 对于最低支持 Rust 版本的改动比较保守。但async/await
本身就是一个新功能,我们将在开发初期逐步地改动最低支持 Rust 版本。
安全修复
安全修复适用于所有支持 的 major 版本下的所有 的 minor 分支。这一政策可能会有改动,但我们将会在至少三个月 前发出通知。
说明
该政策基于BurntSushi's regex crate.
原文链接:book.async.rs/
本译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。