tmp

docs/src/SUMMARY.md

@@ -22,6 +22,7 @@
   - [Action](./carapace/action.md)
     - [Custom](./carapace/action/custom.md)
     - [Chdir](./carapace/action/chDir.md)
+    - [NoSpace](./carapace/action/noSpace.md)
     - [Suppress](./carapace/action/suppress.md)
     - [Style](./carapace/action/style.md)
     - [Tag](./carapace/action/tag.md)

docs/src/carapace/action/noSpace.md

@@ -0,0 +1 @@
+# NoSpace

docs/src/carapace/defaultActions/actionMultiParts.md

@@ -1,22 +1,27 @@
 # ActionMultiParts
 
-[`ActionMultiParts`] is a [callback action](./actionCallback.md) where parts of an argument can be completed separately (e.g. `user:group` from chown). Divider can be empty as well, but note that bash and fish will add the space suffix for anything other than `/=@:.,` (it still works, but after each selection backspace is needed to continue the completion).
+[`ActionMultiParts`] completes parts of an argument separately (e.g. `user:group` from chown).
+For this the `Context.CallbackValue` is split with given divider and then updated to only contain the currently completed part.
+`Context.Parts` contains the preceding parts and can be used in a `switch` statement to return the corresponding [Action](../action.md).
+
+> An empty divider splits per character, but be aware that fish will add space suffix for anything other than `/=@:.,`.
 
 ```go
 carapace.ActionMultiParts(":", func(c carapace.Context) carapace.Action {
-	switch len(parts) {
+	switch len(c.Parts) {
 	case 0:
-		return ActionUsers().Invoke(c).Suffix(":").ToA()
+		return carapace.ActionValues("userA", "UserB").Invoke(c).Suffix(":").ToA()
 	case 1:
-		return ActionGroups()
+		return carapace.ActionValues("groupA", "groupB")
 	default:
 		return carapace.ActionValues()
 	}
 })
 ```
 
-- values **must not** contain the separator as a simple `strings.Split()` is used to separate the parts
-- it is however **allowed as suffix** to enable fluent tab completion (like `/` for a directory)
+- Values **must not** contain the separator as a simple `strings.Split()` is used to separate the parts.
+- It is however **allowed as suffix** to enable fluent tab completion (like `/` for a directory).
+- If no suffix is added [`NoSpace`] can be used in the preceding parts to prevent a space suffix.
 
 ## Nesting
 
@@ -35,11 +40,11 @@ carapace.ActionMultiParts(",", func(cEntries carapace.Context) carapace.Action {
 		case 1:
 			switch c.Parts[0] {
 			case "FILE":
-				return carapace.ActionFiles("")
+				return carapace.ActionFiles("").NoSpace()
 			case "DIRECTORY":
-				return carapace.ActionDirectories()
+				return carapace.ActionDirectories().NoSpace()
 			case "VALUE":
-				return carapace.ActionValues("one", "two", "three")
+				return carapace.ActionValues("one", "two", "three").NoSpace()
 			default:
 				return carapace.ActionValues()
 
@@ -53,3 +58,4 @@ carapace.ActionMultiParts(",", func(cEntries carapace.Context) carapace.Action {
 
 [`carapace.CallbackValue`]:https://pkg.go.dev/github.com/rsteube/carapace#pkg-variables
 [`ActionMultiParts`]:https://pkg.go.dev/github.com/rsteube/carapace#ActionMultiParts
+[`NoSpace`]:../action/noSpace.md

example/cmd/action.go

@@ -31,6 +31,8 @@ func init() {
 	actionCmd.Flags().String("files", "", "ActionFiles()")
 	actionCmd.Flags().String("files-filtered", "", "ActionFiles(\".md\", \"go.mod\", \"go.sum\")")
 	actionCmd.Flags().String("message", "", "ActionMessage()")
+	actionCmd.Flags().String("multiparts", "", "ActionMultiParts()")
+	actionCmd.Flags().String("multiparts-nested", "", "ActionMultiParts(...ActionMultiParts...)")
 	actionCmd.Flags().String("styled-values", "", "ActionStyledValues()")
 	actionCmd.Flags().String("styled-values-described", "", "ActionStyledValuesDescribed()")
 	actionCmd.Flags().String("values", "", "ActionValues()")
@@ -47,6 +49,42 @@ func init() {
 		"files":          carapace.ActionFiles(),
 		"files-filtered": carapace.ActionFiles(".md", "go.mod", "go.sum"),
 		"message":        carapace.ActionMessage("example message"),
+		"multiparts": carapace.ActionMultiParts(":", func(c carapace.Context) carapace.Action {
+			switch len(c.Parts) {
+			case 0:
+				return carapace.ActionValues("userA", "UserB").Invoke(c).Suffix(":").ToA()
+			case 1:
+				return carapace.ActionValues("groupA", "groupB")
+			default:
+				return carapace.ActionValues()
+			}
+		}),
+		"multiparts-nested": carapace.ActionMultiParts(",", func(cEntries carapace.Context) carapace.Action {
+			return carapace.ActionMultiParts("=", func(c carapace.Context) carapace.Action {
+				switch len(c.Parts) {
+				case 0:
+					keys := make([]string, len(cEntries.Parts))
+					for index, entry := range cEntries.Parts {
+						keys[index] = strings.Split(entry, "=")[0]
+					}
+					return carapace.ActionValues("FILE", "DIRECTORY", "VALUE").Invoke(c).Filter(keys).Suffix("=").ToA()
+				case 1:
+					switch c.Parts[0] {
+					case "FILE":
+						return carapace.ActionFiles("").NoSpace()
+					case "DIRECTORY":
+						return carapace.ActionDirectories().NoSpace()
+					case "VALUE":
+						return carapace.ActionValues("one", "two", "three").NoSpace()
+					default:
+						return carapace.ActionValues()
+
+					}
+				default:
+					return carapace.ActionValues()
+				}
+			})
+		}),
 		"styled-values": carapace.ActionStyledValues(
 			"first", style.Default,
 			"second", style.Blue,