#table #fixtures #loader #sqlite #egui #world #server

bin+lib world-tables-data

为 world-tables 提供固定加载器

1 个不稳定版本

0.1.0 2023年2月18日

#2668数据库接口


world-tables-server 使用

MIT/Apache

3.5MB
1.5K SLoC

世界表格

这是一个实验,使用 Axum 构建的 API 实现 Egui 接口,使它们像一个单一应用程序一样一起工作。尽管目前仅限于单用户使用,但这个项目是在考虑未来的多用户应用的情况下制作的。

屏幕截图

Main windows

Misc windows

备注

  • 迄今为止,仅在 Linux 上进行了测试。

  • 我不想让 Egui 应用在发送请求和等待 API 时阻塞,但我看不到使用 tokio 的理由,因为在这种情况下,你无论如何都受限于用户的按钮点击速度。我只是使用普通的 std::thread 创建处理请求的线程,并通过通道将它们与主线程通信。

  • 由于我使用了线程,我不知道该应用是否在 wasm 上运行。它可能只是使用 wasm_threadreqwasm 运行。

  • 使用 Sqlite 与 rust (rusqlite) 和使用多线程或异步编程的最佳方法似乎在人们之间存在争议,没有明确的共识或关于最佳方法的文档。我决定只使用 r2d2 的池管理器,但在这次测试中,我还没有正确使用 tokio::spawn_blocking。因此,API 的异步处理程序中的数据库调用仍然会阻塞,但这对这个应用来说不是什么大问题。

  • 我不想使用复杂的 ORM 设置来配置数据库,这样我就可以更多地控制查询并在以后进行实验。相反,我创建了一系列简单的辅助特质,以便仍然像使用 ORM 一样组织代码,并将它们分割到 dbent 库中。

使用方法

此项目使用 cargo-make 进行构建和运行。要安装 cargo-make,请运行以下命令

cargo install cargo-make

安装完成后,您可以通过运行以下命令构建服务器和其他所有组件

cargo make server

请注意,这不仅会构建组件,如果成功,还应该运行带图形用户界面的服务器。第一次运行服务器时,SQLite数据库将在用户目录中创建,可能需要一些时间才能完成。

资源

许可证

根据您的选择,许可协议为Apache许可证,版本2.0MIT许可证

除非您明确表示,否则您提交给World-Tables的任何贡献,根据Apache-2.0许可证定义,将按上述方式双许可,不附加任何额外条款或条件。

依赖项

~31MB
~592K SLoC