Add diff logic to python format subcommand (#15156)

* Add diff logic to python format subcommand

* Update test

* Add in filter per format-c

* fix tests

* Update new workflow

.github/workflows/format.yaml

@@ -37,7 +37,7 @@ jobs:
       shell: 'bash {0}'
       run: |
         qmk format-c --core-only $(< ~/files.txt)
-        qmk format-python
+        qmk format-python $(< ~/files.txt)
         qmk format-text $(< ~/files.txt)
         git diff
 

.github/workflows/format_push.yaml

@@ -25,7 +25,7 @@ jobs:
       shell: 'bash {0}'
       run: |
         qmk format-c -a
-        qmk format-python
+        qmk format-python -a
         qmk format-text -a
         git diff
 

lib/python/qmk/cli/format/python.py

@@ -4,23 +4,65 @@ from subprocess import CalledProcessError, DEVNULL
 
 from milc import cli
 
+from qmk.path import normpath
+
+py_file_suffixes = ('py',)
+py_dirs = ['lib/python']
+
+
+def yapf_run(files):
+    edit = '--diff' if cli.args.dry_run else '--in-place'
+    yapf_cmd = ['yapf', '-vv', '--recursive', edit, *files]
+    try:
+        cli.run(yapf_cmd, check=True, capture_output=False, stdin=DEVNULL)
+        cli.log.info('Successfully formatted the python code.')
+
+    except CalledProcessError:
+        cli.log.error(f'Python code in {",".join(py_dirs)} incorrectly formatted!')
+        return False
+
+
+def filter_files(files):
+    """Yield only files to be formatted and skip the rest
+    """
+
+    for file in files:
+        if file and file.name.split('.')[-1] in py_file_suffixes:
+            yield file
+        else:
+            cli.log.debug('Skipping file %s', file)
+
 
 @cli.argument('-n', '--dry-run', arg_only=True, action='store_true', help="Don't actually format.")
+@cli.argument('-b', '--base-branch', default='origin/master', help='Branch to compare to diffs to.')
+@cli.argument('-a', '--all-files', arg_only=True, action='store_true', help='Format all files.')
+@cli.argument('files', nargs='*', arg_only=True, type=normpath, help='Filename(s) to format.')
 @cli.subcommand("Format python code according to QMK's style.", hidden=False if cli.config.user.developer else True)
 def format_python(cli):
     """Format python code according to QMK's style.
     """
-    edit = '--diff' if cli.args.dry_run else '--in-place'
+    # Find the list of files to format
-    yapf_cmd = ['yapf', '-vv', '--recursive', edit, 'bin/qmk', 'lib/python']
+    if cli.args.files:
-    try:
+        files = list(filter_files(cli.args.files))
-        cli.run(yapf_cmd, check=True, capture_output=False, stdin=DEVNULL)
+
-        cli.log.info('Python code in `bin/qmk` and `lib/python` is correctly formatted.')
+        if not files:
-        return True
+            cli.log.error('No Python files in filelist: %s', ', '.join(map(str, cli.args.files)))
+            exit(0)
+
+        if cli.args.all_files:
+            cli.log.warning('Filenames passed with -a, only formatting: %s', ','.join(map(str, files)))
+
+    elif cli.args.all_files:
+        files = py_dirs
 
-    except CalledProcessError:
-        if cli.args.dry_run:
-            cli.log.error('Python code in `bin/qmk` and `lib/python` incorrectly formatted!')
     else:
-            cli.log.error('Error formatting python code!')
+        git_diff_cmd = ['git', 'diff', '--name-only', cli.args.base_branch, *py_dirs]
+        git_diff = cli.run(git_diff_cmd, stdin=DEVNULL)
+        files = list(filter(None, git_diff.stdout.split('\n')))
 
+    # Sanity check
+    if not files:
+        cli.log.error('No changed files detected. Use "qmk format-python -a" to format all files')
         return False
+
+    return yapf_run(files)

lib/python/qmk/tests/test_cli_commands.py

@@ -81,9 +81,9 @@ def test_hello():
 
 
 def test_format_python():
-    result = check_subcommand('format-python', '--dry-run')
+    result = check_subcommand('format-python', '-n', '-a')
     check_returncode(result)
-    assert 'Python code in `bin/qmk` and `lib/python` is correctly formatted.' in result.stdout
+    assert 'Successfully formatted the python code.' in result.stdout
 
 
 def test_list_keyboards():