diff options
author | Cameron Katri <me@cameronkatri.com> | 2021-05-09 14:20:58 -0400 |
---|---|---|
committer | Cameron Katri <me@cameronkatri.com> | 2021-05-09 14:20:58 -0400 |
commit | 5fd83771641d15c418f747bd343ba6738d3875f7 (patch) | |
tree | 5abf0f78f680d9837dbd93d4d4c3933bb7509599 /system_cmds/lsmp.tproj/json.h | |
download | apple_cmds-5fd83771641d15c418f747bd343ba6738d3875f7.tar.gz apple_cmds-5fd83771641d15c418f747bd343ba6738d3875f7.tar.zst apple_cmds-5fd83771641d15c418f747bd343ba6738d3875f7.zip |
Import macOS userland
adv_cmds-176
basic_cmds-55
bootstrap_cmds-116.100.1
developer_cmds-66
diskdev_cmds-667.40.1
doc_cmds-53.60.1
file_cmds-321.40.3
mail_cmds-35
misc_cmds-34
network_cmds-606.40.1
patch_cmds-17
remote_cmds-63
shell_cmds-216.60.1
system_cmds-880.60.2
text_cmds-106
Diffstat (limited to 'system_cmds/lsmp.tproj/json.h')
-rw-r--r-- | system_cmds/lsmp.tproj/json.h | 119 |
1 files changed, 119 insertions, 0 deletions
diff --git a/system_cmds/lsmp.tproj/json.h b/system_cmds/lsmp.tproj/json.h new file mode 100644 index 0000000..2a87a8b --- /dev/null +++ b/system_cmds/lsmp.tproj/json.h @@ -0,0 +1,119 @@ +/* + * Copyright (c) 2017 Apple Inc. All rights reserved. + * + * @APPLE_LICENSE_HEADER_START@ + * + * The contents of this file constitute Original Code as defined in and + * are subject to the Apple Public Source License Version 1.1 (the + * "License"). You may not use this file except in compliance with the + * License. Please obtain a copy of the License at + * http://www.apple.com/publicsource and read it before using this file. + * + * This Original Code and all software distributed under the License are + * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER + * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, + * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT. Please see the + * License for the specific language governing rights and limitations + * under the License. + * + * @APPLE_LICENSE_HEADER_END@ + */ + +/* + * Provides a stream-based API for generating JSON output + * + * Handles tedious tasks like worrying about comma placement (and avoiding trailing commas). + * Assumes strings are already escaped (if necessary) and does no error checking (thus it + * may produce invalid JSON when used improperly). + * + * As a convenience, when the provided `json` stream is NULL (i.e. it was never initialized + * by `JSON_OPEN`) these APIs will do nothing. + * + * Example usage: + * + * JSON_t json = JSON_OPEN("/path/to/output.json") + * JSON_OBJECT_BEGIN(json); // root object + * + * JSON_OBJECT_SET(json, version, %.1f, 1.0); + * JSON_OBJECT_SET_BOOL(json, has_fruit, 1); + * + * // Note the required quotes for strings (formatted or not) + * char *mystr = "hello"; + * JSON_OBJECT_SET(json, formatted_string, "%s", mystr); + * JSON_OBJECT_SET(json, literal_string, "my literal string"); + * + * JSON_KEY(json, fruit_array); + * JSON_ARRAY_BEGIN(json); // fruit_array + * JSON_ARRAY_APPEND(json, "my literal string"); + * JSON_ARRAY_APPEND(json, "<0x%08llx>", 0xface); + * JSON_ARRAY_APPEND(json, %d, 3); + * JSON_ARRAY_END(json); // fruit_array + * + * JSON_OBJECT_END(json); // root object + * JSON_CLOSE(json); + */ + +#ifndef _JSON_H_ +#define _JSON_H_ + +#include <stdio.h> +#include <stdlib.h> +#include <stdbool.h> + +#define _JSON_IF(json, code) \ + if (json != NULL) { \ + code; \ + } +#define _JSON_COMMA(json) \ + if (json->require_comma) { \ + fprintf(json->stream, ","); \ + } + +struct _JSON { + FILE* stream; + bool require_comma; +}; +typedef struct _JSON * JSON_t; + +#pragma mark Open/Close +/* Return a new JSON_t stream */ +static inline JSON_t JSON_OPEN(const char *path) { + JSON_t p = malloc(sizeof(struct _JSON)); + p->stream = fopen(path, "w+"); + p->require_comma = false; + return p; +} + +/* Close an existing JSON stream, removing trailing commas */ +#define JSON_CLOSE(json) _JSON_IF(json, fclose(json->stream); free(json)) + +#pragma mark Keys/Values +/* Output the `key` half of a key/value pair */ +#define JSON_KEY(json, key) _JSON_IF(json, _JSON_COMMA(json); fprintf(json->stream, "\"" #key "\":"); json->require_comma = false) +/* Output the `value` half of a key/value pair */ +#define JSON_VALUE(json, format, ...) _JSON_IF(json, fprintf(json->stream, #format, ##__VA_ARGS__); json->require_comma = true) + +#define _JSON_BEGIN(json, character) _JSON_COMMA(json); fprintf(json->stream, #character); json->require_comma = false; +#define _JSON_END(json, character) fprintf(json->stream, #character); json->require_comma = true; +#define _JSON_BOOL(val) ( val ? "true" : "false" ) + +#pragma mark Objects +/* Start a new JSON object */ +#define JSON_OBJECT_BEGIN(json) _JSON_IF(json, _JSON_BEGIN(json, {)) +/* Set a value in the current JSON object */ +#define JSON_OBJECT_SET(json, key, format, ...) _JSON_IF(json, JSON_KEY(json, key); JSON_VALUE(json, format, ##__VA_ARGS__)) +/* Set a boolean in the current JSON object */ +#define JSON_OBJECT_SET_BOOL(json, key, value) JSON_OBJECT_SET(json, key, %s, _JSON_BOOL(value)) +/* End the current JSON object */ +#define JSON_OBJECT_END(json) _JSON_IF(json, _JSON_END(json, })) + +#pragma mark Arrays +/* Start a new JSON array */ +#define JSON_ARRAY_BEGIN(json) _JSON_IF(json, _JSON_BEGIN(json, [)) +/* Append a value to the current JSON array */ +#define JSON_ARRAY_APPEND(json, format, ...) _JSON_IF(json, _JSON_COMMA(json); JSON_VALUE(json, format, ##__VA_ARGS__)) +/* End the current JSON array */ +#define JSON_ARRAY_END(json) _JSON_IF(json, _JSON_END(json, ])) + +#endif /* _JSON_H_ */ |