WslBuild
A Sublime Text package to create build systems running in WSL2
Details
Installs
- Total 478
- Win 477
- Mac 0
- Linux 1
Jul 26 | Jul 25 | Jul 24 | Jul 23 | Jul 22 | Jul 21 | Jul 20 | Jul 19 | Jul 18 | Jul 17 | Jul 16 | Jul 15 | Jul 14 | Jul 13 | Jul 12 | Jul 11 | Jul 10 | Jul 9 | Jul 8 | Jul 7 | Jul 6 | Jul 5 | Jul 4 | Jul 3 | Jul 2 | Jul 1 | Jun 30 | Jun 29 | Jun 28 | Jun 27 | Jun 26 | Jun 25 | Jun 24 | Jun 23 | Jun 22 | Jun 21 | Jun 20 | Jun 19 | Jun 18 | Jun 17 | Jun 16 | Jun 15 | Jun 14 | Jun 13 | Jun 12 | Jun 11 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Windows | 1 | 4 | 0 | 0 | 0 | 0 | 0 | 1 | 3 | 2 | 0 | 0 | 0 | 1 | 1 | 1 | 1 | 1 | 2 | 0 | 0 | 2 | 2 | 0 | 1 | 0 | 0 | 0 | 1 | 0 | 2 | 1 | 1 | 0 | 1 | 1 | 1 | 0 | 2 | 1 | 0 | 0 | 0 | 1 | 1 | 1 |
Mac | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
Linux | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
Readme
- Source
- raw.githubusercontent.com
WSL Build
A Sublime Text package to create build systems running in WSL2.
It adds a wsl_exec
target that:
- executes Linux commands within Windows Subsystem for Linux 2
- provides Linux paths in variables such as
$unix_file
- properly sets environment variables for Linux commands
Execution and printing output is performed by Sublime Text's default exec
build target.
Installation
Package Control
The easiest way to install is using Package Control. It's listed as WslBuild
.
- Open
Command Palette
using ctrl+shift+P or menu itemTools → Command Palette...
- Choose
Package Control: Install Package
- Find
WslBuild
and hit Enter
Manual Install
- Download appropriate WslBuild.sublime-package for your Sublime Text build.
- Copy it into Installed Packages directory
To find Installed Packages…
- call Menu > Preferences > Browse Packages..
- Navigate to parent folder
Clone repository
You can clone this repository into your Sublime Text/Packages
Note
To find Packages folder call Menu > Preferences > Browse Packages…
Mac OS
cd ~/Library/Application\ Support/Sublime\ Text/Packages/
git clone https://github.com/SublimeText/WslBuild.git
Linux
cd ~/.config/sublime-text/Packages
git clone https://github.com/SublimeText/WslBuild.git
Windows
cd "%APPDATA%\Sublime Text\Packages"
git clone https://github.com/SublimeText/WslBuild.git
Usage
Defining a Build
Set "target": "wsl_exec"
and "cancel": {"kill": true}
to be able to cancel a command.
Note
For more information about defining Sublime Text builds see the official documentation
Required Keys
wsl_cmd
Set "wsl_cmd"
instead of "cmd"
. The command array will be executed through WSL.
Can be a string
or list
of strings.
Note
Build variables such as $file have a $unix_file counter part with unix style paths.
Optional Keys
wsl_working_dir
Set "wsl_working_dir"
instead of "working_dir"
.
Note
Build variables such as $file have a $unix_file counter part with unix style paths.
wsl_env
Set "wsl_env"
instead of "env"
to set environment variables that are available to
the Linux command.
Note
Build variables such as $file have a $unix_file counter part with unix style paths.
Environment variables can be suffixed by conversion flags to specify how their values are treated by WSL.
"MY_PATH/p": "C:\\Path\\to\\File"
is converted to:
MY_PATH=/mnt/c/Path/to/File
when running unix commandsMY_PATH=C:\\Path\\to\\File
when running windows commands
flag | description |
---|---|
/p |
This flag indicates that a path should be translated between WSL paths and Win32 paths. Notice in the example below how we set the var in WSL, add it to WSLENV with the /p flag, and then read the variable from cmd.exe and the path translates accordingly. |
/l |
This flag indicates the value is a list of paths. In WSL, it is a colon-delimited list. In Win32, it is a semicolon-delimited list. |
/u |
This flag indicates the value should only be included when invoking WSL from Win32. |
/w |
Notice how it does not convert the path automatically—we need to specify the /p flag to do this. |
For more information about it, visit: https://devblogs.microsoft.com/commandline/share-environment-vars-between-wsl-and-windows
Example Build System to run file in WSL:
{
"target": "wsl_exec",
"cancel": {"kill": true},
"wsl_cmd": "./$unix_file",
"wsl_working_dir": "$unix_file_path",
}
Example Builds for a Rails app in WSL:
"build_systems": [
{
"name": "Run Current Spec",
"target": "wsl_exec",
"cancel": {"kill": true},
"wsl_cmd": "bundle exec rake spec"
"wsl_env": {
"SPEC/p": "$file"
},
"wsl_working_dir": "$unix_folder"
},
{
"name": "Run All Specs",
"target": "wsl_exec",
"cancel": {"kill": true},
"wsl_cmd": [
"bundle", "exec", "rake", "spec"
],
"wsl_working_dir": "$unix_folder",
},
{
"name": "Run Database Migrations",
"target": "wsl_exec",
"cancel": {"kill": true},
"wsl_cmd": [
"bundle", "exec", "rake", "db:migrate"
],
"wsl_working_dir": "$unix_folder"
}
]
Variables
Default Variables
All default variables are provided in unconverted form in case a windows command is being executed within WSL2.
variable | description |
---|---|
$packages |
The path to the Packages/ folder. |
$platform |
The platform Sublime Text is running on: “windows”, “osx” or “linux”. |
$file |
The full path, including folder, to the file in the active view. |
$file_path |
The path to the folder that contains the file in the active view. |
$file_name |
The file name (sans folder path) of the file in the active view. |
$file_base_name |
The file name, excluding the extension, of the file in the active view. |
$file_extension |
The extension of the file name of the file in the active view. |
$folder |
The full path to the first folder open in the side bar. |
$project |
The full path to the current project file. |
$project_path |
The path to the folder containing the current project file. |
$project_name |
The file name (sans folder path) of the current project file. |
$project_base_name |
The file name, excluding the extension, of the current project file. |
$project_extension |
The extension of the current project file. |
see: https://www.sublimetext.com/docs/build_systems.html#variables
Unix Variables
Converted path variables are provided for unix commands being executed within WSL.
variable (unix style) | original variable (windows style) |
---|---|
$unix_file |
$file |
$unix_file_path |
$file_path |
$unix_folder |
$folder |
$unix_packages |
$packages |
$unix_project |
$project |
$unix_project_path |
$project_path |
Acknowledgments
Inspired by