|
1
|
|
|
from __future__ import unicode_literals |
|
2
|
|
|
|
|
3
|
|
|
from django import __version__ as django__version__, VERSION as django_version |
|
4
|
|
|
from django.apps import AppConfig |
|
5
|
|
|
from django.conf import settings |
|
6
|
|
|
from django.core.checks import register, Tags, Warning, Error |
|
7
|
|
|
from cachalot.utils import ITERABLES |
|
8
|
|
|
|
|
9
|
|
|
from .settings import ( |
|
10
|
|
|
cachalot_settings, SUPPORTED_CACHE_BACKENDS, SUPPORTED_DATABASE_ENGINES, |
|
11
|
|
|
SUPPORTED_ONLY) |
|
12
|
|
|
|
|
13
|
|
|
|
|
14
|
|
|
@register(Tags.compatibility) |
|
15
|
|
|
def check_django_version(app_configs, **kwargs): |
|
16
|
|
|
if not (1, 11) <= django_version < (2, 1): |
|
17
|
|
|
return [Error( |
|
18
|
|
|
'Django %s is not compatible with this version of django-cachalot.' |
|
19
|
|
|
% django__version__, |
|
20
|
|
|
hint='Refer to the django-cachalot documentation to find ' |
|
21
|
|
|
'which versions are compatible.', |
|
22
|
|
|
id='cachalot.E003')] |
|
23
|
|
|
return [] |
|
24
|
|
|
|
|
25
|
|
|
|
|
26
|
|
|
@register(Tags.caches, Tags.compatibility) |
|
27
|
|
|
def check_cache_compatibility(app_configs, **kwargs): |
|
28
|
|
|
cache = settings.CACHES[cachalot_settings.CACHALOT_CACHE] |
|
29
|
|
|
cache_backend = cache['BACKEND'] |
|
30
|
|
|
if cache_backend not in SUPPORTED_CACHE_BACKENDS: |
|
31
|
|
|
return [Warning( |
|
32
|
|
|
'Cache backend %r is not supported by django-cachalot.' |
|
33
|
|
|
% cache_backend, |
|
34
|
|
|
hint='Switch to a supported cache backend ' |
|
35
|
|
|
'like Redis or Memcached.', |
|
36
|
|
|
id='cachalot.W001')] |
|
37
|
|
|
return [] |
|
38
|
|
|
|
|
39
|
|
|
|
|
40
|
|
|
@register(Tags.database, Tags.compatibility) |
|
41
|
|
|
def check_databases_compatibility(app_configs, **kwargs): |
|
42
|
|
|
errors = [] |
|
43
|
|
|
databases = settings.DATABASES |
|
44
|
|
|
original_enabled_databases = getattr(settings, 'CACHALOT_DATABASES', |
|
45
|
|
|
SUPPORTED_ONLY) |
|
46
|
|
|
enabled_databases = cachalot_settings.CACHALOT_DATABASES |
|
47
|
|
|
if original_enabled_databases == SUPPORTED_ONLY: |
|
48
|
|
|
if not cachalot_settings.CACHALOT_DATABASES: |
|
49
|
|
|
errors.append(Warning( |
|
50
|
|
|
'None of the configured databases are supported ' |
|
51
|
|
|
'by django-cachalot.', |
|
52
|
|
|
hint='Use a supported database, or remove django-cachalot, or ' |
|
53
|
|
|
'put at least one database alias in `CACHALOT_DATABASES` ' |
|
54
|
|
|
'to force django-cachalot to use it.', |
|
55
|
|
|
id='cachalot.W002' |
|
56
|
|
|
)) |
|
57
|
|
|
elif enabled_databases.__class__ in ITERABLES: |
|
58
|
|
|
for db_alias in enabled_databases: |
|
59
|
|
|
if db_alias in databases: |
|
60
|
|
|
engine = databases[db_alias]['ENGINE'] |
|
61
|
|
|
if engine not in SUPPORTED_DATABASE_ENGINES: |
|
62
|
|
|
errors.append(Warning( |
|
63
|
|
|
'Database engine %r is not supported ' |
|
64
|
|
|
'by django-cachalot.' % engine, |
|
65
|
|
|
hint='Switch to a supported database engine.', |
|
66
|
|
|
id='cachalot.W003' |
|
67
|
|
|
)) |
|
68
|
|
|
else: |
|
69
|
|
|
errors.append(Error( |
|
70
|
|
|
'Database alias %r from `CACHALOT_DATABASES` ' |
|
71
|
|
|
'is not defined in `DATABASES`.' % db_alias, |
|
72
|
|
|
hint='Change `CACHALOT_DATABASES` to be compliant with' |
|
73
|
|
|
'`CACHALOT_DATABASES`', |
|
74
|
|
|
id='cachalot.E001', |
|
75
|
|
|
)) |
|
76
|
|
|
|
|
77
|
|
|
if not enabled_databases: |
|
78
|
|
|
errors.append(Warning( |
|
79
|
|
|
'Django-cachalot is useless because no database ' |
|
80
|
|
|
'is configured in `CACHALOT_DATABASES`.', |
|
81
|
|
|
hint='Reconfigure django-cachalot or remove it.', |
|
82
|
|
|
id='cachalot.W004' |
|
83
|
|
|
)) |
|
84
|
|
|
else: |
|
85
|
|
|
errors.append(Error( |
|
86
|
|
|
"`CACHALOT_DATABASES` must be either %r or a list, tuple, " |
|
87
|
|
|
"frozenset or set of database aliases." % SUPPORTED_ONLY, |
|
88
|
|
|
hint='Remove `CACHALOT_DATABASES` or change it.', |
|
89
|
|
|
id='cachalot.E002', |
|
90
|
|
|
)) |
|
91
|
|
|
return errors |
|
92
|
|
|
|
|
93
|
|
|
|
|
94
|
|
|
class CachalotConfig(AppConfig): |
|
95
|
|
|
name = 'cachalot' |
|
96
|
|
|
|
|
97
|
|
|
def ready(self): |
|
98
|
|
|
cachalot_settings.load() |
|
99
|
|
|
|