Suggestion list

bookwyrm/activitypub/__init__.py

@@ -15,8 +15,8 @@
 from .note import Review, Rating
 from .note import Tombstone
 from .ordered_collection import OrderedCollection, OrderedCollectionPage
-from .ordered_collection import CollectionItem, ListItem, ShelfItem
-from .ordered_collection import BookList, Shelf
+from .ordered_collection import CollectionItem, ListItem, ShelfItem, SuggestionListItem
+from .ordered_collection import BookList, SuggestionList, Shelf
 from .person import Person, PublicKey
 from .response import ActivitypubResponse
 from .book import Edition, Work, Author

bookwyrm/activitypub/ordered_collection.py

@@ -4,6 +4,7 @@
 from typing import List
 
 from .base_activity import ActivityObject
+from .book import Work
 
 
 @dataclass(init=False)
@@ -42,6 +43,15 @@ class BookList(OrderedCollectionPrivate):
     type: str = "BookList"
 
 
+@dataclass(init=False)
+class SuggestionList(OrderedCollectionPrivate):
+    """structure of an ordered collection activity"""
+
+    summary: str = None
+    book: Work = None
+    type: str = "SuggestionList"
+
+
 @dataclass(init=False)
 class OrderedCollectionPage(ActivityObject):
     """structure of an ordered collection activity"""
@@ -72,6 +82,15 @@ class ListItem(CollectionItem):
     type: str = "ListItem"
 
 
+@dataclass(init=False)
+class SuggestionListItem(CollectionItem):
+    """a book on a list"""
+
+    book: str
+    notes: str = None
+    type: str = "SuggestionListItem"
+
+
 @dataclass(init=False)
 class ShelfItem(CollectionItem):
     """a book on a list"""

bookwyrm/forms/lists.py

@@ -20,6 +20,18 @@ class Meta:
         fields = ["user", "book", "book_list", "notes"]
 
 
+class SuggestionListForm(CustomForm):
+    class Meta:
+        model = models.SuggestionList
+        fields = ["suggests_for"]
+
+
+class SuggestionListItemForm(CustomForm):
+    class Meta:
+        model = models.SuggestionListItem
+        fields = ["user", "book", "book_list", "notes"]
+
+
 class SortListForm(forms.Form):
     sort_by = ChoiceField(
         choices=(

bookwyrm/migrations/0219_alter_listitem_options_suggestionlist_and_more.py

@@ -0,0 +1,154 @@
+# Generated by Django 5.2.3 on 2025-10-15 18:14
+
+import bookwyrm.models.activitypub_mixin
+import bookwyrm.models.fields
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("bookwyrm", "0218_merge_0217_merge_20250816_0749_0217_usersession"),
+    ]
+
+    operations = [
+        migrations.AlterModelOptions(
+            name="listitem",
+            options={},
+        ),
+        migrations.CreateModel(
+            name="SuggestionList",
+            fields=[
+                (
+                    "id",
+                    models.AutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("created_date", models.DateTimeField(auto_now_add=True)),
+                ("updated_date", models.DateTimeField(auto_now=True)),
+                (
+                    "remote_id",
+                    bookwyrm.models.fields.RemoteIdField(
+                        max_length=255,
+                        null=True,
+                        validators=[bookwyrm.models.fields.validate_remote_id],
+                    ),
+                ),
+                ("embed_key", models.UUIDField(editable=False, null=True, unique=True)),
+                (
+                    "privacy",
+                    bookwyrm.models.fields.PrivacyField(
+                        choices=[
+                            ("public", "Public"),
+                            ("unlisted", "Unlisted"),
+                            ("followers", "Followers"),
+                            ("direct", "Private"),
+                        ],
+                        default="public",
+                        max_length=255,
+                    ),
+                ),
+                (
+                    "suggests_for",
+                    bookwyrm.models.fields.OneToOneField(
+                        on_delete=django.db.models.deletion.PROTECT,
+                        related_name="suggestion_list",
+                        to="bookwyrm.work",
+                    ),
+                ),
+                (
+                    "user",
+                    bookwyrm.models.fields.ForeignKey(
+                        on_delete=django.db.models.deletion.PROTECT,
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+            ],
+            options={
+                "ordering": ("-updated_date",),
+                "abstract": False,
+            },
+            bases=(
+                bookwyrm.models.activitypub_mixin.OrderedCollectionMixin,
+                models.Model,
+            ),
+        ),
+        migrations.CreateModel(
+            name="SuggestionListItem",
+            fields=[
+                (
+                    "id",
+                    models.AutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("created_date", models.DateTimeField(auto_now_add=True)),
+                ("updated_date", models.DateTimeField(auto_now=True)),
+                (
+                    "remote_id",
+                    bookwyrm.models.fields.RemoteIdField(
+                        max_length=255,
+                        null=True,
+                        validators=[bookwyrm.models.fields.validate_remote_id],
+                    ),
+                ),
+                (
+                    "notes",
+                    bookwyrm.models.fields.HtmlField(
+                        blank=True, max_length=300, null=True
+                    ),
+                ),
+                (
+                    "book",
+                    bookwyrm.models.fields.ForeignKey(
+                        on_delete=django.db.models.deletion.PROTECT,
+                        to="bookwyrm.edition",
+                    ),
+                ),
+                (
+                    "book_list",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        to="bookwyrm.suggestionlist",
+                    ),
+                ),
+                (
+                    "endorsement",
+                    models.ManyToManyField(
+                        related_name="suggestion_endorsers", to=settings.AUTH_USER_MODEL
+                    ),
+                ),
+                (
+                    "user",
+                    bookwyrm.models.fields.ForeignKey(
+                        on_delete=django.db.models.deletion.PROTECT,
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+            ],
+            options={
+                "ordering": ("-created_date",),
+                "abstract": False,
+                "unique_together": {("book", "book_list")},
+            },
+            bases=(bookwyrm.models.activitypub_mixin.CollectionItemMixin, models.Model),
+        ),
+        migrations.AddField(
+            model_name="suggestionlist",
+            name="books",
+            field=models.ManyToManyField(
+                through="bookwyrm.SuggestionListItem",
+                through_fields=("book_list", "book"),
+                to="bookwyrm.edition",
+            ),
+        ),
+    ]

bookwyrm/migrations/0224_merge_20251116_1928.py

@@ -0,0 +1,13 @@
+# Generated by Django 5.2.3 on 2025-11-16 19:28
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("bookwyrm", "0219_alter_listitem_options_suggestionlist_and_more"),
+        ("bookwyrm", "0223_sitesettings_disable_federation"),
+    ]
+
+    operations = []

bookwyrm/models/__init__.py

@@ -10,6 +10,7 @@
 
 from .shelf import Shelf, ShelfBook
 from .list import List, ListItem
+from .list import SuggestionList, SuggestionListItem
 
 from .status import Status, GeneratedNote, Comment, Quotation
 from .status import Review, ReviewRating

bookwyrm/models/fields.py

@@ -636,11 +636,11 @@ class BooleanField(ActivitypubFieldMixin, models.BooleanField):
 
 
 class IntegerField(ActivitypubFieldMixin, models.IntegerField):
-    """activitypub-aware boolean field"""
+    """activitypub-aware integer field"""
 
 
 class DecimalField(ActivitypubFieldMixin, models.DecimalField):
-    """activitypub-aware boolean field"""
+    """activitypub-aware decimal field"""
 
     def field_to_activity(self, value):
         if not value: