docstring-format-checker 0.5.0__tar.gz → 1.6.3__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {docstring_format_checker-0.5.0 → docstring_format_checker-1.6.3}/PKG-INFO +5 -3
- {docstring_format_checker-0.5.0 → docstring_format_checker-1.6.3}/pyproject.toml +50 -63
- {docstring_format_checker-0.5.0 → docstring_format_checker-1.6.3}/src/docstring_format_checker/__init__.py +8 -4
- docstring_format_checker-1.6.3/src/docstring_format_checker/cli.py +935 -0
- {docstring_format_checker-0.5.0 → docstring_format_checker-1.6.3}/src/docstring_format_checker/config.py +230 -54
- docstring_format_checker-1.6.3/src/docstring_format_checker/core.py +2034 -0
- docstring_format_checker-1.6.3/src/docstring_format_checker/utils/exceptions.py +103 -0
- docstring_format_checker-0.5.0/src/docstring_format_checker/cli.py +0 -648
- docstring_format_checker-0.5.0/src/docstring_format_checker/core.py +0 -983
- docstring_format_checker-0.5.0/src/docstring_format_checker/utils/exceptions.py +0 -39
- {docstring_format_checker-0.5.0 → docstring_format_checker-1.6.3}/README.md +0 -0
- {docstring_format_checker-0.5.0 → docstring_format_checker-1.6.3}/src/docstring_format_checker/utils/__init__.py +0 -0
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: docstring-format-checker
|
|
3
|
-
Version:
|
|
3
|
+
Version: 1.6.3
|
|
4
4
|
Summary: A CLI tool to check and validate Python docstring formatting and completeness
|
|
5
5
|
Author: Chris Mahoney
|
|
6
6
|
Author-email: Chris Mahoney <docstring-format-checker@data-science-extensions.com>
|
|
7
7
|
License-Expression: MIT
|
|
8
|
-
Classifier: Development Status ::
|
|
8
|
+
Classifier: Development Status :: 5 - Production/Stable
|
|
9
9
|
Classifier: License :: OSI Approved :: MIT License
|
|
10
10
|
Classifier: Topic :: Software Development :: Quality Assurance
|
|
11
11
|
Classifier: Topic :: Software Development :: Libraries :: Python Modules
|
|
@@ -17,17 +17,19 @@ Classifier: Programming Language :: Python :: 3.10
|
|
|
17
17
|
Classifier: Programming Language :: Python :: 3.11
|
|
18
18
|
Classifier: Programming Language :: Python :: 3.12
|
|
19
19
|
Classifier: Programming Language :: Python :: 3.13
|
|
20
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
20
21
|
Classifier: Intended Audience :: Developers
|
|
21
22
|
Classifier: Environment :: Console
|
|
22
23
|
Requires-Dist: typer>=0.9.0
|
|
23
24
|
Requires-Dist: tomli>=2.0.0 ; python_full_version < '3.11'
|
|
24
25
|
Requires-Dist: rich>=13.0.0
|
|
25
26
|
Requires-Dist: toolbox-python==1.*
|
|
27
|
+
Requires-Dist: pyfiglet==1.*
|
|
26
28
|
Maintainer: Chris Mahoney
|
|
27
29
|
Maintainer-email: Chris Mahoney <docstring-format-checker@data-science-extensions.com>
|
|
28
30
|
Requires-Python: >=3.9
|
|
29
31
|
Project-URL: Changelog, https://github.com/data-science-extensions/docstring-format-checker/releases
|
|
30
|
-
Project-URL: Documentation, https://
|
|
32
|
+
Project-URL: Documentation, https://data-science-extensions.com/toolboxes/docstring-format-checker/latest/code/
|
|
31
33
|
Project-URL: Homepage, https://github.com/data-science-extensions/docstring-format-checker
|
|
32
34
|
Project-URL: Issues, https://github.com/data-science-extensions/docstring-format-checker/issues
|
|
33
35
|
Project-URL: Repository, https://github.com/data-science-extensions/docstring-format-checker
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
[project]
|
|
2
2
|
name = "docstring-format-checker"
|
|
3
|
-
version = "
|
|
3
|
+
version = "1.6.3"
|
|
4
4
|
description = "A CLI tool to check and validate Python docstring formatting and completeness"
|
|
5
5
|
readme = "README.md"
|
|
6
6
|
license = "MIT"
|
|
@@ -11,7 +11,7 @@ maintainers = [
|
|
|
11
11
|
{ name="Chris Mahoney", email="docstring-format-checker@data-science-extensions.com" },
|
|
12
12
|
]
|
|
13
13
|
classifiers = [
|
|
14
|
-
"Development Status ::
|
|
14
|
+
"Development Status :: 5 - Production/Stable",
|
|
15
15
|
"License :: OSI Approved :: MIT License",
|
|
16
16
|
"Topic :: Software Development :: Quality Assurance",
|
|
17
17
|
"Topic :: Software Development :: Libraries :: Python Modules",
|
|
@@ -23,6 +23,7 @@ classifiers = [
|
|
|
23
23
|
"Programming Language :: Python :: 3.11",
|
|
24
24
|
"Programming Language :: Python :: 3.12",
|
|
25
25
|
"Programming Language :: Python :: 3.13",
|
|
26
|
+
"Programming Language :: Python :: 3.14",
|
|
26
27
|
"Intended Audience :: Developers",
|
|
27
28
|
"Environment :: Console",
|
|
28
29
|
]
|
|
@@ -32,11 +33,12 @@ dependencies = [
|
|
|
32
33
|
"tomli>=2.0.0;python_version<'3.11'",
|
|
33
34
|
"rich>=13.0.0",
|
|
34
35
|
"toolbox-python==1.*",
|
|
36
|
+
"pyfiglet==1.*",
|
|
35
37
|
]
|
|
36
38
|
|
|
37
39
|
[project.urls]
|
|
38
40
|
Homepage = "https://github.com/data-science-extensions/docstring-format-checker"
|
|
39
|
-
Documentation = "https://
|
|
41
|
+
Documentation = "https://data-science-extensions.com/toolboxes/docstring-format-checker/latest/code/"
|
|
40
42
|
Repository = "https://github.com/data-science-extensions/docstring-format-checker"
|
|
41
43
|
Changelog = "https://github.com/data-science-extensions/docstring-format-checker/releases"
|
|
42
44
|
Issues = "https://github.com/data-science-extensions/docstring-format-checker/issues"
|
|
@@ -66,7 +68,7 @@ docs = [
|
|
|
66
68
|
"mike==2.*",
|
|
67
69
|
"mkdocs==1.*",
|
|
68
70
|
"mkdocs-autorefs==1.*",
|
|
69
|
-
"mkdocs-coverage==
|
|
71
|
+
"mkdocs-coverage==2.*",
|
|
70
72
|
"mkdocs-material==9.*",
|
|
71
73
|
"mkdocstrings==0.*",
|
|
72
74
|
"mkdocstrings-python==1.*",
|
|
@@ -77,11 +79,12 @@ test = [
|
|
|
77
79
|
"parameterized==0.*",
|
|
78
80
|
"pytest==8.*",
|
|
79
81
|
"pytest-clarity==1.*",
|
|
80
|
-
"pytest-cov==
|
|
82
|
+
"pytest-cov==7.*",
|
|
81
83
|
"pytest-icdiff==0.*",
|
|
82
84
|
"pytest-sugar==1.*",
|
|
83
85
|
"pytest-xdist==3.*",
|
|
84
86
|
"requests==2.*",
|
|
87
|
+
"complexipy==4.*",
|
|
85
88
|
]
|
|
86
89
|
|
|
87
90
|
[tool.black]
|
|
@@ -146,6 +149,33 @@ lines_after_imports = 2
|
|
|
146
149
|
[tool.codespell]
|
|
147
150
|
ignore-words-list = "demog"
|
|
148
151
|
|
|
152
|
+
[tool.pylint.main]
|
|
153
|
+
disable = [
|
|
154
|
+
"C0103", # invalid-name
|
|
155
|
+
"C0301", # line-too-long
|
|
156
|
+
"C0302", # too-many-lines
|
|
157
|
+
"R0913", # too-many-arguments
|
|
158
|
+
"R0914", # too-many-locals
|
|
159
|
+
"R0915", # too-many-statements
|
|
160
|
+
"R0917", # too-many-positional-arguments
|
|
161
|
+
"R1705", # no-else-return
|
|
162
|
+
"R1724", # no-else-continue
|
|
163
|
+
"W0107", # unnecessary-pass
|
|
164
|
+
"W0212", # protected-access
|
|
165
|
+
"W0612", # unused-variable
|
|
166
|
+
"W0613", # unused-argument
|
|
167
|
+
"W0622", # redefined-builtin
|
|
168
|
+
"W0718", # broad-exception-caught
|
|
169
|
+
]
|
|
170
|
+
|
|
171
|
+
[tool.complexipy]
|
|
172
|
+
paths = "src/docstring_format_checker"
|
|
173
|
+
max-complexity-allowed = 13
|
|
174
|
+
quiet = false
|
|
175
|
+
ignore-complexity = false
|
|
176
|
+
details = "low"
|
|
177
|
+
sort = "asc"
|
|
178
|
+
|
|
149
179
|
[tool.bump_version.replacements]
|
|
150
180
|
files = [
|
|
151
181
|
{ file = "src/docstring_format_checker/__init__.py", pattern = "__version__ = \"{VERSION}\"" },
|
|
@@ -154,64 +184,21 @@ files = [
|
|
|
154
184
|
]
|
|
155
185
|
|
|
156
186
|
[tool.dfc]
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
required =
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
order =
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
admonition = "info"
|
|
172
|
-
prefix = "???+"
|
|
173
|
-
required = false
|
|
174
|
-
|
|
175
|
-
[[tool.dfc.sections]]
|
|
176
|
-
order = 3
|
|
177
|
-
name = "params"
|
|
178
|
-
type = "list_name_and_type"
|
|
179
|
-
required = true
|
|
180
|
-
|
|
181
|
-
[[tool.dfc.sections]]
|
|
182
|
-
order = 4
|
|
183
|
-
name = "returns"
|
|
184
|
-
type = "list_name_and_type"
|
|
185
|
-
required = false
|
|
186
|
-
|
|
187
|
-
[[tool.dfc.sections]]
|
|
188
|
-
order = 5
|
|
189
|
-
name = "yields"
|
|
190
|
-
type = "list_type"
|
|
191
|
-
required = false
|
|
192
|
-
|
|
193
|
-
[[tool.dfc.sections]]
|
|
194
|
-
order = 6
|
|
195
|
-
name = "raises"
|
|
196
|
-
type = "list_type"
|
|
197
|
-
required = false
|
|
198
|
-
|
|
199
|
-
[[tool.dfc.sections]]
|
|
200
|
-
order = 7
|
|
201
|
-
name = "examples"
|
|
202
|
-
type = "free_text"
|
|
203
|
-
admonition = "example"
|
|
204
|
-
prefix = "???+"
|
|
205
|
-
required = false
|
|
206
|
-
|
|
207
|
-
[[tool.dfc.sections]]
|
|
208
|
-
order = 8
|
|
209
|
-
name = "notes"
|
|
210
|
-
type = "free_text"
|
|
211
|
-
admonition = "note"
|
|
212
|
-
prefix = "???"
|
|
213
|
-
required = false
|
|
187
|
+
allow_undefined_sections = false
|
|
188
|
+
require_docstrings = true
|
|
189
|
+
check_private = true
|
|
190
|
+
validate_param_types = true
|
|
191
|
+
sections = [
|
|
192
|
+
{ order=1, name="summary", type="free_text", required=true, admonition="note", prefix="!!!" },
|
|
193
|
+
{ order=2, name="details", type="free_text", required=false, admonition="abstract", prefix="???+" },
|
|
194
|
+
{ order=3, name="params", type="list_name_and_type", required=false, admonition=false },
|
|
195
|
+
{ order=4, name="raises", type="list_type", required=false, admonition=false },
|
|
196
|
+
{ order=5, name="returns", type="list_name_and_type", required=false, admonition=false },
|
|
197
|
+
{ order=6, name="yields", type="list_type", required=false, admonition=false },
|
|
198
|
+
{ order=7, name="examples", type="free_text", required=false, admonition="example", prefix="???+" },
|
|
199
|
+
{ order=8, name="notes", type="free_text", required=false, admonition="note", prefix="???" },
|
|
200
|
+
]
|
|
214
201
|
|
|
215
202
|
[build-system]
|
|
216
|
-
requires = ["uv_build>=0.
|
|
203
|
+
requires = ["uv_build>=0.8.17,<0.9.0"]
|
|
217
204
|
build-backend = "uv_build"
|
|
@@ -4,16 +4,20 @@ Docstring Format Checker.
|
|
|
4
4
|
A CLI tool to check and validate Python docstring formatting and completeness.
|
|
5
5
|
"""
|
|
6
6
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
__email__ = "docstring-format-checker@data-science-extensions.com"
|
|
10
|
-
|
|
7
|
+
# ## Python StdLib Imports ----
|
|
8
|
+
from importlib.metadata import metadata
|
|
11
9
|
|
|
12
10
|
# ## Local First Party Imports ----
|
|
13
11
|
from docstring_format_checker.config import DEFAULT_CONFIG, load_config
|
|
14
12
|
from docstring_format_checker.core import DocstringChecker, SectionConfig
|
|
15
13
|
|
|
16
14
|
|
|
15
|
+
_metadata = metadata("docstring-format-checker")
|
|
16
|
+
__name__: str = _metadata["Name"]
|
|
17
|
+
__version__: str = _metadata["Version"]
|
|
18
|
+
__author__: str = _metadata["Author"]
|
|
19
|
+
__email__: str = _metadata.get("Email", "")
|
|
20
|
+
|
|
17
21
|
__all__: list[str] = [
|
|
18
22
|
"DocstringChecker",
|
|
19
23
|
"SectionConfig",
|