#error-management #performance #universal #csv #high

common-error-build

High performance universal error code management for Rust in Rust

2 releases

0.1.1 Sep 21, 2024
0.1.0 Sep 20, 2024

#167 in Procedural macros

Download history 296/week @ 2024-09-20 15/week @ 2024-09-27 3/week @ 2024-10-04

314 downloads per month

Apache-2.0

13KB
198 lines

common-error:Rust 的高性能通用错误码管理

英文 | 简体中文

概述

通用错误码是为 Rust 提供的高性能通用错误码管理工具。

提供一个构建过程,用于解析 crate 中的 common-error.csv 并将其转换为 rust 文件。

所有解析和转换过程都会提前生成代码,以实现一定程度的高性能。

简介

CSV示例

  • 高性能:在构建阶段预先生成错误消息的字面汇编
  • 易于管理:通过文件控制管理错误码

问题

本项目存在以下问题,请谨慎选择使用。

  • 生成的代码未格式化:因为错误码数量很多,因此进行单行显示。

未格式化

  • 需要手动引入:因为include文件在宏展示时,顺序和编译顺序冲突,可能导致crate编译失败因此需要手动引入。 未格式化

  • 为什么不用宏:因为使用宏不利于统一维护,如果有需要可以邮件联系我。下面图片是使用宏的状态 未格式化

  • xml、toml、properties的支持:目前数据结构校验已经打通,如果有需要的可以邮件联系我。

坐者一直兴奋,看着简单,听着也很简单的方式维护自己的项目,因此基于个人觉得不算好的的写法就没有收录进去

快速开始

步骤 1:在 crate 中引入依赖

[build-dependencies]
common-error-build = "0.1.0"

[dependencies]
common-error = "0.1.0"

步骤 2:构建脚本调用 error_build 函数。 步骤 3:维护你的 common-error.csv 文件。 步骤 4:在你的crate 中引入 _common_error mod

许可证

本项目采用 Apache 2.0 许可证 授权。

Dependencies

~3.5–5.5MB
~88K SLoC