github-local 0.0.3b3827.post12__tar.gz → 0.0.3b4575__tar.gz

{github_local-0.0.3b3827.post12/python_packages/github_local.egg-info → github_local-0.0.3b4575}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-local
-Version: 0.0.3b3827.post12
+Version: 0.0.3b4575
 Summary: PyPI github-local Python Package owned by Circlez.ai
 Home-page: https://github.com/circles-zone/github-local-python-package
 Author: Circles

{github_local-0.0.3b3827.post12 → github_local-0.0.3b4575}/pyproject.toml

@@ -22,7 +22,7 @@ pythonpath = ["."]
 name = "github-local"
 # After the b (beta) comes the Jira Work Item ID (sdk-local Makec.ps1 updates it)
 # I believe we are still using the version from setup.py and not from here until Potery will work
-version = "0.0.3b3827.post12" # https://pypi.org/project/github-local/
+version = "0.0.3b4575" # https://pypi.org/project/github-local/
 description = "github-local Python Package"
 readme = "README.md"
 authors = [

github_local-0.0.3b4575/python_packages/github_local/src/classify_github_actions_failure.py

@@ -0,0 +1,70 @@
+import re
+from http import HTTPStatus
+
+from .github_actions_failure import GitHubActionsFailure
+from .github_actions_failure_category import GitHubActionsFailureCategory
+
+ERROR_MARKER = "##[error]"
+GENERIC_ERROR_PATTERN = re.compile(r"Process completed with exit code|The process '.*' failed with exit code")
+LINES_BEFORE_ERROR = 40
+LINES_AFTER_ERROR = 10
+
+UNAUTHORIZED = f"{HTTPStatus.UNAUTHORIZED.value} {HTTPStatus.UNAUTHORIZED.phrase}"
+FORBIDDEN = f"{HTTPStatus.FORBIDDEN.value} {HTTPStatus.FORBIDDEN.phrase}"
+
+# The first matching rule wins. The rules come from 1,959 failed runs in circles-zone (30 days to 2026-10-25).
+RULES = [
+    (GitHubActionsFailureCategory.RUNNER,
+     r"no space left|runner.*(lost|shutdown|offline)|lost communication|command not found|"
+     r"cannot connect to the docker daemon|The operation was canceled"),
+    (GitHubActionsFailureCategory.CONFIG_SECRET,
+     r"(token|secret|credential|api[_ ]?key|password|deploy_key)\w*( and \w+)? (is |are )?"
+     rf"(not found|missing|invalid|expired|empty)|OurEnvironmentVariableException|Bad credentials|"
+     rf"{UNAUTHORIZED}|{FORBIDDEN}|ExpiredToken|Input required and not supplied: token|"
+     r"fatal: repository '.*' not found"),
+    (GitHubActionsFailureCategory.PROCESS_GATE,
+     r"Files were changed since Makec ran|Makec report is (invalid|missing)|Makec failed in local|"
+     r"Branch name for BU-|does not start with a BU-|is already Done - it must be an OPEN|"
+     r"no unit tests / system tests|check-jira-work-item|Not Fully Green"),
+    (GitHubActionsFailureCategory.SECURITY_DEPENDENCY,
+     r"Dependabot|No matching distribution|Could not find a version|ResolutionImpossible|npm ERR!|"
+     r"Cannot find module|ModuleNotFoundError"),
+    (GitHubActionsFailureCategory.TEST_FAILURE,
+     r"(^|\])\s*\[-\] |(?-i:\bFAILED\b)|AssertionError|Tests? failed|[1-9]\d* failed"),
+    (GitHubActionsFailureCategory.LINT_TYPE,
+     r"PSAvoid|PSUse|flake8|mypy|error TS\d+|\bE\d{3} |\bF\d{3} "),
+    (GitHubActionsFailureCategory.PUBLISH_DEPLOY,
+     r"PublishPowerShell failed|Serverless deploy failed|Docker build failed|Publish.*failed"),
+]
+COMPILED_RULES = [(category, re.compile(pattern, re.IGNORECASE | re.MULTILINE)) for category, pattern in RULES]
+
+
+def log_excerpt(log: str) -> str:
+    """The lines around the first error - the end of a job log is only its cleanup"""
+    lines = log.splitlines()
+    error_indexes = [index for index, line in enumerate(lines) if ERROR_MARKER in line]
+    if error_indexes:
+        first_error = error_indexes[0]
+        excerpt_lines = lines[max(0, first_error - LINES_BEFORE_ERROR):first_error + LINES_AFTER_ERROR]
+    else:
+        excerpt_lines = lines[-LINES_BEFORE_ERROR:]
+    excerpt = "\n".join(excerpt_lines)
+    return excerpt
+
+
+def main_error(log: str) -> str:
+    """The first specific error line ("Process completed with exit code 1" says nothing)"""
+    errors = [line.split(ERROR_MARKER, 1)[1].strip() for line in log.splitlines() if ERROR_MARKER in line]
+    specific_errors = [error for error in errors if not GENERIC_ERROR_PATTERN.search(error)]
+    error = (specific_errors or errors or [""])[0]
+    return error
+
+
+def classify_github_actions_failure(failure: GitHubActionsFailure) -> GitHubActionsFailureCategory:
+    if not failure.has_jobs:
+        category = GitHubActionsFailureCategory.INVALID_WORKFLOW
+    else:
+        excerpt = log_excerpt(failure.log)
+        category = next((rule_category for rule_category, pattern in COMPILED_RULES if pattern.search(excerpt)),
+                        GitHubActionsFailureCategory.UNKNOWN)
+    return category

github_local-0.0.3b4575/python_packages/github_local/src/github_actions_failure.py

@@ -0,0 +1,13 @@
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class GitHubActionsFailure:
+    """A failed GitHub Actions job, as the GitHub webhook / REST-API reports it"""
+    repo_name: str
+    workflow_name: str
+    job_name: str | None = None
+    failed_step_name: str | None = None
+    runner_name: str | None = None
+    log: str = ""
+    has_jobs: bool = True

github_local-0.0.3b4575/python_packages/github_local/src/github_actions_failure_category.py

@@ -0,0 +1,23 @@
+from enum import Enum
+
+
+class GitHubActionsFailureCategory(Enum):
+    """Why a GitHub Actions job failed - decides what to do with it (rerun, notify, open a Jira Work Item)"""
+    INVALID_WORKFLOW = "invalid_workflow"
+    RUNNER = "runner"
+    CONFIG_SECRET = "config_secret"
+    PROCESS_GATE = "process_gate"
+    SECURITY_DEPENDENCY = "security_dependency"
+    TEST_FAILURE = "test_failure"
+    LINT_TYPE = "lint_type"
+    PUBLISH_DEPLOY = "publish_deploy"
+    UNKNOWN = "unknown"
+
+
+# A rerun of the same commit (maybe on another runner) can pass only when the code is not the cause.
+RERUN_SAFE_CATEGORIES = frozenset({GitHubActionsFailureCategory.RUNNER})
+
+
+def is_rerun_safe(category: GitHubActionsFailureCategory) -> bool:
+    rerun_safe = category in RERUN_SAFE_CATEGORIES
+    return rerun_safe

{github_local-0.0.3b3827.post12 → github_local-0.0.3b4575}/python_packages/github_local/src/github_local.py

@@ -1,3 +1,4 @@
+from http import HTTPStatus
 import re
 from datetime import datetime, timezone
 from typing import Any, Optional
@@ -79,7 +80,7 @@ class GitHubLocal:
                                         timeout=GITHUB_REQUEST_TIMEOUT_SECONDS)
         except requests.RequestException as exception:
             raise GitHubLocalException(f"GitHub is unreachable: {exception}")
