docsig 0.87.1__tar.gz → 0.89.0__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.
- {docsig-0.87.1 → docsig-0.89.0}/PKG-INFO +14 -8
- {docsig-0.87.1 → docsig-0.89.0}/README.rst +12 -6
- {docsig-0.87.1 → docsig-0.89.0}/docsig/_config.py +6 -7
- {docsig-0.87.1 → docsig-0.89.0}/docsig/_main.py +1 -1
- {docsig-0.87.1 → docsig-0.89.0}/docsig/_version.py +1 -1
- {docsig-0.87.1 → docsig-0.89.0}/pyproject.toml +15 -10
- {docsig-0.87.1 → docsig-0.89.0}/LICENSE +0 -0
- {docsig-0.87.1 → docsig-0.89.0}/LICENSES/SPHINX_LICENSE +0 -0
- {docsig-0.87.1 → docsig-0.89.0}/docsig/__init__.py +0 -0
- {docsig-0.87.1 → docsig-0.89.0}/docsig/__main__.py +0 -0
- {docsig-0.87.1 → docsig-0.89.0}/docsig/_check.py +0 -0
- {docsig-0.87.1 → docsig-0.89.0}/docsig/_core.py +0 -0
- {docsig-0.87.1 → docsig-0.89.0}/docsig/_decorators.py +0 -0
- {docsig-0.87.1 → docsig-0.89.0}/docsig/_directives.py +0 -0
- {docsig-0.87.1 → docsig-0.89.0}/docsig/_files.py +0 -0
- {docsig-0.87.1 → docsig-0.89.0}/docsig/_hooks.py +0 -0
- {docsig-0.87.1 → docsig-0.89.0}/docsig/_module.py +0 -0
- {docsig-0.87.1 → docsig-0.89.0}/docsig/_parsers.py +0 -0
- {docsig-0.87.1 → docsig-0.89.0}/docsig/_report.py +0 -0
- {docsig-0.87.1 → docsig-0.89.0}/docsig/_stub.py +0 -0
- {docsig-0.87.1 → docsig-0.89.0}/docsig/_utils.py +0 -0
- {docsig-0.87.1 → docsig-0.89.0}/docsig/_vendor/sphinx/ext/napoleon.py +0 -0
- {docsig-0.87.1 → docsig-0.89.0}/docsig/messages.py +0 -0
- {docsig-0.87.1 → docsig-0.89.0}/docsig/plugin/__init__.py +0 -0
- {docsig-0.87.1 → docsig-0.89.0}/docsig/plugin/_flake8.py +0 -0
- {docsig-0.87.1 → docsig-0.89.0}/docsig/plugin/_validate_pyproject.py +0 -0
- {docsig-0.87.1 → docsig-0.89.0}/docsig/py.typed +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: docsig
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.89.0
|
|
4
4
|
Summary: Check signature params for proper documentation
|
|
5
5
|
License-Expression: MIT
|
|
6
6
|
License-File: LICENSE
|
|
@@ -20,7 +20,7 @@ Classifier: Programming Language :: Python :: 3.14
|
|
|
20
20
|
Requires-Dist: astroid (>=4.0.2,<5.0.0)
|
|
21
21
|
Requires-Dist: pathspec (>=0.12.1,<1.2.0)
|
|
22
22
|
Requires-Dist: tomli (>=2.0.1,<3.0.0)
|
|
23
|
-
Requires-Dist: wcmatch (>=
|
|
23
|
+
Requires-Dist: wcmatch (>=10.2.1,<11.0.0)
|
|
24
24
|
Project-URL: Documentation, https://docsig.io/en/latest
|
|
25
25
|
Project-URL: Homepage, https://docsig.io
|
|
26
26
|
Project-URL: Repository, https://github.com/jshwi/docsig
|
|
@@ -35,7 +35,7 @@ Description-Content-Type: text/x-rst
|
|
|
35
35
|
|
|
36
36
|
|
|
|
37
37
|
|
|
38
|
-
|License| |PyPI| |Jetbrains Plugin| |CI| |Jetbrains Build| |CodeQL| |pre-commit.ci status| |codecov.io| |readthedocs.org| |python3.10| |Black| |isort| |pylint| |Security Status|
|
|
38
|
+
|License| |PyPI| |Jetbrains Plugin| |VS Code Extension| |CI| |Jetbrains Build| |VS Code Build| |CodeQL| |pre-commit.ci status| |codecov.io| |readthedocs.org| |python3.10| |Black| |isort| |pylint| |Security Status|
|
|
39
39
|
|
|
40
40
|
.. |License| image:: https://img.shields.io/badge/License-MIT-yellow.svg
|
|
41
41
|
:target: https://opensource.org/licenses/MIT
|
|
@@ -79,6 +79,12 @@ Description-Content-Type: text/x-rst
|
|
|
79
79
|
.. |Jetbrains Build| image:: https://github.com/jshwi/docsig/actions/workflows/build-intellij-plugin.yaml/badge.svg
|
|
80
80
|
:target: https://github.com/jshwi/docsig/actions/workflows/build-intellij-plugin.yaml
|
|
81
81
|
:alt: Build
|
|
82
|
+
.. |VS Code Build| image:: https://github.com/jshwi/docsig/actions/workflows/build-vscode-extension.yaml/badge.svg
|
|
83
|
+
:target: https://github.com/jshwi/docsig/actions/workflows/build-vscode-extension.yaml.yaml
|
|
84
|
+
:alt: Build
|
|
85
|
+
.. |VS Code Extension| image:: https://img.shields.io/badge/vscode%20extension-v1.0.0-007ACC
|
|
86
|
+
:target: https://marketplace.visualstudio.com/items?itemName=jshwi.docsig
|
|
87
|
+
:alt: VS Code Extension Version
|
|
82
88
|
|
|
83
89
|
Check Python signature params for proper documentation
|
|
84
90
|
-------------------------------------------------------
|
|
@@ -118,7 +124,7 @@ Commandline
|
|
|
118
124
|
[--check-property-returns] [--check-protected]
|
|
119
125
|
[--check-protected-class-methods] [--ignore-args] [--ignore-kwargs]
|
|
120
126
|
[--ignore-no-params] [-d LIST] [-t LIST] [-e PATTERN] [-E PATH [PATH ...]]
|
|
121
|
-
[-
|
|
127
|
+
[-i] [-s STR]
|
|
122
128
|
[path [path ...]]
|
|
123
129
|
|
|
124
130
|
Check signature params for proper documentation
|
|
@@ -154,7 +160,7 @@ Commandline
|
|
|
154
160
|
regular expression of files or dirs to exclude from checks
|
|
155
161
|
-E PATH [PATH ...], --excludes PATH [PATH ...]
|
|
156
162
|
path glob patterns to exclude from checks
|
|
157
|
-
-
|
|
163
|
+
-i, --include-ignored
|
|
158
164
|
check files even if they match a gitignore pattern
|
|
159
165
|
-s STR, --string STR string to parse instead of files
|
|
160
166
|
|
|
@@ -200,7 +206,7 @@ ensure your installation has registered `docsig`
|
|
|
200
206
|
.. code-block:: console
|
|
201
207
|
|
|
202
208
|
$ flake8 --version
|
|
203
|
-
7.3.0 (docsig: 0.
|
|
209
|
+
7.3.0 (docsig: 0.89.0, mccabe: 0.7.0, pycodestyle: 2.14.0, pyflakes: 3.4.0) CPython 3.10.19 on Darwin
|
|
204
210
|
|
|
205
211
|
And now use `flake8` to lint your files
|
|
206
212
|
|
|
@@ -286,7 +292,7 @@ Standalone
|
|
|
286
292
|
|
|
287
293
|
repos:
|
|
288
294
|
- repo: https://github.com/jshwi/docsig
|
|
289
|
-
rev: v0.
|
|
295
|
+
rev: v0.89.0
|
|
290
296
|
hooks:
|
|
291
297
|
- id: docsig
|
|
292
298
|
args:
|
|
@@ -305,7 +311,7 @@ or integrated with ``flake8``
|
|
|
305
311
|
hooks:
|
|
306
312
|
- id: flake8
|
|
307
313
|
additional_dependencies:
|
|
308
|
-
- docsig==0.
|
|
314
|
+
- docsig==0.89.0
|
|
309
315
|
args:
|
|
310
316
|
- "--sig-check-class"
|
|
311
317
|
- "--sig-check-dunders"
|
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
|
|
8
8
|
|
|
|
9
9
|
|
|
10
|
-
|License| |PyPI| |Jetbrains Plugin| |CI| |Jetbrains Build| |CodeQL| |pre-commit.ci status| |codecov.io| |readthedocs.org| |python3.10| |Black| |isort| |pylint| |Security Status|
|
|
10
|
+
|License| |PyPI| |Jetbrains Plugin| |VS Code Extension| |CI| |Jetbrains Build| |VS Code Build| |CodeQL| |pre-commit.ci status| |codecov.io| |readthedocs.org| |python3.10| |Black| |isort| |pylint| |Security Status|
|
|
11
11
|
|
|
12
12
|
.. |License| image:: https://img.shields.io/badge/License-MIT-yellow.svg
|
|
13
13
|
:target: https://opensource.org/licenses/MIT
|
|
@@ -51,6 +51,12 @@
|
|
|
51
51
|
.. |Jetbrains Build| image:: https://github.com/jshwi/docsig/actions/workflows/build-intellij-plugin.yaml/badge.svg
|
|
52
52
|
:target: https://github.com/jshwi/docsig/actions/workflows/build-intellij-plugin.yaml
|
|
53
53
|
:alt: Build
|
|
54
|
+
.. |VS Code Build| image:: https://github.com/jshwi/docsig/actions/workflows/build-vscode-extension.yaml/badge.svg
|
|
55
|
+
:target: https://github.com/jshwi/docsig/actions/workflows/build-vscode-extension.yaml.yaml
|
|
56
|
+
:alt: Build
|
|
57
|
+
.. |VS Code Extension| image:: https://img.shields.io/badge/vscode%20extension-v1.0.0-007ACC
|
|
58
|
+
:target: https://marketplace.visualstudio.com/items?itemName=jshwi.docsig
|
|
59
|
+
:alt: VS Code Extension Version
|
|
54
60
|
|
|
55
61
|
Check Python signature params for proper documentation
|
|
56
62
|
-------------------------------------------------------
|
|
@@ -90,7 +96,7 @@ Commandline
|
|
|
90
96
|
[--check-property-returns] [--check-protected]
|
|
91
97
|
[--check-protected-class-methods] [--ignore-args] [--ignore-kwargs]
|
|
92
98
|
[--ignore-no-params] [-d LIST] [-t LIST] [-e PATTERN] [-E PATH [PATH ...]]
|
|
93
|
-
[-
|
|
99
|
+
[-i] [-s STR]
|
|
94
100
|
[path [path ...]]
|
|
95
101
|
|
|
96
102
|
Check signature params for proper documentation
|
|
@@ -126,7 +132,7 @@ Commandline
|
|
|
126
132
|
regular expression of files or dirs to exclude from checks
|
|
127
133
|
-E PATH [PATH ...], --excludes PATH [PATH ...]
|
|
128
134
|
path glob patterns to exclude from checks
|
|
129
|
-
-
|
|
135
|
+
-i, --include-ignored
|
|
130
136
|
check files even if they match a gitignore pattern
|
|
131
137
|
-s STR, --string STR string to parse instead of files
|
|
132
138
|
|
|
@@ -172,7 +178,7 @@ ensure your installation has registered `docsig`
|
|
|
172
178
|
.. code-block:: console
|
|
173
179
|
|
|
174
180
|
$ flake8 --version
|
|
175
|
-
7.3.0 (docsig: 0.
|
|
181
|
+
7.3.0 (docsig: 0.89.0, mccabe: 0.7.0, pycodestyle: 2.14.0, pyflakes: 3.4.0) CPython 3.10.19 on Darwin
|
|
176
182
|
|
|
177
183
|
And now use `flake8` to lint your files
|
|
178
184
|
|
|
@@ -258,7 +264,7 @@ Standalone
|
|
|
258
264
|
|
|
259
265
|
repos:
|
|
260
266
|
- repo: https://github.com/jshwi/docsig
|
|
261
|
-
rev: v0.
|
|
267
|
+
rev: v0.89.0
|
|
262
268
|
hooks:
|
|
263
269
|
- id: docsig
|
|
264
270
|
args:
|
|
@@ -277,7 +283,7 @@ or integrated with ``flake8``
|
|
|
277
283
|
hooks:
|
|
278
284
|
- id: flake8
|
|
279
285
|
additional_dependencies:
|
|
280
|
-
- docsig==0.
|
|
286
|
+
- docsig==0.89.0
|
|
281
287
|
args:
|
|
282
288
|
- "--sig-check-class"
|
|
283
289
|
- "--sig-check-dunders"
|
|
@@ -168,17 +168,10 @@ def build_parser() -> _ArgumentParser:
|
|
|
168
168
|
help="check overridden methods",
|
|
169
169
|
dest="check_overridden",
|
|
170
170
|
)
|
|
171
|
-
parser.add_argument(
|
|
172
|
-
"-P",
|
|
173
|
-
action="store_true",
|
|
174
|
-
help=_argparse.SUPPRESS,
|
|
175
|
-
dest="check_property_returns",
|
|
176
|
-
)
|
|
177
171
|
parser.add_argument(
|
|
178
172
|
"--check-property-returns",
|
|
179
173
|
action="store_true",
|
|
180
174
|
help="check property return values",
|
|
181
|
-
dest="check_property_returns",
|
|
182
175
|
)
|
|
183
176
|
parser.add_argument(
|
|
184
177
|
"-p",
|
|
@@ -250,6 +243,12 @@ def build_parser() -> _ArgumentParser:
|
|
|
250
243
|
)
|
|
251
244
|
parser.add_argument(
|
|
252
245
|
"-I",
|
|
246
|
+
action="store_true",
|
|
247
|
+
help=_argparse.SUPPRESS,
|
|
248
|
+
dest="include_ignored",
|
|
249
|
+
)
|
|
250
|
+
parser.add_argument(
|
|
251
|
+
"-i",
|
|
253
252
|
"--include-ignored",
|
|
254
253
|
action="store_true",
|
|
255
254
|
help="check files even if they match a gitignore pattern",
|
|
@@ -16,11 +16,11 @@ from ._hooks import excepthook as _excepthook
|
|
|
16
16
|
|
|
17
17
|
def _warn_on_deprecated_short_flags() -> None:
|
|
18
18
|
deprecated_short_flags = {
|
|
19
|
+
"-I": "--include-ignored",
|
|
19
20
|
"-c": "--check-class",
|
|
20
21
|
"-D": "--check-dunders",
|
|
21
22
|
"-o": "--check-overridden",
|
|
22
23
|
"-p": "--check-protected",
|
|
23
|
-
"-P": "--check-property-returns",
|
|
24
24
|
}
|
|
25
25
|
raw_args = _sys.argv[1:]
|
|
26
26
|
expanded_flags = []
|
|
@@ -12,7 +12,7 @@ dependencies = [
|
|
|
12
12
|
"astroid (>=4.0.2,<5.0.0)",
|
|
13
13
|
"pathspec (>=0.12.1,<1.2.0)",
|
|
14
14
|
"tomli (>=2.0.1,<3.0.0)",
|
|
15
|
-
"wcmatch (>=
|
|
15
|
+
"wcmatch (>=10.2.1,<11.0.0)"
|
|
16
16
|
]
|
|
17
17
|
description = "Check signature params for proper documentation"
|
|
18
18
|
keywords = [
|
|
@@ -29,7 +29,7 @@ maintainers = [
|
|
|
29
29
|
name = "docsig"
|
|
30
30
|
readme = "README.rst"
|
|
31
31
|
requires-python = ">=3.10"
|
|
32
|
-
version = "0.
|
|
32
|
+
version = "0.89.0"
|
|
33
33
|
|
|
34
34
|
[project.entry-points."flake8.extension"]
|
|
35
35
|
SIG = "docsig.plugin:Flake8"
|
|
@@ -47,7 +47,7 @@ line-length = 79
|
|
|
47
47
|
allow_dirty = true
|
|
48
48
|
commit = true
|
|
49
49
|
commit_args = "-sS"
|
|
50
|
-
current_version = "0.
|
|
50
|
+
current_version = "0.89.0"
|
|
51
51
|
message = "bump: version {current_version} → {new_version}"
|
|
52
52
|
sign_tags = true
|
|
53
53
|
tag = true
|
|
@@ -96,6 +96,7 @@ omit = [
|
|
|
96
96
|
"docs/conf.py",
|
|
97
97
|
"docsig/__main__.py",
|
|
98
98
|
"docsig/_vendor/sphinx/ext/napoleon.py",
|
|
99
|
+
"tests/plugins/_gitignore.py",
|
|
99
100
|
"whitelist.py"
|
|
100
101
|
]
|
|
101
102
|
|
|
@@ -141,18 +142,18 @@ repository = "https://github.com/jshwi/docsig"
|
|
|
141
142
|
|
|
142
143
|
[tool.poetry.group.dev.dependencies]
|
|
143
144
|
black = ">=24.4.2,<27.0.0"
|
|
144
|
-
bump-my-version = ">=
|
|
145
|
+
bump-my-version = ">=1.4.1,<1.5.0"
|
|
145
146
|
deptry = ">=0.16.1,<0.26.0"
|
|
146
147
|
flynt = "^1.0.1"
|
|
147
148
|
gitpython = "^3.1.43"
|
|
148
149
|
isort = ">=5.13.2,<9.0.0"
|
|
149
150
|
mypy = ">=1.10,<3.0"
|
|
150
151
|
pre-commit = ">=3.3.3,<5.0.0"
|
|
151
|
-
pylint = "^4.0.
|
|
152
|
+
pylint = "^4.0.6"
|
|
152
153
|
tomli = "^2.0.1"
|
|
153
154
|
tomli-w = "^1.0.0"
|
|
154
155
|
towncrier = ">=23.11,<26.0"
|
|
155
|
-
tox = "^4.
|
|
156
|
+
tox = "^4.56.1"
|
|
156
157
|
validate-pyproject = {extras = ["all", "store"], version = "^0.25"}
|
|
157
158
|
vulture = "^2.11"
|
|
158
159
|
|
|
@@ -160,7 +161,7 @@ vulture = "^2.11"
|
|
|
160
161
|
Sphinx = ">=7,<8.2"
|
|
161
162
|
furo = ">=2024.4.27,<2026.0.0"
|
|
162
163
|
myst-parser = ">=3.0.1,<5.0.0"
|
|
163
|
-
pytest = "9.
|
|
164
|
+
pytest = "9.1.1"
|
|
164
165
|
pyyaml = "^6.0.1"
|
|
165
166
|
roman-numerals = "4.1.0"
|
|
166
167
|
sphinx-copybutton = "^0.5.2"
|
|
@@ -175,10 +176,9 @@ flake8 = "^7.1.0"
|
|
|
175
176
|
shiv = "^1.0.8"
|
|
176
177
|
|
|
177
178
|
[tool.poetry.group.tests.dependencies]
|
|
178
|
-
pytest = ">=
|
|
179
|
+
pytest = ">=9.1.1,<10.0"
|
|
179
180
|
pytest-benchmark = ">=4,<6"
|
|
180
181
|
pytest-cov = ">=5,<8"
|
|
181
|
-
pytest-gitignore = "^1.3"
|
|
182
182
|
pytest-randomly = ">=3.15,<5.0"
|
|
183
183
|
pytest-sugar = "^1.0.0"
|
|
184
184
|
pytest-xdist = "^3.6.1"
|
|
@@ -202,6 +202,7 @@ addopts = [
|
|
|
202
202
|
"--color=yes",
|
|
203
203
|
"--cov-report=term-missing",
|
|
204
204
|
"--durations=5",
|
|
205
|
+
"-p _gitignore",
|
|
205
206
|
"-vv"
|
|
206
207
|
]
|
|
207
208
|
filterwarnings = "ignore::DeprecationWarning"
|
|
@@ -215,6 +216,9 @@ norecursedirs = [
|
|
|
215
216
|
".pytest_cache",
|
|
216
217
|
"docs"
|
|
217
218
|
]
|
|
219
|
+
pythonpath = [
|
|
220
|
+
"tests/plugins"
|
|
221
|
+
]
|
|
218
222
|
|
|
219
223
|
[tool.towncrier]
|
|
220
224
|
directory = "changelog"
|
|
@@ -252,7 +256,8 @@ name = "Security"
|
|
|
252
256
|
exclude = [
|
|
253
257
|
"_vendor",
|
|
254
258
|
"tests/base_test.py",
|
|
255
|
-
"tests/conftest.py"
|
|
259
|
+
"tests/conftest.py",
|
|
260
|
+
"tests/plugin"
|
|
256
261
|
]
|
|
257
262
|
make_whitelist = true
|
|
258
263
|
paths = [
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|