src/catalogue/api/serializers.py

   1 # This file is part of Wolne Lektury, licensed under GNU Affero GPLv3 or later.
   2 # Copyright © Fundacja Wolne Lektury. See NOTICE for more information.
   3 #
   4 from rest_framework import serializers
   5 from api.fields import AbsoluteURLField, LegacyMixin, ThumbnailField
   6 from catalogue.models import Book, Collection, Tag, BookMedia, Fragment
   7 from .fields import BookLiked, EmbargoURLField
   8
   9
  10 class TagSerializer(serializers.ModelSerializer):
  11     url = AbsoluteURLField()
  12     href = AbsoluteURLField(
  13         view_name='catalogue_api_tag',
  14         view_args=('category', 'slug')
  15     )
  16
  17     class Meta:
  18         model = Tag
  19         fields = ['url', 'href', 'name', 'slug']
  20
  21
  22 class TagDetailSerializer(serializers.ModelSerializer):
  23     url = AbsoluteURLField()
  24
  25     class Meta:
  26         model = Tag
  27         fields = [
  28             'name', 'url', 'sort_key',
  29             'description',
  30             'description_pl',
  31             'plural', 'genre_epoch_specific',
  32             'adjective_feminine_singular', 'adjective_nonmasculine_plural',
  33             'genitive', 'collective_noun',
  34         ]
  35         write_only_fields = [
  36             'description_pl',
  37             'plural', 'genre_epoch_specific',
  38             'adjective_feminine_singular', 'adjective_nonmasculine_plural',
  39             'genitive', 'collective_noun',
  40         ]
  41
  42
  43 class AuthorItemSerializer(serializers.ModelSerializer):
  44     url = AbsoluteURLField()
  45     href = AbsoluteURLField(
  46         view_name='catalogue_api_author',
  47         view_args=('slug',)
  48     )
  49
  50     class Meta:
  51         model = Tag
  52         fields = [
  53             'url', 'href', 'name'
  54         ]
  55
  56 class AuthorSerializer(AuthorItemSerializer):
  57     photo_thumb = ThumbnailField('139x193', source='photo')
  58
  59     class Meta:
  60         model = Tag
  61         fields = [
  62             'url', 'href', 'name', 'slug', 'sort_key', 'description',
  63             'genitive', 'photo', 'photo_thumb', 'photo_attribution',
  64         ]
  65
  66 class EpochItemSerializer(serializers.ModelSerializer):
  67     url = AbsoluteURLField()
  68     href = AbsoluteURLField(
  69         view_name='catalogue_api_epoch',
  70         view_args=('slug',)
  71     )
  72     class Meta:
  73         model = Tag
  74         fields = ['url', 'href', 'name']
  75
  76 class EpochSerializer(EpochItemSerializer):
  77     class Meta:
  78         model = Tag
  79         fields = [
  80             'url', 'href', 'name', 'slug', 'sort_key', 'description',
  81             'adjective_feminine_singular', 'adjective_nonmasculine_plural',
  82         ]
  83
  84 class GenreItemSerializer(serializers.ModelSerializer):
  85     url = AbsoluteURLField()
  86     href = AbsoluteURLField(
  87         view_name='catalogue_api_genre',
  88         view_args=('slug',)
  89     )
  90     class Meta:
  91         model = Tag
  92         fields = ['url', 'href', 'name']
  93
  94 class GenreSerializer(GenreItemSerializer):
  95     class Meta:
  96         model = Tag
  97         fields = [
  98             'url', 'href', 'name', 'slug', 'sort_key', 'description',
  99             'plural', 'genre_epoch_specific',
 100         ]
 101
 102 class KindItemSerializer(serializers.ModelSerializer):
 103     url = AbsoluteURLField()
 104     href = AbsoluteURLField(
 105         view_name='catalogue_api_kind',
 106         view_args=('slug',)
 107     )
 108     class Meta:
 109         model = Tag
 110         fields = ['url', 'href', 'name']
 111
 112 class KindSerializer(KindItemSerializer):
 113     class Meta:
 114         model = Tag
 115         fields = [
 116             'url', 'href', 'name', 'slug', 'sort_key', 'description',
 117             'collective_noun',
 118         ]
 119
 120
 121 class TranslatorSerializer(serializers.Serializer):
 122     name = serializers.CharField(source='*')
 123
 124
 125 class BookSerializer2(serializers.ModelSerializer):
 126     url = AbsoluteURLField()
 127     href = AbsoluteURLField(view_name='catalogue_api_book', view_args=['slug'])
 128     xml = EmbargoURLField(source='xml_url')
 129     html = EmbargoURLField(source='html_url')
 130     txt = EmbargoURLField(source='txt_url')
 131     fb2 = EmbargoURLField(source='fb2_url')
 132     epub = EmbargoURLField(source='epub_url')
 133     mobi = EmbargoURLField(source='mobi_url')
 134     pdf = EmbargoURLField(source='pdf_url')
 135
 136     authors = AuthorItemSerializer(many=True)
 137     translators = AuthorItemSerializer(many=True)
 138     epochs = EpochItemSerializer(many=True)
 139     genres = GenreItemSerializer(many=True)
 140     kinds = KindItemSerializer(many=True)
 141     parent = serializers.HyperlinkedRelatedField(
 142         read_only=True,
 143         view_name='catalogue_api_book',
 144         lookup_field='slug'
 145     )
 146
 147     class Meta:
 148         model = Book
 149         fields = [
 150             'slug', 'title', 'full_sort_key',
 151             'href', 'url', 'language',
 152             'authors', 'translators',
 153             'epochs', 'genres', 'kinds',
 154             #'children',
 155             'parent', 'preview',
 156             'epub', 'mobi', 'pdf', 'html', 'txt', 'fb2', 'xml',
 157             'cover_thumb', 'cover',
 158             'isbn_pdf', 'isbn_epub', 'isbn_mobi',
 159         ]
 160
 161 class BookSerializer11Labs(serializers.ModelSerializer):
 162     url = AbsoluteURLField()
 163     href = AbsoluteURLField(view_name='catalogue_api_book', view_args=['slug'])
 164     html = EmbargoURLField(source='html_nonotes_url')
 165
 166     authors = AuthorItemSerializer(many=True)
 167     translators = AuthorItemSerializer(many=True)
 168     epochs = EpochItemSerializer(many=True)
 169     genres = GenreItemSerializer(many=True)
 170     kinds = KindItemSerializer(many=True)
 171     parent = serializers.HyperlinkedRelatedField(
 172         read_only=True,
 173         view_name='catalogue_api_book',
 174         lookup_field='slug'
 175     )
 176
 177     class Meta:
 178         model = Book
 179         fields = [
 180             'slug', 'title', 'full_sort_key',
 181             'href', 'url', 'language',
 182             'authors', 'translators',
 183             'epochs', 'genres', 'kinds',
 184             #'children',
 185             'parent', 'preview',
 186             'html',
 187             'cover_thumb', 'cover',
 188             'isbn_pdf', 'isbn_epub', 'isbn_mobi',
 189         ]
 190
 191
 192 class BookSerializer(LegacyMixin, serializers.ModelSerializer):
 193     author = serializers.CharField(source='author_unicode')
 194     kind = serializers.CharField(source='kind_unicode')
 195     epoch = serializers.CharField(source='epoch_unicode')
 196     genre = serializers.CharField(source='genre_unicode')
 197     liked = BookLiked()
 198
 199     simple_thumb = serializers.FileField(source='cover_api_thumb')
 200     href = AbsoluteURLField(view_name='catalogue_api_book', view_args=['slug'])
 201     url = AbsoluteURLField()
 202     cover_thumb = ThumbnailField('139x193', source='cover')
 203
 204     class Meta:
 205         model = Book
 206         fields = [
 207             'kind', 'full_sort_key', 'title', 'url', 'cover_color', 'author',
 208             'cover', 'epoch', 'href', 'has_audio', 'genre',
 209             'simple_thumb', 'slug', 'cover_thumb', 'liked']
 210         legacy_non_null_fields = [
 211             'kind', 'author', 'epoch', 'genre',
 212             'cover', 'simple_thumb', 'cover_thumb']
 213
 214
 215 class BookListSerializer(BookSerializer):
 216     cover = serializers.CharField()
 217     cover_thumb = serializers.CharField()
 218
 219     Meta = BookSerializer.Meta
 220
 221
 222 class FilterBookListSerializer(BookListSerializer):
 223     key = serializers.CharField()
 224
 225     class Meta:
 226         model = Book
 227         fields = BookListSerializer.Meta.fields + ['key']
 228         legacy_non_null_fields = BookListSerializer.Meta.legacy_non_null_fields
 229
 230
 231 class MediaSerializer(LegacyMixin, serializers.ModelSerializer):
 232     url = EmbargoURLField(source='file_url')
 233
 234     class Meta:
 235         model = BookMedia
 236         fields = ['url', 'director', 'type', 'name', 'artist']
 237         legacy_non_null_fields = ['director', 'artist']
 238
 239
 240 class BookDetailSerializer(LegacyMixin, serializers.ModelSerializer):
 241     url = AbsoluteURLField()
 242
 243     authors = TagSerializer(many=True)
 244     translators = TranslatorSerializer(many=True)
 245     epochs = TagSerializer(many=True)
 246     genres = TagSerializer(many=True)
 247     kinds = TagSerializer(many=True)
 248
 249     fragment_data = serializers.DictField()
 250     parent = BookSerializer()
 251     children = BookSerializer(many=True)
 252
 253     xml = EmbargoURLField(source='xml_url')
 254     html = EmbargoURLField(source='html_url')
 255     txt = EmbargoURLField(source='txt_url')
 256     fb2 = EmbargoURLField(source='fb2_url')
 257     epub = EmbargoURLField(source='epub_url')
 258     mobi = EmbargoURLField(source='mobi_url')
 259     pdf = EmbargoURLField(source='pdf_url')
 260     media = MediaSerializer(many=True)
 261     cover_thumb = ThumbnailField('139x193', source='cover')
 262     simple_thumb = serializers.FileField(source='cover_api_thumb')
 263
 264     class Meta:
 265         model = Book
 266         fields = [
 267             'title', 'url', 'language',
 268             'epochs', 'genres', 'kinds', 'authors', 'translators',
 269             'fragment_data', 'children', 'parent', 'preview',
 270             'epub', 'mobi', 'pdf', 'html', 'txt', 'fb2', 'xml', 'media', 'audio_length',
 271             'cover_color', 'simple_cover', 'cover_thumb', 'cover', 'simple_thumb',
 272             'isbn_pdf', 'isbn_epub', 'isbn_mobi',
 273         ]
 274         legacy_non_null_fields = ['html', 'txt', 'fb2', 'epub', 'mobi', 'pdf',
 275                                   'cover', 'simple_cover', 'cover_thumb', 'simple_thumb']
 276
 277
 278 class BookPreviewSerializer(BookDetailSerializer):
 279     class Meta:
 280         model = Book
 281         fields = BookDetailSerializer.Meta.fields + ['slug']
 282         legacy_non_null_fields = BookDetailSerializer.Meta.legacy_non_null_fields
 283
 284
 285 class EbookSerializer(BookListSerializer):
 286     txt = EmbargoURLField(source='txt_url')
 287     fb2 = EmbargoURLField(source='fb2_url')
 288     epub = EmbargoURLField(source='epub_url')
 289     mobi = EmbargoURLField(source='mobi_url')
 290     pdf = EmbargoURLField(source='pdf_url')
 291
 292     class Meta:
 293         model = Book
 294         fields = ['author', 'href', 'title', 'cover', 'slug'] + Book.ebook_formats
 295         legacy_non_null_fields = ['author', 'cover'] + Book.ebook_formats
 296
 297
 298 class CollectionListSerializer(serializers.ModelSerializer):
 299     url = AbsoluteURLField()
 300     href = AbsoluteURLField(view_name='collection-detail', view_args=['slug'])
 301
 302     class Meta:
 303         model = Collection
 304         fields = ['url', 'href', 'title']
 305
 306
 307 class CollectionSerializer(serializers.ModelSerializer):
 308     books = BookSerializer(many=True, source='get_books', read_only=True)
 309     authors = TagSerializer(many=True, read_only=True)
 310     book_slugs = serializers.CharField(write_only=True, required=False)
 311     author_slugs = serializers.CharField(write_only=True, required=False)
 312     url = AbsoluteURLField()
 313
 314     class Meta:
 315         model = Collection
 316         fields = [
 317             'url', 'books', 'description', 'title',
 318             'book_slugs', 'authors', 'author_slugs'
 319         ]
 320
 321     def update(self, instance, validated_data):
 322         instance = super().update(instance, validated_data)
 323         author_slugs = validated_data.get('author_slugs', '').strip().split()
 324         if author_slugs:
 325             authors = Tag.objects.filter(
 326                 category='author',
 327                 slug__in=author_slugs
 328             )
 329         else:
 330             authors = []
 331         instance.authors.set(authors)
 332         return instance
 333
 334
 335 class FragmentSerializer(serializers.ModelSerializer):
 336     book = BookSerializer()
 337     url = AbsoluteURLField()
 338     href = AbsoluteURLField(source='get_api_url')
 339
 340     class Meta:
 341         model = Fragment
 342         fields = ['book', 'url', 'anchor', 'href']
 343
 344
 345 class FragmentDetailSerializer(serializers.ModelSerializer):
 346     book = BookSerializer()
 347     url = AbsoluteURLField()
 348     themes = TagSerializer(many=True)
 349
 350     class Meta:
 351         model = Fragment
 352         fields = ['book', 'anchor', 'text', 'url', 'themes']