示例程序
做完入门教程以后,可以看看这些更完整的程序。它们都放在仓库的 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 或者生产环境的负载都能支持。
