Version 9 (modified by 7 years ago) (diff) | ,
---|
Contents
Track the status of code repository pull requests
Description
This plugin allows you to track the status of your code repository pull requests (PR). A pull request is a request or proposal to submit code changes into a main code repository. Pull is standard terminology from version control systems like Git or Mercurial. Basically it is a method of submitting contributions. The contributor has a clone of the main repository, pushes the proposed changes to that clone, then submits a pull request. The pull request contains the information required to merge these changes back to the main repository. Usually this means the URL of the repository and a branch (Git) or bookmark name (Mercurial). See also here.
A special <command> PR: [arg]
syntax is introduced to create and control pull requests from ticket comments:
This plugin also adds a macro that lists the queried pull requests, and it also adds a new admin panel, that lists all pull requests:
Create Pull Request
A new pull request is automatically created when a ticket comment contains the command open PR: <link>
.
Examples:
open PR: changeset:123/MyForkedRepositoryName
open PR: log:MyForkedRepositoryName@bookmark_name
open PR: [https://www.example.com/git/branches/123 Branch 123]
The pull request number is automatically inserted into the ticket comment.
The trac.ini option [pullrequests] create_commands
can be changed to allow multiple or different commands that create pull requests in different states. The status of a created pull request is always the same as the command that was used to create it.
Change Status of a Pull Request
The status of a pull request is automatically changed when a ticket comment contains the command <newstatus> PR:<number>
.
Examples:
reviewed PR:3
closed PR:7
The trac.ini option [pullrequests] update_commands
can be changed to allow different commands that change the pull request statuses. The next status of a pull request is always the same as the command that was used to change status.
PRQuery Macro
A new macro allows listing all pull requests by author and / or status.
Examples:
[[PRQuery()]]
[[PRQuery(status=reviewed)]]
[[PRQuery(status=!closed)]]
[[PRQuery(status=reviewed, author=joe)]]
[[PRQuery(status=open, author=!joe)]]
Bugs/Feature Requests
Existing bugs and feature requests for PullRequestsPlugin are here.
If you have any issues, create a new ticket.
defect |
6 / 7 |
||
---|---|---|---|
enhancement |
1 / 2 |
Download
Download the zipped source from here.
Source
You can check out PullRequestsPlugin from here using Subversion, or browse the source with Trac.
Installation
General instructions on installing Trac plugins can be found on the TracPlugins page.
Recent Changes
- 17663 by lucid on 2020-01-26 12:48:11
-
PullRequestsPlugin: Python3 compatibility.
(fix #13741)
- 17486 by lucid on 2019-09-03 20:40:11
-
PullRequestsPlugin: Fix selected options.
Jinja does not remove attributes with value None anymore.
(see #13594)
- 17475 by lucid on 2019-08-31 09:55:30
-
PullRequestsPlugin: Support Trac 1.5.1+ using Jinja templates.
Bump version to 1.2
Refs #13594.
(more)
Author/Contributors
Attachments (2)
- PullRequestsExample.png (44.5 KB) - added by 7 years ago.
- PullRequestsAdmin.png (42.4 KB) - added by 7 years ago.
Download all attachments as: .zip