#ifndef EDI_EXE_H_
# define EDI_EXE_H_

#ifdef __cplusplus
extern "C" {
#endif

/**
 * @file
 * @brief These routines are used for Edi executable management.
 */

/**
 * @brief Executable helpers
 * @defgroup Exe
 *
 * @{
 *
 * Functions of executable management.
 *
 */

/**
 * Run an executable command and wait for it to return.
 *
 * @param command The command to execute in a child process.
 * @return The return code of the executable.
 *
 * @ingroup Exe
 */
EAPI int edi_exe_wait(const char *command);

/**
 * Run an executable command and return command string.
 *
 * @param command The command to execute in a child process.
 * @return The output string of the command.
 *
 * @ingroup Exe
 */
EAPI char *edi_exe_response(const char *command);

/**
 * Run an executable command with notifcation enabled.
 *
 * @param name The name of the resource used to identify the notification.
 * @param command The command to execute in a child process.
 *
 * @ingroup Exe
 */
EAPI void edi_exe_notify(const char *name, const char *command);

/**
 * This function is used to set a callback that will execute when an
 * edi_exe_response has terminated and supplied its exit status.
 *
 * @param name The name of the resource used to identify the notification.
 * @param func Function that will execute upon receiving exit code of exe.
 * @param data Additional data to pass to the callback.
 *
 * @ingroup Exe
 */
EAPI Eina_Bool edi_exe_notify_handle(const char *name, void ((*func)(int, void *)), void *data);

/**
 * This function launches the project application binary. Used for monitoring a running
 * process state. It's a wrapper for ecore_exe_run but is necessary to keep track of any
 * instance of program being ran.
 *
 * @param command The command to execute.
 * @param flags The ECORE_EXE flags to execute with.
 * @param data  Data to be passed to ecore_exe_run.
 *
 * @return PID of the process after executing.
 */
EAPI pid_t edi_exe_project_run(const char *command, int flags, void *data);

/**
 * Returns the PID of the project executable if running.
 *
 * @return PID if the process exists else -1.
 */
EAPI pid_t edi_exe_project_pid_get(void);

/**
 * Reset the project PID to inactive state.
 */
EAPI void edi_exe_project_pid_reset(void);

/**
 * @}
 */

#ifdef __cplusplus
}
#endif

#endif /* EDI_EXE_H_ */