added output file option

Author: arturcic

src/GitVersionCore/Core/GitVersionTool.cs

@@ -85,7 +85,7 @@ public void OutputVariables(VersionVariables variables)
 
             using (outputGenerator)
             {
-                outputGenerator.Execute(variables, new OutputContext(gitVersionOptions.WorkingDirectory));
+                outputGenerator.Execute(variables, new OutputContext(gitVersionOptions.WorkingDirectory, gitVersionOptions.OutputFile));
             }
         }
 

src/GitVersionCore/Model/GitVersionOptions.cs

@@ -39,6 +39,7 @@ public GitVersionOptions()
 
         public string LogFilePath;
         public string ShowVariable;
+        public string OutputFile;
         public ISet<OutputType> Output = new HashSet<OutputType>();
         public Verbosity Verbosity = Verbosity.Normal;
 

src/GitVersionCore/Model/OutputType.cs

@@ -3,7 +3,7 @@ namespace GitVersion.Model
     public enum OutputType
     {
         BuildServer,
-
-        Json
+        Json,
+        File
     }
 }

src/GitVersionCore/VersionConverters/OutputGenerator/OutputContext.cs

@@ -2,11 +2,13 @@ namespace GitVersion.VersionConverters.OutputGenerator
 {
     public readonly struct OutputContext : IConverterContext
     {
-        public OutputContext(string workingDirectory)
+        public OutputContext(string workingDirectory, string outputFile)
         {
             WorkingDirectory = workingDirectory;
+            OutputFile = outputFile;
         }
 
         public string WorkingDirectory { get; }
+        public string OutputFile { get; }
     }
 }

src/GitVersionCore/VersionConverters/OutputGenerator/OutputGenerator.cs

@@ -13,12 +13,14 @@ public interface IOutputGenerator : IVersionConverter<OutputContext>
     public class OutputGenerator : IOutputGenerator
     {
         private readonly IConsole console;
+        private readonly IFileSystem fileSystem;
         private readonly IOptions<GitVersionOptions> options;
         private readonly ICurrentBuildAgent buildAgent;
 
-        public OutputGenerator(ICurrentBuildAgent buildAgent, IConsole console, IOptions<GitVersionOptions> options)
+        public OutputGenerator(ICurrentBuildAgent buildAgent, IConsole console, IFileSystem fileSystem, IOptions<GitVersionOptions> options)
         {
             this.console = console ?? throw new ArgumentNullException(nameof(console));
+            this.fileSystem = fileSystem ?? throw new ArgumentNullException(nameof(fileSystem));
             this.options = options ?? throw new ArgumentNullException(nameof(options));
             this.buildAgent = buildAgent;
         }
@@ -30,6 +32,10 @@ public void Execute(VersionVariables variables, OutputContext context)
             {
                 buildAgent?.WriteIntegration(console.WriteLine, variables);
             }
+            if (gitVersionOptions.Output.Contains(OutputType.File))
+            {
+                fileSystem.WriteAllText(context.OutputFile, variables.ToString());
+            }
             if (gitVersionOptions.Output.Contains(OutputType.Json))
             {
                 switch (gitVersionOptions.ShowVariable)

src/GitVersionExe/ArgumentParser.cs

@@ -223,6 +223,13 @@ private static bool ParseSwitches(Arguments arguments, string name, string[] val
                 return true;
             }
 
+            if (name.IsSwitch("outputfile"))
+            {
+                EnsureArgumentValueCount(values);
+                arguments.OutputFile = value;
+                return true;
+            }
+
             if (name.IsSwitch("nofetch"))
             {
                 arguments.NoFetch = true;
@@ -417,7 +424,7 @@ private static void ParseOutput(Arguments arguments, string[] values)
             {
                 if (!Enum.TryParse(v, true, out OutputType outputType))
                 {
-                    throw new WarningException($"Value '{v}' cannot be parsed as output type, please use 'json' or 'buildserver'");
+                    throw new WarningException($"Value '{v}' cannot be parsed as output type, please use 'json', 'file' or 'buildserver'");
                 }
 
                 arguments.Output.Add(outputType);

src/GitVersionExe/Arguments.cs

@@ -34,6 +34,7 @@ public class Arguments
 
         public string LogFilePath;
         public string ShowVariable;
+        public string OutputFile;
         public ISet<OutputType> Output = new HashSet<OutputType>();
         public Verbosity Verbosity = Verbosity.Normal;
 
@@ -108,6 +109,7 @@ public GitVersionOptions ToOptions()
                 ShowVariable = ShowVariable,
                 Verbosity = Verbosity,
                 Output = Output,
+                OutputFile = OutputFile,
 
                 // TODO obsolete to be removed in version 6.0.0
                 Proj = Proj,