github-rest-api 0.47.1__py3-none-any.whl → 0.48.0__py3-none-any.whl

github_rest_api/github.py

@@ -31,9 +31,9 @@ DEFAULT_PR_MODEL = "anthropic/claude-haiku-4-5-20251001"
 # Defaults for automatic pull request merging (see Repository.auto_merge_pull_requests).
 # A marker comment from an allowlisted approver is accepted as an approval signal
 # for AI reviewers that only comment instead of submitting a formal review.
-DEFAULT_AUTO_MERGE_MARKER = "<!-- auto-merge: approved -->"
+DEFAULT_AUTO_MERGE_MARKER = "AUTO_MERGE_APPROVED"
 # Conventional-commit title types eligible for auto-merge.
-DEFAULT_AUTO_MERGE_TYPES = ("chore", "docs", "deps")
+DEFAULT_AUTO_MERGE_TYPES = ("build", "chore", "ci", "docs", "deps")
 # A PR is only auto-merged once its head commit is at least this old, an anti-race
 # guard so a PR that momentarily reads `clean` before CI registers is not merged.
 # A just-created PR is simply deferred to the next run, never dropped, so a small
@@ -177,8 +177,15 @@ def _field_gate_failure(
         return "it is a draft"
     if not _in_allowlist(_login(pr), _normalized_logins(authors)):
         return "its author is not in the allowlist"
-    if not _title_type_allowed(pr.get("title") or "", allowed_types):
-        return "its title type is not auto-merge eligible"
+    title = pr.get("title") or ""
+    if not _title_type_allowed(title, allowed_types):
+        type_ = _conventional_type(title)
+        current = f"'{type_}'" if type_ is not None else "missing/unrecognized"
+        eligible = ", ".join(allowed_types) or "none"
+        return (
+            f"its title type ({current}) is not auto-merge eligible "
+            f"(eligible types: {eligible})"
+        )
     return None
 
 

github_rest_api/scripts/github/create_github_repo.py

@@ -2,6 +2,7 @@
 
 import argparse
 import getpass
+import logging
 import os
 import shutil
 import sys
@@ -12,6 +13,8 @@ from dulwich import porcelain
 
 from github_rest_api import Organization, User
 
+logger = logging.getLogger(__name__)
+
 
 def _validate_repo(repo: str) -> None:
     parts = repo.split("/")
@@ -28,8 +31,9 @@ def _create_remote_repo(
         if is_owner_user
         else Organization(token=token, org=owner)
     )
+    logger.info("Creating remote GitHub repository '%s'...", repo)
     entity.create_repository(name=r, private=private)
-    print(f"\nCreated the GitHub repo https://github.com/{repo}.\n")
+    logger.info("Created the GitHub repo https://github.com/%s.", repo)
 
 
 def _remote_url(repo: str, protocol: str) -> str:
@@ -41,6 +45,7 @@ def _remote_url(repo: str, protocol: str) -> str:
 def _ensure_remote(path: Path, repo: str, protocol: str) -> None:
     try:
         porcelain.remote_add(path, "origin", _remote_url(repo, protocol))
+        logger.info("Added remote 'origin' for %s", repo)
     except porcelain.RemoteExists:
         pass
 
@@ -62,39 +67,57 @@ def _init_local_repo(
     dir_: str,
     token: str,
     protocol: str,
+    push: bool,
     branches: Sequence[str] = ("main",),
 ) -> None:
+    branches = list(dict.fromkeys(branches))
+    if not branches:
+        raise ValueError("At least one branch must be specified.")
     repo_name = repo.split("/")[-1]
     path = Path(dir_) if dir_ else Path(repo_name)
     path.mkdir(parents=True, exist_ok=True)
     readme = path / "README.md"
     if not readme.exists():
         readme.write_text(f"# {repo_name}\n")
+        logger.info("Created %s", readme)
     if not (path / ".git").exists():
         porcelain.init(path=path)
+        logger.info("Initialized empty Git repository in %s", path)
     if not porcelain.branch_list(path):
         initial_branch = _active_branch(path)
         porcelain.add(repo=path, paths=["README.md"])
+        logger.info("Added README.md to staging")
         porcelain.commit(repo=path, message="first commit")
+        logger.info("Created first commit")
         for branch in branches:
             if branch != initial_branch:
                 porcelain.branch_create(repo=path, name=branch)
+                logger.info("Created branch '%s'", branch)
         porcelain.checkout(repo=path, target=branches[0])
+        logger.info("Checked out branch '%s'", branches[0])
         if initial_branch not in branches:
             porcelain.branch_delete(repo=path, name=initial_branch)
+            logger.info("Deleted initial branch '%s'", initial_branch)
+    else:
+        existing_branches = {b.decode() for b in porcelain.branch_list(path)}
+        for branch in branches:
+            if branch not in existing_branches:
+                porcelain.branch_create(repo=path, name=branch)
+                logger.info("Created branch '%s' from HEAD", branch)
     _ensure_remote(path, repo, protocol)
-    local_branches = {b.decode() for b in porcelain.branch_list(path)}
-    branches_to_push = [branch for branch in branches if branch in local_branches]
-    if not branches_to_push:
-        branches_to_push = [_active_branch(path)]
-    for branch in branches_to_push:
-        porcelain.push(
-            repo=path,
-            remote_location=_remote_url(repo, "https"),
-            refspecs=[branch.encode()],
-            username="x-access-token",
-            password=token,
-        )
+    if push:
+        for branch in branches:
+            logger.info("Pushing branch '%s' to remote '%s'...", branch, repo)
+            porcelain.push(
+                repo=path,
+                remote_location=_remote_url(repo, "https"),
+                refspecs=[branch.encode()],
+                username="x-access-token",
+                password=token,
+            )
+            logger.info("Successfully pushed branch '%s'.", branch)
+    else:
+        logger.info("Skipping push (pass --push to push branches to the remote).")
     _add_workflow(path, language)
 
 
@@ -106,6 +129,7 @@ def create_github_repo(
     dir_: str,
     token: str,
     protocol: str,
+    push: bool,
     branches: Sequence[str] = ("main",),
 ) -> None:
     token = token or os.getenv("GITHUB_TOKEN", "")
@@ -127,6 +151,7 @@ def create_github_repo(
         token=token,
         branches=branches,
         protocol=protocol,
+        push=push,
     )
 
 
@@ -138,6 +163,7 @@ def _add_workflow(path: Path, language: str, workflow_dir: Path | None = None) -
     for yaml in workflow_dir.glob("*.yaml"):
         if not (dir_dest / yaml.name).exists():
             shutil.copy2(yaml, dir_dest)
+            logger.info("Copied workflow %s to %s", yaml.name, dir_dest)
     if not language:
         return
     lang_dir = workflow_dir / language
@@ -146,6 +172,9 @@ def _add_workflow(path: Path, language: str, workflow_dir: Path | None = None) -
     for yaml in lang_dir.glob("*.yaml"):
         if not (dir_dest / yaml.name).exists():
             shutil.copy2(yaml, dir_dest)
+            logger.info(
+                "Copied %s specific workflow %s to %s", language, yaml.name, dir_dest
+            )
 
 
 def parse_args(args=None, namespace=None):
@@ -205,7 +234,7 @@ def parse_args(args=None, namespace=None):
         nargs="+",
         default=["main"],
         metavar="BRANCH",
-        help="Branches to create and push to remote (default: main).",
+        help="Branches to create (and push if --push is set) (default: main).",
     )
     parser.add_argument(
         "--https",
@@ -215,11 +244,25 @@ def parse_args(args=None, namespace=None):
         default="git",
         help="Use the HTTPS protocol for the remote URL.",
     )
