Skip to content

示例程序 ​

做完入门教程以后,可以看看这些更完整的程序。它们都放在仓库的 examples/ 目录里,每个目录的 README 都写了怎么运行、用到了哪些依赖,以及还有哪些限制。

先从本地小工具看起 ​

  • Task Tracker:命令行任务清单,数据存在本地的 JSON 文件里。演示文件读写、带类型的数据模型,以及用 @std/json_codec 读取 JSON 字段,不需要联网。
  • json_select:从 JSON 里挑选字段的命令行工具,由多个文件组成,用 sprig-cli 库解析命令行选项。
  • tasks:带子命令的命令行待办清单,数据存在 JSON 文件里(sprig-cli、@std/json_codec)。
  • csv:用 sprig-csv 写出再读回一个 UTF-8 的 CSV 文件,单元格里有逗号、换行和非 ASCII 文字,按表头读取各列。这个库从 v0.9.0-beta.1 起随 SDK 提供。
  • config_summary:读取一个小的 JSON 配置文件,输出格式固定的摘要;输入有误时会给出清楚的错误信息。
  • blog:静态博客生成器,把带 front matter 的文章生成 HTML 页面和索引,输入有误时返回对应的退出码(@std/files、@std/text、@std/lists)。
  • agent_tools:三个用 Sprig 写的小工具,读取编译器输出的 JSON,用来查询 Java 和 Sprig API、汇总错误信息、比较 API 的差异。

用到 Java 库的应用 ​

  • application_foundation:HTTP、JSON 编解码、UTC 时间和文件处理。
  • sqlite 和 sqlite_migrations:通过 Maven 使用 JDBC,演示事务、数据持久化和数据库迁移。
  • parallel_words:用 @std/concurrent 并行统计词数,作用域、任务、线程池、通道、计数器和锁各用一次,见并发。
  • crawler:在本地页面上并发抓取,用到作用域、任务、通道、计数器和锁(@std/concurrent)。
  • ledger:精简的记账 HTTP 后端,重启后数据还在。详见 Web 与 SQLite。
  • todo:数据存在 SQLite 里、通过小型 HTTP 接口访问的待办清单(sprig-sqlite、sprig-web);它的测试通过 HTTP 驱动真正运行的服务。
  • mini_web:带类型的路由、JSON 和 OpenAPI 文档。

第三方 Java 库照常用 Maven 坐标加进项目,由锁文件固定版本,见项目和 JVM 互操作。Sprig 自己维护的库都在 libraries/ 目录里。

更大一些的程序 ​

  • repository_audit:遍历一个代码仓库,生成 JSON 报告。
  • maven_slug:锁定一个 Maven 库,查询它的 API,离线时复用缓存。
  • source_analyzer:用 Sprig 写的源码分析工具,遍历语法树,列出函数、变量和引用。它只覆盖语言的一部分,不是完整的编译器 API。
  • test_runner:在普通的 Sprig 项目里写各种测试,包括运行时测试、表格式测试、临时文件、子进程,以及预期会编译失败的测试。

另外,Fabric 模组是一个单独的案例:在 Minecraft 模组里用 Sprig 写逻辑,Gradle 和 Loom 负责构建,Java 那边只保留很薄的一层接口。

这些示例只覆盖了测试过的场景,不代表所有库 API 或者生产环境的负载都能支持。

Last updated:

Sprig 采用 Apache-2.0 许可证 · v0.7.1-beta.1 已作为 prerelease 发布