github2gerrit 2.3.0__py3-none-any.whl → 2.4.0__py3-none-any.whl

github2gerrit/models.py

@@ -27,18 +27,21 @@ RECHECK_EVENTS: frozenset[str] = frozenset(
     {
         "issue_comment",
         "pull_request_review",
+        "schedule",
     }
 )
 """Events that ask the tool to look at a pull request again.
 
-Neither changes the pull request's code, so each maps to UPDATE: an
+None changes the pull request's code, so each maps to UPDATE: an
 existing Gerrit change should gain a patchset rather than a sibling.
 
 They exist because the fork approval gate needs a **privileged** run to
 notice that a maintainer has approved.  GitHub withholds secrets from
 ``pull_request_review`` on a fork pull request, so the approval itself
 cannot be the run that acts on it (see
-:func:`github2gerrit.cli._skip_unprivileged_fork_run`).
+:func:`github2gerrit.cli._skip_unprivileged_fork_run`).  A comment
+asks for the re-check; a schedule makes it without anyone asking, one
+pull request per job of the reusable workflow's sweep (#421).
 
 The important property is that these are *triggers only*.  They decide
 when to re-evaluate, never whether to proceed: authorisation is always

{github2gerrit-2.3.0.dist-info → github2gerrit-2.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: github2gerrit
-Version: 2.3.0
+Version: 2.4.0
 Summary: Submit a GitHub pull request to a Gerrit repository.
 Project-URL: Homepage, https://github.com/lfreleng-actions/github2gerrit-action
 Project-URL: Repository, https://github.com/lfreleng-actions/github2gerrit-action
@@ -145,6 +145,9 @@ on:
   # pull_request_review runs on fork PRs.
   issue_comment:
     types: [created]
+  # Optional: transfer approved fork PRs without anyone commenting.
+  # schedule:
+  #   - cron: "17 * * * *"
   push:
     branches: [main, master]
   workflow_dispatch:
@@ -189,6 +192,12 @@ which closes a human-authored pull request before the approval gate
 sees it, so leaving it set would make the fork path unreachable. Drop
 both if the repository only ever receives automation PRs.
 
+The optional `schedule` trigger does the comment's job unattended: each
+run transfers fork pull requests whose current commit a maintainer has
+approved, one job per pull request, and leaves every other pull request
+alone. See
+[scheduled sweeps](docs/features.md#which-triggers-can-lift-the-gate).
+
 Repositories using the Gerrit-side dispatch integration should also
 declare `GERRIT_CHANGE_URL`, `GERRIT_EVENT_TYPE`, and `GERRIT_BRANCH`
 as dispatch inputs and forward them the same way.
@@ -263,7 +272,8 @@ A composite action cannot start jobs, so here a bulk `workflow_dispatch`
 (`PR_NUMBER` of `0`) still processes every open pull request in one job. That
 job does not serialise against the per-pull-request runs events start, so
 avoid triggering one while pull request activity is in flight, or use the
-reusable workflow, which fans the sweep out.
+reusable workflow, which fans the sweep out. For the same reason a `schedule`
+trigger works only through the reusable workflow.
 
 ### Option C: command-line tool
 

{github2gerrit-2.3.0.dist-info → github2gerrit-2.4.0.dist-info}/RECORD

@@ -19,7 +19,7 @@ github2gerrit/github_api.py,sha256=GuncFKSyd8PYlTAzc4iIZIvNnQB4sN0pXn_-Gh5s3ck,1
 github2gerrit/gitreview.py,sha256=JV7wIninafcEw5bIt9KxN6ZtGWCPsQ0eq-VeOQ-R2kA,24240
 github2gerrit/gitutils.py,sha256=PtaQMpYrf4hC2TjR8fyI0OjHyCLeDnyK8rsvOac2uoE,26512
 github2gerrit/mapping_comment.py,sha256=4jpiiMnoZCT-rRd3WIdMi-afrI3HriwCfdYZ8qLZHE0,9670
-github2gerrit/models.py,sha256=fwTR7HhEd6zrN2nivi1lvVYST0tC9r5EcFXTAPBHXrc,8441
+github2gerrit/models.py,sha256=t7zu3jPaZOWp8RcEu4Oa1_8WmdIjhLIldYpYd5vAExQ,8601
 github2gerrit/netrc.py,sha256=lRoT001CjqcduIjmJ3GNz9h8oH4OYTlppKYt32V-pRE,26941
 github2gerrit/pr_approval.py,sha256=UJHnUpyJqgTtL3KqS-An-tsjjmi5-bzs5YauU0ddvww,13489
 github2gerrit/pr_commands.py,sha256=4HK6GU8QRMbe2AIx9QT5_BVn7cY8XC3dtgPuwc74vOU,19458
@@ -39,8 +39,8 @@ github2gerrit/trust.py,sha256=_1T4qRmnpQNd6dcVMBGqrP0pcZsW5QKYgpHWYsAZuoI,4275
 github2gerrit/utils.py,sha256=2izB7vvp0-Lnej4dx5eE8mW3is-PdYBWQyor8eUcyhk,6934
 github2gerrit/orchestrator/__init__.py,sha256=HAEcdCAHOFr8LsdIwAdcIcFZn_ayMbX9rdVUULp8410,864
 github2gerrit/orchestrator/reconciliation.py,sha256=TJaAsuLo0_PRnWt3e_RxwKufETKX8b1unV_U_lsZp8E,22105
-github2gerrit-2.3.0.dist-info/METADATA,sha256=TKGCNshcuoduChUqLMH0kIG75Gs1jcjLUJOrBH_dm-4,27100
-github2gerrit-2.3.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-github2gerrit-2.3.0.dist-info/entry_points.txt,sha256=MxN2_liIKo3-xJwtAulAeS5GcOS6JS96nvwOQIkP3W8,56
-github2gerrit-2.3.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-github2gerrit-2.3.0.dist-info/RECORD,,
+github2gerrit-2.4.0.dist-info/METADATA,sha256=fWui6xxhAH1mHt2whscLFmaVFTVHj_YPR-8xCAv5ZlI,27590
+github2gerrit-2.4.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+github2gerrit-2.4.0.dist-info/entry_points.txt,sha256=MxN2_liIKo3-xJwtAulAeS5GcOS6JS96nvwOQIkP3W8,56
+github2gerrit-2.4.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+github2gerrit-2.4.0.dist-info/RECORD,,