options/common.h

Go to the documentation of this file.

 
#pragma once
 
#ifndef OPTIONS_COMMON_H
#define OPTIONS_COMMON_H
 
#include "../options/options.h"
#ifdef _WIN32
#include "../os/windows/getopt.h"
#else
#include <getopt.h>
#endif
#include <libplatform/terminal.h>
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
// ============================================================================
// Option Parsing Helpers
// ============================================================================

const char *find_similar_option(const char *unknown_opt, const struct option *options);

const char *format_available_modes(option_mode_bitmask_t mode_bitmask);

int strtoint_safe(const char *str);

static inline asciichat_error_t option_error_invalid(void) {
  return ERROR_INVALID_PARAM;
}

char *validate_required_argument(const char *optarg, char *argbuf, size_t argbuf_size, const char *option_name,
                                 asciichat_mode_t mode);

bool validate_positive_int_opt(const char *value_str, int *out_value, const char *param_name);

bool validate_port_opt(const char *value_str, uint16_t *out_port);

bool validate_fps_opt(const char *value_str, int *out_fps);

bool validate_webcam_index(const char *value_str, unsigned short int *out_index);

asciichat_error_t validate_options_and_report(const void *config, const void *opts);

asciichat_error_t detect_default_ssh_key(char *key_path, size_t path_size);
 
// ============================================================================
// Argument Processing Helpers
// ============================================================================

char *strip_equals_prefix(const char *opt_value, char *buffer, size_t buffer_size);

char *get_required_argument(const char *opt_value, char *buffer, size_t buffer_size, const char *option_name,
                            asciichat_mode_t mode);

char *read_password_from_stdin(const char *prompt);
 
// ============================================================================
// Shared Option Parsers (Client + Mirror Common Options)
// ============================================================================

asciichat_error_t parse_color_mode_option(const char *value_str, options_t *opts);

asciichat_error_t parse_render_mode_option(const char *value_str, options_t *opts);

asciichat_error_t parse_palette_option(const char *value_str, options_t *opts);

asciichat_error_t parse_palette_chars_option(const char *value_str, options_t *opts);

asciichat_error_t parse_width_option(const char *value_str, options_t *opts);

asciichat_error_t parse_height_option(const char *value_str, options_t *opts);

asciichat_error_t parse_webcam_index_option(const char *value_str, options_t *opts);

asciichat_error_t parse_snapshot_delay_option(const char *value_str, options_t *opts);

asciichat_error_t parse_log_level_option(const char *value_str, options_t *opts);
 
// ============================================================================
// Terminal Dimension Utilities
// ============================================================================

void update_dimensions_for_full_height(options_t *opts);

void update_dimensions_to_terminal_size(options_t *opts);

void print_project_links(FILE *desc);
 
#ifdef __cplusplus
}
#endif
 
#endif // OPTIONS_COMMON_H