Support for GitHub Actions

src/GitVersion.sln.DotSettings

@@ -485,7 +485,7 @@ II.2.12 <HandlesEvent />
 </Patterns>
 </s:String>
 	<s:String x:Key="/Default/CodeStyle/CSharpMemberOrderPattern/LayoutType/@EntryValue">CustomLayout</s:String>
-	<s:Boolean x:Key="/Default/CodeStyle/CSharpUsing/AddImportsToDeepestScope/@EntryValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/CodeStyle/CSharpUsing/AddImportsToDeepestScope/@EntryValue">False</s:Boolean>
 	<s:Boolean x:Key="/Default/CodeStyle/CSharpUsing/QualifiedUsingAtNestedScope/@EntryValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/CodeStyle/Generate/=Constructor/@KeyIndexDefined">True</s:Boolean>
 	<s:String x:Key="/Default/CodeStyle/Generate/=Constructor/Options/=XmlDocumentation/@EntryIndexedValue">False</s:String>

src/GitVersionCore.Tests/BuildServers/GitHubActionsTests.cs

@@ -0,0 +1,183 @@
+using System;
+using GitVersion;
+using GitVersion.BuildServers;
+using GitVersion.Logging;
+using NUnit.Framework;
+using Shouldly;
+using System.Collections.Generic;
+using GitVersion.Configuration;
+using NSubstitute;
+using Environment = System.Environment;
+
+namespace GitVersionCore.Tests.BuildServers
+{
+
+    [TestFixture]
+    public class GitHubActionsTests : TestBase
+    {
+        private IConsole console;
+        private IEnvironment environment;
+        private ILog log;
+        private List<string> consoleLinesWritten;
+
+        [SetUp]
+        public void SetUp()
+        {
+            log = new NullLog();
+            console = Substitute.For<IConsole>();
+
+            consoleLinesWritten = new List<string>();
+            console.WhenForAnyArgs(c => c.WriteLine(default))
+                .Do(info => consoleLinesWritten.Add(info.Arg<string>()));
+            console.WhenForAnyArgs(c => c.WriteLine())
+                .Do(info => consoleLinesWritten.Add(string.Empty));
+
+            environment = new TestEnvironment();
+            environment.SetEnvironmentVariable("GITHUB_ACTION", Guid.NewGuid().ToString());
+        }
+
+        [TearDown]
+        public void TearDown()
+        {
+            environment.SetEnvironmentVariable("GITHUB_ACTION", null);
+        }
+
+        [Test]
+        public void CanApplyToCurrentContextShouldBeTrueWhenEnvironmentVariableIsSet()
+        {
+            // Arrange
+            var buildServer = new GitHubActions(environment, log, console);
+
+            // Act
+            var result = buildServer.CanApplyToCurrentContext();
+
+            // Assert
+            result.ShouldBeTrue();
+        }
+
+        [Test]
+        public void CanApplyToCurrentContextShouldBeFalseWhenEnvironmentVariableIsNotSet()
+        {
+            // Arrange
+            environment.SetEnvironmentVariable("GITHUB_ACTION", "");
+            var buildServer = new GitHubActions(environment, log, console);
+
+            // Act
+            var result = buildServer.CanApplyToCurrentContext();
+
+            // Assert
+            result.ShouldBeFalse();
+        }
+
+        [Test]
+        public void GetCurrentBranchShouldGetBranchIfSet()
+        {
+            // Arrange
+            const string expected = "actionsBranch";
+
+            environment.SetEnvironmentVariable("GITHUB_REF", $"refs/heads/{expected}");
+
+            var buildServer = new GitHubActions(environment, log, console);
+
+            // Act
+            var result = buildServer.GetCurrentBranch(false);
+
+            // Assert
+            result.ShouldBe(expected);
+        }
+
+        [Test]
+        public void GetCurrentBranchShouldNotMatchTag()
+        {
+            // Arrange
+            environment.SetEnvironmentVariable("GITHUB_REF", $"refs/tags/v1.0.0");
+
+            var buildServer = new GitHubActions(environment, log, console);
+
+            // Act
+            var result = buildServer.GetCurrentBranch(false);
+
+            // Assert
+            result.ShouldBeNull();
+        }
+
+        [TestCase("Something", "1.0.0",
+            "Adding Environment Variable to future steps. name='GitVersion_Something' value='1.0.0'",
+            "::set-env name=GitVersion_Something::1.0.0")]
+        public void GetSetParameterMessage(string key, string value, string expectedResult, string expectedConsole)
+        {
+            // Arrange
+            var buildServer = new GitHubActions(environment, log, console);
+
+            // Assert
+            environment.GetEnvironmentVariable("GitVersion_Something").ShouldBeNullOrWhiteSpace();
+
+            // Act
+            var result = buildServer.GenerateSetParameterMessage(key, value);
+
+            // Assert
+            result.ShouldContain(s => true, 1);
+            result.ShouldBeEquivalentTo(new[] { expectedResult });
+
+            consoleLinesWritten.ShouldBeEquivalentTo(new List<string> { expectedConsole });
+        }
+
+        [Test]
+        public void SkipEmptySetParameterMessage()
+        {
+            // Arrange
+            var buildServer = new GitHubActions(environment, log, console);
+
+            // Act
+            var result = buildServer.GenerateSetParameterMessage("Hello", string.Empty);
+
+            // Assert
+            result.ShouldBeEquivalentTo(new string[0]);
+        }
+
+        [Test]
+        public void ShouldWriteIntegration()
+        {
+            // Arrange
+            var buildServer = new GitHubActions(environment, log, console);
+
+            var vars = new TestableVersionVariables("1.0.0");
+
+            var list = new List<string>();
+
+            // Assert
+            environment.GetEnvironmentVariable("GitVersion_Major").ShouldBeNullOrWhiteSpace();
+
+            // Act
+            buildServer.WriteIntegration(s => { list.Add(s); }, vars);
+
+            // Assert
+            var expected = new List<string>
+            {
+                "Executing GenerateSetVersionMessage for 'GitHubActions'.",
+                "",
+                "Executing GenerateBuildLogOutput for 'GitHubActions'.",
+                "Adding Environment Variable to future steps. name='GitVersion_Major' value='1.0.0'"
+            };
+
+            string.Join(Environment.NewLine, list)
+                .ShouldBe(string.Join(Environment.NewLine, expected));
+
+            consoleLinesWritten.ShouldBeEquivalentTo(new List<string> { "::set-env name=GitVersion_Major::1.0.0" });
+        }
+
+        [Test]
+        public void GetEmptyGenerateSetVersionMessage()
+        {
+            // Arrange
+            var buildServer = new GitHubActions(environment, log, console);
+            var vars = new TestableVersionVariables("1.0.0");
+
+            // Act
+            var message = buildServer.GenerateSetVersionMessage(vars);
+
+            // Assert
+            message.ShouldBeEmpty();
+        }
+    }
+}

