README.md

wsl-path

A small node utility for converting file paths from POSIX paths in wsl (Windows Subsystem for Linux) to their counterparts in the Windows Filesystem and vice versa.

How it works

This utility requires the wslpath CLI tool to be installed on the running machine and a wsl environment. Only the base drive letter (Windows) / mount folder (POSIX) is being translated into the windows world, the rest of the path is then appended in the correct form. Base path resolutions are cached, so only the first resolution causes wslpath to be called, while subsequent paths in the same drive/mount folder are resolved by the cache.

The utility checks the mount points for the WSL environment in order to determine cachable paths.

Usage

The following examples are taken from the unit tests:

windowsToWsl(path, options?)

Converts a windows path to a WSL (POSIX) path.

const correctPath = "C:\\Users";

const result = await windowsToWsl(correctPath);

expect(result).toEqual("/mnt/c/Users");

wslToWindows(path, options?)

Converts a WSL (POSIX) Path to a windows path.

const mountedPath = "/mnt/c/Users";

const result = await wslToWindows(mountedPath);

expect(result).toEqual("C:\\Users");

windowsToWslSync(path, options?)

Converts a windows path to a WSL (POSIX) path in a synchronous call.

const correctPath = "C:\\Users";

const result =  windowsToWslSync(correctPath);

expect(result).toEqual("/mnt/c/Users");

wslToWindowsSync(path, options?)

Converts a WSL (POSIX) Path to a windows path in a synchronous call.

const mountedPath = "/mnt/c/Users";

const result = wslToWindowsSync(mountedPath);

expect(result).toEqual("C:\\Users");

Resolving without wslpath

If you want to resolve without having wslpath (or without wanting to spawn a process calling it) you can provide your own cache in the options containing the base path resolution:

const windowsPath = "C:\\Users";

const result1 = await windowsToWsl(windowsPath, {
   basePathCache: { "C:\\": "/mnt/x" }
});

expect(result1).toEqual("/mnt/x/Users");

Using different wsl environments than the default

If you have multiple wsl environments installed, you can use the wslCommand option for setting up the shell that should be used:

const result1 = await windowsToWsl(windowsPath, {
   wslCommand: 'ubuntu run'
});

Building and testing

Install packages: npm install

Build: npm run build

Test: npm run test or npm run test -- --watch

Integration Test, which does not mock wslpath: CALL_WSL_PROCESS=1 npm run test