app.go

package core

import (
	"encoding/json"
	"errors"
	"fmt"
	"github.com/MG-RAST/AWE/lib/conf"
	"github.com/MG-RAST/AWE/lib/logger"
	"github.com/MG-RAST/AWE/vendor/github.com/MG-RAST/golib/httpclient"
	"io/ioutil"
	"path"
	"regexp"
	"strconv"
	"strings"
	"time"
)

// part of the app-definition
type AppInput struct {
	Type         string `bson:"type" json:"type"`
	Name         string `bson:"name" json:"name"`
	DefaultValue string `bson:"default_value" json:"default_value"`
	Required     bool   `bson:"required" json:"required"` // or use optional // TODO remove
	Optional     bool   `bson:"optional" json:"optional"`
	Option       string `bson:"option" json:"option"`         // this is the name used by the command line proramm, e.g. "--input="
	Cache        bool   `bson:"cache" json:"cache"`           // specifies that input has to be cached (predata)
	ShockIndex   string `bson:"shockindex" json:"shockindex"` // specifies that (shock) input has to be indexed in Shock by the AWE server
	//Description		`bson:"description" json:"description"`
}

type AppCommandMode struct {
	Input           []AppInput          `bson:"input" json:"input"`
	Output_array    []string            `bson:"output_array" json:"output_array"`
	Outputs         []IO                `bson:"outputs" json:"outputs"`
	Predata         []IO                `bson:"predata" json:"predata"`
	Cmd             string              `bson:"cmd" json:"cmd"`
	Cmd_interpreter string              `bson:"cmd_interpreter" json:"cmd_interpreter"`
	Cmd_script      []string            `bson:"cmd_script" json:"cmd_script"`
	Variables       []map[string]string `bson:"variables" json:"variables"`
	Dockerimage     string              // just for convenience
}

type AppPackage struct {
	Dockerimage string                                `bson:"dockerimage" json:"dockerimage"`
	Commands    map[string]map[string]*AppCommandMode // package_command, package_mode
}

type AppRegistry map[string]*AppPackage

// part of workflow document, used in "Command", defines input: shock, task, string
// those can generate IO structs (see io.go)
type AppResource struct {
	Resource       string        `bson:"resource" json:"resource"`
	Host           string        `bson:"host" json:"host"`
	Node           string        `bson:"node" json:"node"`
	Url            string        `bson:"url" json:"url"`
	Filename       string        `bson:"filename" json:"filename"`
	Key            string        `bson:"key" json:"key"`
	Value          string        `bson:"value" json:"value"`
	Task           string        `bson:"task" json:"task"`
	OutputPosition *int          `bson:"position" json:"position"`
	OutputName     string        `bson:"name" json:"name"`
	Uncompress     string        `bson:"uncompress" json:"uncompress"` // tells AWE client to uncompress this file, e.g. "gzip"
	List           []AppResource `bson:"list" json:"list"`
	Cache          bool          `bson:"cache" json:"cache"`
	ShockIndex     string        `bson:"shockindex" json:"shockindex"` // specifies that (shock) input has to be indexed in Shock by the AWE server
}

type AppInputType int

const (
	Ait_undefined AppInputType = iota
	Ait_file
	Ait_string
	Ait_shock
	Ait_url
	Ait_task
	Ait_list
)

type AppVariable struct {
	Value    string
	Var_type AppInputType
	Option   string // a flag that is needed to activate an argument on the command line, e.g. "--input ", mainly used for optional arguments
	Optional bool   // indicates that an empty value is ok and not an error
}

// part of the (internal-only) workflow document, used in "Task""
type AppVariables map[string]AppVariable

type VariableExpander struct {
	simple_variable_match     *regexp.Regexp
	functional_variable_match *regexp.Regexp
	app_variables             AppVariables
}

func (this_ait AppInputType) HasType(ait AppInputType) bool {
	if this_ait == ait {
		return true
	}
	// file hasType shock = false
	// shock hasType file = true

	if ait == Ait_file {
		if this_ait == Ait_shock {
			return true
		}
		if this_ait == Ait_url {
			return true
		}
		if this_ait == Ait_task {
			return true
		}
	}
	return false
}

func String2apptype(type_string string) (ait AppInputType, err error) {

	if type_string == "file" {
		ait = Ait_file
	} else if type_string == "string" {
		ait = Ait_string
	} else if type_string == "shock" {
		ait = Ait_shock
	} else if type_string == "url" {
		ait = Ait_url
	} else if type_string == "task" {
		ait = Ait_task
	} else if type_string == "list" {
		ait = Ait_list
	} else {
		err = errors.New(fmt.Sprintf("could not convert type: %s", type_string))
	}

	return
}

