[Code] Pycubool:

- Minor structure refactoring
- Add matrix properties query
- Add matrix values extraction
- Fix types of passed indices
- Fix args types for ctypes (cuboolinstance, cuboolmatrix)
- Add cuboolinstancedesc fields setup

Author: EgorOrachyov

.gitignore

@@ -3,4 +3,7 @@
 
 # Build files
 /cmake-build-debug
-/build
+/build
+
+# Python cache
+/python/pycubool/__pycache__/

include/cubool/cubool.h

@@ -293,7 +293,7 @@ CUBOOL_EXPERIMENTAL CUBOOL_API CuBoolStatus CuBool_MatrixDense_Build(
  *
  * @return Error code on this operation
  */
-CUBOOL_EXPERIMENTAL CUBOOL_API CuBoolStatus CuBool_MatrixDense_ExtractPairs(
+CUBOOL_EXPERIMENTAL CUBOOL_API CuBoolStatus CuBool_MatrixDense_ExtractPairsExt(
     CuBoolInstance              instance,
     CuBoolMatrixDense           matrix,
     CuBoolIndex_t**             rows,
@@ -403,6 +403,27 @@ CUBOOL_API CuBoolStatus CuBool_Matrix_Build(
     CuBoolSize_t                nvals
 );
 
+/**
+ * Reads matrix data to the host visible CPU buffer as an array of values pair.
+ * The arrays must be provided by the user and the size of this arrays must
+ * be greater or equal the values count of the matrix.
+ *
+ * @param instance An instance object reference to perform this operation
+ * @param matrix Matrix handle to perform operation on
+ * @param[in,out] rows Allocated buffer with row indices
+ * @param[in,out] cols Allocated buffer with column indices
+ * @param[in,out] nvals Total number of the pairs
+ *
+ * @return Error code on this operation
+ */
+CUBOOL_API CuBoolStatus CuBool_Matrix_ExtractPairs(
+        CuBoolInstance              instance,
+        CuBoolMatrix                matrix,
+        CuBoolIndex_t*              rows,
+        CuBoolIndex_t*              cols,
+        CuBoolSize_t*               nvals
+);
+
 /**
  * Reads matrix data to the host visible CPU buffer as an array of values pair.
  * The indices of the i-th pair can be evaluated as (r=rows[i],c=cols[i]).
@@ -418,7 +439,7 @@ CUBOOL_API CuBoolStatus CuBool_Matrix_Build(
  *
  * @return Error code on this operation
  */
-CUBOOL_API CuBoolStatus CuBool_Matrix_ExtractPairs(
+CUBOOL_API CuBoolStatus CuBool_Matrix_ExtractPairsExt(
     CuBoolInstance              instance,
     CuBoolMatrix                matrix,
     CuBoolIndex_t**             rows,

python/pycubool/CuBoolWrapper/__init__.py

@@ -0,0 +1,7 @@
+from .wrapper import *
+
+from .matrix import *
+from .add import *
+
+# Setup global module state
+init_wrapper()

python/pycubool/CuBoolWrapper/add.py

@@ -0,0 +1,16 @@
+from . import wrapper
+from . import dll
+from . import matrix
+
+
+__all__ = [
+    "add"
+]
+
+
+def add(result_matrix: matrix.Matrix, a_matrix: matrix.Matrix):
+    status = wrapper.loaded_dll.CuBool_Matrix_Add(wrapper.instance,
+                                                  result_matrix.hnd,
+                                                  a_matrix.hnd)
+
+    dll.check(status)