#twilight #discord #discord-api #api-bindings

已删除 sparkle-cache

Twilight生态系统的一个后端无关的Discord缓存实现

0.14.1 2022年12月6日
0.14.0 2022年11月18日
0.13.21 2022年11月6日
0.13.19 2022年10月17日
0.13.7 2022年9月28日

#29 in #twilight

每月32次下载
sparkle-cache-postgres 中使用

ISC 许可证

140KB
2.5K SLoC

Sparkle Cache

GitHub crates.io docs.rs

Twilight生态系统的一个后端无关的Discord缓存实现

它提供了一个 Cache trait,该trait提供了从缓存中获取数据的方法,以及一个 Backend trait,用于添加对后端的支持,更多内容请参阅每个trait的文档

用法

此crate是为了添加对后端的支持,如果您只需要使用缓存,您应该使用以下crate之一

兼容性

模型不使用任何数组,每个字段都是原始类型,这使得它无需额外设置即可与schematic后端兼容

不完整性

目前只缓存事件数据,尽管支持需要API方法的数据也在待办事项列表中

这意味着目前无法缓存这些数据

  • 私聊频道
  • 封禁
  • 自动管理规则
  • 集成
  • 计划事件
  • 邀请
  • Webhooks
  • 您可以通过创建PR添加到此列表中缺失的数据

支持Twilight之外的库

这并不紧密依赖于Twilight,您可以轻松地分叉它并更改其中使用的Twilight模型

版本控制

因为它试图遵循Twilight的版本,次要版本将包含破坏性更改。这意味着您应该将其固定到最新版本。例如,不要使用 sparkle-cache = "0.14",而应该使用 sparkle-cache = "0.14.0"。当然,尽量保持最新版本,因为更新通常包含错误修复

特性

测试

启用测试模块,它旨在用于实现此库中特质的库,并且仅在 [dev-dependencies] 下启用,例如

[package]
name = "sparkle-cache-some-backend"
[dev-dependencies]
sparkle-cache = { version = "x", features = ["tests"] }
[dependencies]
sparkle-cache = "x"

如果测试错误与此crate相关,请创建一个问题

由于 Twilight中的一个错误,目前无法缓存贴纸,因为它们无法进行测试

需要您的帮助

任何反馈或错误报告对进一步开发都非常有用,代码处于工作状态,所有基本方法都已实现,但根据您的需求,将添加许多可能的扩展功能!

依赖项

~3–14MB
~167K SLoC