Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[pydoclint] Extend docstring-missing-exception to empty exception descriptions (DOC501) #14496

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

sbrugman
Copy link
Contributor

Summary

Resolves #14494.

Test Plan

cargo test. Awaiting ecosystem checks.

Copy link
Contributor

ruff-ecosystem results

Linter (stable)

✅ ecosystem check detected no linter changes.

Linter (preview)

ℹ️ ecosystem check detected linter changes. (+2 -0 violations, +0 -0 fixes in 1 projects; 53 projects unchanged)

bokeh/bokeh (+2 -0 violations, +0 -0 fixes)

ruff check --no-cache --exit-zero --ignore RUF9 --output-format concise --preview --select ALL

+ src/bokeh/client/util.py:41:5: DOC501 Raised exception `ValueError` missing from docstring
+ src/bokeh/client/util.py:68:5: DOC501 Raised exception `ValueError` missing from docstring

Changes by rule (1 rules affected)

code total + violation - violation + fix - fix
DOC501 2 2 0 0 0

@MichaReiser
Copy link
Member

Let's wait with merging this until after the 0.8 release

@MichaReiser MichaReiser added the rule Implementing or modifying a lint rule label Nov 20, 2024
@sbrugman
Copy link
Contributor Author

Bokeh is a false positive. They use google-style, but start exception descriptions on a newline.

@sbrugman
Copy link
Contributor Author

Reference that newlines are valid after the colon in Google-style docstrings: https://google.github.io/styleguide/pyguide.html#doc-function-args

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
rule Implementing or modifying a lint rule
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Extend docstring-missing-exception to empty exception description (DOC501)
2 participants