Rust中的VRChat API

VRChat API的WIP Rust模型。

这是完全非官方的，与VRChat没有任何关联、认可、支持或创建。

非常感谢MIT许可的vrchatapi，这个crate从中借鉴了很多。如果您正在寻找一个更成熟的项目，请考虑查看他们的生成的rust crate。

尽管如此，我不喜欢它的生成性质，并且希望有些东西有更强的Rust风格，这就是这个crate存在的原因。

还有很多东西缺失，如果您想帮忙，请参见贡献。

分类来自令人惊叹的VRChat API文档项目。

测试

集成测试与实时API交互。这就是为什么它们默认被忽略。

大多数测试都需要身份验证。

遗憾的是，并非所有事情都可以在没有创建模拟API的情况下可靠地测试。这反而违背了测试的初衷。因此，实际上只测试了一些行为，尽管对其的改进是受欢迎的。

手动创建用户会话

由于使用cookie以及2fa需要另一个请求，获取VRC的身份验证需要几个步骤。

您可以使用get_auth.py脚本方便地操作。它是在正式的 typed rust API客户端准备好之前创建的，它是Python编写的。注意，您应该之前从相同的IP地址登录过，因为VRChat对来自新IP地址的登录处理方式不同，这只会破坏一切。

运行被忽略的测试

请确保您有

• 互联网连接
• 一个有效的 user-session.json

然后只需运行测试；

# A specific test with output logging
cargo test --all-features current_user -- --exact --ignored --nocapture
# All tests
cargo test --all-features -- --ignored

贡献

编码

这个crate的目标是质量高于数量。这意味着合并的标准可能比一些人愿意处理的要高。请运行clippy检查，并与nightly cargo格式化一起检查CI检查是否通过。

尽管如此，欢迎任何贡献，只需将PR标记为维护者可编辑即可。这样，即使你不打算对反馈采取行动，改进也可能会最终返回到这里。

其他

如果你不想编码，创建GitHub问题报告错误行为将非常受欢迎。此外，了解实际的数据类型和继承模型，以及改进文档，将极大地帮助开发！另外，给这个GitHub仓库点赞也有助于提高对该crate进行更多工作的动力，该crate也为其他项目提供服务。

许可证

请注意，许可证是 MPL-2.0 而不是更常见的 MIT OR Apache-2.0。