stringslice-support

still messy and will break some stuff (most works fine though)

- not implicit, but rather by using ActionMultiParts
- added bash-completion to containers as it is needed to split compline
without default wordbreaks
- ActionMultiParts now returns Action
- added Suffix/Prefix to alter actions for ActionMultiParts
- Action now contains rawValues and the custom shell code is now invoked
using functions
- removed specific shell snippet functions and only left Snippet(shell)
- removed custom functions as they now reside in rsteube/carapace-bin
- ActionMessage now defaults to ActionValuesDescribed as only zsh has
specific support for this and it better fits the rawValues approach
- bash completion now has descriptions (https://stackoverflow.com/a/10130007)
- introduced Candidate struct for better representation of completion
candidates
- removed zsh specific snippet tests
- completion for values within quotes is probably broken for now

Dockerfile.bash

@@ -1,7 +1,11 @@
 FROM golang
 
+RUN apt-get update \
+ && apt-get install -y bash-completion
+
 RUN echo "\n\
 PS1=$'\e[0;36mcarapace \e[0m'\n\
+source /usr/share/bash-completion/bash_completion \n\
 source <(example _carapace bash)" \
        > /root/.bashrc
 

Dockerfile.oil

@@ -1,7 +1,7 @@
 FROM golang
 
 RUN apt-get update \
- && apt install -y build-essential libreadline-dev
+ && apt install -y build-essential libreadline-dev bash-completion
 
 RUN curl https://www.oilshell.org/download/oil-0.8.0.tar.gz | tar -xvz \
  && cd oil-*/ \
@@ -12,6 +12,7 @@ RUN curl https://www.oilshell.org/download/oil-0.8.0.tar.gz | tar -xvz \
 RUN mkdir -p ~/.config/oil \
  && echo "\n\
 PS1=$'\e[0;36mcarapace \e[0m'\n\
+source /usr/share/bash-completion/bash_completion \n\
 source <(example _carapace bash)" \
        > ~/.config/oil/oshrc
 

README.md

@@ -66,7 +66,7 @@ Uids are generated to identify corresponding completions:
 
 
 ## Action
-An [action](#action) indicates how to complete a flag or a positional argument. See [action.go](./action.go) and the examples below for current implementations.
+An [action](#action) indicates how to complete a flag or a positional argument. See [action.go](./action.go) and the examples below for current implementations. A range of custom actions can be found at [rsteube/carapace-bin](https://github.com/rsteube/carapace-bin/tree/master/actions)
 
 ### ActionMessage
 
@@ -135,32 +135,24 @@ Since callbacks are simply invocations of the program they can be tested directl
 
 ### ActionMultiParts
 
-> This is an initial version which still got some quirks, expect some changes here (in the long term this shall return Action as well)
-
 ActionMultiParts is a [callback action](#actioncallback) where parts of an argument can be completed separately (e.g. user:group from [chown](https://github.com/rsteube/carapace-completers/blob/master/completers/chown_completer/cmd/root.go)). 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).
 
 ```go
-carapace.ActionMultiParts(":", func(args []string, parts []string) []string {
-	switch len(parts) {
-	case 0:
-		return []{"user1:", "user2:", "user3:"}
-	case 1:
-		return []{"groupA", "groupB", "groupC"}
-	default:
-		return []string{}
-	}
-})
+func ActionUserGroup() carapace.Action {
+	return carapace.ActionMultiParts(":", func(args []string, parts []string) carapace.Action {
+		switch len(parts) {
+		case 0:
+			return ActionUsers().Suffix(":", args)
+		case 1:
+			return ActionGroups()
+		default:
+			return carapace.ActionValues()
+		}
+	})
+}
 ```
 
-### Custom Action
-
-For [actions](#action) that aren't implemented or missing required options, a custom action can be defined.
-
-```go
-carapace.Action{Zsh: "_most_recent_file 2"}
-
-// #./example action --custom <TAB>
-```
+### Shell Completion Documentation
 
 Additional information can be found at:
 - Bash: [bash-programmable-completion-tutorial](https://iridakos.com/programming/2018/03/01/bash-programmable-completion-tutorial) and [Programmable-Completion-Builtins](https://www.gnu.org/software/bash/manual/html_node/Programmable-Completion-Builtins.html#Programmable-Completion-Builtins)