from typing import List from django import forms from django.contrib.auth import get_user_model from django.db import models 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 for name in names if name] 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.URLField() title = models.CharField(max_length=512) description = models.TextField() 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_string or 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] + '...)' auto_fill_placeholder = 'Leave empty to fill from website metadata' class BookmarkForm(forms.ModelForm): # Use URLField for URL url = forms.URLField() 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()) class Meta: model = Bookmark fields = ['url', 'tag_string', 'title', 'description']