Files
Matt Godbolt (bot acct) 164d33bb42 Add TinyGo compiler support (#8456)
Adds support for [TinyGo](https://tinygo.org/), an LLVM-based Go
compiler targeting microcontrollers and WebAssembly.

## Changes

- **New `TinyGoCompiler` class** (`lib/compilers/tinygo.ts`): Extends
BaseCompiler with TinyGo-specific handling:
- Forces binary mode (TinyGo has no `-gcflags=-S` equivalent — it's
LLVM-based, not gc)
  - Sets up `TINYGOROOT`, `GOROOT`, and `PATH` environment variables
  - Uses `tinygo build -o <output>` as the compilation command
- User arguments (e.g. `-opt=2`, `-gc=none`, `-scheduler=none`) pass
through directly
- **Config**: Adds TinyGo 0.37.0 to `go.amazon.properties`
- **Registration**: Exports `TinyGoCompiler` from `_all.ts`

## Why TinyGo?

TinyGo produces significantly smaller binaries than standard Go (445KB
vs 1.5MB for a hello world). It targets a different niche —
microcontrollers, WASM, and resource-constrained environments — making
it an interesting comparison alongside the existing gc and gccgo
compilers.

## Testing

Tested locally with CE running on a non-default port:
-  Compiler detected and version parsed correctly
-  Compilation produces x86 assembly via objdump (5000+ lines for a
simple program)
-  Execution works (`println` output captured correctly)
-  User arguments like `-opt=2` pass through correctly
-  All pre-commit checks pass (ts-check, lint, properties validation,
related tests)

## Infra

TinyGo 0.37.0 is already configured in the infra repo
(`bin/yaml/go.yaml`) — installation is just a tarball download from
GitHub releases.

The config references `/opt/compiler-explorer/golang-1.24.2/go` as
GOROOT — TinyGo needs a standard Go installation for the stdlib.

Closes #3969

🤖 Generated by LLM (Claude, via OpenClaw)

---------

Co-authored-by: mattgodbolt-molty <mattgodbolt-molty@users.noreply.github.com>
2026-02-08 15:02:47 -06:00

89 lines
3.5 KiB
TypeScript

// Copyright (c) 2026, Compiler Explorer Authors
// All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are met:
//
// * Redistributions of source code must retain the above copyright notice,
// this list of conditions and the following disclaimer.
// * Redistributions in binary form must reproduce the above copyright
// notice, this list of conditions and the following disclaimer in the
// documentation and/or other materials provided with the distribution.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
// ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
// LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
// POSSIBILITY OF SUCH DAMAGE.
import path from 'node:path';
import type {ExecutionOptionsWithEnv, FiledataPair} from '../../types/compilation/compilation.interfaces.js';
import type {PreliminaryCompilerInfo} from '../../types/compiler.interfaces.js';
import type {ParseFiltersAndOutputOptions} from '../../types/features/filters.interfaces.js';
import {BaseCompiler} from '../base-compiler.js';
import {CompilationEnvironment} from '../compilation-env.js';
export class TinyGoCompiler extends BaseCompiler {
private readonly tinygoRoot: string;
private readonly goRoot: string | undefined;
static get key() {
return 'tinygo';
}
constructor(compilerInfo: PreliminaryCompilerInfo, env: CompilationEnvironment) {
super(compilerInfo, env);
this.tinygoRoot = path.dirname(path.dirname(compilerInfo.exe));
const group = this.compiler.group;
this.goRoot = this.compilerProps<string | undefined>(
'goroot',
this.compilerProps<string | undefined>(`group.${group}.goroot`),
);
}
override getSharedLibraryPathsAsArguments() {
return [];
}
override optionsForFilter(filters: ParseFiltersAndOutputOptions, outputFilename: string) {
return ['build', '-o', outputFilename];
}
override getDefaultExecOptions(): ExecutionOptionsWithEnv {
const options = super.getDefaultExecOptions();
options.env = {
...options.env,
TINYGOROOT: this.tinygoRoot,
};
if (this.goRoot) {
options.env.GOROOT = this.goRoot;
const goBin = path.join(this.goRoot, 'bin');
options.env.PATH = options.env.PATH ? `${goBin}:${options.env.PATH}` : goBin;
}
return options;
}
override fixFiltersBeforeCacheKey(filters: ParseFiltersAndOutputOptions, options: string[], files: FiledataPair[]) {
// TinyGo is LLVM-based and always produces a binary — force binary mode
// to avoid the base compiler adding -S (which TinyGo doesn't understand).
filters.binary = true;
super.fixFiltersBeforeCacheKey(filters, options, files);
}
override isCfgCompiler() {
return true;
}
}