Files
compiler-explorer/lib/compilation-env.ts
2025-09-08 22:07:47 +02:00

247 lines
10 KiB
TypeScript

// Copyright (c) 2016, 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 child_process from 'node:child_process';
import fs from 'node:fs/promises';
import _ from 'underscore';
import type {CacheableValue} from '../types/cache.interfaces.js';
import {CompilerOverrideOptions} from '../types/compilation/compiler-overrides.interfaces.js';
import {LanguageKey} from '../types/languages.interfaces.js';
import {unwrap} from './assert.js';
import {BaseCompiler} from './base-compiler.js';
import type {Cache} from './cache/base.interfaces.js';
import {BaseCache} from './cache/base.js';
import {createCacheFromConfig} from './cache/from-config.js';
import {S3Cache} from './cache/s3.js';
import {CompilationQueue, EnqueueOptions, Job} from './compilation-queue.js';
import {FormattingService} from './formatting-service.js';
import {logger} from './logger.js';
import type {PropertyGetter} from './properties.interfaces.js';
import {CompilerProps, PropFunc} from './properties.js';
import {createStatsNoter, IStatsNoter} from './stats.js';
type FindCompiler = (langId: LanguageKey, compilerId: string) => BaseCompiler | undefined;
export class CompilationEnvironment {
ceProps: PropertyGetter;
awsProps: PropFunc;
compilationQueue: CompilationQueue;
compilerProps: PropFunc;
okOptions: RegExp;
badOptions: RegExp;
cache: Cache;
executableCache: Cache;
compilerCache: Cache;
reportCacheEvery: number;
multiarch: string | null;
baseEnv: Record<string, string>;
possibleToolchains?: CompilerOverrideOptions;
statsNoter: IStatsNoter;
private logCompilerCacheAccesses: boolean;
private cachingInProgress: Record<string, boolean>;
private findCompilerFunc?: FindCompiler;
constructor(
compilerProps: CompilerProps,
awsProps: PropFunc,
compilationQueue: CompilationQueue,
public formattingService: FormattingService,
doCache?: boolean,
) {
this.ceProps = compilerProps.ceProps;
this.awsProps = awsProps;
this.compilationQueue = compilationQueue;
this.compilerProps = compilerProps.get.bind(compilerProps);
// So people running local instances don't break suddenly when updating
const deprecatedAllowed = this.ceProps('optionsWhitelistRe', '.*');
const deprecatedForbidden = this.ceProps('optionsBlacklistRe', '(?!)');
this.okOptions = new RegExp(this.ceProps('optionsAllowedRe', deprecatedAllowed));
this.badOptions = new RegExp(this.ceProps('optionsForbiddenRe', deprecatedForbidden));
this.cache = createCacheFromConfig(
'default',
doCache === undefined || doCache ? this.ceProps('cacheConfig', '') : '',
);
this.executableCache = createCacheFromConfig(
'executable',
doCache === undefined || doCache ? this.ceProps('executableCacheConfig', '') : '',
);
this.compilerCache = createCacheFromConfig(
'compiler',
doCache === undefined || doCache ? this.ceProps('compilerCacheConfig', '') : '',
);
this.cachingInProgress = {};
this.reportCacheEvery = this.ceProps('cacheReportEvery', 100);
this.multiarch = null;
try {
const multi = child_process.execSync('gcc -print-multiarch').toString().trim();
if (multi) {
logger.info(`Multiarch: ${multi}`);
this.multiarch = multi;
} else {
logger.info('No multiarch');
}
} catch (err) {
logger.warn(`Unable to get multiarch: ${err}`);
}
this.baseEnv = {};
const envs = this.ceProps('environmentPassThrough', 'LD_LIBRARY_PATH,PATH,HOME').split(',');
_.each(envs, environmentVariable => {
if (environmentVariable === '') return;
this.baseEnv[environmentVariable] = process.env[environmentVariable] ?? '';
});
this.logCompilerCacheAccesses = this.ceProps('logCompilerCacheAccesses', false);
this.statsNoter = createStatsNoter(this.ceProps);
}
getEnv(needsMulti: boolean) {
const env = {...this.baseEnv};
if (needsMulti && this.multiarch) {
env.LIBRARY_PATH = '/usr/lib/' + this.multiarch;
env.C_INCLUDE_PATH = '/usr/include/' + this.multiarch;
env.CPLUS_INCLUDE_PATH = '/usr/include/' + this.multiarch;
}
return env;
}
setPossibleToolchains(toolchains: CompilerOverrideOptions) {
this.possibleToolchains = toolchains;
}
getPossibleToolchains(): CompilerOverrideOptions {
return this.possibleToolchains || [];
}
async cacheGet(object: CacheableValue) {
const result = await this.cache.get(BaseCache.hash(object));
if (this.cache.gets % this.reportCacheEvery === 0) {
this.cache.report();
}
if (!result.hit) return null;
return JSON.parse(unwrap(result.data).toString());
}
async cachePut(object: CacheableValue, result: object, creator: string | undefined) {
const key = BaseCache.hash(object);
return this.cache.put(key, JSON.stringify(result), creator);
}
async compilerCacheGet(object: CacheableValue) {
const key = BaseCache.hash(object);
const result = await this.compilerCache.get(key);
if (this.logCompilerCacheAccesses) {
logger.info(`hash ${key} (${object?.['compiler'] || '???'}) ${result.hit ? 'hit' : 'miss'}`);
logger.debug(`Cache get ${JSON.stringify(object)}`);
}
if (!result.hit) return null;
return JSON.parse(unwrap(result.data).toString());
}
async compilerCachePut(object: CacheableValue, result: object, creator: string | undefined) {
const key = BaseCache.hash(object);
if (this.logCompilerCacheAccesses) {
logger.info(`Cache put ${JSON.stringify(object)} hash ${key}`);
}
return this.compilerCache.put(key, JSON.stringify(result), creator);
}
async cachePutWithTTL(object: CacheableValue, result: object, ttlDays: number, creator: string | undefined) {
const key = BaseCache.hash(object);
const jsonData = JSON.stringify(result);
// Check if cache is S3Cache to use TTL functionality
if (this.cache instanceof S3Cache) {
return this.cache.putWithTTL(key, Buffer.from(jsonData), ttlDays, creator);
} else {
// Fallback to regular put for non-S3 caches
return this.cache.put(key, jsonData, creator);
}
}
async tempCachePutWithTTL(object: CacheableValue, result: object, ttlDays: number, creator: string | undefined) {
const key = BaseCache.hash(object);
const jsonData = JSON.stringify(result);
// Check if cache is S3Cache to use TTL functionality with temp path
if (this.cache instanceof S3Cache) {
return this.cache.putWithTTLAndPath(key, Buffer.from(jsonData), ttlDays, 'temp', creator);
} else {
// Fallback to regular put for non-S3 caches
return this.cache.put(key, jsonData, creator);
}
}
getExecutableHash(object: CacheableValue): string {
return BaseCache.hash(object) + '_exec';
}
async executableGet(key: string, destinationFolder: string): Promise<string | null> {
const result = await this.executableCache.get(key);
if (!result.hit) return null;
const filepath = destinationFolder + '/' + key;
await fs.writeFile(filepath, unwrap(result.data));
return filepath;
}
async executablePut(key: string, filepath: string): Promise<void> {
await this.executableCache.put(key, await fs.readFile(filepath));
}
setCachingInProgress(key: string) {
this.cachingInProgress[key] = true;
}
clearCachingInProgress(key: string) {
delete this.cachingInProgress[key];
}
willBeInCacheSoon(key: string): boolean {
return this.cachingInProgress[key] || false;
}
enqueue<T>(job: Job<T>, options?: EnqueueOptions) {
if (this.compilationQueue) return this.compilationQueue.enqueue(job, options);
}
findBadOptions(options: string[]) {
return options.filter(option => !this.okOptions.test(option) || this.badOptions.test(option));
}
getCompilerPropsForLanguage(languageId: string): PropFunc {
return _.partial(this.compilerProps as any, languageId);
}
setCompilerFinder(compilerFinder: FindCompiler) {
this.findCompilerFunc = compilerFinder;
}
findCompiler(langId: LanguageKey, compilerId: string): BaseCompiler | undefined {
if (!this.findCompilerFunc) throw new Error('Compiler finder not set');
return this.findCompilerFunc(langId, compilerId);
}
}