data: introduce store_only flags

This patch introduces store_only flag, which allows user to only store
value without performing any sort of additional type checks as
length, range, pattern, etc.

Signed-off-by: Stefan Gula <steweg@gmail.com>

Author: steweg

cffi/cdefs.h

@@ -264,6 +264,7 @@ struct lyd_node {
 LY_ERR lys_set_implemented(struct lys_module *,	const char **);
 
 #define LYD_NEW_VAL_OUTPUT ...
+#define LYD_NEW_VAL_STORE_ONLY ...
 #define LYD_NEW_VAL_BIN ...
 #define LYD_NEW_VAL_CANON ...
 #define LYD_NEW_META_CLEAR_DFLT ...

libyang/context.py

@@ -244,6 +244,7 @@ def create_data_path(
         parent: Optional[DNode] = None,
         value: Any = None,
         update: bool = True,
+        store_only: bool = False,
         rpc_output: bool = False,
         force_return_value: bool = True,
     ) -> Optional[DNode]:
@@ -254,7 +255,9 @@ def create_data_path(
                 value = str(value).lower()
             elif not isinstance(value, str):
                 value = str(value)
-        flags = newval_flags(update=update, rpc_output=rpc_output)
+        flags = newval_flags(
+            update=update, store_only=store_only, rpc_output=rpc_output
+        )
         dnode = ffi.new("struct lyd_node **")
         ret = lib.lyd_new_path(
             parent.cdata if parent else ffi.NULL,
@@ -348,6 +351,7 @@ def parse_data(
         strict: bool = False,
         validate_present: bool = False,
         validate_multi_error: bool = False,
+        store_only: bool = False,
     ) -> Optional[DNode]:
         if self.cdata is None:
             raise RuntimeError("context already destroyed")
@@ -358,6 +362,7 @@ def parse_data(
             opaq=opaq,
             ordered=ordered,
             strict=strict,
+            store_only=store_only,
         )
         validation_flgs = validation_flags(
             no_state=no_state,
@@ -415,6 +420,7 @@ def parse_data_mem(
         strict: bool = False,
         validate_present: bool = False,
         validate_multi_error: bool = False,
+        store_only: bool = False,
     ) -> Optional[DNode]:
         return self.parse_data(
             fmt,
@@ -429,6 +435,7 @@ def parse_data_mem(
             strict=strict,
             validate_present=validate_present,
             validate_multi_error=validate_multi_error,
+            store_only=store_only,
         )
 
     def parse_data_file(
@@ -444,6 +451,7 @@ def parse_data_file(
         strict: bool = False,
         validate_present: bool = False,
         validate_multi_error: bool = False,
+        store_only: bool = False,
     ) -> Optional[DNode]:
         return self.parse_data(
             fmt,
@@ -458,6 +466,7 @@ def parse_data_file(
             strict=strict,
             validate_present=validate_present,
             validate_multi_error=validate_multi_error,
+            store_only=store_only,
         )
 
     def __iter__(self) -> Iterator[Module]:

libyang/data.py

@@ -79,6 +79,7 @@ def data_format(fmt_string: str) -> int:
 # -------------------------------------------------------------------------------------
 def newval_flags(
     rpc_output: bool = False,
+    store_only: bool = False,
     bin_value: bool = False,
     canon_value: bool = False,
     meta_clear_default: bool = False,
@@ -91,6 +92,8 @@ def newval_flags(
     flags = 0
     if rpc_output:
         flags |= lib.LYD_NEW_VAL_OUTPUT
+    if store_only:
+        flags |= lib.LYD_NEW_VAL_STORE_ONLY
     if bin_value:
         flags |= lib.LYD_NEW_VAL_BIN
     if canon_value:
@@ -112,6 +115,7 @@ def parser_flags(
     opaq: bool = False,
     ordered: bool = False,
     strict: bool = False,
+    store_only: bool = False,
 ) -> int:
     flags = 0
     if lyb_mod_update:
@@ -126,6 +130,8 @@ def parser_flags(
         flags |= lib.LYD_PARSE_ORDERED
     if strict:
         flags |= lib.LYD_PARSE_STRICT
+    if store_only:
+        flags |= lib.LYD_PARSE_STORE_ONLY
     return flags
 
 
@@ -314,8 +320,10 @@ def meta_free(self, name):
                 break
             item = item.next
 
-    def new_meta(self, name: str, value: str, clear_dflt: bool = False):
-        flags = newval_flags(meta_clear_default=clear_dflt)
+    def new_meta(
+        self, name: str, value: str, clear_dflt: bool = False, store_only: bool = False
+    ):
+        flags = newval_flags(meta_clear_default=clear_dflt, store_only=store_only)
         ret = lib.lyd_new_meta(
             ffi.NULL,
             self.cdata,
@@ -391,13 +399,15 @@ def new_path(
         opt_opaq: bool = False,
         opt_bin_value: bool = False,
         opt_canon_value: bool = False,
+        opt_store_only: bool = False,
     ):
         flags = newval_flags(
             update=opt_update,
             rpc_output=opt_output,
             opaq=opt_opaq,
             bin_value=opt_bin_value,
             canon_value=opt_canon_value,
+            store_only=opt_store_only,
         )
         ret = lib.lyd_new_path(
             self.cdata, ffi.NULL, str2c(path), str2c(value), flags, ffi.NULL
@@ -1062,9 +1072,10 @@ def create_path(
         path: str,
         value: Any = None,
         rpc_output: bool = False,
+        store_only: bool = False,
     ) -> Optional[DNode]:
         return self.context.create_data_path(
-            path, parent=self, value=value, rpc_output=rpc_output
+            path, parent=self, value=value, rpc_output=rpc_output, store_only=store_only
         )
 
     def children(self, no_keys=False) -> Iterator[DNode]:
@@ -1188,6 +1199,7 @@ def dict_to_dnode(
     rpc: bool = False,
     rpcreply: bool = False,
     notification: bool = False,
+    store_only: bool = False,
 ) -> Optional[DNode]:
     """
     Convert a python dictionary to a DNode object given a YANG module object. The return
@@ -1214,6 +1226,8 @@ def dict_to_dnode(
         Data represents RPC or action output parameters.
     :arg notification:
         Data represents notification parameters.
+    :arg store_only:
+        Data are being stored regardless of type validation (length, range, pattern, etc.)
     """
     if not dic:
         return None
@@ -1235,7 +1249,7 @@ def _create_leaf(_parent, module, name, value, in_rpc_output=False):
                 value = str(value)
 
         n = ffi.new("struct lyd_node **")
-        flags = newval_flags(rpc_output=in_rpc_output)
+        flags = newval_flags(rpc_output=in_rpc_output, store_only=store_only)
         ret = lib.lyd_new_term(
             _parent,
             module.cdata,
@@ -1273,7 +1287,7 @@ def _create_container(_parent, module, name, in_rpc_output=False):
 
     def _create_list(_parent, module, name, key_values, in_rpc_output=False):
         n = ffi.new("struct lyd_node **")
-        flags = newval_flags(rpc_output=in_rpc_output)
+        flags = newval_flags(rpc_output=in_rpc_output, store_only=store_only)
         ret = lib.lyd_new_list(
             _parent,
             module.cdata,

tests/test_data.py

@@ -1092,3 +1092,11 @@ def test_dnode_leafref_linking(self):
         self.assertIsInstance(dnode4, DLeaf)
         self.assertEqual(dnode4.cdata, dnode2.cdata)
         dnode1.free()
+
+    def test_dnode_store_only(self):
+        MAIN = {"yolo-nodetypes:test1": 50}
+        module = self.ctx.load_module("yolo-nodetypes")
+        dnode = dict_to_dnode(MAIN, module, None, validate=False, store_only=True)
+        self.assertIsInstance(dnode, DLeaf)
+        self.assertEqual(dnode.value(), 50)
+        dnode.free()

tests/yang/yolo/yolo-nodetypes.yang

@@ -91,7 +91,9 @@ module yolo-nodetypes {
   }
 
   leaf test1 {
-    type uint8;
+    type uint8 {
+      range "2..20";
+    }
   }
 
   grouping grp1 {