fix: reraise original exception and windows specific cleanup errors

* Basing on #243, we are having some difficulty with pygit2 Repository file
  handlers being open. in `pygit.py` we instantiate the Repository
  class, which holds references to `pack` and `.idx` git objects and
  keeps files open. If taf and cleanup is attempted from same subprocess,
  Repository handler won't be deleted, and cleanup error occurs. Calling
  manual garbage collection did not help. This
  seems to be a known issue throughout the git community, see [1] and
  [2].

  [1] - libgit2/pygit2#596
  [2] - gitpython-developers/GitPython#546

  Several workarounds were proposed by the community, but it seems that
  we can't fully replicate those workarounds. In [2] they attempt to
  workaround the issue by deleting git cache. That works for them
  because their git implementation has file handlers open in pure
  python, while we only do subprocess git calls.

  Our TODO: if these  windows specific error issues keep persisting, figure out how to
  garbage collect pygit2 Repository handler correctly.

  For now settle on error handling, as this issue is
  specific to a subprocess call that calls taf/updater. Though we should
  keep track of progress of these known bugs, so we can fix them if they
  get addressed by pygit2 or gitpython

chore: changelog

Author: n-dusan

CHANGELOG.md

@@ -29,6 +29,9 @@ and this project adheres to [Semantic Versioning][semver].
 
 ### Fixed
 
+- Fix Warn when git object cleanup fails (`idx`,`pack`) and include cleanup warning message ([259])
+
+[259]: https://github.com/openlawlibrary/taf/pull/259
 [257]: https://github.com/openlawlibrary/taf/pull/257
 [256]: https://github.com/openlawlibrary/taf/pull/256
 

taf/updater/handlers.py

@@ -257,7 +257,15 @@ def cleanup(self):
         self.validation_auth_repo.cleanup()
         temp_dir = Path(self.validation_auth_repo.path, os.pardir).parent
         if temp_dir.is_dir():
-            shutil.rmtree(str(temp_dir), onerror=on_rm_error)
+            try:
+                shutil.rmtree(str(temp_dir), onerror=on_rm_error)
+            except (OSError, PermissionError) as e:
+                taf_logger.warning(
+                    "Could not remove temporary directory {}. Something went wrong during cleanup: {}",
+                    temp_dir,
+                    e,
+                )
+                raise e
 
     def earliest_valid_expiration_time(self):
         # Only validate expiration time of the last commit

taf/updater/updater.py

@@ -1317,7 +1317,14 @@ def _validate_authentication_repository(
             )
 
     # always cleanup repository updater
-    repository_updater.update_handler.cleanup()
+    try:
+        repository_updater.update_handler.cleanup()
+    except Exception as e:
+        taf_logger.warning(
+            "Failed to clean up temporary update files: {}. This is a known issue when running TAF in a subprocess. You could consider upgrading taf to see if cleanup errors persist",
+            e,
+        )
+        pass
 
     return (
         commits,