附加组件
关于这个附加组件
Seams bring you Patchwork!
Seams provides some integration with Patchwork, the patch tracking system. It makes the patch state visible directly from Thunderbird. It also displays useful links to the patch or its series on a Patchwork instance or in mail archives, and ready-to-paste commands that can be used to apply the patch locally.
Starting from v2.0.0, the add-on offers a way to configure what Patchwork instances to use.
Usage
Whenever a patch is displayed, Seams displays an action button above the message. The colored badge on that button indicates the current state of the patch, as retrieved from Patchwork.
On clicking the button, a panel appears and displays:
The button is not displayed when the message is not recognized as a patch, or when the add-on fails to retrieve metadata from Patchwork.
Internals
Patch detection currently works as follows:
When a message is displayed and recognized as a patch, the add-on sends an API request to the Patchwork instance to retrieve the state of the patch as well as some metadata. On clicking the action button, this information is reused to generate the panel.
For cover letters, the add-on also retrieves some information, but elements such as the state of a patch or the results for the checks are not available (because not relevant) and hence not displayed.
If several Patchwork instances are configured, and the message matches the pattern for several of them, the first one matching (as per the order in which instances are defined in the “Preferences” tab) is considered for retrieving and printing information related to the patch. Other matching instances are ignored.
Disclaimer
This add-on is not an official add-on either developed, supported or otherwise endorsed by the community of the Patchwork project.
Seams provides some integration with Patchwork, the patch tracking system. It makes the patch state visible directly from Thunderbird. It also displays useful links to the patch or its series on a Patchwork instance or in mail archives, and ready-to-paste commands that can be used to apply the patch locally.
Starting from v2.0.0, the add-on offers a way to configure what Patchwork instances to use.
Usage
Whenever a patch is displayed, Seams displays an action button above the message. The colored badge on that button indicates the current state of the patch, as retrieved from Patchwork.
On clicking the button, a panel appears and displays:
- The name of the Patchwork project for the patch.
- The state of the patch (for example,
new,superseded,accepted). - The state of CI checks, with expandable details if any. Click to load and
expand the details. - Links to the Patchwork pages for the patch and the series to which it belongs. Clicking the links open the pages in the panel. You can right-click on the links to open them in a browser or to copy the targets.
- Links to the mail archives (for example, lore.kernel.org).
- Commands to apply the patch or its full series to a local Git repository. Click on the command to copy it to the clipboard.
The button is not displayed when the message is not recognized as a patch, or when the add-on fails to retrieve metadata from Patchwork.
Internals
Patch detection currently works as follows:
- The message must have a specific substring in one of the recipient addresses (“to” or “cc”), for example
@vger.kernel.org. - The subject of the message must begin with a
[character, this is to avoid considering replies to patches as patches. - Messages with subject matching
0+/are considered as cover letters for a patch series.
When a message is displayed and recognized as a patch, the add-on sends an API request to the Patchwork instance to retrieve the state of the patch as well as some metadata. On clicking the action button, this information is reused to generate the panel.
For cover letters, the add-on also retrieves some information, but elements such as the state of a patch or the results for the checks are not available (because not relevant) and hence not displayed.
If several Patchwork instances are configured, and the message matches the pattern for several of them, the first one matching (as per the order in which instances are defined in the “Preferences” tab) is considered for retrieving and printing information related to the patch. Other matching instances are ignored.
Disclaimer
This add-on is not an official add-on either developed, supported or otherwise endorsed by the community of the Patchwork project.
