pygitpub 0.0.62__tar.gz → 0.0.64__tar.gz

{pygitpub-0.0.62 → pygitpub-0.0.64}/.gitignore

@@ -38,6 +38,10 @@ lib*.so.*
 *.gcda
 *.map
 *.bin
+# cmake in-source build output; builds belong in build/ (ignored above)
+CMakeFiles/
+CMakeCache.txt
+cmake_install.cmake
 
 # kernel stuff
 *.ko

{pygitpub-0.0.62 → pygitpub-0.0.64}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pygitpub
-Version: 0.0.62
+Version: 0.0.64
 Summary: Pygitpub will help you work with github
 Project-URL: Homepage, https://github.com/veltzer/pygitpub
 Project-URL: Bug Tracker, https://github.com/veltzer/pygitpub/issues
@@ -41,9 +41,7 @@ project website: https://veltzer.github.io/pygitpub
 
 author: Mark Veltzer
 
-version: 0.0.62
-
-![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)
+version: 0.0.64
 
 ## github
 
@@ -69,8 +67,6 @@ version: 0.0.62
 
 ## contact me
 
-[mailto](mailto:mark.veltzer@gmail.com)
-![discord](https://img.shields.io/discord/719336281624281119)
-![discord](https://img.shields.io/discord/719336282194444302)
+[mark.veltzer@gmail.com](mailto:mark.veltzer@gmail.com)
 
 Mark Veltzer, Copyright © 2022, 2023, 2024, 2025, 2026

{pygitpub-0.0.62 → pygitpub-0.0.64}/README.md

@@ -9,9 +9,7 @@ project website: https://veltzer.github.io/pygitpub
 
 author: Mark Veltzer
 
-version: 0.0.62
-
-![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)
+version: 0.0.64
 
 ## github
 
@@ -37,8 +35,6 @@ version: 0.0.62
 
 ## contact me
 
-[mailto](mailto:mark.veltzer@gmail.com)
-![discord](https://img.shields.io/discord/719336281624281119)
-![discord](https://img.shields.io/discord/719336282194444302)
+[mark.veltzer@gmail.com](mailto:mark.veltzer@gmail.com)
 
 Mark Veltzer, Copyright © 2022, 2023, 2024, 2025, 2026

{pygitpub-0.0.62 → pygitpub-0.0.64}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pygitpub"
-version = "0.0.62"
+version = "0.0.64"
 requires-python = ">=3.14"
 authors = [
 	{ name = "Mark Veltzer", email = "mark.veltzer@gmail.com" }
@@ -41,8 +41,7 @@ dependencies = [
 
 [dependency-groups]
 dev = [
-    "mypy",
-    "pylint",
+    "pyrefly",
     "pytest",
     "ruff",
     "sphinx",
@@ -83,24 +82,29 @@ exclude = [
     "*.md",
 ]
 
-[tool.mypy]
-python_version = "3.14"
-warn_return_any = true
-warn_unused_configs = true
-mypy_path = "src:python:scripts"
-explicit_package_bases = true
-namespace_packages = true
-
-# Third-party libraries without type stubs; `foo.*` also matches `foo` itself.
-[[tool.mypy.overrides]]
-module = [
+[tool.pyrefly]
+# Type checking (rsconstruct's pyrefly processor). preset = "legacy" is
+# pyrefly's mypy-compatible behavior; "." on the search path is mypy's
+# implicit current directory.
+preset = "legacy"
+python-version = "3.14"
+search-path = [
+    "src",
+    "scripts",
+    ".",
+]
+# Third-party libraries without type information.
+ignore-missing-imports = [
     "github.*",
     "lupa.*",
     "pyapikey.*",
     "pylogconf.*",
     "pytconf.*",
 ]
-ignore_missing_imports = true
+
+[tool.pyrefly.errors]
+no-any-return = "error"
+
 [tool.hatch.envs.default]
 installer = "uv"
 

{pygitpub-0.0.62 → pygitpub-0.0.64}/src/pygitpub/configs.py

@@ -63,6 +63,26 @@ class ConfigAlgo(Config):
     )
 
 
+# The ways the runs_show_failing and runs_show_not_success endpoints can
+# query github. The first is the default.
+RUNS_APIS = [
+    "graphql",
+    "rest",
+]
+
+
+class ConfigRuns(Config):
+    """
+    Parameters to control how workflow runs are queried
+    """
+    api = ParamCreator.create_choice(
+        choice_list=RUNS_APIS,
+        help_string="graphql: check the default branch head commit of all repos in parallel batches (fast);"
+                    " rest: walk every workflow's last run on any branch (slow, one call per workflow)",
+        default="graphql",
+    )
+
+
 class ConfigOutput(Config):
     """
     Parameters to control output

{pygitpub-0.0.62 → pygitpub-0.0.64}/src/pygitpub/main.py

@@ -6,6 +6,9 @@ import json
 import os
 import subprocess
 import sys
+from collections.abc import Callable
+from concurrent.futures import ThreadPoolExecutor
+from typing import Any
 
 import github
 import pyapikey
@@ -15,7 +18,7 @@ from pytconf.pydoc import get_first_line
 from pytconf.registry import the_registry
 
 import pygitpub.static
-from pygitpub.configs import AFFILIATIONS, ConfigAlgo, ConfigGithub, ConfigOutput
+from pygitpub.configs import AFFILIATIONS, ConfigAlgo, ConfigGithub, ConfigOutput, ConfigRuns
 from pygitpub.utils.lua import config_path, load_lua_file
 from pygitpub.utils.misc import get_all_git_repos
 
@@ -31,7 +34,7 @@ def get_repo_folder(repo) -> str:
 
 def get_affiliation() -> str:
     """ validate the affiliation parameter and return it in the form github wants """
-    values = [x.strip() for x in ConfigAlgo.affiliation.split(",")]
+    values: list[str] = [x.strip() for x in ConfigAlgo.affiliation.split(",")]
     values = [x for x in values if x != ""]
     if not values:
         raise ValueError("affiliation must not be empty")
@@ -202,7 +205,7 @@ def cleanup() -> None:
             existing = 0
             for run in workflow.get_runs():
                 if ConfigOutput.verbose:
-                    print(f"inspecting {repo.name} {workflow.name} {run.conclusion}")
+                    print(f"inspecting [workflow run] {repo.name} {workflow.name} {run.conclusion}")
                 delete_it = False
                 # if its a pages build delete it unless its in mid work (run.conclusion is None)
                 if workflow.name == "pages-build-deployment" and run.conclusion is not None:
@@ -218,7 +221,7 @@ def cleanup() -> None:
                 if existing >= 4:
                     delete_it = True
                 if delete_it:
-                    print(f"deleting {repo.name} {workflow.name} {run.head_branch} {run.conclusion} {run.url}")
+                    print(f"deleting [workflow run] {repo.name} {workflow.name} {run.head_branch} {run.conclusion} {run.url}")
                     try:
                         run.delete()
                     except github.GithubException as e:
@@ -241,7 +244,7 @@ def cleanup() -> None:
                 existing_deployments += 1
 
             if delete_it:
-                print(f"deleting deployment {repo.name} {deployment.id}")
+                print(f"deleting [deployment] {repo.name} {deployment.id}")
                 try:
                     deployment.create_status("inactive")
                 except github.GithubException as e:
@@ -258,7 +261,7 @@ def cleanup() -> None:
         existing_releases = 0
         for release in repo.get_releases():
             if existing_releases >= 4:
-                print(f"deleting release {repo.name} {release.title}")
+                print(f"deleting [release] {repo.name} {release.title}")
                 try:
                     release.delete_release()
                 except github.GithubException as e:
@@ -296,14 +299,123 @@ def runs_show_running() -> None:
                     print(f"{repo.name}: {workflow.name} {run.conclusion}")
 
 
+# repos per GraphQL query; measured fastest at around 10
+GRAPHQL_BATCH_SIZE = 10
+# GraphQL queries in flight at once, well below github's concurrency limits
+GRAPHQL_WORKERS = 26
+
+GRAPHQL_ROLLUP_FIELD = """
+r{index}: repository(owner: {owner}, name: {name}) {{
+  defaultBranchRef {{ target {{ ... on Commit {{ statusCheckRollup {{ state }} }} }} }}
+}}
+"""
+
+GRAPHQL_SUITES_QUERY = """
+query($owner: String!, $name: String!) {
+  repository(owner: $owner, name: $name) {
+    defaultBranchRef {
+      target {
+        ... on Commit {
+          checkSuites(first: 50) {
+            nodes {
+              status
+              conclusion
+              workflowRun { workflow { name } }
+            }
+          }
+        }
+      }
+    }
+  }
+}
+"""
+
+
+def graphql_show_runs(bad_state: Callable[[str], bool], bad_conclusion: Callable[[str], bool]) -> None:
+    """
+    Print the workflows that are not green on the default branch head commit
+    of every repo.
+
+    Resolving statusCheckRollup is slow on github's side (~4.5s per 50 repos)
+    and cursor pagination would run the pages one after another, so the repos
+    are split into small batches, each batch is one query with an aliased
+    `repository` field per repo, and the batches run in parallel. Repos whose
+    rollup state is bad then get one more query each to name the workflows.
+    Only the head commit of the default branch is looked at, so a failed run
+    on another branch, or a scheduled run on an older commit, does not show.
+    """
+    apikey = pyapikey.get_key(ConfigGithub.apikey)
+    # the default client sleeps a second between POSTs, and every GraphQL
+    # query is a POST, which would serialize the parallel queries
+    g = github.Github(
+        login_or_token=apikey,
+        pool_size=GRAPHQL_WORKERS,
+        seconds_between_requests=None,
+        seconds_between_writes=None,
+    )
+
+    def graphql(query: str, variables: dict[str, str]) -> dict[str, Any]:
+        _headers, data = g.requester.graphql_query(query, variables)
+        result: dict[str, Any] = data["data"]
+        return result
+
+    def get_states(batch: list[str]) -> list[str | None]:
+        fields = []
+        for index, full_name in enumerate(batch):
+            owner, name = full_name.split("/", 1)
+            # json.dumps gives a correctly quoted GraphQL string literal
+            fields.append(GRAPHQL_ROLLUP_FIELD.format(index=index, owner=json.dumps(owner), name=json.dumps(name)))
+        data = graphql("query {" + "".join(fields) + "}", {})
+        states: list[str | None] = []
+        for index in range(len(batch)):
+            ref = data[f"r{index}"]["defaultBranchRef"]
+            rollup = ref and ref["target"].get("statusCheckRollup")
+            states.append(rollup and rollup["state"])
+        return states
+
+    def get_bad_workflows(full_name: str) -> list[tuple[str, str]]:
+        owner, name = full_name.split("/", 1)
+        data = graphql(GRAPHQL_SUITES_QUERY, {"owner": owner, "name": name})
+        workflows = []
+        for suite in data["repository"]["defaultBranchRef"]["target"]["checkSuites"]["nodes"]:
+            # github creates an empty, never-run suite for every installed
+            # app; without a workflow run behind it, it tells us nothing
+            if suite["workflowRun"] is None:
+                continue
+            # an unfinished suite has no conclusion yet; report its status
+            conclusion = suite["conclusion"] or suite["status"]
+            if bad_conclusion(conclusion):
+                workflows.append((suite["workflowRun"]["workflow"]["name"], conclusion.lower()))
+        return workflows
+
+    full_names = [repo.full_name for repo in yield_repos()]
+    batches = [full_names[i:i + GRAPHQL_BATCH_SIZE] for i in range(0, len(full_names), GRAPHQL_BATCH_SIZE)]
+    with ThreadPoolExecutor(GRAPHQL_WORKERS) as executor:
+        states = [state for result in executor.map(get_states, batches) for state in result]
+        # repos without any checks have no state and are skipped, as the rest
+        # api path skips workflows that never ran
+        bad = [full_name for full_name, state in zip(full_names, states) if state is not None and bad_state(state)]
+        for full_name, workflows in zip(bad, executor.map(get_bad_workflows, bad)):
+            name = full_name.split("/", 1)[1]
+            for workflow, conclusion in workflows:
+                print(f"{name}: {workflow} {conclusion}")
+
+
 @register_endpoint(
     description="Show all runs which are last and failing in all workflows and all repositories",
     configs=[
         ConfigGithub,
         ConfigAlgo,
+        ConfigRuns,
     ],
 )
 def runs_show_failing() -> None:
+    if ConfigRuns.api == "graphql":
+        graphql_show_runs(
+            lambda state: state in ("FAILURE", "ERROR"),
+            lambda conclusion: conclusion == "FAILURE",
+        )
+        return
     for repo in yield_repos():
         for workflow in repo.get_workflows():
             last_run = next(iter(workflow.get_runs()), None)
@@ -316,9 +428,16 @@ def runs_show_failing() -> None:
     configs=[
         ConfigGithub,
         ConfigAlgo,
+        ConfigRuns,
     ],
 )
 def runs_show_not_success() -> None:
+    if ConfigRuns.api == "graphql":
+        graphql_show_runs(
+            lambda state: state != "SUCCESS",
+            lambda conclusion: conclusion != "SUCCESS",
+        )
+        return
     for repo in yield_repos():
         for workflow in repo.get_workflows():
             last_run = next(iter(workflow.get_runs()), None)

{pygitpub-0.0.62 → pygitpub-0.0.64}/src/pygitpub/static.py

@@ -1,5 +1,5 @@
 """ version which can be consumed from within the module """
-VERSION_STR = "0.0.62"
+VERSION_STR = "0.0.64"
 DESCRIPTION = "Pygitpub will help you work with github"
 APP_NAME = "pygitpub"
 LOGGER_NAME = "pygitpub"