Skip to content
This repository was archived by the owner on Sep 20, 2024. It is now read-only.

Flake 8 plugin that checks docstrings for Django models

License

Notifications You must be signed in to change notification settings

Saritasa/flake8-django-docstrings

Folders and files

NameName
Last commit message
Last commit date

Latest commit

b5a80d8 · Feb 21, 2020

History

13 Commits
Feb 21, 2020
Feb 13, 2020
Feb 13, 2020
Feb 10, 2020
Feb 5, 2020
Feb 10, 2020
Feb 21, 2020
Feb 21, 2020
Feb 13, 2020
Feb 21, 2020
Feb 13, 2020

Repository files navigation

GitHub Workflow Status

Flake 8 plugin that checks docstrings for Django models

It will show code style errors in this cases:

  • Model class doesn't have docstring at all
  • Model class's docstring doesn't describes model's fields
  • Model class's proprieties doesn't have docstrings

Error codes:

  • DMD1 - Model class doesn't have docstring at all
  • DMD2 - Model class's docstring doesn't describes model's fields. They should be described like this: field_name (type): description
  • DMD3 - Model class's proprieties doesn't have docstrings

Developing

First you need to install all needed dependencies for development:

pip install -r development.txt 

To install plugin into your current environment:

pip install .

If you are working with PyCharm, this plugin might be useful pytest-pycharm

To fully check your code with style check run this:

pytest --isort --flake8

To just fo style check run this:

pytest --isort --flake8 -m "isort or flake8"

To test your code against different versions of python run:

tox

Note: they must be installed(you can do it by pyenv)

If want ot specify version of python:

tox -e py35

To run in parallel:

tox --parallel auto

About

Flake 8 plugin that checks docstrings for Django models

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages