F copy entity

Summary

Function to copy an entity.

Note to reviewer: This MR depends on f-merge-entities.

Test Environment

There is a unit test.

Check List for the Author

• All automated tests pass
• Reference related Issues
• Up-to-date CHANGELOG.md
• Add type hints in created/changed code
• 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.

src/caosdb/apiutils.py

@@ -39,6 +39,8 @@ from caosdb.common.models import (Container, Entity, File, Property, Query,
                                   Record, RecordType, execute_query,
                                   get_config, SPECIAL_ATTRIBUTES)
 
+import logging
+
 
 def new_record(record_type, name=None, description=None,
                tempid=None, insert=False, **kwargs):
@@ -689,8 +691,13 @@ def merge_entities(entity_a: Entity, entity_b: Entity):
     The merge operation is done in place.
 
     Returns entity_a.
+
+    WARNING: This function is currently experimental and insufficiently tested. Use with care.
     """
 
+    logging.warning(
+        "This function is currently experimental and insufficiently tested. Use with care.")
+
     # Compare both entities:
     diff_r1, diff_r2 = compare_entities(entity_a, entity_b)