Update readme for v1.0 🎉

Bumps [acorn](https://github.com/acornjs/acorn) from 6.4.0 to 6.4.1. **This update includes a security fix.**
- [Release notes](https://github.com/acornjs/acorn/releases)
- [Commits](https://github.com/acornjs/acorn/compare/6.4.0...6.4.1)

Signed-off-by: dependabot-preview[bot] <support@dependabot.com>

.gitignore

@@ -1,2 +1,3 @@
 .idea
 node_modules
+coverage/

README.md

@@ -51,7 +51,7 @@ your license file and add it as a secret.
 Then, define the build step as follows:
 
 ```yaml
-- uses: webbertakken/unity-builder@v0.11
+- uses: webbertakken/unity-builder@<version>
   env:
     UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
   with:
@@ -73,7 +73,7 @@ Instead, three variables will need to be set.
 Define the build step as follows:
 
 ```yaml
-- uses: webbertakken/unity-builder@v0.11
+- uses: webbertakken/unity-builder@<version>
   env:
     UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}
     UNITY_PASSWORD: ${{ secrets.UNITY_PASSWORD }}
@@ -177,7 +177,7 @@ jobs:
           restore-keys: |
             Library-${{ matrix.projectPath }}-
             Library-
-      - uses: webbertakken/unity-builder@v0.11
+      - uses: webbertakken/unity-builder@<version>
         with:
           projectPath: ${{ matrix.projectPath }}
           unityVersion: ${{ matrix.unityVersion }}
@@ -245,7 +245,7 @@ There are two conditions for a custom buildCommand:
 _**example:**_
 
 ```yaml
-- uses: webbertakken/unity-builder@master
+- uses: webbertakken/unity-builder@<version>
   with:
     buildMethod: EditorNamespace.BuilderClassName.StaticBulidMethod
 ```
@@ -253,6 +253,63 @@ _**example:**_
 _**required:** `false`_
 _**default:** Built-in script that will run a build out of the box._
 
+#### versioning
+
+Configure a specific versioning strategy
+
+```yaml
+- uses: webbertakken/unity-builder@<version>
+  with:
+    versioning: Semantic
+```
+
+Find the available strategies below:
+
+##### Semantic
+
+Versioning out of the box! **(recommended)**
+
+> Compatible with **all platforms**.  
+> Does **not** modify your repository.  
+> Requires **zero configuration**.
+
+How it works:
+
+> Generates a version based on [semantic versioning](https://semver.org/).  
+> Follows `<major>.<minor>.<patch>` for example `0.17.2`.  
+> The latest tag dictates `<major>.<minor>` (defaults to 0.0 for no tag).  
+> The number of commits (since the last tag, if any) is used for `<patch>`.
+
+No configuration required.
+
+##### Custom
+
+Allows specifying a custom version in the `version` field. **(advanced users)**
+
+> This strategy is useful when your project or pipeline has some kind of orchestration
+> that determines the versions.
+
+##### None
+
+No version will be set by Builder. **(not recommended)**
+
+> Not recommended unless you generate a new version in a pre-commit hook. Manually
+> setting versions is error-prone.
+
+#### allowDirtyBuild
+
+Allows the branch of the build to be dirty, and still generate the build.
+
+```yaml
+- uses: webbertakken/unity-builder@<version>
+  with:
+    allowDirtyBuild: true
+```
+
+Note that it is generally bad practice to modify your branch
+in a CI Pipeline. However there are exceptions where this might
+be needed. (use with care).
+
 #### customParameters
 
 Custom parameters to configure the build.
@@ -264,7 +321,7 @@ Parameters without a value will be considered booleans (with a value of true).
 _**example:**_
 
 ```yaml
-- uses: webbertakken/unity-builder@master
+- uses: webbertakken/unity-builder@<version>
   with:
     customParameters: -profile SomeProfile -someBoolean -someValue exampleValue
 ```

action/default-build-script/.editorconfig

@@ -0,0 +1,4 @@
+root = true
+
+[*.cs]
+resharper_check_namespace_highlighting = do_not_show

action/default-build-script/Assembly-CSharp-Editor.csproj

@@ -57,6 +57,13 @@
   </ItemGroup>
   <ItemGroup>
      <Compile Include="Assets\Editor\Builder.cs" />
+     <Compile Include="Assets\Editor\Input\ArgumentsParser.cs" />
+     <Compile Include="Assets\Editor\Reporting\StdOutReporter.cs" />
+     <Compile Include="Assets\Editor\System\ProcessExtensions.cs" />
+     <Compile Include="Assets\Editor\Versioning\VersionApplicator.cs" />
+     <Compile Include="Assets\Editor\Versioning\Git.cs" />
+     <Compile Include="Assets\Editor\Versioning\VersionGenerator.cs" />
+     <Compile Include="Assets\Editor\Versioning\GitException.cs" />
  <Reference Include="UnityEditor.TestRunner">
  <HintPath>C:/Repositories/unity-builder/builder/default-build-script/Library/ScriptAssemblies/UnityEditor.TestRunner.dll</HintPath>
  </Reference>
@@ -688,6 +695,9 @@
  <HintPath>C:/Program Files/Unity/2019.2.11f1/Editor/Data/MonoBleedingEdge/lib/mono/unityscript/Boo.Lang.dll</HintPath>
  </Reference>
   </ItemGroup>
+  <ItemGroup>
+    <Content Include=".editorconfig" />
+  </ItemGroup>
   <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />
   <!-- To modify your build process, add your task inside one of the targets below and uncomment it. 
        Other similar extension points exist, see Microsoft.Common.targets.

action/default-build-script/Assets/Editor/Builder.cs

@@ -1,87 +1,20 @@
-using System;
+using System;
 using System.Collections.Generic;
-using System.IO;
 using System.Linq;
+using UnityBuilderAction.Input;
+using UnityBuilderAction.Reporting;
+using UnityBuilderAction.Versioning;
 using UnityEditor;
 using UnityEditor.Build.Reporting;
-using UnityEngine;
 
 namespace UnityBuilderAction
 {
   static class Builder
   {
-    private static string EOL = Environment.NewLine;
-
-    private static void ParseCommandLineArguments(out Dictionary<string, string> providedArguments)
-    {
-      providedArguments = new Dictionary<string, string>();
-      string[] args = Environment.GetCommandLineArgs();
-
-      Console.WriteLine(
-        $"{EOL}" +
-        $"###########################{EOL}" +
-        $"#    Parsing settings     #{EOL}" +
-        $"###########################{EOL}" +
-        $"{EOL}"
-      );
-
-      // Extract flags with optional values
-      for (int current = 0, next = 1; current < args.Length; current++, next++) {
-        // Parse flag
-        bool isFlag = args[current].StartsWith("-");
-        if (!isFlag) continue;
-        string flag = args[current].TrimStart('-');
-
-        // Parse optional value
-        bool flagHasValue = next < args.Length && !args[next].StartsWith("-");
-        string value = flagHasValue ? args[next].TrimStart('-') : "";
-
-        // Assign
-        Console.WriteLine($"Found flag \"{flag}\" with value \"{value}\".");
-        providedArguments.Add(flag, value);
-      }
-    }
-
-    private static Dictionary<string, string> GetValidatedOptions()
-    {
-      ParseCommandLineArguments(out var validatedOptions);
-
-      if (!validatedOptions.TryGetValue("projectPath", out var projectPath)) {
-        Console.WriteLine("Missing argument -projectPath");
-        EditorApplication.Exit(110);
-      }
-
-      if (!validatedOptions.TryGetValue("buildTarget", out var buildTarget)) {
-        Console.WriteLine("Missing argument -buildTarget");
-        EditorApplication.Exit(120);
-      }
-
-      if (!Enum.IsDefined(typeof(BuildTarget), buildTarget)) {
-        EditorApplication.Exit(121);
-      }
-
-      if (!validatedOptions.TryGetValue("customBuildPath", out var customBuildPath)) {
-        Console.WriteLine("Missing argument -customBuildPath");
-        EditorApplication.Exit(130);
-      }
-
-      string defaultCustomBuildName = "TestBuild";
-      if (!validatedOptions.TryGetValue("customBuildName", out var customBuildName)) {
-        Console.WriteLine($"Missing argument -customBuildName, defaulting to {defaultCustomBuildName}.");
-        validatedOptions.Add("customBuildName", defaultCustomBuildName);
-      }
-      else if (customBuildName == "") {
-        Console.WriteLine($"Invalid argument -customBuildName, defaulting to {defaultCustomBuildName}.");
-        validatedOptions.Add("customBuildName", defaultCustomBuildName);
-      }
-
-      return validatedOptions;
-    }
-
     public static void BuildProject()
     {
       // Gather values from args
-      var options = GetValidatedOptions();
+      var options = ArgumentsParser.GetValidatedOptions();
 
       // Gather values from project
       var scenes = EditorBuildSettings.scenes.Where(scene => scene.enabled).Select(s => s.path).ToArray();
@@ -93,55 +26,19 @@ namespace UnityBuilderAction
         target = (BuildTarget) Enum.Parse(typeof(BuildTarget), options["buildTarget"]),
       };
 
+      // Set version for this build
+      VersionApplicator.SetVersion(options["version"]);
+
       // Perform build
       BuildReport buildReport = BuildPipeline.BuildPlayer(buildOptions);
 
       // Summary
       BuildSummary summary = buildReport.summary;
-      ReportSummary(summary);
+      StdOutReporter.ReportSummary(summary);
 
       // Result
       BuildResult result = summary.result;
-      ExitWithResult(result);
+      StdOutReporter.ExitWithResult(result);
-    }
-
-    private static void ReportSummary(BuildSummary summary)
-    {
-      Console.WriteLine(
-        $"{EOL}" +
-        $"###########################{EOL}" +
-        $"#      Build results      #{EOL}" +
-        $"###########################{EOL}" +
-        $"{EOL}" +
-        $"Duration: {summary.totalTime.ToString()}{EOL}" +
-        $"Warnings: {summary.totalWarnings.ToString()}{EOL}" +
-        $"Errors: {summary.totalErrors.ToString()}{EOL}" +
-        $"Size: {summary.totalSize.ToString()} bytes{EOL}" +
-        $"{EOL}"
-      );
-    }
-
-    private static void ExitWithResult(BuildResult result)
-    {
-      if (result == BuildResult.Succeeded) {
-        Console.WriteLine("Build succeeded!");
-        EditorApplication.Exit(0);
-      }
-
-      if (result == BuildResult.Failed) {
-        Console.WriteLine("Build failed!");
-        EditorApplication.Exit(101);
-      }
-
-      if (result == BuildResult.Cancelled) {
-        Console.WriteLine("Build cancelled!");
-        EditorApplication.Exit(102);
-      }
-
-      if (result == BuildResult.Unknown) {
-        Console.WriteLine("Build result is unknown!");
-        EditorApplication.Exit(103);
-      }
     }
   }
 }

action/default-build-script/Assets/Editor/Input.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: b6e5ef18d769419d887b56665969442b
+timeCreated: 1587503329

action/default-build-script/Assets/Editor/Input/ArgumentsParser.cs

@@ -0,0 +1,76 @@
+using System;
+using System.Collections.Generic;
+using UnityEditor;
+
+namespace UnityBuilderAction.Input
+{
+  public class ArgumentsParser
+  {
+    static string EOL = Environment.NewLine;
+
+    public static Dictionary<string, string> GetValidatedOptions()
+    {
+      ParseCommandLineArguments(out var validatedOptions);
+
+      if (!validatedOptions.TryGetValue("projectPath", out var projectPath)) {
+        Console.WriteLine("Missing argument -projectPath");
+        EditorApplication.Exit(110);
+      }
+
+      if (!validatedOptions.TryGetValue("buildTarget", out var buildTarget)) {
+        Console.WriteLine("Missing argument -buildTarget");
+        EditorApplication.Exit(120);
+      }
+
+      if (!Enum.IsDefined(typeof(BuildTarget), buildTarget)) {
+        EditorApplication.Exit(121);
+      }
+
+      if (!validatedOptions.TryGetValue("customBuildPath", out var customBuildPath)) {
+        Console.WriteLine("Missing argument -customBuildPath");
+        EditorApplication.Exit(130);
+      }
+
+      const string defaultCustomBuildName = "TestBuild";
+      if (!validatedOptions.TryGetValue("customBuildName", out var customBuildName)) {
+        Console.WriteLine($"Missing argument -customBuildName, defaulting to {defaultCustomBuildName}.");
+        validatedOptions.Add("customBuildName", defaultCustomBuildName);
+      } else if (customBuildName == "") {
+        Console.WriteLine($"Invalid argument -customBuildName, defaulting to {defaultCustomBuildName}.");
+        validatedOptions.Add("customBuildName", defaultCustomBuildName);
+      }
+
+      return validatedOptions;
+    }
+
+    static void ParseCommandLineArguments(out Dictionary<string, string> providedArguments)
+    {
+      providedArguments = new Dictionary<string, string>();
+      string[] args = Environment.GetCommandLineArgs();
+
+      Console.WriteLine(
+        $"{EOL}" +
+        $"###########################{EOL}" +
+        $"#    Parsing settings     #{EOL}" +
+        $"###########################{EOL}" +
+        $"{EOL}"
+      );
+
+      // Extract flags with optional values
+      for (int current = 0, next = 1; current < args.Length; current++, next++) {
+        // Parse flag
+        bool isFlag = args[current].StartsWith("-");
+        if (!isFlag) continue;
+        string flag = args[current].TrimStart('-');
+
+        // Parse optional value
+        bool flagHasValue = next < args.Length && !args[next].StartsWith("-");
+        string value = flagHasValue ? args[next].TrimStart('-') : "";
+
+        // Assign
+        Console.WriteLine($"Found flag \"{flag}\" with value \"{value}\".");
+        providedArguments.Add(flag, value);
+      }
+    }
+  }
+}

action/default-build-script/Assets/Editor/Input/ArgumentsParser.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: 46d2ec4a86604575be2b2d02b0df7b74
+timeCreated: 1587503354

action/default-build-script/Assets/Editor/Reporting.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: 166f919334c44e7a80ae916667974e7d
+timeCreated: 1587503566

action/default-build-script/Assets/Editor/Reporting/StdOutReporter.cs

@@ -0,0 +1,50 @@
+using System;
+using UnityEditor;
+using UnityEditor.Build.Reporting;
+
+namespace UnityBuilderAction.Reporting
+{
+  public class StdOutReporter
+  {
+    static string EOL = Environment.NewLine;
+
+    public static void ReportSummary(BuildSummary summary)
+    {
+      Console.WriteLine(
+        $"{EOL}" +
+        $"###########################{EOL}" +
+        $"#      Build results      #{EOL}" +
+        $"###########################{EOL}" +
+        $"{EOL}" +
+        $"Duration: {summary.totalTime.ToString()}{EOL}" +
+        $"Warnings: {summary.totalWarnings.ToString()}{EOL}" +
+        $"Errors: {summary.totalErrors.ToString()}{EOL}" +
+        $"Size: {summary.totalSize.ToString()} bytes{EOL}" +
+        $"{EOL}"
+      );
+    }
+
+    public static void ExitWithResult(BuildResult result)
+    {
+      if (result == BuildResult.Succeeded) {
+        Console.WriteLine("Build succeeded!");
+        EditorApplication.Exit(0);
+      }
+
+      if (result == BuildResult.Failed) {
+        Console.WriteLine("Build failed!");
+        EditorApplication.Exit(101);
+      }
+
+      if (result == BuildResult.Cancelled) {
+        Console.WriteLine("Build cancelled!");
+        EditorApplication.Exit(102);
+      }
+
+      if (result == BuildResult.Unknown) {
+        Console.WriteLine("Build result is unknown!");
+        EditorApplication.Exit(103);
+      }
+    }
+  }
+}

action/default-build-script/Assets/Editor/Reporting/StdOutReporter.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: e59b491a4124442ea7277f76761cdc8a
+timeCreated: 1587503545

action/default-build-script/Assets/Editor/System.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: b5da3bd7e18c43d79243410166c8dc9a
+timeCreated: 1587493708

action/default-build-script/Assets/Editor/System/ProcessExtensions.cs

@@ -0,0 +1,42 @@
+using System.Diagnostics;
+using System.Text;
+
+public static class ProcessExtensions
+{
+  // Execute an application or binary with given arguments
+  //
+  // See: https://stackoverflow.com/questions/4291912/process-start-how-to-get-the-output
+  public static int Run(this Process process, string application,
+    string arguments, string workingDirectory, out string output,
+    out string errors)
+  {
+    // Configure how to run the application
+    process.StartInfo = new ProcessStartInfo {
+      CreateNoWindow = true,
+      UseShellExecute = false,
+      RedirectStandardError = true,
+      RedirectStandardOutput = true,
+      FileName = application,
+      Arguments = arguments,
+      WorkingDirectory = workingDirectory
+    };
+
+    // Read the output
+    var outputBuilder = new StringBuilder();
+    var errorsBuilder = new StringBuilder();
+    process.OutputDataReceived += (_, args) => outputBuilder.AppendLine(args.Data);
+    process.ErrorDataReceived += (_, args) => errorsBuilder.AppendLine(args.Data);
+
+    // Run the application and wait for it to complete
+    process.Start();
+    process.BeginOutputReadLine();
+    process.BeginErrorReadLine();
+    process.WaitForExit();
+
+    // Format the output
+    output = outputBuilder.ToString().TrimEnd();
+    errors = errorsBuilder.ToString().TrimEnd();
+
+    return process.ExitCode;
+  }
+}

action/default-build-script/Assets/Editor/System/ProcessExtensions.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: 29c1880a390c4af7be821b7877602815
+timeCreated: 1587494270

action/default-build-script/Assets/Editor/Versioning.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: 1c3bddf6d8984cde9208e3f0fe584879
+timeCreated: 1587490700

action/default-build-script/Assets/Editor/Versioning/Git.cs

@@ -0,0 +1,116 @@
+using System;
+using UnityEngine;
+
+namespace UnityBuilderAction.Versioning
+{
+  public static class Git
+  {
+    const string application = @"git";
+
+    /// <summary>
+    /// Generate a version based on the latest tag and the amount of commits.
+    /// Format: 0.1.2 (where 2 is the amount of commits).
+    ///
+    /// If no tag is present in the repository then v0.0 is assumed.
+    /// This would result in 0.0.# where # is the amount of commits.
+    /// </summary>
+    public static string GenerateSemanticCommitVersion()
+    {
+      string version;
+      if (HasAnyVersionTags()) {
+        version = GetSemanticCommitVersion();
+        Console.WriteLine("Repository has a valid version tag.");
+      } else {
+        version = $"0.0.{GetTotalNumberOfCommits()}";
+        Console.WriteLine("Repository does not have tags to base the version on.");
+      }
+
+      Console.WriteLine($"Version is {version}");
+
+      return version;
+    }
+
+    /// <summary>
+    /// Get the version of the current tag.
+    ///
+    /// The tag must point at HEAD for this method to work.
+    ///
+    /// Output Format:
+    /// #.* (where # is the major version and * can be any number of any type of character)
+    /// </summary>
+    public static string GetTagVersion()
+    {
+      string version = Run(@"tag --points-at HEAD | grep v[0-9]*");
+
+      version = version.Substring(1);
+
+      return version;
+    }
+
+    /// <summary>
+    /// Get the total number of commits.
+    /// </summary>
+    static int GetTotalNumberOfCommits()
+    {
+      string numberOfCommitsAsString = Run(@"git rev-list --count HEAD");
+
+      return int.Parse(numberOfCommitsAsString);
+    }
+
+    /// <summary>
+    /// Whether or not the repository has any version tags yet.
+    /// </summary>
+    static bool HasAnyVersionTags()
+    {
+      return "0" != Run(@"tag --list --merged HEAD | grep v[0-9]* | wc -l");
+    }
+
+    /// <summary>
+    /// Retrieves the build version from git based on the most recent matching tag and
+    /// commit history. This returns the version as: {major.minor.build} where 'build'
+    /// represents the nth commit after the tagged commit.
+    /// Note: The initial 'v' and the commit hash are removed.
+    /// </summary>
+    static string GetSemanticCommitVersion()
+    {
+      // v0.1-2-g12345678 (where 2 is the amount of commits, g stands for git)
+      string version = GetVersionString();
+      // 0.1-2
+      version = version.Substring(1, version.LastIndexOf('-') - 1);
+      // 0.1.2
+      version = version.Replace('-', '.');
+
+      return version;
+    }
+
+    /// <summary>
+    /// Get version string.
+    ///
+    /// Format: `v0.1-2-g12345678` (where 2 is the amount of commits since the last tag)
+    ///
+    /// See: https://softwareengineering.stackexchange.com/questions/141973/how-do-you-achieve-a-numeric-versioning-scheme-with-git
+    /// </summary>
+    static string GetVersionString()
+    {
+      return Run(@"describe --tags --long --match ""v[0-9]*""");
+
+      // Todo - implement split function based on this more complete query
+      // return Run(@"describe --long --tags --dirty --always");
+    }
+
+    /// <summary>
+    /// Runs git binary with any given arguments and returns the output.
+    /// </summary>
+    static string Run(string arguments)
+    {
+      using (var process = new System.Diagnostics.Process()) {
+        string workingDirectory = Application.dataPath;
+
+        int exitCode = process.Run(application, arguments, workingDirectory, out string output, out string errors);
+        if (exitCode != 0) { throw new GitException(exitCode, errors); }
+
+        return output;
+      }
+    }
+  }
+}

action/default-build-script/Assets/Editor/Versioning/Git.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: cdec7fa0f5bb44958fdf74d4658a4601
+timeCreated: 1587495075

action/default-build-script/Assets/Editor/Versioning/GitException.cs

@@ -0,0 +1,14 @@
+using System;
+
+namespace UnityBuilderAction.Versioning
+{
+  public class GitException : InvalidOperationException
+  {
+    public readonly int code;
+
+    public GitException(int code, string errors) : base(errors)
+    {
+      this.code = code;
+    }
+  }
+}

action/default-build-script/Assets/Editor/Versioning/GitException.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: 4d375e209fd14fc5bc2f3dc3c78ac574
+timeCreated: 1587490750

action/default-build-script/Assets/Editor/Versioning/VersionApplicator.cs

@@ -0,0 +1,23 @@
+using System;
+using JetBrains.Annotations;
+using UnityEditor;
+
+namespace UnityBuilderAction.Versioning
+{
+  public class VersionApplicator
+  {
+    public static void SetVersion(string version)
+    {
+      if (version == "none") {
+        return;
+      }
+      
+      Apply(version);
+    }
+
+    static void Apply(string version)
+    {
+      PlayerSettings.bundleVersion = version;
+    }
+  }
+}

action/default-build-script/Assets/Editor/Versioning/VersionApplicator.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: 30483367ddc84699a0da377ccb93769a
+timeCreated: 1587504315

action/default-build-script/Assets/Editor/Versioning/VersionGenerator.cs

@@ -0,0 +1,10 @@
+namespace UnityBuilderAction.Versioning
+{
+  public static class VersionGenerator
+  {
+    public static string Generate()
+    {
+      return Git.GenerateSemanticCommitVersion();
+    }
+  }
+}

action/default-build-script/Assets/Editor/Versioning/VersionGenerator.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: 9892e03ae8314b7eacd793c8002de007
+timeCreated: 1587490842

action/default-build-script/default-build-script.sln.DotSettings

@@ -0,0 +1,3 @@
+<wpf:ResourceDictionary xml:space="preserve" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:s="clr-namespace:System;assembly=mscorlib" xmlns:ss="urn:shemas-jetbrains-com:settings-storage-xaml" xmlns:wpf="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Untracked/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Versioning/@EntryIndexedValue">True</s:Boolean></wpf:ResourceDictionary>

action/steps/build.sh

@@ -109,6 +109,8 @@ xvfb-run --auto-servernum --server-args='-screen 0 640x480x24' \
     -customBuildTarget "$BUILD_TARGET" \
     -customBuildPath "$CUSTOM_BUILD_PATH" \
     -executeMethod "$BUILD_METHOD" \
+    -versioning "$VERSIONING" \
+    -version "$VERSION" \
     $CUSTOM_PARAMETERS
 
 # Catch exit code

codecov.yml

@@ -0,0 +1,39 @@
+codecov:
+  require_ci_to_pass: yes
+
+coverage:
+  precision: 2
+  round: down
+  range: '70...100'
+
+  status:
+    patch:
+      default:
+        # basic
+        target: auto
+        threshold: 100% # don't require patch to have coverage per se
+        base: auto
+
+    project:
+      default:
+        # basic
+        target: auto
+        threshold: 5%
+        base: auto
+        flags:
+          - unit
+        paths:
+          - 'src'
+
+parsers:
+  gcov:
+    branch_detection:
+      conditional: yes
+      loop: yes
+      method: no
+      macro: no
+
+comment:
+  layout: 'reach,diff,flags,tree'
+  behavior: default
+  require_changes: no

jest.config.js

@@ -5,4 +5,5 @@ module.exports = {
   moduleFileExtensions: ['js', 'jsx', 'json', 'vue'],
   transform: { '^.+\\.(js|jsx)?$': 'babel-jest' },
   transformIgnorePatterns: [`/node_modules/(?!${esModules})`],
+  setupFilesAfterEnv: ['./src/jest.setup.js'],
 };

package.json

@@ -13,30 +13,30 @@
     "test": "jest"
   },
   "dependencies": {
-    "@actions/core": "^1.2.2",
+    "@actions/core": "^1.2.4",
-    "@actions/exec": "1.0.3",
+    "@actions/exec": "1.0.4",
     "@actions/github": "^2.1.1"
   },
   "devDependencies": {
     "@babel/cli": "7.8.4",
-    "@babel/core": "7.8.7",
+    "@babel/core": "7.9.6",
-    "@babel/preset-env": "7.8.7",
+    "@babel/preset-env": "7.9.6",
-    "@zeit/ncc": "0.21.1",
+    "@zeit/ncc": "0.22.1",
     "babel-eslint": "10.1.0",
     "eslint": "6.8.0",
-    "eslint-config-airbnb": "18.0.1",
+    "eslint-config-airbnb": "18.1.0",
-    "eslint-config-prettier": "6.10.0",
+    "eslint-config-prettier": "6.11.0",
-    "eslint-plugin-flowtype": "4.6.0",
+    "eslint-plugin-flowtype": "4.7.0",
-    "eslint-plugin-import": "2.20.1",
+    "eslint-plugin-import": "2.20.2",
     "eslint-plugin-jsx-a11y": "6.2.3",
-    "eslint-plugin-prettier": "3.1.2",
+    "eslint-plugin-prettier": "3.1.3",
     "eslint-plugin-react": "7.19.0",
-    "eslint-plugin-unicorn": "17.1.0",
+    "eslint-plugin-unicorn": "19.0.1",
-    "husky": "4.2.3",
+    "husky": "4.2.5",
-    "jest": "25.1.0",
+    "jest": "25.5.3",
-    "lint-staged": "10.0.8",
+    "lint-staged": "10.2.2",
     "lodash-es": "4.17.15",
-    "prettier": "1.19.1"
+    "prettier": "2.0.5"
   },
   "husky": {
     "hooks": {

src/index.js

@@ -1,4 +1,4 @@
-import { Action, BuildParameters, Cache, Docker, Input, ImageTag } from './model';
+import { Action, BuildParameters, Cache, Docker, ImageTag } from './model';
 
 const core = require('@actions/core');
 
@@ -7,7 +7,8 @@ async function action() {
   Cache.verify();
 
   const { dockerfile, workspace, actionFolder } = Action;
-  const buildParameters = BuildParameters.create(Input.getFromUser());
+
+  const buildParameters = await BuildParameters.create();
   const baseImage = new ImageTag(buildParameters);
 
   // Build docker image
@@ -17,6 +18,6 @@ async function action() {
   await Docker.run(builtImage, { workspace, ...buildParameters });
 }
 
-action().catch(error => {
+action().catch((error) => {
   core.setFailed(error.message);
 });

src/jest.setup.js

@@ -0,0 +1,49 @@
+expect.extend({
+  toBeOfType(received, expectedType) {
+    const type = typeof received;
+
+    const pass = type === expectedType;
+    const message = () => `
+      Expected value to be of type ${this.utils.printExpected(expectedType)},
+      but received ${this.utils.printReceived(type)}`;
+
+    return {
+      message,
+      pass,
+    };
+  },
+
+  toBeEitherAFunctionOrAnObject(received) {
+    const type = typeof received;
+
+    const pass = ['object', 'function'].includes(type);
+    const message = () => `Expected a ${this.utils.printExpected('function')}
+      or an ${this.utils.printExpected('object')},
+      but received ${type}`;
+
+    return {
+      message,
+      pass,
+    };
+  },
+
+  toBeParsableToANumber(received) {
+    let pass = false;
+    let errorMessage = '';
+
+    try {
+      Number.parseInt(received, 10);
+      pass = true;
+    } catch (error) {
+      errorMessage = error;
+    }
+
+    const message = () => `Expected ${this.utils.printExpected(received)} to be parsable as a number
+      , but received error: ${this.utils.printReceived(errorMessage)}.`;
+
+    return {
+      message,
+      pass,
+    };
+  },
+});

src/model/__mocks__/input.js

@@ -0,0 +1,17 @@
+// Import this named export into your test file:
+import Platform from '../platform';
+
+export const mockGetFromUser = jest.fn().mockResolvedValue({
+  version: '',
+  targetPlatform: Platform.types.Test,
+  projectPath: '.',
+  buildName: Platform.types.Test,
+  buildsPath: 'build',
+  buildMethod: undefined,
+  buildVersion: '1.3.37',
+  customParameters: '',
+});
+
+export default {
+  getFromUser: mockGetFromUser,
+};

src/model/__mocks__/versioning.js

@@ -0,0 +1,38 @@
+/* eslint-disable unicorn/prevent-abbreviations */
+
+// Import these named export into your test file:
+export const mockProjectPath = jest.fn().mockResolvedValue('mockProjectPath');
+export const mockIsDirtyAllowed = jest.fn().mockResolvedValue(false);
+export const mockBranch = jest.fn().mockResolvedValue('mockBranch');
+export const mockHeadRef = jest.fn().mockResolvedValue('mockHeadRef');
+export const mockRef = jest.fn().mockResolvedValue('mockRef');
+export const mockDetermineVersion = jest.fn().mockResolvedValue('1.2.3');
+export const mockGenerateSemanticVersion = jest.fn().mockResolvedValue('2.3.4');
+export const mockGenerateTagVersion = jest.fn().mockResolvedValue('1.0');
+export const mockParseSemanticVersion = jest.fn().mockResolvedValue({});
+export const mockFetch = jest.fn().mockImplementation(() => {});
+export const mockGetVersionDescription = jest.fn().mockResolvedValue('1.2-3-g12345678-dirty');
+export const mockIsDirty = jest.fn().mockResolvedValue(false);
+export const mockGetTag = jest.fn().mockResolvedValue('v1.0');
+export const mockHasAnyVersionTags = jest.fn().mockResolvedValue(true);
+export const mockGetTotalNumberOfCommits = jest.fn().mockResolvedValue(3);
+export const mockGit = jest.fn().mockImplementation(() => {});
+
+export default {
+  projectPath: mockProjectPath,
+  isDirtyAllowed: mockIsDirtyAllowed,
+  branch: mockBranch,
+  headRef: mockHeadRef,
+  ref: mockRef,
+  determineVersion: mockDetermineVersion,
+  generateSemanticVersion: mockGenerateSemanticVersion,
+  generateTagVersion: mockGenerateTagVersion,
+  parseSemanticVersion: mockParseSemanticVersion,
+  fetch: mockFetch,
+  getVersionDescription: mockGetVersionDescription,
+  isDirty: mockIsDirty,
+  getTag: mockGetTag,
+  hasAnyVersionTags: mockHasAnyVersionTags,
+  getTotalNumberOfCommits: mockGetTotalNumberOfCommits,
+  git: mockGit,
+};

src/model/__snapshots__/versioning.test.js.snap

@@ -0,0 +1,7 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`Versioning determineVersion throws for invalid strategy 0 1`] = `"Versioning strategy should be one of None, Semantic, Tag, Custom."`;
+
+exports[`Versioning determineVersion throws for invalid strategy somethingRandom 1`] = `"Versioning strategy should be one of None, Semantic, Tag, Custom."`;
+
+exports[`Versioning determineVersion throws for invalid strategy undefined 1`] = `"Versioning strategy should be one of None, Semantic, Tag, Custom."`;

src/model/build-parameters.js

@@ -1,26 +1,25 @@
+import Input from './input';
 import Platform from './platform';
+import Versioning from './versioning';
 
 class BuildParameters {
-  static create(parameters) {
+  static async create() {
-    const {
+    const buildFile = this.parseBuildFile(Input.buildName, Input.targetPlatform);
-      unityVersion,
+    const buildVersion = await Versioning.determineVersion(
-      targetPlatform,
+      Input.versioningStrategy,
-      projectPath,
+      Input.specifiedVersion,
-      buildName,
+    );
-      buildsPath,
-      buildMethod,
-      customParameters,
-    } = parameters;
 
     return {
-      version: unityVersion,
+      version: Input.unityVersion,
-      platform: targetPlatform,
+      platform: Input.targetPlatform,
-      projectPath,
+      projectPath: Input.projectPath,
-      buildName,
+      buildName: Input.buildName,
-      buildPath: `${buildsPath}/${targetPlatform}`,
+      buildPath: `${Input.buildsPath}/${Input.targetPlatform}`,
-      buildFile: this.parseBuildFile(buildName, targetPlatform),
+      buildFile,
-      buildMethod,
+      buildMethod: Input.buildMethod,
-      customParameters,
+      buildVersion,
+      customParameters: Input.customParameters,
     };
   }
 

src/model/build-parameters.test.js

@@ -1,84 +1,110 @@
+import Versioning from './versioning';
 import BuildParameters from './build-parameters';
+import Input from './input';
 import Platform from './platform';
 
+const determineVersion = jest
+  .spyOn(Versioning, 'determineVersion')
+  .mockImplementation(() => '1.3.37');
+
+afterEach(() => {
+  jest.clearAllMocks();
+});
+
 describe('BuildParameters', () => {
   describe('create', () => {
-    const someParameters = {
+    it('does not throw', async () => {
-      unityVersion: 'someVersion',
+      await expect(BuildParameters.create()).resolves.not.toThrow();
-      targetPlatform: 'somePlatform',
-      projectPath: 'path/to/project',
-      buildName: 'someBuildName',
-      buildsPath: 'someBuildsPath',
-      buildMethod: 'Namespace.Class.Method',
-      customParameters: '-someParam someValue',
-    };
-
-    it('does not throw', () => {
-      expect(() => BuildParameters.create(someParameters)).not.toThrow();
     });
 
-    it('returns the version', () => {
+    it('determines the version only once', async () => {
-      expect(BuildParameters.create(someParameters).version).toStrictEqual(
+      await BuildParameters.create();
-        someParameters.unityVersion,
+      expect(determineVersion).toHaveBeenCalledTimes(1);
+    });
+
+    it('returns the version', async () => {
+      const mockValue = 'someVersion';
+      jest.spyOn(Input, 'unityVersion', 'get').mockReturnValue(mockValue);
+      await expect(BuildParameters.create()).resolves.toEqual(
+        expect.objectContaining({ version: mockValue }),
       );
     });
 
-    it('returns the platform', () => {
+    it('returns the platform', async () => {
-      expect(BuildParameters.create(someParameters).platform).toStrictEqual(
+      const mockValue = 'somePlatform';
-        someParameters.targetPlatform,
+      jest.spyOn(Input, 'targetPlatform', 'get').mockReturnValue(mockValue);
+      await expect(BuildParameters.create()).resolves.toEqual(
+        expect.objectContaining({ platform: mockValue }),
       );
     });
 
-    it('returns the project path', () => {
+    it('returns the project path', async () => {
-      expect(BuildParameters.create(someParameters).projectPath).toStrictEqual(
+      const mockValue = 'path/to/project';
-        someParameters.projectPath,
+      jest.spyOn(Input, 'projectPath', 'get').mockReturnValue(mockValue);
+      await expect(BuildParameters.create()).resolves.toEqual(
+        expect.objectContaining({ projectPath: mockValue }),
       );
     });
 
-    it('returns the build name', () => {
+    it('returns the build name', async () => {
-      expect(BuildParameters.create(someParameters).buildName).toStrictEqual(
+      const mockValue = 'someBuildName';
-        someParameters.buildName,
+      jest.spyOn(Input, 'buildName', 'get').mockReturnValue(mockValue);
+      await expect(BuildParameters.create()).resolves.toEqual(
+        expect.objectContaining({ buildName: mockValue }),
       );
     });
 
-    it('returns the build path', () => {
+    it('returns the build path', async () => {
-      expect(BuildParameters.create(someParameters).buildPath).toStrictEqual(
+      const mockPath = 'somePath';
-        `${someParameters.buildsPath}/${someParameters.targetPlatform}`,
+      const mockPlatform = 'somePlatform';
+      const expectedBuildPath = `${mockPath}/${mockPlatform}`;
+      jest.spyOn(Input, 'buildsPath', 'get').mockReturnValue(mockPath);
+      jest.spyOn(Input, 'targetPlatform', 'get').mockReturnValue(mockPlatform);
+      await expect(BuildParameters.create()).resolves.toEqual(
+        expect.objectContaining({ buildPath: expectedBuildPath }),
       );
     });
 
-    describe('build file', () => {
+    it('returns the build file', async () => {
-      it('returns the build file', () => {
+      const mockValue = 'someBuildName';
-        expect(BuildParameters.create(someParameters).buildFile).toStrictEqual(
+      jest.spyOn(Input, 'buildName', 'get').mockReturnValue(mockValue);
-          someParameters.buildName,
+      await expect(BuildParameters.create()).resolves.toEqual(
+        expect.objectContaining({ buildFile: mockValue }),
+      );
+    });
+
+    test.each([Platform.types.StandaloneWindows, Platform.types.StandaloneWindows64])(
+      'appends exe for %s',
+      async (targetPlatform) => {
+        jest.spyOn(Input, 'targetPlatform', 'get').mockReturnValue(targetPlatform);
+        jest.spyOn(Input, 'buildName', 'get').mockReturnValue(targetPlatform);
+        await expect(BuildParameters.create()).resolves.toEqual(
+          expect.objectContaining({ buildFile: `${targetPlatform}.exe` }),
         );
-      });
+      },
+    );
 
-      test.each([Platform.types.StandaloneWindows, Platform.types.StandaloneWindows64])(
+    test.each([Platform.types.Android])('appends apk for %s', async (targetPlatform) => {
-        'appends exe for %s',
+      jest.spyOn(Input, 'targetPlatform', 'get').mockReturnValue(targetPlatform);
-        targetPlatform => {
+      jest.spyOn(Input, 'buildName', 'get').mockReturnValue(targetPlatform);
-          expect(
+      await expect(BuildParameters.create()).resolves.toEqual(
-            BuildParameters.create({ ...someParameters, targetPlatform }).buildFile,
+        expect.objectContaining({ buildFile: `${targetPlatform}.apk` }),
-          ).toStrictEqual(`${someParameters.buildName}.exe`);
-        },
-      );
-
-      test.each([Platform.types.Android])('appends apk for %s', targetPlatform => {
-        expect(
-          BuildParameters.create({ ...someParameters, targetPlatform }).buildFile,
-        ).toStrictEqual(`${someParameters.buildName}.apk`);
-      });
-    });
-
-    it('returns the build method', () => {
-      expect(BuildParameters.create(someParameters).buildMethod).toStrictEqual(
-        someParameters.buildMethod,
       );
     });
 
-    it('returns the custom parameters', () => {
+    it('returns the build method', async () => {
-      expect(BuildParameters.create(someParameters).customParameters).toStrictEqual(
+      const mockValue = 'Namespace.ClassName.BuildMethod';
-        someParameters.customParameters,
+      jest.spyOn(Input, 'buildMethod', 'get').mockReturnValue(mockValue);
+      await expect(BuildParameters.create()).resolves.toEqual(
+        expect.objectContaining({ buildMethod: mockValue }),
+      );
+    });
+
+    it('returns the custom parameters', async () => {
+      const mockValue = '-profile SomeProfile -someBoolean -someValue exampleValue';
+      jest.spyOn(Input, 'customParameters', 'get').mockReturnValue(mockValue);
+      await expect(BuildParameters.create()).resolves.toEqual(
+        expect.objectContaining({ customParameters: mockValue }),
       );
     });
   });

src/model/cache.js

@@ -1,3 +1,4 @@
+import * as core from '@actions/core';
 import fs from 'fs';
 import Action from './action';
 import Project from './project';
@@ -14,11 +15,11 @@ class Cache {
       return;
     }
 
-    // eslint-disable-next-line no-console
+    core.warning(`
-    console.log(`
       Library folder does not exist.
-      Consider setting up caching to speed up your workflow
+      Consider setting up caching to speed up your workflow,
-      If this is not your first build.`);
+      if this is not your first build.
+    `);
   }
 }
 

src/model/cache.test.js

@@ -1,5 +1,7 @@
 import Cache from './cache';
 
+jest.mock('./input');
+
 describe('Cache', () => {
   describe('Verification', () => {
     it('does not throw', () => {

src/model/docker.js

@@ -12,7 +12,7 @@ class Docker {
       --build-arg IMAGE=${baseImage} \
       --tag ${tag}`;
 
-    await exec(command, null, { silent });
+    await exec(command, undefined, { silent });
 
     return tag;
   }
@@ -27,6 +27,7 @@ class Docker {
       buildPath,
       buildFile,
       buildMethod,
+      buildVersion,
       customParameters,
     } = parameters;
 
@@ -45,6 +46,7 @@ class Docker {
         --env BUILD_PATH="${buildPath}" \
         --env BUILD_FILE="${buildFile}" \
         --env BUILD_METHOD="${buildMethod}" \
+        --env VERSION="${buildVersion}" \
         --env CUSTOM_PARAMETERS="${customParameters}" \
         --env HOME=/github/home \
         --env GITHUB_REF \
@@ -68,7 +70,7 @@ class Docker {
         --volume "${workspace}":"/github/workspace" \
         ${image}`;
 
-    await exec(command, null, { silent });
+    await exec(command, undefined, { silent });
   }
 }
 

src/model/error/command-execution-error.js

@@ -0,0 +1,8 @@
+class CommandExecutionError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = 'CommandExecutionError';
+  }
+}
+
+export default CommandExecutionError;

src/model/error/command-execution-error.test.js

@@ -0,0 +1,14 @@
+import CommandExecutionError from './command-execution-error';
+
+describe('CommandExecutionError', () => {
+  it('instantiates', () => {
+    expect(() => new CommandExecutionError()).not.toThrow();
+  });
+
+  test.each([1, 'one', { name: '!' }])('Displays title %s', (message) => {
+    const error = new CommandExecutionError(message);
+
+    expect(error.name).toStrictEqual('CommandExecutionError');
+    expect(error.message).toStrictEqual(message.toString());
+  });
+});

src/model/error/not-implemented-exception.js

@@ -0,0 +1,8 @@
+class NotImplementedException extends Error {
+  constructor(message) {
+    super(message);
+    this.name = 'NotImplementedException';
+  }
+}
+
+export default NotImplementedException;

src/model/error/not-implemented-exception.test.js

@@ -0,0 +1,14 @@
+import NotImplementedException from './not-implemented-exception';
+
+describe('NotImplementedException', () => {
+  it('instantiates', () => {
+    expect(() => new NotImplementedException()).not.toThrow();
+  });
+
+  test.each([1, 'one', { name: '!' }])('Displays title %s', (message) => {
+    const error = new NotImplementedException(message);
+
+    expect(error.name).toStrictEqual('NotImplementedException');
+    expect(error.message).toStrictEqual(message.toString());
+  });
+});

src/model/error/validation-error.js

@@ -0,0 +1,8 @@
+class ValidationError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = 'ValidationError';
+  }
+}
+
+export default ValidationError;

src/model/error/validation-error.test.js

@@ -0,0 +1,14 @@
+import ValidationError from './validation-error';
+
+describe('ValidationError', () => {
+  it('instantiates', () => {
+    expect(() => new ValidationError()).not.toThrow();
+  });
+
+  test.each([1, 'one', { name: '!' }])('Displays title %s', (message) => {
+    const error = new ValidationError(message);
+
+    expect(error.name).toStrictEqual('ValidationError');
+    expect(error.message).toStrictEqual(message.toString());
+  });
+});

src/model/image-tag.test.js

@@ -31,16 +31,16 @@ describe('UnityImageVersion', () => {
       expect(image.builderPlatform).toStrictEqual(some.builderPlatform);
     });
 
-    test.each(['2000.0.0f0', '2011.1.11f1'])('accepts %p version format', version => {
+    test.each(['2000.0.0f0', '2011.1.11f1'])('accepts %p version format', (version) => {
       expect(() => new ImageTag({ version, platform: some.platform })).not.toThrow();
     });
 
-    test.each(['some version', '', 1, null])('throws for incorrect versions %p', version => {
+    test.each(['some version', '', 1])('throws for incorrect versions %p', (version) => {
       const { platform } = some;
       expect(() => new ImageTag({ version, platform })).toThrow();
     });
 
-    test.each([undefined, 'nonExisting'])('throws for unsupported target %p', platform => {
+    test.each([undefined, 'nonExisting'])('throws for unsupported target %p', (platform) => {
       expect(() => new ImageTag({ platform })).toThrow();
     });
   });

src/model/index.js

@@ -7,5 +7,17 @@ import ImageTag from './image-tag';
 import Platform from './platform';
 import Project from './project';
 import Unity from './unity';
+import Versioning from './versioning';
 
-export { Action, BuildParameters, Cache, Docker, Input, ImageTag, Platform, Project, Unity };
+export {
+  Action,
+  BuildParameters,
+  Cache,
+  Docker,
+  Input,
+  ImageTag,
+  Platform,
+  Project,
+  Unity,
+  Versioning,
+};

src/model/index.test.js

@@ -6,12 +6,12 @@ describe('Index', () => {
     'BuildParameters',
     'Cache',
     'Docker',
-    'Input',
     'ImageTag',
+    'Input',
     'Platform',
     'Project',
     'Unity',
-  ])('exports %s', exportedModule => {
+  ])('exports %s', (exportedModule) => {
-    expect(typeof Index[exportedModule]).toStrictEqual('function');
+    expect(Index[exportedModule]).toBeEitherAFunctionOrAnObject();
   });
 });

src/model/input.js

@@ -2,30 +2,53 @@ import Platform from './platform';
 
 const core = require('@actions/core');
 
+/**
+ * Input variables specified in workflows using "with" prop.
+ *
+ * Note that input is always passed as a string, even booleans.
+ */
 class Input {
-  static getFromUser() {
+  static get unityVersion() {
-    // Input variables specified in workflows using "with" prop.
+    return core.getInput('unityVersion');
-    const unityVersion = core.getInput('unityVersion');
+  }
-    const targetPlatform = core.getInput('targetPlatform') || Platform.default;
+
+  static get targetPlatform() {
+    return core.getInput('targetPlatform') || Platform.default;
+  }
+
+  static get projectPath() {
     const rawProjectPath = core.getInput('projectPath') || '.';
-    const buildName = core.getInput('buildName') || targetPlatform;
+    return rawProjectPath.replace(/\/$/, '');
-    const buildsPath = core.getInput('buildsPath') || 'build';
+  }
-    const buildMethod = core.getInput('buildMethod'); // processed in docker file
-    const customParameters = core.getInput('customParameters') || '';
 
-    // Sanitise input
+  static get buildName() {
-    const projectPath = rawProjectPath.replace(/\/$/, '');
+    return core.getInput('buildName') || this.targetPlatform;
+  }
 
-    // Return sanitised input
+  static get buildsPath() {
-    return {
+    return core.getInput('buildsPath') || 'build';
-      unityVersion,
+  }
-      targetPlatform,
+
-      projectPath,
+  static get buildMethod() {
-      buildName,
+    return core.getInput('buildMethod'); // processed in docker file
-      buildsPath,
+  }
-      buildMethod,
+
-      customParameters,
+  static get versioningStrategy() {
-    };
+    return core.getInput('versioning') || 'Semantic';
+  }
+
+  static get specifiedVersion() {
+    return core.getInput('version') || '';
+  }
+
+  static get allowDirtyBuild() {
+    const input = core.getInput('allowDirtyBuild') || 'false';
+
+    return input === 'true' ? 'true' : 'false';
+  }
+
+  static get customParameters() {
+    return core.getInput('customParameters') || '';
   }
 }
 

src/model/input.test.js

@@ -1,13 +1,151 @@
+import * as core from '@actions/core';
+
 import Input from './input';
+import Platform from './platform';
+
+afterEach(() => {
+  jest.restoreAllMocks();
+});
 
 describe('Input', () => {
-  describe('getFromUser', () => {
+  describe('unityVersion', () => {
-    it('does not throw', () => {
+    it('returns the default value', () => {
-      expect(() => Input.getFromUser()).not.toThrow();
+      expect(Input.unityVersion).toStrictEqual('');
     });
 
-    it('returns an object', () => {
+    it('takes input from the users workflow', () => {
-      expect(typeof Input.getFromUser()).toStrictEqual('object');
+      const mockValue = '2020.4.99f9';
+      const spy = jest.spyOn(core, 'getInput').mockReturnValue(mockValue);
+      expect(Input.unityVersion).toStrictEqual(mockValue);
+      expect(spy).toHaveBeenCalledTimes(1);
+    });
+  });
+
+  describe('targetPlatform', () => {
+    it('returns the default value', () => {
+      expect(Input.targetPlatform).toStrictEqual(Platform.default);
+    });
+
+    it('takes input from the users workflow', () => {
+      const mockValue = 'Android';
+      const spy = jest.spyOn(core, 'getInput').mockReturnValue(mockValue);
+      expect(Input.targetPlatform).toStrictEqual(mockValue);
+      expect(spy).toHaveBeenCalledTimes(1);
+    });
+  });
+
+  describe('projectPath', () => {
+    it('returns the default value', () => {
+      expect(Input.projectPath).toStrictEqual('.');
+    });
+
+    it('takes input from the users workflow', () => {
+      const mockValue = 'customProjectPath';
+      const spy = jest.spyOn(core, 'getInput').mockReturnValue(mockValue);
+      expect(Input.projectPath).toStrictEqual(mockValue);
+      expect(spy).toHaveBeenCalledTimes(1);
+    });
+  });
+
+  describe('buildName', () => {
+    it('returns the default value', () => {
+      expect(Input.buildName).toStrictEqual(Input.targetPlatform);
+    });
+
+    it('takes input from the users workflow', () => {
+      const mockValue = 'Build';
+      const spy = jest.spyOn(core, 'getInput').mockReturnValue(mockValue);
+      expect(Input.buildName).toStrictEqual(mockValue);
+      expect(spy).toHaveBeenCalledTimes(1);
+    });
+
+    it('takes special characters as input', () => {
+      const mockValue = '1ßúëld2';
+      jest.spyOn(core, 'getInput').mockReturnValue(mockValue);
+      expect(Input.buildName).toStrictEqual(mockValue);
+    });
+  });
+
+  describe('buildsPath', () => {
+    it('returns the default value', () => {
+      expect(Input.buildsPath).toStrictEqual('build');
+    });
+
+    it('takes input from the users workflow', () => {
+      const mockValue = 'customBuildsPath';
+      const spy = jest.spyOn(core, 'getInput').mockReturnValue(mockValue);
+      expect(Input.buildsPath).toStrictEqual(mockValue);
+      expect(spy).toHaveBeenCalledTimes(1);
+    });
+  });
+
+  describe('buildMethod', () => {
+    it('returns the default value', () => {
+      expect(Input.buildMethod).toStrictEqual('');
+    });
+
+    it('takes input from the users workflow', () => {
+      const mockValue = 'Namespace.ClassName.Method';
+      const spy = jest.spyOn(core, 'getInput').mockReturnValue(mockValue);
+      expect(Input.buildMethod).toStrictEqual(mockValue);
+      expect(spy).toHaveBeenCalledTimes(1);
+    });
+  });
+
+  describe('versioningStrategy', () => {
+    it('returns the default value', () => {
+      expect(Input.versioningStrategy).toStrictEqual('Semantic');
+    });
+
+    it('takes input from the users workflow', () => {
+      const mockValue = 'Anything';
+      const spy = jest.spyOn(core, 'getInput').mockReturnValue(mockValue);
+      expect(Input.versioningStrategy).toStrictEqual(mockValue);
+      expect(spy).toHaveBeenCalledTimes(1);
+    });
+  });
+
+  describe('specifiedVersion', () => {
+    it('returns the default value', () => {
+      expect(Input.specifiedVersion).toStrictEqual('');
+    });
+
+    it('takes input from the users workflow', () => {
+      const mockValue = '1.33.7';
+      const spy = jest.spyOn(core, 'getInput').mockReturnValue(mockValue);
+      expect(Input.specifiedVersion).toStrictEqual(mockValue);
+      expect(spy).toHaveBeenCalledTimes(1);
+    });
+  });
+
+  describe('allowDirtyBuild', () => {
+    it('returns the default value', () => {
+      expect(Input.allowDirtyBuild).toStrictEqual('false');
+    });
+
+    it('returns true when string true is passed', () => {
+      const spy = jest.spyOn(core, 'getInput').mockReturnValue('true');
+      expect(Input.allowDirtyBuild).toStrictEqual('true');
+      expect(spy).toHaveBeenCalledTimes(1);
+    });
+
+    it('returns false when string false is passed', () => {
+      const spy = jest.spyOn(core, 'getInput').mockReturnValue('false');
+      expect(Input.allowDirtyBuild).toStrictEqual('false');
+      expect(spy).toHaveBeenCalledTimes(1);
+    });
+  });
+
+  describe('customParameters', () => {
+    it('returns the default value', () => {
+      expect(Input.customParameters).toStrictEqual('');
+    });
+
+    it('takes input from the users workflow', () => {
+      const mockValue = '-imAFlag';
+      const spy = jest.spyOn(core, 'getInput').mockReturnValue(mockValue);
+      expect(Input.customParameters).toStrictEqual(mockValue);
+      expect(spy).toHaveBeenCalledTimes(1);
     });
   });
 });

src/model/project.js

@@ -1,10 +1,10 @@
-import Unity from './unity';
 import Input from './input';
+import Unity from './unity';
 import Action from './action';
 
 class Project {
   static get relativePath() {
-    const { projectPath } = Input.getFromUser();
+    const { projectPath } = Input;
 
     return `${projectPath}`;
   }

src/model/project.test.js

@@ -1,5 +1,7 @@
 import Project from './project';
 
+jest.mock('./input');
+
 describe('Platform', () => {
   describe('relativePath', () => {
     it('does not throw', () => {

src/model/system.js

@@ -0,0 +1,62 @@
+import * as core from '@actions/core';
+import { exec } from '@actions/exec';
+
+class System {
+  static async run(command, arguments_, options) {
+    let result = '';
+    let error = '';
+    let debug = '';
+
+    const listeners = {
+      stdout: (dataBuffer) => {
+        result += dataBuffer.toString();
+      },
+      stderr: (dataBuffer) => {
+        error += dataBuffer.toString();
+      },
+      debug: (dataString) => {
+        debug += dataString.toString();
+      },
+    };
+
+    const showOutput = () => {
+      if (debug !== '') {
+        core.debug(debug);
+      }
+
+      if (result !== '') {
+        core.info(result);
+      }
+
+      if (error !== '') {
+        core.warning(error);
+      }
+    };
+
+    const throwContextualError = (message) => {
+      let commandAsString = command;
+      if (Array.isArray(arguments_)) {
+        commandAsString += ` ${arguments_.join(' ')}`;
+      } else if (typeof arguments_ === 'string') {
+        commandAsString += ` ${arguments_}`;
+      }
+
+      throw new Error(`Failed to run "${commandAsString}".\n ${message}`);
+    };
+
+    try {
+      const exitCode = await exec(command, arguments_, { silent: true, listeners, ...options });
+      showOutput();
+      if (exitCode !== 0) {
+        throwContextualError(`Command returned non-zero exit code.\nError: ${error}`);
+      }
+    } catch (inCommandError) {
+      showOutput();
+      throwContextualError(`In-command error caught: ${inCommandError}`);
+    }
+
+    return result;
+  }
+}
+
+export default System;

src/model/system.test.js

@@ -0,0 +1,56 @@
+import * as core from '@actions/core';
+import System from './system';
+
+jest.spyOn(core, 'debug').mockImplementation(() => {});
+const info = jest.spyOn(core, 'info').mockImplementation(() => {});
+jest.spyOn(core, 'warning').mockImplementation(() => {});
+jest.spyOn(core, 'error').mockImplementation(() => {});
+
+afterEach(() => {
+  jest.clearAllMocks();
+});
+
+describe('System', () => {
+  describe('run', () => {
+    it('runs a command successfully', async () => {
+      await expect(System.run('true')).resolves.not.toBeNull();
+    });
+
+    it('outputs results', async () => {
+      await expect(System.run('echo test')).resolves.toStrictEqual('test\n');
+    });
+
+    it('throws on when error code is not 0', async () => {
+      await expect(System.run('false')).rejects.toThrowError();
+    });
+
+    it('throws when no arguments are given', async () => {
+      await expect(System.run()).rejects.toThrowError();
+    });
+
+    it('outputs info', async () => {
+      await expect(System.run('echo test')).resolves.not.toBeNull();
+      expect(info).toHaveBeenLastCalledWith('test\n');
+    });
+
+    it('outputs info only once', async () => {
+      await expect(System.run('echo 1')).resolves.not.toBeNull();
+      expect(info).toHaveBeenCalledTimes(1);
+      expect(info).toHaveBeenLastCalledWith('1\n');
+
+      info.mockClear();
+      await expect(System.run('echo 2')).resolves.not.toBeNull();
+      await expect(System.run('echo 3')).resolves.not.toBeNull();
+      expect(info).toHaveBeenCalledTimes(2);
+      expect(info).toHaveBeenLastCalledWith('3\n');
+    });
+
+    it('allows pipes using buffer', async () => {
+      await expect(
+        System.run('sh', undefined, {
+          input: Buffer.from('git tag --list --merged HEAD | grep v[0-9]* | wc -l'),
+        }),
+      ).resolves.toBeParsableToANumber();
+    });
+  });
+});

src/model/versioning.js

@@ -0,0 +1,220 @@
+import * as core from '@actions/core';
+import NotImplementedException from './error/not-implemented-exception';
+import ValidationError from './error/validation-error';
+import Input from './input';
+import System from './system';
+
+export default class Versioning {
+  static get projectPath() {
+    return Input.projectPath;
+  }
+
+  static get isDirtyAllowed() {
+    return Input.allowDirtyBuild === 'true';
+  }
+
+  static get strategies() {
+    return { None: 'None', Semantic: 'Semantic', Tag: 'Tag', Custom: 'Custom' };
+  }
+
+  /**
+   * Get the branch name of the (related) branch
+   */
+  static get branch() {
+    // Todo - use optional chaining (https://github.com/zeit/ncc/issues/534)
+    return this.headRef || (this.ref && this.ref.slice(11));
+  }
+
+  /**
+   * For pull requests we can reliably use GITHUB_HEAD_REF
+   */
+  static get headRef() {
+    return process.env.GITHUB_HEAD_REF;
+  }
+
+  /**
+   * For branches GITHUB_REF will have format `refs/heads/feature-branch-1`
+   */
+  static get ref() {
+    return process.env.GITHUB_REF;
+  }
+
+  /**
+   * Regex to parse version description into separate fields
+   */
+  static get descriptionRegex() {
+    return /^v([\d.]+)-(\d+)-g(\w+)-?(\w+)*/g;
+  }
+
+  static async determineVersion(strategy, inputVersion) {
+    // Validate input
+    if (!Object.hasOwnProperty.call(this.strategies, strategy)) {
+      throw new ValidationError(
+        `Versioning strategy should be one of ${Object.values(this.strategies).join(', ')}.`,
+      );
+    }
+
+    let version;
+    switch (strategy) {
+      case this.strategies.None:
+        version = 'none';
+        break;
+      case this.strategies.Custom:
+        version = inputVersion;
+        break;
+      case this.strategies.Semantic:
+        version = await this.generateSemanticVersion();
+        break;
+      case this.strategies.Tag:
+        version = await this.generateTagVersion();
+        break;
+      default:
+        throw new NotImplementedException(`Strategy ${strategy} is not implemented.`);
+    }
+
+    return version;
+  }
+
+  /**
+   * Automatically generates a version based on SemVer out of the box.
+   *
+   * The version works as follows: `<major>.<minor>.<patch>` for example `0.1.2`.
+   *
+   * The latest tag dictates `<major>.<minor>`
+   * The number of commits since that tag dictates`<patch>`.
+   *
+   * @See: https://semver.org/
+   */
+  static async generateSemanticVersion() {
+    await this.fetch();
+
+    if ((await this.isDirty()) && !this.isDirtyAllowed) {
+      throw new Error('Branch is dirty. Refusing to base semantic version on uncommitted changes');
+    }
+
+    if (!(await this.hasAnyVersionTags())) {
+      const version = `0.0.${await this.getTotalNumberOfCommits()}`;
+      core.info(`Generated version ${version} (no version tags found).`);
+      return version;
+    }
+
+    const { tag, commits, hash } = await this.parseSemanticVersion();
+    core.info(`Found semantic version ${tag}.${commits} for ${this.branch}@${hash}`);
+
+    return `${tag}.${commits}`;
+  }
+
+  /**
+   * Generate the proper version for unity based on an existing tag.
+   */
+  static async generateTagVersion() {
+    let tag = await this.getTag();
+
+    if (tag.charAt(0) === 'v') {
+      tag = tag.slice(1);
+    }
+
+    return tag;
+  }
+
+  /**
+   * Parses the versionDescription into their named parts.
+   */
+  static async parseSemanticVersion() {
+    const description = await this.getVersionDescription();
+
+    try {
+      const [match, tag, commits, hash] = this.descriptionRegex.exec(description);
+
+      return {
+        match,
+        tag,
+        commits,
+        hash,
+      };
+    } catch (error) {
+      throw new Error(`Failed to parse git describe output: "${description}".`);
+    }
+  }
+
+  /**
+   * Retrieves refs from the configured remote.
+   *
+   * Fetch unshallow for incomplete repository, but fall back to normal fetch.
+   *
+   * Note: `--all` should not be used, and would break fetching for push event.
+   */
+  static async fetch() {
+    try {
+      await this.git(['fetch', '--unshallow']);
+    } catch (error) {
+      core.warning(`Fetch --unshallow caught: ${error}`);
+      await this.git(['fetch']);
+    }
+  }
+
+  /**
+   * Retrieves information about the branch.
+   *
+   * Format: `v0.12-24-gd2198ab`
+   *
+   * In this format v0.12 is the latest tag, 24 are the number of commits since, and gd2198ab
+   * identifies the current commit.
+   */
+  static async getVersionDescription() {
+    const commitIsh = (await this.getTag()) ? 'HEAD' : `origin/${this.branch}`;
+    return this.git(['describe', '--long', '--tags', '--always', '--debug', commitIsh]);
+  }
+
+  /**
+   * Returns whether there are uncommitted changes that are not ignored.
+   */
+  static async isDirty() {
+    const output = await this.git(['status', '--porcelain']);
+
+    return output !== '';
+  }
+
+  /**
+   * Get the tag if there is one pointing at HEAD
+   */
+  static async getTag() {
+    return this.git(['tag', '--points-at', 'HEAD']);
+  }
+
+  /**
+   * Whether or not the repository has any version tags yet.
+   */
+  static async hasAnyVersionTags() {
+    const numberOfCommitsAsString = await System.run('sh', undefined, {
+      input: Buffer.from('git tag --list --merged HEAD | grep v[0-9]* | wc -l'),
+      silent: false,
+    });
+
+    const numberOfCommits = Number.parseInt(numberOfCommitsAsString, 10);
+
+    return numberOfCommits !== 0;
+  }
+
+  /**
+   * Get the total number of commits on head.
+   *
+   * Note: HEAD should not be used, as it may be detached, resulting in an additional count.
+   */
+  static async getTotalNumberOfCommits() {
+    const numberOfCommitsAsString = await this.git([
+      'rev-list',
+      '--count',
+      `origin/${this.branch}`,
+    ]);
+
+    return Number.parseInt(numberOfCommitsAsString, 10);
+  }
+
+  /**
+   * Run git in the specified project path
+   */
+  static async git(arguments_, options = {}) {
+    return System.run('git', arguments_, { cwd: this.projectPath, ...options });
+  }
+}

src/model/versioning.test.js

@@ -0,0 +1,317 @@
+import * as core from '@actions/core';
+import NotImplementedException from './error/not-implemented-exception';
+import System from './system';
+import Versioning from './versioning';
+
+afterEach(() => {
+  jest.restoreAllMocks();
+});
+
+describe('Versioning', () => {
+  describe('strategies', () => {
+    it('returns an object', () => {
+      expect(typeof Versioning.strategies).toStrictEqual('object');
+    });
+
+    it('has items', () => {
+      expect(Object.values(Versioning.strategies).length).toBeGreaterThan(2);
+    });
+
+    it('has an opt out option', () => {
+      expect(Versioning.strategies).toHaveProperty('None');
+    });
+
+    it('has the semantic option', () => {
+      expect(Versioning.strategies).toHaveProperty('Semantic');
+    });
+
+    it('has a strategy for tags', () => {
+      expect(Versioning.strategies).toHaveProperty('Tag');
+    });
+
+    it('has an option that allows custom input', () => {
+      expect(Versioning.strategies).toHaveProperty('Custom');
+    });
+  });
+
+  describe('branch', () => {
+    it('returns headRef when set', () => {
+      const headReference = jest
+        .spyOn(Versioning, 'headRef', 'get')
+        .mockReturnValue('feature-branch-1');
+
+      expect(Versioning.branch).toStrictEqual('feature-branch-1');
+      expect(headReference).toHaveBeenCalledTimes(1);
+    });
+
+    it('returns part of Ref when set', () => {
+      jest.spyOn(Versioning, 'headRef', 'get').mockReturnValue(undefined);
+      const reference = jest
+        .spyOn(Versioning, 'ref', 'get')
+        .mockReturnValue('refs/heads/feature-branch-2');
+
+      expect(Versioning.branch).toStrictEqual('feature-branch-2');
+      expect(reference).toHaveBeenCalledTimes(2);
+    });
+
+    it('prefers headRef over ref when set', () => {
+      const headReference = jest
+        .spyOn(Versioning, 'headRef', 'get')
+        .mockReturnValue('feature-branch-1');
+      const reference = jest
+        .spyOn(Versioning, 'ref', 'get')
+        .mockReturnValue('refs/heads/feature-2');
+
+      expect(Versioning.branch).toStrictEqual('feature-branch-1');
+      expect(headReference).toHaveBeenCalledTimes(1);
+      expect(reference).toHaveBeenCalledTimes(0);
+    });
+
+    it('returns undefined when headRef and ref are not set', () => {
+      const headReference = jest.spyOn(Versioning, 'headRef', 'get').mockReturnValue(undefined);
+      const reference = jest.spyOn(Versioning, 'ref', 'get').mockReturnValue(undefined);
+
+      expect(Versioning.branch).not.toBeDefined();
+
+      expect(headReference).toHaveBeenCalledTimes(1);
+      expect(reference).toHaveBeenCalledTimes(1);
+    });
+  });
+
+  describe('headRef', () => {
+    it('does not throw', () => {
+      expect(() => Versioning.headRef).not.toThrow();
+    });
+  });
+
+  describe('ref', () => {
+    it('does not throw', () => {
+      expect(() => Versioning.ref).not.toThrow();
+    });
+  });
+
+  describe('isDirtyAllowed', () => {
+    it('does not throw', () => {
+      expect(() => Versioning.isDirtyAllowed).not.toThrow();
+    });
+
+    it('returns false by default', () => {
+      expect(Versioning.isDirtyAllowed).toStrictEqual(false);
+    });
+  });
+
+  describe('descriptionRegex', () => {
+    it('is a valid regex', () => {
+      expect(Versioning.descriptionRegex).toBeInstanceOf(RegExp);
+    });
+
+    test.each(['v1.1-1-g12345678', 'v0.1-2-g12345678', 'v0.0-500-gA9B6C3D0-dirty'])(
+      'is happy with valid %s',
+      (description) => {
+        expect(Versioning.descriptionRegex.test(description)).toBeTruthy();
+      },
+    );
+
+    test.each([undefined, 'v0', 'v0.1', 'v0.1.2', 'v0.1-2', 'v0.1-2-g'])(
+      'does not like %s',
+      (description) => {
+        expect(Versioning.descriptionRegex.test(description)).toBeFalsy();
+        // Also never expect without the v to work for any of these cases.
+        expect(Versioning.descriptionRegex.test(description?.substr(1))).toBeFalsy();
+      },
+    );
+  });
+
+  describe('determineVersion', () => {
+    test.each([undefined, 0, 'somethingRandom'])(
+      'throws for invalid strategy %s',
+      async (strategy) => {
+        await expect(Versioning.determineVersion(strategy)).rejects.toThrowErrorMatchingSnapshot();
+      },
+    );
+
+    describe('opt out strategy', () => {
+      it("returns 'none'", async () => {
+        await expect(Versioning.determineVersion('None', 'v1.0')).resolves.toMatchInlineSnapshot(
+          `"none"`,
+        );
+      });
+    });
+
+    describe('custom strategy', () => {
+      test.each([undefined, 0, 'v0.1', '1', 'CamelCase', 'dashed-version'])(
+        'returns the inputVersion for %s',
+        async (inputVersion) => {
+          await expect(Versioning.determineVersion('Custom', inputVersion)).resolves.toStrictEqual(
+            inputVersion,
+          );
+        },
+      );
+    });
+
+    describe('semantic strategy', () => {
+      it('refers to generateSemanticVersion', async () => {
+        const generateSemanticVersion = jest
+          .spyOn(Versioning, 'generateSemanticVersion')
+          .mockResolvedValue('1.3.37');
+
+        await expect(Versioning.determineVersion('Semantic')).resolves.toStrictEqual('1.3.37');
+        expect(generateSemanticVersion).toHaveBeenCalledTimes(1);
+      });
+    });
+
+    describe('tag strategy', () => {
+      it('refers to generateTagVersion', async () => {
+        const generateTagVersion = jest
+          .spyOn(Versioning, 'generateTagVersion')
+          .mockResolvedValue('0.1');
+
+        await expect(Versioning.determineVersion('Tag')).resolves.toStrictEqual('0.1');
+        expect(generateTagVersion).toHaveBeenCalledTimes(1);
+      });
+    });
+
+    describe('not implemented strategy', () => {
+      it('throws a not implemented exception', async () => {
+        const strategy = 'Test';
+        jest.spyOn(Versioning, 'strategies', 'get').mockReturnValue({ [strategy]: strategy });
+        await expect(Versioning.determineVersion(strategy)).rejects.toThrowError(
+          NotImplementedException,
+        );
+      });
+    });
+  });
+
+  describe('generateTagVersion', () => {
+    it('removes the v', async () => {
+      jest.spyOn(Versioning, 'getTag').mockResolvedValue('v1.3.37');
+      await expect(Versioning.generateTagVersion()).resolves.toStrictEqual('1.3.37');
+    });
+  });
+
+  describe('parseSemanticVersion', () => {
+    it('returns the named parts', async () => {
+      jest.spyOn(Versioning, 'getVersionDescription').mockResolvedValue('v0.1-2-g12345678');
+
+      await expect(Versioning.parseSemanticVersion()).resolves.toMatchObject({
+        tag: '0.1',
+        commits: '2',
+        hash: '12345678',
+      });
+    });
+
+    it('throws when no match could be made', async () => {
+      jest.spyOn(Versioning, 'getVersionDescription').mockResolvedValue('no-match-can-be-made');
+
+      await expect(Versioning.parseSemanticVersion()).rejects.toThrowErrorMatchingInlineSnapshot(
+        `"Failed to parse git describe output: \\"no-match-can-be-made\\"."`,
+      );
+    });
+  });
+
+  describe('getVersionDescription', () => {
+    it('returns the commands output', async () => {
+      const runOutput = 'someValue';
+      jest.spyOn(System, 'run').mockResolvedValue(runOutput);
+      await expect(Versioning.getVersionDescription()).resolves.toStrictEqual(runOutput);
+    });
+  });
+
+  describe('fetch', () => {
+    it('awaits the command', async () => {
+      jest.spyOn(core, 'warning').mockImplementation(() => {});
+      jest.spyOn(System, 'run').mockResolvedValue(undefined);
+      await expect(Versioning.fetch()).resolves.not.toThrow();
+    });
+
+    it('falls back to the second strategy when the first fails', async () => {
+      jest.spyOn(core, 'warning').mockImplementation(() => {});
+      const gitFetch = jest
+        .spyOn(System, 'run')
+        .mockResolvedValue(undefined)
+        .mockRejectedValueOnce(undefined);
+
+      await expect(Versioning.fetch()).resolves.not.toThrow();
+      expect(gitFetch).toHaveBeenCalledTimes(2);
+    });
+  });
+
+  describe('generateSemanticVersion', () => {
+    it('returns a proper version from description', async () => {
+      jest.spyOn(System, 'run').mockResolvedValue(undefined);
+      jest.spyOn(core, 'info').mockImplementation(() => {});
+      jest.spyOn(Versioning, 'isDirty').mockResolvedValue(false);
+      jest.spyOn(Versioning, 'hasAnyVersionTags').mockResolvedValue(true);
+      jest.spyOn(Versioning, 'getTotalNumberOfCommits').mockResolvedValue(2);
+      jest.spyOn(Versioning, 'parseSemanticVersion').mockResolvedValue({
+        match: '0.1-2-g1b345678',
+        tag: '0.1',
+        commits: '2',
+        hash: '1b345678',
+      });
+
+      await expect(Versioning.generateSemanticVersion()).resolves.toStrictEqual('0.1.2');
+    });
+
+    it('throws when dirty', async () => {
+      jest.spyOn(System, 'run').mockResolvedValue(undefined);
+      jest.spyOn(core, 'info').mockImplementation(() => {});
+      jest.spyOn(Versioning, 'isDirty').mockResolvedValue(true);
+      await expect(Versioning.generateSemanticVersion()).rejects.toThrowError();
+    });
+
+    it('falls back to commits only, when no tags are present', async () => {
+      const commits = Math.round(Math.random() * 10);
+      jest.spyOn(System, 'run').mockResolvedValue(undefined);
+      jest.spyOn(core, 'info').mockImplementation(() => {});
+      jest.spyOn(Versioning, 'isDirty').mockResolvedValue(false);
+      jest.spyOn(Versioning, 'hasAnyVersionTags').mockResolvedValue(false);
+      jest.spyOn(Versioning, 'getTotalNumberOfCommits').mockResolvedValue(commits);
+
+      await expect(Versioning.generateSemanticVersion()).resolves.toStrictEqual(`0.0.${commits}`);
+    });
+  });
+
+  describe('isDirty', () => {
+    it('returns true when there are files listed', async () => {
+      const runOutput = 'file.ext\nfile2.ext';
+      jest.spyOn(System, 'run').mockResolvedValue(runOutput);
+      await expect(Versioning.isDirty()).resolves.toStrictEqual(true);
+    });
+
+    it('returns false when there is no output', async () => {
+      const runOutput = '';
+      jest.spyOn(System, 'run').mockResolvedValue(runOutput);
+      await expect(Versioning.isDirty()).resolves.toStrictEqual(false);
+    });
+  });
+
+  describe('getTag', () => {
+    it('returns the commands output', async () => {
+      const runOutput = 'v1.0';
+      jest.spyOn(System, 'run').mockResolvedValue(runOutput);
+      await expect(Versioning.getTag()).resolves.toStrictEqual(runOutput);
+    });
+  });
+
+  describe('hasAnyVersionTags', () => {
+    it('returns false when the command returns 0', async () => {
+      const runOutput = '0';
+      jest.spyOn(System, 'run').mockResolvedValue(runOutput);
+      await expect(Versioning.hasAnyVersionTags()).resolves.toStrictEqual(false);
+    });
+
+    it('returns true when the command returns >= 0', async () => {
+      const runOutput = '9';
+      jest.spyOn(System, 'run').mockResolvedValue(runOutput);
+      await expect(Versioning.hasAnyVersionTags()).resolves.toStrictEqual(true);
+    });
+  });
+
+  describe('getTotalNumberOfCommits', () => {
+    it('returns a number from the command', async () => {
+      jest.spyOn(System, 'run').mockResolvedValue('9');
+      await expect(Versioning.getTotalNumberOfCommits()).resolves.toStrictEqual(9);
+    });
+  });
+});