Language support
flowchart TD
P["Your project"] --> Q{"Python?"}
Q -->|"yes"| Y["pytest, Python stubs, adapter.py, probe_run"]
Q -->|"no"| N["Detected test command, stub lines, seam file, no probe_run"]
What changes by language
Section titled “What changes by language”| Part | Python project | Other language |
|---|---|---|
| Test command | .superlite/test-cmd.json, else detection |
Same; detection covers npm, go, cargo, dotnet |
probe_run |
Runs | Python only |
plan_tools stubs |
Writes Python stubs | One stub: line per Produces signature and a contract: line, no .py file |
plan_tools adapter |
Writes .superlite/probes/adapter.py |
Writes seam.ts, seam.js, seam.go, seam.rs, seam.cs, seam.java, seam.rb or seam.txt |
superlite needs Python 3.12 or newer, git and bash (Git Bash on Windows). uv is optional.
Example: a Go service
Section titled “Example: a Go service”Say you build a Go service, so your project has a go.mod and no Python.
-
You ask for a feature as usual. superlite finds
go.modand takesgo test ./...as the test command, so you set nothing.The detection covers npm, go, cargo and dotnet projects. Background test runs and the hang probe work the same in every language.
-
The plan lists what each task produces, as signatures.
plan_tools stubsprints onestub:line for each, plus acontract:line, and writes no.pyfile.A Go project cannot use Python stubs, so the tasks get the signatures as text to build against.
-
For the review seam,
plan_tools adapterwrites a Go file:Directory.superlite/
Directoryprobes/
- seam.go the review seam
.superlite/probes/seam.go // superlite seam: goThe seam is where a reviewer checks that the tasks fit together. The Python version is
adapter.py. Other languages get a seam file in their own extension. -
probe_run, the parallel robustness probes, does not run, because it is Python only. Your reviews still run. -
You decide: if
go test ./...is not what you want, write another command to.superlite/test-cmd.jsonand superlite uses that instead..superlite/test-cmd.json {"language": "go","test": "go test ./internal/..."}superlite reads this file before it tries detection.
What you end up with: a build that works in Go with the right test command, signature stubs and a review seam, and without the Python-only probes.