feat: added support for dirty files

docs/reference/config.md

@@ -145,6 +145,17 @@ commitAuthor:
 commitMessage: "chore(release): this is a custom release message"
 ```
 
+## DirtyFiles
+```{ .yaml .annotate linenums="1" }
+# Allowing specific case sensitive files to allow using uplift to
+# add unedited but changed files as part of your CI
+
+git:
+    dirtyFiles:
+        - file.txt
+        - path/to/file.txt
+```
+
 ## hooks
 
 ```{ .yaml .annotate linenums="1" }
@@ -242,6 +253,14 @@ git:
     - option: ci.variable="MAX_RETRIES=10"
       skipTag: true
       skipBranch: false
+
+  # Defines a list of files that uplift will ignore when checking the 
+  # status of the current repository. If a change is detected that is 
+  # not defined in this list, uplift will assume its default behaviour 
+  # and fail due to the repository being in a dirty state
+  dirtyFiles:
+    - file.txt
+    - path/to/file.txt
 ```
 
 ## gitea

docs/static/schema.json

@@ -217,6 +217,14 @@
           },
           "type": "array",
           "minItems": 1
+        },
+        "dirtyFiles": {
+          "items": {
+            "$comment": "https://upliftci.dev/reference/config#git",
+            "description": "Defines a list of files that uplift will ignore when checking the status of the current repository. If a change is detected that is not defined in this list, uplift will assume its default behaviour and fail due to the repository being in a dirty state"
+          },
+          "type": "array",
+          "minItems": 1
         }
       },
       "type": "object",

internal/config/uplift.go

@@ -94,6 +94,7 @@ type Git struct {
 	IgnoreDetached bool            `yaml:"ignoreDetached"`
 	IgnoreShallow  bool            `yaml:"ignoreShallow"`
 	PushOptions    []GitPushOption `yaml:"pushOptions" validate:"dive"`
+	DirtyFiles     []string        `yaml:"dirtyFiles" validate:"omitempty,dive,min=1,file"`
 }
 
 // GitPushOption provides a way of supplying additional options to

internal/context/context.go

@@ -38,6 +38,7 @@ type Context struct {
 	CommitDetails            git.CommitDetails
 	Config                   config.Uplift
 	CurrentVersion           semver.Version
+	DirtyFiles               []string
 	DryRun                   bool
 	Debug                    bool
 	FetchTags                bool
@@ -107,5 +108,15 @@ func New(cfg config.Uplift, out io.Writer) *Context {
 		SCM: SCM{
 			Provider: Unrecognised,
 		},
+		DirtyFiles: DirtyFiles(cfg),
 	}
 }
+
+// For nil safe object getting
+func DirtyFiles(c config.Uplift) []string {
+	if c.Git == nil {
+		return nil
+	}
+
+	return c.Git.DirtyFiles
+}

internal/task/gitcheck/check.go

@@ -23,8 +23,6 @@ SOFTWARE.
 package gitcheck
 
 import (
-	"strings"
-
 	"github.com/apex/log"
 	"github.com/gembaadvantage/uplift/internal/context"
 )
@@ -52,18 +50,22 @@ func (t Task) Run(ctx *context.Context) error {
 
 	log.Debug("checking if repository is dirty")
 	status, err := ctx.GitClient.PorcelainStatus()
+
 	if err != nil {
 		return err
 	}
 
 	if len(status) > 0 {
-		// Convert status into string friendly output
-		out := make([]string, 0, len(status))
-		for _, s := range status {
-			out = append(out, s.String())
+
+		if len(ctx.DirtyFiles) == 0 {
+			return ErrDirty{status}
 		}
 
-		return ErrDirty{status: strings.Join(out, "\n")}
+		for _, sts := range status {
+			if !stringInSlice(sts.Path, ctx.DirtyFiles) {
+				return ErrDirty{status}
+			}
+		}
 	}
 
 	log.Debug("checking for detached head")
@@ -86,3 +88,12 @@ func (t Task) Run(ctx *context.Context) error {
 
 	return nil
 }
+
+func stringInSlice(stringToFind string, listOfStrings []string) bool {
+	for _, value := range listOfStrings {
+		if value == stringToFind {
+			return true
+		}
+	}
+	return false
+}

internal/task/gitcheck/check_test.go

@@ -124,9 +124,18 @@ func TestRun_Dirty(t *testing.T) {
 
 	err := Task{}.Run(&context.Context{})
 	assert.EqualError(t, err, `uplift cannot reliably run if the repository is in a dirty state. Changes detected:
-?? testing.go
+[?? testing.go]
 
 Please check and resolve the status of these files before retrying. For further
 details visit: https://upliftci.dev/faq/gitdirty
 `)
 }
+
+func TestRun_DirtyWithConfiguredFiles(t *testing.T) {
+	gittest.InitRepository(t, gittest.WithFiles("testing.go"))
+
+	err := Task{}.Run(&context.Context{
+		DirtyFiles: []string{"testing.go"},
+	})
+	assert.NoError(t, err)
+}

internal/task/gitcheck/errors.go

@@ -25,11 +25,13 @@ package gitcheck
 import (
 	"errors"
 	"fmt"
+
+	git "github.com/purpleclay/gitz"
 )
 
 // ErrDirty is raised when a git repository has un-committed and/or un-staged changes
 type ErrDirty struct {
-	status string
+	status []git.FileStatus
 }
 
 // Error returns a formatted message of the current error