update argfile example

Author: DannyBen

examples/argfile/.download

@@ -1,2 +1,14 @@
+# Boolean flags in the argfile are loaded as defaults
 --force
+
+# Flag values must appear on the same line
 --log "some path with spaces.log"
+
+# Arguments in argfile also work for repeatable flags
+--header "x-from-file: 1"
+
+# Unknown flags in the argfile are ignored
+--no-such-flag
+
+# Non-flag lines in the argfile are ignored
+this line is ignored

examples/argfile/README.md

@@ -39,22 +39,46 @@ flags:
   short: -l
   arg: path
   help: Path to log file
+
+# Arguments in argfile also work for repeatable flags
+- long: --header
+  short: -H
+  arg: value
+  repeatable: true
+  help: Add an HTTP header
 ````
 
 ## `.download`
 
 ````bash
+# Boolean flags in the argfile are loaded as defaults
 --force
+
+# Flag values must appear on the same line
 --log "some path with spaces.log"
 
-````
+# Arguments in argfile also work for repeatable flags
+--header "x-from-file: 1"
 
-Only flag lines are loaded from the argfile. Each flag value must appear on the
-same line as the flag. Non-flag lines are ignored.
+# Unknown flags in the argfile are ignored
+--no-such-flag
+
+# Non-flag lines in the argfile are ignored
+this line is ignored
+
+````
 
 
 ## Output
 
+### `$ ./download --version`
+
+````shell
+0.1.0
+
+
+````
+
 ### `$ ./download somesource`
 
 ````shell
@@ -64,24 +88,30 @@ same line as the flag. Non-flag lines are ignored.
 # Feel free to edit this file; your changes will persist when regenerating.
 args:
 - ${args[--force]} = 1
+- ${args[--header]} = x-from-file:\ 1
 - ${args[--log]} = some path with spaces.log
 - ${args[source]} = somesource
 
 
 ````
 
-### `$ ./download --help`
+### `$ ./download somesource --log cli.log`
 
 ````shell
-download - Sample application with autoloaded arguments
+# This file is located at 'src/root_command.sh'.
+# It contains the implementation for the 'download' command.
+# The code you write here will be wrapped by a function named 'root_command()'.
+# Feel free to edit this file; your changes will persist when regenerating.
+args:
+- ${args[--force]} = 1
+- ${args[--header]} = x-from-file:\ 1
+- ${args[--log]} = cli.log
+- ${args[source]} = somesource
+
 
-Usage:
-  download SOURCE [OPTIONS]
-  download --help | -h
-  download --version | -v
 ````
 
-### `$ ./download somesource --log cli.log`
+### `$ ./download somesource --header "x-from-cli: 2"`
 
 ````shell
 # This file is located at 'src/root_command.sh'.
@@ -90,10 +120,12 @@ Usage:
 # Feel free to edit this file; your changes will persist when regenerating.
 args:
 - ${args[--force]} = 1
-- ${args[--log]} = cli.log
+- ${args[--header]} = x-from-file:\ 1 x-from-cli:\ 2
+- ${args[--log]} = some path with spaces.log
 - ${args[source]} = somesource
 
 
 ````
 
 
+

examples/argfile/src/bashly.yml

@@ -2,7 +2,7 @@ name: download
 help: Sample application with autoloaded arguments
 version: 0.1.0
 
-# Allow users to configure args and flags in a file named '.download'
+# Allow users to configure flag defaults in a file named '.download'
 argfile: .download
 
 args:
@@ -18,3 +18,10 @@ flags:
   short: -l
   arg: path
   help: Path to log file
+
+# Arguments in argfile also work for repeatable flags
+- long: --header
+  short: -H
+  arg: value
+  repeatable: true
+  help: Add an HTTP header

examples/argfile/test.sh

@@ -8,5 +8,7 @@ bashly generate
 
 ### Try Me ###
 
+./download --version
 ./download somesource
 ./download somesource --log cli.log
+./download somesource --header "x-from-cli: 2"

spec/approvals/examples/argfile

@@ -3,13 +3,16 @@ creating user files in src
 skipped src/root_command.sh (exists)
 created ./download
 run ./download --help to test your bash script
++ ./download --version
+0.1.0
 + ./download somesource
 # This file is located at 'src/root_command.sh'.
 # It contains the implementation for the 'download' command.
 # The code you write here will be wrapped by a function named 'root_command()'.
 # Feel free to edit this file; your changes will persist when regenerating.
 args:
 - ${args[--force]} = 1
+- ${args[--header]} = x-from-file:\ 1
 - ${args[--log]} = some path with spaces.log
 - ${args[source]} = somesource
 + ./download somesource --log cli.log
@@ -19,5 +22,16 @@ args:
 # Feel free to edit this file; your changes will persist when regenerating.
 args:
 - ${args[--force]} = 1
+- ${args[--header]} = x-from-file:\ 1
 - ${args[--log]} = cli.log
 - ${args[source]} = somesource
++ ./download somesource --header 'x-from-cli: 2'
+# This file is located at 'src/root_command.sh'.
+# It contains the implementation for the 'download' command.
+# The code you write here will be wrapped by a function named 'root_command()'.
+# Feel free to edit this file; your changes will persist when regenerating.
+args:
+- ${args[--force]} = 1
+- ${args[--header]} = x-from-file:\ 1 x-from-cli:\ 2
+- ${args[--log]} = some path with spaces.log
+- ${args[source]} = somesource