Skip to content

wsl

Run block-scoped operations between Windows and WSL Linux through a remote VFS.

Functions

with_linux[R] block … -> R

Runs block in a WSL Linux distribution through a stdio VFS.

The active VFS target must be Windows.

Parameters

NameTypeDescription
block (() -> R) Block to run in Linux.
:distro? Str WSL distribution. Defaults to WSL's configured default.
:user? Str Linux user. Defaults to WSL's configured default.
:command? Iterable[Str] Linux VFS launcher command and arguments.
:cd? (Str | fs.Path) Initial Linux working directory.
:env? Dict[Str | Sym, Value] Initial Linux environment overrides.

with_windows[R] block … -> R

Runs block on the Windows host through WSL interoperability and a stdio VFS. The active VFS target must be Linux.

Parameters

NameTypeDescription
block (() -> R) Block to run on Windows.
:command? Iterable[Str] Windows VFS launcher command and arguments. Defaults to dolang-vfs.exe, preferring dolang.exe --vfs as a fallback.
:cd? (Str | fs.Path) Initial Windows working directory.
:env? Dict[Str | Sym, Value] Initial Windows environment overrides.