func apptype2string(ait AppInputType) string {
	switch ait {
	case Ait_undefined:
		return "undefined"
	case Ait_file:
		return "file"
	case Ait_string:
		return "string"
	case Ait_shock:
		return "shock"
	case Ait_url:
		return "url"
	case Ait_task:
		return "task"
	case Ait_list:
		return "list"
	}

	return "unknown"

}

// generator function for app registry
func MakeAppRegistry() (new_instance AppRegistry, err error) {

	if conf.APP_REGISTRY_URL == "" {
		err = errors.New("error app registry url empty")
		return
	}

	new_instance = make(AppRegistry)
	return
}

func (apr AppRegistry) GetAppPackage(app_package string) (ap *AppPackage, err error) {

	ap, ok := apr[app_package]
	if ok {
		return ap, nil
	}

	package_url := conf.APP_REGISTRY_URL + "/" + app_package + ".json"

	var new_app_package AppPackage

	for i := 0; i < 3; i++ {

		if i > 0 {
			time.Sleep(1000 * time.Millisecond)
		}
		logger.Debug(1, fmt.Sprintf("downloading app package \"%s\"", package_url))

		res, err := httpclient.GetTimeout(package_url, nil, nil, nil, 5000*time.Millisecond)

		if err != nil {
			logger.Error("warning: " + conf.APP_REGISTRY_URL + " " + err.Error())
			continue
		}

		app_package_json, err := ioutil.ReadAll(res.Body)
		if err != nil {
			logger.Error(fmt.Sprintf("warning, could not read app registry json: %s", err.Error()))
			continue
		}

		// transform json into go struct interface
		//var f map[string]interface{}
		err = json.Unmarshal(app_package_json, &new_app_package)

		if err != nil {
			logger.Error("error unmarshaling app package " + app_package + ", error=" + err.Error())
			continue
		}

		apr[app_package] = &new_app_package
		ap = &new_app_package

		logger.Debug(1, fmt.Sprintf("app package unmarshalled"))
		return ap, nil
	}

	ap = nil
	err = errors.New("could not get app package from " + package_url)
	return

}

func (appr AppRegistry) Get_cmd_mode_object(app_package_name string, app_command_name string, app_cmd_mode_name string) (app_cmd_mode_object_ref *AppCommandMode, err error) {

	// test if app package exsists, if not, load it
	app_package_object_ref, err := appr.GetAppPackage(app_package_name) // this loads the app package !
	if err != nil {
		return
	}

	app_command_object_ref, ok := app_package_object_ref.Commands[app_command_name]
	if !ok {
		err = errors.New("app_command_name=" + app_command_name + " not found in app registry")

		return
	}

	app_cmd_mode_object_ref, ok = app_command_object_ref[app_cmd_mode_name]
	if !ok {
		err = errors.New("app_cmd_mode_name=" + app_cmd_mode_name + " not found in app registry , " + app_package_name + "." + app_command_name)
		return
	}

	if app_cmd_mode_object_ref.Dockerimage == "" {
		app_cmd_mode_object_ref.Dockerimage = app_package_object_ref.Dockerimage
	}
	//app_cmd_mode_object_ref = &app_cmd_mode_object

	return
}

func (appr AppRegistry) Get_dockerimage(app_package_name string) (dockerimage string, err error) {
	app_package_object_ref, ok := appr[app_package_name]
	if !ok {
		err = errors.New("app_package_name=" + app_package_name + " not found in app registry")
		return
	}

	return app_package_object_ref.Dockerimage, err
}

func (acm AppCommandMode) Get_default_app_variables() (app_variables AppVariables, err error) {
	app_variables = make(AppVariables)
	// this function is called on the server

	// *** app input arguments (app definition)
	logger.Debug(1, fmt.Sprintf("Get_default_app_variables: size of acm.Input=%d", len(acm.Input)))
	time.Sleep(15 * time.Millisecond)
	for _, input_arg := range acm.Input {
		//logger.Debug(1, fmt.Sprintf("app input arg: %s", strings.Join(input_arg, ", ")))

		// save the defaults if available

		logger.Debug(1, fmt.Sprintf("from app-definition: variable \"%s\"", input_arg.Name))
		app_type, err := String2apptype(input_arg.Type)
		if err != nil {
			err = errors.New(fmt.Sprintf("error converting type, error=%s", err.Error()))
			return app_variables, err
		}
		logger.Debug(1, fmt.Sprintf("from app-definition: variable \"%s\" has type %s", input_arg.Name, apptype2string(app_type)))

		logger.Debug(1, fmt.Sprintf("from app-definition: write variable:\"%s\" - default value: \"%s\"", input_arg.Name, input_arg.DefaultValue))
		app_variables[input_arg.Name] = AppVariable{Var_type: app_type,
			Value:    input_arg.DefaultValue,
			Option:   input_arg.Option,
			Optional: input_arg.Optional}

	}

	return
}

