flake8-author 2.0.0__tar.gz → 2.2.0__tar.gz

{flake8-author-2.0.0/flake8_author.egg-info → flake8_author-2.2.0}/PKG-INFO

@@ -1,30 +1,32 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: flake8-author
-Version: 2.0.0
+Version: 2.2.0
 Summary: Flake8 __author__ checker
-Home-page: https://github.com/jparise/flake8-author
-Author: Jon Parise
-Author-email: jon@indelible.org
-License: MIT
-Project-URL: Source Code, https://github.com/jparise/flake8-author
-Project-URL: Issue Tracker, https://github.com/jparise/flake8-author/issues
-Keywords: flake8 __author__
-Platform: UNKNOWN
+Author-email: Jon Parise <jon@indelible.org>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/jparise/flake8-author
+Project-URL: Repository, https://github.com/jparise/flake8-author
+Project-URL: Issues, https://github.com/jparise/flake8-author/issues
+Project-URL: Changelog, https://github.com/jparise/flake8-author/blob/main/CHANGELOG.rst
+Keywords: flake8,__author__
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Framework :: Flake8
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Software Development :: Quality Assurance
-Requires-Python: >=3.7
+Requires-Python: >=3.9
+Description-Content-Type: text/x-rst
 License-File: LICENSE
+Requires-Dist: flake8>=3.0.0
+Dynamic: license-file
 
 =========================
 Flake8 __author__ Checker
@@ -51,6 +53,9 @@ This extension can therefore be configured to explicitly require or forbid
 If the ``__author__`` attribute is allowed, its value can also be validated
 using a configurable regular expression pattern.
 
+The ``__author__`` attribute is generally assigned to a string, but multiple
+authors can be listed using a list (or tuple or set) of strings.
+
 .. |PyPI Version| image:: https://img.shields.io/pypi/v/flake8-author.svg
    :target: https://pypi.python.org/pypi/flake8-author
 .. |Python Versions| image:: https://img.shields.io/pypi/pyversions/flake8-author.svg
@@ -72,7 +77,7 @@ that it has been loaded by inspecting the ``flake8 --version`` string.
 .. code-block:: sh
 
     $ flake8 --version
-    4.0.1 (author: 2.0.0, ...) CPython 3.9.9 on Darwin
+    6.1.0 (author: 2.1.0, ...) CPython 3.11.5 on Darwin
 
 
 Error Codes
