60 lines
2.3 KiB
Python
60 lines
2.3 KiB
Python
from __future__ import unicode_literals
|
|
|
|
import logging
|
|
|
|
from django.conf import settings
|
|
from django.core.exceptions import ValidationError
|
|
from django.core.urlresolvers import reverse
|
|
from django.db import models
|
|
from django.utils.encoding import python_2_unicode_compatible
|
|
from django.utils.timezone import now
|
|
from django.utils.translation import ugettext_lazy as _
|
|
|
|
from documents.models import Document
|
|
|
|
from .events import event_document_check_out
|
|
from .exceptions import DocumentAlreadyCheckedOut
|
|
from .managers import DocumentCheckoutManager
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
@python_2_unicode_compatible
|
|
class DocumentCheckout(models.Model):
|
|
"""
|
|
Model to store the state and information of a document checkout
|
|
"""
|
|
document = models.ForeignKey(Document, unique=True, verbose_name=_('Document'))
|
|
checkout_datetime = models.DateTimeField(auto_now_add=True, verbose_name=_('Check out date and time'))
|
|
expiration_datetime = models.DateTimeField(help_text=_('Amount of time to hold the document checked out in minutes.'), verbose_name=_('Check out expiration date and time'))
|
|
user = models.ForeignKey(settings.AUTH_USER_MODEL, verbose_name=_('User'))
|
|
block_new_version = models.BooleanField(default=True, help_text=_('Do not allow new version of this document to be uploaded.'), verbose_name=_('Block new version upload'))
|
|
|
|
objects = DocumentCheckoutManager()
|
|
|
|
def __str__(self):
|
|
return unicode(self.document)
|
|
|
|
def clean(self):
|
|
if self.expiration_datetime < now():
|
|
raise ValidationError(_('Check out expiration date and time must be in the future.'))
|
|
|
|
def save(self, *args, **kwargs):
|
|
new_checkout = not self.pk
|
|
if not new_checkout or self.document.is_checked_out():
|
|
raise DocumentAlreadyCheckedOut
|
|
|
|
result = super(DocumentCheckout, self).save(*args, **kwargs)
|
|
if new_checkout:
|
|
event_document_check_out.commit(actor=self.user, target=self.document)
|
|
logger.info('Document "%s" checked out by user "%s"', self.document, self.user)
|
|
|
|
return result
|
|
|
|
def get_absolute_url(self):
|
|
return reverse('checkout:checkout_info', args=[self.document.pk])
|
|
|
|
class Meta:
|
|
verbose_name = _('Document checkout')
|
|
verbose_name_plural = _('Document checkouts')
|