wexample-helpers-git 6.1.0__tar.gz → 6.2.0__tar.gz

{wexample_helpers_git-6.1.0 → wexample_helpers_git-6.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wexample-helpers-git
-Version: 6.1.0
+Version: 6.2.0
 Summary: Some python basic helpers for git.
 Author-Email: weeger <contact@wexample.com>
 License: MIT
@@ -20,7 +20,7 @@ Description-Content-Type: text/markdown
 
 # helpers_git
 
-Version: 6.1.0
+Version: 6.2.0
 
 Some python basic helpers for git.
 

{wexample_helpers_git-6.1.0 → wexample_helpers_git-6.2.0}/README.md

@@ -1,6 +1,6 @@
 # helpers_git
 
-Version: 6.1.0
+Version: 6.2.0
 
 Some python basic helpers for git.
 

{wexample_helpers_git-6.1.0 → wexample_helpers_git-6.2.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "wexample-helpers-git"
-version = "6.1.0"
+version = "6.2.0"
 description = "Some python basic helpers for git."
 authors = [
     { name = "weeger", email = "contact@wexample.com" },

{wexample_helpers_git-6.1.0 → wexample_helpers_git-6.2.0}/src/wexample_helpers_git/helpers/git.py

@@ -442,3 +442,33 @@ def git_tag_exists(
         return len(out) > 0
     except Exception:
         return False
+
+
+def git_tag_lightweight(
+    tag: str, *, cwd: FileStringOrPath, force: bool = False, inherit_stdio: bool = True
+) -> None:
+    """Create (or force-update) a lightweight tag at HEAD."""
+    from wexample_helpers.helpers.file import file_resolve_path
+
+    cmd = ["tag"]
+    if force:
+        cmd.append("-f")
+    cmd.append(tag)
+    git_run(cmd, inherit_stdio=inherit_stdio, cwd=file_resolve_path(cwd))
+
+
+def git_tag_points_to_head(tag: str, *, cwd: FileStringOrPath) -> bool:
+    """Return True if the given tag resolves to the same commit as HEAD."""
+    from wexample_helpers.helpers.file import file_resolve_path
+    from wexample_helpers.helpers.shell import shell_run
+
+    try:
+        tag_hash = shell_run(
+            ["git", "rev-parse", f"refs/tags/{tag}^{{}}"],
+            inherit_stdio=False,
+            cwd=file_resolve_path(cwd),
+        ).stdout.strip()
+        head_hash = git_get_current_commit_hash(cwd=cwd)
+        return bool(tag_hash) and tag_hash == head_hash
+    except Exception:
+        return False