func (acm AppCommandMode) Get_app_variables(app_variables AppVariables) (err error) {
	va := NewVariableExpander(app_variables)
	logger.Debug(1, fmt.Sprintf("---------variable block start"))
	for _, variable_block := range acm.Variables {
		for variable_name, variable_term := range variable_block {

			// evaluate and add to app_variables
			expanded_var, err := va.Expand(variable_term)
			if err != nil {
				return err
			}
			logger.Debug(1, fmt.Sprintf("variable_name: %s -> %s", variable_name, expanded_var))
			variable_obj, ok := app_variables[variable_name]
			if ok {
				variable_obj.Value = expanded_var
			} else {
				app_variables[variable_name] = AppVariable{Var_type: Ait_string, Value: expanded_var}
			}

		}
	}
	logger.Debug(1, fmt.Sprintf("---------variable block end"))
	return
}

// Overview of createIOnodes_forTask (this is executed server-side) // TODO rename this function and the caller
// -------------------------------
// recurse into task dependencies
// get app object
// app input           -> variables
// task input          -> variables
// app/task variables  -> variables
// eval outputs
// creates task.AppVariables (from "variables"" above)
// creates task.Outputs
//   -> creates io.NodeAttr.workflow_tracking for Output nodes if requested
// creates task.Inputs
// extends DependsOn
// creates job.ShockHost
// creates task.PreData

