bashly 0.9.1 → 0.9.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e1139c7453fff329c05879511103b80b6a89a76896a9d0cb3f5cad016d224b15
-  data.tar.gz: acda8a068081a04a32218be7ddfee8cad1612b3dfafd9e1465170fd9cded32db
+  metadata.gz: 310bcfcf9a37601cdf37bd37f81c96fc8e33e4e38e601a4d496a2b8fed20e319
+  data.tar.gz: 72c4644b4051c9a290192c4d497bdcb80c8bdc5d473fe3c7bb01c40209f62a3d
 SHA512:
-  metadata.gz: 61247ecd7b928a4babdbf307004424ffa060c567a16b4eb4b062c59e51eb9812f3469981ead958bb4f08aee8cb7ecd86a32a830f6102211012540eac0b878fd4
-  data.tar.gz: 606e5df99d98e9853ed25a7fd516a807a90f1c40d7f19ac2ab1b8f3388a82919dd59af3b291d8de7b866d88cdcb8b1fec7883bd258b80c04f137b1729e58aca1
+  metadata.gz: 8b655051b58edb3182e022405484e006ef1ac6a7a0815fe6be77f38cbe57a5f9bf90adfa45be713719d718221451f9ab88087e4253fb7356651ff03f7ddc5b61
+  data.tar.gz: 992d1f15fdb7649375b2c1f8f09054b73dc7aef92c7e980995b7fd4c28671b42c9635078617ff10bba81a49836852b53151ef5559b53a55cf7070197a5937a01

data/README.md