@@ -97,85 +102,3 @@ file`_ or as command line arguments (e.g. ``--author-attribute=required``).
 
 .. _config file: http://flake8.pycqa.org/en/latest/user/configuration.html
 .. _re: https://docs.python.org/library/re.html
-
-Copyright (c) 2016 Jon Parise
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
-Changes
-=======
-
-2.0.0 (2021-12-30)
-------------------
-
-* Drop support for Python 2.7 and 3.6, and add 3.10.
-* Drop support for flake8 2.x versions.
-
-1.2.0 (2020-10-12)
-------------------
-
-* Drop Python 3.5 support and add versions 3.8 and 3.9.
-* Minor documentation improvements.
-
-1.1.4 (2017-07-29)
-------------------
-
-* Minor code and packaging cleanup.
-
-1.1.3 (2017-07-28)
-------------------
-
-* Drop the ``setup_requires`` dependency on flake8.
-
-1.1.2 (2017-01-12)
-------------------
-
-* Only apply the author regular expression pattern check when a pattern has
-  actually been configured.
-
-1.1.1 (2016-11-06)
-------------------
-
-* Fix configuration file parsing for flake8 3.0+.
-
-1.1.0 (2016-08-15)
-------------------
-
-* Support flake8 3.0.0 (required for development)
-
-
-1.0.2 (2016-06-02)
-------------------
-
-* Support flake8 version 2.6.0
-* Drop test dependency on pytest (development only)
-
-
-1.0.1 (2016-05-11)
-------------------
-
-* Fixed parser validation for configuration-based options
-
-
-1.0.0 (2016-04-30)
-------------------
-
-* Initial release
-
-

{flake8-author-2.0.0 → flake8_author-2.2.0}/README.rst

@@ -23,6 +23,9 @@ This extension can therefore be configured to explicitly require or forbid
 If the ``__author__`` attribute is allowed, its value can also be validated
 using a configurable regular expression pattern.
 
+The ``__author__`` attribute is generally assigned to a string, but multiple
+authors can be listed using a list (or tuple or set) of strings.
+
 .. |PyPI Version| image:: https://img.shields.io/pypi/v/flake8-author.svg
    :target: https://pypi.python.org/pypi/flake8-author
 .. |Python Versions| image:: https://img.shields.io/pypi/pyversions/flake8-author.svg
@@ -44,7 +47,7 @@ that it has been loaded by inspecting the ``flake8 --version`` string.
 .. code-block:: sh
 
     $ flake8 --version
-    4.0.1 (author: 2.0.0, ...) CPython 3.9.9 on Darwin
+    6.1.0 (author: 2.1.0, ...) CPython 3.11.5 on Darwin
 
 
 Error Codes

flake8_author-2.2.0/pyproject.toml

@@ -0,0 +1,51 @@
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "flake8-author"
+dynamic = ["version"]
+description = "Flake8 __author__ checker"
+authors = [
+    {name = "Jon Parise", email = "jon@indelible.org"},
+]
+readme = "README.rst"
+license = "MIT"
+keywords = ["flake8", "__author__"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Framework :: Flake8",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: Quality Assurance",
+]
+requires-python = ">= 3.9"
+dependencies = [
+    "flake8>=3.0.0",
+]
+
+[dependency-groups]
+dev = [
+    "pytest>=8",
+    "ruff==0.12.0",
+]
+
+[project.entry-points."flake8.extension"]
+A40 = "flake8_author:Checker"
+
+[project.urls]
+Homepage = "https://github.com/jparise/flake8-author"
+Repository = "https://github.com/jparise/flake8-author"
+Issues = "https://github.com/jparise/flake8-author/issues"
+Changelog = "https://github.com/jparise/flake8-author/blob/main/CHANGELOG.rst"
+
+[tool.setuptools.dynamic]
+version = {attr = "flake8_author.__version__"}

flake8_author-2.2.0/setup.cfg

@@ -0,0 +1,9 @@
+[flake8]
+max-line-length = 88
+ignore = E203,E701
+exclude = .eggs/,.git/,.venv/,build/,dist/
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

{flake8-author-2.0.0 → flake8_author-2.2.0/src/flake8_author.egg-info}/PKG-INFO

@@ -1,30 +1,32 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: flake8-author
-Version: 2.0.0
+Version: 2.2.0
 Summary: Flake8 __author__ checker
-Home-page: https://github.com/jparise/flake8-author
-Author: Jon Parise
-Author-email: jon@indelible.org
-License: MIT
-Project-URL: Source Code, https://github.com/jparise/flake8-author
-Project-URL: Issue Tracker, https://github.com/jparise/flake8-author/issues
-Keywords: flake8 __author__
-Platform: UNKNOWN
+Author-email: Jon Parise <jon@indelible.org>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/jparise/flake8-author
+Project-URL: Repository, https://github.com/jparise/flake8-author
+Project-URL: Issues, https://github.com/jparise/flake8-author/issues
+Project-URL: Changelog, https://github.com/jparise/flake8-author/blob/main/CHANGELOG.rst
+Keywords: flake8,__author__
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Framework :: Flake8
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Software Development :: Quality Assurance
-Requires-Python: >=3.7
+Requires-Python: >=3.9
+Description-Content-Type: text/x-rst
 License-File: LICENSE
+Requires-Dist: flake8>=3.0.0
+Dynamic: license-file
 
 =========================
 Flake8 __author__ Checker
@@ -51,6 +53,9 @@ This extension can therefore be configured to explicitly require or forbid
 If the ``__author__`` attribute is allowed, its value can also be validated
 using a configurable regular expression pattern.
 
+The ``__author__`` attribute is generally assigned to a string, but multiple
+authors can be listed using a list (or tuple or set) of strings.
+
 .. |PyPI Version| image:: https://img.shields.io/pypi/v/flake8-author.svg
    :target: https://pypi.python.org/pypi/flake8-author
 .. |Python Versions| image:: https://img.shields.io/pypi/pyversions/flake8-author.svg
@@ -72,7 +77,7 @@ that it has been loaded by inspecting the ``flake8 --version`` string.
 .. code-block:: sh
 
     $ flake8 --version
-    4.0.1 (author: 2.0.0, ...) CPython 3.9.9 on Darwin
+    6.1.0 (author: 2.1.0, ...) CPython 3.11.5 on Darwin
 
 
 Error Codes
@@ -97,85 +102,3 @@ file`_ or as command line arguments (e.g. ``--author-attribute=required``).
 
 .. _config file: http://flake8.pycqa.org/en/latest/user/configuration.html
 .. _re: https://docs.python.org/library/re.html
