feat: implement task sorting with --sort flag (#1105)

* refactor: move deepcopy into its own package

* feat: add generic orderedmap implementation

* refactor: implement tasks with orderedmap

* feat: implement sort flag for all task outputs

* refactor: implement vars with orderedmap

* chore: docs

* fix: linting issues

* fix: non deterministic behavior in tests

taskfile/tasks.go

@@ -4,40 +4,49 @@ import (
 	"fmt"
 
 	"gopkg.in/yaml.v3"
+
+	"github.com/go-task/task/v3/internal/orderedmap"
 )
 
 // Tasks represents a group of tasks
-type Tasks map[string]*Task
+type Tasks struct {
+	orderedmap.OrderedMap[string, *Task]
+}
 
 func (t *Tasks) UnmarshalYAML(node *yaml.Node) error {
 	switch node.Kind {
 	case yaml.MappingNode:
-		tasks := map[string]*Task{}
-		if err := node.Decode(tasks); err != nil {
+		tasks := orderedmap.New[string, *Task]()
+		if err := node.Decode(&tasks); err != nil {
 			return err
 		}
 
-		for name := range tasks {
+		// nolint: errcheck
+		tasks.Range(func(name string, task *Task) error {
 			// Set the task's name
-			if tasks[name] == nil {
-				tasks[name] = &Task{
+			if task == nil {
+				task = &Task{
 					Task: name,
 				}
 			}
-			tasks[name].Task = name
+			task.Task = name
 
 			// Set the task's location
 			for _, keys := range node.Content {
 				if keys.Value == name {
-					tasks[name].Location = &Location{
+					task.Location = &Location{
 						Line:   keys.Line,
 						Column: keys.Column,
 					}
 				}
 			}
-		}
+			tasks.Set(name, task)
+			return nil
+		})
 
-		*t = Tasks(tasks)
+		*t = Tasks{
+			OrderedMap: tasks,
+		}
 		return nil
 	}