@@ -27,7 +27,6 @@ usually handled by a framework in any other programming language.
 It is available both as a [ruby gem](https://rubygems.org/gems/bashly) and as
 a [docker image](https://hub.docker.com/r/dannyben/bashly).
 
-
 ## Documentation
 
 - [Bashly Homepage][docs]
@@ -49,6 +48,7 @@ a [docker image](https://hub.docker.com/r/dannyben/bashly).
 Bashly is responsible for:
 
 - Generating a **single, standalone bash script**.
+- Generating a **human readable, shellcheck-compliant and shfmt-compliant script**.
 - Generating **usage texts** and help screens, showing your tool's arguments, flags and commands (works for sub-commands also).
 - Parsing the user's command line and extracting:
   - Optional or required **positional arguments**.
@@ -72,15 +72,12 @@ to contribute, feel free to [open an issue][issues] or
 
 Visit the *[How to contribute][contributing]* page for more information.
 
-
 ## Stargazers and Forkers
 
 [![Stargazers repo roster for @DannyBen/bashly](https://reporoster.com/stars/DannyBen/bashly)](https://github.com/DannyBen/bashly/stargazers)
 
 [![Forkers repo roster for @DannyBen/bashly](https://reporoster.com/forks/DannyBen/bashly)](https://github.com/DannyBen/bashly/network/members)
 
-
-
 [issues]: https://github.com/DannyBen/bashly/issues
 [discussions]: https://github.com/DannyBen/bashly/discussions
 [docs]: https://bashly.dannyb.co/

data/lib/bashly/cli.rb

@@ -14,6 +14,7 @@ module Bashly
       runner.route 'validate',  to: Commands::Validate
       runner.route 'generate',  to: Commands::Generate
       runner.route 'add',       to: Commands::Add
+      runner.route 'doc',       to: Commands::Doc
 
       runner
     end

data/lib/bashly/commands/doc.rb

@@ -0,0 +1,90 @@
+module Bashly
+  module Commands
+    class Doc < Base
+      summary 'Show bashly reference documentation'
+      help 'This command displays bite-sized help for all the bashly configuration options in the terminal.'
+
+      usage 'bashly doc [SEARCH] [--index]'
+      usage 'bashly doc (-h|--help)'
+
+      option '-i --index', 'Show option keys only'
+      param 'SEARCH', 'Search for options that match this text'
+
+      example 'bashly doc command'
+      example 'bashly doc command.flags'
+      example 'bashly doc flag. -i'
+      example 'bashly doc catch_all'
+
+      def run
+        if args['--index']
+          puts data.keys
+        else
+          show
+        end
+      end
+
+    private
+
+      def show
+        data.each do |key, info|
+          show_key key
+          show_help info['help']
+          show_example info['example'] if info['example']
+          show_url info['url'] if info['url']
+        end
+      end
+
+      def show_key(key)
+        say "!txtgrn!#{key}"
+        say ''
+      end
+
+      def show_url(url)
+        say "  See !undblu!#{url}"
+        say ''
+      end
+
+      def show_example(example)
+        example = word_wrap "    #{example}"
+        example.gsub!(/^(\s*- )?(\s*\w+):/, '\1!txtblu!\2!txtrst!:')
+        example.gsub!(/^(\s*- )/, '!txtylw!\1!txtrst!')
+        example.gsub!(/^(\s*#.+)/, '!txtpur!\1!txtrst!')
+        say example
+        say ''
+      end
+
+      def show_help(help)
+        help = word_wrap "  #{help}"
+        help.gsub!(/`([^`]+)`/, '!txtgrn!\1!txtrst!')
+        say help
+        say ''
+      end
+
+      def data
+        return raw_data unless args['SEARCH']
+
+        result = raw_data.select { |k, _v| k.== args['SEARCH'] }
+        return result if result.any?
+
+        result = raw_data.select { |k, _v| k.include? args['SEARCH'] }
+        return result if result.any?
+
+        raise Error, "No match"
+      end
+
+      def raw_data
+        @raw_data ||= begin
+          result = {}
+          Dir["#{docs_dir}/*.yml"].sort.each do |path|
+            result.merge! YAML.load_file(path)
+          end
+          result
+        end
+      end
+
+      def docs_dir
+        @docs_dir ||= File.expand_path '../docs', __dir__
+      end
+    end
+  end
+end

data/lib/bashly/docs/arg.yml

@@ -0,0 +1,94 @@
+arg:
+  help: Define positional arguments.
+  url: https://bashly.dannyb.co/configuration/argument/
+  example: |-
+    args:
+    - name: user
+      help: AWS Username.
+      required: true
+
+    - name: role
+      help: User role.
+      default: admin
+      allowed:
+      - admin
+      - guest
+
+arg.allowed:
+  help: Specify a list of allowed values. Can be used in conjunction with `default` and `required`.
+  url: https://bashly.dannyb.co/configuration/argument/#allowed
+  example: |-
+    args:
+    - name: region
+      help: Region to connect to
+      
+      # allowed + required
+      allowed: [eu, us]
+      required: true
+
+    - name: environment
+      help: Environment to connect to
+      
+      # allowed + default
+      allowed: [stage, production, development]
+      default: development
+
+arg.default:
+  help: Specify the value to apply when not provided by the user.
+  url: https://bashly.dannyb.co/configuration/argument/#default
+  example: |-
+    args:
+    - name: images
+      help: Image files to convert.
+      default: "*.jpg"
+
+arg.help:
+  help: Specify the help message for this argument.
+  url: https://bashly.dannyb.co/configuration/argument/#help
+  example: |-
+    args:
+    - name: user
+      help: AWS Username.
+      required: true
+
+arg.name:
+  help: Specify the lowercase name of the argument.
+  url: https://bashly.dannyb.co/configuration/argument/#name
+  example: |-
+    args:
+    - name: user
+      help: AWS Username.
+      required: true
+
+arg.repeatable:
+  help: |-
+    Specify that this argument can be provided multiple times.
+
+    The argument below will be received as a space-delimited string which needs to be converted to an array with:
+    `eval "data=(${args[file]})"`
+
+  url: https://bashly.dannyb.co/configuration/argument/#repeatable
+  example: |-
+    args:
+    - name: file
+      help: One or more files to process
+      required: true
+      repeatable: true
+
+arg.required:
+  help: Specify that this argument is required.
+  url: https://bashly.dannyb.co/configuration/argument/#required
+  example: |-
+    args:
+    - name: region
+      help: Region to connect to
+      required: true
+
+arg.validate:
+  help: Apply custom validation functions.
+
+  url: https://bashly.dannyb.co/configuration/argument/#validate
+  example: |-
+    args:
+    - name: path
+      validate: file_exists

data/lib/bashly/docs/command.yml

@@ -0,0 +1,310 @@
+command:
+  help: Define the root command, or any sub-command.
+  url: https://bashly.dannyb.co/configuration/command/
+  example: |-
+    name: rush
+    help: Personal package manager
+    version: 0.6.5
+
+    commands:
+    - name: add
+      alias: a
+      help: Register a local repository
+      args:
+      - name: repo
+        required: true
+        help: Repository name.
+
+command.alias:
+  help: Specify one or more aliases for this sub-command.
+  url: https://bashly.dannyb.co/configuration/command/#alias
+  example: |-
+    # Define a single alias
+    command:
+      name: download
+      alias: d
+
+    # Define multiple aliases
+    command:
+      name: download
+      alias: [d, pull]
+
+    # Run this command with anything that starts with 's'.
+    command:
+      name: server
+      alias: s*
+
+command.args:
+  help: Define a list of positional arguments. See `arg` for reference.
+  url: https://bashly.dannyb.co/configuration/command/#args
+  example: |-
+    args:
+    - name: repo
+      required: true
+      help: Repository name.
+
+command.catch_all:
+  help: Specify that this command should allow for additional arbitrary arguments or flags.
+  url: https://bashly.dannyb.co/configuration/command/#catch_all
+  example: |-
+    commands:
+    - name: download
+      help: Download one or more URLs
+      
+      # Set to 'true' to simply enable this option
+      catch_all: true
+
+    - name: upload
+      help: Upload one or more files
+
+      # Use this extended syntax in order to also provide a usage label
+      # for these arguments, as well as specifying that at least one is
+      # required.
+      catch_all:
+        label: Files
+        help: Files to upload
+        required: true
+
+command.commands:
+  help: Define a list of sub-commands. See `command` for reference.
+  url: https://bashly.dannyb.co/configuration/command/#commands
+  example: |-
+    commands:
+    - name: add
+      alias: a
+      help: Register a local repository
+
+command.completions:
+  help: Specify a list of additional completion suggestions when used in conjunction with `bashly add comp`.
+  url: https://bashly.dannyb.co/configuration/command/#completions
+  example: |-
+    commands:
+    - name: view
+      help: View a directory, system user or a git branch
+      completions:
+      - <directory>
+      - <user>
+      - $(git branch 2> /dev/null)
+
+command.default:
+  help: Specify that this sub-command will be executed implicitly.
+  url: https://bashly.dannyb.co/configuration/command/#default
+  example: |-
+    # This command will execute when the command line is not
+    # recognized.
+    commands:
+    - name: upload
+      help: Upload a file
+      default: true
+
+    # This command will execute when the command line is not
+    # recognized, or when it is empty.
+    commands:
+    - name: all
+      help: Run all tests
+      default: force
+
+command.dependencies:
+  help: Specify a list of required external commands that are needed to run this command.
+  url: https://bashly.dannyb.co/configuration/command/#dependencies
+  example: |-
+    # Array syntax
+    dependencies:
+    - docker
+    - curl
+
+    # Hash syntax, to provide additional help message
+    dependencies:
+      docker: see https://docker.com for installation instructions
+      git: "install by running: sudo apt install git"
+  
+command.environment_variables:
+  help: Define a list of environment variables. See `environment_variable` for reference.
+  url: https://bashly.dannyb.co/configuration/command/#environment_variables
+  example: |-
+    environment_variables:
+    - name: config_path
+      help: Location of the config file
+      default: ~/config.ini
+    - name: api_key
+      help: Your API key
+      required: true
+
+command.examples:
+  help: Define one or more example messages. 
+  url: https://bashly.dannyb.co/configuration/command/#examples
+  example: |-
+    # Use an array of examples for simple one-liners.
+    examples:
+    - cli download example.com
+    - cli download example.com ./output -f
+
+    # Use a multi-line string when you need more control.
+    # Note the use of the '|-' marker that tells YAML to use the
+    # string as is, including the newlines it contains.
+    examples: |-
+      Upload a file
+      $ cli upload profile.png -u admin -p s3cr3t
+
+      Upload a file (you will be prompted to provide a password)
+      $ cli upload profile.png --user admin
+
+command.expose:
+  help: Specify that the sub-commands of this command should be visible when showing the usage of its parent.
+  url: https://bashly.dannyb.co/configuration/command/#expose
+  example: |-
+    name: cli
+    commands:
+    - name: config
+      help: Config management commands
+
+      # Set to 'true' to show both 'config edit' and 'config show' when
+      # running 'cli --help'
+      expose: true
+      commands:
+      - name: edit
+        help: Edit config file
+      - name: show
+        help: Show config file
+
+    - name: server
+      help: Server management commands
+      
+      # Set to 'always' to also show the usage of the sub-commands when
+      # running 'cli' without arguments.
+      expose: always
+
+      commands:
+      - name: start
+        help: Start the server
+      - name: stop
+        help: Stop the server
+
+command.extensible:
+  help: Specify that this command can be extended by external means.
+  url: https://bashly.dannyb.co/configuration/command/#extensible
+  example: |-
+    name: mygit
+    help: Wrapper for git
+    version: 0.1.0
+
+    # Set to 'true' to allow extending it by creating executables in the
+    # path named 'mygit-*'.
+    extensible: true
+
+    # Set to another executable name to delegate all unknown commands
+    # to it.
+    extensible: git
+
+command.filename:
+  help: Specify the path (relative to src) to the partial source code file.
+  url: https://bashly.dannyb.co/configuration/command/#filename
+  example: |-
+    commands:
+    - name: connect
+      help: Connect to server
+      filename: admin_commands/list.sh
+
+command.filters:
+  help: Specify a list of custom filter functions that will prevent the command from running unless certain conditions are met.
+  url: https://bashly.dannyb.co/configuration/command/#filters
+  example: |-
+    commands:
+    - name: container
+      help: Perform actions on a docker container
+
+      # When the command is executed, your script will look for a function
+      # named 'filter_docker_running' and execute it. If it prints a string,
+      # it will be considered an error and the command execution will be
+      # halted.
+      filters:
+      - docker_running
+
+    # Example function (put somewhere in src/lib)
+    filter_docker_running() {
+      docker info >/dev/null 2>&1 || echo "Docker must be running"
+    }
+
+command.flags:
+  help: Define a list of option flags. See `flag` for reference.
+  url: https://bashly.dannyb.co/configuration/command/#flags
+  example: |-
+    flags:
+    - long: --purge
+      short: -p
+      help: Also remove the local directory.
+
+command.footer:
+  help: Specify a message to show at the bottom of the help text.
+  url: https://bashly.dannyb.co/configuration/command/#footer
+  example: |-
+    footer: For further help visit https://my.docs-site.com
+
+command.function:
+  help: Specify a different base function name for this command.
+  url: https://bashly.dannyb.co/configuration/command/#function
+  example: |-
+    commands:
+    - name: container-start
+      help: Start a new container (deprecated)
+
+      # Override the name of the internal functions bashly uses. This is
+      # needed in this case since the command 'container-start' and the
+      # nested command 'container start' will have the same underlying
+      # function name otherwise.
+      function: deprecated_container_start
+      footer: This command is deprecated, use 'container start' instead
+
+    - name: container
+      help: Container commands
+      commands:
+      - name: start
+        help: Start a new container
+
+command.group:
+  help: Specify the group that this command belongs to.
+  url: https://bashly.dannyb.co/configuration/command/#group
+  example: |-
+    command:
+      name: start
+      help: Start the server
+      group: Server
+
+command.help:
+  help: Specify the help text to show when displaying usage.
+  url: https://bashly.dannyb.co/configuration/command/#help
+  example: |-
+    name: docker
+    help: Runtime for containers
+
+    commands:
+    - name: images
+      help: Manage images
+
+command.name:
+  help: Specify the name of the command. This option is required.
+  url: https://bashly.dannyb.co/configuration/command/#name
+  example: |-
+    name: docker
+    help: Runtime for containers
+
+    commands:
+    - name: images
+      help: Manage images
+
+command.private:
+  help: Specify that this command should not be displayed in the help text.
+  url: https://bashly.dannyb.co/configuration/command/#private
+  example: |-
+    commands:
+    - name: completions
+      help: Send bash completions
+      private: true
+
+command.version:
+  help: Specify the version to show when running with `--version`.
+  url: https://bashly.dannyb.co/configuration/command/#version
+  example: |-
+    name: rush
+    help: Personal package manager
+    version: 0.6.5

data/lib/bashly/docs/env.yml

@@ -0,0 +1,54 @@
+environment_variable:
+  help: Define environment variables that will be in use in your script.
+  url: https://bashly.dannyb.co/configuration/environment-variable/
+  example: |-
+    environment_variables:
+    - name: config_path
+      help: Location of the config file
+      default: ~/config.ini
+    - name: api_key
+      help: Your API key
+      required: true
+
+environment_variable.default:
+  help: Specify the value to apply when not provided by the user.
+  url: https://bashly.dannyb.co/configuration/environment-variable/#default
+  example: |-
+    environment_variables:
+    - name: config_path
+      help: Location of the config file
+      default: ~/config.ini
+
+environment_variable.help:
+  help: Specify the help message for this variable.
+  url: https://bashly.dannyb.co/configuration/environment-variable/#help
+  example: |-
+    environment_variables:
+    - name: api_key
+      help: Your API key
+
+environment_variable.name:
+  help: Specify the lowercase name of the variable.
+  url: https://bashly.dannyb.co/configuration/environment-variable/#name
+  example: |-
+    environment_variables:
+    - name: api_key
+      help: Your API key
+
+environment_variable.private:
+  help: Specify that this environment variable should not be advertised in the usage text. Only makes sense when accompanied by `default`.
+  url: https://bashly.dannyb.co/configuration/environment-variable/#private
+  example: |-
+    environment_variables:
+    - name: editor
+      help: Editor to use
+      default: vim
+      private: true
+
+environment_variable.required:
+  help: Specify that this variable is required.
+  url: https://bashly.dannyb.co/configuration/environment-variable/#required
+  example: |-
+    - name: api_key
+      help: Your API key
+      required: true

data/lib/bashly/docs/flag.yml

@@ -0,0 +1,163 @@
+flag:
+  help: Define option flags.
+  url: https://bashly.dannyb.co/configuration/flag/
+  example: |-
+    flags:
+    - long: --ssh
+      short: -s
+      help: Clone using SSH
+
+    - long: --user
+      short: -u
+      arg: name
+      help: Repository user name
+      required: true
+
+flag.allowed:
+  help: Specify a list of allowed values. Can be used in conjunction with `default` and `required`, and must be accompanied by `arg`.
+  url: https://bashly.dannyb.co/configuration/flag/#allowed
+  example: |-
+    flags:
+    - long: --user
+      short: -u
+      arg: name
+      help: User name
+      
+      # allowed + required
+      allowed: [user, admin]
+      required: true
+
+    - long: --protocol
+      short: -p
+      arg: type
+      help: Protocol to connect with
+      
+      # allowed + default
+      allowed: [ftp, ssh, http]
+      default: ssh
+
+flag.arg:
+  help: Specify the name of the argument for this flag, in case it requires any.
+  url: https://bashly.dannyb.co/configuration/flag/#arg
+  example: |-
+    flags:
+    - long: --ssh
+      short: -s
+      help: Clone using SSH
+
+flag.completions:
+  help: Specify a list of additional completion suggestions when used in conjunction with `bashly add comp`. Must be accompanied by `arg`.
+  url: https://bashly.dannyb.co/configuration/flag/#completions
+  example: |-
+    flags:
+    - long: --user
+      arg: username
+      completions:
+      - <user>
+    
+    # Anything in the 'allowed' option is automatically added as a completion.
+    - long: --protocol
+      arg: protocol
+      allowed:
+      - ssh
+      - telnet
+
+flag.conflicts:
+  help: Specify that this flag is mutually exclusive with one or more other flags. Use the long name of these conflicting flags.
+  url: https://bashly.dannyb.co/configuration/flag/#conflicts
+  example: |-
+    flags:
+    - long: --cache
+      help: Enable cache
+      
+      # Running --cache with --no-cache is not permitted
+      conflicts: [--no-cache]
+    
+    - long: --no-cache
+      help: Disable cache
+      
+      # Running --no-cache with --cache or with --fast is not permitted
+      conflicts: [--cache, --fast]
+    
+    - long: --fast
+      help: Run faster
+      
+      # Make sure to add the conflicting flags on both sides of the conflict
+      conflicts: [--no-cache]
+
+flag.default:
+  help: Specify the value to apply when not provided by the user.
+  url: https://bashly.dannyb.co/configuration/flag/#default
+  example: |-
+    flags:
+    - long: --environment
+      arg: name
+      help: Set environment name
+      default: production
+
+flag.help:
+  help: Specify the help message for this flag.
+  url: https://bashly.dannyb.co/configuration/flag/#help
+  example: |-
+    flags:
+    - long: --cache
+      help: Enable cache
+
+flag.long:
+  help: Specify the long form of the flag, including the -- prefix. Either `long` or `short` is required.
+  url: https://bashly.dannyb.co/configuration/flag/#long
+  example: |-
+    flags:
+    - long: --ssh
+      short: -s
+      help: Clone using SSH
+
+flag.repeatable:
+  help: |-
+    Specify that this flag can be provided multiple times. When used on a flag with an argument, it will be received as a space-delimited string, which needs to be converted to an array with:
+    `eval "data=(${args[--data]})"`
+
+  url: https://bashly.dannyb.co/configuration/flag/#repeatable
+  example: |-
+    flags:
+    - long: --data
+      short: -d
+      arg: data
+      help: Provide data values
+      required: true
+      repeatable: true
+
+    - long: --verbose
+      short: -v
+      help: Set verbosity level
+      repeatable: true
+
+flag.required:
+  help: Specify that this flag is required.
+  url: https://bashly.dannyb.co/configuration/flag/#required
+  example: |-
+    args:
+    - long: --user
+      arg: name
+      help: Repository user name
+      required: true
+
+flag.short:
+  help: Specify the short form of the flag, including the - prefix. Either `long` or `short` is required.
+  url: https://bashly.dannyb.co/configuration/flag/#short
+  example: |-
+    - long: --user
+      short: -u
+      arg: name
+      help: Repository user name
+
+flag.validate:
+  help: Apply custom validation functions. Must be accompanied by `arg`.
+
+  url: https://bashly.dannyb.co/configuration/flag/#validate
+  example: |-
+   flags:
+   - long: --config
+     arg: path
+     help: Load configuration from a file
+     validate: file_exists

data/lib/bashly/version.rb

@@ -1,3 +1,3 @@
 module Bashly
-  VERSION = '0.9.1'
+  VERSION = '0.9.3'
 end

data/lib/bashly/views/command/command_fallback.gtx

@@ -24,6 +24,7 @@ elsif extensible.is_a? String
   >     printf "{{ strings[:invalid_command] }}\n" "$action" >&2
   >     exit 1
   >   fi
+  >   ;;
   >
 
 elsif extensible
@@ -34,6 +35,7 @@ elsif extensible
   >     printf "{{ strings[:invalid_command] }}\n" "$action" >&2
   >     exit 1
   >   fi
+  >   ;;
   >
 
 else

data/lib/bashly/views/command/default_assignments.gtx

@@ -2,11 +2,11 @@ if default_args.any? or default_flags.any?
   = view_marker
 
   default_args.each do |arg|
-    > [[ -n ${args[{{ arg.name }}]:-} ]] || args[{{ arg.name }}]="{{ arg.default }}"
+    > [[ -n ${args['{{ arg.name }}']:-} ]] || args['{{ arg.name }}']="{{ arg.default }}"
   end
 
   default_flags.each do |flag|
-    > [[ -n ${args[{{ flag.long }}]:-} ]] || args[{{ flag.long }}]="{{ flag.default }}"
+    > [[ -n ${args['{{ flag.long }}']:-} ]] || args['{{ flag.long }}']="{{ flag.default }}"
   end
 
   >

data/lib/bashly/views/command/fixed_flags_filter.gtx

@@ -4,14 +4,14 @@
 >   case "${1:-}" in
 
 if root_command?
-  = short_flag_exist?("-v") ? "--version)" : "--version | -v)".indent(4)
+  = (short_flag_exist?("-v") ? "--version)" : "--version | -v)").indent(4)
   >       version_command
   >       exit
   >       ;;
   > 
 end
 
-= short_flag_exist?("-h") ? "--help)" : "--help | -h)".indent(4)
+= (short_flag_exist?("-h") ? "--help)" : "--help | -h)").indent(4)
 >       long_usage=yes
 >       <%= function_name %>_usage
 >       exit

data/lib/bashly/views/command/parse_requirements_case_catch_all.gtx

@@ -3,9 +3,9 @@
 if args.any?
   condition = "if"
   args.each do |arg|
-    > {{ condition }} [[ -z ${args[{{ arg.name }}]+x} ]]; then
+    > {{ condition }} [[ -z ${args['{{ arg.name }}']+x} ]]; then
     =   arg.render(:validations).indent 2
-    >   args[{{ arg.name }}]=$1
+    >   args['{{ arg.name }}']=$1
     >   shift
     
     condition = "elif"

data/lib/bashly/views/command/parse_requirements_case_repeatable.gtx

@@ -2,18 +2,17 @@
 
 condition = "if"
 args.each do |arg|
-  > {{ condition }} [[ -z ${args[{{ arg.name }}]+x} ]]; then
-  = arg.render(:validations).indent 2
-
+  = arg.render(:validations)
+  > {{ condition }} [[ -z ${args['{{ arg.name }}']+x} ]]; then
   if arg.repeatable
-    >   args[{{ arg.name }}]="\"$1\""
+    >   args['{{ arg.name }}']="\"$1\""
     >   shift
     > else
-    >   args[{{ arg.name }}]="${args[{{ arg.name }}]} \"$1\""
+    >   args['{{ arg.name }}']="${args[{{ arg.name }}]} \"$1\""
     >   shift
 
   else
-    >   args[{{ arg.name }}]=$1
+    >   args['{{ arg.name }}']=$1
     >   shift
 
   end

data/lib/bashly/views/command/parse_requirements_case_simple.gtx

@@ -3,9 +3,9 @@
 if args.any?
   condition = "if"
   args.each do |arg|
-    > {{ condition }} [[ -z ${args[{{ arg.name }}]+x} ]]; then
+    > {{ condition }} [[ -z ${args['{{ arg.name }}']+x} ]]; then
     > {{ arg.render(:validations).indent 2 }}
-    >   args[{{ arg.name }}]=$1
+    >   args['{{ arg.name }}']=$1
     >   shift
 
     condition = "elif"

data/lib/bashly/views/command/parse_requirements_while.gtx

@@ -11,8 +11,16 @@ unless global_flags?
 end
 
 >
->     -?*)
+if catch_all.enabled?
+>     --)
+>       shift
+>       other_args+=("$@")
+>       break
+>       ;;
+>
+end
 
+>     -?*)
 if catch_all.enabled?
   >       other_args+=("$1")
   >       shift

data/lib/bashly/views/command/required_args_filter.gtx

@@ -2,7 +2,7 @@ if required_args.any?
   = view_marker
 
   required_args.each do |arg|
-    > if [[ -z ${args[{{ arg.name }}]+x} ]]; then
+    > if [[ -z ${args['{{ arg.name }}']+x} ]]; then
     >   printf "{{ strings[:missing_required_argument] % { arg: arg.name.upcase, usage: usage_string } }}\n" >&2
     >   exit 1
     > fi

data/lib/bashly/views/command/required_flags_filter.gtx

@@ -2,7 +2,7 @@ if required_flags.any?
   = view_marker
 
   required_flags.each do |flag|
-    > if [[ -z ${args[{{ flag.long }}]+x} ]]; then
+    > if [[ -z ${args['{{ flag.long }}']+x} ]]; then
     >   printf "{{ strings[:missing_required_flag] % { usage: flag.usage_string } }}\n" >&2
     >   exit 1
     > fi

data/lib/bashly/views/command/run.gtx

@@ -11,7 +11,7 @@
 
 deep_commands.each do |command|
   >     "{{ command.action_name }}")
-  >       if [[ ${args[--help]:-} ]]; then
+  >       if [[ ${args['--help']:-} ]]; then
   >         long_usage=yes
   >         {{ command.function_name }}_usage
   >       else

data/lib/bashly/views/command/whitelist_filter.gtx

@@ -12,7 +12,7 @@ if whitelisted_args.any? or whitelisted_flags.any?
       > done
 
     else
-      > if [[ ! ${args[{{ arg.name }}]} =~ ^({{ arg.allowed.join '|' }})$ ]]; then
+      > if [[ ! ${args['{{ arg.name }}']} =~ ^({{ arg.allowed.join '|' }})$ ]]; then
       >   printf "%s\n" "{{ strings[:disallowed_argument] % { name: arg.name, allowed: arg.allowed.join(', ') } }}" >&2
       >   exit 1
       > fi
@@ -31,7 +31,7 @@ if whitelisted_args.any? or whitelisted_flags.any?
       > done
     
     else
-      > if [[ ! ${args[{{ flag.name }}]} =~ ^({{ flag.allowed.join '|' }})$ ]]; then
+      > if [[ ! ${args['{{ flag.name }}']} =~ ^({{ flag.allowed.join '|' }})$ ]]; then
       >   printf "%s\n" "{{ strings[:disallowed_flag] % { name: flag.name, allowed: flag.allowed.join(', ') } }}" >&2
       >   exit 1
       > fi

data/lib/bashly/views/flag/case_arg.gtx

@@ -4,14 +4,14 @@
 = render(:validations).indent 2
 
 if repeatable
-  >   if [[ -z ${args[{{ name }}]+x} ]]; then
-  >     args[{{ name }}]="\"$2\""
+  >   if [[ -z ${args['{{ name }}']+x} ]]; then
+  >     args['{{ name }}']="\"$2\""
   >   else
-  >     args[{{ name }}]="${args[{{ name }}]} \"$2\""
+  >     args['{{ name }}']="${args[{{ name }}]} \"$2\""
   >   fi
 
 else
-  >   args[{{ name }}]="$2"
+  >   args['{{ name }}']="$2"
 
 end
 

data/lib/bashly/views/flag/case_no_arg.gtx

@@ -1,9 +1,9 @@
 = view_marker
 
 if repeatable
-  > ((args[<%= name %>]+=1))
+  > ((args['<%= name %>'] += 1))
 else
-  > args[<%= name %>]=1
+  > args['<%= name %>']=1
 end
 
 > shift

data/lib/bashly/views/flag/conflicts.gtx

@@ -3,7 +3,7 @@ if conflicts
   = view_marker
   
   if conflicts.count == 1
-    > if [[ -n "${args[{{ conflicts.first }}]:-}" ]]; then
+    > if [[ -n "${args['{{ conflicts.first }}']:-}" ]]; then
     >   printf "{{ strings[:conflicting_flags] }}\n" "$key" "{{ conflicts.first }}" >&2
     >   exit 1
     > fi

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bashly
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: 0.9.3
 platform: ruby
 authors:
 - Danny Ben Shitrit
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-12-09 00:00:00.000000000 Z
+date: 2022-12-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: completely
@@ -121,6 +121,7 @@ files:
 - lib/bashly/cli.rb
 - lib/bashly/commands/add.rb
 - lib/bashly/commands/base.rb
+- lib/bashly/commands/doc.rb
 - lib/bashly/commands/generate.rb
 - lib/bashly/commands/init.rb
 - lib/bashly/commands/preview.rb
@@ -132,6 +133,10 @@ files:
 - lib/bashly/config.rb
 - lib/bashly/config_validator.rb
 - lib/bashly/deprecation.rb
+- lib/bashly/docs/arg.yml
+- lib/bashly/docs/command.yml
+- lib/bashly/docs/env.yml
+- lib/bashly/docs/flag.yml
 - lib/bashly/exceptions.rb
 - lib/bashly/extensions/array.rb
 - lib/bashly/extensions/file.rb
@@ -247,7 +252,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.26
+rubygems_version: 3.4.0
 signing_key: 
 specification_version: 4
 summary: Bash Command Line Tool Generator