Files
compiler-explorer/test/execution-triple-tests.ts
Matt Godbolt (bot acct) 3d5a62fe6b Re-add CI check enforcing license header banners (#8883)
## What & why

We used to enforce the BSD-2-Clause license banner on every source file
via `eslint-plugin-header`. That check was lost when we migrated from
ESLint to Biome (#7033), which has no equivalent rule. This PR
reinstates it as a standalone node script, modelled on the existing
`etc/scripts/check-frontend-imports.js`.

### Why a script rather than a Biome rule
Biome 2.x has no built-in license/header rule and no plugin equivalent
to `eslint-plugin-header`; its experimental GritQL plugins aren't suited
to whole-file-prefix matching. A script needs zero new dependencies and
gives full control over scope and exemptions.

## The check (`etc/scripts/check-license-headers.js`)

A file "has an appropriate banner" if, ignoring an optional shebang, it
opens with a `// Copyright (c) …` line **and** contains the BSD-2-Clause
disclaimer body. The year and copyright holder are intentionally **not**
constrained — the tree legitimately has many holders (Compiler Explorer
Authors, Arm, Microsoft, HRT, individuals). The `(c)`/`(C)` marker is
matched case-insensitively.

**Scope:** `.ts/.js/.mjs/.cjs` under `lib/ static/ shared/ types/ test/
cypress/`.

**Exempt:** generated files (`lib/asm-docs/generated`), vendored
(`docenizer/vendor`), `.d.ts`, and three third-party ports that carry
their own upstream license — `static/ansi-to-html.ts` (MIT),
`lib/node-graceful.ts` (MIT), `shared/rison.ts` (Nanonid/rison port).

**Wired into:** CI (`test-and-deploy.yml`), `npm run check`, the `make
pre-commit` target, the husky pre-commit hook, and `lint-staged` (per
staged file).

Usage:
```
node ./etc/scripts/check-license-headers.js            # scan the tracked tree
node ./etc/scripts/check-license-headers.js <files...> # scan specific files (lint-staged)
```

## Backfill

The check surfaced **42 CE-authored files** missing the banner. This PR
backfills them all with the standard `Copyright (c) <year>, Compiler
Explorer Authors` banner, using each file's **git creation year**
(added-at-this-path, so no `--follow` rename artifacts).

## Verification

- `check-license-headers` → clean (was 42 failures)
- `biome check` on all source → no fixes needed (banner format matches
existing convention)
- `tsc` backend + frontend + tests → clean
- pre-commit gauntlet (lint, ts-check, related tests: 528 passed) ran on
commit

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: mattgodbolt-molty <mattgodbolt-molty@users.noreply.github.com>
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-02 19:13:21 +01:00

110 lines
5.5 KiB
TypeScript

// Copyright (c) 2024, 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 {describe, expect, it} from 'vitest';
import {BinaryInfoLinux} from '../lib/binaries/binary-utils.js';
import {BaseExecutionTriple, ExecutionSpecialty} from '../lib/execution/base-execution-triple.js';
import {getExecutionTriplesForCurrentHost, matchesCurrentHost} from '../lib/execution/execution-triple.js';
describe('Execution triple utils', () => {
it('default always matches', () => {
const triples: BaseExecutionTriple[] = getExecutionTriplesForCurrentHost();
expect(matchesCurrentHost(triples[0])).toEqual(true);
});
it('can parse a thing', () => {
const triple = new BaseExecutionTriple();
triple.parse('aarch64-linux-cpu');
expect(triple.instructionSet).toEqual('aarch64');
expect(triple.os).toEqual('linux');
expect(triple.specialty).toEqual(ExecutionSpecialty.cpu);
});
it('would parse nvgpu', () => {
const triple = new BaseExecutionTriple();
triple.parse('amd64-linux-nvgpu');
expect(triple.instructionSet).toEqual('amd64');
expect(triple.os).toEqual('linux');
expect(triple.specialty).toEqual(ExecutionSpecialty.nvgpu);
});
it('recognizes aarch64', () => {
const info = BinaryInfoLinux.parseFileInfo(
'ELF 64-bit LSB pie executable, ARM aarch64, version 1 (SYSV), dynamically linked, interpreter /lib/ld-linux-aarch64.so.1, for GNU/Linux 5.17.0, with debug_info, not stripped',
);
expect(info?.instructionSet).toEqual('aarch64');
expect(info?.os).toEqual('linux');
});
it('recognizes arm32', () => {
const info = BinaryInfoLinux.parseFileInfo(
'ELF 32-bit LSB executable, ARM, EABI5 version 1 (GNU/Linux), dynamically linked, interpreter /lib/ld-linux-armhf.so.3, for GNU/Linux 4.4.255, with debug_info, not stripped',
);
expect(info?.instructionSet).toEqual('arm32');
expect(info?.os).toEqual('linux');
});
it('recognizes lin64', () => {
const info = BinaryInfoLinux.parseFileInfo(
'ELF 64-bit LSB executable, x86-64, version 1 (GNU/Linux), dynamically linked, interpreter /lib64/ld-linux-x86-64.so.2, BuildID[sha1]=9def7a0f68cf33177d0d8566b152af24d9ec1ac4, for GNU/Linux 3.2.0, stripped',
);
expect(info?.instructionSet).toEqual('amd64');
expect(info?.os).toEqual('linux');
});
it('recognizes win64', () => {
const info = BinaryInfoLinux.parseFileInfo(
'PE32+ executable (DLL) (console) x86-64 (stripped to external PDB), for MS Windows, 12 sections',
);
expect(info?.instructionSet).toEqual('amd64');
expect(info?.os).toEqual('win32');
});
it('recognizes win alternatives', () => {
const filteredLine = BinaryInfoLinux.removeComments(
'PE32+ executable (DLL) (console) Aarch64 (stripped to external PDB)',
);
expect(filteredLine).toEqual('PE32+ executable Aarch64');
const info = BinaryInfoLinux.parseFileInfo(
'PE32+ executable (DLL) (console) Aarch64 (stripped to external PDB), for MS Windows, 12 sections',
);
expect(info?.instructionSet).toEqual('aarch64');
expect(info?.os).toEqual('win32');
});
it('recognizes win32', () => {
const info = BinaryInfoLinux.parseFileInfo('PE32 executable (GUI) Intel 80386, for MS Windows, 4 sections');
expect(info?.instructionSet).toEqual('x86');
expect(info?.os).toEqual('win32');
});
it('recognizes avr', () => {
const info = BinaryInfoLinux.parseFileInfo(
'ELF 32-bit LSB executable, Atmel AVR 8-bit, version 1 (SYSV), statically linked, with debug_info, not stripped',
);
expect(info?.instructionSet).toEqual('avr');
expect(info?.os).toEqual('linux');
});
it('recognizes 32-bit Intel for file >= v5.46', () => {
const info = BinaryInfoLinux.parseFileInfo(
'ELF 32-bit LSB executable, Intel i386, version 1 (SYSV), dynamically linked, interpreter /lib/ld-linux.so.2, BuildID[sha1]=936152b4351a49d381553a593f68286e1069435f, for GNU/Linux 4.4.0, not stripped',
);
expect(info?.instructionSet).toEqual('x86');
expect(info?.os).toEqual('linux');
});
});