options/common.h

Go to the documentation of this file.

 
#pragma once
 
#ifndef OPTIONS_COMMON_H
#define OPTIONS_COMMON_H
 
#include "../options/options.h"
#include "../platform/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