path.h

Go to the documentation of this file.

#pragma once

 
#include <stddef.h>
#include <stdbool.h>
 
#include "../common.h"
 
/* ============================================================================
 * Path Constants
 * ============================================================================
 */

#define PATH_COMPONENT_DOT '.'

#define PATH_COMPONENT_DOTDOT ".."

#define PATH_TILDE '~'

#define PATH_DRIVE_SEPARATOR ':'

#define MAX_PATH_BASES 16
 
/* ============================================================================
 * Path Manipulation Functions
 * ============================================================================
 */

const char *extract_project_relative_path(const char *file, const char *const *owned_dirs);

const char *path_last_components(const char *path, size_t component_count);

char *expand_path(const char *path);

char *get_config_dir(void);

char *get_data_dir(void);

char *get_log_dir(void);

char *get_discovery_database_dir(void);

bool path_normalize_copy(const char *path, char *out, size_t out_len);

bool path_is_absolute(const char *path);

bool path_is_within_base(const char *path, const char *base);

bool path_is_within_any_base(const char *path, const char *const *bases, size_t base_count);

 * @brief Classification for user-supplied filesystem paths.
 */
typedef enum {
  PATH_ROLE_CONFIG_FILE, 
  PATH_ROLE_LOG_FILE,    
  PATH_ROLE_KEY_PRIVATE, 
  PATH_ROLE_KEY_PUBLIC,  
  PATH_ROLE_CLIENT_KEYS  
} path_role_t;

bool path_looks_like_path(const char *value);

asciichat_error_t path_validate_user_path(const char *input, path_role_t role, char **normalized_out);

void path_cleanup_thread_locals(void);