Skip to content
This repository was archived by the owner on Nov 3, 2023. It is now read-only.

Extend support for detecting missing arguments in Numpy style docstrings #407

Merged
merged 5 commits into from
Oct 23, 2019

Conversation

sambhav
Copy link
Member

@sambhav sambhav commented Sep 21, 2019

Thanks for submitting a PR!

Please make sure to check for the following items:

  • Add unit tests and integration tests where applicable.
    If you've added an error code or changed an error code behavior,
    you should probably add or change a test case file under tests/test_cases/ and add
    it to the list under tests/test_definitions.py.
    If you've added or changed a command line option,
    you should probably add or change a test in tests/test_integration.py.
  • Add a line to the release notes (docs/release_notes.rst) under "Current Development Version".
    Make sure to include the PR number after you open and get one.

Please don't get discouraged as it may take a while to get a review.

@sambhav sambhav force-pushed the numpy-arg-check branch 2 times, most recently from 1e1aec5 to b0248e7 Compare September 21, 2019 17:12
@sambhav
Copy link
Member Author

sambhav commented Sep 21, 2019

@Nurdok review please :)

@sambhav sambhav changed the title Numpy arg check Extend support for detecting missing arguments in Numpy style docstrings Sep 21, 2019
@sambhav
Copy link
Member Author

sambhav commented Sep 28, 2019

@Nurdok ping.

@sambhav sambhav force-pushed the numpy-arg-check branch 2 times, most recently from 24e263a to 30c5d33 Compare October 13, 2019 09:22
@sambhav
Copy link
Member Author

sambhav commented Oct 13, 2019

@Nurdok addressed comments :)

@sambhav sambhav requested a review from Nurdok October 13, 2019 09:29
@sambhav
Copy link
Member Author

sambhav commented Oct 16, 2019

@Nurdok ping

@Nurdok
Copy link
Member

Nurdok commented Oct 21, 2019

Thanks for this @samj1912. Sorry for the delayed response, I've been out on a family vacation. Please update branch so I can merge.

@sambhav
Copy link
Member Author

sambhav commented Oct 21, 2019

@Nurdok done

Google docstrings should document their arguments in the Args section
not the Parameters section.

See http://google.github.io/styleguide/pyguide.html#38-comments-and-docstrings
Fixes PyCQA#394

This adds support for checking missing arguments in Numpy docstrings.
D417 is raised even if that parameter is present in the docstring,
but has an empty description.
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants