1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
|
/* Copyright (C) 2026 Ramin Seyed Moussavi, Yacoub Automation GmbH <ramin.moussavi@yacoub.de>
This file is part of the JWT C Library
SPDX-License-Identifier: MPL-2.0
This Source Code Form is subject to the terms of the Mozilla Public
License, v. 2.0. If a copy of the MPL was not distributed with this
file, You can obtain one at http://mozilla.org/MPL/2.0/. */
/**
* JSON backend abstraction for libjwt.
*
* Common interface header for all JSON backends (jansson, json-c).
* Each backend provides a .c file implementing these functions.
*/
#ifndef JWT_JSON_OPS_H
#define JWT_JSON_OPS_H
#include <stddef.h>
#include <stdint.h>
#include <stdio.h>
#include <jwt_export.h>
/* ================================================================
* Types
* ================================================================ */
/** Opaque JSON type - backends cast internally to the real lib struct */
typedef struct jwt_json_s jwt_json_t;
typedef int64_t jwt_json_int_t;
#define JWT_JSON_ERROR_TEXT_LENGTH 160
#define JWT_JSON_ERROR_SOURCE_LENGTH 80
typedef struct {
char text[JWT_JSON_ERROR_TEXT_LENGTH];
char source[JWT_JSON_ERROR_SOURCE_LENGTH];
int line;
int column;
size_t position;
} jwt_json_error_t;
/* ================================================================
* Flags
* ================================================================ */
/* Encoding */
#define JWT_JSON_INDENT(n) ((n) & 0x1F)
#define JWT_JSON_COMPACT 0x20
#define JWT_JSON_SORT_KEYS 0x80
/* Decoding */
#define JWT_JSON_REJECT_DUPLICATES 0x01
#define JWT_JSON_DECODE_ANY 0x08
/* ================================================================
* Memory allocator override
* ================================================================ */
JWT_NO_EXPORT
void jwt_json_set_alloc(void *(*alloc_func)(size_t),
void (*free_func)(void *));
/* ================================================================
* Reference counting & auto cleanup
* ================================================================ */
JWT_NO_EXPORT
void jwt_json_releasep(jwt_json_t **json);
#define jwt_json_auto_t jwt_json_t __attribute__((cleanup(jwt_json_releasep)))
JWT_NO_EXPORT
void jwt_json_release(jwt_json_t *json);
/* ================================================================
* Object creation
* ================================================================ */
JWT_NO_EXPORT
jwt_json_t *jwt_json_create(void);
JWT_NO_EXPORT
jwt_json_t *jwt_json_create_arr(void);
JWT_NO_EXPORT
jwt_json_t *jwt_json_create_str(const char *value);
JWT_NO_EXPORT
jwt_json_t *jwt_json_create_int(jwt_json_int_t value);
JWT_NO_EXPORT
jwt_json_t *jwt_json_create_bool(int value);
/* ================================================================
* Object operations
* ================================================================ */
JWT_NO_EXPORT
jwt_json_t *jwt_json_obj_get(const jwt_json_t *object, const char *key);
JWT_NO_EXPORT
int jwt_json_obj_set(jwt_json_t *object, const char *key, jwt_json_t *value);
JWT_NO_EXPORT
int jwt_json_obj_del(jwt_json_t *object, const char *key);
JWT_NO_EXPORT
int jwt_json_obj_clear(jwt_json_t *object);
JWT_NO_EXPORT
int jwt_json_obj_merge(jwt_json_t *object, jwt_json_t *other);
JWT_NO_EXPORT
int jwt_json_obj_merge_new(jwt_json_t *object, jwt_json_t *other);
/* ================================================================
* Array operations
* ================================================================ */
JWT_NO_EXPORT
size_t jwt_json_arr_size(const jwt_json_t *array);
JWT_NO_EXPORT
jwt_json_t *jwt_json_arr_get(const jwt_json_t *array, size_t index);
JWT_NO_EXPORT
int jwt_json_arr_append(jwt_json_t *array, jwt_json_t *value);
#define jwt_json_arr_foreach(array, index, value) \
for ((index) = 0; \
(index) < jwt_json_arr_size(array) && \
((value) = jwt_json_arr_get((array), (index))); \
(index)++)
/* ================================================================
* Type checking
* ================================================================ */
JWT_NO_EXPORT
int jwt_json_is_array(const jwt_json_t *json);
JWT_NO_EXPORT
int jwt_json_is_string(const jwt_json_t *json);
JWT_NO_EXPORT
int jwt_json_is_int(const jwt_json_t *json);
JWT_NO_EXPORT
int jwt_json_is_bool(const jwt_json_t *json);
JWT_NO_EXPORT
int jwt_json_is_true(const jwt_json_t *json);
/* ================================================================
* Value extraction
* ================================================================ */
JWT_NO_EXPORT
const char *jwt_json_str_val(const jwt_json_t *json);
JWT_NO_EXPORT
jwt_json_int_t jwt_json_int_val(const jwt_json_t *json);
/* ================================================================
* Deep copy
* ================================================================ */
JWT_NO_EXPORT
jwt_json_t *jwt_json_clone(const jwt_json_t *value);
/* ================================================================
* Serialization / Parsing
* ================================================================ */
JWT_NO_EXPORT
char *jwt_json_serialize(const jwt_json_t *json, size_t flags);
JWT_NO_EXPORT
jwt_json_t *jwt_json_parse(const char *input, size_t flags,
jwt_json_error_t *error);
JWT_NO_EXPORT
jwt_json_t *jwt_json_parse_buf(const char *buffer, size_t buflen,
size_t flags, jwt_json_error_t *error);
JWT_NO_EXPORT
jwt_json_t *jwt_json_parse_file(const char *path, size_t flags,
jwt_json_error_t *error);
JWT_NO_EXPORT
jwt_json_t *jwt_json_parse_fp(FILE *input, size_t flags,
jwt_json_error_t *error);
#endif /* JWT_JSON_OPS_H */
|
