2020-02-15 22:38:46 +00:00
|
|
|
''' database schema for books and shelves '''
|
2020-10-30 19:57:31 +00:00
|
|
|
import re
|
|
|
|
|
2020-02-11 23:17:21 +00:00
|
|
|
from django.db import models
|
2020-09-17 20:02:52 +00:00
|
|
|
from django.utils import timezone
|
2020-03-27 22:42:44 +00:00
|
|
|
from model_utils.managers import InheritanceManager
|
2020-02-17 03:17:11 +00:00
|
|
|
|
2020-09-21 15:10:37 +00:00
|
|
|
from bookwyrm import activitypub
|
|
|
|
from bookwyrm.settings import DOMAIN
|
|
|
|
from bookwyrm.utils.fields import ArrayField
|
2020-02-15 22:38:46 +00:00
|
|
|
|
2020-09-21 15:16:34 +00:00
|
|
|
from .base_model import ActivityMapping, ActivitypubMixin, BookWyrmModel
|
2020-09-17 20:02:52 +00:00
|
|
|
|
2020-03-27 23:36:52 +00:00
|
|
|
|
2020-09-21 15:16:34 +00:00
|
|
|
class Book(ActivitypubMixin, BookWyrmModel):
|
2020-03-07 06:56:44 +00:00
|
|
|
''' a generic book, which can mean either an edition or a work '''
|
|
|
|
# these identifiers apply to both works and editions
|
2020-03-28 22:06:16 +00:00
|
|
|
openlibrary_key = models.CharField(max_length=255, blank=True, null=True)
|
|
|
|
librarything_key = models.CharField(max_length=255, blank=True, null=True)
|
|
|
|
goodreads_key = models.CharField(max_length=255, blank=True, null=True)
|
2020-02-11 23:17:21 +00:00
|
|
|
|
2020-03-07 06:56:44 +00:00
|
|
|
# info about where the data comes from and where/if to sync
|
|
|
|
sync = models.BooleanField(default=True)
|
2020-03-28 22:06:16 +00:00
|
|
|
sync_cover = models.BooleanField(default=True)
|
2020-03-30 00:40:51 +00:00
|
|
|
last_sync_date = models.DateTimeField(default=timezone.now)
|
2020-03-27 21:14:28 +00:00
|
|
|
connector = models.ForeignKey(
|
|
|
|
'Connector', on_delete=models.PROTECT, null=True)
|
2020-02-11 23:17:21 +00:00
|
|
|
|
2020-03-07 06:56:44 +00:00
|
|
|
# TODO: edit history
|
2020-02-11 23:17:21 +00:00
|
|
|
|
2020-03-07 06:56:44 +00:00
|
|
|
# book/work metadata
|
|
|
|
title = models.CharField(max_length=255)
|
2020-03-28 22:06:16 +00:00
|
|
|
sort_title = models.CharField(max_length=255, blank=True, null=True)
|
|
|
|
subtitle = models.CharField(max_length=255, blank=True, null=True)
|
2020-03-07 06:56:44 +00:00
|
|
|
description = models.TextField(blank=True, null=True)
|
2020-03-30 20:15:49 +00:00
|
|
|
languages = ArrayField(
|
|
|
|
models.CharField(max_length=255), blank=True, default=list
|
|
|
|
)
|
2020-03-07 06:56:44 +00:00
|
|
|
series = models.CharField(max_length=255, blank=True, null=True)
|
|
|
|
series_number = models.CharField(max_length=255, blank=True, null=True)
|
2020-03-28 04:28:52 +00:00
|
|
|
subjects = ArrayField(
|
|
|
|
models.CharField(max_length=255), blank=True, default=list
|
|
|
|
)
|
|
|
|
subject_places = ArrayField(
|
|
|
|
models.CharField(max_length=255), blank=True, default=list
|
|
|
|
)
|
2020-03-07 06:56:44 +00:00
|
|
|
# TODO: include an annotation about the type of authorship (ie, translator)
|
2020-02-11 23:17:21 +00:00
|
|
|
authors = models.ManyToManyField('Author')
|
2020-04-29 17:09:14 +00:00
|
|
|
# preformatted authorship string for search and easier display
|
|
|
|
author_text = models.CharField(max_length=255, blank=True, null=True)
|
2020-02-11 23:17:21 +00:00
|
|
|
cover = models.ImageField(upload_to='covers/', blank=True, null=True)
|
2020-03-28 22:06:16 +00:00
|
|
|
first_published_date = models.DateTimeField(blank=True, null=True)
|
|
|
|
published_date = models.DateTimeField(blank=True, null=True)
|
2020-03-27 22:42:44 +00:00
|
|
|
objects = InheritanceManager()
|
2020-03-07 06:56:44 +00:00
|
|
|
|
2020-09-17 20:02:52 +00:00
|
|
|
@property
|
|
|
|
def ap_authors(self):
|
2020-09-17 20:09:11 +00:00
|
|
|
''' the activitypub serialization should be a list of author ids '''
|
2020-09-17 20:02:52 +00:00
|
|
|
return [a.remote_id for a in self.authors.all()]
|
|
|
|
|
2020-10-31 00:18:25 +00:00
|
|
|
@property
|
|
|
|
def ap_cover(self):
|
|
|
|
''' an image attachment '''
|
2020-10-31 17:50:00 +00:00
|
|
|
if not self.cover or not hasattr(self.cover, 'url'):
|
|
|
|
return []
|
2020-10-31 00:18:25 +00:00
|
|
|
return [activitypub.Image(
|
|
|
|
url='https://%s%s' % (DOMAIN, self.cover.url),
|
|
|
|
)]
|
|
|
|
|
|
|
|
|
2020-09-17 20:02:52 +00:00
|
|
|
activity_mappings = [
|
|
|
|
ActivityMapping('id', 'remote_id'),
|
|
|
|
|
|
|
|
ActivityMapping('authors', 'ap_authors'),
|
2020-10-30 22:22:20 +00:00
|
|
|
ActivityMapping('first_published_date', 'first_published_date'),
|
|
|
|
ActivityMapping('published_date', 'published_date'),
|
2020-09-17 20:02:52 +00:00
|
|
|
|
|
|
|
ActivityMapping('title', 'title'),
|
|
|
|
ActivityMapping('sort_title', 'sort_title'),
|
|
|
|
ActivityMapping('subtitle', 'subtitle'),
|
|
|
|
ActivityMapping('description', 'description'),
|
|
|
|
ActivityMapping('languages', 'languages'),
|
|
|
|
ActivityMapping('series', 'series'),
|
|
|
|
ActivityMapping('series_number', 'series_number'),
|
|
|
|
ActivityMapping('subjects', 'subjects'),
|
|
|
|
ActivityMapping('subject_places', 'subject_places'),
|
|
|
|
|
|
|
|
ActivityMapping('openlibrary_key', 'openlibrary_key'),
|
|
|
|
ActivityMapping('librarything_key', 'librarything_key'),
|
|
|
|
ActivityMapping('goodreads_key', 'goodreads_key'),
|
|
|
|
|
|
|
|
ActivityMapping('work', 'parent_work'),
|
|
|
|
ActivityMapping('isbn_10', 'isbn_10'),
|
|
|
|
ActivityMapping('isbn_13', 'isbn_13'),
|
|
|
|
ActivityMapping('oclc_number', 'oclc_number'),
|
|
|
|
ActivityMapping('asin', 'asin'),
|
|
|
|
ActivityMapping('pages', 'pages'),
|
|
|
|
ActivityMapping('physical_format', 'physical_format'),
|
|
|
|
ActivityMapping('publishers', 'publishers'),
|
|
|
|
|
|
|
|
ActivityMapping('lccn', 'lccn'),
|
|
|
|
ActivityMapping('editions', 'editions_path'),
|
2020-10-31 00:18:25 +00:00
|
|
|
ActivityMapping('attachment', 'ap_cover'),
|
2020-09-17 20:02:52 +00:00
|
|
|
]
|
|
|
|
|
2020-03-30 21:12:18 +00:00
|
|
|
def save(self, *args, **kwargs):
|
|
|
|
''' can't be abstract for query reasons, but you shouldn't USE it '''
|
|
|
|
if not isinstance(self, Edition) and not isinstance(self, Work):
|
|
|
|
raise ValueError('Books should be added as Editions or Works')
|
2020-05-13 01:56:28 +00:00
|
|
|
|
2020-03-30 21:12:18 +00:00
|
|
|
super().save(*args, **kwargs)
|
|
|
|
|
2020-05-13 01:56:28 +00:00
|
|
|
def get_remote_id(self):
|
|
|
|
''' editions and works both use "book" instead of model_name '''
|
|
|
|
return 'https://%s/book/%d' % (DOMAIN, self.id)
|
|
|
|
|
|
|
|
|
|
|
|
@property
|
|
|
|
def local_id(self):
|
|
|
|
''' when a book is ingested from an outside source, it becomes local to
|
|
|
|
an instance, so it needs a local url for federation. but it still needs
|
|
|
|
the remote_id for easier deduplication and, if appropriate, to sync with
|
|
|
|
the remote canonical copy '''
|
|
|
|
return 'https://%s/book/%d' % (DOMAIN, self.id)
|
|
|
|
|
2020-03-24 16:56:53 +00:00
|
|
|
def __repr__(self):
|
2020-03-28 04:28:52 +00:00
|
|
|
return "<{} key={!r} title={!r}>".format(
|
2020-03-27 21:14:28 +00:00
|
|
|
self.__class__,
|
|
|
|
self.openlibrary_key,
|
|
|
|
self.title,
|
|
|
|
)
|
2020-03-24 16:56:53 +00:00
|
|
|
|
2020-03-07 06:56:44 +00:00
|
|
|
|
|
|
|
class Work(Book):
|
|
|
|
''' a work (an abstract concept of a book that manifests in an edition) '''
|
|
|
|
# library of congress catalog control number
|
2020-03-28 22:06:16 +00:00
|
|
|
lccn = models.CharField(max_length=255, blank=True, null=True)
|
2020-03-07 06:56:44 +00:00
|
|
|
|
2020-09-17 20:02:52 +00:00
|
|
|
@property
|
|
|
|
def editions_path(self):
|
2020-09-17 20:09:11 +00:00
|
|
|
''' it'd be nice to serialize the edition instead but, recursion '''
|
2020-10-29 19:32:37 +00:00
|
|
|
return [e.remote_id for e in self.edition_set.all()]
|
2020-09-17 20:02:52 +00:00
|
|
|
|
|
|
|
|
2020-03-30 22:03:21 +00:00
|
|
|
@property
|
|
|
|
def default_edition(self):
|
2020-09-17 20:09:11 +00:00
|
|
|
''' best-guess attempt at picking the default edition for this work '''
|
2020-03-30 22:03:21 +00:00
|
|
|
ed = Edition.objects.filter(parent_work=self, default=True).first()
|
|
|
|
if not ed:
|
|
|
|
ed = Edition.objects.filter(parent_work=self).first()
|
|
|
|
return ed
|
|
|
|
|
2020-09-17 20:02:52 +00:00
|
|
|
activity_serializer = activitypub.Work
|
|
|
|
|
2020-03-07 06:56:44 +00:00
|
|
|
|
|
|
|
class Edition(Book):
|
|
|
|
''' an edition of a book '''
|
2020-04-29 17:09:14 +00:00
|
|
|
# default -> this is what gets displayed for a work
|
2020-03-30 20:15:49 +00:00
|
|
|
default = models.BooleanField(default=False)
|
2020-05-04 01:56:29 +00:00
|
|
|
|
2020-04-29 17:09:14 +00:00
|
|
|
# these identifiers only apply to editions, not works
|
|
|
|
isbn_10 = models.CharField(max_length=255, blank=True, null=True)
|
|
|
|
isbn_13 = models.CharField(max_length=255, blank=True, null=True)
|
2020-03-28 22:06:16 +00:00
|
|
|
oclc_number = models.CharField(max_length=255, blank=True, null=True)
|
2020-04-29 17:09:14 +00:00
|
|
|
asin = models.CharField(max_length=255, blank=True, null=True)
|
2020-03-28 22:06:16 +00:00
|
|
|
pages = models.IntegerField(blank=True, null=True)
|
|
|
|
physical_format = models.CharField(max_length=255, blank=True, null=True)
|
2020-03-28 04:28:52 +00:00
|
|
|
publishers = ArrayField(
|
|
|
|
models.CharField(max_length=255), blank=True, default=list
|
|
|
|
)
|
2020-03-30 21:12:18 +00:00
|
|
|
shelves = models.ManyToManyField(
|
|
|
|
'Shelf',
|
|
|
|
symmetrical=False,
|
|
|
|
through='ShelfBook',
|
|
|
|
through_fields=('book', 'shelf')
|
|
|
|
)
|
|
|
|
parent_work = models.ForeignKey('Work', on_delete=models.PROTECT, null=True)
|
2020-02-17 03:17:11 +00:00
|
|
|
|
2020-09-17 20:02:52 +00:00
|
|
|
activity_serializer = activitypub.Edition
|
|
|
|
|
2020-10-29 19:32:37 +00:00
|
|
|
def save(self, *args, **kwargs):
|
|
|
|
''' calculate isbn 10/13 '''
|
|
|
|
if self.isbn_13 and self.isbn_13[:3] == '978' and not self.isbn_10:
|
|
|
|
self.isbn_10 = isbn_13_to_10(self.isbn_13)
|
|
|
|
if self.isbn_10 and not self.isbn_13:
|
|
|
|
self.isbn_13 = isbn_10_to_13(self.isbn_10)
|
|
|
|
|
|
|
|
super().save(*args, **kwargs)
|
|
|
|
|
|
|
|
|
|
|
|
def isbn_10_to_13(isbn_10):
|
|
|
|
''' convert an isbn 10 into an isbn 13 '''
|
2020-10-30 19:57:31 +00:00
|
|
|
isbn_10 = re.sub(r'[^0-9X]', '', isbn_10)
|
2020-10-29 19:32:37 +00:00
|
|
|
# drop the last character of the isbn 10 number (the original checkdigit)
|
|
|
|
converted = isbn_10[:9]
|
|
|
|
# add "978" to the front
|
|
|
|
converted = '978' + converted
|
|
|
|
# add a check digit to the end
|
|
|
|
# multiply the odd digits by 1 and the even digits by 3 and sum them
|
2020-10-30 19:57:31 +00:00
|
|
|
try:
|
|
|
|
checksum = sum(int(i) for i in converted[::2]) + \
|
2020-10-29 19:32:37 +00:00
|
|
|
sum(int(i) * 3 for i in converted[1::2])
|
2020-10-30 19:57:31 +00:00
|
|
|
except ValueError:
|
|
|
|
return None
|
2020-10-29 19:32:37 +00:00
|
|
|
# add the checksum mod 10 to the end
|
|
|
|
checkdigit = checksum % 10
|
|
|
|
if checkdigit != 0:
|
|
|
|
checkdigit = 10 - checkdigit
|
|
|
|
return converted + str(checkdigit)
|
|
|
|
|
|
|
|
|
|
|
|
def isbn_13_to_10(isbn_13):
|
|
|
|
''' convert isbn 13 to 10, if possible '''
|
|
|
|
if isbn_13[:3] != '978':
|
|
|
|
return None
|
|
|
|
|
2020-10-30 19:57:31 +00:00
|
|
|
isbn_13 = re.sub(r'[^0-9X]', '', isbn_13)
|
2020-10-30 19:43:02 +00:00
|
|
|
|
2020-10-29 19:32:37 +00:00
|
|
|
# remove '978' and old checkdigit
|
|
|
|
converted = isbn_13[3:-1]
|
|
|
|
# calculate checkdigit
|
|
|
|
# multiple each digit by 10,9,8.. successively and sum them
|
2020-10-30 19:57:31 +00:00
|
|
|
try:
|
|
|
|
checksum = sum(int(d) * (10 - idx) for (idx, d) in enumerate(converted))
|
|
|
|
except ValueError:
|
|
|
|
return None
|
2020-10-29 19:32:37 +00:00
|
|
|
checkdigit = checksum % 11
|
|
|
|
checkdigit = 11 - checkdigit
|
|
|
|
if checkdigit == 10:
|
|
|
|
checkdigit = 'X'
|
|
|
|
return converted + str(checkdigit)
|
|
|
|
|
2020-02-11 23:17:21 +00:00
|
|
|
|
2020-09-21 15:16:34 +00:00
|
|
|
class Author(ActivitypubMixin, BookWyrmModel):
|
2020-02-15 22:38:46 +00:00
|
|
|
''' copy of an author from OL '''
|
2020-03-28 22:06:16 +00:00
|
|
|
openlibrary_key = models.CharField(max_length=255, blank=True, null=True)
|
2020-05-04 01:56:29 +00:00
|
|
|
sync = models.BooleanField(default=True)
|
|
|
|
last_sync_date = models.DateTimeField(default=timezone.now)
|
2020-03-07 06:56:44 +00:00
|
|
|
wikipedia_link = models.CharField(max_length=255, blank=True, null=True)
|
|
|
|
# idk probably other keys would be useful here?
|
2020-03-28 22:06:16 +00:00
|
|
|
born = models.DateTimeField(blank=True, null=True)
|
|
|
|
died = models.DateTimeField(blank=True, null=True)
|
2020-03-07 06:56:44 +00:00
|
|
|
name = models.CharField(max_length=255)
|
2020-03-28 22:06:16 +00:00
|
|
|
last_name = models.CharField(max_length=255, blank=True, null=True)
|
|
|
|
first_name = models.CharField(max_length=255, blank=True, null=True)
|
2020-03-27 21:14:28 +00:00
|
|
|
aliases = ArrayField(
|
|
|
|
models.CharField(max_length=255), blank=True, default=list
|
|
|
|
)
|
2020-03-07 06:56:44 +00:00
|
|
|
bio = models.TextField(null=True, blank=True)
|
2020-05-10 04:52:13 +00:00
|
|
|
|
2020-05-13 01:56:28 +00:00
|
|
|
@property
|
|
|
|
def local_id(self):
|
|
|
|
''' when a book is ingested from an outside source, it becomes local to
|
|
|
|
an instance, so it needs a local url for federation. but it still needs
|
|
|
|
the remote_id for easier deduplication and, if appropriate, to sync with
|
|
|
|
the remote canonical copy (ditto here for author)'''
|
|
|
|
return 'https://%s/book/%d' % (DOMAIN, self.id)
|
|
|
|
|
2020-06-17 22:16:19 +00:00
|
|
|
@property
|
|
|
|
def display_name(self):
|
|
|
|
''' Helper to return a displayable name'''
|
|
|
|
if self.name:
|
2020-09-17 20:02:52 +00:00
|
|
|
return self.name
|
2020-06-17 22:16:19 +00:00
|
|
|
# don't want to return a spurious space if all of these are None
|
2020-09-17 20:02:52 +00:00
|
|
|
if self.first_name and self.last_name:
|
2020-06-17 22:16:19 +00:00
|
|
|
return self.first_name + ' ' + self.last_name
|
2020-09-17 20:02:52 +00:00
|
|
|
return self.last_name or self.first_name
|
|
|
|
|
|
|
|
activity_mappings = [
|
|
|
|
ActivityMapping('id', 'remote_id'),
|
|
|
|
ActivityMapping('url', 'remote_id'),
|
|
|
|
ActivityMapping('name', 'display_name'),
|
|
|
|
ActivityMapping('born', 'born'),
|
|
|
|
ActivityMapping('died', 'died'),
|
|
|
|
ActivityMapping('aliases', 'aliases'),
|
|
|
|
ActivityMapping('bio', 'bio'),
|
|
|
|
ActivityMapping('openlibrary_key', 'openlibrary_key'),
|
|
|
|
ActivityMapping('wikipedia_link', 'wikipedia_link'),
|
|
|
|
]
|
|
|
|
activity_serializer = activitypub.Author
|