ascii-chat
Binary v0.16.50-198-g78f51665f
Library lib/v0.3.2-2240-g78f51665f
Video chat in your terminal
Loading...
Searching...
No Matches
options/strings.c
Go to the documentation of this file.
1
13
14/* Existing buffer budgets in bytes, including NUL for text storage. */
15#define MODE_NAME_CAPACITY 32
16
17#include <options/options.h> // For asciichat_mode_t and MODE_ enums
18#include <options/strings.h>
19#include <libflags/levenshtein.h>
20#include <options/enums.h>
22#include <libplatform/terminal.h> // For terminal color modes
23#include <ascii-chat/video/ascii/palette.h> // For palette_type_t
24#include <ascii-chat/common.h>
25#include <string.h>
26#include <stdio.h>
27
28// ============================================================================
29// Mode String Conversions
30// ============================================================================
31
35typedef struct {
37 const char *name;
38 const char *description;
40
48static const mode_string_mapping_t mode_registry[] = {
49 {MODE_SERVER, "server", "Multi-client video chat server"}, {MODE_CLIENT, "client", "Connect to ascii-chat server"},
50 {MODE_MIRROR, "mirror", "Local webcam preview (no networking)"}, {MODE_DISCOVERY_SERVICE, "discovery-service", "Session discovery server (ACDS)"},
51 {MODE_DISCOVERY_SERVICE, "acds", "Alias for discovery-service"}, {MODE_MCP_SERVER, "mcp-server", "MCP rendering server"},
52 {MODE_API_SERVER, "api-server", "HTTP image-to-ASCII API"}, {MODE_INVALID, NULL, NULL} // Terminator
53};
54
56 // Special case: MODE_DISCOVERY is the default mode, show as "default" to users
57 if (mode == MODE_DISCOVERY) {
58 return "default";
59 }
60
61 for (size_t i = 0; mode_registry[i].name != NULL; i++) {
62 if (mode_registry[i].mode == mode) {
63 return mode_registry[i].name;
64 }
65 }
66 return "unknown";
67}
68
70 if (!str) {
71 return MODE_INVALID;
72 }
73
74 for (size_t i = 0; mode_registry[i].name != NULL; i++) {
75 if (strcmp(mode_registry[i].name, str) == 0) {
76 return mode_registry[i].mode;
77 }
78 }
79
80 return MODE_INVALID;
81}
82
83bool asciichat_is_valid_mode_string(const char *str) {
85}
86
87size_t asciichat_get_all_mode_strings(const char ***out_names) {
88 static const char *names[MODE_NAME_CAPACITY]; // Max 32 modes
89 size_t count = 0;
90
91 for (size_t i = 0; mode_registry[i].name != NULL && count < MODE_NAME_CAPACITY; i++) {
92 // The HTTP API entry point is selected by its dedicated launcher and is
93 // not a user-facing mode for generic mode completion/help lists.
94 if (mode_registry[i].mode == MODE_API_SERVER || strcmp(mode_registry[i].name, "acds") == 0)
95 continue;
96 // Skip duplicates (like "acds" alias)
97 bool duplicate = false;
98 for (size_t j = 0; j < count; j++) {
99 if (strcmp(names[j], mode_registry[i].name) == 0) {
100 duplicate = true;
101 break;
102 }
103 }
104 if (!duplicate) {
105 names[count++] = mode_registry[i].name;
106 }
107 }
108
109 if (out_names) {
110 *out_names = names;
111 }
112 return count;
113}
114
115const char *asciichat_suggest_mode(const char *input) {
116 if (!input) {
117 return NULL;
118 }
119
120 const char **names = NULL;
121 size_t count = asciichat_get_all_mode_strings(&names);
122
123 // Create a NULL-terminated array for libflags suggestion matching.
124 static const char *null_terminated[MODE_NAME_CAPACITY + 1]; // Max 32 modes + NULL
125 for (size_t i = 0; i < count && i < MODE_NAME_CAPACITY; i++) {
126 null_terminated[i] = names[i];
127 }
128 null_terminated[count] = NULL;
129
130 return levenshtein_find_similar(input, null_terminated);
131}
132
133// ============================================================================
134// Color Mode String Conversions
135// ============================================================================
136
137const char *color_mode_to_string(terminal_color_mode_t mode) {
138 switch (mode) {
139 case TERM_COLOR_AUTO:
140 return OPT_COLOR_MODE_AUTO;
141 case TERM_COLOR_NONE:
142 return OPT_COLOR_MODE_NONE;
143 case TERM_COLOR_16:
144 return OPT_COLOR_MODE_16;
145 case TERM_COLOR_256:
146 return OPT_COLOR_MODE_256;
147 case TERM_COLOR_TRUECOLOR:
149 default:
150 return "unknown";
151 }
152}
153
154// ============================================================================
155// Render Mode String Conversions
156// ============================================================================
157
158const char *render_mode_to_string(terminal_render_mode_t mode) {
159 switch (mode) {
160 case RENDER_MODE_FOREGROUND:
162 case RENDER_MODE_BACKGROUND:
164 case RENDER_MODE_HALF_BLOCK:
166 default:
167 return "unknown";
168 }
169}
170
171// ============================================================================
172// Palette Type String Conversions
173// ============================================================================
174
176 switch (type) {
177 case PALETTE_STANDARD:
179 case PALETTE_BLOCKS:
180 return OPT_PALETTE_BLOCKS;
181 case PALETTE_DIGITAL:
182 return OPT_PALETTE_DIGITAL;
183 case PALETTE_MINIMAL:
184 return OPT_PALETTE_MINIMAL;
185 case PALETTE_COOL:
186 return OPT_PALETTE_COOL;
187 case PALETTE_CUSTOM:
188 return OPT_PALETTE_CUSTOM;
189 default:
190 return "unknown";
191 }
192}
193
194// ============================================================================
195// Generic Enum Value Fuzzy Matching
196// ============================================================================
197
198const char *asciichat_suggest_enum_value(const char *option_name, const char *input) {
199 if (!option_name || !input) {
200 return NULL;
201 }
202
203 size_t value_count = 0;
204 const char **values = options_registry_get_enum_values(option_name, NULL, &value_count);
205 return values ? levenshtein_find_similar(input, values) : NULL;
206}
Option enum value definitions - single source of truth.
#define OPT_PALETTE_CUSTOM
Definition enums.h:125
#define OPT_PALETTE_COOL
Definition enums.h:124
#define OPT_RENDER_MODE_FOREGROUND
Definition enums.h:128
#define OPT_RENDER_MODE_HALF_BLOCK
Definition enums.h:132
#define OPT_COLOR_MODE_256
Definition enums.h:101
#define OPT_COLOR_MODE_NONE
Definition enums.h:98
#define OPT_PALETTE_MINIMAL
Definition enums.h:123
#define OPT_PALETTE_BLOCKS
Definition enums.h:121
#define OPT_PALETTE_STANDARD
Definition enums.h:120
#define OPT_COLOR_MODE_TRUECOLOR
Definition enums.h:102
#define OPT_PALETTE_DIGITAL
Definition enums.h:122
#define OPT_RENDER_MODE_BACKGROUND
Definition enums.h:130
#define OPT_COLOR_MODE_AUTO
Definition enums.h:97
#define OPT_COLOR_MODE_16
Definition enums.h:100
asciichat_mode_t
Mode type for options parsing.
Definition options.h:916
const char * levenshtein_find_similar(const char *unknown, const char *const *candidates)
Find the most similar string from a NULL-terminated array.
@ MODE_CLIENT
Client mode - network client options.
Definition options.h:918
@ MODE_MCP_SERVER
Model Context Protocol rendering server.
Definition options.h:922
@ MODE_DISCOVERY_SERVICE
Discovery server mode - session management and WebRTC signaling.
Definition options.h:920
@ MODE_API_SERVER
Image-to-ASCII HTTP API server.
Definition options.h:923
@ MODE_INVALID
Invalid mode.
Definition options.h:924
@ MODE_SERVER
Server mode - network server options.
Definition options.h:917
@ MODE_MIRROR
Mirror mode - local webcam viewing (no network).
Definition options.h:919
@ MODE_DISCOVERY
Discovery mode - participant that can dynamically become host.
Definition options.h:921
palette_type_t
Built-in palette type enumeration.
Definition palette.h:96
@ PALETTE_BLOCKS
Unicode block characters: " ░░▒▒▓▓██".
Definition palette.h:102
@ PALETTE_CUSTOM
User-defined via –palette-chars.
Definition palette.h:110
@ PALETTE_COOL
Ascending blocks: " ▁▂▃▄▅▆▇█".
Definition palette.h:108
@ PALETTE_STANDARD
Standard ASCII palette: " ...',;:clodxkO0KXNWM".
Definition palette.h:100
@ PALETTE_DIGITAL
Digital/glitch aesthetic: " -=≡≣▰▱◼".
Definition palette.h:104
@ PALETTE_MINIMAL
Simple ASCII: " .-+*#".
Definition palette.h:106
⚙️ Common definitions, error codes, macros, and types shared throughout the application
Central registry of all command-line options with mode applicability.
const char * color_mode_to_string(terminal_color_mode_t mode)
Convert color mode enum to string.
asciichat_mode_t asciichat_string_to_mode(const char *str)
Convert string to mode enum.
const char * render_mode_to_string(terminal_render_mode_t mode)
const char * asciichat_mode_to_string(asciichat_mode_t mode)
Convert mode enum to string.
const char * asciichat_suggest_mode(const char *input)
Suggest closest matching mode using fuzzy matching.
bool asciichat_is_valid_mode_string(const char *str)
Check if string is a valid mode name.
size_t asciichat_get_all_mode_strings(const char ***out_names)
Get all mode strings.
const char * palette_type_to_string(palette_type_t type)
Convert palette type enum to string.
const char * asciichat_suggest_enum_value(const char *option_name, const char *input)
Suggest closest matching enum value using fuzzy matching.
#define MODE_NAME_CAPACITY
Centralized enum and mode string conversion API.
⚙️ Unified options parsing system for ascii-chat with builder pattern and lock-free access
ASCII Palette Management for Video-to-ASCII Conversion.
const char ** options_registry_get_enum_values(const char *option_name, const char ***descriptions, size_t *count)
Get enum values for an option.
Definition public_api.c:272
🔤 String Manipulation and Shell Escaping Utilities
Mode name mapping for string conversion.
asciichat_mode_t mode