kevinveenbirkenbach/pkgmgr
1
0
Fork 0
Code Issues Pull Requests Actions 25 Packages Projects Releases Wiki Activity

refactor(git): introduce structured core.git command/query API and adapt actions & tests
Some checks failed
Mark stable commit / test-unit (push) Has been cancelled
Details
Mark stable commit / test-integration (push) Has been cancelled
Details
Mark stable commit / test-env-virtual (push) Has been cancelled
Details
Mark stable commit / test-env-nix (push) Has been cancelled
Details
Mark stable commit / test-e2e (push) Has been cancelled
Details
Mark stable commit / test-virgin-user (push) Has been cancelled
Details
Mark stable commit / test-virgin-root (push) Has been cancelled
Details
Mark stable commit / lint-shell (push) Has been cancelled
Details
Mark stable commit / lint-python (push) Has been cancelled
Details
Mark stable commit / mark-stable (push) Has been cancelled
Details

Browse Source 
- Replace direct subprocess usage with core.git.run wrapper
- Introduce dedicated core.git.commands (add, commit, fetch, pull_ff_only, push, clone, tag_annotated, tag_force_annotated, etc.)
- Introduce core.git.queries (list_tags, get_upstream_ref, get_config_value, changelog helpers, etc.)
- Refactor release workflow and git_ops to use command/query split
- Implement semantic vX.Y.Z comparison with safe fallback for non-parseable tags
- Refactor repository clone logic to use core.git.commands.clone with preview support and ssh→https fallback
- Remove legacy run_git_command helpers
- Split and update unit tests to mock command/query boundaries instead of subprocess
- Add comprehensive tests for clone modes, preview behavior, ssh→https fallback, and verification prompts
- Add unit tests for core.git.run error handling and preview mode
- Align public exports (__all__) with new structure
- Improve type hints, docstrings, and error specificity across git helpers

https://chatgpt.com/share/69414735-51d4-800f-bc7b-4b90e35f71e5
This commit is contained in:
Kevin Veen-Birkenbach
2025-12-16 12:49:03 +01:00
parent f83e192e37
commit 9c22c7dbb4
4 changed files with 352 additions and 117 deletions
Download Patch File Download Diff File Expand all files Collapse all files

251
tests/unit/pkgmgr/actions/repos/test_clone.py
View File

