Add --allow-star-arg-any flag

.pre-commit-config.yaml

@@ -3,7 +3,7 @@ ci:
 
 repos:
   - repo: /~https://github.com/psf/black
-    rev: 22.1.0
+    rev: 22.3.0
     hooks:
       - id: black
   - repo: /~https://github.com/pycqa/isort

CHANGELOG.md

@@ -1,6 +1,10 @@
 # Changelog
 Versions follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html) (`<major>`.`<minor>`.`<patch>`)
 
+## [v2.9.0]
+### Added
+* #135 Add `--allow-star-arg-any` to support suppression of `ANN401` for `*args` and `**kwargs`.
+
 ## [v2.8.0]
 ### Added
 * #131 Add the `ANN4xx` error level for opinionated warnings that are disabled by default.

README.md

@@ -136,6 +136,10 @@ See: [The `typing.overload` Decorator](#the-typingoverload-decorator) for additi
 
 Default: `"overload"`
 
+### `--allow-star-arg-any`
+Suppress `ANN401` for dynamically typed `*args` and `**kwargs`.
+
+Default: `False`
 
 ## Generic Functions
 Per the Python Glossary, a [generic function](https://docs.python.org/3/glossary.html#term-generic-function) is defined as:

flake8_annotations/checker.py

@@ -45,6 +45,7 @@ def __init__(self, tree: t.Optional[ast.Module], lines: t.List[str]):
         self.allow_untyped_defs: bool
         self.allow_untyped_nested: bool
         self.mypy_init_return: bool
+        self.allow_star_arg_any: bool
         self.dispatch_decorators: t.Set[str]
         self.overload_decorators: t.Set[str]
 
@@ -168,9 +169,7 @@ def add_options(cls, parser: OptionManager) -> None:  # pragma: no cover
             default=False,
             action="store_true",
             parse_from_config=True,
-            help=(
-                "Suppress ANN000-level errors for dummy arguments, defined as '_'. (Default: %(default)s)"  # noqa: E501
-            ),
+            help="Suppress ANN000-level errors for dummy arguments, defined as '_'. (Default: %(default)s)",  # noqa: E501
         )
 
         parser.add_option(
@@ -226,6 +225,14 @@ def add_options(cls, parser: OptionManager) -> None:  # pragma: no cover
             ),
         )
 
+        parser.add_option(
+            "--allow-star-arg-any",
+            default=False,
+            action="store_true",
+            parse_from_config=True,
+            help="Suppress ANN401 for dynamically typed *args and **kwargs. (Default: %(default)s)",
+        )
+
     @classmethod
     def parse_options(cls, options: Namespace) -> None:  # pragma: no cover
         """Parse the custom configuration options given to flake8."""
@@ -234,6 +241,7 @@ def parse_options(cls, options: Namespace) -> None:  # pragma: no cover
         cls.allow_untyped_defs = options.allow_untyped_defs
         cls.allow_untyped_nested = options.allow_untyped_nested
         cls.mypy_init_return = options.mypy_init_return
+        cls.allow_star_arg_any = options.allow_star_arg_any
 
         # Store decorator lists as sets for easier lookup
         cls.dispatch_decorators = set(options.dispatch_decorators)