Cleanup apiutils module a bit and move git related functions to another module

Summary

This is a simple refactoring: Some git-related functions have been used to a different module and the old functions have been deprecated.

Focus

Just check whether you are fine with my decision and whether the functions are called from the deprecated ones correctly.

Test Environment

It looks like these functions were tested manually before. Feel free to add a feature request for unit tests for these functions.

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 (or not necessary)
• Up-to-date JSON schema (or not necessary)
• Appropriate user and developer documentation (or not necessary)
  • How do I use the software? Assume "stupid" users.
  • How do I develop or debug the software? Assume novice developers.
• 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 (or not necessary)
• Appropriate user and developer documentation (or not necessary)
• 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 specifications? Are they satisfied?

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

src/caosdb/apiutils.py

@@ -149,32 +149,32 @@ def retrieve_entities_with_ids(entities):
 def getOriginUrlIn(folder):
     warnings.warn("""
                   This function is deprecated and will be removed with the next release.
-                  Please use the module caosdb.utils.git_utils for a
-                  similar functionality.""", DeprecationWarning)
+                  Please use the caosdb.utils.git_utils.get_origin_url_in instead.""",
+                  DeprecationWarning)
     return get_origin_url_in(folder)
 
 
 def getDiffIn(folder, save_dir=None):
     warnings.warn("""
                   This function is deprecated and will be removed with the next release.
-                  Please use the module caosdb.utils.git_utils for a
-                  similar functionality.""", DeprecationWarning)
+                  Please use the caosdb.utils.git_utils.get_diff_in instead.""",
+                  DeprecationWarning)
     return get_diff_in(folder, save_dir)
 
 
 def getBranchIn(folder):
     warnings.warn("""
                   This function is deprecated and will be removed with the next release.
-                  Please use the module caosdb.utils.git_utils for a
-                  similar functionality.""", DeprecationWarning)
+                  Please use the caosdb.utils.git_utils.get_branch_in instead.""",
+                  DeprecationWarning)
     return get_branch_in(folder)
 
 
 def getCommitIn(folder):
     warnings.warn("""
                   This function is deprecated and will be removed with the next release.
-                  Please use the module caosdb.utils.git_utils for a
-                  similar functionality.""", DeprecationWarning)
+                  Please use the caosdb.utils.git_utils.get_commit_in instead.""",
+                  DeprecationWarning)
     return get_commit_in(folder)