@@ -1,23 +1,27 @@
# tests/test_clone_repos.py
# tests/unit/pkgmgr/actions/repos/test_clone.py
from __future__ import annotations
import unittest
from unittest.mock import patch, MagicMock
from unittest.mock import patch
from pkgmgr.actions.repository.clone import clone_repos
class TestCloneRepos(unittest.TestCase):
def setUp(self):
def setUp(self) -> None:
# Add `verified` so verify_repository() is actually exercised.
self.repo = {
"provider": "github.com",
"account": "user",
"repository": "repo",
"verified": {"commit": "deadbeef"},
}
self.selected = [self.repo]
self.base_dir = "/tmp/repos"
self.all_repos = self.selected
@patch("pkgmgr.actions.repository.clone.verify_repository")
@patch("pkgmgr.actions.repository.clone.subprocess.run")
@patch("pkgmgr.actions.repository.clone.git_clone")
@patch("pkgmgr.actions.repository.clone.os.makedirs")
@patch("pkgmgr.actions.repository.clone.os.path.exists")
@patch("pkgmgr.actions.repository.clone.get_repo_dir")
@@ -28,13 +32,14 @@ class TestCloneRepos(unittest.TestCase):
mock_get_repo_dir,
mock_exists,
mock_makedirs,
mock_run,
mock_git_clone,
mock_verify,
):
) -> None:
mock_get_repo_identifier.return_value = "github.com/user/repo"
mock_get_repo_dir.return_value = "/tmp/repos/user/repo"
mock_exists.return_value = False
mock_run.return_value = MagicMock(returncode=0)
# verification called; and because no_verification=True, result doesn't matter
mock_verify.return_value = (True, [], "hash", "key")
clone_repos(
@@ -46,17 +51,26 @@ class TestCloneRepos(unittest.TestCase):
clone_mode="ssh",
)
mock_run.assert_called_once()
# subprocess.run wird mit positional args aufgerufen
cmd = mock_run.call_args[0][0]
cwd = mock_run.call_args[1]["cwd"]
mock_git_clone.assert_called_once()
args, kwargs = mock_git_clone.call_args
clone_args = args[0]
self.assertEqual(
clone_args,
["git@github.com:user/repo.git", "/tmp/repos/user/repo"],
)
self.assertEqual(kwargs["cwd"], "/tmp/repos/user")
self.assertFalse(kwargs["preview"])
self.assertIn("git clone", cmd)
self.assertIn("git@github.com:user/repo.git", cmd)
self.assertEqual(cwd, "/tmp/repos/user")
# verify_repository should be called because repo has "verified"
mock_verify.assert_called_once()
v_args, v_kwargs = mock_verify.call_args
self.assertEqual(v_args[0], self.repo) # repo dict
self.assertEqual(v_args[1], "/tmp/repos/user/repo") # repo_dir
self.assertEqual(v_kwargs["mode"], "local")
self.assertTrue(v_kwargs["no_verification"])
@patch("pkgmgr.actions.repository.clone.verify_repository")
@patch("pkgmgr.actions.repository.clone.subprocess.run")
@patch("pkgmgr.actions.repository.clone.git_clone")
@patch("pkgmgr.actions.repository.clone.os.makedirs")
@patch("pkgmgr.actions.repository.clone.os.path.exists")
@patch("pkgmgr.actions.repository.clone.get_repo_dir")
@@ -67,13 +81,12 @@ class TestCloneRepos(unittest.TestCase):
mock_get_repo_dir,
mock_exists,
mock_makedirs,
mock_run,
mock_git_clone,
mock_verify,
):
) -> None:
mock_get_repo_identifier.return_value = "github.com/user/repo"
mock_get_repo_dir.return_value = "/tmp/repos/user/repo"
mock_exists.return_value = False
mock_run.return_value = MagicMock(returncode=0)
mock_verify.return_value = (True, [], "hash", "key")
clone_repos(
@@ -85,16 +98,20 @@ class TestCloneRepos(unittest.TestCase):
clone_mode="https",
)
mock_run.assert_called_once()
cmd = mock_run.call_args[0][0]
cwd = mock_run.call_args[1]["cwd"]
mock_git_clone.assert_called_once()
args, kwargs = mock_git_clone.call_args
clone_args = args[0]
self.assertEqual(
clone_args,
["https://github.com/user/repo.git", "/tmp/repos/user/repo"],
)
self.assertEqual(kwargs["cwd"], "/tmp/repos/user")
self.assertFalse(kwargs["preview"])
self.assertIn("git clone", cmd)
self.assertIn("https://github.com/user/repo.git", cmd)
self.assertEqual(cwd, "/tmp/repos/user")
mock_verify.assert_called_once()
@patch("pkgmgr.actions.repository.clone.verify_repository")
@patch("pkgmgr.actions.repository.clone.subprocess.run")
@patch("pkgmgr.actions.repository.clone.git_clone")
@patch("pkgmgr.actions.repository.clone.os.makedirs")
@patch("pkgmgr.actions.repository.clone.os.path.exists")
@patch("pkgmgr.actions.repository.clone.get_repo_dir")
@@ -105,13 +122,12 @@ class TestCloneRepos(unittest.TestCase):
mock_get_repo_dir,
mock_exists,
mock_makedirs,
mock_run,
mock_git_clone,
mock_verify,
):
) -> None:
mock_get_repo_identifier.return_value = "github.com/user/repo"
mock_get_repo_dir.return_value = "/tmp/repos/user/repo"
mock_exists.return_value = False
mock_run.return_value = MagicMock(returncode=0)
mock_verify.return_value = (True, [], "hash", "key")
clone_repos(
@@ -123,29 +139,39 @@ class TestCloneRepos(unittest.TestCase):
clone_mode="shallow",
)
mock_run.assert_called_once()
cmd = mock_run.call_args[0][0]
cwd = mock_run.call_args[1]["cwd"]
mock_git_clone.assert_called_once()
args, kwargs = mock_git_clone.call_args
clone_args = args[0]
self.assertEqual(
clone_args,
[
"--depth",
"1",
"--single-branch",
"https://github.com/user/repo.git",
"/tmp/repos/user/repo",
],
)
self.assertEqual(kwargs["cwd"], "/tmp/repos/user")
self.assertFalse(kwargs["preview"])
self.assertIn("git clone --depth 1 --single-branch", cmd)
self.assertIn("https://github.com/user/repo.git", cmd)
self.assertEqual(cwd, "/tmp/repos/user")
mock_verify.assert_called_once()
@patch("pkgmgr.actions.repository.clone.verify_repository")
@patch("pkgmgr.actions.repository.clone.subprocess.run")
@patch("pkgmgr.actions.repository.clone.git_clone")
@patch("pkgmgr.actions.repository.clone.os.makedirs")
@patch("pkgmgr.actions.repository.clone.os.path.exists")
@patch("pkgmgr.actions.repository.clone.get_repo_dir")
@patch("pkgmgr.actions.repository.clone.get_repo_identifier")
def test_preview_mode_does_not_call_subprocess_run(
def test_preview_mode_calls_git_clone_with_preview_true(
self,
mock_get_repo_identifier,
mock_get_repo_dir,
mock_exists,
mock_makedirs,
mock_run,
mock_git_clone,
mock_verify,
):
) -> None:
mock_get_repo_identifier.return_value = "github.com/user/repo"
mock_get_repo_dir.return_value = "/tmp/repos/user/repo"
mock_exists.return_value = False
@@ -160,8 +186,153 @@ class TestCloneRepos(unittest.TestCase):
clone_mode="shallow",
)
# Im Preview-Modus sollte subprocess.run nicht aufgerufen werden
mock_run.assert_not_called()
mock_git_clone.assert_called_once()
_args, kwargs = mock_git_clone.call_args
self.assertTrue(kwargs["preview"])
# Even in preview, verification is reached (because repo has "verified"),
# but no_verification=True makes it non-blocking.
mock_verify.assert_called_once()
@patch("builtins.input", return_value="y")
@patch("pkgmgr.actions.repository.clone.verify_repository")
@patch("pkgmgr.actions.repository.clone.git_clone")
@patch("pkgmgr.actions.repository.clone.os.makedirs")
@patch("pkgmgr.actions.repository.clone.os.path.exists")
@patch("pkgmgr.actions.repository.clone.get_repo_dir")
@patch("pkgmgr.actions.repository.clone.get_repo_identifier")
def test_ssh_clone_failure_prompts_and_falls_back_to_https_when_confirmed(
self,
mock_get_repo_identifier,
mock_get_repo_dir,
mock_exists,
mock_makedirs,
mock_git_clone,
mock_verify,
mock_input,
) -> None:
mock_get_repo_identifier.return_value = "github.com/user/repo"
mock_get_repo_dir.return_value = "/tmp/repos/user/repo"
mock_exists.return_value = False
mock_verify.return_value = (True, [], "hash", "key")
# First call (ssh) fails, second call (https) succeeds
from pkgmgr.core.git.commands.clone import GitCloneError
mock_git_clone.side_effect = [
GitCloneError("ssh failed", cwd="/tmp/repos/user"),
None,
]
clone_repos(
self.selected,
self.base_dir,
self.all_repos,
preview=False,
no_verification=True,
clone_mode="ssh",
)
self.assertEqual(mock_git_clone.call_count, 2)
first_args, first_kwargs = mock_git_clone.call_args_list[0]
self.assertEqual(
first_args[0],
["git@github.com:user/repo.git", "/tmp/repos/user/repo"],
)
self.assertEqual(first_kwargs["cwd"], "/tmp/repos/user")
self.assertFalse(first_kwargs["preview"])
second_args, second_kwargs = mock_git_clone.call_args_list[1]
self.assertEqual(
second_args[0],
["https://github.com/user/repo.git", "/tmp/repos/user/repo"],
)
self.assertEqual(second_kwargs["cwd"], "/tmp/repos/user")
self.assertFalse(second_kwargs["preview"])
mock_input.assert_called_once()
mock_verify.assert_called_once()
@patch("builtins.input", return_value="n")
@patch("pkgmgr.actions.repository.clone.verify_repository")
@patch("pkgmgr.actions.repository.clone.git_clone")
@patch("pkgmgr.actions.repository.clone.os.makedirs")
@patch("pkgmgr.actions.repository.clone.os.path.exists")
@patch("pkgmgr.actions.repository.clone.get_repo_dir")
@patch("pkgmgr.actions.repository.clone.get_repo_identifier")
def test_ssh_clone_failure_does_not_fallback_when_declined(
self,
mock_get_repo_identifier,
mock_get_repo_dir,
mock_exists,
mock_makedirs,
mock_git_clone,
mock_verify,
mock_input,
) -> None:
mock_get_repo_identifier.return_value = "github.com/user/repo"
mock_get_repo_dir.return_value = "/tmp/repos/user/repo"
mock_exists.return_value = False
from pkgmgr.core.git.commands.clone import GitCloneError
mock_git_clone.side_effect = GitCloneError("ssh failed", cwd="/tmp/repos/user")
clone_repos(
self.selected,
self.base_dir,
self.all_repos,
preview=False,
no_verification=True,
clone_mode="ssh",
)
mock_git_clone.assert_called_once()
mock_input.assert_called_once()
# If fallback is declined, verification should NOT run (repo was not cloned)
mock_verify.assert_not_called()
@patch("builtins.input", return_value="n")
@patch("pkgmgr.actions.repository.clone.verify_repository")
@patch("pkgmgr.actions.repository.clone.git_clone")
@patch("pkgmgr.actions.repository.clone.os.makedirs")
@patch("pkgmgr.actions.repository.clone.os.path.exists")
@patch("pkgmgr.actions.repository.clone.get_repo_dir")
@patch("pkgmgr.actions.repository.clone.get_repo_identifier")
def test_verification_failure_prompts_and_skips_when_user_declines(
self,
mock_get_repo_identifier,
mock_get_repo_dir,
mock_exists,
mock_makedirs,
mock_git_clone,
mock_verify,
mock_input,
) -> None:
mock_get_repo_identifier.return_value = "github.com/user/repo"
mock_get_repo_dir.return_value = "/tmp/repos/user/repo"
mock_exists.return_value = False
# Clone succeeds
mock_git_clone.return_value = None
# Verification fails, and user answers "n" to proceed anyway
mock_verify.return_value = (False, ["bad signature"], "hash", "key")
clone_repos(
self.selected,
self.base_dir,
self.all_repos,
preview=False,
no_verification=False,
clone_mode="https",
)
mock_git_clone.assert_called_once()
mock_verify.assert_called_once()
mock_input.assert_called_once()
if __name__ == "__main__":