branch_outdated: Branch out of date#
The branch of a pull request is behind its base branch.
Holds when its base branch has commits that the branch of the pull request does
not have, and the repository requires branches to be up to date before merging
(mergeable_state is behind). A merged pull request is not out of date, see
branch_up_to_date: Branch up to date.
It is checked on pull requests only. While the data of a pull request is not complete, the condition cannot be assessed yet.
Inputs#
The condition has no inputs.
Data#
The update of the repository reads in the background:
pull_requestWhether the pull request can be merged, is behind its base, and merges itself. Permissions of the GitHub App:
pull_requests: read,contents: read; webhooks:pull_request,push.
API reference#
- class pycal_dashboard.conditions.condition.branch_outdated.BranchOutdated#
Bases:
ConditionThe branch of a pull request is out of date.
Holds when its base branch has commits that the branch of the pull request does not have, and the repository requires branches to be up to date before merging (
mergeable_stateisbehind). A merged pull request is not out of date.- classmethod assess(issue, values)#
Whether the branch is behind its base.
- Parameters:
issue – The pull request.
values – Nothing: the condition has no inputs.
- Returns:
True if it is behind.