-
-Copyright (c) 2016 Jon Parise
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
-Changes
-=======
-
-2.0.0 (2021-12-30)
-------------------
-
-* Drop support for Python 2.7 and 3.6, and add 3.10.
-* Drop support for flake8 2.x versions.
-
-1.2.0 (2020-10-12)
-------------------
-
-* Drop Python 3.5 support and add versions 3.8 and 3.9.
-* Minor documentation improvements.
-
-1.1.4 (2017-07-29)
-------------------
-
-* Minor code and packaging cleanup.
-
-1.1.3 (2017-07-28)
-------------------
-
-* Drop the ``setup_requires`` dependency on flake8.
-
-1.1.2 (2017-01-12)
-------------------
-
-* Only apply the author regular expression pattern check when a pattern has
-  actually been configured.
-
-1.1.1 (2016-11-06)
-------------------
-
-* Fix configuration file parsing for flake8 3.0+.
-
-1.1.0 (2016-08-15)
-------------------
-
-* Support flake8 3.0.0 (required for development)
-
-
-1.0.2 (2016-06-02)
-------------------
-
-* Support flake8 version 2.6.0
-* Drop test dependency on pytest (development only)
-
-
-1.0.1 (2016-05-11)
-------------------
-
-* Fixed parser validation for configuration-based options
-
-
-1.0.0 (2016-04-30)
-------------------
-
-* Initial release
-
-

flake8_author-2.2.0/src/flake8_author.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.rst
+pyproject.toml
+setup.cfg
+src/flake8_author.py
+src/flake8_author.egg-info/PKG-INFO
+src/flake8_author.egg-info/SOURCES.txt
+src/flake8_author.egg-info/dependency_links.txt
+src/flake8_author.egg-info/entry_points.txt
+src/flake8_author.egg-info/requires.txt
+src/flake8_author.egg-info/top_level.txt
+tests/test_checker.py

{flake8-author-2.0.0 → flake8_author-2.2.0/src}/flake8_author.egg-info/entry_points.txt

@@ -1,3 +1,2 @@
 [flake8.extension]
 A40 = flake8_author:Checker
-

flake8_author-2.2.0/src/flake8_author.py

