[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]>
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.