-        if response.status_code == 404 and is_not_found_empty:
+        if response.status_code == HTTPStatus.NOT_FOUND and is_not_found_empty:
             response_json: Any = []
         elif not response.ok:
             raise GitHubLocalException(f"GitHub GET {path} failed with {response.status_code}: {response.text[:200]}")

github_local-0.0.3b4575/python_packages/github_local/tests/unit/classify_github_actions_failure_unit_test.py

@@ -0,0 +1,69 @@
+import pytest
+
+from github_local.src.classify_github_actions_failure import classify_github_actions_failure, log_excerpt, main_error
+from github_local.src.github_actions_failure import GitHubActionsFailure
+from github_local.src.github_actions_failure_category import GitHubActionsFailureCategory as Category, is_rerun_safe
+
+
+def failure_with_log(log: str) -> GitHubActionsFailure:
+    failure = GitHubActionsFailure(repo_name="sdk-local", workflow_name="Build Publish SDK-Local", log=log)
+    return failure
+
+
+# The error lines are real ones from failed runs in circles-zone.
+@pytest.mark.parametrize("error_line, expected_category", [
+    ("/home/runner/_work/_temp/1.sh: line 3: jq: command not found", Category.RUNNER),
+    ("System.IO.IOException: No space left on device", Category.RUNNER),
+    ("API_TOKEN_GITHUB and SSH_DEPLOY_KEY are empty. Please fill one", Category.CONFIG_SECRET),
+    ("fatal: repository 'https://github.com/circles-zone/url-remote-python-package/' not found", Category.CONFIG_SECRET),
+    ("Files were changed since Makec ran: files other than makec_report.json5 are different", Category.PROCESS_GATE),
+    ("Input required and not supplied: token", Category.CONFIG_SECRET),
+    ("Makec report is missing: makec_report.json5 was not found in the repo", Category.PROCESS_GATE),
+    ("Jira Work Item BU-4163 is already Done - it must be an OPEN Work Item.", Category.PROCESS_GATE),
+    ("Dependabot alert #12 [critical] PyJWT (requirements-freeze.txt)", Category.SECURITY_DEPENDENCY),
+    ("[-] returns every TODO, not only the first few 12ms", Category.TEST_FAILURE),
+    ("FAILED tests/unit/parser_unit_test.py::test_parse - AssertionError", Category.TEST_FAILURE),
+    ("PSAvoidUsingConvertToSecureStringWithPlainText: File 'OurModule.Tests.ps1'", Category.LINT_TYPE),
+    ("Serverless deploy failed", Category.PUBLISH_DEPLOY),
+    ("Something nobody has seen before", Category.UNKNOWN),
+])
+def test_classify_by_the_error_line(error_line: str, expected_category: Category):
+    log = f"2026-10-24T10:00:00.0000000Z Run the step\n##[error]{error_line}\n##[error]Process completed with exit code 1."
+
+    assert classify_github_actions_failure(failure_with_log(log)) == expected_category
+
+
+def test_a_run_without_jobs_is_an_invalid_workflow_file():
+    failure = GitHubActionsFailure(repo_name="github-workflows", workflow_name=".github/workflows/smoke-tests.yml",
+                                   has_jobs=False)
+
+    assert classify_github_actions_failure(failure) == Category.INVALID_WORKFLOW
+
+
+def test_the_cleanup_at_the_end_of_the_log_is_ignored():
+    log = "\n".join(["##[error]Serverless deploy failed"] + ["Cleaning up orphan processes"] * 100
+                    + ["fatal: repository 'x' not found"])
+
+    assert classify_github_actions_failure(failure_with_log(log)) == Category.PUBLISH_DEPLOY
+
+
+def test_log_excerpt_without_an_error_is_the_end_of_the_log():
+    log = "\n".join(f"line {number}" for number in range(100))
+
+    assert log_excerpt(log).splitlines() == [f"line {number}" for number in range(60, 100)]
+
+
+def test_main_error_skips_the_generic_exit_code_line():
+    log = "##[error]Process completed with exit code 1.\n##[error]Serverless deploy failed"
+
+    assert main_error(log) == "Serverless deploy failed"
+
+
+def test_main_error_falls_back_to_the_generic_line_and_to_empty():
+    assert main_error("##[error]Process completed with exit code 1.") == "Process completed with exit code 1."
+    assert main_error("no error marker") == ""
+
+
+def test_only_runner_failures_are_rerun_safe():
+    assert is_rerun_safe(Category.RUNNER)
+    assert not is_rerun_safe(Category.TEST_FAILURE)