src/GitVersionCore/BuildServers/GitHubActions.cs

@@ -0,0 +1,74 @@
+using GitVersion.Logging;
+using GitVersion.OutputVariables;
+using GitVersion.Configuration;
+
+namespace GitVersion.BuildServers
+{
+    public class GitHubActions: BuildServerBase
+    {
+        private readonly IConsole console;
+        // https://help.github.com/en/actions/automating-your-workflow-with-github-actions/using-environment-variables#default-environment-variables
+
+        public GitHubActions(IEnvironment environment, ILog log, IConsole console) : base(environment, log)
+        {
+            this.console = console;
+        }
+
+        public const string EnvironmentVariableName = "GITHUB_ACTION";
+        protected override string EnvironmentVariable { get; } = EnvironmentVariableName;
+        public override bool CanApplyToCurrentContext()
+        {
+            return !string.IsNullOrWhiteSpace(Environment.GetEnvironmentVariable(EnvironmentVariable));
+        }
+
+        public override string GenerateSetVersionMessage(VersionVariables variables)
+        {
+            // There is no equivalent function in GitHub Actions.
+
+            return string.Empty;
+        }
+
+        public override string[] GenerateSetParameterMessage(string name, string value)
+        {
+            // https://help.github.com/en/actions/automating-your-workflow-with-github-actions/development-tools-for-github-actions#set-an-environment-variable-set-env
+            // Example
+            // echo "::set-env name=action_state::yellow"
+
+            if (!string.IsNullOrWhiteSpace(value))
+            {
+                var key = $"GitVersion_{name}";
+
+                console.WriteLine($"::set-env name={key}::{value}");
+
+                return new[]
+                {
+                    $"Adding Environment Variable to future steps. name='{key}' value='{value}'"
+                };
+            }
+
+            return new string[0];
+        }
+
+        public override string GetCurrentBranch(bool usingDynamicRepos)
+        {
+            // GITHUB_REF
+            // The branch or tag ref that triggered the workflow.
+            // For example, refs/heads/feature-branch-1. If neither a branch or
+            // tag is available for the event type, the variable will not exist.
+
+            var value = Environment.GetEnvironmentVariable("GITHUB_REF");
+            if (!string.IsNullOrWhiteSpace(value))
+            {
+                const string refsHeads = "refs/heads/";
+
+                if (value.StartsWith(refsHeads))
+                {
+                    value = value.Substring(refsHeads.Length);
+                    return value;
+                }
+            }
+
+            return base.GetCurrentBranch(usingDynamicRepos);
+        }
+    }
+}

src/GitVersionCore/Common/Environment.cs

@@ -1,3 +1,5 @@
+using System;
+
 namespace GitVersion
 {
     public class Environment : IEnvironment
@@ -11,5 +13,10 @@ public void SetEnvironmentVariable(string variableName, string value)
         {
             System.Environment.SetEnvironmentVariable(variableName, value);
         }
+
+        public void SetEnvironmentVariable(string variableName, string value, EnvironmentVariableTarget target)
+        {
+            System.Environment.SetEnvironmentVariable(variableName, value, target);
+        }
     }
 }

src/GitVersionCore/GitVersionCoreModule.cs

@@ -57,6 +57,7 @@ private static void RegisterBuildServers(IServiceCollection services)
             services.AddSingleton<IBuildServer, EnvRun>();
             services.AddSingleton<IBuildServer, Drone>();
             services.AddSingleton<IBuildServer, CodeBuild>();
+            services.AddSingleton<IBuildServer, GitHubActions>();
         }
 
         private static void RegisterVersionStrategies(IServiceCollection services)