docsig 0.55.0__tar.gz → 0.57.0__tar.gz

{docsig-0.55.0 → docsig-0.57.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: docsig
-Version: 0.55.0
+Version: 0.57.0
 Summary: Check signature params for proper documentation
 Home-page: https://pypi.org/project/docsig/
 License: MIT
@@ -9,10 +9,9 @@ Author: jshwi
 Author-email: stephen@jshwisolutions.com
 Maintainer: jshwi
 Maintainer-email: stephen@jshwisolutions.com
-Requires-Python: >=3.8,<4.0
+Requires-Python: >=3.8.1,<4.0.0
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -152,16 +151,49 @@ Options can also be configured with the pyproject.toml file
     check-overridden = false
     check-protected = false
     disable = [
-        "E101",
-        "E102",
-        "E103",
+        "SIG101",
+        "SIG102",
+        "SIG402",
     ]
     target = [
-        "E102",
-        "E103",
-        "E104",
+        "SIG202",
+        "SIG203",
+        "SIG201",
     ]
 
+Flake8
+******
+
+``docsig`` can also be used as a ``flake8`` plugin. Install ``flake8`` and
+ensure your installation has registered `docsig`
+
+.. code-block:: console
+
+    $ flake8 --version
+    7.1.0 (docsig: 0.57.0, mccabe: 0.7.0, pycodestyle: 2.12.0, pyflakes: 3.2.0) CPython 3.8.13 on Darwin
+
+And now use `flake8` to lint your files
+
+.. code-block:: console
+
+    $ flake8 example.py
+    example.py:1:1: SIG202 includes parameters that do not exist (params-do-not-exist) 'function'
+
+With ``flake8`` the pyproject.toml config will still be the base config, though the
+`ini files <https://flake8.pycqa.org/en/latest/user/configuration.html#configuration-locations>`_ ``flake8`` gets it config from will override the pyproject.toml config.
+For ``flake8`` all args and config options are prefixed with ``sig`` to
+avoid any potential conflicts with other plugins
+
+.. code-block:: ini
+
+    [flake8]
+    sig-check-dunders = True
+    sig-check-overridden = True
+    sig-check-protected = True
+
+..
+   end flake8
+
 API
 ***
 
@@ -196,7 +228,7 @@ API
     ... """
     >>> docsig(string=string, no_ansi=True)
     2 in function
-        E102: includes parameters that do not exist (params-do-not-exist)
+        SIG202: includes parameters that do not exist (params-do-not-exist)
     1
 
 A full list of checks can be found `here <https://docsig.readthedocs.io/en/latest/usage/messages.html>`__
@@ -204,6 +236,9 @@ A full list of checks can be found `here <https://docsig.readthedocs.io/en/lates
 Message Control
 ***************
 
+If you have been using ``docsig`` prior to ``v0.56.0``, please see
+`updated messages <https://docsig.readthedocs.io/en/latest/deprecated/messages.html>`_
+
 `Documentation on message control <https://docsig.readthedocs.io/en/latest/usage/message-control.html>`_
 
 Classes
@@ -222,7 +257,7 @@ It can be added to your .pre-commit-config.yaml as follows:
 
     repos:
       - repo: https://github.com/jshwi/docsig
-        rev: v0.55.0
+        rev: v0.57.0
         hooks:
           - id: docsig
             args:

{docsig-0.55.0 → docsig-0.57.0}/README.rst

@@ -124,16 +124,49 @@ Options can also be configured with the pyproject.toml file
     check-overridden = false
     check-protected = false
     disable = [
-        "E101",
-        "E102",
-        "E103",
+        "SIG101",
+        "SIG102",
+        "SIG402",
     ]
     target = [
-        "E102",
-        "E103",
-        "E104",
+        "SIG202",
+        "SIG203",
+        "SIG201",
     ]
 
+Flake8
+******
+
+``docsig`` can also be used as a ``flake8`` plugin. Install ``flake8`` and
+ensure your installation has registered `docsig`
+
+.. code-block:: console
+
+    $ flake8 --version
+    7.1.0 (docsig: 0.57.0, mccabe: 0.7.0, pycodestyle: 2.12.0, pyflakes: 3.2.0) CPython 3.8.13 on Darwin
+
+And now use `flake8` to lint your files
+
+.. code-block:: console
+
+    $ flake8 example.py
+    example.py:1:1: SIG202 includes parameters that do not exist (params-do-not-exist) 'function'
+
+With ``flake8`` the pyproject.toml config will still be the base config, though the
+`ini files <https://flake8.pycqa.org/en/latest/user/configuration.html#configuration-locations>`_ ``flake8`` gets it config from will override the pyproject.toml config.
+For ``flake8`` all args and config options are prefixed with ``sig`` to
+avoid any potential conflicts with other plugins
+
+.. code-block:: ini
+
+    [flake8]
+    sig-check-dunders = True
+    sig-check-overridden = True
+    sig-check-protected = True
+
+..
+   end flake8
+
 API
 ***
 
@@ -168,7 +201,7 @@ API
     ... """
     >>> docsig(string=string, no_ansi=True)
     2 in function
-        E102: includes parameters that do not exist (params-do-not-exist)
+        SIG202: includes parameters that do not exist (params-do-not-exist)
     1
 
 A full list of checks can be found `here <https://docsig.readthedocs.io/en/latest/usage/messages.html>`__
@@ -176,6 +209,9 @@ A full list of checks can be found `here <https://docsig.readthedocs.io/en/lates
 Message Control
 ***************
 
+If you have been using ``docsig`` prior to ``v0.56.0``, please see
+`updated messages <https://docsig.readthedocs.io/en/latest/deprecated/messages.html>`_
+
 `Documentation on message control <https://docsig.readthedocs.io/en/latest/usage/message-control.html>`_
 
 Classes
@@ -194,7 +230,7 @@ It can be added to your .pre-commit-config.yaml as follows:
 
     repos:
       - repo: https://github.com/jshwi/docsig
-        rev: v0.55.0
+        rev: v0.57.0
         hooks:
           - id: docsig
             args:

{docsig-0.55.0 → docsig-0.57.0}/docsig/_hooks.py

@@ -14,7 +14,7 @@ def excepthook(no_ansi: bool = False) -> None:
 
     :param no_ansi: Disable ANSI output.
     """
-    if _e.get("DOCSIG_DEBUG", None) != "1":
+    if _e.get("DOCSIG_DEBUG") != "1":
         _sys.excepthook = lambda x, y, _: _pretty_print_error(
             x, str(y), no_ansi
         )

{docsig-0.55.0 → docsig-0.57.0}/docsig/_report.py

@@ -80,24 +80,24 @@ class Failure(_t.List[str]):
             if not comment.isvalid:
                 if comment.ismodule:
                     # unknown-module-directive
-                    self._add(_E[201], directive=comment.kind)
+                    self._add(_E[1], directive=comment.kind)
                 else:
                     # unknown-inline-directive
-                    self._add(_E[202], directive=comment.kind)
+                    self._add(_E[2], directive=comment.kind)
             else:
                 for rule in comment:
                     if not rule.isknown:
                         if comment.ismodule:
                             # unknown-module-directive-option
                             self._add(
-                                _E[203],
+                                _E[3],
                                 directive=comment.kind,
                                 option=rule.description,
                             )
                         else:
                             # unknown-inline-directive-option
                             self._add(
-                                _E[204],
+                                _E[4],
                                 directive=comment.kind,
                                 option=rule.description,
                             )
@@ -105,10 +105,10 @@ class Failure(_t.List[str]):
     def _sig1xx_missing(self) -> None:
         if not self._func.isinit:
             # function-doc-missing
-            self._add(_E[113])
+            self._add(_E[101])
         else:
             # class-doc-missing
-            self._add(_E[114])
+            self._add(_E[102])
 
     def _sig2xx_signature(self) -> None:
         if self._func.docstring.args.duplicated:
@@ -120,7 +120,7 @@ class Failure(_t.List[str]):
                     self._func.docstring.args.pop(count)
 
             # duplicate-params-found
-            self._add(_E[106])
+            self._add(_E[201])
         # there are non-existing params in the docstring
         elif len(self._func.docstring.args) > len(self._func.signature.args):
             # pop the parameters that do not exist so that they are
@@ -133,7 +133,7 @@ class Failure(_t.List[str]):
                 if count > len(self._func.signature.args):
                     self._func.docstring.args.pop(count - 1)
             # params-do-not-exist
-            self._add(_E[102])
+            self._add(_E[202])
         # there are more args in sig than doc, so doc params missing
         elif len(self._func.signature.args) > len(self._func.docstring.args):
             # append the parameters that are missing so that they are
@@ -148,33 +148,33 @@ class Failure(_t.List[str]):
                         _Param(arg.kind, arg.name, _VALID_DESCRIPTION, 0)
                     )
             # params-missing
-            self._add(_E[103])
+            self._add(_E[203])
 
     def _sig3xx_description(self, doc: _Param) -> None:
         if doc.description is None:
-            self._add(_E[117])
+            self._add(_E[301])
         elif doc.description is not None and not doc.description.startswith(
             " "
         ):
             # syntax-error-in-description
-            self._add(_E[115])
+            self._add(_E[302])
         # if the parameter does not have a name, but exists, then it
         # must be incorrectly documented
         elif doc.name == _UNNAMED:
             # param-incorrectly-documented
-            self._add(_E[107])
+            self._add(_E[303])
 
     def _sig4xx_parameters(self, doc: _Param, sig: _Param) -> None:
         if doc.indent > 0:
             # incorrect-indent
-            self._add(_E[116])
+            self._add(_E[401])
         elif doc != sig:
             if (
                 sig.name in self._func.docstring.args.names
                 or doc.name in self.func.signature.args.names
             ):
                 # params-out-of-order
-                self._add(_E[101])
+                self._add(_E[402])
             elif (
                 doc.name != _UNNAMED
                 and sig.name is not None
@@ -182,10 +182,10 @@ class Failure(_t.List[str]):
             ):
                 if _almost_equal(sig.name, doc.name, _MIN_MATCH, _MAX_MATCH):
                     # spelling-error
-                    self._add(_E[112])
+                    self._add(_E[403])
                 else:
                     # param-not-equal-to-arg
-                    self._add(_E[110])
+                    self._add(_E[404])
 
     def _sig5xx_returns(self) -> None:
         if not self._func.isinit and not (
@@ -194,28 +194,28 @@ class Failure(_t.List[str]):
             # no types, cannot know either way
             if self._func.signature.rettype == _RetType.UNTYPED:
                 # confirm-return-needed
-                self._add(_E[109], hint=True)
+                self._add(_E[501], hint=True)
             # return type is none, so no return should be documented
             elif self._func.docstring.returns:
                 if self._func.signature.rettype == _RetType.NONE:
                     # return-documented-for-none
-                    self._add(_E[104])
+                    self._add(_E[502])
             # return type is some, so return should be documented
             elif self._func.signature.returns:
                 # return-missing
                 self._add(
-                    _E[105],
+                    _E[503],
                     hint=_has_bad_return(str(self._func.docstring.string)),
                 )
         elif self._func.docstring.returns:
             # method is init, so no return should be documented
             if self._func.isinit:
                 # class-return-documented
-                self._add(_E[111], hint=True)
+                self._add(_E[504], hint=True)
             # method is property and not set to document property
             elif self._func.isproperty and not self._check_property_returns:
                 # return-documented-for-property
-                self._add(_E[108], hint=True)
+                self._add(_E[505], hint=True)
 
     @property
     def func(self) -> _Function:

{docsig-0.55.0 → docsig-0.57.0}/docsig/_version.py

@@ -8,4 +8,4 @@ Allows for access to the version internally without cyclic imports
 caused by accessing it through __init__.
 """
 
-__version__ = "0.55.0"
+__version__ = "0.57.0"

{docsig-0.55.0 → docsig-0.57.0}/docsig/messages.py

@@ -6,12 +6,16 @@ docsig.messages
 from __future__ import annotations
 
 import typing as _t
+from warnings import warn as _warn
 
 #: Error code for unknown errors.
-UNKNOWN = "E000"
+UNKNOWN = "SIG000"
 
 #: Default template to format message strings.
-TEMPLATE = "{code}: {description} ({symbolic})"
+TEMPLATE = "{ref}: {description} ({symbolic})"
+
+#: Flake8 template to format message strings.
+FLAKE8 = "{ref} {description} ({symbolic})"
 
 
 class Message(_t.NamedTuple):
@@ -39,7 +43,7 @@ class Message(_t.NamedTuple):
         This might exist due to a typo or an attempt to retrieve an
         error that does not exist.
         """
-        return self.code != UNKNOWN
+        return self.ref != UNKNOWN
 
     def fstring(self, template: str) -> str:
         """Return message values as a string.
@@ -48,7 +52,7 @@ class Message(_t.NamedTuple):
         :return: Formatted string.
         """
         return template.format(
-            code=self.code,
+            ref=self.ref,
             description=self.description,
             symbolic=self.symbolic,
         )
@@ -68,7 +72,18 @@ class MessageMap(_t.Dict[int, Message]):
         :return: Message if valid ref else an unknown message type.
         """
         for value in self.values():
-            if ref in (value.ref, value.code, value.symbolic):
+            if ref == value.code:
+                _warn(
+                    "Exxx errors are deprecated and might not be supported in "
+                    "a future version, see "
+                    "https://docsig.readthedocs.io/en/latest/deprecated/"
+                    "messages.html",
+                    category=DeprecationWarning,
+                    stacklevel=6,
+                )
+                return value
+
+            if ref in (value.ref, value.symbolic):
                 return value
 
         return Message(UNKNOWN, UNKNOWN, ref)
@@ -84,144 +99,142 @@ class MessageMap(_t.Dict[int, Message]):
     @property
     def all(self) -> Messages:
         """Get all messages that aren't a config error."""
-        return Messages(
-            v for k, v in self.items() if str(k).startswith(str(1))
-        )
+        return Messages(v for k, v in self.items() if len(str(k)) > 1)
 
 
 # SIGxxx: Error
 E = MessageMap(
     {
         #: SIG0xx Config
-        201: Message(
+        1: Message(
             "SIG001",
             "E201",
             "unknown module comment directive '{directive}'",
             "unknown-module-directive",
         ),
-        202: Message(
+        2: Message(
             "SIG002",
             "E202",
             "unknown inline comment directive '{directive}'",
             "unknown-inline-directive",
         ),
-        203: Message(
+        3: Message(
             "SIG003",
             "E203",
             "unknown module comment option for {directive} '{option}'",
             "unknown-module-directive-option",
         ),
-        204: Message(
+        4: Message(
             "SIG004",
             "E204",
             "unknown inline comment option for {directive} '{option}'",
             "unknown-inline-directive-option",
         ),
         #: SIG1xx Missing
-        113: Message(
+        101: Message(
             "SIG101",
             "E113",
             "function is missing a docstring",
             "function-doc-missing",
         ),
-        114: Message(
+        102: Message(
             "SIG102",
             "E114",
             "class is missing a docstring",
             "class-doc-missing",
         ),
         #: SIG2xx Signature
-        106: Message(
+        201: Message(
             "SIG201",
             "E106",
             "duplicate parameters found",
             "duplicate-params-found",
         ),
-        102: Message(
+        202: Message(
             "SIG202",
             "E102",
             "includes parameters that do not exist",
             "params-do-not-exist",
         ),
-        103: Message(
+        203: Message(
             "SIG203",
             "E103",
             "parameters missing",
             "params-missing",
         ),
         #: SIG3xx Parameters
-        117: Message(
+        301: Message(
             "SIG301",
             "E117",
             "description missing from parameter",
             "description-missing",
         ),
-        115: Message(
+        302: Message(
             "SIG302",
             "E115",
             "syntax error in description",
             "syntax-error-in-description",
         ),
-        107: Message(
+        303: Message(
             "SIG303",
             "E107",
             "parameter appears to be incorrectly documented",
             "param-incorrectly-documented",
         ),
         #: SIG4xx Description
-        116: Message(
+        401: Message(
             "SIG401",
             "E116",
             "param not indented correctly",
             "incorrect-indent",
         ),
-        101: Message(
+        402: Message(
             "SIG402",
             "E101",
             "parameters out of order",
             "params-out-of-order",
         ),
-        112: Message(
+        403: Message(
             "SIG403",
             "E112",
             "spelling error found in documented parameter",
             "spelling-error",
         ),
-        110: Message(
+        404: Message(
             "SIG404",
             "E110",
             "documented parameter not equal to its respective argument",
             "param-not-equal-to-arg",
         ),
         #: SIG5xx Returns
-        109: Message(
+        501: Message(
             "SIG501",
             "E109",
             "cannot determine whether a return statement should exist",
             "confirm-return-needed",
             "annotate type to indicate whether return documentation needed",
         ),
-        104: Message(
+        502: Message(
             "SIG502",
             "E104",
             "return statement documented for None",
             "return-documented-for-none",
         ),
-        105: Message(
+        503: Message(
             "SIG503",
             "E105",
             "return missing from docstring",
             "return-missing",
             "it is possible a syntax error could be causing this",
         ),
-        111: Message(
+        504: Message(
             "SIG504",
             "E111",
             "return statement documented for class",
             "class-return-documented",
             "a class does not return a value during instantiation",
         ),
-        108: Message(
+        505: Message(
             "SIG505",
             "E108",
             "return statement documented for property",

docsig-0.57.0/docsig/plugin.py

@@ -0,0 +1,165 @@
+"""Flake8 implementation of docsig."""
+
+import ast
+import contextlib
+import io
+import re
+import sys
+import typing as t
+from argparse import Namespace
+
+import docsig
+
+Flake8Error = t.Tuple[int, int, str, t.Type]
+
+
+class Docsig:
+    """Flake8 implementation of docsig class.
+
+    :param tree: Ast module, which will not be used by flake8 will
+        provide.
+    :param filename: Filename to pass to docsig.
+    """
+
+    off_by_default = False
+    name = docsig.__name__
+    version = docsig.__version__
+    options_dict: t.Dict[str, bool] = {}
+
+    def __init__(self, tree: ast.Module, filename: str) -> None:
+        _tree = tree  # noqa
+        self.filename = filename
+
+    # won't import flake8 type
+    # conflicts with this module name
+    # might require that flake8 actually be installed, which is not a
+    # requirement for this package
+    @classmethod
+    def add_options(cls, parser) -> None:
+        """Add flake8 commandline and config options.sig_
+
+        :param parser: Flake8 option manager.
+        """
+        parser.add_option(
+            "--sig-check-class",
+            action="store_true",
+            parse_from_config=True,
+            help="check class docstrings",
+        )
+        parser.add_option(
+            "--sig-check-class-constructor",
+            action="store_true",
+            parse_from_config=True,
+            help="check __init__ methods. Note: mutually incompatible with -c",
+        )
+        parser.add_option(
+            "--sig-check-dunders",
+            action="store_true",
+            parse_from_config=True,
+            help="check dunder methods",
+        )
+        parser.add_option(
+            "--sig-check-protected-class-methods",
+            action="store_true",
+            parse_from_config=True,
+            help="check public methods belonging to protected classes",
+        )
+        parser.add_option(
+            "--sig-check-nested",
+            action="store_true",
+            parse_from_config=True,
+            help="check nested functions and classes",
+        )
+        parser.add_option(
+            "--sig-check-overridden",
+            action="store_true",
+            parse_from_config=True,
+            help="check overridden methods",
+        )
+        parser.add_option(
+            "--sig-check-protected",
+            action="store_true",
+            parse_from_config=True,
+            help="check protected functions and classes",
+        )
+        parser.add_option(
+            "--sig-check-property-returns",
+            action="store_true",
+            parse_from_config=True,
+            help="check property return values",
+        )
+        parser.add_option(
+            "--sig-ignore-no-params",
+            action="store_true",
+            parse_from_config=True,
+            help="ignore docstrings where parameters are not documented",
+        )
+        parser.add_option(
+            "--sig-ignore-args",
+            action="store_true",
+            parse_from_config=True,
+            help="ignore args prefixed with an asterisk",
+        )
+        parser.add_option(
+            "--sig-ignore-kwargs",
+            action="store_true",
+            parse_from_config=True,
+            help="ignore kwargs prefixed with two asterisks",
+        )
+        parser.add_option(
+            "--sig-ignore-typechecker",
+            action="store_true",
+            parse_from_config=True,
+            help="ignore checking return values",
+        )
+
+    @classmethod
+    def parse_options(cls, options: Namespace) -> None:
+        """Parse flake8 options into am instance accessible dict.
+
+        :param options: Argparse namespace.
+        """
+        cls.options_dict = {
+            "check_class": options.sig_check_class,
+            "check_class_constructor": options.sig_check_class_constructor,
+            "check_dunders": options.sig_check_dunders,
+            "check_protected_class_methods": (
+                options.sig_check_protected_class_methods
+            ),
+            "check_nested": options.sig_check_nested,
+            "check_overridden": options.sig_check_overridden,
+            "check_protected": options.sig_check_protected,
+            "check_property_returns": options.sig_check_property_returns,
+            "ignore_no_params": options.sig_ignore_no_params,
+            "ignore_args": options.sig_ignore_args,
+            "ignore_kwargs": options.sig_ignore_kwargs,
+            "ignore_typechecker": options.sig_ignore_typechecker,
+        }
+
+    def run(self) -> t.Generator[Flake8Error, None, None]:
+        """Run docsig and possibly yield a flake8 error.
+
+        :return: Flake8 error, if there is one.
+        """
+        buffer = io.StringIO()
+        with contextlib.redirect_stdout(buffer):
+            sys.argv = [
+                __package__,
+                self.filename,
+                *[
+                    f"--{k.replace('_', '-')}"
+                    for k, v in self.options_dict.items()
+                    if v
+                ],
+            ]
+            docsig.main()
+
+        results = re.split(r"^(?!\s)", buffer.getvalue(), flags=re.MULTILINE)
+        for result in results:
+            if not result:
+                continue
+
+            header, remainder = result.splitlines()[:2]
+            lineno, func_name = header.split(":", 1)[1].split(" in ", 1)
+            line = f"{remainder.lstrip().replace(':', '')} '{func_name}'"
+            yield int(lineno), 0, line, self.__class__

{docsig-0.55.0 → docsig-0.57.0}/pyproject.toml

@@ -7,12 +7,56 @@ requires = [
 [tool.black]
 line-length = 79
 
+[tool.bumpversion]
+allow_dirty = true
+commit = true
+commit_args = "-sS"
+current_version = "0.57.0"
+message = "bump: version {current_version} → {new_version}"
+sign_tags = true
+tag = true
+
+[[tool.bumpversion.files]]
+filename = "docs/conf.py"
+
+[[tool.bumpversion.files]]
+filename = "docsig/_version.py"
+
+[[tool.bumpversion.files]]
+filename = "pyproject.toml"
+replace = 'version = "{new_version}"'
+search = 'version = "{current_version}"'
+
+[[tool.bumpversion.files]]
+filename = "package.json"
+replace = '"version": "{new_version}"'
+search = '"version": "{current_version}"'
+
+[[tool.bumpversion.files]]
+filename = "README.rst"
+replace = "rev: v{new_version}"
+search = "rev: v{current_version}"
+
+[[tool.bumpversion.files]]
+filename = "README.rst"
+replace = "docsig: {new_version}"
+search = "docsig: {current_version}"
+
+[[tool.bumpversion.files]]
+filename = "SECURITY.md"
+
+[[tool.bumpversion.files]]
+filename = "Makefile"
+replace = "VERSION := {new_version}"
+search = "VERSION := {current_version}"
+
 [tool.codespell]
 ignore-words-list = "astroid"
 
 [tool.coverage.report]
 exclude_lines = [
-  "@_t.overload"
+  "@_t.overload",
+  "if __name__ == .__main__.:"
 ]
 fail_under = 100
 
@@ -24,7 +68,14 @@ omit = [
 ]
 
 [tool.deptry.per_rule_ignores]
-DEP004 = ["yaml"]
+DEP004 = [
+  "flake8",
+  "git",
+  "pytest",
+  "tomli",
+  "tomli_w",
+  "yaml"
+]
 
 [tool.docformatter]
 in-place = true
@@ -76,7 +127,7 @@ maintainers = [
 name = "docsig"
 readme = "README.rst"
 repository = "https://github.com/jshwi/docsig"
-version = "0.55.0"
+version = "0.57.0"
 
 [tool.poetry.dependencies]
 Sphinx = "^7.0.0"
@@ -84,18 +135,22 @@ arcon = ">=0.4.0"
 astroid = "^3.0.1"
 click = "^8.1.7"
 pathspec = "^0.12.1"
-python = "^3.8"
+python = "^3.8.1"
 
 [tool.poetry.group.dev.dependencies]
 black = "^24.4.2"
-bump2version = "^1.0.1"
+bump-my-version = "^0.24.1"
 deptry = "^0.16.1"
 docformatter = "^1.7.5"
 flynt = "^1.0.1"
+gitpython = "^3.1.43"
 isort = "^5.13.2"
 mypy = "^1.10.0"
 pre-commit = "^3.3.3"
 pylint = "^3.1.0"
+tomli = "^2.0.1"
+tomli-w = "^1.0.0"
+towncrier = "^23.11.0"
 tox = "^4.15.0"
 vulture = "^2.11"
 
@@ -108,6 +163,9 @@ sphinx-copybutton = "^0.5.2"
 sphinx-markdown-builder = ">=0.5.5,<0.7.0"
 templatest = "^0.10.1"
 
+[tool.poetry.group.flake8.dependencies]
+flake8 = "^7.1.0"
+
 [tool.poetry.group.tests.dependencies]
 pytest = "^8.2.0"
 pytest-benchmark = "^4.0.0"
@@ -117,6 +175,9 @@ pytest-sugar = "^1.0.0"
 pytest-xdist = "^3.6.1"
 templatest = "^0.10.1"
 
+[tool.poetry.plugins."flake8.extension"]
+SIG = "docsig.plugin:Docsig"
+
 [tool.poetry.scripts]
 docsig = "docsig.__main__:main"
 
@@ -149,3 +210,32 @@ norecursedirs = [
   ".pytest_cache",
   "docs"
 ]
+
+[tool.towncrier]
+directory = "changelog"
+filename = "CHANGELOG.md"
+issue_format = "[#{issue}](https://github.com/jshwi/docsig/issues/{issue})"
+package = "docsig"
+start_string = "<!-- release notes start -->\n"
+template = "changelog/_template.md"
+
+[tool.towncrier.fragment.add]
+name = "Added"
+
+[tool.towncrier.fragment.change]
+name = "Changed"
+
+[tool.towncrier.fragment.deprecate]
+name = "Deprecated"
+
+[tool.towncrier.fragment.fix]
+name = "Fixed"
+
+[tool.towncrier.fragment.hack]
+name = "Hacked"
+
+[tool.towncrier.fragment.remove]
+name = "Removed"
+
+[tool.towncrier.fragment.security]
+name = "Security"