wexample-helpers-git 0.1.0__tar.gz → 0.2.0__tar.gz

{wexample_helpers_git-0.1.0 → wexample_helpers_git-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wexample-helpers-git
-Version: 0.1.0
+Version: 0.2.0
 Summary: Some python basic helpers for git.
 Author-Email: weeger <contact@wexample.com>
 License: MIT
@@ -12,7 +12,7 @@ Requires-Python: >=3.10
 Requires-Dist: attrs>=23.1.0
 Requires-Dist: cattrs>=23.1.0
 Requires-Dist: gitpython
-Requires-Dist: wexample-helpers>=0.7.0
+Requires-Dist: wexample-helpers>=2.0.0
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
@@ -20,7 +20,7 @@ Description-Content-Type: text/markdown
 
 # helpers_git
 
-Version: 0.1.0
+Version: 0.2.0
 
 Some python basic helpers for git.
 
@@ -33,6 +33,7 @@ Some python basic helpers for git.
 - [License](#license)
 - [Suite Integration](#suite-integration)
 - [Suite Signature](#suite-signature)
+- [Introduction](#introduction)
 - [Roadmap](#roadmap)
 - [Status Compatibility](#status-compatibility)
 - [Useful Links](#useful-links)
@@ -102,7 +103,7 @@ Visit the [Wexample Suite documentation](https://docs.wexample.com) for the comp
 - attrs: >=23.1.0
 - cattrs: >=23.1.0
 - gitpython: 
-- wexample-helpers: >=0.7.0
+- wexample-helpers: >=2.0.0
 
 ## Versioning & Compatibility Policy
 
@@ -138,6 +139,8 @@ This packages suite embodies this spirit. Trusted by professionals and enthusias
 
 Wexample cultivates a culture of mastery. Each package, each contribution carries the mark of a community that values precision, ethics, and innovation — a community proud to shape the future of digital craftsmanship.
 
+A Python toolkit providing helper utilities for Git operations.
+
 ## Known Limitations & Roadmap
 
 Current limitations and planned features are tracked in the GitHub issues.

{wexample_helpers_git-0.1.0 → wexample_helpers_git-0.2.0}/README.md

@@ -1,6 +1,6 @@
 # helpers_git
 
-Version: 0.1.0
+Version: 0.2.0
 
 Some python basic helpers for git.
 
@@ -13,6 +13,7 @@ Some python basic helpers for git.
 - [License](#license)
 - [Suite Integration](#suite-integration)
 - [Suite Signature](#suite-signature)
+- [Introduction](#introduction)
 - [Roadmap](#roadmap)
 - [Status Compatibility](#status-compatibility)
 - [Useful Links](#useful-links)
@@ -82,7 +83,7 @@ Visit the [Wexample Suite documentation](https://docs.wexample.com) for the comp
 - attrs: >=23.1.0
 - cattrs: >=23.1.0
 - gitpython: 
-- wexample-helpers: >=0.7.0
+- wexample-helpers: >=2.0.0
 
 ## Versioning & Compatibility Policy
 
@@ -118,6 +119,8 @@ This packages suite embodies this spirit. Trusted by professionals and enthusias
 
 Wexample cultivates a culture of mastery. Each package, each contribution carries the mark of a community that values precision, ethics, and innovation — a community proud to shape the future of digital craftsmanship.
 
+A Python toolkit providing helper utilities for Git operations.
+
 ## Known Limitations & Roadmap
 
 Current limitations and planned features are tracked in the GitHub issues.

{wexample_helpers_git-0.1.0 → wexample_helpers_git-0.2.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "wexample-helpers-git"
-version = "0.1.0"
+version = "0.2.0"
 description = "Some python basic helpers for git."
 authors = [
     { name = "weeger", email = "contact@wexample.com" },
@@ -21,7 +21,7 @@ dependencies = [
     "attrs>=23.1.0",
     "cattrs>=23.1.0",
     "gitpython",
-    "wexample-helpers>=0.7.0",
+    "wexample-helpers>=2.0.0",
 ]
 
 [project.readme]

{wexample_helpers_git-0.1.0 → wexample_helpers_git-0.2.0}/src/wexample_helpers_git/helpers/git.py

@@ -29,15 +29,10 @@ def git_commit_all_with_message(
 ) -> None:
     """Stage all changes (including new files) and commit with the provided message."""
     from wexample_helpers.helpers.file import file_resolve_path
-    from wexample_helpers.helpers.shell import shell_run
 
     resolved = file_resolve_path(cwd)
-    shell_run(["git", "add", "-A"], inherit_stdio=inherit_stdio, cwd=resolved)
-    shell_run(
-        ["git", "commit", "-m", message],
-        inherit_stdio=inherit_stdio,
-        cwd=resolved,
-    )
+    git_run(["add", "-A"], inherit_stdio=inherit_stdio, cwd=resolved)
+    git_run(["commit", "-m", message], inherit_stdio=inherit_stdio, cwd=resolved)
 
 
 def git_create_or_switch_branch(

wexample_helpers_git-0.2.0/src/wexample_helpers_git/helpers/repo.py

@@ -0,0 +1,43 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+from wexample_helpers.const.types import PathOrString
+
+STATE_FILE = Path(".last_git_state")
+
+
+def repo_get_state(cwd: PathOrString | None = None) -> str:
+    """Return a unique hash representing the current git state (HEAD + changes)."""
+    from wexample_helpers_git.helpers.git import git_run
+
+    head_result = git_run(["rev-parse", "HEAD"], cwd=cwd)
+    head_hash = head_result.stdout.strip() if head_result.stdout else ""
+
+    diff_result = git_run(["diff"], cwd=cwd)
+    diff_hash = diff_result.stdout if diff_result.stdout else ""
+
+    return f"{head_hash}-{hash(diff_hash)}"
+
+
+def repo_has_changed(
+    cwd: PathOrString | None = None,
+    state_file: Path | None = None,
+) -> bool:
+    """Check if code has changed since last run."""
+    current_state = repo_get_state(cwd=cwd)
+    file_to_use = state_file if state_file is not None else STATE_FILE
+    previous_state = file_to_use.read_text().strip() if file_to_use.exists() else None
+    if current_state != previous_state:
+        file_to_use.write_text(current_state)
+        return True
+    return False
+
+
+def repo_has_changed_since(
+    previous_state: str,
+    cwd: PathOrString | None = None,
+) -> bool:
+    """Return True if the repo state has changed compared to a provided hash."""
+    current_state = repo_get_state(cwd=cwd)
+    return current_state != previous_state