@@ -0,0 +1,106 @@
+"""Flake8 extension that checks Python modules for an __author__ attribute.
+
+This extension can be configured to explicitly require or forbid __author__
+attributes. By default, __author__ is optional.
+
+If the __author__ attribute is allowed, its value will be validated against a
+configurable regular expression pattern (defaults to '.*').
+"""
+
+import ast
+import re
+from typing import Literal, Optional, get_args
+
+__author__ = "Jon Parise"
+__version__ = "2.2.0"
+
+AttributePolicy = Literal["optional", "required", "forbidden"]
+
+
+class Checker(object):
+    """flake8 __author__ checker"""
+
+    name = "author"
+    version = __version__
+
+    # Options
+    attribute: AttributePolicy = "optional"
+    pattern: Optional[re.Pattern] = None
+
+    def __init__(self, tree, filename):
+        self.tree = tree
+
+    @classmethod
+    def add_options(cls, parser):
+        extra_kwargs = {"parse_from_config": True}
+
+        parser.add_option(
+            "--author-attribute",
+            default=cls.attribute,
+            help="__author__ attribute: {0}".format(
+                ", ".join(get_args(AttributePolicy))
+            ),
+            **extra_kwargs,
+        )
+        parser.add_option(
+            "--author-pattern",
+            default=r"",
+            help="__author__ attribute validation pattern (regex)",
+            **extra_kwargs,
+        )
+
+    @classmethod
+    def parse_options(cls, options):
+        if options.author_attribute in get_args(AttributePolicy):
+            cls.attribute = options.author_attribute
+        else:
+            raise ValueError(
+                "author-attribute: '{0}' must be one of: {1}".format(
+                    options.author_attribute, ", ".join(get_args(AttributePolicy))
+                )
+            )
+
+        # Only build a regular expression object when we've been configured
+        # with a pattern that doesn't match all strings. This naively just
+        # checks for the default empty pattern string as well as `.*`.
+        if options.author_pattern and options.author_pattern != ".*":
+            try:
+                cls.pattern = re.compile(options.author_pattern)
+            except re.error as e:
+                raise ValueError(
+                    "author-pattern: '{0}': {1}".format(options.author_pattern, e)
+                )
+
+    def find_author_node(self, tree):
+        for node in tree.body:
+            if not isinstance(node, ast.Assign):
+                continue
+
+            for target in node.targets:
+                if isinstance(target, ast.Name) and target.id == "__author__":
+                    return node
+
+    def _match_author_pattern(self, author, node):
+        if self.pattern is not None and not self.pattern.match(author):
+            message = 'A402 __author__ value "{0}" does not match "{1}"'.format(
+                author, self.pattern.pattern
+            )
+            yield (node.lineno, node.col_offset, message, type(self))
+
+    def run(self):
+        node = self.find_author_node(self.tree)
+
+        if node is None and self.attribute == "required":
+            message = "A400 module-level __author__ attribute required"
+            yield 0, 0, message, type(self)
+
+        elif node and self.attribute == "forbidden":
+            message = "A401 __author__ attributes are not allowed"
+            yield node.lineno, node.col_offset, message, type(self)
+
+        elif node and self.pattern is not None:
+            if isinstance(node.value, (ast.List, ast.Tuple, ast.Set)):
+                for author in ast.literal_eval(node.value):
+                    yield from self._match_author_pattern(author, node)
+            elif isinstance(node.value, ast.Constant):
+                yield from self._match_author_pattern(node.value.value, node)

flake8_author-2.2.0/tests/test_checker.py

