ENH: Allow insertion and deletion of single entities

Summary

See https://gitlab.indiscale.com/caosdb/customers/lfpb/management/-/issues/394. Implementations for entities, parents, and properties were added. The transactions were extended s.th. all objects can be inserted, retrieved, and deleted.

Focus

Most of the new stuff is in entity.cpp and entity.h. See test_entity for the new functionality.

Test Environment

Unit and integration tests should be sufficient.

Check List for the Author

Please, prepare your MR for a review. Be sure to write a summary and a focus and create gitlab comments for the reviewer. They should guide the reviewer through the changes, explain your changes and also point out open questions. For further good practices have a look at our review guidelines

• All automated tests pass
• Reference related Issues
• [ ] Up-to-date CHANGELOG.md
• Annotations in code (Gitlab comments)
  • Intent of new code
  • Problems with old code
  • Why this implementation?

Check List for the Reviewer

• I understand the intent of this MR
• All automated tests pass
• [ ] Up-to-date CHANGELOG.md
• The test environment setup works and the intended behavior is reproducible in the test environment
• In-code documentation and comments are up-to-date.
• Check: Are there spezifications? Are they satisfied?

For further good practices have a look at our review guidelines.

include/ccaosdb.h

 #ifdef __cplusplus
 extern "C" {
-#else
-#include <stdbool.h>
 #endif
 
 /**
@@ -236,6 +234,104 @@ int caosdb_connection_connection_manager_get_default_connection(
 int caosdb_connection_connection_manager_get_connection(
   caosdb_connection_connection *out, const char *name);
 
+/****************************************************************************
+ * ENTITY STUFF AND TRANSACTIONS
+ ****************************************************************************/
+
+// TODO(fspreck) implementations needed, and probably these declarations are
+// not sufficient yet.
+typedef struct {
+  void *wrapped_transaction;
+} caosdb_transaction_transaction;
+
+int caosdb_connection_connection_create_transaction(
+  caosdb_connection_connection *connection,
+  caosdb_transaction_transaction *out);
+int caosdb_transaction_transaction_retrieve_by_id(
+  caosdb_transaction_transaction *transaction, const char *id);
+int caosdb_transaction_transaction_execute(
+  caosdb_transaction_transaction *transaction);
+
+typedef struct {
+  void *wrapped_result_set;
+} caosdb_transaction_result_set;
+
+int caosdb_transaction_transaction_get_result_set(
+  caosdb_transaction_transaction *transaction,
+  caosdb_transaction_result_set *out);
+
+typedef struct {
+  void *wrapped_entity;
+  char **id;
+  char **role;
+  char **name;
+  char **description;
+  char **datatype;
+  char **unit;
+  char **value;
+  char **version_id;
+} caosdb_entity_entity;
+
+int caosdb_transaction_result_set_get_entity(
+  caosdb_transaction_result_set *result_set, caosdb_entity_entity *entity,
+  int index);
+
+typedef struct {
+  void *wrapped_property;
+  char **id;
+  char **name;
+  char **description;
+  char **datatype;
+  char **unit;
+  char **value;
+} caosdb_entity_property;
+typedef struct {
+  void *wrapped_parent;
+  char **id;
+  char **name;
+  char **description;
+} caosdb_entity_parent;
+typedef struct {
+  void *wrapped_message;
+  int *code;
+  char **description;
+} caosdb_entity_message;
+
+// GETTERS FOR COMPLEX OBJECTS
+int caosdb_entity_entity_get_errors_size(caosdb_entity_entity *entity,
+                                         int *out);
+int caosdb_entity_entity_get_error(caosdb_entity_entity *entity,
+                                   caosdb_entity_message *out, int index);
+int caosdb_entity_entity_get_warnings_size(caosdb_entity_entity *entity,
+                                           int *out);
+int caosdb_entity_entity_get_warning(caosdb_entity_entity *entity,
+                                     caosdb_entity_message *out, int index);
+int caosdb_entity_entity_get_infos_size(caosdb_entity_entity *entity, int *out);
+int caosdb_entity_entity_get_info(caosdb_entity_entity *entity,
+                                  caosdb_entity_message *out, int index);
+int caosdb_entity_entity_get_properties_size(caosdb_entity_entity *entity,
+                                             int *out);
+int caosdb_entity_entity_get_property(caosdb_entity_entity *entity,
+                                      caosdb_entity_property *out, int index);
+int caosdb_entity_entity_get_parents_size(caosdb_entity_entity *entity,
+                                          int *out);
+int caosdb_entity_entity_get_parent(caosdb_entity_entity *entity,
+                                    caosdb_entity_parent *out, int index);
+
+// CONSTRUCTORS AND DESTRUCTORS
+int caosdb_entity_create_entity(caosdb_entity_entity *out);
+int caosdb_entity_delete_entity(caosdb_entity_entity *out);
+int caosdb_entity_create_property(caosdb_entity_property *out);
+int caosdb_entity_delete_property(caosdb_entity_property *out);
+int caosdb_entity_create_parent(caosdb_entity_parent *out);
+int caosdb_entity_delete_parent(caosdb_entity_parent *out);
+
+// SETTERS FOR COMPLEX OBJECTS
+int caosdb_entity_entity_append_parent(caosdb_entity_entity *entity,
+                                       caosdb_entity_parent *parent);
+int caosdb_entity_entity_append_property(caosdb_entity_entity *entity,
+                                         caosdb_entity_property *property);
+
 #ifdef __cplusplus
 }
 #endif