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.
Files changed (27) hide show
  1. {docsig-0.87.1 → docsig-0.89.0}/PKG-INFO +14 -8
  2. {docsig-0.87.1 → docsig-0.89.0}/README.rst +12 -6
  3. {docsig-0.87.1 → docsig-0.89.0}/docsig/_config.py +6 -7
  4. {docsig-0.87.1 → docsig-0.89.0}/docsig/_main.py +1 -1
  5. {docsig-0.87.1 → docsig-0.89.0}/docsig/_version.py +1 -1
  6. {docsig-0.87.1 → docsig-0.89.0}/pyproject.toml +15 -10
  7. {docsig-0.87.1 → docsig-0.89.0}/LICENSE +0 -0
  8. {docsig-0.87.1 → docsig-0.89.0}/LICENSES/SPHINX_LICENSE +0 -0
  9. {docsig-0.87.1 → docsig-0.89.0}/docsig/__init__.py +0 -0
  10. {docsig-0.87.1 → docsig-0.89.0}/docsig/__main__.py +0 -0
  11. {docsig-0.87.1 → docsig-0.89.0}/docsig/_check.py +0 -0
  12. {docsig-0.87.1 → docsig-0.89.0}/docsig/_core.py +0 -0
  13. {docsig-0.87.1 → docsig-0.89.0}/docsig/_decorators.py +0 -0
  14. {docsig-0.87.1 → docsig-0.89.0}/docsig/_directives.py +0 -0
  15. {docsig-0.87.1 → docsig-0.89.0}/docsig/_files.py +0 -0
  16. {docsig-0.87.1 → docsig-0.89.0}/docsig/_hooks.py +0 -0
  17. {docsig-0.87.1 → docsig-0.89.0}/docsig/_module.py +0 -0
  18. {docsig-0.87.1 → docsig-0.89.0}/docsig/_parsers.py +0 -0
  19. {docsig-0.87.1 → docsig-0.89.0}/docsig/_report.py +0 -0
  20. {docsig-0.87.1 → docsig-0.89.0}/docsig/_stub.py +0 -0
  21. {docsig-0.87.1 → docsig-0.89.0}/docsig/_utils.py +0 -0
  22. {docsig-0.87.1 → docsig-0.89.0}/docsig/_vendor/sphinx/ext/napoleon.py +0 -0
  23. {docsig-0.87.1 → docsig-0.89.0}/docsig/messages.py +0 -0
  24. {docsig-0.87.1 → docsig-0.89.0}/docsig/plugin/__init__.py +0 -0
  25. {docsig-0.87.1 → docsig-0.89.0}/docsig/plugin/_flake8.py +0 -0
  26. {docsig-0.87.1 → docsig-0.89.0}/docsig/plugin/_validate_pyproject.py +0 -0
  27. {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.87.1
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 (>=8.5.2,<11.0.0)
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
- [-I] [-s STR]
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
- -I, --include-ignored
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.87.1, mccabe: 0.7.0, pycodestyle: 2.14.0, pyflakes: 3.4.0) CPython 3.10.19 on Darwin
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.87.1
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.87.1
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
- [-I] [-s STR]
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
- -I, --include-ignored
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.87.1, mccabe: 0.7.0, pycodestyle: 2.14.0, pyflakes: 3.4.0) CPython 3.10.19 on Darwin
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.87.1
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.87.1
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 = []
@@ -8,4 +8,4 @@ Allows for access to the version internally without cyclic imports
8
8
  caused by accessing it through __init__.
9
9
  """
10
10
 
11
- __version__ = "0.87.1"
11
+ __version__ = "0.89.0"
@@ -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 (>=8.5.2,<11.0.0)"
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.87.1"
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.87.1"
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 = ">=0.24.1,<1.4.0"
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.4"
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.15.0"
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.0.3"
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 = ">=8.2,<10.0"
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