@@ -0,0 +1,197 @@
+import ast
+import unittest
+
+from flake8.main.application import Application
+from flake8_author import Checker
+
+
+def make_linter(code, path="example.py", argv=None):
+    app = Application()
+    app.initialize(argv)
+    Checker.parse_options(app.options)
+    tree = ast.parse(code, path)
+    return Checker(tree, path)
+
+
+def check(author, attribute=None, pattern=None):
+    code = ""
+    if isinstance(author, (list, tuple, set)):
+        code = "__author__ = {0}".format(author)
+    elif author:
+        code = '__author__ = "{0}"'.format(author)
+
+    argv = []
+    if attribute:
+        argv.append("--author-attribute={0}".format(attribute))
+    if pattern:
+        argv.append("--author-pattern={0}".format(pattern))
+
+    linter = make_linter(code, argv=argv)
+    if isinstance(author, (list, tuple, set)):
+        result = list(linter.run())
+        return result if len(result) else None
+    return next(linter.run(), None)
+
+
+class TestChecker(unittest.TestCase):
+    def tearDown(self):
+        Checker.attribute = "optional"
+        Checker.pattern = None
+
+    def test_author_optional(self):
+        self.assertIsNone(check("", attribute="optional"))
+        self.assertIsNone(check("Jon Parise", attribute="optional"))
+
+    def test_author_required(self):
+        self.assertIsNone(check("Jon Parise", attribute="required"))
+
+    def test_author_required_but_missing(self):
+        lineno, offset, message, _ = check("", attribute="required")
+        self.assertEqual(lineno, 0)
+        self.assertEqual(offset, 0)
+        self.assertTrue(message.startswith("A400"))
+
+    def test_author_forbidden(self):
+        self.assertIsNone(check("", attribute="forbidden"))
+
+    def test_author_forbidden_but_present(self):
+        lineno, offset, message, _ = check("Jon Parise", attribute="forbidden")
+        self.assertEqual(lineno, 1)
+        self.assertEqual(offset, 0)
+        self.assertTrue(message.startswith("A401"))
+
+    def test_author_invalid_attribute(self):
+        with self.assertRaises(ValueError):
+            check("Jon Parise", attribute="invalid")
+
+    def test_author_pattern(self):
+        author = "Jon Parise <jon@example.com>"
+        self.assertIsNone(check(author))
+        self.assertIsNone(check(author, pattern=r""))
+        self.assertIsNone(check(author, pattern=r".*"))
+
+    def test_author_pattern_not_matched(self):
+        author = "Jon Parise <jon@example.com>"
+        lineno, offset, message, _ = check(author, pattern=r"^[\w\s]+$")
+        self.assertEqual(lineno, 1)
+        self.assertEqual(offset, 0)
+        self.assertTrue(message.startswith("A402"))
+
+    def test_multi_author_list_pattern(self):
+        author = [
+            "Jon Parise <jon@example.com>",
+            "Jesse Boswell <jesse@example.com>",
+        ]
+        self.assertIsNone(check(author))
+        self.assertIsNone(check(author, pattern=r""))
+        self.assertIsNone(check(author, pattern=r".*"))
+
+    def test_multi_author_list_pattern_partial_match(self):
+        author = [
+            "Jon Parise <jon@example.com>",
+            "Jesse Boswell <jesse@badexample.com>",
+        ]
+        results = check(author, pattern=r"^.+?@example.com>$")
+        self.assertIsNotNone(results)
+        self.assertEqual(len(results), 1)
+        for result in results:
+            lineno, offset, message, _ = result
+            self.assertEqual(lineno, 1)
+            self.assertEqual(offset, 0)
+            self.assertTrue(message.startswith("A402"))
+
+    def test_multi_author_list_pattern_not_matched(self):
+        author = [
+            "Jon Parise <jon@example.com>",
+            "Jesse Boswell <jesse@example.com>",
+        ]
+        results = check(author, pattern=r"^[\w\s]+$")
+        self.assertIsNotNone(results)
+        self.assertEqual(len(results), 2)
+        for result in results:
+            lineno, offset, message, _ = result
+            self.assertEqual(lineno, 1)
+            self.assertEqual(offset, 0)
+            self.assertTrue(message.startswith("A402"))
+
+    def test_multi_author_tuple_pattern(self):
+        author = (
+            "Jon Parise <jon@example.com>",
+            "Jesse Boswell <jesse@example.com>",
+        )
+        self.assertIsNone(check(author))
+        self.assertIsNone(check(author, pattern=r""))
+        self.assertIsNone(check(author, pattern=r".*"))
+
+    def test_multi_author_tuple_pattern_partial_match(self):
+        author = (
+            "Jon Parise <jon@example.com>",
+            "Jesse Boswell <jesse@badexample.com>",
+        )
+        results = check(author, pattern=r"^.+?@example.com>$")
+        self.assertIsNotNone(results)
+        self.assertEqual(len(results), 1)
+        for result in results:
+            lineno, offset, message, _ = result
+            self.assertEqual(lineno, 1)
+            self.assertEqual(offset, 0)
+            self.assertTrue(message.startswith("A402"))
+
+    def test_multi_author_tuple_pattern_not_matched(self):
+        author = (
+            "Jon Parise <jon@example.com>",
+            "Jesse Boswell <jesse@example.com>",
+        )
+        results = check(author, pattern=r"^[\w\s]+$")
+        self.assertIsNotNone(results)
+        self.assertEqual(len(results), 2)
+        for result in results:
+            lineno, offset, message, _ = result
+            self.assertEqual(lineno, 1)
+            self.assertEqual(offset, 0)
+            self.assertTrue(message.startswith("A402"))
+
+    def test_multi_author_set_pattern(self):
+        author = {
+            "Jon Parise <jon@example.com>",
+            "Jesse Boswell <jesse@example.com>",
+        }
+        self.assertIsNone(check(author))
+        self.assertIsNone(check(author, pattern=r""))
+        self.assertIsNone(check(author, pattern=r".*"))
+
+    def test_multi_author_set_pattern_partial_match(self):
+        author = {
+            "Jon Parise <jon@example.com>",
+            "Jesse Boswell <jesse@badexample.com>",
+        }
+        results = check(author, pattern=r"^.+?@example.com>$")
+        self.assertIsNotNone(results)
+        self.assertEqual(len(results), 1)
+        for result in results:
+            lineno, offset, message, _ = result
+            self.assertEqual(lineno, 1)
+            self.assertEqual(offset, 0)
+            self.assertTrue(message.startswith("A402"))
+
+    def test_multi_author_set_pattern_not_matched(self):
+        author = {
+            "Jon Parise <jon@example.com>",
+            "Jesse Boswell <jesse@example.com>",
+        }
+        results = check(author, pattern=r"^[\w\s]+$")
+        self.assertIsNotNone(results)
+        self.assertEqual(len(results), 2)
+        for result in results:
+            lineno, offset, message, _ = result
+            self.assertEqual(lineno, 1)
+            self.assertEqual(offset, 0)
+            self.assertTrue(message.startswith("A402"))
+
+    def test_author_pattern_invalid_regex(self):
+        with self.assertRaises(ValueError):
+            check("Jon Parise", pattern=r"\[[")
+
+
+if __name__ == "__main__":
+    unittest.main()

