wishforge-ide/apps/ide/scripts/download-python-debugger.mjs
eust-w 0ef99b1e6d style: add Prettier and EditorConfig, format the codebase
Adds prettier 3.9.8 (exact) with a shared config (single quotes,
120 columns, trailing commas), .prettierignore, .editorconfig and the
`format` / `format:check` scripts, then formats all TypeScript,
JavaScript, CSS, JSON and YAML sources.

Purely mechanical: no behaviour change. Typecheck passes, the vitest
suite and the 74 IDE node tests produce the same results as before
(socket-binding tests still cannot run inside this sandbox).
Previously the longest source line was ~3000 characters; reviewing the
following semantic changes now produces readable diffs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 13:32:43 +08:00

181 lines
6.5 KiB
JavaScript

import { createHash, randomUUID } from 'node:crypto';
import { execFile } from 'node:child_process';
import { readFile, writeFile, mkdir, rename, rm, stat } from 'node:fs/promises';
import { dirname, join } from 'node:path';
import { fileURLToPath, pathToFileURL } from 'node:url';
import { promisify } from 'node:util';
const lock = JSON.parse(await readFile(new URL('./python-debugger.lock.json', import.meta.url), 'utf8'));
const maxBytes = 64 * 1024 * 1024;
const sha256 = bytes => createHash('sha256').update(bytes).digest('hex');
const run = promisify(execFile);
export async function installPythonDebugger({
platform = `${process.platform}-${process.arch}`,
archive,
pythonArchive,
pyrightArchive,
directory = fileURLToPath(new URL('../plugins/', import.meta.url)),
fetcher = fetch,
} = {}) {
const expected = lock.platforms[platform];
if (!expected) throw new Error(`Python debugger package is not pinned for ${platform}`);
const filename = `${lock.id}-${lock.version}@${platform}.vsix`;
const dependency = lock.pythonDependency;
const python = await installArchive({
expected: dependency.sha256,
filename: `${dependency.id}-${dependency.version}.vsix`,
id: dependency.id,
version: dependency.version,
url: dependency.url,
archive: pythonArchive,
directory,
fetcher,
});
const debuggerExtension = await installArchive({
expected,
filename,
archive,
directory,
fetcher,
id: lock.id,
version: lock.version,
url: `https://open-vsx.org/api/ms-python/debugpy/${platform}/${lock.version}/file/${filename}`,
});
const languageServer = await installArchive({
expected: lock.languageServer.sha256,
filename: `${lock.languageServer.id}-${lock.languageServer.version}.vsix`,
id: lock.languageServer.id,
version: lock.languageServer.version,
url: lock.languageServer.url,
archive: pyrightArchive,
directory,
fetcher,
});
return { version: lock.version, platform, python, debugger: debuggerExtension, languageServer };
}
async function installArchive({ expected, filename, url, archive, directory, fetcher, id, version }) {
const target = join(directory, '.downloads', filename);
let bytes;
let cached = false;
if (!archive) {
try {
bytes = await readFile(target);
if (sha256(bytes) !== expected) throw new Error(`Cached Python debugger checksum mismatch: ${target}`);
cached = true;
} catch (error) {
if (error.code !== 'ENOENT') throw error;
}
}
if (archive) {
if ((await stat(archive)).size > maxBytes) throw new Error('Python debugger archive exceeds 64 MiB');
bytes = await readFile(archive);
} else if (!cached) {
const response = await fetcher(url, { signal: AbortSignal.timeout(120_000) });
if (!response.ok || !response.body) throw new Error(`Python debugger download failed: HTTP ${response.status}`);
if (Number(response.headers.get('content-length')) > maxBytes)
throw new Error('Python debugger archive exceeds 64 MiB');
const chunks = [];
let size = 0;
for await (const chunk of response.body) {
size += chunk.length;
if (size > maxBytes) throw new Error('Python debugger archive exceeds 64 MiB');
chunks.push(chunk);
}
bytes = Buffer.concat(chunks);
}
if (sha256(bytes) !== expected) throw new Error('Python debugger checksum mismatch; nothing was installed');
await mkdir(dirname(target), { recursive: true });
const temporary = `${target}.${randomUUID()}.partial`;
try {
await writeFile(temporary, bytes, { flag: 'wx', mode: 0o644 });
await rename(temporary, target);
} finally {
await rm(temporary, { force: true });
}
// Theia's local-dir resolver requires unpacked system plugins. Keep VSIX files
// in its explicitly ignored dot-directory and verify before every extraction.
const unpacked = join(directory, `.${id}-${randomUUID()}`);
const plugin = join(directory, id);
const previous = `${unpacked}-previous`;
let moved = false;
try {
await run(
'python3',
[
'-c',
`
import json,os,pathlib,stat,sys,zipfile
archive,target,expected_id,expected_version=sys.argv[1:]
with zipfile.ZipFile(archive) as z:
entries=z.infolist()
if len(entries)>100000 or sum(i.file_size for i in entries)>268435456: raise ValueError('Plugin extraction size limit')
for item in entries:
p=pathlib.PurePosixPath(item.filename)
if p.is_absolute() or '..' in p.parts or '\\\\' in item.filename or stat.S_ISLNK(item.external_attr>>16): raise ValueError('Unsafe plugin archive path')
manifest=json.loads(z.read('extension/package.json'))
if manifest.get('publisher')+'.'+manifest.get('name')!=expected_id or manifest.get('version')!=expected_version: raise ValueError('Plugin identity mismatch')
z.extractall(target)
for item in entries:
if not item.is_dir(): os.chmod(pathlib.Path(target)/item.filename, 0o755 if (item.external_attr>>16)&0o111 else 0o644)
`,
target,
unpacked,
id,
version,
],
{ timeout: 30_000 },
);
try {
await rename(plugin, previous);
moved = true;
} catch (error) {
if (error.code !== 'ENOENT') throw error;
}
try {
await rename(unpacked, plugin);
} catch (error) {
if (moved) await rename(previous, plugin);
throw error;
}
await rm(previous, { recursive: true, force: true });
} finally {
await rm(unpacked, { recursive: true, force: true });
}
return { target: plugin, archive: target, sha256: expected, cached };
}
if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
const args = process.argv.slice(2);
const flags = new Map();
for (let index = 0; index < args.length; index += 2) flags.set(args[index], args[index + 1]);
if (
args.length % 2 ||
[...flags].some(
([key, value]) => !['--archive', '--python-archive', '--pyright-archive'].includes(key) || !value,
) ||
flags.size * 2 !== args.length
) {
console.error(
'Usage: node scripts/download-python-debugger.mjs [--archive /path/to/debugpy.vsix] [--python-archive /path/to/python.vsix] [--pyright-archive /path/to/pyright.vsix]',
);
process.exitCode = 1;
} else {
try {
console.log(
JSON.stringify(
await installPythonDebugger({
archive: flags.get('--archive'),
pythonArchive: flags.get('--python-archive'),
pyrightArchive: flags.get('--pyright-archive'),
}),
),
);
} catch (error) {
console.error(error.message);
process.exitCode = 1;
}
}
}