From patchwork Thu Feb 26 20:00:07 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Simon Glass X-Patchwork-Id: 1938 Return-Path: X-Original-To: u-boot-concept@u-boot.org Delivered-To: u-boot-concept@u-boot.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1772136096; bh=uYdgAQspKzzZjzbm03TABGlg369t/9AePcqkS3bgQMQ=; h=From:To:Date:In-Reply-To:References:CC:Subject:List-Id: List-Archive:List-Help:List-Owner:List-Post:List-Subscribe: List-Unsubscribe:From; b=K89PX3w5IGYDD3IgSJYEqcDBbeFZgqk/r+gF0L1E1LIc77LfssTgB6oB/UlgXx+eO yaOjdFFcuY0mOdfgSujOsQfsGvJp5x1mHNMe4EAG/f6D7Dc4v6DlmL5c2q78FaZWMl v05NtXjQmOTo5ROKKKdFTdf80C+FFV29XjFn+4B5uoBmDhRx20KfVuJWQU28fjmk9K DtB8OsyFevlECVb1cOYJfUy2RS9SIv9pDZb42Xew5C6AKY4bnO+53SiU9K9krYOSbH xYdPAcibDYpIARJYQG7OcY4WWpUhomcDyVFUaxIDe/YohC80ugedpfvxVTaYY71ywe itIFKF4yev57A== Received: from localhost (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id 35BEC69E36 for ; Thu, 26 Feb 2026 13:01:36 -0700 (MST) X-Virus-Scanned: Debian amavis at Received: from mail.u-boot.org ([127.0.0.1]) by localhost (mail.u-boot.org [127.0.0.1]) (amavis, port 10024) with ESMTP id eySuUrwpQ9PF for ; Thu, 26 Feb 2026 13:01:36 -0700 (MST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1772136096; bh=uYdgAQspKzzZjzbm03TABGlg369t/9AePcqkS3bgQMQ=; h=From:To:Date:In-Reply-To:References:CC:Subject:List-Id: List-Archive:List-Help:List-Owner:List-Post:List-Subscribe: List-Unsubscribe:From; b=K89PX3w5IGYDD3IgSJYEqcDBbeFZgqk/r+gF0L1E1LIc77LfssTgB6oB/UlgXx+eO yaOjdFFcuY0mOdfgSujOsQfsGvJp5x1mHNMe4EAG/f6D7Dc4v6DlmL5c2q78FaZWMl v05NtXjQmOTo5ROKKKdFTdf80C+FFV29XjFn+4B5uoBmDhRx20KfVuJWQU28fjmk9K DtB8OsyFevlECVb1cOYJfUy2RS9SIv9pDZb42Xew5C6AKY4bnO+53SiU9K9krYOSbH xYdPAcibDYpIARJYQG7OcY4WWpUhomcDyVFUaxIDe/YohC80ugedpfvxVTaYY71ywe itIFKF4yev57A== Received: from mail.u-boot.org (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id 231B569DAB for ; Thu, 26 Feb 2026 13:01:36 -0700 (MST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1772136094; bh=7Xr60iw7cP0MSdZp/xIEUAcqBk6m4ZPTbkLAH3E044U=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=WUnCHws2sPrwPZBwe6DSMwsmCNpLv2+iASaGdeq9heZwD9l9ptuL8puFEORHB6LlU ZRQ+6hBtKdODotTRQvHmFDthd2QUzLrKA2ABGB0hNNd6avah0ncKsEToCYrm2B0mc5 ZjtYr4iISJd+jMFMvuPgbTfdkTxg+QwJwy6Zemp3rrZWBLo8OLGk23FZrUzA54t44P u8jo7EOzu4llMgS6qsxyLzTSpG58pvnN4mFFmAq2ogAl2xqbPMNGdaVAL+DZ3xQbps R4WDhN5Of+IoyFlpMF8wo9itXXyxM8WQVDkOlNwC3NP96weaRdFHmc6LcPMtLXWJJP TrMY2dHqdhx6A== Received: from localhost (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id 0475269D4A; Thu, 26 Feb 2026 13:01:34 -0700 (MST) X-Virus-Scanned: Debian amavis at Received: from mail.u-boot.org ([127.0.0.1]) by localhost (mail.u-boot.org [127.0.0.1]) (amavis, port 10026) with ESMTP id yJ8fNp1PxqbP; Thu, 26 Feb 2026 13:01:33 -0700 (MST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1772136090; bh=7gqVi5XSHF1p5fGZWjS+KRdOSvk+EOPtRFVwGaDLIhs=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=RRyUuKfAk+r+Z+cHVnMnXwpxEh262EsWHAJezPgeSYI1uVEhIsAOfLETO2TIt3iSe j1cq+vnJCswZ2Q8hu4i8tz5/WeNslVHJGbzexx9u/1bbp7ofmCiomwjDgHmd7q3bs3 VqmpY9Sd9RtE9q4YjpNuC/OrozHN7ebmoZccKKEXJIesU0C51C6GktgjBnpFux1XOE iUj4lYKvhUstUFL5oH6j9NdNvMdbUkS8+S050lmTToXztdePxn7YGDgMzTA7YUXu6S WV9XewNJPuInseMPi9gBqfDyXSE2ivnw5VSU0QwMKVZw3L6FPpW8rGzr++hsPLH9Kf vcs8jagnV0hHw== Received: from u-boot.org (unknown [73.34.74.121]) by mail.u-boot.org (Postfix) with ESMTPSA id DF97469D79; Thu, 26 Feb 2026 13:01:29 -0700 (MST) From: Simon Glass To: U-Boot Concept Date: Thu, 26 Feb 2026 13:00:07 -0700 Message-ID: <20260226200106.1727176-2-sjg@u-boot.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20260226200106.1727176-1-sjg@u-boot.org> References: <20260226200106.1727176-1-sjg@u-boot.org> MIME-Version: 1.0 Message-ID-Hash: TCVHIIF2MPCJEKQWVPGMWY5WGYKSS3HT X-Message-ID-Hash: TCVHIIF2MPCJEKQWVPGMWY5WGYKSS3HT X-MailFrom: sjg@u-boot.org X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; loop; banned-address; emergency; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header CC: Simon Glass X-Mailman-Version: 3.3.10 Precedence: list Subject: [Concept] [PATCH 01/32] patman: Expand the prep_series() comment List-Id: Discussion and patches related to U-Boot Concept Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: From: Simon Glass The comment for prep_series() is quite terse. Expand it to describe what the function actually does. Signed-off-by: Simon Glass --- tools/patman/cser_helper.py | 9 +++++++-- tools/patman/database.py | 2 +- 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/tools/patman/cser_helper.py b/tools/patman/cser_helper.py index ea9881fcf6f..4289593b64b 100644 --- a/tools/patman/cser_helper.py +++ b/tools/patman/cser_helper.py @@ -255,11 +255,16 @@ class CseriesHelper: def prep_series(self, name, end=None): """Prepare to work with a series + Parse the branch name to determine the series name and version + number, then count the commits from the upstream branch (or up to the + end commit if provided) and collect the series metadata from those + commits. + Args: name (str): Branch name with version appended, e.g. 'fix2' end (str or None): Commit to end at, e.g. 'my_branch~16'. Only - commits up to that are processed. None to process commits up to - the upstream branch + commits up to that are processed. Use None to process commits up + to the upstream branch Return: tuple: str: Series name, e.g. 'fix' diff --git a/tools/patman/database.py b/tools/patman/database.py index 9c25b04a720..e6684f990da 100644 --- a/tools/patman/database.py +++ b/tools/patman/database.py @@ -41,7 +41,7 @@ Pcommit = namedtuple( 'idnum,seq,subject,svid,change_id,state,patch_id,num_comments') -class Database: +class Database: # pylint:disable=R0904 """Database of information used by patman""" # dict of databases: