/
models.py
71 lines (60 loc) · 2.27 KB
/
models.py
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
from django.db import models
from django.conf import settings
from django.core.cache import cache
class DocumentReleaseManager(models.Manager):
def default(self):
return DocumentRelease.objects.get(is_default=True)
class DocumentRelease(models.Model):
"""
A "release" of documentation -- i.e. English for v1.2.
"""
DEFAULT_CACHE_KEY = "%s_recent_release" % settings.CACHE_MIDDLEWARE_KEY_PREFIX
SVN = 'svn'
SCM_CHOICES = (
(SVN, 'SVN'),
)
lang = models.CharField(max_length=2, choices=settings.LANGUAGES, default='en')
version = models.CharField(max_length=20)
scm = models.CharField(max_length=10, choices=SCM_CHOICES)
scm_url = models.URLField()
is_default = models.BooleanField()
objects = DocumentReleaseManager()
def __unicode__(self):
return "%s/%s" % (self.lang, self.version)
@models.permalink
def get_absolute_url(self):
return ('document-index', [], {'lang': self.lang, 'version': self.version})
def save(self, *args, **kwargs):
# There can be only one. Default, that is.
if self.is_default:
DocumentRelease.objects.update(is_default=False)
cache.set(
self.DEFAULT_CACHE_KEY,
self.version,
settings.CACHE_MIDDLEWARE_SECONDS,
)
super(DocumentRelease, self).save(*args, **kwargs)
@property
def human_version(self):
"""
Return a "human readable" version of the version.
"""
return "Development trunk" if self.version == 'dev' \
else "Django %s" % self.version
class Document(models.Model):
"""
An individual document. Used mainly as a hook point for Haystack.
"""
release = models.ForeignKey(DocumentRelease, related_name='documents')
path = models.CharField(max_length=500)
title = models.CharField(max_length=500)
def __unicode__(self):
return "/".join([self.release.lang, self.release.version, self.path])
@models.permalink
def get_absolute_url(self):
kwargs = {
'lang': self.release.lang,
'version': self.release.version,
'url': self.path
}
return ('document-detail', [], kwargs)