-
Notifications
You must be signed in to change notification settings - Fork 2
Fix flake8-docstring warnings #31
Conversation
* The first line should be in imperative mood.
* Avoid possibility that __all__ can be mutated confusing flake8-docstrings
* The first line should end with a full stop.
* Omit docstrings for setUp methods in TestCases * D102: Public method docstring missing. * D102: Public function docstring missing.
conman/nav_tree/tests/test_models.py
Outdated
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
..."includes its url."
|
Thanks again for this |
Disable flake8 warnings for D100, D203 and D204 * D100: Module docstring missing. * D203: 1 blank line required before class docstring. * D204: 1 blank line required after class docstring.
* D200: One-line docstrings should fit on one line with quotes.
* Omit docstrings for test classes. * D101: Public class docstring missing.
* Allow use of flake8-docstrings locally without causing travis build failures.
docstring_requirements.txt
Outdated
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@meshy What do you think of the idea of adding flake8-docstrings in a separate requirements file? This way we can run the docstring checks while developing, but don't need to worry about D101, D102 and D103 (missing docstrings) in travis runs.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Perhaps it would be better to add it to the normal test_requirements, and remove it for travis?
|
@meshy Review? |
Conflicts: conman/redirects/tests/factories.py
de74d92 to
ffe3196
Compare
* Explicitly remove flake8-docstrings from travis builds
ffe3196 to
9f60edc
Compare
conman/cms/urls.py
Outdated
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This seems to be something of a repetition.
|
Awesome work, Ian, thanks very much! I'll make sure to install the plugin, and to try not to introduce any more of these |
|
Heh! |
Related to #30.