flake8-author-2.0.0/CHANGES.rst

@@ -1,59 +0,0 @@
-Changes
-=======
-
-2.0.0 (2021-12-30)
-------------------
-
-* Drop support for Python 2.7 and 3.6, and add 3.10.
-* Drop support for flake8 2.x versions.
-
-1.2.0 (2020-10-12)
-------------------
-
-* Drop Python 3.5 support and add versions 3.8 and 3.9.
-* Minor documentation improvements.
-
-1.1.4 (2017-07-29)
-------------------
-
-* Minor code and packaging cleanup.
-
-1.1.3 (2017-07-28)
-------------------
-
-* Drop the ``setup_requires`` dependency on flake8.
-
-1.1.2 (2017-01-12)
-------------------
-
-* Only apply the author regular expression pattern check when a pattern has
-  actually been configured.
-
-1.1.1 (2016-11-06)
-------------------
-
-* Fix configuration file parsing for flake8 3.0+.
-
-1.1.0 (2016-08-15)
-------------------
-
-* Support flake8 3.0.0 (required for development)
-
-
-1.0.2 (2016-06-02)
-------------------
-
-* Support flake8 version 2.6.0
-* Drop test dependency on pytest (development only)
-
-
-1.0.1 (2016-05-11)
-------------------
-
-* Fixed parser validation for configuration-based options
-
-
-1.0.0 (2016-04-30)
-------------------
-
-* Initial release

flake8-author-2.0.0/MANIFEST.in

@@ -1,6 +0,0 @@
-include CHANGES.rst
-include LICENSE
-include README.rst
-
-recursive-include tests *
-recursive-exclude * *.py[co]

flake8-author-2.0.0/flake8_author.egg-info/SOURCES.txt

