Releasing 0.12.0 (#497)

Author: belav

CHANGELOG.md

@@ -1,3 +1,13 @@
+[diff](https://github.com/belav/csharpier/compare/0.11.1...0.12.0)
+
+### Breaking Changes
+- If a file that fails to compile is piped to csharpier, csharpier now writes an error message on std error and return a 1 exit code.  
+
+### Changes
+- Nested Initializers should break [#487](https://github.com/belav/csharpier/issues/487)
+- Adding --pipe-multiple-files and other changes to support vscode extension [#283](https://github.com/belav/csharpier/pull/495)
+
+
 # 0.11.2 (CSharpier.MSBuild only)
 - CSharpier.MSBuild 0.11.1 is not published correctly [#481](https://github.com/belav/csharpier/issues/481)
 
@@ -39,7 +49,7 @@
 
 - Require the directoryOrFile argument when not piping into to stdin [#381](https://github.com/belav/csharpier/issues/381)
 
-### Resolved Issues
+### Changes
 - SwitchExpression + Pattern edge cause causes extra line and poor formatting [#408](https://github.com/belav/csharpier/issues/408)
 - NewLines not retained before lock statement [#401](https://github.com/belav/csharpier/issues/401)
 - Better error handling when given a csproj or sln file [#398](https://github.com/belav/csharpier/issues/398)

CSharpier.Build.props

@@ -1,6 +1,6 @@
 <Project>
     <PropertyGroup>
-        <Version>0.11.1</Version>
+        <Version>0.12.0</Version>
         <PackageLicenseExpression>MIT</PackageLicenseExpression>
         <RepositoryUrl>https://github.com/belav/csharpier</RepositoryUrl>
         <RepositoryType>git</RepositoryType>

Docs/CLI.md

@@ -12,6 +12,7 @@ Options:
   --fast            Skip comparing syntax tree of formatted file to original file to validate changes.
   --skip-write      Skip writing changes. Generally used for testing to ensure csharpier doesn't throw any errors or cause syntax tree validation failures.
   --write-stdout    Write the results of formatting any files to stdout.
+  --pipe-multiple-files  Keep csharpier running so that multiples files can be piped to it via stdin
   --version         Show version information
   -?, -h, --help    Show help and usage information
 
@@ -78,4 +79,24 @@ public class ClassName
 {
     public string Field;
 }
-```
+```
+
+### --pipe-multiple-files
+Running csharpier to format a single file is slow because of the overhead of starting up dotnet. 
+This option keeps csharpier running so that multiple files can be formatted. This is mainly used by IDE plugins
+to drastically improve formatting time.  
+The input is a '\u0003' delimited list of file names followed by file contents.  
+The results are written to stdout delimited by \u0003.  
+For an example of implementing this in code see [this example](https://github.com/belav/csharpier/blob/master/Src/CSharpier.VSCode/src/CSharpierProcessPipeMultipleFiles.ts)
+```bash
+$ [FullPathToFile]\u0003[FileContents]\u0003[FullPathToFile]\u0003[FileContents]\u0003 | dotnet csharpier --pipe-multiple-files
+public class ClassName
+{
+    public string Field;
+}
+\u0003
+public class ClassName
+{
+    public string Field;
+}
+```

Docs/EditorsAndCICD.md

@@ -1,3 +1,20 @@
+## Editor Integration
+### Visual Studio
+Check out [WillFuqua.RunOnSave](https://marketplace.visualstudio.com/items?itemName=WillFuqua.RunOnSave)
+### Visual Studio Code
+Use the [official extension](https://marketplace.visualstudio.com/items?itemName=csharpier.csharpier-vscode)
+
+
+### Rider
+1. Open Settings
+2. Tools - File Watchers
+3. Add New File Watcher
+   * File Type: C# File
+   * Program: dotnet
+   * Arguments: csharpier $FilePath$
+   * Output paths to refresh: $FilePath$
+   * Advanced Options - Auto-save edited files...: This should probably be off otherwise if you pause while coding csharpier will reformat the file as is.
+
 ## Continuous Integration
 Normally when using a code formatter like CSharpier, you'll want to ensure that all code that makes it to your main branch has been formatted. This can be accomplished by doing the following
 1. Set up a dotnet tool manifest file at `.config/dotnet-tools.json` with the following content. Replacing `[SpecificVersion]` with the version of CSharpier you are currently using. 
@@ -38,24 +55,3 @@ Normally when using a code formatter like CSharpier, you'll want to ensure that
    
    ```
 
-
-## Editor Integration
-### Visual Studio
-Check out [WillFuqua.RunOnSave](https://marketplace.visualstudio.com/items?itemName=WillFuqua.RunOnSave)
-### Visual Studio Code
-An official extension is being discussed https://github.com/belav/csharpier/issues/283 \
-A couple of extensions have been built for personal use [CSharpier-vscode]([https://github.com/pontusntengnas/CSharpier-vscode]) and
-[vscode-csharpier](https://github.com/saborrie/vscode-csharpier) \
-Using a run on save extension is another option. Check out
- [emeraldwalk.RunOnSave](https://marketplace.visualstudio.com/items?itemName=emeraldwalk.RunOnSave) or [pucelle.run-on-save](https://marketplace.visualstudio.com/items?itemName=pucelle.run-on-save)
-
-
-### Rider
-1. Open Settings
-2. Tools - File Watchers
-3. Add New File Watcher
-    * File Type: C# File
-    * Program: dotnet
-    * Arguments: csharpier $FilePath$
-    * Output paths to refresh: $FilePath$
-    * Advanced Options - Auto-save edited files...: This should probably be off otherwise if you pause while coding csharpier will reformat the file as is.