libamxd  6.4.1
Data Model Manager
test_amxd_function_add.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 <stdio.h>
57 #include <stdarg.h>
58 #include <stddef.h>
59 #include <setjmp.h>
60 #include <fcntl.h>
61 #include <unistd.h>
62 #include <signal.h>
63 #include <cmocka.h>
64 
65 #include <amxc/amxc.h>
66 #include <amxp/amxp_signal.h>
67 #include <amxp/amxp_slot.h>
68 #include <amxp/amxp_timer.h>
69 
70 #include <amxd/amxd_dm.h>
71 #include <amxd/amxd_object.h>
72 #include <amxd/amxd_object_event.h>
73 #include <amxd/amxd_transaction.h>
74 
75 #include "test_amxd_function_add.h"
76 
77 #include <amxc/amxc_macros.h>
78 static amxd_dm_t dm;
79 
80 int test_function_add_setup(UNUSED void** state) {
81  amxd_object_t* root = NULL;
82  amxd_object_t* singleton = NULL;
83  amxd_object_t* template = NULL;
84  amxd_object_t* template2 = NULL;
85  amxd_object_t* instance = NULL;
86  amxd_param_t* param = NULL;
87  amxd_function_t* func = NULL;
88  amxc_var_t def_val;
89  amxc_var_t* param3_val = NULL;
90 
91  assert_int_equal(amxd_dm_init(&dm), 0);
92  amxc_var_init(&def_val);
93 
94  // object Main
95  assert_int_equal(amxd_object_new(&root, amxd_object_singleton, "Main"), 0);
96  assert_int_equal(amxd_dm_add_root_object(&dm, root), 0);
97 
98  // %persistent object Main.Template[]
99  assert_int_equal(amxd_object_new(&template, amxd_object_template, "Template"), 0);
101  assert_int_equal(amxd_object_add_object(root, template), 0);
102  // string param1
103  assert_int_equal(amxd_param_new(&param, "param1", AMXC_VAR_ID_CSTRING), 0);
104  assert_int_equal(amxd_object_add_param(template, param), 0);
105  // %read-only uint32 param2
106  assert_int_equal(amxd_param_new(&param, "param2", AMXC_VAR_ID_UINT32), 0);
108  assert_int_equal(amxd_object_add_param(template, param), 0);
109  // %unique uint32 param3
110  assert_int_equal(amxd_param_new(&param, "param3", AMXC_VAR_ID_UINT32), 0);
112  assert_int_equal(amxd_object_add_param(template, param), 0);
113  // htable func1(%mandatory %in string arg1, %in uint32 arg2 = 10)
114  assert_int_equal(amxd_function_new(&func, "func1", AMXC_VAR_ID_HTABLE, NULL), 0);
115  assert_int_equal(amxd_function_new_arg(func, "arg1", AMXC_VAR_ID_CSTRING, NULL), 0);
116  amxc_var_set(uint32_t, &def_val, 10);
117  assert_int_equal(amxd_function_new_arg(func, "arg2", AMXC_VAR_ID_UINT32, &def_val), 0);
118  assert_int_equal(amxd_object_add_function(template, func), 0);
119 
120  // %persistent object Main.Template[].SubTemplate[]
121  assert_int_equal(amxd_object_new(&template2, amxd_object_template, "SubTemplate"), 0);
123  assert_int_equal(amxd_object_add_object(template, template2), 0);
124  // string param1
125  assert_int_equal(amxd_param_new(&param, "param1", AMXC_VAR_ID_CSTRING), 0);
126  assert_int_equal(amxd_object_add_param(template2, param), 0);
127 
128  // %persistent object Main.Singleton
129  assert_int_equal(amxd_object_new(&singleton, amxd_object_singleton, "Singleton"), 0);
131  assert_int_equal(amxd_object_add_object(root, singleton), 0);
132  // string param1
133  assert_int_equal(amxd_param_new(&param, "param1", AMXC_VAR_ID_CSTRING), 0);
134  assert_int_equal(amxd_object_add_param(singleton, param), 0);
135  // %read-only uint32 param2
136  assert_int_equal(amxd_param_new(&param, "param2", AMXC_VAR_ID_UINT32), 0);
138  assert_int_equal(amxd_object_add_param(singleton, param), 0);
139  // htable func1(%mandatory %in string arg1, %in uint32 arg2 = 10)
140  assert_int_equal(amxd_function_new(&func, "func1", AMXC_VAR_ID_HTABLE, NULL), 0);
141  assert_int_equal(amxd_function_new_arg(func, "arg1", AMXC_VAR_ID_CSTRING, NULL), 0);
142  amxc_var_set(uint32_t, &def_val, 10);
143  assert_int_equal(amxd_function_new_arg(func, "arg2", AMXC_VAR_ID_UINT32, &def_val), 0);
144  assert_int_equal(amxd_object_add_function(singleton, func), 0);
145 
146  amxc_var_set_type(&def_val, AMXC_VAR_ID_HTABLE);
147  param3_val = amxc_var_add_key(uint32_t, &def_val, "param3", 1);
148  assert_int_equal(amxd_object_add_instance(&instance, template, "Instance1", 0, &def_val), 0);
149  amxc_var_set(uint32_t, param3_val, 2);
150  assert_int_equal(amxd_object_add_instance(&instance, template, "Instance2", 0, &def_val), 0);
151 
152  amxc_var_clean(&def_val);
153  return 0;
154 }
155 
156 int test_function_add_teardown(UNUSED void** state) {
157  amxd_dm_clean(&dm);
158 
159  return 0;
160 }
161 
162 void test_amxd_can_add_instance_object(UNUSED void** state) {
163  amxd_object_t* template = NULL;
164  amxc_var_t retval;
165  amxc_var_t args;
166 
167  amxc_var_init(&args);
168  amxc_var_init(&retval);
169 
170  template = amxd_dm_findf(&dm, "Main.Template");
171  assert_non_null(template);
172 
173  amxc_var_set_type(&args, AMXC_VAR_ID_HTABLE);
174  assert_int_equal(amxd_object_invoke_function(template, "_add", &args, &retval), 0);
175 
176  assert_non_null(GET_ARG(&retval, "index"));
177  assert_non_null(GET_ARG(&retval, "name"));
178 
179  amxc_var_clean(&retval);
180  amxc_var_clean(&args);
181 }
182 
183 void test_amxd_add_can_use_rel_path(UNUSED void** state) {
184  amxd_object_t* root = NULL;
185  amxc_var_t retval;
186  amxc_var_t args;
187  amxc_var_t* params = NULL;
188 
189  amxc_var_init(&args);
190  amxc_var_init(&retval);
191 
192  root = amxd_dm_findf(&dm, "Main.");
193  assert_non_null(root);
194 
195  amxc_var_set_type(&args, AMXC_VAR_ID_HTABLE);
196  amxc_var_add_key(cstring_t, &args, "rel_path", "Template.");
197  params = amxc_var_add_key(amxc_htable_t, &args, "parameters", NULL);
198  amxc_var_add_key(uint32_t, params, "param3", 3);
199  assert_int_equal(amxd_object_invoke_function(root, "_add", &args, &retval), 0);
200 
201  amxc_var_dump(&retval, STDOUT_FILENO);
202  assert_int_equal(amxc_var_type_of(&retval), AMXC_VAR_ID_HTABLE);
203 
204  amxc_var_clean(&retval);
205  amxc_var_clean(&args);
206 }
207 
208 void test_amxd_add_fails_with_invalid_rel_path(UNUSED void** state) {
209  amxd_object_t* root = NULL;
210  amxc_var_t retval;
211  amxc_var_t args;
212 
213  amxc_var_init(&args);
214  amxc_var_init(&retval);
215 
216  root = amxd_dm_findf(&dm, "Main.");
217  assert_non_null(root);
218 
219  amxc_var_set_type(&args, AMXC_VAR_ID_HTABLE);
220  amxc_var_add_key(cstring_t, &args, "rel_path", "NotExisting.Object.");
221  assert_int_not_equal(amxd_object_invoke_function(root, "_add", &args, &retval), 0);
222 
223  amxc_var_clean(&retval);
224  amxc_var_clean(&args);
225 }
226 
227 
228 void test_amxd_add_can_use_to_high_access(UNUSED void** state) {
229  amxd_object_t* singleton = NULL;
230  amxc_var_t retval;
231  amxc_var_t args;
232  amxc_var_t* params = NULL;
233 
234  amxc_var_init(&args);
235  amxc_var_init(&retval);
236 
237  singleton = amxd_dm_findf(&dm, "Main.Template.");
238  assert_non_null(singleton);
239 
240  amxc_var_set_type(&args, AMXC_VAR_ID_HTABLE);
241  amxc_var_add_key(uint32_t, &args, "access", 100);
242  params = amxc_var_add_key(amxc_htable_t, &args, "parameters", NULL);
243  amxc_var_add_key(uint32_t, params, "param3", 4);
244  assert_int_equal(amxd_object_invoke_function(singleton, "_add", &args, &retval), 0);
245 
246  amxc_var_clean(&retval);
247  amxc_var_clean(&args);
248 }
249 
250 void test_amxd_add_fails_on_singleton(UNUSED void** state) {
251  amxd_object_t* object = NULL;
252  amxc_var_t retval;
253  amxc_var_t args;
254 
255  amxc_var_init(&args);
256  amxc_var_init(&retval);
257 
258  object = amxd_dm_findf(&dm, "Main.Singleton");
259  assert_non_null(object);
260 
261  amxc_var_set_type(&args, AMXC_VAR_ID_HTABLE);
262  assert_int_not_equal(amxd_object_invoke_function(object, "_add", &args, &retval), 0);
263 
264  object = amxd_dm_findf(&dm, "Main.");
265  amxc_var_add_key(cstring_t, &args, "rel_path", "Singleton.");
266  assert_int_not_equal(amxd_object_invoke_function(object, "_add", &args, &retval), 0);
267 
268  amxc_var_clean(&retval);
269  amxc_var_clean(&args);
270 }
271 
273  amxd_object_t* root = NULL;
274  amxc_var_t retval;
275  amxc_var_t args;
276  amxc_var_t* params = NULL;
277 
278  amxc_var_init(&args);
279  amxc_var_init(&retval);
280 
281  root = amxd_dm_findf(&dm, "Main.");
282  assert_non_null(root);
283 
284  amxc_var_set_type(&args, AMXC_VAR_ID_HTABLE);
285  amxc_var_add_key(cstring_t, &args, "rel_path", "Template.");
286  params = amxc_var_add_key(amxc_htable_t, &args, "parameters", NULL);
287  amxc_var_add_key(uint32_t, params, "param3", 3);
288  assert_int_not_equal(amxd_object_invoke_function(root, "_add", &args, &retval), 0);
289 
290  amxc_var_clean(&retval);
291  amxc_var_clean(&args);
292 }
293 
295  amxd_object_t* template = NULL;
296  amxc_var_t retval;
297  amxc_var_t args;
298 
299  amxc_var_init(&args);
300  amxc_var_init(&retval);
301 
302  template = amxd_dm_findf(&dm, "Main.Template");
303  assert_non_null(template);
304 
305  amxc_var_set_type(&args, AMXC_VAR_ID_HTABLE);
306  amxc_var_add_key(cstring_t, &args, "rel_path", "*.SubTemplate.");
307  assert_int_equal(amxd_object_invoke_function(template, "_add", &args, &retval), 0);
308  amxc_var_dump(&retval, STDOUT_FILENO);
309 
310  assert_int_equal(amxc_var_type_of(&retval), AMXC_VAR_ID_LIST);
311  assert_string_equal(GETP_CHAR(&retval, "0.path"), "Main.Template.1.SubTemplate.1.");
312  assert_string_equal(GETP_CHAR(&retval, "1.path"), "Main.Template.2.SubTemplate.1.");
313  assert_string_equal(GETP_CHAR(&retval, "2.path"), "Main.Template.3.SubTemplate.1.");
314  assert_string_equal(GETP_CHAR(&retval, "3.path"), "Main.Template.4.SubTemplate.1.");
315 
316  amxc_var_clean(&retval);
317  amxc_var_clean(&args);
318 }
319 
321  amxd_object_t* template = NULL;
322  amxc_var_t retval;
323  amxc_var_t args;
324 
325  amxc_var_init(&args);
326  amxc_var_init(&retval);
327 
328  template = amxd_dm_findf(&dm, "Main.Template");
329  assert_non_null(template);
330 
331  amxc_var_set_type(&args, AMXC_VAR_ID_HTABLE);
332  amxc_var_add_key(cstring_t, &args, "rel_path", "[param3 == 4].SubTemplate.");
333  assert_int_equal(amxd_object_invoke_function(template, "_add", &args, &retval), 0);
334  amxc_var_dump(&retval, STDOUT_FILENO);
335 
336  assert_int_equal(amxc_var_type_of(&retval), AMXC_VAR_ID_LIST);
337  assert_string_equal(GETP_CHAR(&retval, "0.path"), "Main.Template.5.SubTemplate.2.");
338 
339  amxc_var_clean(&retval);
340  amxc_var_clean(&args);
341 }
Ambiorix Data Model API header file.
amxd_object_t * amxd_dm_findf(amxd_dm_t *const dm, const char *abs_path,...) __attribute__((format(printf
Ambiorix Data Model API header file.
Ambiorix Data Model API header file.
amxd_status_t amxd_param_new(amxd_param_t **param, const char *name, const uint32_t type)
amxd_status_t amxd_param_set_attr(amxd_param_t *param, const amxd_pattr_id_t attr, const bool enable)
Ambiorix Data Model API header file.
@ amxd_pattr_unique
Definition: amxd_types.h:363
@ amxd_pattr_read_only
Definition: amxd_types.h:358
@ amxd_oattr_persistent
Definition: amxd_types.h:200
@ amxd_object_template
Definition: amxd_types.h:183
@ amxd_object_singleton
Definition: amxd_types.h:181
amxd_status_t amxd_dm_add_root_object(amxd_dm_t *const dm, amxd_object_t *const object)
Adds an object to the root of the data model.
Definition: amxd_dm.c:418
amxd_status_t amxd_dm_init(amxd_dm_t *dm)
Initializes a data model structure.
Definition: amxd_dm.c:334
void amxd_dm_clean(amxd_dm_t *dm)
Cleans a data model structure.
Definition: amxd_dm.c:365
amxd_status_t amxd_object_add_object(amxd_object_t *const parent, amxd_object_t *const child)
Adds an object in the data model tree.
Definition: amxd_object.c:207
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_add_function(amxd_object_t *const object, amxd_function_t *const func)
Adds an RPC method definition to the object definition.
amxd_status_t amxd_object_invoke_function(amxd_object_t *const object, const char *func_name, amxc_var_t *const args, amxc_var_t *const ret)
Calls an object RPC method.
amxd_status_t amxd_object_set_attr(amxd_object_t *const object, const amxd_oattr_id_t attr, const bool enable)
Sets or unsets an object attribute.
Definition: amxd_object.c:269
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
amxd_status_t amxd_object_add_instance(amxd_object_t **object, amxd_object_t *templ, const char *name, uint32_t index, amxc_var_t *values)
Data model object constructor function.
amxd_status_t amxd_function_new(amxd_function_t **func, const char *name, const uint32_t ret_type, amxd_object_fn_t impl)
Data model RPC method constructor function.
amxd_status_t amxd_function_new_arg(amxd_function_t *func, const char *name, const uint32_t type, amxc_var_t *default_value)
Adds an argument definition to a RPC method definition.
RPC method structure.
Definition: amxd_types.h:341
static amxd_dm_t dm
void test_amxd_can_add_instances_using_searchpath(UNUSED void **state)
void test_amxd_add_can_use_rel_path(UNUSED void **state)
void test_amxd_add_fails_on_singleton(UNUSED void **state)
void test_amxd_add_fails_when_unique_param_is_not_unique(UNUSED void **state)
void test_amxd_add_fails_with_invalid_rel_path(UNUSED void **state)
void test_amxd_add_can_use_to_high_access(UNUSED void **state)
void test_amxd_can_add_instances_using_wildcard(UNUSED void **state)
int test_function_add_setup(UNUSED void **state)
int test_function_add_teardown(UNUSED void **state)
void test_amxd_can_add_instance_object(UNUSED void **state)