@@ -1,16 +0,0 @@
-CHANGES.rst
-LICENSE
-MANIFEST.in
-README.rst
-flake8_author.py
-setup.cfg
-setup.py
-flake8_author.egg-info/PKG-INFO
-flake8_author.egg-info/SOURCES.txt
-flake8_author.egg-info/dependency_links.txt
-flake8_author.egg-info/entry_points.txt
-flake8_author.egg-info/requires.txt
-flake8_author.egg-info/top_level.txt
-flake8_author.egg-info/zip-safe
-tests/__init__.py
-tests/test_checker.py

flake8-author-2.0.0/flake8_author.egg-info/zip-safe

@@ -1 +0,0 @@
-

flake8-author-2.0.0/flake8_author.py

@@ -1,90 +0,0 @@
-"""Flake8 extension that checks Python modules for an __author__ attribute.
-
-This extension can be configured to explicitly require or forbid __author__
-attributes. By default, __author__ is optional.
-
-If the __author__ attribute is allowed, its value will be validated against a
-configurable regular expression pattern (defaults to '.*').
-"""
-
-import ast
-import re
-
-__author__ = 'Jon Parise'
-__version__ = '2.0.0'
-
-
-class Checker(object):
-    """flake8 __author__ checker"""
-
-    name = 'author'
-    options = {}
-    version = __version__
-
-    # Attribute existence choices
-    attribute_choices = ('optional', 'required', 'forbidden')
-
-    def __init__(self, tree, filename):
-        self.tree = tree
-
-    @classmethod
-    def add_options(cls, parser):
-        extra_kwargs = {'parse_from_config': True}
-
-        parser.add_option(
-            '--author-attribute',
-            default='optional',
-            help="__author__ attribute: {0}".format(
-                ', '.join(cls.attribute_choices)),
-            **extra_kwargs)
-        parser.add_option(
-            '--author-pattern',
-            default=r'',
-            help="__author__ attribute validation pattern (regex)",
-            **extra_kwargs)
-
-    @classmethod
-    def parse_options(cls, options):
-        if options.author_attribute in cls.attribute_choices:
-            cls.options['attribute'] = options.author_attribute
-        else:
-            raise ValueError(
-                "author-attribute: '{0}' must be one of: {1}".format(
-                    options.author_attribute,
-                    ', '.join(cls.attribute_choices)))
-
-        # Only build a regular expression object when we've been configured
-        # with a pattern that doesn't match all strings. This naively just
-        # checks for the default empty pattern string as well as `.*`.
-        if options.author_pattern and options.author_pattern != '.*':
-            try:
-                cls.options['pattern'] = re.compile(options.author_pattern)
-            except re.error as e:
-                raise ValueError("author-pattern: '{0}': {1}".format(
-                    options.author_pattern, e))
-
-    def find_author_node(self, tree):
-        for node in tree.body:
-            if not isinstance(node, ast.Assign):
-                continue
-
-            for target in node.targets:
-                if isinstance(target, ast.Name) and target.id == '__author__':
-                    return node
-
-    def run(self):
-        node = self.find_author_node(self.tree)
-
-        if node is None and self.options['attribute'] == 'required':
-            message = 'A400 module-level __author__ attribute required'
-            yield 0, 0, message, type(self)
-
-        elif node and self.options['attribute'] == 'forbidden':
-            message = 'A401 __author__ attributes are not allowed'
-            yield node.lineno, node.col_offset, message, type(self)
-
-        elif (node and 'pattern' in self.options and
-                not self.options['pattern'].match(node.value.s)):
-            message = ('A402 __author__ value "{0}" does not match "{1}"'
-                       .format(node.value.s, self.options['pattern'].pattern))
-            yield node.lineno, node.col_offset, message, type(self)

flake8-author-2.0.0/setup.cfg

