Collection of useful checks for Django Checks Framework
Project description
Django Extra Checks
Useful checks for Django Checks Frameworks
Settings
To enable some check define EXTRA_CHECKS
setting with a dict of checks and its settings:
EXTRA_CHECKS = {
"checks": [
# require non empty `upload_to` argument.
"field-file-upload-to",
# use dict form if check need configuration
# eg. all models must have fk to Site model
{"id": "model-attribute", "attrs": ["site"]},
# require `db_table` for all models, increase level to CRITICAL
{"id": "model-meta-attribute", "attrs": ["db_table"], "level": "CRITICAL"},
]
}
By default only your project apps are checked but you can use
include_apps
option to specify apps to check (including third party apps):
EXTRA_CHECKS = {
# use same names as in INSTALLED_APPS
"include_apps": ["django.contrib.sites", "my_app"],
...
}
Ignoring check problems
To ignore all warnings on some object you can use ignore_checks
decorator:
from extra_checks import ignore_checks, CheckID
@ignore_checks("model-attribute", "X011", CheckID.X050)
class MyModel(models.Model):
image = models.ImageField()
Another way is to specify type of the object that need to be ignored in ignore_types
option:
EXTRA_CHECKS = {
"check": [
{
"id": "field-verbose-name-gettext",
# make this check skip wagtail's StreamField
"ignore_types": ["wagtail.core.fields.StreamField"],
}
]
}
Checks
Models
- extra-checks-config - settings.EXTRA_CHECKS is valid config for django-extra-checks (always enabled).
- model-attribute - Each Model in the project must have all attributes from
attrs
setting specified. - model-meta-attribute - Each Model.Meta in the project must have all attributes from
attrs
setting specified. - model-admin - Each model must be registered in admin.
- field-file-upload-to - FileField/ImageField must have non empty
upload_to
argument. - field-verbose-name - All model's fields must have verbose name.
- field-verbose-name-gettext - verbose_name must use gettext.
- field-verbose-name-gettext-case - Words in text wrapped with gettext must be in one case.
- field-help-text-gettext - help_text must use gettext.
- field-text-null - text fields shoudn't use
null=True
. - field-boolean-null - prefer using
BooleanField(null=True)
instead ofNullBooleanField
. - field-null - don't pass
null=False
to model fields (this is django default). - field-foreign-key-index - ForeignKey fields must specify
db_index
explicitly (to apply to unique together only:when: unique_together
). - field-default-null - If field nullable (
null=True
), thendefault=None
argument is redundant and should be removed. WARNING Be aware that setting is database dependent, eg. Oracle interprets empty strings as nulls as a result django uses empty string instead of null as default.
DRF Serializers
- drf-model-serializer-extra-kwargs - ModelSerializer's extra_kwargs must not include fields that specified on serializer.
- drf-model-serializer-meta-attribute - Each ModelSerializer.Meta must have all attributes specified in
attrs
, use case.
Development
Install dev deps in virtualenv pip install -e .[dev]
.
Credits
The project was built using ideas and code snippets from:
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
django-extra-checks-0.6.0.tar.gz
(21.3 kB
view hashes)
Built Distribution
Close
Hashes for django-extra-checks-0.6.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | c906a7fd3c68dc657815aaa107f8bfdc59fffd01082bca8c446ebf56ceb1ad85 |
|
MD5 | e49c76e27739641f612b8b1ab297114e |
|
BLAKE2b-256 | fe3751613b150a3c3fae3435f5ad110729b375de2bda1486adc0f217bd602a03 |
Close
Hashes for django_extra_checks-0.6.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ebb8b38a90447cfd83c292df42ed1b0e3f482702eaa0dccfbda7a97d46dbcc42 |
|
MD5 | 269536c1a655e10fa70cafdbab56dd5e |
|
BLAKE2b-256 | 9b9467384c0b2496177d58cd208dabceac50df6d7c114021211fbed6b84a23aa |