feat: static generated library

.gitignore

@@ -1,2 +1,2 @@
-vendor
 jsonnetfile.lock.json
+vendor

Makefile

@@ -1,3 +1,34 @@
-generate:
-	jsonnet -m gen -S -J vendor main.libsonnet | xargs -n 1 -- jsonnetfmt --no-use-implicit-plus -i
-
+JSONNET_BIN ?= jsonnet
+
+jsonnetfile.json:
+	jb init
+
+vendor jsonnetfile.lock.json: jsonnetfile.json
+	jb install
+
+.PHONY: test
+test: vendor jsonnetfile.lock.json
+	@cd test/ && make test
+
+.PHONY: fmt
+fmt:
+	@find . \
+		-path './.git' -prune \
+		-o -name 'vendor' -prune \
+		-o -name '*.libsonnet' -print \
+		-o -name '*.jsonnet' -print \
+		| xargs -n 1 -- jsonnetfmt --no-use-implicit-plus -i
+
+.PHONY: docs
+docs: jsonnetfile.json
+	@rm -rf docs/
+	@jb install github.com/jsonnet-libs/docsonnet/doc-util
+	@$(JSONNET_BIN) \
+		-J vendor \
+		-J lib \
+		-S -c -m docs \
+		-e '(import "github.com/jsonnet-libs/docsonnet/doc-util/main.libsonnet").render(import "main.libsonnet")'
+
+.PHONY: generate
+generate: jsonnetfile.json
+	jsonnet -J generator/vendor -S generator/generate.jsonnet | jsonnetfmt - > raw.libsonnet

docs/README.md

@@ -1,6 +1,35 @@
 # github-actions-libsonnet
 
-Jsonnet library for github-actions-libsonnet
+Jsonnet library to create GitHub actions workflows.
+## Install
 
-> [!CAUTION]
-> Incomplete library, very experimental
+```
+jb install github.com/crdsonnet/github-actions-libsonnet@main
+```
+
+## Usage
+
+```jsonnet
+local ga = import 'github.com/crdsonnet/github-actions-libsonnet/main.libsonnet';
+
+local exampleWorkflow =
+  ga.workflow.withName('example workflow')
+  + ga.workflow.on.pull_request.withBranches(['main'])
+  + ga.workflow.withJobs({
+    example:
+      ga.job.withRunsOn('ubuntu-latest')
+      + ga.job.withSteps(
+        ga.job.step.withName('Checkout')
+        + ga.job.step.withUses('actions/checkout@v4')
+      ),
+  });
+
+std.manifestYamlDoc(exampleWorkflow, indent_array_in_object=true, quote_keys=false)
+
+```
+
+
+## Subpackages
+
+* [job](job/index.md)
+* [workflow](workflow.md)