libamxd  6.4.1
Data Model Manager
test_amxd_parameter.c
Go to the documentation of this file.
1 /****************************************************************************
2 **
3 ** SPDX-License-Identifier: BSD-2-Clause-Patent
4 **
5 ** SPDX-FileCopyrightText: Copyright (c) 2023 SoftAtHome
6 **
7 ** Redistribution and use in source and binary forms, with or without modification,
8 ** are permitted provided that the following conditions are met:
9 **
10 ** 1. Redistributions of source code must retain the above copyright notice,
11 ** this list of conditions and the following disclaimer.
12 **
13 ** 2. Redistributions in binary form must reproduce the above copyright notice,
14 ** this list of conditions and the following disclaimer in the documentation
15 ** and/or other materials provided with the distribution.
16 **
17 ** Subject to the terms and conditions of this license, each copyright holder
18 ** and contributor hereby grants to those receiving rights under this license
19 ** a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable
20 ** (except for failure to satisfy the conditions of this license) patent license
21 ** to make, have made, use, offer to sell, sell, import, and otherwise transfer
22 ** this software, where such license applies only to those patent claims, already
23 ** acquired or hereafter acquired, licensable by such copyright holder or contributor
24 ** that are necessarily infringed by:
25 **
26 ** (a) their Contribution(s) (the licensed copyrights of copyright holders and
27 ** non-copyrightable additions of contributors, in source or binary form) alone;
28 ** or
29 **
30 ** (b) combination of their Contribution(s) with the work of authorship to which
31 ** such Contribution(s) was added by such copyright holder or contributor, if,
32 ** at the time the Contribution is added, such addition causes such combination
33 ** to be necessarily infringed. The patent license shall not apply to any other
34 ** combinations which include the Contribution.
35 **
36 ** Except as expressly stated above, no rights or licenses from any copyright
37 ** holder or contributor is granted under this license, whether expressly, by
38 ** implication, estoppel or otherwise.
39 **
40 ** DISCLAIMER
41 **
42 ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
43 ** AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
44 ** IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
45 ** ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
46 ** LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
47 ** DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
48 ** SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
49 ** CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
50 ** OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
51 ** USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
52 **
53 ****************************************************************************/
54 
55 #include <stdlib.h>
56 #include <stdarg.h>
57 #include <stddef.h>
58 #include <setjmp.h>
59 #include <fcntl.h>
60 #include <unistd.h>
61 #include <signal.h>
62 #include <cmocka.h>
63 
64 #include <amxc/amxc.h>
65 #include <amxp/amxp_signal.h>
66 #include <amxp/amxp_slot.h>
67 
68 #include <amxd/amxd_common.h>
69 #include <amxd/amxd_dm.h>
70 #include <amxd/amxd_object.h>
71 #include <amxd/amxd_parameter.h>
72 
73 #include "test_amxd_parameter.h"
74 
75 #include <amxc/amxc_macros.h>
76 void test_amxd_parameter_new_delete(UNUSED void** state) {
77  amxd_param_t* param = NULL;
78 
79  assert_int_equal(amxd_param_new(&param, "Param1", AMXC_VAR_ID_CSTRING), 0);
80  assert_ptr_not_equal(param, NULL);
81  assert_int_equal(amxc_var_type_of(&param->value), AMXC_VAR_ID_CSTRING);
82  assert_int_equal(param->attr.templ, 0);
83  assert_int_equal(param->attr.instance, 0);
84  assert_int_equal(param->attr.priv, 0);
85  assert_int_equal(param->attr.read_only, 0);
86  assert_int_equal(param->attr.persistent, 0);
87  assert_int_equal(param->attr.variable, 0);
88 
89  amxd_param_delete(&param);
90  assert_ptr_equal(param, NULL);
91  amxd_param_delete(&param);
92 
93  assert_int_equal(amxd_param_new(&param, "Param1", AMXC_VAR_ID_CSTRING), 0);
94  assert_ptr_not_equal(param, NULL);
95  amxd_param_delete(&param);
96  amxd_param_delete(NULL);
97  assert_ptr_equal(param, NULL);
98 }
99 
101  amxd_param_t* param = NULL;
102 
103  assert_int_equal(amxd_param_new(&param, "Param1", AMXC_VAR_ID_CSTRING), 0);
104  assert_ptr_not_equal(param, NULL);
105  amxd_param_delete(&param);
106 
107  assert_int_not_equal(amxd_param_new(&param, "Param1", AMXC_VAR_ID_CUSTOM_BASE + 100), 0);
108  assert_ptr_equal(param, NULL);
109 
110  assert_int_not_equal(amxd_param_new(NULL, "Param1", AMXC_VAR_ID_CSTRING), 0);
111  assert_ptr_equal(param, NULL);
112 
113  assert_int_not_equal(amxd_param_new(&param, "123", AMXC_VAR_ID_CSTRING), 0);
114  assert_ptr_equal(param, NULL);
115  assert_int_not_equal(amxd_param_new(&param, "MyParam@test", AMXC_VAR_ID_CSTRING), 0);
116  assert_ptr_equal(param, NULL);
117  assert_int_not_equal(amxd_param_new(&param, "", AMXC_VAR_ID_CSTRING), 0);
118  assert_ptr_equal(param, NULL);
119  assert_int_not_equal(amxd_param_new(&param, NULL, AMXC_VAR_ID_CSTRING), 0);
120  assert_ptr_equal(param, NULL);
121 
122  amxd_param_delete(&param);
123 }
124 
125 void test_amxd_parameter_copy(UNUSED void** state) {
126  amxd_param_t* param = NULL;
127  amxd_param_t* cparam = NULL;
128 
129  assert_int_equal(amxd_param_new(&param, "Param1", AMXC_VAR_ID_BOOL), 0);
130  assert_int_equal(amxd_param_copy(&cparam, param), 0);
131  assert_int_equal(amxc_var_type_of(&cparam->value), AMXC_VAR_ID_BOOL);
132  assert_string_equal(cparam->name, "Param1");
133  assert_int_equal(cparam->attr.templ, 0);
134  assert_int_equal(cparam->attr.instance, 0);
135  assert_int_equal(cparam->attr.priv, 0);
136  assert_int_equal(cparam->attr.read_only, 0);
137  assert_int_equal(cparam->attr.persistent, 0);
138  assert_int_equal(cparam->attr.variable, 0);
139  amxd_param_delete(&cparam);
140 
141  amxd_param_set_flag(param, "TestFlag");
142  assert_int_equal(amxd_param_copy(&cparam, param), 0);
143  assert_true(amxd_param_has_flag(cparam, "TestFlag"));
144 
145  amxd_param_delete(&cparam);
146  amxd_param_delete(&param);
147 }
148 
149 void test_amxd_parameter_copy_invalid(UNUSED void** state) {
150  amxd_param_t* param = NULL;
151  amxd_param_t* cparam = NULL;
152 
153  assert_int_equal(amxd_param_new(&param, "Param1", AMXC_VAR_ID_BOOL), 0);
154  assert_int_not_equal(amxd_param_copy(NULL, param), 0);
155  assert_int_not_equal(amxd_param_copy(&cparam, NULL), 0);
156 
157  amxd_param_delete(&param);
158  amxd_param_delete(&cparam);
159 }
160 
161 void test_amxd_parameter_owner(UNUSED void** state) {
162  amxd_object_t* object1 = NULL;
163  amxd_object_t* object2 = NULL;
164  amxd_param_t* param1 = NULL;
165  amxd_param_t* param2 = NULL;
166 
167  assert_int_equal(amxd_object_new(&object1, amxd_object_singleton, "obj1"), 0);
168  assert_int_equal(amxd_object_new(&object2, amxd_object_singleton, "obj2"), 0);
169  assert_int_equal(amxd_param_new(&param1, "param", AMXC_VAR_ID_CSTRING), 0);
170  assert_int_equal(amxd_param_new(&param2, "param", AMXC_VAR_ID_CSTRING), 0);
171  assert_int_equal(amxd_object_add_param(object1, param1), 0);
172  assert_int_not_equal(amxd_object_add_param(object2, param1), 0);
173 
174  assert_ptr_equal(amxd_param_get_owner(param1), object1);
175  assert_ptr_equal(amxd_param_get_owner(param2), NULL);
176  assert_ptr_equal(amxd_param_get_owner(NULL), NULL);
177 
178  amxd_object_delete(&object1);
179  amxd_object_delete(&object2);
180  amxd_param_delete(&param2);
181 }
182 
183 void test_amxd_parameter_name(UNUSED void** state) {
184  amxd_param_t* param1 = NULL;
185  assert_int_equal(amxd_param_new(&param1, "param", AMXC_VAR_ID_CSTRING), 0);
186  assert_string_equal(amxd_param_get_name(param1), "param");
187  assert_ptr_equal(amxd_param_get_name(NULL), NULL);
188 
189  amxd_param_delete(&param1);
190 }
191 
192 void test_amxd_param_attributes(UNUSED void** state) {
193  amxd_param_t* param = NULL;
194 
195  assert_int_equal(amxd_param_new(&param, "templ_func", AMXC_VAR_ID_CSTRING), 0);
196  assert_false(amxd_param_is_attr_set(param, amxd_pattr_template));
197  assert_false(amxd_param_is_attr_set(param, amxd_pattr_instance));
198  assert_false(amxd_param_is_attr_set(param, amxd_pattr_private));
199  assert_false(amxd_param_is_attr_set(param, amxd_pattr_read_only));
200  assert_false(amxd_param_is_attr_set(param, amxd_pattr_variable));
201  assert_false(amxd_param_is_attr_set(param, amxd_pattr_persistent));
202 
203  assert_int_equal(amxd_param_set_attr(param, amxd_pattr_template, true), 0);
204  assert_true(amxd_param_is_attr_set(param, amxd_pattr_template));
205  assert_int_equal(amxd_param_set_attr(param, amxd_pattr_template, false), 0);
206  assert_false(amxd_param_is_attr_set(param, amxd_pattr_template));
207 
208  assert_int_equal(amxd_param_set_attr(param, amxd_pattr_instance, true), 0);
209  assert_true(amxd_param_is_attr_set(param, amxd_pattr_instance));
210  assert_int_equal(amxd_param_set_attr(param, amxd_pattr_instance, false), 0);
211  assert_false(amxd_param_is_attr_set(param, amxd_pattr_instance));
212 
213  assert_int_equal(amxd_param_set_attr(param, amxd_pattr_private, true), 0);
214  assert_true(amxd_param_is_attr_set(param, amxd_pattr_private));
215  assert_int_equal(amxd_param_set_attr(param, amxd_pattr_private, false), 0);
216  assert_false(amxd_param_is_attr_set(param, amxd_pattr_private));
217 
218  assert_int_equal(amxd_param_set_attr(param, amxd_pattr_read_only, true), 0);
219  assert_true(amxd_param_is_attr_set(param, amxd_pattr_read_only));
220  assert_int_equal(amxd_param_set_attr(param, amxd_pattr_read_only, false), 0);
221  assert_false(amxd_param_is_attr_set(param, amxd_pattr_read_only));
222 
223  assert_int_equal(amxd_param_set_attr(param, amxd_pattr_variable, true), 0);
224  assert_true(amxd_param_is_attr_set(param, amxd_pattr_variable));
225  assert_int_equal(amxd_param_set_attr(param, amxd_pattr_variable, false), 0);
226  assert_false(amxd_param_is_attr_set(param, amxd_pattr_variable));
227 
228  assert_int_equal(amxd_param_set_attr(param, amxd_pattr_persistent, true), 0);
229  assert_true(amxd_param_is_attr_set(param, amxd_pattr_persistent));
230  assert_int_equal(amxd_param_set_attr(param, amxd_pattr_persistent, false), 0);
231  assert_false(amxd_param_is_attr_set(param, amxd_pattr_persistent));
232 
233 
234  assert_int_not_equal(amxd_param_set_attr(NULL, amxd_pattr_persistent, true), 0);
235  assert_false(amxd_param_is_attr_set(NULL, amxd_pattr_persistent));
236 
237  assert_int_equal(amxd_param_set_attrs(param, SET_BIT(amxd_pattr_template) |
242  SET_BIT(amxd_pattr_persistent), false), 0);
243  assert_false(amxd_param_is_attr_set(param, amxd_pattr_template));
244  assert_false(amxd_param_is_attr_set(param, amxd_pattr_instance));
245  assert_false(amxd_param_is_attr_set(param, amxd_pattr_private));
246  assert_false(amxd_param_is_attr_set(param, amxd_pattr_read_only));
247  assert_false(amxd_param_is_attr_set(param, amxd_pattr_variable));
248  assert_false(amxd_param_is_attr_set(param, amxd_pattr_persistent));
249 
250  assert_int_equal(amxd_param_set_attrs(param, SET_BIT(amxd_pattr_template) |
255  SET_BIT(amxd_pattr_persistent), true), 0);
256  assert_true(amxd_param_is_attr_set(param, amxd_pattr_template));
257  assert_true(amxd_param_is_attr_set(param, amxd_pattr_instance));
258  assert_true(amxd_param_is_attr_set(param, amxd_pattr_private));
259  assert_true(amxd_param_is_attr_set(param, amxd_pattr_read_only));
260  assert_true(amxd_param_is_attr_set(param, amxd_pattr_variable));
261  assert_true(amxd_param_is_attr_set(param, amxd_pattr_persistent));
262 
263  assert_int_equal(amxd_param_set_attrs(param, SET_BIT(amxd_pattr_template) |
268  SET_BIT(amxd_pattr_persistent), false), 0);
269  assert_false(amxd_param_is_attr_set(param, amxd_pattr_template));
270  assert_false(amxd_param_is_attr_set(param, amxd_pattr_instance));
271  assert_false(amxd_param_is_attr_set(param, amxd_pattr_private));
272  assert_false(amxd_param_is_attr_set(param, amxd_pattr_read_only));
273  assert_false(amxd_param_is_attr_set(param, amxd_pattr_variable));
274  assert_false(amxd_param_is_attr_set(param, amxd_pattr_persistent));
275 
276  assert_int_not_equal(amxd_param_set_attrs(param, SET_BIT(amxd_pattr_template) |
279  SET_BIT((amxd_pattr_max + 1)), false), 0);
280  assert_int_not_equal(amxd_param_set_attrs(NULL, SET_BIT(amxd_pattr_template) |
282  SET_BIT(amxd_pattr_private), true), 0);
283 
284  amxd_param_delete(&param);
285 }
286 
287 void test_amxd_param_get_value(UNUSED void** state) {
288  amxd_param_t* param = NULL;
289  amxc_var_t value;
290 
291  amxc_var_init(&value);
292  assert_int_equal(amxd_param_new(&param, "Param1", AMXC_VAR_ID_CSTRING), 0);
293  assert_ptr_not_equal(param, NULL);
294 
295  assert_int_equal(amxd_param_get_value(param, &value), 0);
296  assert_int_not_equal(amxd_param_get_value(param, NULL), 0);
297  assert_int_not_equal(amxd_param_get_value(NULL, &value), 0);
298 
299  amxd_param_delete(&param);
300 }
301 
302 void test_amxd_param_set_value(UNUSED void** state) {
303  amxd_param_t* param = NULL;
304  amxc_var_t value;
305 
306  amxc_var_init(&value);
307  amxc_var_set(cstring_t, &value, "ABCD");
308 
309  assert_int_equal(amxd_param_new(&param, "Param1", AMXC_VAR_ID_CSTRING), 0);
310  assert_ptr_not_equal(param, NULL);
311 
312  assert_int_equal(amxd_param_set_value(param, &value), 0);
313  assert_int_not_equal(amxd_param_set_value(param, NULL), 0);
314  assert_int_not_equal(amxd_param_set_value(NULL, &value), 0);
315 
316  amxd_param_delete(&param);
317  amxc_var_clean(&value);
318 }
319 
320 void test_amxd_param_validate(UNUSED void** state) {
321  amxd_param_t* param = NULL;
322  amxc_var_t value;
323 
324  amxc_var_init(&value);
325  amxc_var_set(cstring_t, &value, "ABCD");
326 
327  assert_int_equal(amxd_param_new(&param, "Param1", AMXC_VAR_ID_CSTRING), 0);
328  assert_ptr_not_equal(param, NULL);
329 
330  assert_int_equal(amxd_param_validate(param, &value), 0);
331  assert_int_not_equal(amxd_param_validate(param, NULL), 0);
332  assert_int_not_equal(amxd_param_validate(NULL, &value), 0);
333 
334  amxd_param_delete(&param);
335  amxc_var_clean(&value);
336 }
337 
338 void test_amxd_param_delete(UNUSED void** state) {
339  amxd_param_t* param = NULL;
340 
341  assert_int_equal(amxd_param_new(&param, "Param1", AMXC_VAR_ID_CSTRING), 0);
342  assert_ptr_not_equal(param, NULL);
343 
344  amxd_param_delete(&param);
345  assert_ptr_equal(param, NULL);
346  amxd_param_delete(&param);
347 
348  amxd_param_delete(NULL);
349 
350  amxd_param_delete(&param);
351 }
352 
353 void test_amxd_param_describe(UNUSED void** state) {
354  amxd_param_t* param = NULL;
355  amxc_var_t value;
356 
357  amxc_var_init(&value);
358 
359  assert_int_equal(amxd_param_new(&param, "Param1", AMXC_VAR_ID_CSTRING), 0);
360  assert_ptr_not_equal(param, NULL);
361 
362  assert_int_equal(amxd_param_describe(param, &value), 0);
363  assert_int_equal(amxc_var_type_of(&value), AMXC_VAR_ID_HTABLE);
364  assert_ptr_not_equal(amxc_var_get_key(&value, "name", AMXC_VAR_FLAG_DEFAULT), NULL);
365  assert_ptr_not_equal(amxc_var_get_key(&value, "type_name", AMXC_VAR_FLAG_DEFAULT), NULL);
366  assert_ptr_not_equal(amxc_var_get_key(&value, "type_id", AMXC_VAR_FLAG_DEFAULT), NULL);
367  assert_ptr_not_equal(amxc_var_get_key(&value, "attributes", AMXC_VAR_FLAG_DEFAULT), NULL);
368 
369  assert_int_not_equal(amxd_param_describe(param, NULL), 0);
370  assert_int_not_equal(amxd_param_describe(NULL, &value), 0);
371 
372  amxc_var_clean(&value);
373  amxd_param_delete(&param);
374 }
375 
376 void test_amxd_param_type(UNUSED void** state) {
377  amxd_param_t* param = NULL;
378 
379  assert_int_equal(amxd_param_new(&param, "Param1", AMXC_VAR_ID_CSTRING), 0);
380  assert_ptr_not_equal(param, NULL);
381  assert_int_equal(amxd_param_get_type(param), AMXC_VAR_ID_CSTRING);
382  amxd_param_delete(&param);
383 
384  assert_int_not_equal(amxd_param_new(&param, "Param1", AMXC_VAR_ID_ANY), 0);
385  assert_ptr_equal(param, NULL);
386 
387  assert_int_not_equal(amxd_param_new(&param, "Param1", AMXC_VAR_ID_LIST), 0);
388  assert_ptr_equal(param, NULL);
389 
390  assert_int_not_equal(amxd_param_new(&param, "Param1", AMXC_VAR_ID_HTABLE), 0);
391  assert_ptr_equal(param, NULL);
392 
393  assert_int_not_equal(amxd_param_new(&param, "Param1", AMXC_VAR_ID_CUSTOM_BASE), 0);
394  assert_ptr_equal(param, NULL);
395 
396  assert_int_not_equal(amxd_param_new(&param, "Param1", AMXC_VAR_ID_CUSTOM_BASE + 100), 0);
397  assert_ptr_equal(param, NULL);
398 
399  assert_int_equal(amxd_param_new(&param, "Param1", AMXC_VAR_ID_BOOL), 0);
400  assert_ptr_not_equal(param, NULL);
401  assert_int_equal(amxd_param_get_type(param), AMXC_VAR_ID_BOOL);
402  amxd_param_delete(&param);
403 
404  amxd_param_delete(&param);
405 }
#define SET_BIT(x)
Definition: amxd_common.h:65
Ambiorix Data Model API header file.
Ambiorix Data Model API header file.
amxd_status_t amxd_param_describe(amxd_param_t *const param, amxc_var_t *const value)
amxd_status_t amxd_param_copy(amxd_param_t **dest, const amxd_param_t *const source)
bool amxd_param_is_attr_set(const amxd_param_t *const param, const amxd_pattr_id_t attr)
amxd_status_t amxd_param_set_attrs(amxd_param_t *param, const uint32_t bitmask, bool enable)
const char * amxd_param_get_name(const amxd_param_t *const param)
amxd_status_t amxd_param_validate(amxd_param_t *const param, const amxc_var_t *const value)
amxd_status_t amxd_param_new(amxd_param_t **param, const char *name, const uint32_t type)
amxd_status_t amxd_param_set_value(amxd_param_t *const param, const amxc_var_t *const value)
amxd_status_t amxd_param_set_attr(amxd_param_t *param, const amxd_pattr_id_t attr, const bool enable)
static uint32_t amxd_param_get_type(const amxd_param_t *const param)
bool amxd_param_has_flag(const amxd_param_t *const param, const char *flag)
void amxd_param_set_flag(amxd_param_t *param, const char *flag)
amxd_object_t * amxd_param_get_owner(const amxd_param_t *const param)
amxd_status_t amxd_param_delete(amxd_param_t **param)
amxd_status_t amxd_param_get_value(amxd_param_t *const param, amxc_var_t *const value)
@ amxd_pattr_template
Definition: amxd_types.h:355
@ amxd_pattr_private
Definition: amxd_types.h:357
@ amxd_pattr_persistent
Definition: amxd_types.h:359
@ amxd_pattr_variable
Definition: amxd_types.h:360
@ amxd_pattr_instance
Definition: amxd_types.h:356
@ amxd_pattr_read_only
Definition: amxd_types.h:358
@ amxd_pattr_max
Definition: amxd_types.h:366
@ amxd_object_singleton
Definition: amxd_types.h:181
amxd_status_t amxd_object_add_param(amxd_object_t *const object, amxd_param_t *const param)
Adds a parameter definition to an object.
amxd_status_t amxd_object_new(amxd_object_t **object, const amxd_object_type_t type, const char *name)
Data model object constructor function.
Definition: amxd_object.c:185
void amxd_object_delete(amxd_object_t **object)
Invokes the destroy handler(s) of the object.
uint32_t templ
Definition: amxd_types.h:370
uint32_t persistent
Definition: amxd_types.h:375
uint32_t read_only
Definition: amxd_types.h:374
uint32_t variable
Definition: amxd_types.h:377
uint32_t instance
Definition: amxd_types.h:371
amxc_var_t value
Definition: amxd_types.h:390
amxd_param_attr_t attr
Definition: amxd_types.h:388
void test_amxd_parameter_new_delete_invalid_args(UNUSED void **state)
void test_amxd_param_attributes(UNUSED void **state)
void test_amxd_param_type(UNUSED void **state)
void test_amxd_parameter_name(UNUSED void **state)
void test_amxd_param_get_value(UNUSED void **state)
void test_amxd_param_describe(UNUSED void **state)
void test_amxd_param_delete(UNUSED void **state)
void test_amxd_param_validate(UNUSED void **state)
void test_amxd_parameter_copy(UNUSED void **state)
void test_amxd_param_set_value(UNUSED void **state)
void test_amxd_parameter_new_delete(UNUSED void **state)
void test_amxd_parameter_owner(UNUSED void **state)
void test_amxd_parameter_copy_invalid(UNUSED void **state)