libamxd  6.4.1
Data Model Manager
test_amxd_function_del.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_del.h"
76 
77 #include <amxc/amxc_macros.h>
78 static amxd_dm_t dm;
79 
80 int test_function_del_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* sub = 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 
90  assert_int_equal(amxd_dm_init(&dm), 0);
91  amxc_var_init(&def_val);
92 
93  // object Main
94  assert_int_equal(amxd_object_new(&root, amxd_object_singleton, "Main"), 0);
95  assert_int_equal(amxd_dm_add_root_object(&dm, root), 0);
96 
97  // %persistent object Main.Template[]
98  assert_int_equal(amxd_object_new(&template, amxd_object_template, "Template"), 0);
100  assert_int_equal(amxd_object_add_object(root, template), 0);
101  // %unique %key string Alias
102  assert_int_equal(amxd_param_new(&param, "Alias", AMXC_VAR_ID_CSTRING), 0);
103  amxd_param_set_attr(param, amxd_pattr_key, true);
105  assert_int_equal(amxd_object_add_param(template, param), 0);
106  // string param1
107  assert_int_equal(amxd_param_new(&param, "param1", AMXC_VAR_ID_CSTRING), 0);
108  assert_int_equal(amxd_object_add_param(template, param), 0);
109  // %read-only uint32 param2
110  assert_int_equal(amxd_param_new(&param, "param2", 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  // object Main.Template[].Sub[]
121  assert_int_equal(amxd_object_new(&sub, amxd_object_template, "Sub"), 0);
122  assert_int_equal(amxd_object_add_object(template, sub), 0);
123  // %unique %key string Alias
124  assert_int_equal(amxd_param_new(&param, "Alias", AMXC_VAR_ID_CSTRING), 0);
125  amxd_param_set_attr(param, amxd_pattr_key, true);
127  assert_int_equal(amxd_object_add_param(sub, param), 0);
128 
129  // %persistent object Main.Singleton
130  assert_int_equal(amxd_object_new(&singleton, amxd_object_singleton, "Singleton"), 0);
132  assert_int_equal(amxd_object_add_object(root, singleton), 0);
133  // string param1
134  assert_int_equal(amxd_param_new(&param, "param1", AMXC_VAR_ID_CSTRING), 0);
135  assert_int_equal(amxd_object_add_param(singleton, param), 0);
136  // %read-only uint32 param2
137  assert_int_equal(amxd_param_new(&param, "param2", AMXC_VAR_ID_UINT32), 0);
139  assert_int_equal(amxd_object_add_param(singleton, param), 0);
140  // htable func1(%mandatory %in string arg1, %in uint32 arg2 = 10)
141  assert_int_equal(amxd_function_new(&func, "func1", AMXC_VAR_ID_HTABLE, NULL), 0);
142  assert_int_equal(amxd_function_new_arg(func, "arg1", AMXC_VAR_ID_CSTRING, NULL), 0);
143  amxc_var_set(uint32_t, &def_val, 10);
144  assert_int_equal(amxd_function_new_arg(func, "arg2", AMXC_VAR_ID_UINT32, &def_val), 0);
145  assert_int_equal(amxd_object_add_function(singleton, func), 0);
146 
147  assert_int_equal(amxd_object_add_instance(&instance, template, "Instance1", 0, NULL), 0);
148  assert_int_equal(amxd_object_add_instance(&instance, template, "Instance2", 0, NULL), 0);
149  assert_int_equal(amxd_object_add_instance(&instance, template, "Test1", 0, NULL), 0);
150  assert_int_equal(amxd_object_add_instance(&instance, template, "Test2", 0, NULL), 0);
151  assert_int_equal(amxd_object_add_instance(&instance, template, "Test3", 0, NULL), 0);
152  assert_int_equal(amxd_object_add_instance(&instance, template, "YAI1", 0, NULL), 0);
153  assert_int_equal(amxd_object_add_instance(&instance, template, "YAI2", 0, NULL), 0);
154  assert_int_equal(amxd_object_add_instance(&instance, template, "YAI3", 0, NULL), 0);
155  template = amxd_object_findf(instance, "Sub");
156  assert_int_equal(amxd_object_add_instance(&instance, template, "SUBINST", 0, NULL), 0);
157 
158  amxc_var_clean(&def_val);
159  return 0;
160 }
161 
162 int test_function_del_teardown(UNUSED void** state) {
163  amxd_dm_clean(&dm);
164 
165  return 0;
166 }
167 
168 void test_amxd_can_del_instance_object(UNUSED void** state) {
169  amxd_object_t* template = NULL;
170  amxd_object_t* object = NULL;
171  amxc_var_t retval;
172  amxc_var_t args;
173 
174  amxc_var_init(&args);
175  amxc_var_init(&retval);
176 
177  template = amxd_dm_findf(&dm, "Main.Template.");
178  assert_non_null(template);
179  object = amxd_dm_findf(&dm, "Main.Template.1");
180  assert_non_null(object);
181 
182  amxc_var_set_type(&args, AMXC_VAR_ID_HTABLE);
183  assert_int_equal(amxd_object_invoke_function(object, "_del", &args, &retval), 0);
184  assert_int_equal(amxd_object_get_instance_count(template), 7);
185 
186  assert_int_equal(amxc_var_type_of(&retval), AMXC_VAR_ID_LIST);
187 
188  amxc_var_clean(&retval);
189  amxc_var_clean(&args);
190 }
191 
192 void test_amxd_del_can_use_rel_path(UNUSED void** state) {
193  amxd_object_t* template = NULL;
194  amxd_object_t* root = NULL;
195  amxc_var_t retval;
196  amxc_var_t args;
197 
198  amxc_var_init(&args);
199  amxc_var_init(&retval);
200 
201  root = amxd_dm_findf(&dm, "Main.");
202  assert_non_null(root);
203  template = amxd_dm_findf(&dm, "Main.Template.");
204  assert_non_null(template);
205 
206  amxc_var_set_type(&args, AMXC_VAR_ID_HTABLE);
207  amxc_var_add_key(cstring_t, &args, "rel_path", "Template.2.");
208  assert_int_equal(amxd_object_invoke_function(root, "_del", &args, &retval), 0);
209  assert_int_equal(amxd_object_get_instance_count(template), 6);
210 
211  root = amxd_dm_findf(&dm, "Main.Template.");
212  amxc_var_set_type(&args, AMXC_VAR_ID_HTABLE);
213  amxc_var_add_key(uint32_t, &args, "index", 3); // index should be ignored
214  amxc_var_add_key(cstring_t, &args, "rel_path", "[Alias == 'YAI1' || Alias == 'YAI2'].");
215  assert_int_equal(amxd_object_invoke_function(root, "_del", &args, &retval), 0);
216  assert_int_equal(amxd_object_get_instance_count(template), 4);
217 
218  amxc_var_dump(&retval, STDOUT_FILENO);
219  assert_string_equal(GETI_CHAR(&retval, 0), "Main.Template.6.");
220  assert_string_equal(GETI_CHAR(&retval, 1), "Main.Template.6.Sub.");
221  assert_string_equal(GETI_CHAR(&retval, 2), "Main.Template.7.");
222  assert_string_equal(GETI_CHAR(&retval, 3), "Main.Template.7.Sub.");
223 
224  amxc_var_clean(&retval);
225  amxc_var_clean(&args);
226 }
227 
228 void test_amxd_del_fails_with_invalid_rel_path(UNUSED void** state) {
229  amxd_object_t* template = NULL;
230  amxd_object_t* root = NULL;
231  amxc_var_t retval;
232  amxc_var_t args;
233 
234  amxc_var_init(&args);
235  amxc_var_init(&retval);
236 
237  root = amxd_dm_findf(&dm, "Main.");
238  assert_non_null(root);
239  template = amxd_dm_findf(&dm, "Main.Template.");
240  assert_non_null(template);
241 
242  amxc_var_set_type(&args, AMXC_VAR_ID_HTABLE);
243  amxc_var_add_key(cstring_t, &args, "rel_path", "NotExisting.Object.");
244  assert_int_not_equal(amxd_object_invoke_function(root, "_del", &args, &retval), 0);
245  assert_int_equal(amxd_object_get_instance_count(template), 4);
246  amxc_var_clean(&retval);
247  amxc_var_clean(&args);
248 }
249 
250 
251 void test_amxd_del_can_use_to_high_access(UNUSED void** state) {
252  amxd_object_t* template = NULL;
253  amxc_var_t retval;
254  amxc_var_t args;
255 
256  amxc_var_init(&args);
257  amxc_var_init(&retval);
258 
259  template = amxd_dm_findf(&dm, "Main.Template.");
260  assert_non_null(template);
261 
262  amxc_var_set_type(&args, AMXC_VAR_ID_HTABLE);
263  amxc_var_add_key(uint32_t, &args, "access", 100);
264  amxc_var_add_key(cstring_t, &args, "name", "Test1");
265  assert_int_equal(amxd_object_invoke_function(template, "_del", &args, &retval), 0);
266  assert_int_equal(amxd_object_get_instance_count(template), 3);
267 
268  amxc_var_clean(&retval);
269  amxc_var_clean(&args);
270 }
271 
272 void test_amxd_del_fails_on_singleton(UNUSED void** state) {
273  amxd_object_t* template = NULL;
274  amxd_object_t* object = NULL;
275  amxc_var_t retval;
276  amxc_var_t args;
277 
278  amxc_var_init(&args);
279  amxc_var_init(&retval);
280 
281  object = amxd_dm_findf(&dm, "Main.Singleton");
282  assert_non_null(object);
283  template = amxd_dm_findf(&dm, "Main.Template.");
284  assert_non_null(template);
285 
286  amxc_var_set_type(&args, AMXC_VAR_ID_HTABLE);
287  assert_int_not_equal(amxd_object_invoke_function(object, "_del", &args, &retval), 0);
288 
289  object = amxd_dm_findf(&dm, "Main.");
290  amxc_var_add_key(cstring_t, &args, "rel_path", "Singleton.");
291  assert_int_not_equal(amxd_object_invoke_function(object, "_del", &args, &retval), 0);
292  assert_int_equal(amxd_object_get_instance_count(template), 3);
293 
294  amxc_var_clean(&retval);
295  amxc_var_clean(&args);
296 }
297 
299  amxd_object_t* template = NULL;
300  amxd_object_t* root = NULL;
301  amxc_var_t retval;
302  amxc_var_t args;
303 
304  amxc_var_init(&args);
305  amxc_var_init(&retval);
306 
307  root = amxd_dm_findf(&dm, "Main.");
308  assert_non_null(root);
309  template = amxd_dm_findf(&dm, "Main.Template.");
310  assert_non_null(template);
311 
312  amxc_var_set_type(&args, AMXC_VAR_ID_HTABLE);
313  amxc_var_add_key(cstring_t, &args, "rel_path", "Template.");
314  amxc_var_add_key(uint32_t, &args, "index", 4);
315  assert_int_equal(amxd_object_invoke_function(root, "_del", &args, &retval), 0);
316  assert_int_equal(amxd_object_get_instance_count(template), 2);
317 
318  amxc_var_dump(&retval, STDOUT_FILENO);
319  assert_string_equal(GETI_CHAR(&retval, 0), "Main.Template.4.");
320  assert_string_equal(GETI_CHAR(&retval, 1), "Main.Template.4.Sub.");
321 
322  amxc_var_clean(&retval);
323  amxc_var_clean(&args);
324 }
325 
327  amxd_object_t* template = NULL;
328  amxd_object_t* root = NULL;
329  amxc_var_t retval;
330  amxc_var_t args;
331 
332  amxc_var_init(&args);
333  amxc_var_init(&retval);
334 
335  root = amxd_dm_findf(&dm, "Main.");
336  assert_non_null(root);
337  template = amxd_dm_findf(&dm, "Main.Template.");
338  assert_non_null(template);
339 
340  amxc_var_set_type(&args, AMXC_VAR_ID_HTABLE);
341  amxc_var_add_key(cstring_t, &args, "rel_path", "Template.");
342  amxc_var_add_key(cstring_t, &args, "name", "Test3");
343  assert_int_equal(amxd_object_invoke_function(root, "_del", &args, &retval), 0);
344  assert_int_equal(amxd_object_get_instance_count(template), 1);
345 
346  amxc_var_dump(&retval, STDOUT_FILENO);
347  assert_string_equal(GETI_CHAR(&retval, 0), "Main.Template.5.");
348  assert_string_equal(GETI_CHAR(&retval, 1), "Main.Template.5.Sub.");
349 
350  amxc_var_clean(&retval);
351  amxc_var_clean(&args);
352 }
353 
355  amxd_object_t* root = NULL;
356  amxc_var_t retval;
357  amxc_var_t args;
358 
359  amxc_var_init(&args);
360  amxc_var_init(&retval);
361 
362  root = amxd_dm_findf(&dm, "Main.");
363  assert_non_null(root);
364 
365  amxc_var_set_type(&args, AMXC_VAR_ID_HTABLE);
366  amxc_var_add_key(cstring_t, &args, "rel_path", "Template.YAI3.Sub.SUBINST.");
367  assert_int_equal(amxd_object_invoke_function(root, "_del", &args, &retval), 0);
368 
369  amxc_var_dump(&retval, STDOUT_FILENO);
370  assert_string_equal(GETI_CHAR(&retval, 0), "Main.Template.8.Sub.1.");
371 
372  amxc_var_set_type(&args, AMXC_VAR_ID_HTABLE);
373  amxc_var_add_key(cstring_t, &args, "rel_path", "Template.YAI3.");
374  assert_int_equal(amxd_object_invoke_function(root, "_del", &args, &retval), 0);
375 
376  amxc_var_dump(&retval, STDOUT_FILENO);
377  assert_string_equal(GETI_CHAR(&retval, 0), "Main.Template.8.");
378  assert_string_equal(GETI_CHAR(&retval, 1), "Main.Template.8.Sub.");
379 
380  amxc_var_clean(&retval);
381  amxc_var_clean(&args);
382 }
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.
static uint32_t amxd_object_get_instance_count(const amxd_object_t *object)
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_key
Definition: amxd_types.h:362
@ 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_object_t * amxd_object_findf(amxd_object_t *object, const char *rel_path,...) __attribute__((format(printf
Find an object in the data model tree, starting from an object.
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
void test_amxd_del_fails_with_invalid_rel_path(UNUSED void **state)
int test_function_del_teardown(UNUSED void **state)
void test_amxd_delete_key_path_returns_index_path(UNUSED void **state)
void test_amxd_can_delete_on_name_with_rel_path(UNUSED void **state)
static amxd_dm_t dm
void test_amxd_can_delete_on_index_with_rel_path(UNUSED void **state)
void test_amxd_del_fails_on_singleton(UNUSED void **state)
void test_amxd_del_can_use_rel_path(UNUSED void **state)
int test_function_del_setup(UNUSED void **state)
void test_amxd_can_del_instance_object(UNUSED void **state)
void test_amxd_del_can_use_to_high_access(UNUSED void **state)