conventional-pre-commit 3.1.0__tar.gz → 3.3.0__tar.gz

{conventional_pre_commit-3.1.0 → conventional_pre_commit-3.3.0}/.github/workflows/release.yml

@@ -38,7 +38,7 @@ jobs:
 
       - name: Release
         id: release
-        uses: softprops/action-gh-release@v1
+        uses: softprops/action-gh-release@v2
         with:
           files: |
             ./dist/*.whl

{conventional_pre_commit-3.1.0 → conventional_pre_commit-3.3.0}/.pre-commit-config.yaml

@@ -8,7 +8,7 @@ default_install_hook_types:
 
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.5.0
+    rev: v4.6.0
     hooks:
       - id: trailing-whitespace
       - id: mixed-line-ending
@@ -18,21 +18,21 @@ repos:
       - id: check-added-large-files
 
   - repo: https://github.com/psf/black
-    rev: 23.12.1
+    rev: 24.4.2
     hooks:
       - id: black
         types:
           - python
 
   - repo: https://github.com/PyCQA/flake8
-    rev: 7.0.0
+    rev: 7.1.0
     hooks:
       - id: flake8
         types:
           - python
 
   - repo: https://github.com/pycqa/bandit
-    rev: 1.7.6
+    rev: 1.7.9
     hooks:
       - id: bandit
         args: ["-ll"]

{conventional_pre_commit-3.1.0 → conventional_pre_commit-3.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: conventional_pre_commit
-Version: 3.1.0
+Version: 3.3.0
 Summary: A pre-commit hook that checks commit messages for Conventional Commits formatting.
 Author-email: Compiler LLC <dev@compiler.la>
 License:                                  Apache License
@@ -352,18 +352,19 @@ print(is_conventional("custom: this is a conventional commit", types=["custom"])
 
 ```shell
 $ conventional-pre-commit -h
-usage: conventional-pre-commit [-h] [--force-scope] [--strict] [types ...] input
+usage: conventional-pre-commit [-h] [--force-scope] [--scopes SCOPES] [--strict] [types ...] input
 
 Check a git commit message for Conventional Commits formatting.
 
 positional arguments:
-  types          Optional list of types to support
-  input          A file containing a git commit message
+  types            Optional list of types to support
+  input            A file containing a git commit message
 
 options:
-  -h, --help     show this help message and exit
-  --force-scope  Force commit to have scope defined.
-  --strict       Force commit to strictly follow Conventional Commits formatting. Disallows fixup! style commits.
+  -h, --help       show this help message and exit
+  --force-scope    Force commit to have scope defined.
+  --scopes SCOPES  Optional list of scopes to support. Scopes should be separated by commas with no spaces (e.g. api,client)
+  --strict         Force commit to strictly follow Conventional Commits formatting. Disallows fixup! style commits.
 ```
 
 Supply arguments on the command-line, or via the pre-commit `hooks.args` property:

{conventional_pre_commit-3.1.0 → conventional_pre_commit-3.3.0}/README.md

@@ -129,18 +129,19 @@ print(is_conventional("custom: this is a conventional commit", types=["custom"])
 
 ```shell
 $ conventional-pre-commit -h
-usage: conventional-pre-commit [-h] [--force-scope] [--strict] [types ...] input
+usage: conventional-pre-commit [-h] [--force-scope] [--scopes SCOPES] [--strict] [types ...] input
 
 Check a git commit message for Conventional Commits formatting.
 
 positional arguments:
-  types          Optional list of types to support
-  input          A file containing a git commit message
+  types            Optional list of types to support
+  input            A file containing a git commit message
 
 options:
-  -h, --help     show this help message and exit
-  --force-scope  Force commit to have scope defined.
-  --strict       Force commit to strictly follow Conventional Commits formatting. Disallows fixup! style commits.
+  -h, --help       show this help message and exit
+  --force-scope    Force commit to have scope defined.
+  --scopes SCOPES  Optional list of scopes to support. Scopes should be separated by commas with no spaces (e.g. api,client)
+  --strict         Force commit to strictly follow Conventional Commits formatting. Disallows fixup! style commits.
 ```
 
 Supply arguments on the command-line, or via the pre-commit `hooks.args` property:

{conventional_pre_commit-3.1.0 → conventional_pre_commit-3.3.0}/conventional_pre_commit/format.py

@@ -1,4 +1,5 @@
 import re
+from typing import List, Optional
 
 CONVENTIONAL_TYPES = ["feat", "fix"]
 DEFAULT_TYPES = [
@@ -26,8 +27,20 @@ def r_types(types):
     return "|".join(types)
 
 
-def r_scope(optional=True):
+def _get_scope_pattern(scopes: Optional[List[str]] = None):
+    scopes_str = r_types(scopes)
+    escaped_delimiters = list(map(re.escape, [":", ",", "-", "/"]))  # type: ignore
+    delimiters_pattern = r_types(escaped_delimiters)
+    return rf"\(\s*(?:{scopes_str})(?:\s*(?:{delimiters_pattern})\s*(?:{scopes_str}))*\s*\)"
+
+
+def r_scope(optional=True, scopes: Optional[List[str]] = None):
     """Regex str for an optional (scope)."""
+
+    if scopes:
+        scopes_pattern = _get_scope_pattern(scopes)
+        return scopes_pattern
+
     if optional:
         return r"(\([\w \/:,-]+\))?"
     else:
@@ -54,6 +67,15 @@ def r_autosquash_prefixes():
     return "|".join(AUTOSQUASH_PREFIXES)
 
 
+def r_verbose_diff():
+    """Regex str for verbose diff"""
+    return r"(?P<diff>(^# -* >8 -*$\r?\n)(^# .*$\r?\n)+(diff ){1}(.*\r?\n)*)"
+
+
+def strip_verbose_diff(input):
+    return re.sub(r_verbose_diff(), "", input, flags=re.MULTILINE)
+
+
 def r_comment():
     """Regex str for comment"""
     return r"^#.*\r?\n?"
@@ -70,16 +92,17 @@ def conventional_types(types=[]):
     return types
 
 
-def is_conventional(input, types=DEFAULT_TYPES, optional_scope=True):
+def is_conventional(input, types=DEFAULT_TYPES, optional_scope=True, scopes: Optional[List[str]] = None):
     """
     Returns True if input matches Conventional Commits formatting
     https://www.conventionalcommits.org
 
     Optionally provide a list of additional custom types.
     """
+    input = strip_verbose_diff(input)
     input = strip_comments(input)
     types = conventional_types(types)
-    pattern = f"^({r_types(types)}){r_scope(optional_scope)}{r_delim()}{r_subject()}{r_body()}"
+    pattern = f"^({r_types(types)}){r_scope(optional_scope, scopes=scopes)}{r_delim()}{r_subject()}{r_body()}"
     regex = re.compile(pattern, re.MULTILINE)
 
     result = regex.match(input)

{conventional_pre_commit-3.1.0 → conventional_pre_commit-3.3.0}/conventional_pre_commit/hook.py

@@ -23,6 +23,12 @@ def main(argv=[]):
     parser.add_argument(
         "--force-scope", action="store_false", default=True, dest="optional_scope", help="Force commit to have scope defined."
     )
+    parser.add_argument(
+        "--scopes",
+        type=str,
+        default=None,
+        help="Optional list of scopes to support. Scopes should be separated by commas with no spaces (e.g. api,client)",
+    )
     parser.add_argument(
         "--strict",
         action="store_true",
@@ -51,12 +57,16 @@ See {Colors.LBLUE}https://git-scm.com/docs/git-commit/#_discussion{Colors.RESTOR
         """
         )
         return RESULT_FAIL
+    if args.scopes:
+        scopes = args.scopes.split(",")
+    else:
+        scopes = args.scopes
 
     if not args.strict:
         if format.has_autosquash_prefix(message):
             return RESULT_SUCCESS
 
-    if format.is_conventional(message, args.types, args.optional_scope):
+    if format.is_conventional(message, args.types, args.optional_scope, scopes):
         return RESULT_SUCCESS
     else:
         print(

{conventional_pre_commit-3.1.0 → conventional_pre_commit-3.3.0}/conventional_pre_commit.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: conventional_pre_commit
-Version: 3.1.0
+Version: 3.3.0
 Summary: A pre-commit hook that checks commit messages for Conventional Commits formatting.
 Author-email: Compiler LLC <dev@compiler.la>
 License:                                  Apache License
@@ -352,18 +352,19 @@ print(is_conventional("custom: this is a conventional commit", types=["custom"])
 
 ```shell
 $ conventional-pre-commit -h
-usage: conventional-pre-commit [-h] [--force-scope] [--strict] [types ...] input
+usage: conventional-pre-commit [-h] [--force-scope] [--scopes SCOPES] [--strict] [types ...] input
 
 Check a git commit message for Conventional Commits formatting.
 
 positional arguments:
-  types          Optional list of types to support
-  input          A file containing a git commit message
+  types            Optional list of types to support
+  input            A file containing a git commit message
 
 options:
-  -h, --help     show this help message and exit
-  --force-scope  Force commit to have scope defined.
-  --strict       Force commit to strictly follow Conventional Commits formatting. Disallows fixup! style commits.
+  -h, --help       show this help message and exit
+  --force-scope    Force commit to have scope defined.
+  --scopes SCOPES  Optional list of scopes to support. Scopes should be separated by commas with no spaces (e.g. api,client)
+  --strict         Force commit to strictly follow Conventional Commits formatting. Disallows fixup! style commits.
 ```
 
 Supply arguments on the command-line, or via the pre-commit `hooks.args` property:

{conventional_pre_commit-3.1.0 → conventional_pre_commit-3.3.0}/conventional_pre_commit.egg-info/SOURCES.txt

@@ -33,6 +33,7 @@ tests/messages/conventional_commit_bad_multi_line
 tests/messages/conventional_commit_gbk
 tests/messages/conventional_commit_multi_line
 tests/messages/conventional_commit_utf-8
+tests/messages/conventional_commit_with_multiple_scopes
 tests/messages/conventional_commit_with_scope
 tests/messages/custom_commit
 tests/messages/fixup_commit

{conventional_pre_commit-3.1.0 → conventional_pre_commit-3.3.0}/tests/conftest.py

@@ -52,3 +52,8 @@ def conventional_commit_bad_multi_line_path():
 @pytest.fixture
 def conventional_commit_multi_line_path():
     return get_message_path("conventional_commit_multi_line")
+
+
+@pytest.fixture
+def conventional_commit_with_multiple_scopes_path():
+    return get_message_path("conventional_commit_with_multiple_scopes")

conventional_pre_commit-3.3.0/tests/messages/conventional_commit_with_multiple_scopes

@@ -0,0 +1 @@
+feat(api,client): added new endpoint with client support

{conventional_pre_commit-3.1.0 → conventional_pre_commit-3.3.0}/tests/test_format.py

@@ -64,6 +64,20 @@ def test_r_scope__special_chars():
     assert regex.match("(some,thing)")
 
 
+def test_r_scope__scopes():
+    scopes_input = ["api", "client"]
+    result = format.r_scope(scopes=scopes_input)
+    regex = re.compile(result)
+    assert regex.match("(api)")
+    assert regex.match("(client)")
+    assert regex.match("(api, client)")
+    assert regex.match("(api: client)")
+    assert regex.match("(api/client)")
+    assert regex.match("(api-client)")
+    assert not regex.match("(test)")
+    assert not regex.match("(api; client)")
+
+
 def test_r_delim():
     result = format.r_delim()
     regex = re.compile(result)
@@ -151,6 +165,73 @@ def test_strip_comments__spaced():
     assert result.strip() == "feat(scope): message"
 
 
+def test_r_verbose_diff__has_diff():
+    regex = re.compile(format.r_verbose_diff(), re.MULTILINE)
+    input = """# ----------- >8 -----------
+# Some comment
+# Some comment
+diff --git a/file b/file
+"""
+
+    assert regex.match(input)
+
+
+def test_r_verbose_diff__no_diff():
+    regex = re.compile(format.r_verbose_diff(), re.MULTILINE)
+    input = """# ----------- >8 -----------
+# Some comment
+# Some comment
+"""
+
+    assert not regex.match(input)
+
+
+def test_r_verbose_diff__no_extra_comments():
+    regex = re.compile(format.r_verbose_diff(), re.MULTILINE)
+    input = """# ----------- >8 -----------
+diff --git a/file b/file
+"""
+
+    assert not regex.match(input)
+
+
+def test_strip_verbose_diff__has_diff():
+    input = """feat(scope): message
+# Please enter the commit message for your changes.
+
+# These are comments usually added by editors, f.ex. with export EDITOR=vim
+# ----------- >8 -----------
+# Some comment
+# Some comment
+diff --git a/file b/file
+"""
+
+    result = format.strip_verbose_diff(input)
+    assert result.count("\n") == 4
+    assert (
+        result
+        == """feat(scope): message
+# Please enter the commit message for your changes.
+
+# These are comments usually added by editors, f.ex. with export EDITOR=vim
+"""
+    )
+
+
+def test_strip_verbose_diff__no_diff():
+    input = """feat(scope): message
+# Please enter the commit message for your changes.
+
+# These are comments usually added by editors, f.ex. with export EDITOR=vim
+# ----------- >8 -----------
+# Some comment
+# Some comment
+"""
+
+    result = format.strip_verbose_diff(input)
+    assert result == input
+
+
 @pytest.mark.parametrize("type", format.DEFAULT_TYPES)
 def test_is_conventional__default_type(type):
     input = f"{type}: message"

{conventional_pre_commit-3.1.0 → conventional_pre_commit-3.3.0}/tests/test_hook.py

@@ -142,6 +142,16 @@ def test_subprocess_success__conventional_with_scope(cmd, conventional_commit_wi
     assert result == RESULT_SUCCESS
 
 
+def test_subprocess_success__conventional_with_multiple_scopes(cmd, conventional_commit_with_multiple_scopes_path):
+    result = subprocess.call((cmd, "--scopes", "api,client", conventional_commit_with_multiple_scopes_path))
+    assert result == RESULT_SUCCESS
+
+
+def test_subprocess_fail__conventional_with_multiple_scopes(cmd, conventional_commit_with_multiple_scopes_path):
+    result = subprocess.call((cmd, "--scopes", "api", conventional_commit_with_multiple_scopes_path))
+    assert result == RESULT_FAIL
+
+
 def test_subprocess_success__fixup_commit(cmd, fixup_commit_path):
     result = subprocess.call((cmd, fixup_commit_path))