[PATCH RFC v3] add basic support for b4 contribution workflow
Quentin Schulz <[email protected]>
| Newsgroups | org.yoctoproject.lists.poky |
|---|---|
| Message-ID | <[email protected]> |
From: Quentin Schulz <[email protected]> b4[1] is a very nice tool for mail-based contribution. A config[2] file exists to set up a few defaults. We can use it to provide the Cc and To recipient list for the series. This uses the b4-wrapper-poky.py script for checking that each patch in the series is only for one project. Indeed, poky is actually a "collection" of multiple repositories, namely BitBake, OpenEmbedded-Core and the Yocto Docs. One patch should therefore not make changes in multiple of those projects otherwise it cannot be merged. Additionally, a check is added to make sure that a series only touches files from one project to avoid having to figure out which patch is to be merged by which maintainer in which project repo. Moreover, it is not uncommon to have people develop patches for those projects from within poky. This wrapper figures out which mailing lists to send patches to based on the files that are modified in the series. Considering that patches to the bitbake/doc/ directory need to be sent to both the bitbake and yocto-docs mailing list (To recipient for the former, Cc recipient for the latter) this wrapper handles that. A limitation of the script (lsdiff actually) is that it doesn't know how to handle empty files, but those should be of rather rare occurrences. Note that this script requires hardcoding of paths that are handled by different projects to map files to projects. Anything not mapped is assumed part of OE-Core. [1] https://pypi.org/project/b4/ [2] https://b4.docs.kernel.org/en/latest/config.html Signed-off-by: Quentin Schulz <[email protected]> --- This is marked as RFC for two reasons: - this depends on the following patch series for OE-Core: https://lore.kernel.org/openembedded-core/[email protected]/T/#ma4eac2488b318119393ae76e71a7d597253dd874 - this depends on the script used to merge OE-Core into poky to NOT overwrite .b4-config from poky added in this patch series with the one from OE-Core, Note that b4 will not work for modifications made to .b4-config for poky as it'll detect that as being for OE-Core. Since the file will eventually exist in both repos, I have no clue how to handle that. --- Changes in v3: - call the b4 wrapper script also for both Cc and To recipient lists, to handle the special case of yocto-docs in Cc for bitbake/doc patches, and also because we're supposed to use To recipient list for all other mailing lists, - Link to v2: https://lore.kernel.org/r/[email protected] Changes in v2: - moved script to OE-Core repo (in another patch series now) - updated path to reflect new location in OE-Core (scripts/) and name (b4-wrapper-poky.py instead of b4-wrapper.py), - Link to v1: https://lore.kernel.org/r/[email protected] --- .b4-config | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/.b4-config b/.b4-config new file mode 100644 index 0000000000000000000000000000000000000000..683b816ffaa92163c6bb9da6368889dc20d0d1f3 --- /dev/null +++ b/.b4-config @@ -0,0 +1,4 @@ +[b4] + prep-perpatch-check-cmd = ./scripts/b4-wrapper-poky.py prep-perpatch-check-cmd + send-auto-cc-cmd = ./scripts/b4-wrapper-poky.py send-auto-cc-cmd + send-auto-to-cmd = ./scripts/b4-wrapper-poky.py send-auto-to-cmd --- base-commit: 1d777d0fe4d0517a3b31207da7f92c3b72e388ee change-id: 20250117-b4-support-e4cca7ad3106 Best regards, -- Quentin Schulz <[email protected]>