patch-manager 0.0.6__tar.gz → 0.0.8__tar.gz

patch_manager-0.0.8/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: patch-manager
+Version: 0.0.8
+Summary: Create, check and email patch series, with Patchwork integration
+Author-email: Simon Glass <sjg@chromium.org>
+License-Expression: GPL-2.0-or-later
+Project-URL: Homepage, https://github.com/nxtboot/patman
+Project-URL: Documentation, https://patman.readthedocs.io/
+Project-URL: Repository, https://github.com/nxtboot/patman
+Project-URL: Bug Tracker, https://github.com/nxtboot/patman/issues
+Keywords: patch,email,git,patchwork,u-boot,review
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.9
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Requires-Dist: pygit2>=1.14
+Requires-Dist: aiohttp>=3.9
+Provides-Extra: gmail
+Requires-Dist: google-api-python-client; extra == "gmail"
+Requires-Dist: google-auth-httplib2; extra == "gmail"
+Requires-Dist: google-auth-oauthlib; extra == "gmail"
+Provides-Extra: review
+Requires-Dist: claude-agent-sdk; extra == "review"
+Provides-Extra: test
+Requires-Dist: concurrencytest; extra == "test"
+Provides-Extra: all
+Requires-Dist: google-api-python-client; extra == "all"
+Requires-Dist: google-auth-httplib2; extra == "all"
+Requires-Dist: google-auth-oauthlib; extra == "all"
+Requires-Dist: claude-agent-sdk; extra == "all"
+Requires-Dist: concurrencytest; extra == "all"
+Dynamic: license-file
+
+Patman patch manager
+====================
+
+.. image:: https://github.com/nxtboot/patman/actions/workflows/test.yml/badge.svg
+   :target: https://github.com/nxtboot/patman/actions/workflows/test.yml
+   :alt: Test status
+
+.. image:: https://img.shields.io/pypi/v/patch-manager.svg
+   :target: https://pypi.org/project/patch-manager/
+   :alt: PyPI version
+
+.. image:: https://readthedocs.org/projects/patman/badge/?version=latest
+   :target: https://patman.readthedocs.io/en/latest/
+   :alt: Documentation status
+
+.. image:: https://img.shields.io/pypi/pyversions/patch-manager.svg
+   :target: https://pypi.org/project/patch-manager/
+   :alt: Supported Python versions
+
+Patman is a command-line tool that automates the boring parts of preparing
+and sending patches by email, in the style used by the U-Boot and Linux
+kernel projects. It:
+
+- creates patches directly from a git branch;
+- cleans them up by removing unwanted tags and inserting a cover letter;
+- runs checkpatch.pl and the project's checks before anything is sent;
+- looks up the maintainers to Cc, and emails the series out;
+- tracks series in a local database and integrates with Patchwork to gather
+  review tags and follow up on comments.
+
+Installation
+------------
+
+Install the latest release from PyPI::
+
+    pip install patch-manager
+
+Optional features are available as extras::
+
+    pip install patch-manager[gmail]    # send/fetch review mail via Gmail
+    pip install patch-manager[review]   # AI-assisted patch review
+    pip install patch-manager[all]      # everything
+
+The ``patman`` command is then on your path.
+
+Quick start
+-----------
+
+From a git branch containing the commits you want to send::
+
+    patman              # create, check and email the series
+    patman -n           # dry run: create and check, but do not send
+
+See ``patman --full-help`` for the complete manual, or the documentation
+linked below.
+
+Documentation
+-------------
+
+Full documentation is hosted on Read the Docs:
+
+    https://patman.readthedocs.io/
+
+Development
+-----------
+
+Run the test suite from a checkout::
+
+    pip install -r requirements.txt
+    pip install -e .
+    patman test
+
+The suite is self-contained: a pinned ``checkpatch.pl`` and its helper files
+live in ``scripts/``, and the bundled ``u_boot_pylib`` package is vendored in
+the tree, so no surrounding U-Boot source is required.
+
+License
+-------
+
+GPL-2.0-or-later. See the ``LICENSE`` file for the full text.