func (appr AppRegistry) createIOnodes_forTask(job *Job, task *Task, taskid2task map[string]*Task, taskid_processed map[string]bool) (err error) {

	taskid_split := strings.Split(task.Id, "_")
	taskid := taskid_split[1]

	// already processed ?
	_, ok := taskid_processed[taskid]
	if ok {
		return
	}
	taskid_processed[taskid] = true

	// is it an app ?
	if task.App == nil || task.App.Name == "" {
		if conf.USE_APP_DEFS == "only" {
			return errors.New("Error: Task " + task.Id + " does not use an app-defintion")
		}

		return
	}

	// recurse into providing tasks (parent tasks)
	args_array := task.App.App_args

	for _, argument := range args_array {
		if argument.Resource == "task" {
			providing_taskid := argument.Task
			logger.Debug(1, fmt.Sprintf("recursion from %s into %s", taskid, providing_taskid))
			providing_task, ok := taskid2task[providing_taskid]
			if !ok {
				return errors.New("Error: Task \"" + providing_taskid + "\" could not be found")
			}
			err = appr.createIOnodes_forTask(job, providing_task, taskid2task, taskid_processed)
			if err != nil {
				return
			}
			logger.Debug(1, fmt.Sprintf("back from recursion (%s into %s)", taskid, providing_taskid))
		}
	}

	// get app definition for this command
	app_string := task.App.Name
	app_array := strings.Split(app_string, ".")
	if len(app_array) != 3 {
		err = errors.New("error: app could not be parsed, app=" + app_string)
		return
	}
	app_cmd_mode_object, err := appr.Get_cmd_mode_object(app_array[0], app_array[1], app_array[2])

	if err != nil {
		err = errors.New(fmt.Sprintf("error reading app registry, error=%s", err.Error()))
		return err
	}

	if task.App.AppDef != nil {
		err = errors.New(fmt.Sprintf("error: AppDef cannot be defined within worflow document"))
		return err
	}

	task.App.AppDef = app_cmd_mode_object

	if task.App.AppDef.Dockerimage == "" {
		image, err := appr.Get_dockerimage(app_array[0])

		if err != nil {
			err = errors.New(fmt.Sprintf("Could not read dockerimage, error=%s", err.Error()))
			return err
		}

		task.App.AppDef.Dockerimage = image
		task.Cmd.Dockerimage = image
	}

	// create app_variables from app-input definition
	logger.Debug(1, fmt.Sprintf("+++ %s +++ create app_variables from app-input definition", task.Id))
	app_variables, err := app_cmd_mode_object.Get_default_app_variables()
	if err != nil {
		return err
	}
	task.AppVariables = app_variables

	// add variables from task input (args_array)
	logger.Debug(1, fmt.Sprintf("+++ %s +++ add variables from task input (args_array)", task.Id))
	err = app_cmd_mode_object.ParseAppInput(app_variables, args_array, nil, task, taskid2task) // task I need here only because of the task id for debug info
	if err != nil {
		return errors.New(fmt.Sprintf("error parsing input, error=%s", err.Error()))
	}

	// add variables from the app variables defintion
	logger.Debug(1, fmt.Sprintf("+++ %s +++ add variables from the app variables defintion", task.Id))
	app_cmd_mode_object.Get_app_variables(app_variables)

	// create ouputs
	logger.Debug(1, fmt.Sprintf("+++ %s +++ create outputs", task.Id))
	//if task.Outputs == nil {
	//	task.Outputs = make(IOmap)
	//}

	task_outputs := task.Outputs

	output_array_copy := make([]string, len(app_cmd_mode_object.Output_array))
	copy(output_array_copy, app_cmd_mode_object.Output_array)

	err = Expand_app_variables(app_variables, output_array_copy)
	if err != nil {
		return
	}

	shockhost := job.ShockHost // this is only used as a backup (or default) if output nodes have no shockhost defined

	var my_attr map[string]interface{}
	var workflow map[string]interface{}
	var newinfo Info

	if job.Info.Tracking {

		// allows me to make nested! copy of Info (without datatoken)
		info_byte, err := json.Marshal(job.Info)
		if err != nil {
			return err
		}

		err = json.Unmarshal(info_byte, &newinfo)
		if err != nil {
			return err
		}

		my_attr = make(map[string]interface{}) // this will be appended to each output node
		workflow = make(map[string]interface{})
		my_attr["workflow_tracking"] = workflow

		workflow["info"] = newinfo
		workflow["job_id"] = job.Id
		workflow["task_id"] = task.Id
		workflow["app"] = task.App.Name
		workflow["app_args"] = task.App.App_args
	}

	for pos, app_output := range output_array_copy {
		if app_output == "" {
			return errors.New("error: app_output is empty string")
		}
		filename := path.Base(app_output)
		directory := path.Dir(app_output)

		logger.Debug(1, fmt.Sprintf("output: filename: \"%s\", directory: \"%s\", (was: \"%s\")", filename, directory, app_output))
		if directory == "." {
			directory = "" // TODO "." might be ok
		}

		if job.Info.Tracking {
			my_io := &IO{Host: shockhost, Directory: directory, AppPosition: pos, DataToken: task.Info.DataToken, NodeAttr: my_attr, FileName: filename}
			task_outputs = append(task_outputs, my_io)
		} else {
			my_io := &IO{Host: shockhost, Directory: directory, AppPosition: pos, DataToken: task.Info.DataToken, FileName: filename}
			task_outputs = append(task_outputs, my_io)
		}

	}

	expander := NewVariableExpander(app_variables)

	// output files
	for pos, io := range app_cmd_mode_object.Outputs {

		if io.Host == "" {
			if shockhost == "" {
				err = errors.New(fmt.Sprintf("error task output has no shock host specified (neither local nor global)"))
				return err
			}
			io.Host = shockhost
		}

		io.FileName, err = expander.Expand(io.FileName)
		if err != nil {
			return err
		}

		io.AttrFile, err = expander.Expand(io.AttrFile)
		if err != nil {
			return err
		}

		if len(io.FormOptions) > 0 {
			parent_name, ok := io.FormOptions["parent_name"]

			if ok {
				if parent_name != "" {
					parent_name, err = expander.Expand(parent_name)
					if err == nil {
						io.FormOptions["parent_name"] = parent_name
					}
				}
			}
		}

		filename := io.FileName

		if filename == "" {
			err = errors.New(fmt.Sprintf("error task output at position %d has no filename", pos))
			return err
		}

		my_io := &IO{}
		*my_io = io
		my_io.AppPosition = pos
		my_io.FileName = filename
		task_outputs = append(task_outputs, my_io)
	}

	// populate with input fields:
	logger.Debug(1, fmt.Sprintf("+++ %s +++ populate with input fields", task.Id))
	err = app_cmd_mode_object.ParseAppInput(app_variables, args_array, job, task, taskid2task)
	if err != nil {
		err = errors.New(fmt.Sprintf("error populate with input fields, error=%s", err.Error()))
		return err
	}

	// copy predata
	//copy(task.Predata, app_cmd_mode_object.Predata) // TODO expand variables
	//*task.Predata = *app_cmd_mode_object.Predata
	if len(app_cmd_mode_object.Predata) != 0 {
		for _, val := range app_cmd_mode_object.Predata {
			task.Predata = append(task.Predata, &val)
		}
	}
	// convenient dependencies (dependsOn is only used now if dependency without files is needed)
	dependsOn_map := make(map[string]bool)

	for _, dep := range task.DependsOn {
		if dep != "" {
			dependsOn_map[dep] = true
		}
	}

	for _, myio := range task.Inputs {
		if myio.Origin != "" {

			dependency := job.Id + "_" + myio.Origin
			dependsOn_map[dependency] = true
		}
	}

	//dependsOn_array := make([]string, len(dependsOn_map))
	var dependsOn_array []string
	//j := 0
	for key := range dependsOn_map {
		if key == "" {
			err = errors.New(fmt.Sprintf("error : dependsOn key is empty"))
			return err
		}
		dependsOn_array = append(dependsOn_array, key)
	}

	task.DependsOn = dependsOn_array

	for _, dep := range task.DependsOn {
		if dep == "" {
			return errors.New(fmt.Sprintf("error dep is empty !!"))
		}
	}

	logger.Debug(1, "+++ core.Expand_app_variables")

	// expand app variables in cmd_script (this is servser-side)

	task.Cmd.Cmd_script = make([]string, len(app_cmd_mode_object.Cmd_script))
	copy(task.Cmd.Cmd_script, app_cmd_mode_object.Cmd_script)
	logger.Debug(1, fmt.Sprintf("task.Cmd.Cmd_script (unexpanded): %s", strings.Join(task.Cmd.Cmd_script, ", ")))
	err = Expand_app_variables(app_variables, task.Cmd.Cmd_script)
	if err != nil {
		return errors.New(fmt.Sprintf("error: core.Expand_app_variables, %s", err.Error()))
	}
	logger.Debug(1, fmt.Sprintf("task.Cmd.Cmd_script (expanded): %s", strings.Join(task.Cmd.Cmd_script, ", ")))

	return
}

