| |
1 /* |
| |
2 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. |
| |
3 * |
| |
4 * Copyright 2024 Mike Becker, Olaf Wintermann All rights reserved. |
| |
5 * |
| |
6 * Redistribution and use in source and binary forms, with or without |
| |
7 * modification, are permitted provided that the following conditions are met: |
| |
8 * |
| |
9 * 1. Redistributions of source code must retain the above copyright |
| |
10 * notice, this list of conditions and the following disclaimer. |
| |
11 * |
| |
12 * 2. Redistributions in binary form must reproduce the above copyright |
| |
13 * notice, this list of conditions and the following disclaimer in the |
| |
14 * documentation and/or other materials provided with the distribution. |
| |
15 * |
| |
16 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" |
| |
17 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
| |
18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE |
| |
19 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE |
| |
20 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR |
| |
21 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF |
| |
22 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
| |
23 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN |
| |
24 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) |
| |
25 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE |
| |
26 * POSSIBILITY OF SUCH DAMAGE. |
| |
27 */ |
| |
28 |
| |
29 #include "cx/properties.h" |
| |
30 |
| |
31 #include <assert.h> |
| |
32 |
| |
33 const CxPropertiesConfig cx_properties_config_default = { |
| |
34 '=', |
| |
35 //'\\', |
| |
36 '#', |
| |
37 '\0', |
| |
38 '\0' |
| |
39 }; |
| |
40 |
| |
41 void cxPropertiesInit( |
| |
42 CxProperties *prop, |
| |
43 CxPropertiesConfig config |
| |
44 ) { |
| |
45 memset(prop, 0, sizeof(CxProperties)); |
| |
46 prop->config = config; |
| |
47 } |
| |
48 |
| |
49 void cxPropertiesDestroy(CxProperties *prop) { |
| |
50 cxBufferDestroy(&prop->input); |
| |
51 cxBufferDestroy(&prop->buffer); |
| |
52 } |
| |
53 |
| |
54 int cxPropertiesFilln( |
| |
55 CxProperties *prop, |
| |
56 const char *buf, |
| |
57 size_t len |
| |
58 ) { |
| |
59 if (cxBufferEof(&prop->input)) { |
| |
60 // destroy a possible previously initialized buffer |
| |
61 cxBufferDestroy(&prop->input); |
| |
62 cxBufferInit(&prop->input, (void*) buf, len, |
| |
63 NULL, CX_BUFFER_COPY_ON_WRITE | CX_BUFFER_AUTO_EXTEND); |
| |
64 prop->input.size = len; |
| |
65 } else { |
| |
66 if (cxBufferAppend(buf, 1, len, &prop->input) < len) return -1; |
| |
67 } |
| |
68 return 0; |
| |
69 } |
| |
70 |
| |
71 void cxPropertiesUseStack( |
| |
72 CxProperties *prop, |
| |
73 char *buf, |
| |
74 size_t capacity |
| |
75 ) { |
| |
76 cxBufferInit(&prop->buffer, buf, capacity, NULL, CX_BUFFER_COPY_ON_EXTEND); |
| |
77 } |
| |
78 |
| |
79 CxPropertiesStatus cxPropertiesNext( |
| |
80 CxProperties *prop, |
| |
81 cxstring *key, |
| |
82 cxstring *value |
| |
83 ) { |
| |
84 // check if we have a text buffer |
| |
85 if (prop->input.space == NULL) { |
| |
86 return CX_PROPERTIES_NULL_INPUT; |
| |
87 } |
| |
88 |
| |
89 // a pointer to the buffer we want to read from |
| |
90 CxBuffer *current_buffer = &prop->input; |
| |
91 |
| |
92 // check if we have rescued data |
| |
93 if (!cxBufferEof(&prop->buffer)) { |
| |
94 // check if we can now get a complete line |
| |
95 cxstring input = cx_strn(prop->input.space + prop->input.pos, |
| |
96 prop->input.size - prop->input.pos); |
| |
97 cxstring nl = cx_strchr(input, '\n'); |
| |
98 if (nl.length > 0) { |
| |
99 // we add as much data to the rescue buffer as we need |
| |
100 // to complete the line |
| |
101 size_t len_until_nl = (size_t)(nl.ptr - input.ptr) + 1; |
| |
102 |
| |
103 if (cxBufferAppend(input.ptr, 1, |
| |
104 len_until_nl, &prop->buffer) < len_until_nl) { |
| |
105 return CX_PROPERTIES_BUFFER_ALLOC_FAILED; |
| |
106 } |
| |
107 |
| |
108 // advance the position in the input buffer |
| |
109 prop->input.pos += len_until_nl; |
| |
110 |
| |
111 // we now want to read from the rescue buffer |
| |
112 current_buffer = &prop->buffer; |
| |
113 } else { |
| |
114 // still not enough data, copy input buffer to internal buffer |
| |
115 if (cxBufferAppend(input.ptr, 1, |
| |
116 input.length, &prop->buffer) < input.length) { |
| |
117 return CX_PROPERTIES_BUFFER_ALLOC_FAILED; |
| |
118 } |
| |
119 // reset the input buffer (make way for a re-fill) |
| |
120 cxBufferReset(&prop->input); |
| |
121 return CX_PROPERTIES_INCOMPLETE_DATA; |
| |
122 } |
| |
123 } |
| |
124 |
| |
125 char comment1 = prop->config.comment1; |
| |
126 char comment2 = prop->config.comment2; |
| |
127 char comment3 = prop->config.comment3; |
| |
128 char delimiter = prop->config.delimiter; |
| |
129 |
| |
130 // get one line and parse it |
| |
131 while (!cxBufferEof(current_buffer)) { |
| |
132 const char *buf = current_buffer->space + current_buffer->pos; |
| |
133 size_t len = current_buffer->size - current_buffer->pos; |
| |
134 |
| |
135 /* |
| |
136 * First we check if we have at least one line. We also get indices of |
| |
137 * delimiter and comment chars |
| |
138 */ |
| |
139 size_t delimiter_index = 0; |
| |
140 size_t comment_index = 0; |
| |
141 bool has_comment = false; |
| |
142 |
| |
143 size_t i = 0; |
| |
144 char c = 0; |
| |
145 for (; i < len; i++) { |
| |
146 c = buf[i]; |
| |
147 if (c == comment1 || c == comment2 || c == comment3) { |
| |
148 if (comment_index == 0) { |
| |
149 comment_index = i; |
| |
150 has_comment = true; |
| |
151 } |
| |
152 } else if (c == delimiter) { |
| |
153 if (delimiter_index == 0 && !has_comment) { |
| |
154 delimiter_index = i; |
| |
155 } |
| |
156 } else if (c == '\n') { |
| |
157 break; |
| |
158 } |
| |
159 } |
| |
160 |
| |
161 if (c != '\n') { |
| |
162 // we don't have enough data for a line, use the rescue buffer |
| |
163 assert(current_buffer != &prop->buffer); |
| |
164 // make sure that the rescue buffer does not already contain something |
| |
165 assert(cxBufferEof(&prop->buffer)); |
| |
166 if (prop->buffer.space == NULL) { |
| |
167 // initialize a rescue buffer, if the user did not provide one |
| |
168 cxBufferInit(&prop->buffer, NULL, 256, NULL, CX_BUFFER_AUTO_EXTEND); |
| |
169 } else { |
| |
170 // from a previous rescue there might be already read data |
| |
171 // reset the buffer to avoid unnecessary buffer extension |
| |
172 cxBufferReset(&prop->buffer); |
| |
173 } |
| |
174 if (cxBufferAppend(buf, 1, len, &prop->buffer) < len) { |
| |
175 return CX_PROPERTIES_BUFFER_ALLOC_FAILED; |
| |
176 } |
| |
177 // reset the input buffer (make way for a re-fill) |
| |
178 cxBufferReset(&prop->input); |
| |
179 return CX_PROPERTIES_INCOMPLETE_DATA; |
| |
180 } |
| |
181 |
| |
182 cxstring line = has_comment ? |
| |
183 cx_strn(buf, comment_index) : |
| |
184 cx_strn(buf, i); |
| |
185 // check line |
| |
186 if (delimiter_index == 0) { |
| |
187 // if line is not blank ... |
| |
188 line = cx_strtrim(line); |
| |
189 // ... either no delimiter found, or key is empty |
| |
190 if (line.length > 0) { |
| |
191 if (line.ptr[0] == delimiter) { |
| |
192 return CX_PROPERTIES_INVALID_EMPTY_KEY; |
| |
193 } else { |
| |
194 return CX_PROPERTIES_INVALID_MISSING_DELIMITER; |
| |
195 } |
| |
196 } else { |
| |
197 // skip blank line |
| |
198 // if it was the rescue buffer, return to the original buffer |
| |
199 if (current_buffer == &prop->buffer) { |
| |
200 // assert that the rescue buffer really does not contain more data |
| |
201 assert(current_buffer->pos + i + 1 == current_buffer->size); |
| |
202 // reset the rescue buffer, but don't destroy it! |
| |
203 cxBufferReset(&prop->buffer); |
| |
204 // continue with the input buffer |
| |
205 current_buffer = &prop->input; |
| |
206 } else { |
| |
207 // if it was the input buffer already, just advance the position |
| |
208 current_buffer->pos += i + 1; |
| |
209 } |
| |
210 continue; |
| |
211 } |
| |
212 } else { |
| |
213 cxstring k = cx_strn(buf, delimiter_index); |
| |
214 cxstring val = cx_strn( |
| |
215 buf + delimiter_index + 1, |
| |
216 line.length - delimiter_index - 1); |
| |
217 k = cx_strtrim(k); |
| |
218 val = cx_strtrim(val); |
| |
219 if (k.length > 0) { |
| |
220 *key = k; |
| |
221 *value = val; |
| |
222 current_buffer->pos += i + 1; |
| |
223 assert(current_buffer->pos <= current_buffer->size); |
| |
224 return CX_PROPERTIES_NO_ERROR; |
| |
225 } else { |
| |
226 return CX_PROPERTIES_INVALID_EMPTY_KEY; |
| |
227 } |
| |
228 } |
| |
229 // unreachable - either we returned or skipped a blank line |
| |
230 assert(false); |
| |
231 } |
| |
232 |
| |
233 // when we come to this point, all data must have been read |
| |
234 assert(cxBufferEof(&prop->buffer)); |
| |
235 assert(cxBufferEof(&prop->input)); |
| |
236 |
| |
237 return CX_PROPERTIES_NO_DATA; |
| |
238 } |
| |
239 |
| |
240 static int cx_properties_sink_map( |
| |
241 cx_attr_unused CxProperties *prop, |
| |
242 CxPropertiesSink *sink, |
| |
243 cxstring key, |
| |
244 cxstring value |
| |
245 ) { |
| |
246 CxMap *map = sink->sink; |
| |
247 CxAllocator *alloc = sink->data; |
| |
248 cxmutstr v = cx_strdup_a(alloc, value); |
| |
249 int r = cx_map_put_cxstr(map, key, v.ptr); |
| |
250 if (r != 0) cx_strfree_a(alloc, &v); |
| |
251 return r; |
| |
252 } |
| |
253 |
| |
254 CxPropertiesSink cxPropertiesMapSink(CxMap *map) { |
| |
255 CxPropertiesSink sink; |
| |
256 sink.sink = map; |
| |
257 sink.data = cxDefaultAllocator; |
| |
258 sink.sink_func = cx_properties_sink_map; |
| |
259 return sink; |
| |
260 } |
| |
261 |
| |
262 static int cx_properties_read_string( |
| |
263 CxProperties *prop, |
| |
264 CxPropertiesSource *src, |
| |
265 cxstring *target |
| |
266 ) { |
| |
267 if (prop->input.space == src->src) { |
| |
268 // when the input buffer already contains the string |
| |
269 // we have nothing more to provide |
| |
270 target->length = 0; |
| |
271 } else { |
| |
272 target->ptr = src->src; |
| |
273 target->length = src->data_size; |
| |
274 } |
| |
275 return 0; |
| |
276 } |
| |
277 |
| |
278 static int cx_properties_read_file( |
| |
279 cx_attr_unused CxProperties *prop, |
| |
280 CxPropertiesSource *src, |
| |
281 cxstring *target |
| |
282 ) { |
| |
283 target->ptr = src->data_ptr; |
| |
284 target->length = fread(src->data_ptr, 1, src->data_size, src->src); |
| |
285 return ferror(src->src); |
| |
286 } |
| |
287 |
| |
288 static int cx_properties_read_init_file( |
| |
289 cx_attr_unused CxProperties *prop, |
| |
290 CxPropertiesSource *src |
| |
291 ) { |
| |
292 src->data_ptr = malloc(src->data_size); |
| |
293 if (src->data_ptr == NULL) return 1; |
| |
294 return 0; |
| |
295 } |
| |
296 |
| |
297 static void cx_properties_read_clean_file( |
| |
298 cx_attr_unused CxProperties *prop, |
| |
299 CxPropertiesSource *src |
| |
300 ) { |
| |
301 free(src->data_ptr); |
| |
302 } |
| |
303 |
| |
304 CxPropertiesSource cxPropertiesStringSource(cxstring str) { |
| |
305 CxPropertiesSource src; |
| |
306 src.src = (void*) str.ptr; |
| |
307 src.data_size = str.length; |
| |
308 src.data_ptr = NULL; |
| |
309 src.read_func = cx_properties_read_string; |
| |
310 src.read_init_func = NULL; |
| |
311 src.read_clean_func = NULL; |
| |
312 return src; |
| |
313 } |
| |
314 |
| |
315 CxPropertiesSource cxPropertiesCstrnSource(const char *str, size_t len) { |
| |
316 CxPropertiesSource src; |
| |
317 src.src = (void*) str; |
| |
318 src.data_size = len; |
| |
319 src.data_ptr = NULL; |
| |
320 src.read_func = cx_properties_read_string; |
| |
321 src.read_init_func = NULL; |
| |
322 src.read_clean_func = NULL; |
| |
323 return src; |
| |
324 } |
| |
325 |
| |
326 CxPropertiesSource cxPropertiesCstrSource(const char *str) { |
| |
327 CxPropertiesSource src; |
| |
328 src.src = (void*) str; |
| |
329 src.data_size = strlen(str); |
| |
330 src.data_ptr = NULL; |
| |
331 src.read_func = cx_properties_read_string; |
| |
332 src.read_init_func = NULL; |
| |
333 src.read_clean_func = NULL; |
| |
334 return src; |
| |
335 } |
| |
336 |
| |
337 CxPropertiesSource cxPropertiesFileSource(FILE *file, size_t chunk_size) { |
| |
338 CxPropertiesSource src; |
| |
339 src.src = file; |
| |
340 src.data_size = chunk_size; |
| |
341 src.data_ptr = NULL; |
| |
342 src.read_func = cx_properties_read_file; |
| |
343 src.read_init_func = cx_properties_read_init_file; |
| |
344 src.read_clean_func = cx_properties_read_clean_file; |
| |
345 return src; |
| |
346 } |
| |
347 |
| |
348 CxPropertiesStatus cxPropertiesLoad( |
| |
349 CxProperties *prop, |
| |
350 CxPropertiesSink sink, |
| |
351 CxPropertiesSource source |
| |
352 ) { |
| |
353 assert(source.read_func != NULL); |
| |
354 assert(sink.sink_func != NULL); |
| |
355 |
| |
356 // initialize reader |
| |
357 if (source.read_init_func != NULL) { |
| |
358 if (source.read_init_func(prop, &source)) { |
| |
359 return CX_PROPERTIES_READ_INIT_FAILED; |
| |
360 } |
| |
361 } |
| |
362 |
| |
363 // transfer the data from the source to the sink |
| |
364 CxPropertiesStatus status; |
| |
365 bool found = false; |
| |
366 while (true) { |
| |
367 // read input |
| |
368 cxstring input; |
| |
369 if (source.read_func(prop, &source, &input)) { |
| |
370 status = CX_PROPERTIES_READ_FAILED; |
| |
371 break; |
| |
372 } |
| |
373 |
| |
374 // no more data - break |
| |
375 if (input.length == 0) { |
| |
376 status = found ? CX_PROPERTIES_NO_ERROR : CX_PROPERTIES_NO_DATA; |
| |
377 break; |
| |
378 } |
| |
379 |
| |
380 // set the input buffer and read the k/v-pairs |
| |
381 cxPropertiesFill(prop, input); |
| |
382 |
| |
383 CxPropertiesStatus kv_status; |
| |
384 do { |
| |
385 cxstring key, value; |
| |
386 kv_status = cxPropertiesNext(prop, &key, &value); |
| |
387 if (kv_status == CX_PROPERTIES_NO_ERROR) { |
| |
388 found = true; |
| |
389 if (sink.sink_func(prop, &sink, key, value)) { |
| |
390 kv_status = CX_PROPERTIES_SINK_FAILED; |
| |
391 } |
| |
392 } |
| |
393 } while (kv_status == CX_PROPERTIES_NO_ERROR); |
| |
394 |
| |
395 if (kv_status > CX_PROPERTIES_OK) { |
| |
396 status = kv_status; |
| |
397 break; |
| |
398 } |
| |
399 } |
| |
400 |
| |
401 if (source.read_clean_func != NULL) { |
| |
402 source.read_clean_func(prop, &source); |
| |
403 } |
| |
404 |
| |
405 return status; |
| |
406 } |