+    parser.add_argument(
+        "--push",
+        dest="push",
+        action="store_true",
+        help="Push branches to the remote (by default, nothing is pushed).",
+    )
+    parser.add_argument(
+        "-v",
+        "--verbose",
+        dest="verbose",
+        action="store_true",
+        help="Enable verbose output, including tracebacks on errors.",
+    )
     return parser.parse_args(args=args, namespace=namespace)
 
 
 def main() -> int:
     args = parse_args()
+    logging.basicConfig(level=logging.INFO, format="%(message)s")
     try:
         create_github_repo(
             repo=args.repo,
@@ -230,9 +273,10 @@ def main() -> int:
             token=args.token,
             branches=args.branches,
             protocol=args.protocol,
+            push=args.push,
         )
     except Exception as e:
-        print(str(e), file=sys.stderr)
+        logger.error("Failed to create GitHub repo: %s", e, exc_info=args.verbose)
         return 1
     return 0
 

github_rest_api/scripts/github/workflows/auto_merge_pull_request.yaml

@@ -0,0 +1,30 @@
+name: Auto Merge PR
+on:
+  pull_request_review:
+    types:
+      - submitted
+  issue_comment:
+    types:
+      - created
+  check_suite:
+    types:
+      - completed
+  schedule:
+    - cron: '0 * * * *'
+      timezone: 'America/Los_Angeles'
+permissions:
+  contents: write
+  pull-requests: write
+jobs:
+  auto_merge_pull_request:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Install uv
+        run: |
+          curl -LsSf https://astral.sh/uv/install.sh | sudo env UV_INSTALL_DIR="/usr/local/bin" sh
+      - name: Auto Merge PR
+        run: |
+          uvx --from github-rest-api@latest auto_merge_pull_request \
+            --authors dclong \
+            --approvers dclong 'claude[bot]' 'gemini-code-assist[bot]' \
+            --token ${{ secrets.ACTIONS_TOKEN }}

