= NAME =
run_python

= SYNOPSIS =
run_python <arguments>

= DESCRIPTION =
This is a helper function to execute a python program using the python interpreter.  If ORIG_PATH is set, then python is invoked, with the specified
arguments, with PATH=$ORIG_PATH.  Otherwise, python is invoked with the
current PATH.

= EXAMPLES =
Here are some sample invocations:
{{{#!YellowBox
  run_python $PYTHON_ARGS $FUEGO_SCRIPTS_PATH/parser/dataload.py $JOB_NAME $DATA_FILE $REF_FILE
}}}

= ENVIRONMENT and ARGUMENTS =
This functions uses the following environment variables:
 * ORIG_PATH - if non-zero, is used to set PATH before python is invoked

All positional arguments are passed unmodified to the python interpreter command line.

= RETURN =
Returns the result of the python program invocation.

= SOURCE =
Located in ''scripts/common.sh''

= SEE ALSO =