patch_manager-0.0.8/README.rst

@@ -0,0 +1,80 @@
+Patman patch manager
+====================
+
+.. image:: https://github.com/nxtboot/patman/actions/workflows/test.yml/badge.svg
+   :target: https://github.com/nxtboot/patman/actions/workflows/test.yml
+   :alt: Test status
+
+.. image:: https://img.shields.io/pypi/v/patch-manager.svg
+   :target: https://pypi.org/project/patch-manager/
+   :alt: PyPI version
+
+.. image:: https://readthedocs.org/projects/patman/badge/?version=latest
+   :target: https://patman.readthedocs.io/en/latest/
+   :alt: Documentation status
+
+.. image:: https://img.shields.io/pypi/pyversions/patch-manager.svg
+   :target: https://pypi.org/project/patch-manager/
+   :alt: Supported Python versions
+
+Patman is a command-line tool that automates the boring parts of preparing
+and sending patches by email, in the style used by the U-Boot and Linux
+kernel projects. It:
+
+- creates patches directly from a git branch;
+- cleans them up by removing unwanted tags and inserting a cover letter;
+- runs checkpatch.pl and the project's checks before anything is sent;
+- looks up the maintainers to Cc, and emails the series out;
+- tracks series in a local database and integrates with Patchwork to gather
+  review tags and follow up on comments.
+
+Installation
+------------
+
+Install the latest release from PyPI::
+
+    pip install patch-manager
+
+Optional features are available as extras::
+
+    pip install patch-manager[gmail]    # send/fetch review mail via Gmail
+    pip install patch-manager[review]   # AI-assisted patch review
+    pip install patch-manager[all]      # everything
+
+The ``patman`` command is then on your path.
+
+Quick start
+-----------
+
+From a git branch containing the commits you want to send::
+
+    patman              # create, check and email the series
+    patman -n           # dry run: create and check, but do not send
+
+See ``patman --full-help`` for the complete manual, or the documentation
+linked below.
+
+Documentation
+-------------
+
+Full documentation is hosted on Read the Docs:
+
+    https://patman.readthedocs.io/
+
+Development
+-----------
+
+Run the test suite from a checkout::
+
+    pip install -r requirements.txt
+    pip install -e .
+    patman test
+
+The suite is self-contained: a pinned ``checkpatch.pl`` and its helper files
+live in ``scripts/``, and the bundled ``u_boot_pylib`` package is vendored in
+the tree, so no surrounding U-Boot source is required.
+
+License
+-------
+
+GPL-2.0-or-later. See the ``LICENSE`` file for the full text.

