prefix for tasks to avoid conflicts

Author: ataxexe

README.md

@@ -186,10 +186,15 @@ affects the bash completion
 usage
 * **SODA_DEFAULT_RESOURCE_DIR** - the default directory to search for resources (defaults to 
 *resources*)
+* **SODA_TASK_OPTIONAL_PREFIX** - the optional prefix to map a task function (defaults to *do_*)
 
 Remember that parameters are converted to upper case, so you can call `soda --log-file=path/to/file`
 and the *$LOG_FILE* variable will be set to that value.
 
+The parameter **SODA_TASK_OPTIONAL_PREFIX** is very usefull in case of tasks with a name already
+defined by another function or name (*kill* or *status*, for example). To avoid conflicts, prefix
+the function with the SODA_TASK_OPTIONAL_PREFIX value (*do_kill*, *do_status*, ...).
+
 ## Logging
 
 To log something, just call the **log** function passing the category and message (optionally, you

config/soda/conventions.conf

@@ -24,3 +24,4 @@
 SODA_NAMESPACE_DELIMITER=.
 SODA_TASK_BASH_COMPLETION_SUFFIX=_bash_completion
 SODA_DEFAULT_RESOURCE_DIR=resources
+SODA_TASK_OPTIONAL_PREFIX=do_

scripts/soda/exec.sh

@@ -128,17 +128,21 @@ execute() {
 }
 
 #
-# Calls the given function. Using this method will broadcast events around the call:
+# Calls the given task. Using this method will broadcast events around the call:
 #
-# ${FUNCTION_NAME}-start: after call
-# ${FUNCTION_NAME}-finish: before call
+# ${TASK_NAME}-start: after call
+# ${TASK_NAME}-finish: before call
 #
-# This method is intented to use for task call
+# ** This method is intented to use for task call **
 #
 call() {
   local function_name="$(build_name $1)"
+  local task_name="$1"
   shift
-  broadcast "${function_name}-start"
+  broadcast "${task_name}-start"
+  if [[ $(type -t ${SODA_TASK_OPTIONAL_PREFIX}${function_name}) ]]; then
+    function_name="${SODA_TASK_OPTIONAL_PREFIX}${function_name}"
+  fi
   $function_name "$@"
-  broadcast "${function_name}-finish"
+  broadcast "${task_name}-finish"
 }