openharmony_ci
5a366776e1
README.OpenSource修改 Created-by: dragonswordy Commit-by: ljy9810 Merged-by: openharmony_ci Description: ### 一、内容说明（相关的Issue） https://gitcode.com/openharmony/third_party_rust_unicode-ident/issues/3 ### 二、建议测试周期和提测地址 建议测试完成时间：xxxx.xx.xx 投产上线时间：xxxx.xx.xx 提测地址：CI环境/压测环境 测试账号： ### 三、变更内容 * 3.1 关联PR列表 * 3.2 数据库和部署说明 1. 常规更新 2. 重启unicorn 3. 重启sidekiq 4. 迁移任务：是否有迁移任务，没有写 "无" 5. rake脚本：`bundle exec xxx RAILS_ENV = production`；没有写 "无" * 3.4 其他技术优化内容（做了什么，变更了什么） - 重构了 xxxx 代码 - xxxx 算法优化 * 3.5 废弃通知（什么字段、方法弃用？） * 3.6 后向不兼容变更（是否有无法向后兼容的变更？） ### 四、研发自测点（自测哪些？冒烟用例全部自测？） 自测测试结论： ### 五、测试关注点（需要提醒QA重点关注的、可能会忽略的地方） 检查点： | 需求名称 | 是否影响xx公共模块 | 是否需要xx功能 | 需求升级是否依赖其他子产品 | |------|------------|----------|---------------| | xxx | 否 | 需要 | 不需要 | | | | | | 接口测试： 性能测试： 并发测试： 其他： See merge request: openharmony/third_party_rust_static-assertions-rs!8
Compile-time assertions for Rust, brought to you by Nikolai Vazquez.
This library lets you ensure correct assumptions about constants, types, and more. See the docs and FAQ for more info!
Installation
This crate is available
on crates.io and can be used by
adding the following to your project's
Cargo.toml:
[dependencies]
static_assertions = "1.1.0"
and this to your crate root (main.rs or lib.rs):
#[macro_use]
extern crate static_assertions;
Usage
This crate exposes the following macros:
assert_cfg!assert_eq_align!assert_eq_size!assert_eq_size_ptr!assert_eq_size_val!assert_fields!assert_impl_all!assert_impl_any!assert_impl_one!assert_not_impl_all!assert_not_impl_any!assert_obj_safe!assert_trait_sub_all!assert_trait_super_all!assert_type_eq_all!assert_type_ne_all!const_assert!const_assert_eq!const_assert_ne!
FAQ
-
Q: When would I want to use this?
A: This library is useful for when wanting to ensure properties of constants, types, and traits.
Basic examples:
-
With the release of 1.39,
str::lencan be called in aconstcontext. Usingconst_assert!, one can check that a string generated from elsewhere is of a given size:const DATA: &str = include_str!("path/to/string.txt"); const_assert!(DATA.len() < 512); -
Have a type that absolutely must implement certain traits? With
assert_impl_all!, one can ensure this:struct Foo { value: // ... } assert_impl_all!(Foo: Send, Sync);
-
-
Q: How can I contribute?
A: A couple of ways! You can:
-
Attempt coming up with some form of static analysis that you'd like to see implemented. Create a new issue and describe how you'd imagine your assertion to work, with example code to demonstrate.
-
Implement your own static assertion and create a pull request.
-
Give feedback. What are some pain points? Where is it unpleasant?
-
Write docs. If you're familiar with how this library works, sharing your knowledge with the rest its users would be great!
-
-
Q: Will this affect my compiled binary?
A: Nope! There is zero runtime cost to using this because all checks are at compile-time, and so no code is emitted to run.
-
Q: Will this affect my compile times?
A: Likely not by anything perceivable. If this is a concern, this library can be put in
dev-dependencies:[dev-dependencies] static_assertions = "1.1.0"and then assertions can be conditionally run behind
#[cfg(test)]:#[cfg(test)] const_assert_eq!(MEANING_OF_LIFE, 42);However, the assertions will only be checked when running
cargo test. This somewhat defeats the purpose of catching false static conditions up-front with a compilation failure. -
Q: What is
const _?A: It's a way of creating an unnamed constant. This is used so that macros can be called from a global scope without requiring a scope-unique label. This library makes use of the side effects of evaluating the
constexpression. See the feature's tracking issue and issue #1 for more info.
Changes
See CHANGELOG.md
for a complete list of what has changed from one version to another.
License
This project is released under either:
at your choosing.