Paperclip

Paperclip为OpenAPI规范提供工具。完成后，它将提供

• 在Rust中为高效、类型安全、编译时检查的HTTP API（服务器、客户端和CLI）生成代码。
• 支持处理、验证和托管OpenAPI规范。
• 规范和代码生成的自定义。

它目前正在积极开发中，可能尚未准备好用于生产。

您可能还对以下内容感兴趣

• 示例和用法.
• 正在开发的功能.
• API文档.

本地开发

• 请确保已安装rustup。 cd进入此仓库并运行make prepare来设置您的环境。
• 现在运行make来构建和运行测试。

贡献

本项目欢迎所有类型的贡献。没有贡献是微不足道的！

如果您想为此项目做出贡献但不知道从何开始，或者需要与此项目相关的帮助，请随时通过我的GitHub个人资料发送电子邮件，或加入Discord服务器。

行为准则

本项目遵循Rust行为准则。

许可证

根据以下任一许可证授权：

• Apache License，版本2.0 (LICENSE-APACHE或https://apache.ac.cn/licenses/LICENSE-2.0)
• 麻省理工学院许可证（LICENSE-MIT 或 http://opensource.org/licenses/MIT）

由您选择。

赞助商

为该项目开发提供赞助的人士

常见问题解答（FAQ）

为什么这个工具生成原始Rust代码而不是利用过程宏进行编译时代码生成？

我认为过程宏不是实现REST API的正确方式。我们需要以某种方式看到生成的代码，以便识别名称、字段、支持的方法等。使用过程宏，你只能猜测。

这并不意味着您不能在编译时生成API。唯一的区别是您将使用构建脚本而不是include!相关代码。话虽如此，我们在其他方面使用了过程宏。

编译时抛出的错误看起来并不太有用。难道没有更好的方法吗？

很遗憾，我想不出其他方法。

这里需要新的想法。

lib.rs:

paperclip的便利宏。

您不需要依赖此，因为这里的内容已经被相应的crates暴露。