mirror of
https://github.com/compiler-explorer/compiler-explorer.git
synced 2026-09-10 15:47:42 -04:00
## 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>
110 lines
5.5 KiB
TypeScript
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');
|
|
});
|
|
});
|