patch_manager-0.0.8/patch_manager.egg-info/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: patch-manager
+Version: 0.0.8
+Summary: Create, check and email patch series, with Patchwork integration
+Author-email: Simon Glass <sjg@chromium.org>
+License-Expression: GPL-2.0-or-later
+Project-URL: Homepage, https://github.com/nxtboot/patman
+Project-URL: Documentation, https://patman.readthedocs.io/
+Project-URL: Repository, https://github.com/nxtboot/patman
+Project-URL: Bug Tracker, https://github.com/nxtboot/patman/issues
+Keywords: patch,email,git,patchwork,u-boot,review
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.9
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Requires-Dist: pygit2>=1.14
+Requires-Dist: aiohttp>=3.9
+Provides-Extra: gmail
+Requires-Dist: google-api-python-client; extra == "gmail"
+Requires-Dist: google-auth-httplib2; extra == "gmail"
+Requires-Dist: google-auth-oauthlib; extra == "gmail"
+Provides-Extra: review
+Requires-Dist: claude-agent-sdk; extra == "review"
+Provides-Extra: test
+Requires-Dist: concurrencytest; extra == "test"
+Provides-Extra: all
+Requires-Dist: google-api-python-client; extra == "all"
+Requires-Dist: google-auth-httplib2; extra == "all"
+Requires-Dist: google-auth-oauthlib; extra == "all"
+Requires-Dist: claude-agent-sdk; extra == "all"
+Requires-Dist: concurrencytest; extra == "all"
+Dynamic: license-file
+
+Patman patch manager
+====================
+
+.. image:: https://github.com/nxtboot/patman/actions/workflows/test.yml/badge.svg
+   :target: https://github.com/nxtboot/patman/actions/workflows/test.yml
+   :alt: Test status
+
+.. image:: https://img.shields.io/pypi/v/patch-manager.svg
+   :target: https://pypi.org/project/patch-manager/
+   :alt: PyPI version
+
+.. image:: https://readthedocs.org/projects/patman/badge/?version=latest
+   :target: https://patman.readthedocs.io/en/latest/
+   :alt: Documentation status
+
+.. image:: https://img.shields.io/pypi/pyversions/patch-manager.svg
+   :target: https://pypi.org/project/patch-manager/
+   :alt: Supported Python versions
+
+Patman is a command-line tool that automates the boring parts of preparing
+and sending patches by email, in the style used by the U-Boot and Linux
+kernel projects. It:
+
+- creates patches directly from a git branch;
+- cleans them up by removing unwanted tags and inserting a cover letter;
+- runs checkpatch.pl and the project's checks before anything is sent;
+- looks up the maintainers to Cc, and emails the series out;
+- tracks series in a local database and integrates with Patchwork to gather
+  review tags and follow up on comments.
+
+Installation
+------------
+
+Install the latest release from PyPI::
+
+    pip install patch-manager
+
+Optional features are available as extras::
+
+    pip install patch-manager[gmail]    # send/fetch review mail via Gmail
+    pip install patch-manager[review]   # AI-assisted patch review
+    pip install patch-manager[all]      # everything
+
+The ``patman`` command is then on your path.
+
+Quick start
+-----------
+
+From a git branch containing the commits you want to send::
+
+    patman              # create, check and email the series
+    patman -n           # dry run: create and check, but do not send
+
+See ``patman --full-help`` for the complete manual, or the documentation
+linked below.
+
+Documentation
+-------------
+
+Full documentation is hosted on Read the Docs:
+
+    https://patman.readthedocs.io/
+
+Development
+-----------
+
+Run the test suite from a checkout::
+
+    pip install -r requirements.txt
+    pip install -e .
+    patman test
+
+The suite is self-contained: a pinned ``checkpatch.pl`` and its helper files
+live in ``scripts/``, and the bundled ``u_boot_pylib`` package is vendored in
+the tree, so no surrounding U-Boot source is required.
+
+License
+-------
+
+GPL-2.0-or-later. See the ``LICENSE`` file for the full text.

patch_manager-0.0.8/patch_manager.egg-info/SOURCES.txt

@@ -0,0 +1,54 @@
+LICENSE
+README.rst
+pyproject.toml
+patch_manager.egg-info/PKG-INFO
+patch_manager.egg-info/SOURCES.txt
+patch_manager.egg-info/dependency_links.txt
+patch_manager.egg-info/entry_points.txt
+patch_manager.egg-info/requires.txt
+patch_manager.egg-info/top_level.txt
+patman/__init__.py
+patman/__main__.py
+patman/checkpatch.py
+patman/cmdline.py
+patman/commit.py
+patman/control.py
+patman/cser_helper.py
+patman/cseries.py
+patman/database.py
+patman/func_test.py
+patman/get_maintainer.py
+patman/gmail.py
+patman/patchstream.py
+patman/patchwork.py
+patman/patman.rst
+patman/project.py
+patman/review.py
+patman/send.py
+patman/series.py
+patman/settings.py
+patman/status.py
+patman/test_checkpatch.py
+patman/test_common.py
+patman/test_cseries.py
+patman/test_settings.py
+patman/workflow.py
+patman/test/0000-cover-letter.patch
+patman/test/0001-pci-Correct-cast-for-sandbox.patch
+patman/test/0002-fdt-Correct-cast-for-sandbox-in-fdtdec_setup_mem_siz.patch
+patman/test/get_maintainer
+patman/test/maintainers
+patman/test/test01.txt
+u_boot_pylib/__init__.py
+u_boot_pylib/__main__.py
+u_boot_pylib/claude.py
+u_boot_pylib/command.py
+u_boot_pylib/cros_subprocess.py
+u_boot_pylib/gitutil.py
+u_boot_pylib/terminal.py
+u_boot_pylib/test_claude.py
+u_boot_pylib/test_command.py
+u_boot_pylib/test_gitutil.py
+u_boot_pylib/test_util.py
+u_boot_pylib/tools.py
+u_boot_pylib/tout.py