func (appr AppRegistry) createIOnodes(job *Job) (err error) {

	// go over tasks

	taskid2task := make(map[string]*Task)
	taskid_processed := make(map[string]bool)

	// create taskid2task
	for _, task := range job.Tasks {

		taskid_split := strings.Split(task.Id, "_")
		taskid := taskid_split[1]
		_, ok := taskid2task[taskid]
		if ok {
			err = errors.New("error: task id not unique, id=" + taskid)
			return
		}
		taskid2task[taskid] = task
		logger.Debug(1, fmt.Sprintf("--------adding to taskid2task map: %s", taskid))
	}

	for _, task := range job.Tasks {

		err = appr.createIOnodes_forTask(job, task, taskid2task, taskid_processed)
		if err != nil {
			return errors.New(fmt.Sprintf("error in task %s: %s", task.App.Name, err.Error()))
		}
	}

	logger.Debug(1, fmt.Sprintf("+++ +++ createIONodesm finished"))
	return
}

func variable_keys_2_string(app_variables AppVariables) string {

	variable_keys_array := make([]string, len(app_variables))
	i := 0
	for key := range app_variables {
		variable_keys_array[i] = key
		i++
	}
	return strings.Join(variable_keys_array, ",")
}

func ParseResource(input_arg AppResource, app_variables AppVariables, job *Job, task *Task, taskid2task map[string]*Task) (err error) {

	resource_type, err := String2apptype(input_arg.Resource)

	var input_variable_value = ""
	var input_variable_name = input_arg.Key

	if input_variable_name == "" {
		return errors.New(fmt.Sprintf("input_variable_name is empty"))
	}

	var inputs []*IO
	var predata []*IO
	if job != nil {
		inputs = task.Inputs
		predata = task.Predata
	}

	switch resource_type {
	case Ait_shock:
		logger.Debug(1, fmt.Sprintf("processing: %s", apptype2string(resource_type)))
		filename := input_arg.Filename
		host := input_arg.Host
		node := input_arg.Node
		if filename != "" {
			input_variable_value = filename
		} else {
			//TODO invent filename ?
			return errors.New(fmt.Sprintf("filename is missing for app argument %s", input_variable_name))
		}

		// TODO make sure resource_type corresponds to expected type in app def

		if job != nil {
			for _, i := range inputs {
				if i.FileName == filename {
					return errors.New(fmt.Sprintf("input node already exists: %s", input_variable_name))
				}
			}

			input_temp := &IO{
				FileName:   filename,
				Name:       input_variable_name,
				Host:       host,
				Node:       node,
				DataToken:  task.Info.DataToken,
				Uncompress: input_arg.Uncompress,
				Cache:      input_arg.Cache,
				ShockIndex: input_arg.ShockIndex,
			}
			if input_arg.Cache {
				predata = append(predata, input_temp)
			} else {
				inputs = append(inputs, input_temp)
			}
			//app_variables[input_variable_name + ".Host"] = host // do not here
			//app_variables[input_variable_name + ".Node"] = node
		}
	case Ait_url:
		logger.Debug(1, fmt.Sprintf("processing: %s", apptype2string(resource_type)))
		filename := input_arg.Filename
		url := input_arg.Url
		if filename != "" {
			input_variable_value = filename
		} else {
			//TODO invent filename ?
			return errors.New(fmt.Sprintf("filename is missing for app argument %s", input_variable_name))
		}

		// TODO make sure resource_type corresponds to expected type in app def

		if job != nil {

			for _, i := range inputs {
				if i.FileName == filename {
					return errors.New(fmt.Sprintf("input node already exists: %s", input_variable_name))
				}
			}

			input_temp := &IO{
				FileName:   filename,
				Name:       input_variable_name,
				Url:        url,
				Uncompress: input_arg.Uncompress,
				Cache:      input_arg.Cache,
			}

			if input_arg.Cache {
				predata = append(predata, input_temp)
			} else {
				inputs = append(inputs, input_temp)
			}
		}
	case Ait_task:
		logger.Debug(1, fmt.Sprintf("processing: %s", apptype2string(resource_type)))

		//taskid2task

		providing_task_id := input_arg.Task
		outputPosition := input_arg.OutputPosition
		outputName := input_arg.OutputName
		shockhost := input_arg.Host

		// find filename
		filename := ""
		providing_task, ok := taskid2task[providing_task_id]

		if !ok {

			err = errors.New(fmt.Sprintf("did not find providing task: %s", providing_task_id))
			return err
		}

		if outputPosition != nil {
		Loop_outputPosition:
			for _, my_io := range providing_task.Outputs {

				if my_io.AppPosition == *outputPosition {

					filename = my_io.FileName
					break Loop_outputPosition
				}

			}
			if filename == "" {
				err = errors.New(fmt.Sprintf("did not find providing position \"%d\" in task \"%s\"", *outputPosition, task))
				return err
			}
		} else if outputName != "" {
		Loop_outputName:
			for _, my_io := range providing_task.Outputs {
				logger.Debug(1, fmt.Sprintf("Ait_task C"))
				if my_io.Name == outputName {

					filename = my_io.FileName
					break Loop_outputName
				}

			}

		} else {
			err = errors.New(fmt.Sprintf("neither name nor position has been defined for providing_task_id %s", providing_task_id))
			return err
		}

		if filename == "" {
			err = errors.New(fmt.Sprintf("did not find dependency in task \"%s\"", task))
			return err
		}
		logger.Debug(1, fmt.Sprintf("Ait_task filename %s", filename))

		if job != nil {

			if shockhost == "" {
				if job.ShockHost != "" {
					shockhost = job.ShockHost
				} else {
					err = errors.New(fmt.Sprintf("job.ShockHost and host for task input not defined"))
					return err
				}
			}
			input_temp := &IO{
				FileName:   filename,
				Name:       input_variable_name,
				Origin:     providing_task_id,
				Host:       shockhost,
				Uncompress: input_arg.Uncompress,
				Cache:      input_arg.Cache,
				ShockIndex: input_arg.ShockIndex,
			}

			if input_arg.Cache {
				predata = append(predata, input_temp)
			} else {
				inputs = append(inputs, input_temp)
			}
		}

		input_variable_value = filename

	case Ait_string:
		logger.Debug(1, fmt.Sprintf("processing: %s", apptype2string(resource_type)))
		input_variable_value = input_arg.Value
		if input_variable_value == "" {
			return errors.New(fmt.Sprintf("no value found for variable name: %s", input_variable_name))
		}

	default:
		err = errors.New(fmt.Sprintf("Resource type unknown: %s", resource_type))
		return err
	} // end switch

	app_variables[input_variable_name] = AppVariable{Value: input_variable_value, Var_type: resource_type}

	logger.Debug(1, fmt.Sprintf("from task definition: input_variable_name: \"%s\", input_variable_value: \"%s\"", input_variable_name, input_variable_value))
	// can overwrite defaults from the app-definition

	return
}

