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             'abstract',
 160         ]
 161
 162 class BookSerializer11Labs(serializers.ModelSerializer):
 163     url = AbsoluteURLField()
 164     href = AbsoluteURLField(view_name='catalogue_api_book', view_args=['slug'])
 165     html = EmbargoURLField(source='html_nonotes_url')
 166
 167     authors = AuthorItemSerializer(many=True)
 168     translators = AuthorItemSerializer(many=True)
 169     epochs = EpochItemSerializer(many=True)
 170     genres = GenreItemSerializer(many=True)
 171     kinds = KindItemSerializer(many=True)
 172     parent = serializers.HyperlinkedRelatedField(
 173         read_only=True,
 174         view_name='catalogue_api_book',
 175         lookup_field='slug'
 176     )
 177
 178     class Meta:
 179         model = Book
 180         fields = [
 181             'slug', 'title', 'full_sort_key',
 182             'href', 'url', 'language',
 183             'authors', 'translators',
 184             'epochs', 'genres', 'kinds',
 185             #'children',
 186             'parent', 'preview',
 187             'html',
 188             'cover_thumb', 'cover',
 189             'isbn_pdf', 'isbn_epub', 'isbn_mobi',
 190         ]
 191
 192
 193 class BookSerializer(LegacyMixin, serializers.ModelSerializer):
 194     author = serializers.CharField(source='author_unicode')
 195     kind = serializers.CharField(source='kind_unicode')
 196     epoch = serializers.CharField(source='epoch_unicode')
 197     genre = serializers.CharField(source='genre_unicode')
 198     liked = BookLiked()
 199
 200     simple_thumb = serializers.FileField(source='cover_api_thumb')
 201     href = AbsoluteURLField(view_name='catalogue_api_book', view_args=['slug'])
 202     url = AbsoluteURLField()
 203     cover_thumb = ThumbnailField('139x193', source='cover')
 204
 205     class Meta:
 206         model = Book
 207         fields = [
 208             'kind', 'full_sort_key', 'title', 'url', 'cover_color', 'author',
 209             'cover', 'epoch', 'href', 'has_audio', 'genre',
 210             'simple_thumb', 'slug', 'cover_thumb', 'liked']
 211         legacy_non_null_fields = [
 212             'kind', 'author', 'epoch', 'genre',
 213             'cover', 'simple_thumb', 'cover_thumb']
 214
 215
 216 class BookListSerializer(BookSerializer):
 217     cover = serializers.CharField()
 218     cover_thumb = serializers.CharField()
 219
 220     Meta = BookSerializer.Meta
 221
 222
 223 class FilterBookListSerializer(BookListSerializer):
 224     key = serializers.CharField()
 225
 226     class Meta:
 227         model = Book
 228         fields = BookListSerializer.Meta.fields + ['key']
 229         legacy_non_null_fields = BookListSerializer.Meta.legacy_non_null_fields
 230
 231
 232 class MediaSerializer(LegacyMixin, serializers.ModelSerializer):
 233     url = EmbargoURLField(source='file_url')
 234
 235     class Meta:
 236         model = BookMedia
 237         fields = ['url', 'director', 'type', 'name', 'artist']
 238         legacy_non_null_fields = ['director', 'artist']
 239
 240
 241 class BookDetailSerializer(LegacyMixin, serializers.ModelSerializer):
 242     url = AbsoluteURLField()
 243
 244     authors = TagSerializer(many=True)
 245     translators = TranslatorSerializer(many=True)
 246     epochs = TagSerializer(many=True)
 247     genres = TagSerializer(many=True)
 248     kinds = TagSerializer(many=True)
 249
 250     fragment_data = serializers.DictField()
 251     parent = BookSerializer()
 252     children = BookSerializer(many=True)
 253
 254     xml = EmbargoURLField(source='xml_url')
 255     html = EmbargoURLField(source='html_url')
 256     txt = EmbargoURLField(source='txt_url')
 257     fb2 = EmbargoURLField(source='fb2_url')
 258     epub = EmbargoURLField(source='epub_url')
 259     mobi = EmbargoURLField(source='mobi_url')
 260     pdf = EmbargoURLField(source='pdf_url')
 261     media = MediaSerializer(many=True)
 262     cover_thumb = ThumbnailField('139x193', source='cover')
 263     simple_thumb = serializers.FileField(source='cover_api_thumb')
 264
 265     class Meta:
 266         model = Book
 267         fields = [
 268             'title', 'url', 'language',
 269             'epochs', 'genres', 'kinds', 'authors', 'translators',
 270             'fragment_data', 'children', 'parent', 'preview',
 271             'epub', 'mobi', 'pdf', 'html', 'txt', 'fb2', 'xml', 'media', 'audio_length',
 272             'cover_color', 'simple_cover', 'cover_thumb', 'cover', 'simple_thumb',
 273             'isbn_pdf', 'isbn_epub', 'isbn_mobi',
 274         ]
 275         legacy_non_null_fields = ['html', 'txt', 'fb2', 'epub', 'mobi', 'pdf',
 276                                   'cover', 'simple_cover', 'cover_thumb', 'simple_thumb']
 277
 278
 279 class BookPreviewSerializer(BookDetailSerializer):
 280     class Meta:
 281         model = Book
 282         fields = BookDetailSerializer.Meta.fields + ['slug']
 283         legacy_non_null_fields = BookDetailSerializer.Meta.legacy_non_null_fields
 284
 285
 286 class EbookSerializer(BookListSerializer):
 287     txt = EmbargoURLField(source='txt_url')
 288     fb2 = EmbargoURLField(source='fb2_url')
 289     epub = EmbargoURLField(source='epub_url')
 290     mobi = EmbargoURLField(source='mobi_url')
 291     pdf = EmbargoURLField(source='pdf_url')
 292
 293     class Meta:
 294         model = Book
 295         fields = ['author', 'href', 'title', 'cover', 'slug'] + Book.ebook_formats
 296         legacy_non_null_fields = ['author', 'cover'] + Book.ebook_formats
 297
 298
 299 class CollectionListSerializer(serializers.ModelSerializer):
 300     url = AbsoluteURLField()
 301     href = AbsoluteURLField(view_name='collection-detail', view_args=['slug'])
 302
 303     class Meta:
 304         model = Collection
 305         fields = ['url', 'href', 'title']
 306
 307
 308 class CollectionSerializer(serializers.ModelSerializer):
 309     books = BookSerializer(many=True, source='get_books', read_only=True)
 310     authors = TagSerializer(many=True, read_only=True)
 311     book_slugs = serializers.CharField(write_only=True, required=False)
 312     author_slugs = serializers.CharField(write_only=True, required=False)
 313     url = AbsoluteURLField()
 314
 315     class Meta:
 316         model = Collection
 317         fields = [
 318             'url', 'books', 'description', 'title',
 319             'book_slugs', 'authors', 'author_slugs'
 320         ]
 321
 322     def update(self, instance, validated_data):
 323         instance = super().update(instance, validated_data)
 324         author_slugs = validated_data.get('author_slugs', '').strip().split()
 325         if author_slugs:
 326             authors = Tag.objects.filter(
 327                 category='author',
 328                 slug__in=author_slugs
 329             )
 330         else:
 331             authors = []
 332         instance.authors.set(authors)
 333         return instance
 334
 335
 336 class FragmentSerializer(serializers.ModelSerializer):
 337     book = BookSerializer()
 338     url = AbsoluteURLField()
 339     href = AbsoluteURLField(source='get_api_url')
 340
 341     class Meta:
 342         model = Fragment
 343         fields = ['book', 'url', 'anchor', 'href']
 344
 345
 346 class FragmentDetailSerializer(serializers.ModelSerializer):
 347     book = BookSerializer()
 348     url = AbsoluteURLField()
 349     themes = TagSerializer(many=True)
 350
 351     class Meta:
 352         model = Fragment
 353         fields = ['book', 'anchor', 'text', 'url', 'themes']
 354
 355
 356 class FragmentSerializer2(serializers.ModelSerializer):
 357     url = AbsoluteURLField()
 358     html = serializers.CharField(source='text')
 359
 360     class Meta:
 361         model = Fragment
 362         fields = ['anchor', 'html', 'url']
 363
 364
 365 class FilterTagSerializer(serializers.ModelSerializer):
 366     class Meta:
 367         model = Tag
 368         fields = ['id', 'category', 'name']