Documentation
¶
Overview ¶
Package lang runs the native tests of the implementations (spec 09.9).
Each language has a recipe. A recipe copies the files of one implementation to a new temporary directory, writes the build files that the language needs, and runs the test command there. The recipe does not change the content tree.
The tests run code from the content repository. Run them only in a sandbox, such as a CI runner or a container. The CLI asks for -unsafe-local outside CI.
Index ¶
- Constants
- Variables
- func WriteScript(path string, cmds [][]string) error
- type Adapter
- type Recipe
- type Runner
- func (r *Runner) Gen(dir string, n *node.Node, im node.Impl) (Tree, error)
- func (r *Runner) GenAdapter(dir string, n *node.Node, im node.Impl, k *contract.Contract) (Adapter, error)
- func (r *Runner) Shared(n *node.Node, im node.Impl, k *contract.Contract, cases []contract.Case) status.Shared
- func (r *Runner) Test(n *node.Node, im node.Impl) status.Test
- type Skip
- type Tree
Constants ¶
const JUnitVersion = "1.13.4"
JUnitVersion is the version of the JUnit console launcher for Java and Kotlin.
Variables ¶
var ( // HelloTimeout is the longest time that an adapter can take to start. The JVM and .NET start slowly. HelloTimeout = 60 * time.Second // CaseTimeout is the longest time of one shared case. CaseTimeout = 10 * time.Second )
var Recipes = map[string]Recipe{ "python": {ID: "python", Tools: []string{"python3"}, Version: []string{"python3", "--version"}, Run: python}, "go": {ID: "go", Tools: []string{"go"}, Version: []string{"go", "version"}, Run: golang}, "rust": {ID: "rust", Tools: []string{"cargo"}, Version: []string{"rustc", "--version"}, Run: rust}, "c": {ID: "c", Tools: []string{"cc"}, Version: []string{"cc", "--version"}, Run: clang}, "cpp": {ID: "cpp", Tools: []string{"c++"}, Version: []string{"c++", "--version"}, Run: cpp}, "javascript": {ID: "javascript", Tools: []string{"node"}, Version: []string{"node", "--version"}, Run: javascript}, "typescript": {ID: "typescript", Tools: []string{"node"}, Version: []string{"node", "--version"}, Run: typescript}, "java": {ID: "java", Tools: []string{"javac", "java"}, Version: []string{"javac", "-version"}, Run: java}, "kotlin": {ID: "kotlin", Tools: []string{"kotlinc", "java"}, Version: []string{"kotlinc", "-version"}, Run: kotlin}, "csharp": {ID: "csharp", Tools: []string{"dotnet"}, Version: []string{"dotnet", "--version"}, Run: csharp}, }
Recipes are the tier 1 languages (spec 08.2).
var Timeout = 3 * time.Minute
Timeout is the longest time that the tests of one implementation can take.
Functions ¶
func WriteScript ¶ added in v0.1.3
WriteScript writes a POSIX shell script that runs the commands in order, so that a runner image can run a tree without algo.
Types ¶
type Adapter ¶ added in v0.1.3
type Adapter struct {
Dir string
Build [][]string
Run []string
// Types are the types of T that the adapter has.
Types []string
}
Adapter is the generated adapter of one implementation for one problem (spec 09.2).
type Recipe ¶
type Recipe struct {
ID string
// Tools are the commands that the recipe needs. If one is missing, the language is skipped.
Tools []string
// Version prints the version of the toolchain.
Version []string
// Run prepares dir, which holds a copy of the files, and returns the commands to run in it.
Run func(r *Runner, dir string, n *node.Node, im node.Impl) ([][]string, error)
}
Recipe runs the tests of one language.
func (Recipe) ToolVersion ¶
ToolVersion returns the first line of the version output of the toolchain.
type Runner ¶
type Runner struct {
// Cache holds the downloaded jars. The default is the user cache directory.
Cache string
// Log gets one line for each implementation.
Log func(format string, args ...any)
// Keep keeps the temporary directories, for debugging.
Keep bool
}
Runner runs tests and keeps the results.
func (*Runner) Gen ¶ added in v0.1.3
Gen writes the build tree of one implementation to dir: a copy of the files with the tests, and the build files of the language. It never writes to the content tree.
func (*Runner) GenAdapter ¶ added in v0.1.3
func (r *Runner) GenAdapter(dir string, n *node.Node, im node.Impl, k *contract.Contract) (Adapter, error)
GenAdapter writes the adapter of the contract k for one implementation to dir. It does not build it. A language without generics gets the int variant only. `algo test` also drops T = string when the entry does not build with it.
func (*Runner) Shared ¶ added in v0.1.2
func (r *Runner) Shared(n *node.Node, im node.Impl, k *contract.Contract, cases []contract.Case) status.Shared
Shared runs the shared cases of the contract k on one implementation (spec 09.2). It builds the adapter in a new temporary directory, starts it once and sends the cases in order. A crash fails the case, and the next case gets a new adapter.
type Skip ¶
type Skip struct{ Lang, Tool string }
Skip is the error of a language whose tools are missing.
type Tree ¶ added in v0.1.3
type Tree struct {
Dir string
// Test are the commands that build the implementation and run its native tests. They run in Dir.
Test [][]string
// Sources maps each copied file, relative to Dir, to its path in the content repository.
Sources map[string]string
}
Tree is the generated build tree of one implementation (spec 08.5).