from typing import List from django import forms from django.contrib.auth import get_user_model from django.db import models from bookmarks.utils import unique from bookmarks.validators import BookmarkURLValidator class Tag(models.Model): name = models.CharField(max_length=64) date_added = models.DateTimeField() owner = models.ForeignKey(get_user_model(), on_delete=models.CASCADE) def __str__(self): return self.name def parse_tag_string(tag_string: str, delimiter: str = ','): if not tag_string: return [] names = tag_string.strip().split(delimiter) names = [name.strip() for name in names if name] names = unique(names, str.lower) names.sort(key=str.lower) return names def build_tag_string(tag_names: List[str], delimiter: str = ','): return delimiter.join(tag_names) class Bookmark(models.Model): url = models.CharField(max_length=2048, validators=[BookmarkURLValidator()]) title = models.CharField(max_length=512, blank=True) description = models.TextField(blank=True) website_title = models.CharField(max_length=512, blank=True, null=True) website_description = models.TextField(blank=True, null=True) unread = models.BooleanField(default=True) date_added = models.DateTimeField() date_modified = models.DateTimeField() date_accessed = models.DateTimeField(blank=True, null=True) owner = models.ForeignKey(get_user_model(), on_delete=models.CASCADE) tags = models.ManyToManyField(Tag) # Attributes might be calculated in query tag_count = 0 # Projection for number of associated tags tag_string = '' # Projection for list of tag names, comma-separated tag_projection = False # Tracks if the above projections were loaded @property def resolved_title(self): return self.website_title if not self.title else self.title @property def resolved_description(self): return self.website_description if not self.description else self.description @property def tag_names(self): # If tag projections were loaded then avoid querying all tags (=executing further selects) if self.tag_projection: return parse_tag_string(self.tag_string) else: return [tag.name for tag in self.tags.all()] def __str__(self): return self.resolved_title + ' (' + self.url[:30] + '...)' class BookmarkForm(forms.ModelForm): # Use URLField for URL url = forms.CharField(validators=[BookmarkURLValidator()]) tag_string = forms.CharField(required=False) # Do not require title and description in form as we fill these automatically if they are empty title = forms.CharField(max_length=512, required=False) description = forms.CharField(required=False, widget=forms.Textarea()) # Hidden field that determines whether to close window/tab after saving the bookmark auto_close = forms.CharField(required=False) # Hidden field that determines where to redirect after saving the form return_url = forms.CharField(required=False) class Meta: model = Bookmark fields = ['url', 'tag_string', 'title', 'description', 'auto_close', 'return_url']