Nilorea Library
C utilities for networking, threading, graphics
Loading...
Searching...
No Matches
ex_gui_syntaxview.c
Go to the documentation of this file.
1/*
2 * Nilorea Library
3 * Copyright (C) 2005-2026 Castagnier Mickael
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
14 * implied. See the License for the specific language governing
15 * permissions and limitations under the License.
16 *
17 * SPDX-License-Identifier: Apache-2.0
18 */
19
26
27#define ALLEGRO_UNSTABLE 1
28
29#include <stdio.h>
30#include <stdlib.h>
31#include <string.h>
32#include <unistd.h>
33
34#include "nilorea/n_common.h"
35#include "nilorea/n_log.h"
36#include "nilorea/n_gui.h"
37
38static int log_level = LOG_ERR;
39static int failures = 0;
40
41static int process_args(int argc, char** argv) {
42 int opt;
43 while ((opt = getopt(argc, argv, "V:")) != -1) {
44 switch (opt) {
45 case 'V':
46 if (!strcmp("LOG_NULL", optarg))
48 else if (!strcmp("LOG_NOTICE", optarg))
50 else if (!strcmp("LOG_INFO", optarg))
52 else if (!strcmp("LOG_ERR", optarg))
54 else if (!strcmp("LOG_DEBUG", optarg))
56 else
57 return -1;
58 break;
59 default:
60 return -1;
61 }
62 }
63 return 0;
64}
65
66static void expect_true(const char* label, int cond) {
67 if (!cond) {
68 n_log(LOG_ERR, "%s: condition false", label);
69 failures++;
70 }
71}
72
73int main(int argc, char** argv) {
75 if (process_args(argc, argv) != 0) {
76 fprintf(stderr, "Usage: %s [-V LOG_LEVEL]\n", argv[0]);
77 return 2;
78 }
80
81 if (!al_init() || !al_init_font_addon()) {
82 n_log(LOG_ERR, "allegro init failed");
83 return 1;
84 }
85 ALLEGRO_FONT* font = al_create_builtin_font();
86 if (!font) {
87 n_log(LOG_ERR, "al_create_builtin_font failed");
88 return 1;
89 }
91 if (!gui) {
92 n_log(LOG_ERR, "n_gui_new_ctx failed");
93 al_destroy_font(font);
94 return 1;
95 }
96 n_gui_set_display_size(gui, 800.0f, 600.0f);
97
98 int win = n_gui_add_window(gui, "Panel", 0.0f, 0.0f, 800.0f, 600.0f);
99 expect_true("window created", win >= 0);
100
101 int sv = n_gui_add_syntaxview(gui, win, 0.0f, 0.0f, 600.0f, 400.0f, N_GUI_SYNTAX_HTTP);
102 expect_true("syntaxview created", sv >= 0);
103 expect_true("empty line count is zero", n_gui_syntaxview_get_line_count(gui, sv) == 0);
104
105 const char* http =
106 "GET / HTTP/1.1\r\n"
107 "Host: example.com\r\n"
108 "Accept: */*\r\n"
109 "\r\n"
110 "body line";
112 /* five lines: request, two headers, blank, body */
113 expect_true("http line count is 5", n_gui_syntaxview_get_line_count(gui, sv) == 5);
114
115 /* text-selection and copy API (byte offsets into the text) */
116 expect_true("no selection after set_text", n_gui_syntaxview_get_selected_text(gui, sv) == NULL);
117 {
118 const char* got = n_gui_syntaxview_get_text(gui, sv);
119 expect_true("get_text round-trips", got && strcmp(got, http) == 0);
120 }
122 {
124 expect_true("selection [0,3) is GET", sel && strcmp(sel, "GET") == 0);
125 Free(sel);
126 }
127 n_gui_syntaxview_set_selection(gui, sv, 3, 0); /* reversed range selects the same text */
128 {
130 expect_true("reversed [3,0) is GET", sel && strcmp(sel, "GET") == 0);
131 Free(sel);
132 }
133 n_gui_syntaxview_set_selection(gui, sv, 5, 5); /* an empty range clears the selection */
134 expect_true("empty range clears selection", n_gui_syntaxview_get_selected_text(gui, sv) == NULL);
135 n_gui_syntaxview_set_selection(gui, sv, 0, 100000); /* out-of-range clamps to the length */
136 {
138 expect_true("over-long end clamps to text", sel && strcmp(sel, http) == 0);
139 Free(sel);
140 }
142 {
144 expect_true("select_all returns full text", sel && strcmp(sel, http) == 0);
145 Free(sel);
146 }
147 n_gui_syntaxview_select_all(gui, sv); /* set_text must drop a live selection */
149 expect_true("set_text clears selection", n_gui_syntaxview_get_selected_text(gui, sv) == NULL);
150
152 n_gui_syntaxview_set_text(gui, sv, "{\n \"a\": 1,\n \"b\": \"x\"\n}");
153 expect_true("json line count is 4", n_gui_syntaxview_get_line_count(gui, sv) == 4);
154
155 /* the newer modes accept text like any other mode */
157 n_gui_syntaxview_set_text(gui, sv, "<root>\n <a x=\"1\"/>\n <!-- c -->\n</root>");
158 expect_true("xml line count is 4", n_gui_syntaxview_get_line_count(gui, sv) == 4);
160 n_gui_syntaxview_set_text(gui, sv, "key: value\nlist:\n - one # note\n");
161 expect_true("yaml line count is 4", n_gui_syntaxview_get_line_count(gui, sv) == 4);
163 n_gui_syntaxview_set_text(gui, sv, "function f() {\n return 1; // done\n}\n");
164 expect_true("js line count is 4", n_gui_syntaxview_get_line_count(gui, sv) == 4);
165
166 /* unified diff, as n_diff_to_unified writes it: hunk header, context,
167 removed and added lines */
169 n_gui_syntaxview_set_text(gui, sv, "@@ -1,3 +1,3 @@\n a\n-b\n+B\n c\n");
170 expect_true("diff line count is 6", n_gui_syntaxview_get_line_count(gui, sv) == 6);
171 {
172 const char* got = n_gui_syntaxview_get_text(gui, sv);
173 expect_true("diff text round-trips", got && strstr(got, "-b\n+B\n") != NULL);
174 }
175 /* a line longer than the draw buffer must survive set_text/get_text intact;
176 drawing it is chunked rather than cut short */
177 {
178 char big[2048];
179 size_t pos = 0;
180 big[pos++] = '+';
181 while (pos < sizeof(big) - 2) big[pos++] = 'x';
182 big[pos++] = '\n';
183 big[pos] = '\0';
185 expect_true("long diff line kept whole",
186 n_gui_syntaxview_get_text(gui, sv) != NULL &&
187 strlen(n_gui_syntaxview_get_text(gui, sv)) == strlen(big));
188 }
189
190 /* scroll_to_offset centers the line holding the byte offset */
191 {
192 char big[4096];
193 size_t pos = 0;
194 int line60_offset = 0;
195 for (int ln = 0; ln < 100 && pos + 16 < sizeof(big); ln++) {
196 if (ln == 60) line60_offset = (int)pos;
197 pos += (size_t)snprintf(big + pos, sizeof(big) - pos, "line %03d\n", ln);
198 }
203 expect_true("scroll data reachable", yd != NULL);
204 if (yd) {
205 expect_true("initial scroll is zero", yd->scroll_offset == 0);
206 n_gui_syntaxview_scroll_to_offset(gui, sv, line60_offset);
207 expect_true("scroll moved toward line 60",
208 yd->scroll_offset > 0 && yd->scroll_offset <= 60);
210 expect_true("scroll back to top", yd->scroll_offset == 0);
212 expect_true("over-long offset clamps",
213 yd->scroll_offset > 0 &&
215 }
216 }
217
218 /* horizontal scrolling: a line wider than the widget is reached by panning,
219 since the view does not wrap */
220 {
221 char wide[1024];
222 size_t pos = 0;
223 int long_line_offset;
224 while (pos < sizeof(wide) - 16) wide[pos++] = 'x';
225 wide[pos++] = '\n';
226 long_line_offset = (int)pos - 4; /* near the end of the long line */
227 pos += (size_t)snprintf(wide + pos, sizeof(wide) - pos, "short\n");
228 wide[pos] = '\0';
231 expect_true("content wider than the widget",
232 n_gui_syntaxview_content_width(gui, sv) > 600.0f);
233 expect_true("set_text resets the pan",
236 expect_true("h scroll round-trips",
237 n_gui_syntaxview_get_h_scroll(gui, sv) == 120.0f);
239 expect_true("negative h scroll clamps to zero",
241 /* an offset past the right edge pans the view to it */
242 n_gui_syntaxview_scroll_to_offset(gui, sv, long_line_offset);
243 expect_true("scroll_to_offset pans to a far column",
245 /* one on the first screen leaves the pan where it is useful again */
247 expect_true("scroll_to_offset comes back to column zero",
249 n_gui_syntaxview_set_text(gui, sv, "short line\n");
250 expect_true("narrow content needs no pan",
251 n_gui_syntaxview_content_width(gui, sv) < 600.0f);
252 }
253
255 expect_true("cleared line count is zero", n_gui_syntaxview_get_line_count(gui, sv) == 0);
256
258 al_destroy_font(font);
259
260 if (failures) {
261 n_log(LOG_ERR, "ex_gui_syntaxview: %d failure(s)", failures);
262 return 1;
263 }
264 n_log(LOG_NOTICE, "ex_gui_syntaxview: all checks passed");
265 return 0;
266}
void process_args(int argc, char **argv)
static int failures
Definition ex_atlas.c:51
int main(void)
Definition ex_atlas.c:117
static void expect_true(const char *label, int cond)
Definition ex_atlas.c:53
static int log_level
static N_GUI_CTX * gui
FONT * font
the default 8x8 font, valid after allegro_init()
#define Free(__ptr)
Free Handler to get errors.
Definition n_common.h:263
void * data
widget-specific data (union via void pointer)
Definition n_gui.h:1122
int scroll_offset
first visible line
Definition n_gui.h:813
const char * n_gui_syntaxview_get_text(N_GUI_CTX *ctx, int widget_id)
get the text currently shown by a syntax view
Definition n_gui.c:4971
void n_gui_set_display_size(N_GUI_CTX *ctx, float w, float h)
set the display (viewport) size so global scrollbars can be computed.
Definition n_gui.c:12348
#define N_GUI_SYNTAX_HTTP
syntax view: HTTP message highlighting (request/status line and headers)
Definition n_gui.h:153
float n_gui_syntaxview_get_h_scroll(N_GUI_CTX *ctx, int widget_id)
get the horizontal scroll offset of a syntax view
Definition n_gui.c:5109
void n_gui_syntaxview_set_selection(N_GUI_CTX *ctx, int widget_id, int start, int end)
set the selection range of a syntax view (byte offsets into the text)
Definition n_gui.c:5011
void n_gui_syntaxview_set_h_scroll(N_GUI_CTX *ctx, int widget_id, float px)
set the horizontal scroll offset of a syntax view
Definition n_gui.c:5122
int n_gui_syntaxview_get_line_count(N_GUI_CTX *ctx, int widget_id)
get the number of text lines in a syntax view
Definition n_gui.c:4959
void n_gui_syntaxview_set_mode(N_GUI_CTX *ctx, int widget_id, int mode)
set the highlighting mode of a syntax view
Definition n_gui.c:4947
#define N_GUI_SYNTAX_DIFF
syntax view: unified diff highlighting (added, removed and hunk header lines, as produced by n_diff_t...
Definition n_gui.h:166
#define N_GUI_SYNTAX_XML
syntax view: XML/HTML highlighting (tags, attributes, quoted values, comments)
Definition n_gui.h:157
#define N_GUI_SYNTAX_JSON
syntax view: JSON highlighting (keys, strings, numbers, punctuation)
Definition n_gui.h:155
char * n_gui_syntaxview_get_selected_text(N_GUI_CTX *ctx, int widget_id)
get a copy of the currently selected text in a syntax view
Definition n_gui.c:4984
N_GUI_WIDGET * n_gui_get_widget(N_GUI_CTX *ctx, int widget_id)
Get a widget pointer by id.
Definition n_gui.c:3701
int n_gui_add_syntaxview(N_GUI_CTX *ctx, int window_id, float x, float y, float w, float h, int mode)
Add a read-only syntax-highlighted text view.
Definition n_gui.c:3410
int n_gui_add_window(N_GUI_CTX *ctx, const char *title, float x, float y, float w, float h)
Add a new pseudo-window to the context.
Definition n_gui.c:1277
N_GUI_CTX * n_gui_new_ctx(ALLEGRO_FONT *default_font)
Create a new GUI context.
Definition n_gui.c:1103
void n_gui_destroy_ctx(N_GUI_CTX **ctx)
Destroy a GUI context and all its windows/widgets.
Definition n_gui.c:1209
void n_gui_syntaxview_set_text(N_GUI_CTX *ctx, int widget_id, const char *text)
set (copy) the text shown by a syntax view
Definition n_gui.c:4913
void n_gui_syntaxview_scroll_to_offset(N_GUI_CTX *ctx, int widget_id, int byte_offset)
scroll a syntax view so the line holding a byte offset is vertically centered, and horizontally so th...
Definition n_gui.c:5044
float n_gui_syntaxview_content_width(N_GUI_CTX *ctx, int widget_id)
pixel width the widest line of a syntax view needs, padding included
Definition n_gui.c:5095
void n_gui_syntaxview_select_all(N_GUI_CTX *ctx, int widget_id)
select the entire text of a syntax view
Definition n_gui.c:5031
#define N_GUI_SYNTAX_YAML
syntax view: YAML highlighting (keys, quoted values, list markers, comments)
Definition n_gui.h:159
#define N_GUI_SYNTAX_JS
syntax view: JavaScript highlighting (keywords, strings, numbers, comments)
Definition n_gui.h:161
#define N_GUI_SYNTAX_PLAIN
syntax view: no highlighting
Definition n_gui.h:151
The top-level GUI context that holds all windows.
Definition n_gui.h:1669
syntax view specific data: read-only highlighted text
Definition n_gui.h:805
A single GUI widget.
Definition n_gui.h:1092
#define n_log(__LEVEL__,...)
Logging function wrapper to get line and func.
Definition n_log.h:113
#define LOG_DEBUG
debug-level messages
Definition n_log.h:108
#define LOG_ERR
error conditions
Definition n_log.h:100
void set_log_level(const int log_level)
Set the global log level value ( static int LOG_LEVEL ).
Definition n_log.c:123
#define LOG_NOTICE
normal but significant condition
Definition n_log.h:104
#define LOG_NULL
no log output
Definition n_log.h:70
#define LOG_INFO
informational
Definition n_log.h:106
Common headers and low-level functions & define.
GUI system: buttons, sliders, text areas, checkboxes, scrollbars, dropdown menus, windows.
Generic log system.