New Features
- Add
conditions_evaluation
property to/queue/{queue_name}/pull/{pr_number}
endpoint. This property contains a JSON tree with queue rule conditions evaluation. - Queue action has a new option
batch_max_failure_resolution_attempts
corresponding to the number of attempts to resolve a batch failure before unqueueing pull requests. By default, Mergify will attempt to resolve a batch failure by splitting it. You can choose to stop this process after several splits. - It is now possible to use some commit details in the conditions. Each commit can be accessed via its index and needs to be followed by the attribute you want to access, eg:
commits[0].commit_message
for the message of the first commit,commits[-1].date_committer
for the last commit's date. The available attributes areauthor
,commit_message
,commit_verification_verified
,committer
,date_author
,date_committer
,email_author
,email_committer
. The operations available on each attribute depend on its type, you can refer to the documentation for more information. - Add new
/queue/{queue_name}/pull/{pr_number}
endpoint to the API. This endpoint returns data from a queued pull request. - The
label
action now has a new option calledtoggle
. This option will add labels if the rule's conditions are a success and remove those if the rule's conditions fail. - Mergify now allows to disable the cascading effect of a queue freeze through a new attribute named
cascading
available in/api/repos/<owner>/<repo>/queue/<queue_name>/freeze
. - Mergify now allows you to define
priority_rules
in thequeue_rules
configuration.priority_rules
allows you to prioritize pull request treatment inside a queue based on your custom conditions. - The
rebase
action will now rebase a PR, even if it has no commits behind, if theautosquash
option is enabled.
Deprecation Notes
- Deprecate property
speculative_check_pull_request
in/queues
API endpoint. This property is replaced bymergeability_check
which is shorter. Details can be retrieved with new endpoint/queue/{queue_name}/pull/{pr_number}
. - The conditions attributes
current-time
,current-day-of-week
,current-day
,current-timestamp
are deprecated in favor of theschedule
attribute. The conditions attributecurrent-month
,current-year
are also being deprecated but do not have a replacement attribute. - The
priority
configuration option of the merge action is deprecated and planned for removal. - The environment variables
MERGIFYENGINE_GITHUB_REST_API_URL
andMERGIFYENGINE_GITHUB_GRAPHQL_API_URL
are no longer required. - The environment variables
MERGIFYENGINE_BOT_USER_ID
andMERGIFYENGINE_BOT_USER_LOGIN
are no longer required. - The
rebase_fallback
configuration option of the queue and merge actions is deprecated and planned for removal.
Bug Fixes
- Multiple
pull_request_rules
with the samename
in the configuration will raise an error.