{github_rest_api-0.47.1.dist-info → github_rest_api-0.48.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-rest-api
-Version: 0.47.1
+Version: 0.48.0
 Summary: Simple wrapper of GitHub REST APIs.
 Author-email: Ben Du <longendu@yahoo.com>
 Classifier: Programming Language :: Python :: 3 :: Only

{github_rest_api-0.47.1.dist-info → github_rest_api-0.48.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
 github_rest_api/__init__.py,sha256=VVpiUHVLbjjJGNN88OmEvCwq4xmBnXv68T8Apk_lwVc,282
-github_rest_api/github.py,sha256=iAfhPLH9UGPtScZfcV1TCeY5XfUzAMqenf5FrSNplQc,45146
+github_rest_api/github.py,sha256=tcP2ETyIySFto82S73IZLDaRaRrj9bZjd9wi-VWKUIo,45427
 github_rest_api/pr_content.py,sha256=og1VwsMtwqwl-HUJcJrkwjUjFPw9E1k5xDtJVMAXBRo,10039
 github_rest_api/utils.py,sha256=RspoIZik0g105KpyFXCf4epAtgu1dUsxwlwUSSGhXPI,2697
 github_rest_api/scripts/__init__.py,sha256=NkHTngnnWXPc0JmO5mqVKjDf4JPofuwWjDW1SU3aE7Y,36
@@ -14,17 +14,18 @@ github_rest_api/scripts/container/config_container.py,sha256=BtOqgZlQFM9cWZMoHKv
 github_rest_api/scripts/container/update_version_containerfile.py,sha256=1PkuJkAsJBCEMdacMSndbuZKcmgUyXy6nBArnxKoPZk,4535
 github_rest_api/scripts/github/__init__.py,sha256=tEU1SdCS51M4M13WoqXZt3rjGEAI_QgNljt5XAyQJ_w,38
 github_rest_api/scripts/github/auto_merge_pull_request.py,sha256=_5191Xt_b8DtxjIqHrdY-gKLxvkzWd8oWoSbF2uauc8,3527
-github_rest_api/scripts/github/create_github_repo.py,sha256=gI4qt6ncOk2pB9dfZkXW_YSffbdQhWmqWmMYjXwsD44,7104
+github_rest_api/scripts/github/create_github_repo.py,sha256=6WBMcHtY0rn_ZaF_3TN_sX2QFpklE4TPKNSXOPBwmw0,8919
 github_rest_api/scripts/github/create_pull_request.py,sha256=gXtRRsxzegGxagHb6k3kxtRd3mt4QVwSPZQpsFnzz1Y,3968
 github_rest_api/scripts/github/release_on_github.py,sha256=9psaIv-GtrHdvE-tkw0yxCMDmW0bPts-db2vUxhoKXo,4368
 github_rest_api/scripts/github/remove_branch.py,sha256=iKZ4Y_lQlSOIfifC4plqP-B6pEMnFrknGMvV1oLnuLc,3538
+github_rest_api/scripts/github/workflows/auto_merge_pull_request.yaml,sha256=LOCYzTnubAqBbeGunSdnEt453ZLwJ2870YxRlcPJ7GE,768
 github_rest_api/scripts/github/workflows/create_pr_dev_to_main.yaml,sha256=fuYNQJ_BthRWmFv2J0JZgB_LrBsmEVAc8rZ-Cs_AqrQ,517
 github_rest_api/scripts/github/workflows/create_pr_to_dev.yaml,sha256=wFekTLVWffPQOguJCMfu8NnxLQ3OFvN5aBmYih8Ag14,548
 github_rest_api/scripts/github/workflows/create_pr_to_main.yaml,sha256=mgHPlewkCZfRyMH6PYtPlo-fuE7DaD8v_jj2dSc3nPA,531
 github_rest_api/scripts/github/workflows/remove_branch.yaml,sha256=KDpB76ovrhuRdP0HN5j6Th9gjIQWSDdh8b4b4yAgtoI,544
 github_rest_api/scripts/github/workflows/python/lint.yaml,sha256=toP2oUdVIKyu_n20Dr14k5cJYxN8rPksfbX4sfflXxc,699
 github_rest_api/scripts/github/workflows/python/test.yaml,sha256=86MljYEWX1E9kJYmhMCLwu46WNEWvoyO9PwqeRew540,887
-github_rest_api-0.47.1.dist-info/METADATA,sha256=b9iysY6lBcuo-RKdZ2j-z7qXusI1uTbDzuBPuqh1rAU,915
-github_rest_api-0.47.1.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
-github_rest_api-0.47.1.dist-info/entry_points.txt,sha256=OfbP9GuQC7SyGbymfCYrXEG-TCcKuu31v0EPNvHc1Q4,659
-github_rest_api-0.47.1.dist-info/RECORD,,
+github_rest_api-0.48.0.dist-info/METADATA,sha256=GUo2AkySz1q5KewbBDYUPV-2Yvbchmhd4WXyT2zescs,915
+github_rest_api-0.48.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+github_rest_api-0.48.0.dist-info/entry_points.txt,sha256=OfbP9GuQC7SyGbymfCYrXEG-TCcKuu31v0EPNvHc1Q4,659
+github_rest_api-0.48.0.dist-info/RECORD,,