mirror of
https://github.com/compiler-explorer/compiler-explorer.git
synced 2026-05-16 13:43:10 -04:00
4229733210
Add ca65 as a standalone assembler under the Assembly language, reusing the existing cc65 toolchain installations (2.17, 2.18, 2.19, trunk). ca65 generates a listing file with full macro expansion (`-x -x`) so users can debug macro output — the primary use case from the feature request. **What's included:** - `Ca65Compiler` class — runs ca65, captures the listing output - `AsmParserCa65` — parses the ca65 listing format (address, hex bytes, source) - Config for all 4 existing cc65 versions as ca65 assemblers - Include paths set to each version's `asminc` directory **How it works:** Since ca65 produces object files in cc65's custom format (not ELF), we can't objdump them. Instead, we use ca65's `-l` (listing) flag with `-x -x` (full macro expansion) and `--list-bytes 0` (unlimited hex bytes per line). The listing shows addresses, generated bytes, and expanded source — exactly what users need for macro debugging. Closes #7118 Co-authored-by: mattgodbolt-molty <mattgodbolt-molty@users.noreply.github.com>
95 lines
3.6 KiB
TypeScript
95 lines
3.6 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} 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';
|
|
import {AsmParserCa65} from '../parsers/asm-parser-ca65.js';
|
|
|
|
export class Ca65Compiler extends BaseCompiler {
|
|
static get key() {
|
|
return 'ca65';
|
|
}
|
|
|
|
constructor(compilerInfo: PreliminaryCompilerInfo, env: CompilationEnvironment) {
|
|
super(compilerInfo, env);
|
|
|
|
this.asm = new AsmParserCa65(this.compilerProps);
|
|
}
|
|
|
|
override optionsForFilter(filters: ParseFiltersAndOutputOptions) {
|
|
// ca65 listing output is always parsed as binary (address + hex + source format)
|
|
filters.binary = true;
|
|
return [];
|
|
}
|
|
|
|
override supportsObjdump() {
|
|
// ca65 output is a listing file, not a binary — objdump doesn't apply
|
|
return false;
|
|
}
|
|
|
|
override getSharedLibraryPathsAsArguments() {
|
|
return [];
|
|
}
|
|
|
|
override async runCompiler(
|
|
compiler: string,
|
|
options: string[],
|
|
inputFilename: string,
|
|
execOptions: ExecutionOptionsWithEnv,
|
|
) {
|
|
if (!execOptions) {
|
|
execOptions = this.getDefaultExecOptions();
|
|
}
|
|
|
|
const dirPath = path.dirname(inputFilename);
|
|
if (!execOptions.customCwd) {
|
|
execOptions.customCwd = dirPath;
|
|
}
|
|
|
|
const outputFilename = this.getOutputFilename(dirPath, this.outputFilebase);
|
|
|
|
// Always generate a listing with full macro expansion, writing directly to the output file
|
|
const hasListingOpt = options.some(opt => opt === '-l' || opt === '--listing');
|
|
if (!hasListingOpt) {
|
|
options = ['-l', outputFilename, '-x', '-x', '--list-bytes', '0', ...options];
|
|
}
|
|
|
|
const compilerExecResult = await this.exec(compiler, options, execOptions);
|
|
const result = this.transformToCompilationResult(compilerExecResult, inputFilename);
|
|
|
|
result.forceBinaryView = true;
|
|
|
|
return result;
|
|
}
|
|
|
|
override isCfgCompiler(): boolean {
|
|
return true;
|
|
}
|
|
}
|