Context-Generic Programming 发布 v0.8.0,新增 cargo-cgp 工具改善编译错误提示
来源标题:Context-Generic Programming v0.8.0 – Pluggable trait implementations for Rust
Context-Generic Programming(CGP)v0.8.0 发布,重点在降低学习和维护门槛。新工具 cargo-cgp 可将宏生成的编译错误转述为用户代码层面的提示,例如指出缺少哪个字段。该版本还引入命名空间,可用一条 wiring 条目为一组组件统一选择 provider。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
Context-Generic Programming(CGP)v0.8.0 正式发布!这个版本的重点是让 CGP 更易学习和维护。它引入了 cargo-cgp,这是一个新工具,用来解决 CGP 长期存在的一个问题:编译错误描述的是宏生成的代码,而不是你写的代码。cargo-cgp 用你的语言来解释这些错误。例如,当某个 provider 需要你的类型缺少的字段时,它能告诉你该添加哪个字段,而展开后的文档会解释 provider 为什么需要这个字段。后续随着应用增长,新的命名空间让你可以在一条 wiring 条目中为一整组组件选择 provider。
CGP 是 Rust 的一个语言扩展,提供编译期可插拔的 trait 实现。它是稳定版 Rust 上的普通库:应用通过 wiring 选择 provider,最终解析为静态调用,而且你可以一次只采用一个组件。Overview 文档解释了这一模型。
我先从 cargo-cgp 和新文档讲起,然后通过一个社交媒体应用来演示命名空间。命名空间部分是最长的,所以如果你愿意,也可以单独阅读工具和文档的新闻。完整读完这篇帖子(包括代码)大约需要 35 分钟,或者直接跳到你需要的小节:
自 CGP 诞生以来,冗长且令人困惑的编译错误一直是采用它的最大障碍之一。漏掉一个字段或一个组件绑定,错误信息可能会给出一个生成 trait 的名字,或者显示一个被编码为 Rust 类型的字段名。编译器检查的是宏展开后生成的 Rust 代码,所以它的解释可能与你犯错的那段代码相去甚远。
对新手来说,这意味着可能要学会高级 Rust trait 和泛型,以及 CGP 的内部机制,才能诊断一个小错误。你可能理解自己想写的程序,却仍然不清楚它为什么编译不过。因为难点在于编译器如何报告展开后的代码,仅靠更好的语法无法解决。
所以我构建了 cargo-cgp v0.1.0,这是 CGP 的新错误工具链,用来按照你写的代码来报告这些错误。cargo cgp check 会检查 CGP 代码,并通过涉及的字段、组件和 provider 来解释缺失的依赖,先说根因。不过它还没有重塑所有类别的错误,所以有些错误仍然以编译器自己的措辞出现。如果你想深入查看,cargo cgp expand 会显示宏生成的 Rust 代码。
让我们用面积计算教程里的一个小错误来试试。我们有一个面积 provider,把宽乘以高,而 Rectangle 只提供了 width。这里,Rectangle 本身就是上下文:它是操作作用的值,它的字段提供 provider 的输入。
把这个库示例保存为使用 cgp = "0.8.0" 的 Cargo 包中的 src/lib.rs:
use cgp::prelude::*;
#[cgp_component(AreaCalculator)]
pub trait CanCalculateArea {
fn area(&self) -> f64;
#[cgp_impl(new RectangleArea)]
impl AreaCalculator {
fn area(&self, #[implicit] width: f64, #[implicit] height: f64) -> f64 {
width * height
#[derive(HasField)]
pub struct Rectangle {
pub width: f64,
// missing height field
delegate_and_check_components! {
Rectangle {
AreaCalculatorComponent: RectangleArea,
这个表选择了 RectangleArea,它的 #[implicit] 参数会读取 Rectangle 的字段。因为我们使用了 delegate_and_check_components!,编译器会在 wiring 条目处检查这些依赖。运行 cargo cgp check,它会指向我们忘记的字段:
error[E0277]: [CGP-E001] missing field height on Rectangle
--> src/lib.rs:23:9
|
23 | AreaCalculatorComponent: RectangleArea,
| ^^^^^^^^^^^^^^^^^^^^^^^
|
= note: root cause: [CGP-E110] missing field height on Rectangle
this is required through the dependency chain:
[CGP-E101] consumer trait impl CanCalculateArea for context Rectangle
└─ [CGP-E102] provider trait impl AreaCalculator with context Rectangle for provider RectangleArea
└─ [CGP-E110] missing field height on Rectangle
= help: add the field height: f64 to Rectangle
help 行给出了要做的编辑:height: f64。要了解 provider 为什么需要它,依赖树会带我们经由 RectangleArea 回到面积操作。作为对比,普通的 cargo check 会通过生成的 trait 和嵌套的 Symbol 类型来描述同一个错误:
error[E0277]: the trait bound Rectangle: CanUseComponent<AreaCalculatorComponent> is not satisfied
--> src/lib.rs:23:9
|
23 | AreaCalculatorComponent: RectangleArea,
| ^^^^^^^^^^^^^^^^^^^^^^^ unsatisfied trait bound
|
help: the trait HasField<Symbol<6, Chars<'h', Chars<'e', Chars<'i', Chars<'g', Chars<_, cgp::macro_prelude::Chars<'t', Nil>>>>>>>> is not implemented for Rectangle
but trait HasField<Symbol<5, Chars<'w', Chars<'i', Chars<'d', Chars<'t', Chars<_, Nil>>>>>>> is implemented for it
--> src/lib.rs:17:9
|
17 | pub width: f64,
| ^^^^^
note: required for RectangleArea to implement IsProviderFor<AreaCalculatorComponent, Rectangle>
--> src/lib.rs:8:1
|
8 | #[cgp_impl(new RectangleArea)]
| ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
= note: required for Rectangle to implement CanUseComponent<AreaCalculatorComponent>
note: required by a bound in __CanUseRectangle
--> src/lib.rs:21:1
|
21 | / delegate_and_check_components! {
22 | | Rectangle {
23 | | AreaCalculatorComponent: RectangleArea,
24 | | }
25 | | }
| |_^ required by this bound in __CanUseRectangle
= note: this error originates in the attribute macro cgp_impl which comes from the expansion of the macro delegate_and_check_components (in Nightly builds, run with -Z macro-backtrace for more info)
按照那条建议,我们加上缺失的字段:
#[derive(HasField)] pub struct Rectangle { pub width: f64, pub height: f64,
现在 wiring 检查通过了,provider 可以读取两个字段来计算面积。修复这个错误不需要解码 height 的类型级拼写。
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。