/*
 * @file:   system.hh
 * @author: Jordan P. Lefebvre
 *
 * Created on October 23, 2017, 16:34 PM
 */

#ifndef RADIX_RADIXCORE_SYSTEM_HH_
#define RADIX_RADIXCORE_SYSTEM_HH_

#include <fstream>
#include <string>
#include <vector>

#include "radixcore/visibility.hh"

namespace radix
{
/**
 * @brief Provides platform independent popen call
 * function creates a pipe and asynchronously executes a spawned
 * copy of the command processor with the specified string command
 * Default open mode of "r".
 * Open mode options:<br/>
 * <ul><li> "r" - read standard output</li>
 * <li> "w" - write standard input</li>
 * <li> "b" - open in binary mode </li>
 * <li> "t" - open in text mode </li>
 * @return <b>FILE*</b> nullptr on error
 */
RADIX_PUBLIC FILE *pipe_open(const std::string &command,
                             const std::string &mode = "r");

/**
 * @brief Provides platform independent pclose call
 * Returns the exit status of the terminating command processor,
 * or –1 if an error occurs.
 * @param pipe <b>FILE*</b> stream to close
 * @return process return code
 */
RADIX_PUBLIC int pipe_close(FILE *pipe);

/**
 * @brief Sets the environment variable {@code var} to the value
 * @param var <b>std::string</b>
 * @param value <b> std::string</b>
 */
RADIX_PUBLIC void set_env(const std::string &var, const std::string &value);

/**
 * @brief Retrieve the environment variable {@code var}
 * @param var <b>std::string</b>
 * @return  <b>std::string</b>
 */
RADIX_PUBLIC std::string env(const std::string &var);

/**
 * @brief Get hostname of this computer
 */
RADIX_PUBLIC std::string computer_name();

/**
 * @brief Get the separator character
 * Useful for abstracting platform differences
 * @return <b>char</b>
 */
RADIX_PUBLIC char separator_char(char forceSep = ' ');
/**
 * @brief Get the alternate separator character
 * Useful for abstracting platform differences
 * @return <b>char</b>
 */
RADIX_PUBLIC char alt_separator_char();

/**
 * @brief Update provided path to be native
 * Useful for abstracting platform differences
 * @return <b>std::string</b>
 */
RADIX_PUBLIC std::string to_native_path(const std::string &path);

/**
 * @brief Retrieves the current working directory
 * @return <b>std::string</b>
 */
RADIX_PUBLIC std::string current_dir();

/**
 * @brief Cross-platform, non-QT path listing with globs
 * Perform a file listing using using "dir /B "+spec on windows
 * and "ls -1 "+spec otherwise.  The result is returned in a vector
 * of strings with a return value of false if paths are empty.
 * @param spec <b>std::string</b> path specification (including globs)
 * @param path <b>std::vector<std::string></b> resultant paths
 * @param append <b>bool</b> whether to append to existing paths (default=false)
 * @return <b>bool</b> - false if no matching paths
 */
RADIX_PUBLIC bool get_paths(const std::string &spec,
                            std::vector<std::string> &paths,
                            bool append = false);

/**
 * @brief repeatedly call getPaths on each element
 * @param path <b>std::vector<std::string></b> resultant paths
 * @return <b>bool</b> - false if no matching paths
 */
RADIX_PUBLIC bool expand_paths(std::vector<std::string> &paths);

/**
 * @brief expand the input path via expand_paths
 * @param path <b>std::string</b> input/output path
 * @return <b>bool</b> - false if no matching path
 */
RADIX_PUBLIC bool expand_path(std::string &path);

/**
 * @brief Retrieves the current working directory's name
 * @return <b>std::string</b>
 */
RADIX_PUBLIC std::string current_dirname();

/**
 * @brief designed to behave identical to unix util dirname
 * @param path <b>std::string</b> file system path
 * @return <b>std::string</b> file system path to the directory containing
 * the last file/directory listed
 */
RADIX_PUBLIC std::string dirname(const std::string &path, char forceSep = ' ');

/**
 * @brief designed to behave identical to unix util basename
 * @param path <b>std::string</b> file system path
 * @return <b>std::string</b> file system name of the directory containing
 * the last file/directory listed
 */
RADIX_PUBLIC std::string basename(const std::string &path,
                                  bool removeExtension = false,
                                  char forceSep        = ' ');

/**
 * @brief get the file extension
 * The file extension is extracted as the last sequence of non-"." characters
 * after the last ".". If there is no "." then the empty string "" is returned.
 * @param path <b>std::string</b> file system path
 * @return <b>std::string</b> extension or empty
 */
RADIX_PUBLIC std::string file_extension(const std::string &path);

/**
 * @brief Changes the current working directory to the specified directory
 * On Windows the string must not exceed MAX_PATH characters, including
 * the terminating null character. The final character before the null
 * character must be a backslash ("\"). If you do not specify the
 * backslash, it will be added for you; therefore, specify MAX_PATH-2
 * characters for the path unless you include the trailing backslash,
 * in which case, specify MAX_PATH-1 characters for the path
 * @param directory <b>std::string</b>
 * @return bool
 */
RADIX_PUBLIC bool set_current_dir(const std::string &directory);

/**
 * @brief Does this path exist?
 */
RADIX_PUBLIC bool path_exists(const std::string &path);

/**
 * @brief Does this file exist?
 */
RADIX_PUBLIC bool file_exists(const std::string &file);

/**
 * @brief Does this directory exist?
 */
RADIX_PUBLIC bool dir_exists(const std::string &directory);

/**
 * @brief Create a directory
 * @return true if success
 */
RADIX_PUBLIC bool make_dir(const std::string &path);

/**
 * @brief Remove an empty directory
 * @return true if success
 */
RADIX_PUBLIC bool remove_dir(const std::string &path);

/**
 * @brief Remove a single file
 * @return true if success
 */
RADIX_PUBLIC bool remove_file(const std::string &path);

}  // namespace radix

#endif /** RADIX_RADIXCORE_SYSTEM_HH_ */