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.
@@ -1,11 +1,11 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: docstring-format-checker
3
- Version: 0.5.0
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 :: 4 - Beta
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://github.com/data-science-extensions/docstring-format-checker/blob/main/README.md
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 = "v0.5.0"
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 :: 4 - Beta",
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://github.com/data-science-extensions/docstring-format-checker/blob/main/README.md"
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==1.*",
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==6.*",
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
- # Default configuration for docstring format checker
158
-
159
- [[tool.dfc.sections]]
160
- order = 1
161
- name = "summary"
162
- type = "free_text"
163
- admonition = "note"
164
- prefix = "!!!"
165
- required = true
166
-
167
- [[tool.dfc.sections]]
168
- order = 2
169
- name = "details"
170
- type = "free_text"
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.7.19,<0.8.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
- __version__ = "v0.5.0"
8
- __author__ = "Chris Mahoney"
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",