path: root/include/utils.h

//! @file utils.h
#ifndef OMC_UTILS_H
#define OMC_UTILS_H
#include <stdio.h>
#include <stdlib.h>
#include <dirent.h>
#include <string.h>
#include <unistd.h>
#include <limits.h>
#include <errno.h>
#include "system.h"

#if defined(OMC_OS_WINDOWS)
#define PATH_ENV_VAR "path"
#define DIR_SEP "\\"
#define PATH_SEP ";"
#define LINE_SEP "\r\n"
#else
#define PATH_ENV_VAR "PATH"
#define DIR_SEP "/"
#define PATH_SEP ":"
#define LINE_SEP "\n"
#endif

#define OMC_XML_PRETTY_PRINT_PROG "xmllint"
#define OMC_XML_PRETTY_PRINT_ARGS "--format"

typedef int (ReaderFn)(size_t line, char **);

/**
 * Change directory. Push path on directory stack.
 *
 * ```c
 * pushd("/somepath");
 *
 * FILE fp = fopen("somefile", "w"); // i.e. /somepath/somefile
 * fprintf(fp, "Hello world.\n");
 * fclose(fp);
 *
 * popd();
 * ```
 *
 * @param path of directory
 * @return 0 on success, -1 on error
 */
int pushd(const char *path);

/**
 * Return from directory. Pop last path from directory stack.
 *
 * @see pushd
 * @return 0 on success, -1 if stack is empty
 */
int popd(void);

/**
 * Expand "~" to the user's home directory
 *
 * ```c
 * char *home = expandpath("~");             // == /home/username
 * char *config = expandpath("~/.config");   // == /home/username/.config
 * char *nope = expandpath("/tmp/test");     // == /tmp/test
 * char *nada = expandpath("/~/broken");     // == /~/broken
 *
 * free(home);
 * free(config);
 * free(nope);
 * free(nada);
 * ```
 *
 * @param _path (Must start with a `~`)
 * @return success=expanded path or original path, failure=NULL
 */
char *expandpath(const char *_path);

/**
 * Remove a directory tree recursively
 *
 * ```c
 * mkdirs("a/b/c");
 * rmtree("a");
 * // a/b/c is removed
 * ```
 *
 * @param _path
 * @return 0 on success, -1 on error
 */
int rmtree(char *_path);


char **file_readlines(const char *filename, size_t start, size_t limit, ReaderFn *readerFn);

/**
 * Strip directory from file name
 * Note: Caller is responsible for freeing memory
 *
 * @param _path
 * @return success=file name, failure=NULL
 */
char *path_basename(char *path);

/**
 * Return parent directory of file, or the parent of a directory
 *
 * @param path
 * @return success=directory, failure=empty string
 */
char *path_dirname(char *path);

/**
 * Scan PATH directories for a named program
 * @param name program name
 * @return path to program, or NULL on error
 */
char *find_program(const char *name);

/**
 * Create an empty file, or update modified timestamp on an existing file
 * @param filename file to touch
 * @return 0 on success, 1 on error
 */
int touch(const char *filename);

/**
 * Clone a git repository
 *
 * ```c
 * struct Process proc;
 * memset(proc, 0, sizeof(proc));
 *
 * if (git_clone(&proc, "https://github.com/myuser/myrepo", "./repos", "unstable_branch")) {
 *     fprintf(stderr, "Failed to clone repository\n");
 *     exit(1);
 * }
 *
 * if (pushd("./repos/myrepo")) {
 *     fprintf(stderr, "Unable to enter repository directory\n");
 * } else {
 *     // do something with repository
 *     popd();
 * }
 * ```
 *
 * @see pushd
 *
 * @param proc Process struct
 * @param url URL (or file system path) of repoistory to clone
 * @param destdir destination directory
 * @param gitref commit/branch/tag of checkout (NULL will use HEAD of default branch for repo)
 * @return exit code from "git"
 */
int git_clone(struct Process *proc, char *url, char *destdir, char *gitref);

/**
 * Git describe wrapper
 * @param path to repository
 * @return output from "git describe", or NULL on error
 */
char *git_describe(const char *path);

/**
 * Git rev-parse wrapper
 * @param path to repository
 * @param args to pass to git rev-parse
 * @return output from "git rev-parse", or NULL on error
 */
char *git_rev_parse(const char *path, char *args);

/**
 * Helper function to initialize simple OMC internal path strings
 *
 * ```c
 * char *mypath = NULL;
 *
 * if (path_store(&mypath, PATH_MAX, "/some", "path")) {
 *     fprintf(stderr, "Unable to allocate memory for path elements\n");
 *     exit(1);
 * }
 * // mypath is allocated to size PATH_MAX and contains the string: /some/path
 * // base+path will truncate at maxlen - 1
 * ```
 *
 * @param destptr address of destination string pointer
 * @param maxlen maximum length of the path
 * @param base path
 * @param path to append to base
 * @return 0 on success, -1 on error
 */
int path_store(char **destptr, size_t maxlen, const char *base, const char *path);

#define OMC_MSG_SUCCESS 0
//! Suppress printing of the message text
#define OMC_MSG_NOP 1 << 0
//! The message is an error
#define OMC_MSG_ERROR 1 << 1
//! The message is a warning
#define OMC_MSG_WARN 1 << 2
//! The message will be indented once
#define OMC_MSG_L1 1 << 3
//! The message will be indented twice
#define OMC_MSG_L2 1 << 4
//! The message will be indented thrice
#define OMC_MSG_L3 1 << 5
//! The message will only be printed in verbose mode
#define OMC_MSG_RESTRICT 1 << 6

void msg(unsigned type, char *fmt, ...);

// Enter an interactive shell that ends the program on-exit
void debug_shell();

/**
 * Creates a temporary file returning an open file pointer via @a fp, and the
 * path to the file. The caller is responsible for closing @a fp and
 * free()ing the returned file path.
 *
 * ```c
 * FILE *fp = NULL;
 * char *tempfile = xmkstemp(&fp, "r+");
 * if (!fp || !tempfile) {
 *     fprintf(stderr, "Failed to generate temporary file for read/write\n");
 *     exit(1);
 * }
 * ```
 *
 * @param fp pointer to FILE (to be initialized)
 * @param mode fopen() style file mode string
 * @return system path to the temporary file
 * @return NULL on failure
 */
char *xmkstemp(FILE **fp, const char *mode);

/**
 * Is the path an empty directory structure?
 *
 * ```c
 * if (isempty_dir("/some/path")) {
 *     fprintf(stderr, "The directory is is empty!\n");
 * } else {
 *     printf("The directory contains dirs/files\n");
 * }
 * ```
 *
 * @param path directory
 * @return 0 = no, 1 = yes
 */
int isempty_dir(const char *path);

/**
 * Rewrite an XML file with a pretty printer command
 * @param filename path to modify
 * @param pretty_print_prog program to call
 * @param pretty_print_args arguments to pass to program
 * @return 0 on success, -1 on error
 */
int xml_pretty_print_in_place(const char *filename, const char *pretty_print_prog, const char *pretty_print_args);
#endif //OMC_UTILS_H