Paperclip

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

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

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

你可能还感兴趣

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

本地开发

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

贡献

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

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

行为准则

本项目遵循 Rust 行为准则。

许可协议

根据您选择以下任一许可协议进行许可

• Apache 许可协议 2.0 (LICENSE-APACHE 或 http://www.apache.org/licenses/LICENSE-2.0)
• MIT 许可协议 (LICENSE-MIT 或 http://opensource.org/licenses/MIT)

任选其一。

赞助商

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

常见问题解答

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

我认为过程宏并不是构建REST API的正确方法。我们需要能够以某种方式看到生成的代码，以识别名称、字段、支持的方法等。在使用过程宏的情况下，你只能大概猜测。

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

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

很遗憾，我想不出更好的方法。

需要新的想法。