plain.models 0.39.0__tar.gz → 0.39.2__tar.gz

{plain_models-0.39.0 → plain_models-0.39.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plain.models
-Version: 0.39.0
+Version: 0.39.2
 Summary: Database models for Plain.
 Author-email: Dave Gaeddert <dave.gaeddert@dropseed.dev>
 License-File: LICENSE
@@ -117,3 +117,31 @@ TODO
 ## Forms
 
 TODO
+
+## Sharing fields across models
+
+To share common fields across multiple models, use Python classes as mixins. The final, registered model must inherit directly from `models.Model` and the mixins should not.
+
+```python
+from plain import models
+
+
+# Regular Python class for shared fields
+class TimestampedMixin:
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+
+# Models inherit from the mixin AND models.Model
+@models.register_model
+class User(TimestampedMixin, models.Model):
+    email = models.EmailField()
+    password = PasswordField()
+    is_admin = models.BooleanField(default=False)
+
+
+@models.register_model
+class Note(TimestampedMixin, models.Model):
+    content = models.TextField(max_length=1024)
+    liked = models.BooleanField(default=False)
+```

{plain_models-0.39.0 → plain_models-0.39.2}/plain/models/CHANGELOG.md

@@ -1,5 +1,26 @@
 # plain-models changelog
 
+## [0.39.2](https://github.com/dropseed/plain/releases/plain-models@0.39.2) (2025-07-25)
+
+### What's changed
+
+- Fixed remaining `to_field_name` attribute usage in `ModelMultipleChoiceField` validation to use `id` directly ([26c80356d3](https://github.com/dropseed/plain/commit/26c80356d3))
+
+### Upgrade instructions
+
+- No changes required
+
+## [0.39.1](https://github.com/dropseed/plain/releases/plain-models@0.39.1) (2025-07-22)
+
+### What's changed
+
+- Added documentation for sharing fields across models using Python class mixins ([cad3af01d2](https://github.com/dropseed/plain/commit/cad3af01d2))
+- Added note about `PrimaryKeyField()` replacement requirement for migrations ([70ea931660](https://github.com/dropseed/plain/commit/70ea931660))
+
+### Upgrade instructions
+
+- No changes required
+
 ## [0.39.0](https://github.com/dropseed/plain/releases/plain-models@0.39.0) (2025-07-22)
 
 ### What's changed
@@ -18,6 +39,7 @@
 - Remove any `to_field` arguments from ForeignKey definitions - they are no longer supported
 - Remove any `parent_link=True` arguments from ForeignKey definitions - they are no longer supported
 - Replace any usage of `InlineForeignKeyField` in forms with standard form fields
+- `models.BigAutoField(auto_created=True, primary_key=True)` need to be replaced with `models.PrimaryKeyField()` in migrations
 
 ## [0.38.0](https://github.com/dropseed/plain/releases/plain-models@0.38.0) (2025-07-21)
 

{plain_models-0.39.0 → plain_models-0.39.2}/plain/models/README.md

@@ -106,3 +106,31 @@ TODO
 ## Forms
 
 TODO
+
+## Sharing fields across models
+
+To share common fields across multiple models, use Python classes as mixins. The final, registered model must inherit directly from `models.Model` and the mixins should not.
+
+```python
+from plain import models
+
+
+# Regular Python class for shared fields
+class TimestampedMixin:
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+
+# Models inherit from the mixin AND models.Model
+@models.register_model
+class User(TimestampedMixin, models.Model):
+    email = models.EmailField()
+    password = PasswordField()
+    is_admin = models.BooleanField(default=False)
+
+
+@models.register_model
+class Note(TimestampedMixin, models.Model):
+    content = models.TextField(max_length=1024)
+    liked = models.BooleanField(default=False)
+```

{plain_models-0.39.0 → plain_models-0.39.2}/plain/models/forms.py

@@ -573,7 +573,6 @@ class ModelMultipleChoiceField(ModelChoiceField):
         corresponding objects. Raise a ValidationError if a given value is
         invalid (not a valid PK, not in the queryset, etc.)
         """
-        key = self.to_field_name or "id"
         # deduplicate given values to avoid creating many querysets or
         # requiring the database backend deduplicate efficiently.
         try:
@@ -586,15 +585,15 @@ class ModelMultipleChoiceField(ModelChoiceField):
             )
         for id_val in value:
             try:
-                self.queryset.filter(**{key: id_val})
+                self.queryset.filter(id=id_val)
             except (ValueError, TypeError):
                 raise ValidationError(
                     self.error_messages["invalid_id_value"],
                     code="invalid_id_value",
                     params={"id": id_val},
                 )
-        qs = self.queryset.filter(**{f"{key}__in": value})
-        ids = {str(getattr(o, key)) for o in qs}
+        qs = self.queryset.filter(id__in=value)
+        ids = {str(o.id) for o in qs}
         for val in value:
             if str(val) not in ids:
                 raise ValidationError(

{plain_models-0.39.0 → plain_models-0.39.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "plain.models"
-version = "0.39.0"
+version = "0.39.2"
 description = "Database models for Plain."
 authors = [{name = "Dave Gaeddert", email = "dave.gaeddert@dropseed.dev"}]
 readme = "README.md"