@@ -1,44 +0,0 @@
-[metadata]
-name = flake8-author
-version = attr: flake8_author.__version__
-author = Jon Parise
-author_email = jon@indelible.org
-description = Flake8 __author__ checker
-long_description = file: README.rst, LICENSE, CHANGES.rst
-license = MIT
-url = https://github.com/jparise/flake8-author
-project_urls = 
-	Source Code = https://github.com/jparise/flake8-author
-	Issue Tracker = https://github.com/jparise/flake8-author/issues
-keywords = flake8 __author__
-classifiers = 
-	Development Status :: 5 - Production/Stable
-	Environment :: Console
-	Framework :: Flake8
-	Intended Audience :: Developers
-	License :: OSI Approved :: MIT License
-	Programming Language :: Python
-	Programming Language :: Python :: 3 :: Only
-	Programming Language :: Python :: 3.7
-	Programming Language :: Python :: 3.8
-	Programming Language :: Python :: 3.9
-	Programming Language :: Python :: 3.10
-	Topic :: Software Development :: Libraries :: Python Modules
-	Topic :: Software Development :: Quality Assurance
-
-[options]
-py_modules = flake8_author
-python_requires = >= 3.7
-zip_safe = True
-
-[options.entry_points]
-flake8.extension = 
-	A40 = flake8_author:Checker
-
-[flake8]
-exclude = .eggs/,.git/,.venv/,build/,dist/
-
-[egg_info]
-tag_build = 
-tag_date = 0
-

flake8-author-2.0.0/setup.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python
-
-from setuptools import setup
-
-setup(
-    name="flake8-author",
-    install_requires=["flake8>=3.0.0"],
-    tests_require=['flake8>=3.0.0'],
-    test_suite="tests",
-)

flake8-author-2.0.0/tests/test_checker.py

@@ -1,76 +0,0 @@
-import ast
-import unittest
-
-from flake8.main.application import Application
-from flake8_author import Checker
-
-
-def make_linter(code, path='example.py', argv=None):
-    app = Application()
-    app.initialize(argv)
-    Checker.parse_options(app.options)
-    tree = ast.parse(code, path)
-    return Checker(tree, path)
-
-
-def check(author, attribute=None, pattern=None):
-    code = '__author__ = "{0}"'.format(author) if author else ''
-
-    argv = []
-    if attribute:
-        argv.append('--author-attribute={0}'.format(attribute))
-    if pattern:
-        argv.append('--author-pattern={0}'.format(pattern))
-
-    linter = make_linter(code, argv=argv)
-    return next(linter.run(), None)
-
-
-class TestChecker(unittest.TestCase):
-
-    def test_author_optional(self):
-        self.assertIsNone(check('', attribute='optional'))
-        self.assertIsNone(check('Jon Parise', attribute='optional'))
-
-    def test_author_required(self):
-        self.assertIsNone(check('Jon Parise', attribute='required'))
-
-    def test_author_required_but_missing(self):
-        lineno, offset, message, _ = check('', attribute='required')
-        self.assertEqual(lineno, 0)
-        self.assertEqual(offset, 0)
-        self.assertTrue(message.startswith('A400'))
-
-    def test_author_forbidden(self):
-        self.assertIsNone(check('', attribute='forbidden'))
-
-    def test_author_forbidden_but_present(self):
-        lineno, offset, message, _ = check('Jon Parise', attribute='forbidden')
-        self.assertEqual(lineno, 1)
-        self.assertEqual(offset, 0)
-        self.assertTrue(message.startswith('A401'))
-
-    def test_author_invalid_attribute(self):
-        with self.assertRaises(ValueError):
-            check('Jon Parise', attribute='invalid')
-
-    def test_author_pattern(self):
-        author = 'Jon Parise <jon@example.com>'
-        self.assertIsNone(check(author))
-        self.assertIsNone(check(author, pattern=r''))
-        self.assertIsNone(check(author, pattern=r'.*'))
-
-    def test_author_pattern_not_matched(self):
-        author = 'Jon Parise <jon@example.com>'
-        lineno, offset, message, _ = check(author, pattern=r'^[\w\s]+$')
-        self.assertEqual(lineno, 1)
-        self.assertEqual(offset, 0)
-        self.assertTrue(message.startswith('A402'))
-
-    def test_author_pattern_invalid_regex(self):
-        with self.assertRaises(ValueError):
-            check('Jon Parise', pattern=r'\[[')
-
-
-if __name__ == '__main__':
-    unittest.main()