patch_manager-0.0.8/patch_manager.egg-info/requires.txt

@@ -0,0 +1,20 @@
+pygit2>=1.14
+aiohttp>=3.9
+
+[all]
+google-api-python-client
+google-auth-httplib2
+google-auth-oauthlib
+claude-agent-sdk
+concurrencytest
+
+[gmail]
+google-api-python-client
+google-auth-httplib2
+google-auth-oauthlib
+
+[review]
+claude-agent-sdk
+
+[test]
+concurrencytest

patch_manager-0.0.8/patch_manager.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+patman
+u_boot_pylib

patch_manager-0.0.8/patman/__init__.py

@@ -0,0 +1,8 @@
+# SPDX-License-Identifier: GPL-2.0+
+
+__all__ = [
+    'checkpatch', 'cmdline', 'commit', 'control', 'cser_helper', 'cseries',
+    'database', 'func_test', 'get_maintainer', '__main__', 'patchstream',
+    'patchwork', 'project', 'send', 'series', 'settings', 'status',
+    'test_checkpatch', 'test_common', 'test_cseries', 'test_settings'
+]

patch_manager-0.0.8/patman/__main__.py

@@ -0,0 +1,61 @@
+#!/usr/bin/env python3
+# SPDX-License-Identifier: GPL-2.0+
+#
+# Copyright (c) 2011 The Chromium OS Authors.
+#
+
+"""See README for more information"""
+
+import os
+import sys
+
+# Allow 'from patman import xxx to work'
+# pylint: disable=C0413
+our_path = os.path.dirname(os.path.realpath(__file__))
+sys.path.append(os.path.join(our_path, '..'))
+
+# Our modules
+from u_boot_pylib import test_util
+from u_boot_pylib import tout
+from patman import cmdline
+from patman import control
+
+
+def run_patman():
+    """Run patamn
+
+    This is the main program. It collects arguments and runs either the tests or
+    the control module.
+    """
+    args = cmdline.parse_args()
+
+    if not args.debug:
+        sys.tracebacklimit = 0
+
+    tout.init(tout.INFO if args.verbose else tout.NOTICE)
+
+    # Run our reasonably good tests
+    if args.cmd == 'test':
+        # pylint: disable=C0415
+        from patman import func_test
+        from patman import test_checkpatch
+        from patman import test_cseries
+        from u_boot_pylib import test_command
+
+        to_run = args.testname if args.testname not in [None, 'test'] else None
+        result = test_util.run_test_suites(
+            'patman', False, args.verbose, args.no_capture,
+            args.test_preserve_dirs, None, to_run, None,
+            [test_checkpatch.TestPatch, func_test.TestFunctional,
+             'patman.settings', test_cseries.TestCseries,
+             test_command.TestRunInteractive])
+        sys.exit(0 if result.wasSuccessful() else 1)
+
+    # Process commits, produce patches files, check them, email them
+    else:
+        exit_code = control.do_patman(args)
+        sys.exit(exit_code)
+
+
+if __name__ == "__main__":
+    sys.exit(run_patman())

{patch-manager-0.0.6/src → patch_manager-0.0.8}/patman/checkpatch.py

@@ -8,8 +8,8 @@ import os
 import re
 import sys
 
-from patman import gitutil
 from u_boot_pylib import command
+from u_boot_pylib import gitutil
 from u_boot_pylib import terminal
 
 EMACS_PREFIX = r'(?:[0-9]{4}.*\.patch:[0-9]+: )?'
