A simple Visual Studio extension that runs a command (i.e. a command line application), whenever a file is saved in Visual Studio. Available for free on the Visual Studio Marketplace.
The command to be run is specified in a .onsaveconfig file, which has the same syntax and behavior as .editorconfig files.
Here's an example .onsaveconfig file that calls dotnet-csharpier on C# files:
# run dotnet csharpier on C# files, whenever they're saved.
[*.cs]
command = dotnet
arguments = csharpier {file}The following options are supported:
- command - the command to run. It should be either fully qualified or available on the Path environment variable. For
.cmdand.batfiles, make sure the file extension is included in the command. - arguments - the arguments to supply to the command. It supports the following placeholders:
{file}- The file that was saved, fully qualified (e.g. C:\MySolution\MyProject\Program.cs){file_in_solution}- The file that was saved, relative to the solution_directory (e.g. MyProject\Program.cs){filename}- The file name of the file that was saved (e.g. Program.cs){directory}- The directory containing the file that was saved (e.g. C:\MySolution\MyProject){solution_directory}- The directory of the solution file (e.g. C:\MySolution)
- working_directory - The working directory to run the command in. Defaults to the directory of the file that was saved.
- timeout_seconds - How long to wait for the command to finish. Defaults to 30 seconds.
- always_run - by default, RunOnSave only runs the command when the input file has changed (so repeatedly pressing ctrl-s will only call the command once). Set this to
trueto disable this behavior, so the command will always run. This may be required if you have additional extensions that also modify the file on save.
Similar to .editorconfig, specific files can be ignored by setting the command to unset or ignore:
[*.cs]
command = dotnet
arguments = csharpier {file}
[BigFile.cs]
command = ignoreLogo by icons8.