Support using a different harper-ls executable than the one bundled in the VSCode extension

packages/vscode-plugin/CHANGELOG.md

@@ -4,6 +4,7 @@
 
 - Linting Python, Shellscript/Bash, and Git Commit files now work properly.
 - Add support for Nix and Plaintext files.
+- Add the `harper-ls.path` setting to optionally use a different `harper-ls` executable.
 
 ## 0.12.0
 

packages/vscode-plugin/README.md

@@ -20,10 +20,11 @@ If you use OpenVSX, for instance if you use VSCodium, you'll want to install fro
 
 ### Settings
 
-| Setting                        | Possible Values                                   | Default Value   | Description                                                       |
-| ------------------------------ | ------------------------------------------------- | --------------- | ----------------------------------------------------------------- |
-| `harper-ls.linters.*`          | `true`, `false`                                   | Varies          | Detect and provide suggestions in a variety of common situations. |
-| `harper-ls.diagnosticSeverity` | `"error"`, `"hint"`, `"information"`, `"warning"` | `"information"` | How severe do you want diagnostics to appear in the editor?       |
+| Setting                        | Type                                              | Default Value   | Description                                                                                                                                                 |
+| ------------------------------ | ------------------------------------------------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `harper-ls.path`               | `string`                                          | `""`            | Optional path to a `harper-ls` executable to use. Primarily useful if the bundled binary doesn't work in your system like in immutable Linux distributions. |
+| `harper-ls.linters.*`          | `boolean`                                         | Varies          | Detect and provide suggestions in a variety of common situations.                                                                                           |
+| `harper-ls.diagnosticSeverity` | `"error"`, `"hint"`, `"information"`, `"warning"` | `"information"` | How severe do you want diagnostics to appear in the editor?                                                                                                 |
 
 ## Developing and Contributing
 

packages/vscode-plugin/package.json

@@ -66,6 +66,11 @@
 			"type": "object",
 			"title": "Harper",
 			"properties": {
+				"harper-ls.path": {
+					"scope": "resource",
+					"type": "string",
+					"description": "Optional path to a harper-ls executable to use."
+				},
 				"harper-ls.linters.spell_check": {
 					"scope": "resource",
 					"type": "boolean",

packages/vscode-plugin/src/extension.ts

@@ -17,11 +17,7 @@ const serverOptions: Executable = { command: '', transport: TransportKind.stdio
 const clientOptions: LanguageClientOptions = {};
 
 export async function activate(context: ExtensionContext): Promise<void> {
-	serverOptions.command = Uri.joinPath(
-		context.extensionUri,
-		'bin',
-		`harper-ls${process.platform === 'win32' ? '.exe' : ''}`
-	).fsPath;
+	serverOptions.command = getExecutablePath(context);
 
 	let manifest: ExtensionManifest;
 	try {
@@ -43,6 +39,12 @@ export async function activate(context: ExtensionContext): Promise<void> {
 	const configs = Object.keys(manifest.contributes.configuration.properties);
 	context.subscriptions.push(
 		workspace.onDidChangeConfiguration(async (event) => {
+			if (event.affectsConfiguration('harper-ls.path')) {
+				serverOptions.command = getExecutablePath(context);
+				await startLanguageServer();
+				return;
+			}
+
 			if (configs.find((c) => event.affectsConfiguration(c))) {
 				await client?.sendNotification('workspace/didChangeConfiguration', {
 					settings: { 'harper-ls': workspace.getConfiguration('harper-ls') }
@@ -58,6 +60,20 @@ export async function activate(context: ExtensionContext): Promise<void> {
 	await startLanguageServer();
 }
 
+function getExecutablePath(context: ExtensionContext): string {
+	const path = workspace.getConfiguration('harper-ls').get<string>('path', '');
+
+	if (path !== '') {
+		return path;
+	}
+
+	return Uri.joinPath(
+		context.extensionUri,
+		'bin',
+		`harper-ls${process.platform === 'win32' ? '.exe' : ''}`
+	).fsPath;
+}
+
 async function startLanguageServer(): Promise<void> {
 	if (client && client.needsStop()) {
 		if (client.diagnostics) {