@@ -22,7 +22,7 @@ RE_NOTE = re.compile(r'NOTE: (.*)')
 
 
 def find_check_patch():
-    top_level = gitutil.get_top_level()
+    top_level = gitutil.get_top_level() or ''
     try_list = [
         os.getcwd(),
         os.path.join(os.getcwd(), '..', '..'),
@@ -92,8 +92,10 @@ def check_patch_parse_one_message(message):
     file_match = RE_FILE.search(message)
     # some messages have no file, catch those here
     no_file_match = any(s in message for s in [
-        '\nSubject:', 'Missing Signed-off-by: line(s)',
-        'does MAINTAINERS need updating'
+        '\nSubject:', 'Missing Signed-off-by:',
+        'does MAINTAINERS need updating',
+        'email address mismatch',
+        'should have a',
     ])
 
     if file_match:
@@ -157,9 +159,24 @@ def check_patch_parse(checkpatch_output, verbose=False):
                                r' checks, (\d+)')
     re_ok = re.compile(r'.*has no obvious style problems')
     re_bad = re.compile(r'.*has style problems, please review')
-
-    # A blank line indicates the end of a message
-    for message in result.stdout.split('\n\n'):
+    # Patterns that start a new message block
+    re_message_start = re.compile(
+        r'^(ERROR|WARNING|CHECK):|^total:|^NOTE:|.* has (no obvious )?style')
+
+    # Split output into individual messages by looking for message-starting
+    # patterns at the start of lines, since messages may not be separated by
+    # blank lines
+    messages = []
+    current = []
+    for line in result.stdout.splitlines():
+        if re_message_start.match(line) and current:
+            messages.append('\n'.join(current))
+            current = []
+        current.append(line)
+    if current:
+        messages.append('\n'.join(current))
+
+    for message in messages:
         if verbose:
             print(message)
 
@@ -187,7 +204,8 @@ def check_patch_parse(checkpatch_output, verbose=False):
     return result
 
 
-def check_patch(fname, verbose=False, show_types=False, use_tree=False):
+def check_patch(fname, verbose=False, show_types=False, use_tree=False,
+                cwd=None):
     """Run checkpatch.pl on a file and parse the results.
 
     Args:
@@ -196,6 +214,7 @@ def check_patch(fname, verbose=False, show_types=False, use_tree=False):
             parsed
         show_types: Tell checkpatch to show the type (number) of each message
         use_tree (bool): If False we'll pass '--no-tree' to checkpatch.
+        cwd (str): Path to use for patch files (None to use current dir)
 
     Returns:
         namedtuple containing:
@@ -217,7 +236,9 @@ def check_patch(fname, verbose=False, show_types=False, use_tree=False):
         args.append('--no-tree')
     if show_types:
         args.append('--show-types')
-    output = command.output(*args, fname, raise_on_error=False)
+    output = command.output(
+        *args, os.path.join(cwd or '', fname), raise_on_error=False,
+        capture_stderr=not use_tree)
 
     return check_patch_parse(output, verbose)
 
@@ -240,7 +261,7 @@ def get_warning_msg(col, msg_type, fname, line, msg):
     line_str = '' if line is None else '%d' % line
     return '%s:%s: %s: %s\n' % (fname, line_str, msg_type, msg)
 
-def check_patches(verbose, args, use_tree):
+def check_patches(verbose, args, use_tree, cwd):
     '''Run the checkpatch.pl script on each patch'''
     error_count, warning_count, check_count = 0, 0, 0
     col = terminal.Color()
@@ -248,7 +269,8 @@ def check_patches(verbose, args, use_tree):
     with concurrent.futures.ThreadPoolExecutor(max_workers=16) as executor:
         futures = []
         for fname in args:
-            f = executor.submit(check_patch, fname, verbose, use_tree=use_tree)
+            f = executor.submit(check_patch, fname, verbose, use_tree=use_tree,
+                                cwd=cwd)
             futures.append(f)
 
         for fname, f in zip(args, futures):