{github_local-0.0.3b3827.post12 → github_local-0.0.3b4575}/python_packages/github_local/tests/unit/conftest.py

@@ -1,3 +1,4 @@
+from http import HTTPStatus
 import json as json_module
 from dataclasses import dataclass
 from typing import Any, Optional, Union
@@ -22,7 +23,7 @@ class FakeHttp:
         self.calls: list[FakeHttpCall] = []
         self.responses_by_request: dict[tuple[str, str], list[Union[requests.Response, Exception]]] = {}
 
-    def add(self, method: str, url: str, status: int = 200, json: Any = None,
+    def add(self, method: str, url: str, status: int = HTTPStatus.OK, json: Any = None,
             body: Union[str, Exception] = "") -> None:
         if isinstance(body, Exception):
             response: Union[requests.Response, Exception] = body

{github_local-0.0.3b3827.post12 → github_local-0.0.3b4575}/python_packages/github_local/tests/unit/github_local_unit_test.py

@@ -1,3 +1,4 @@
+from http import HTTPStatus
 from datetime import datetime, timedelta, timezone
 
 import pytest
@@ -58,9 +59,9 @@ def test_get_keys_merged_to_dev_without_keys_calls_github_zero_times(fake_http,
 
 
 def test_search_not_found_is_an_error_and_not_an_empty_list(fake_http, github_local):
-    fake_http.get(f"{API}/search/issues", status=404, json={"message": "Not Found"})
+    fake_http.get(f"{API}/search/issues", status=HTTPStatus.NOT_FOUND, json={"message": "Not Found"})
 
-    with pytest.raises(GitHubLocalException, match="404"):
+    with pytest.raises(GitHubLocalException, match=str(HTTPStatus.NOT_FOUND.value)):
         github_local.get_keys_merged_to_dev(["BU-1"])
 
 
@@ -68,7 +69,7 @@ def test_get_branches_of_exactly_this_key_with_their_age(fake_http, github_local
     fake_http.get(f"{REFS}/feature/BU-1", json=[
         {"ref": "refs/heads/feature/BU-1-a-Yuval-Rotich", "object": {"sha": "abc"}},
         {"ref": "refs/heads/feature/BU-10-other", "object": {"sha": "def"}}])
-    fake_http.get(f"{REFS}/BU-1", status=404)
+    fake_http.get(f"{REFS}/BU-1", status=HTTPStatus.NOT_FOUND)
     fake_http.get(f"{API}/repos/circles-zone/{REPO}/commits/abc",
                   json={"commit": {"committer": {"date": commit_time(timedelta(days=3))}}})
 
@@ -86,7 +87,7 @@ def test_is_branch_of_key(branch_name, is_of_key):
     assert is_branch_of_key(branch_name, "BU-1") == is_of_key
 
 
-@pytest.mark.parametrize("status", [403, 429, 500])
+@pytest.mark.parametrize("status", [HTTPStatus.FORBIDDEN, HTTPStatus.TOO_MANY_REQUESTS, HTTPStatus.INTERNAL_SERVER_ERROR])
 def test_github_errors_raise(fake_http, github_local, status):
     fake_http.get(f"{API}/search/issues", status=status, body="error")
 

{github_local-0.0.3b3827.post12 → github_local-0.0.3b4575/python_packages/github_local.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-local
-Version: 0.0.3b3827.post12
+Version: 0.0.3b4575
 Summary: PyPI github-local Python Package owned by Circlez.ai
 Home-page: https://github.com/circles-zone/github-local-python-package
 Author: Circles

{github_local-0.0.3b3827.post12 → github_local-0.0.3b4575}/python_packages/github_local.egg-info/SOURCES.txt

@@ -13,9 +13,13 @@ python_packages/github_local.egg-info/dependency_links.txt
 python_packages/github_local.egg-info/requires.txt
 python_packages/github_local.egg-info/top_level.txt
 python_packages/github_local/src/__init__.py
+python_packages/github_local/src/classify_github_actions_failure.py
 python_packages/github_local/src/constants_github_local.py
+python_packages/github_local/src/github_actions_failure.py
+python_packages/github_local/src/github_actions_failure_category.py
 python_packages/github_local/src/github_local.py
 python_packages/github_local/tests/__init__.py
 python_packages/github_local/tests/unit/__init__.py
+python_packages/github_local/tests/unit/classify_github_actions_failure_unit_test.py
 python_packages/github_local/tests/unit/conftest.py
 python_packages/github_local/tests/unit/github_local_unit_test.py

{github_local-0.0.3b3827.post12 → github_local-0.0.3b4575}/setup.py

@@ -32,7 +32,7 @@ setuptools.setup(
     # Updating the b{{JiraWorkItemId}} done automatically by makec.ps1 / make_py.ps1
     # According to GitFlow, in the Feature Branch, after the letter 'b' comes the
     #  Jira Work Item ID, i.e., 0.0.1b2432. Semantic Version simver.org
-    version='0.0.3b3827.post12',  # https://pypi.org/project/github-local#History
+    version='0.0.3b4575',  # https://pypi.org/project/github-local#History
     author="Circles",
     author_email="info@circlez.ai",
     description=f"{PACKAGE_DESCRIPTION}",