// read variables and (optionally) populate with input nodes
// also transfers information from app defintions to app inputs
// 1) for reading variables, it needs only acm.Get_default_app_variables(), job and task will be nil
// 2) for populating input nodes it needs output of 2 !
// this is done server-side !
func (acm AppCommandMode) ParseAppInput(app_variables AppVariables, args_array []AppResource, job *Job, task *Task, taskid2task map[string]*Task) (err error) {

	if err != nil {
		return
	}

	//var inputs IOmap
	//var outputs IOmap

	if job != nil {

		if task == nil {
			err = errors.New(fmt.Sprintf("error: task pointer is empty"))
			return err
		}

		//if task.Inputs == nil {
		//	task.Inputs = make(IOmap)
		//}
		//inputs = task.Inputs
		//outputs = task.Outputs
	}

	name2pos := make(map[string]int)
	for acm_pos, acm_arg := range acm.Input {

		if acm_arg.Name == "" {
			acm_arg.Name = "anonymous_input." + strconv.Itoa(acm_pos)
		}

		_, found := name2pos[acm_arg.Name]
		if found {
			err = errors.New(fmt.Sprintf("error: app input name \"%s\" is not unique", acm_arg.Name))
			return err
		}
		name2pos[acm_arg.Name] = acm_pos

	}

	//app_variables

	//reg_equal := regexp.MustCompile(`\s*=\s*`)

	for arg_position, input_arg := range args_array {
		logger.Debug(1, fmt.Sprintf("reading task input position: %d", arg_position))
		logger.Debug(1, fmt.Sprintf("resource: %s", input_arg.Resource))

		var input_variable_name = input_arg.Key // can be used by any resource

		//logger.Debug(1, fmt.Sprintf("Key: %s", input_arg.Key))
		//logger.Debug(1, fmt.Sprintf("Value: %s", input_arg.Value))

		var input_variable_type_expected = Ait_undefined

		resource_type, err := String2apptype(input_arg.Resource)

		if err != nil {
			err = errors.New(fmt.Sprintf("app input type undefined err=%s", err.Error()))
			return err
		}

		if resource_type == Ait_undefined {
			err = errors.New(fmt.Sprintf("app input type undefined"))
			return err
		}

		if input_variable_name == "" {
			if arg_position >= len(acm.Input) {
				err = errors.New(fmt.Sprintf("app input at position %d not defined in app defintion (task: %s)", arg_position, task.Id))
				return err
			}
			input_variable_name = acm.Input[arg_position].Name // use position to infer key name
			input_arg.Key = input_variable_name                // name the unnamed key
		}

		if input_variable_name == "" {
			return errors.New(fmt.Sprintf("error: name/key for argument not found"))
		}

		acm_pos, acm_found := name2pos[input_variable_name]
		if !acm_found {
			return errors.New(fmt.Sprintf("error: name %s not found", input_variable_name))
		}

		if acm.Input[acm_pos].Cache { // cache if app def or app input indicate cache, this cannot disable cache
			input_arg.Cache = true
		}

		if input_arg.ShockIndex == "" && acm.Input[acm_pos].ShockIndex != "" { // app input can overwrite app def
			input_arg.ShockIndex = acm.Input[acm_pos].ShockIndex
		}

		app_var, ok := app_variables[input_variable_name]
		if !ok {
			err = errors.New(fmt.Sprintf("variable \"%s\" not found in app_variables, possible: ", input_variable_name, variable_keys_2_string(app_variables)))
			return err
		}

		input_variable_type_expected = app_var.Var_type
		//, err = string2apptype(acm.Input[arg_position][0])
		if input_variable_type_expected == Ait_undefined {
			err = errors.New(fmt.Sprintf("app input type undefined"))
			return err
		}

		if !resource_type.HasType(input_variable_type_expected) {
			err = errors.New(fmt.Sprintf("types do not match, %s, %s", apptype2string(resource_type), apptype2string(input_variable_type_expected)))
			return err
		}

		if resource_type == Ait_list {

			for pos, element := range input_arg.List { // TODO make sure only one resource type is used in list
				element_type, err := String2apptype(element.Resource)
				if err != nil {
					err = errors.New(fmt.Sprintf("app input type undefined err=%s", err.Error()))
					return err
				}
				if element_type != Ait_task && element_type != Ait_shock && element_type != Ait_url {
					err = errors.New(fmt.Sprintf("error: elements in resource list can only be of type task, shock or url"))
					return err
				}
				element.Key = input_variable_name + "." + strconv.Itoa(pos)

				err = ParseResource(element, app_variables, job, task, taskid2task)
				if err != nil {
					err = errors.New(fmt.Sprintf("ParseResource failed, err=%s", err.Error()))
					return err
				}

			}
		} else {

			err = ParseResource(input_arg, app_variables, job, task, taskid2task)
			if err != nil {
				err = errors.New(fmt.Sprintf("ParseResource failed, err=%s", err.Error()))
				return err
			}

		}
	}

	return
}

