summaryrefslogtreecommitdiff
path: root/plugins/claude-security/scripts/lib/revision.py
diff options
context:
space:
mode:
Diffstat (limited to 'plugins/claude-security/scripts/lib/revision.py')
-rw-r--r--plugins/claude-security/scripts/lib/revision.py28
1 files changed, 28 insertions, 0 deletions
diff --git a/plugins/claude-security/scripts/lib/revision.py b/plugins/claude-security/scripts/lib/revision.py
new file mode 100644
index 00000000..afe334e2
--- /dev/null
+++ b/plugins/claude-security/scripts/lib/revision.py
@@ -0,0 +1,28 @@
+"""The revision a scan records, and the `<base>..<commit>` range a change scan's revision names."""
+
+from __future__ import annotations
+
+from typing import Literal, TypedDict
+
+from .strictjson import JsonMap, is_str
+
+
+class Revision(TypedDict, total=False):
+ """What was scanned. `versioned` is always present; the rest when in git."""
+
+ versioned: bool
+ commit: str | None
+ parent: str | None
+ branch: str | None
+ dirty: bool | None
+ sparse: Literal[True]
+ not_checked_out_dirs: list[str]
+ base: str | None
+ merge_base: str | None
+
+
+def change_range(revision: JsonMap) -> str | None:
+ """The `<base>..<commit>` range a change scan's revision names; None when it names no change."""
+ base = revision.get("merge_base") or revision.get("parent")
+ commit = revision.get("commit")
+ return f"{base}..{commit}" if is_str(base) and is_str(commit) else None