Merge pull request #454 from DannyBen/add/unique-repeatable-flag

Add support for `unique` in repeatable flag args

Author: DannyBen

examples/render-mandoc/README.md

@@ -102,7 +102,7 @@ ISSUE TRACKER
 AUTHORS
        Lana Lang.
 
-Version 0.1.0                    November 2023                     download(1)
+Version 0.1.0                    December 2023                     download(1)
 
 
 ````

examples/render-mandoc/docs/download.1

@@ -1,60 +1,35 @@
-.\" Automatically generated by Pandoc 3.1.6
+.\" Automatically generated by Pandoc 3.1.9
 .\"
-.\" Define V font for inline verbatim, using C font in formats
-.\" that render this, and otherwise B font.
-.ie "\f[CB]x\f[]"x" \{\
-. ftr V B
-. ftr VI BI
-. ftr VB B
-. ftr VBI BI
-.\}
-.el \{\
-. ftr V CR
-. ftr VI CI
-. ftr VB CB
-. ftr VBI CBI
-.\}
 .TH "download" "1" "December 2023" "Version 0.1.0" "Sample application"
-.hy
 .SH NAME
-.PP
 \f[B]download\f[R] - Sample application
 .SH SYNOPSIS
-.PP
 \f[B]download\f[R] SOURCE [TARGET...]
 OPTIONS
 .SH DESCRIPTION
-.PP
 Sample application
 .SH ARGUMENTS
 .SS SOURCE
-.PP
 Source to download from
 .IP \[bu] 2
 \f[I]Required\f[R]
 .IP \[bu] 2
 Allowed Values: \f[B]server1, server2\f[R]
 .SS TARGET
-.PP
 Target filename (default: same as source)
 .IP \[bu] 2
 \f[I]Repeatable\f[R]
 .SH OPTIONS
 .SS --force, -f
-.PP
 Overwrite existing files
 .SS --debug, -d
-.PP
 Show debug information
 .SH DEPENDENCIES
 .SS aws-cli
-.PP
 Download from <https://aws.amazon.com/cli/>
 .SH SEE ALSO
-.PP
 \f[B]docker\f[R](1), \f[B]docker-compose.yml\f[R](5)
 .SH ISSUE TRACKER
-.PP
 Report issues at <https://github.com/lanalang/smallville>
 .SH AUTHORS
 Lana Lang.

examples/repeatable-flag/README.md

@@ -36,6 +36,15 @@ flags:
   # needs to be converted to an array with `eval "data=(${args[--data]})"`
   repeatable: true
 
+- long: --path
+  short: -p
+  arg: location
+  help: Specify one or more paths
+  repeatable: true
+
+  # Setting this to true will ignore repeating arguments that are not unique
+  unique: true
+
 - long: --verbose
   short: -v
   help: Set verbosity level
@@ -47,6 +56,7 @@ flags:
 
 examples:
 - download -d one -d "two three" -vvv
+- download -d one -p /usr/bin -p /tmp
 ````
 
 ## `src/root_command.sh`
@@ -61,7 +71,7 @@ for i in "${data[@]}"; do
 done
 
 # The --verbose arg will contain the number of times it was used by the user
-verbose=${args[--verbose]}
+verbose=${args[--verbose]:-1}
 echo ""
 echo "Verbosity level: $verbose"
 echo ""
@@ -87,6 +97,9 @@ Options:
   --data, -d DATA (required) (repeatable)
     Provide data values
 
+  --path, -p LOCATION (repeatable)
+    Specify one or more paths
+
   --verbose, -v (repeatable)
     Set verbosity level
 
@@ -98,6 +111,7 @@ Options:
 
 Examples:
   download -d one -d "two three" -vvv
+  download -d one -p /usr/bin -p /tmp
 
 
 
@@ -119,5 +133,20 @@ args:
 
 ````
 
+### `$ ./download -d one --path /bin --path /usr/lib --path /bin`
+
+````shell
+Data elements:
+one
+
+Verbosity level: 1
+
+args:
+- ${args[--data]} = "one"
+- ${args[--path]} = "/bin" "/usr/lib"
+
+
+````
+
 
 

examples/repeatable-flag/src/bashly.yml

@@ -15,6 +15,15 @@ flags:
   # needs to be converted to an array with `eval "data=(${args[--data]})"`
   repeatable: true
 
+- long: --path
+  short: -p
+  arg: location
+  help: Specify one or more paths
+  repeatable: true
+
+  # Setting this to true will ignore repeating arguments that are not unique
+  unique: true
+
 - long: --verbose
   short: -v
   help: Set verbosity level
@@ -26,4 +35,4 @@ flags:
 
 examples:
 - download -d one -d "two three" -vvv
-
+- download -d one -p /usr/bin -p /tmp

examples/repeatable-flag/src/root_command.sh

@@ -7,7 +7,7 @@ for i in "${data[@]}"; do
 done
 
 # The --verbose arg will contain the number of times it was used by the user
-verbose=${args[--verbose]}
+verbose=${args[--verbose]:-1}
 echo ""
 echo "Verbosity level: $verbose"
 echo ""

examples/repeatable-flag/test.sh

@@ -8,3 +8,4 @@ bashly generate
 
 ./download -h
 ./download -d one -d "two three" -vvv
+./download -d one --path /bin --path /usr/lib --path /bin

lib/bashly/config_validator.rb

@@ -118,6 +118,7 @@ def assert_flag(key, value)
 
       assert_boolean "#{key}.private", value['private']
       assert_boolean "#{key}.repeatable", value['repeatable']
+      assert_boolean "#{key}.unique", value['unique']
       assert_boolean "#{key}.required", value['required']
       assert_array "#{key}.allowed", value['allowed'], of: :string
       assert_array "#{key}.conflicts", value['conflicts'], of: :string
@@ -140,6 +141,11 @@ def assert_flag(key, value)
       if value['completions']
         assert value['arg'], "#{key}.completions does not make sense without nub`arg`"
       end
+
+      if value['unique']
+        condition = value['arg'] && value['repeatable']
+        assert condition, "#{key}.unique does not make sense without nub`arg` and nub`repeatable`"
+      end
     end
 
     def assert_env_var(key, value)

lib/bashly/docs/flag.yml

@@ -162,6 +162,17 @@ flag.short:
       arg: name
       help: Repository user name
 
+flag.unique:
+  help: Specify that the arguments provided by this repeatable flag must be unique. When this is set to `true`, non-unique values will be ignored.
+  url: https://bashly.dannyb.co/configuration/flag/#unique
+  example: |-
+    flags:
+    - long: --path
+      arg: location
+      help: Set one or more paths
+      repeatable: true
+      unique: true
+
 flag.validate:
   help: Apply custom validation functions. Must be accompanied by `arg`.
 

lib/bashly/script/flag.rb

@@ -7,7 +7,7 @@ class << self
         def option_keys
           @option_keys ||= %i[
             allowed arg completions conflicts default help long repeatable
-            required short validate private
+            required short unique validate private
           ]
         end
       end

lib/bashly/views/flag/case_arg.gtx

@@ -6,8 +6,12 @@
 if repeatable
   >   if [[ -z ${args['{{ name }}']+x} ]]; then
   >     args['{{ name }}']="\"$2\""
-  >   else
-  >     args['{{ name }}']="${args[{{ name }}]} \"$2\""
+  if unique
+    >   elif [[ ! "${args['{{ name }}']}" =~ \"$2\" ]]; then
+  else
+    >   else
+  end
+  >     args['{{ name }}']="${args['{{ name }}']} \"$2\""
   >   fi
 
 else