func NewVariableExpander(app_variables AppVariables) VariableExpander {

	return VariableExpander{simple_variable_match: regexp.MustCompile(`\$\{[\w-\.]+\}`), // inlcudes underscore
		functional_variable_match: regexp.MustCompile(`\$\{[\w-]+\:[\w-\.]+\}`),
		app_variables:             app_variables}
}

func (va VariableExpander) Expand(line string) (expanded string, err error) {

	replace_functional_app_variables := func(variable string) string {
		//cut name out of brackets....
		logger.Debug(1, fmt.Sprintf("f_variable: %s", variable))
		var variable_name = variable[2 : len(variable)-1]
		logger.Debug(1, fmt.Sprintf("f_variable_name: %s", variable_name))

		f_var := strings.Split(variable_name, ":")

		if len(f_var) != 2 {

			err = errors.New(fmt.Sprintf("number of colons != 2"))

			return "ERROR"
		}

		function_command := f_var[0]
		function_argument := f_var[1]

		if function_command == "remove_extension" {
			extension := path.Ext(function_argument)
			//logger.Debug(1, fmt.Sprintf("extension: %s", extension))
			if extension != "" {
				function_argument = strings.TrimSuffix(function_argument, extension)
				//logger.Debug(1, fmt.Sprintf("trimmed: %s", function_argument))
			}
			logger.Debug(1, fmt.Sprintf("modified function_argument: %s", function_argument))

		} else if function_command == "option" {

			function_argument_obj, ok := va.app_variables[function_argument]
			if !ok {
				logger.Debug(1, fmt.Sprintf("function_argument not found %s", function_argument))
				err = errors.New(fmt.Sprintf("warning: (Expand_app_variables) value of variable %s is empty: ", function_argument))
				return "ERROR"
			}
			function_argument_value := function_argument_obj.Value
			if function_argument_value == "" {
				if function_argument_obj.Optional {
					return ""
				} else {
					logger.Debug(1, fmt.Sprintf("value of function_argument \"%s\" empty", function_argument))
					err = errors.New(fmt.Sprintf("function_argument_value empty"))
					return "ERROR"
				}
			}
			logger.Debug(1, fmt.Sprintf("function_argument_value: %s ", function_argument_value))
			//app_var, ok := va.app_variables[]
			option := function_argument_obj.Option

			sigil := "--" // TODO make the prefix -- configurable

			if option == "" {
				option = sigil + function_argument + "="
			}

			return option + function_argument_value

		} else {
			logger.Debug(1, fmt.Sprintf("warning: (Expand_app_variables) functional variable %s not recognized", variable))

			return variable
		}

		return function_argument

	}

	replace_app_variables := func(variable string) string {
		//cut name out of brackets....
		logger.Debug(1, fmt.Sprintf("variable: %s", variable))
		var variable_name = variable[2 : len(variable)-1]
		logger.Debug(1, fmt.Sprintf("variable_name: %s", variable_name))
		app_var, ok := va.app_variables[variable_name]

		if ok {

			if app_var.Value == "" {
				logger.Debug(1, fmt.Sprintf("warning: (Expand_app_variables) value of variable %s is empty: ", variable_name))
			}

			logger.Debug(1, fmt.Sprintf("app_var.Value: %s", app_var.Value))
			return app_var.Value
		}
		logger.Debug(1, fmt.Sprintf("warning: could not find variable for variable_name: %s", variable_name))
		return variable
	}

	expanded_last := line

	expanded = ""
	for expanded != expanded_last { // that should make nested variables possible ! ;-)))

		expanded = expanded_last

		expanded2 := va.functional_variable_match.ReplaceAllStringFunc(expanded, replace_functional_app_variables)
		if err != nil {
			return
		}
		logger.Debug(1, fmt.Sprintf("functional expansion: %s -> %s", expanded, expanded2))

		expanded_last = va.simple_variable_match.ReplaceAllStringFunc(expanded2, replace_app_variables)
		if err != nil {
			return
		}
		logger.Debug(1, fmt.Sprintf("simple expansion: %s -> %s", expanded2, expanded_last))
		// last for-loop should not change anything
	}

	if line != expanded {
		logger.Debug(1, fmt.Sprintf("expanded: %s -> %s", line, expanded))
	} else {
		logger.Debug(1, fmt.Sprintf("not expanded: %s", line))
	}

	return
}

func Expand_app_variables(app_variables AppVariables, cmd_script []string) (err error) {

	expander := NewVariableExpander(app_variables)

	// for all lines in cmd_script, substitute app variables
	for cmd_line_index, _ := range cmd_script {
		//cmd_script[cmd_line_index] = match.ReplaceAllStringFunc(cmd_script[cmd_line_index], replace_app_variables)
		cmd_script[cmd_line_index], err = expander.Expand(cmd_script[cmd_line_index])
		if err != nil {
			return err
		}
	}
	return
}