add README section

Author: trefzer

README.md

@@ -320,6 +320,56 @@ podman run -it --rm -v $PWD:/repo:Z --entrypoint rubocop ghcr.io/voxpupuli/voxbo
 podman run -it --rm -v $PWD:/repo:Z --entrypoint rubocop ghcr.io/voxpupuli/voxbox:8 --auto-gen-config
 ```
 
+## EasyVoxBox (evb)
+The [evb script](evb) shortens the commands to be typed for running voxbox. Additionaly, it does not care about the sequence of
+options, wich can be usefull for setting shell aliases. To run the command you must change into any subdirectory of a openvox module 
+(with a metadata.json file) or a control repository (with a Puppetfile). 
+
+Display the evb help message:
+```shell
+$ evb help
+Usage: /usr/local/bin/evb [options] [command]
+
+available options:
+  --noop        : print the command to run, but do not run it
+  --entrypoint  : use a different entrypoint
+                  examples for available endpoints are: 
+                  onceover, ash, puppet, yamllint, jq, curl, rubocop
+                  default: no entrypoint specified
+  --image image : use a different image (default ghcr.io/voxpupuli/voxbox:8)
+  --env VAR=val : specify environment variables (can be used multiple times)
+                  Remark: the term './' in a assignment will be replaced with
+                  the correct path to be used in the container.
+                  Example: if you start the script in ~/openvox-supermodule/spec/classes
+                           and set --env SPEC=./supermodule_spec.rb we will
+                           run VoxBox with -e SPEC=spec/classes/supermodule_spec.rb
+  --volume vol  : specify an additional volume to put into the container
+                  see podman man page how to specify 'vol'. (no path magic is done ;)) 
+  --runcmd      : this lets you change the program used to start the container
+                  if not set explicit it looks for podman or docker.
+
+available command:
+   help  : print this help message and exit
+
+commands/options not listed here are passed to VoxBox as is.
+use the '--noop' option to print the detailed call to VoxBox.
+```
+
+See the command that would be executed (dropping the --noop option will run the command):
+```shell
+evb --noop                                     # for rake -T
+evb --noop spec                                # for rake spec
+evb --noop --env SPEC=./example_spec.rb spec   # for only a specific spec in the current subdirectory
+evb --noop --entrypoint onceover --help        # onceover help
+
+# or the release rake task
+evb --volume ~/.gitconfig:/etc/gitconfig:ro \
+    --volume ~/.ssh:/root/.ssh \
+    --volume ${SSH_AUTH_SOCK}:${SSH_AUTH_SOCK} \
+    --env  SSH_AUTH_SOCK="${SSH_AUTH_SOCK}" \
+    release --noop
+```
+
 ## GitLab
 
 ### Example GitLab CI configuration

evb

@@ -22,7 +22,7 @@ available options:
   --noop        : print the command to run, but do not run it
   --entrypoint  : use a different entrypoint
                   examples for available endpoints are: 
-                  onceover, 
+                  onceover, ash, puppet, yamllint, jq, curl, rubocop
                   default: no entrypoint specified
   --image image : use a different image (default ${PODIMAGE})
   --env VAR=val : specify environment variables (can be used multiple times)