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

[WIP] Pre-Commit: Docformatter #119

Closed
wants to merge 2 commits into from

Conversation

ax3l
Copy link
Member

@ax3l ax3l commented Mar 27, 2023

Testing docformatter to auto-format Function/Class docstrings according to numpy style.

Reference:

Alternatives to try:

@ax3l ax3l force-pushed the ci-docformatter branch 3 times, most recently from f791e41 to 732de4c Compare March 27, 2023 16:49
@ax3l ax3l mentioned this pull request Mar 27, 2023
@ax3l ax3l force-pushed the ci-docformatter branch 4 times, most recently from 8c49414 to 72d1cda Compare March 27, 2023 17:31
Add [docformatter](https://github.com/PyCQA/docformatter) to
auto-format Function/Class docstrings according to numpy style.

Reference:
- https://docformatter.readthedocs.io/en/latest/requirements.html#current-implementation
@ax3l ax3l force-pushed the ci-docformatter branch from 361b178 to c14751b Compare March 27, 2023 17:31
@ax3l
Copy link
Member Author

ax3l commented Mar 27, 2023

This tool seems to be quite new and has a nice interplay with black, which we use for our main Python code formatting.

The 1.5.1 version and even 1.6.0 version seem to not yet check styles such as numpy. Status:
https://docformatter.readthedocs.io/en/latest/requirements.html#exceptions-and-interpretations

@ax3l
Copy link
Member Author

ax3l commented Apr 17, 2023

Since PyCQA/docformatter#60 is still a far time out, we will go with #120 for now.

@ax3l ax3l closed this Apr 17, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant