import * as vscode from 'vscode'; import { Env } from './client'; import { log } from "./util"; export type UpdatesChannel = "stable" | "nightly"; export const NIGHTLY_TAG = "nightly"; export type RunnableEnvCfg = undefined | Record | { mask?: string; env: Record }[]; export class Config { readonly extensionId = "matklad.rust-analyzer"; readonly rootSection = "rust-analyzer"; private readonly requiresReloadOpts = [ "serverPath", "server", "cargo", "procMacro", "files", "highlighting", "updates.channel", "lens", // works as lens.* "hoverActions", // works as hoverActions.* ] .map(opt => `${this.rootSection}.${opt}`); readonly package: { version: string; releaseTag: string | null; enableProposedApi: boolean | undefined; } = vscode.extensions.getExtension(this.extensionId)!.packageJSON; readonly globalStoragePath: string; constructor(ctx: vscode.ExtensionContext) { this.globalStoragePath = ctx.globalStoragePath; vscode.workspace.onDidChangeConfiguration(this.onDidChangeConfiguration, this, ctx.subscriptions); this.refreshLogging(); } private refreshLogging() { log.setEnabled(this.traceExtension); log.info("Extension version:", this.package.version); const cfg = Object.entries(this.cfg).filter(([_, val]) => !(val instanceof Function)); log.info("Using configuration", Object.fromEntries(cfg)); } private async onDidChangeConfiguration(event: vscode.ConfigurationChangeEvent) { this.refreshLogging(); const requiresReloadOpt = this.requiresReloadOpts.find( opt => event.affectsConfiguration(opt) ); if (!requiresReloadOpt) return; const userResponse = await vscode.window.showInformationMessage( `Changing "${requiresReloadOpt}" requires a reload`, "Reload now" ); if (userResponse === "Reload now") { await vscode.commands.executeCommand("workbench.action.reloadWindow"); } } // We don't do runtime config validation here for simplicity. More on stackoverflow: // https://stackoverflow.com/questions/60135780/what-is-the-best-way-to-type-check-the-configuration-for-vscode-extension private get cfg(): vscode.WorkspaceConfiguration { return vscode.workspace.getConfiguration(this.rootSection); } /** * Beware that postfix `!` operator erases both `null` and `undefined`. * This is why the following doesn't work as expected: * * ```ts * const nullableNum = vscode * .workspace * .getConfiguration * .getConfiguration("rust-analyer") * .get(path)!; * * // What happens is that type of `nullableNum` is `number` but not `null | number`: * const fullFledgedNum: number = nullableNum; * ``` * So this getter handles this quirk by not requiring the caller to use postfix `!` */ private get(path: string): T { return this.cfg.get(path)!; } get serverPath() { return this.get("server.path") ?? this.get("serverPath"); } get serverExtraEnv() { return this.get("server.extraEnv") ?? {}; } get channel() { return this.get("updates.channel"); } get askBeforeDownload() { return this.get("updates.askBeforeDownload"); } get traceExtension() { return this.get("trace.extension"); } get httpProxy() { const httpProxy = vscode .workspace .getConfiguration('http') .get("proxy")!; return httpProxy || process.env["https_proxy"] || process.env["HTTPS_PROXY"]; } get inlayHints() { return { enable: this.get("inlayHints.enable"), typeHints: this.get("inlayHints.typeHints"), parameterHints: this.get("inlayHints.parameterHints"), chainingHints: this.get("inlayHints.chainingHints"), maxLength: this.get("inlayHints.maxLength"), }; } get checkOnSave() { return { command: this.get("checkOnSave.command"), }; } get cargoRunner() { return this.get("cargoRunner"); } get runnableEnv() { return this.get("runnableEnv"); } get debug() { let sourceFileMap = this.get | "auto">("debug.sourceFileMap"); if (sourceFileMap !== "auto") { // "/rustc/" used by suggestions only. const { ["/rustc/"]: _, ...trimmed } = this.get>("debug.sourceFileMap"); sourceFileMap = trimmed; } return { engine: this.get("debug.engine"), engineSettings: this.get("debug.engineSettings"), openDebugPane: this.get("debug.openDebugPane"), sourceFileMap: sourceFileMap }; } get lens() { return { enable: this.get("lens.enable"), run: this.get("lens.run"), debug: this.get("lens.debug"), implementations: this.get("lens.implementations"), methodReferences: this.get("lens.methodReferences"), references: this.get("lens.references"), }; } get hoverActions() { return { enable: this.get("hoverActions.enable"), implementations: this.get("hoverActions.implementations"), run: this.get("hoverActions.run"), debug: this.get("hoverActions.debug"), gotoTypeDef: this.get("hoverActions.gotoTypeDef"), }; } }