plain.models 0.44.0__py3-none-any.whl → 0.46.0__py3-none-any.whl

plain/models/CHANGELOG.md

@@ -1,5 +1,28 @@
 # plain-models changelog
 
+## [0.46.0](https://github.com/dropseed/plain/releases/plain-models@0.46.0) (2025-09-25)
+
+### What's changed
+
+- The preflight system has been completely reworked with a new `PreflightResult` class that unifies messages and hints into a single `fix` field, providing clearer and more actionable error messages ([b0b610d](https://github.com/dropseed/plain/commit/b0b610d461), [c7cde12](https://github.com/dropseed/plain/commit/c7cde12149))
+- Preflight check IDs have been renamed to use descriptive names instead of numbers for better clarity (e.g., `models.E003` becomes `models.duplicate_many_to_many_relations`) ([cd96c97](https://github.com/dropseed/plain/commit/cd96c97b25))
+- Removed deprecated field types: `CommaSeparatedIntegerField`, `IPAddressField`, and `NullBooleanField` ([345295dc](https://github.com/dropseed/plain/commit/345295dc8a))
+- Removed `system_check_deprecated_details` and `system_check_removed_details` from fields ([e3a7d2dd](https://github.com/dropseed/plain/commit/e3a7d2dd10))
+
+### Upgrade instructions
+
+- Remove any usage of the deprecated field types `CommaSeparatedIntegerField`, `IPAddressField`, and `NullBooleanField` - use `CharField`, `GenericIPAddressField`, and `BooleanField(null=True)` respectively
+
+## [0.45.0](https://github.com/dropseed/plain/releases/plain-models@0.45.0) (2025-09-21)
+
+### What's changed
+
+- Added unlimited varchar support to SQLite - CharField fields without a max_length now generate `varchar` columns instead of `varchar()` with no length specified ([c5c0c3a](https://github.com/dropseed/plain/commit/c5c0c3a743))
+
+### Upgrade instructions
+
+- No changes required
+
 ## [0.44.0](https://github.com/dropseed/plain/releases/plain-models@0.44.0) (2025-09-19)
 
 ### What's changed

plain/models/backends/base/validation.py

@@ -4,7 +4,7 @@ class BaseDatabaseValidation:
     def __init__(self, connection):
         self.connection = connection
 
-    def check(self, **kwargs):
+    def preflight(self):
         return []
 
     def check_field(self, field, **kwargs):

plain/models/backends/mysql/base.py

@@ -102,7 +102,6 @@ class DatabaseWrapper(BaseDatabaseWrapper):
         "FloatField": "double precision",
         "IntegerField": "integer",
         "BigIntegerField": "bigint",
-        "IPAddressField": "char(15)",
         "GenericIPAddressField": "char(39)",
         "JSONField": "json",
         "PositiveBigIntegerField": "bigint UNSIGNED",

plain/models/backends/mysql/validation.py

@@ -3,25 +3,24 @@ from plain.models.backends.base.validation import BaseDatabaseValidation
 
 
 class DatabaseValidation(BaseDatabaseValidation):
-    def check(self, **kwargs):
-        issues = super().check(**kwargs)
-        issues.extend(self._check_sql_mode(**kwargs))
+    def preflight(self):
+        issues = super().preflight()
+        issues.extend(self._check_sql_mode())
         return issues
 
-    def _check_sql_mode(self, **kwargs):
+    def _check_sql_mode(self):
         if not (
             self.connection.sql_mode & {"STRICT_TRANS_TABLES", "STRICT_ALL_TABLES"}
         ):
             return [
-                preflight.Warning(
-                    f"{self.connection.display_name} Strict Mode is not set for the database connection",
-                    hint=(
-                        f"{self.connection.display_name}'s Strict Mode fixes many data integrity problems in "
-                        f"{self.connection.display_name}, such as data truncation upon insertion, by "
-                        "escalating warnings into errors. It is strongly "
-                        "recommended you activate it.",
-                    ),
-                    id="mysql.W002",
+                preflight.PreflightResult(
+                    fix=f"{self.connection.display_name} Strict Mode is not set for the database connection. "
+                    f"{self.connection.display_name}'s Strict Mode fixes many data integrity problems in "
+                    f"{self.connection.display_name}, such as data truncation upon insertion, by "
+                    "escalating warnings into errors. It is strongly "
+                    "recommended you activate it.",
+                    id="mysql.strict_mode_not_enabled",
+                    warning=True,
                 )
             ]
         return []
@@ -40,11 +39,12 @@ class DatabaseValidation(BaseDatabaseValidation):
             and (field.max_length is None or int(field.max_length) > 255)
         ):
             errors.append(
-                preflight.Warning(
-                    f"{self.connection.display_name} may not allow unique CharFields to have a max_length "
+                preflight.PreflightResult(
+                    fix=f"{self.connection.display_name} may not allow unique CharFields to have a max_length "
                     "> 255.",
                     obj=field,
-                    id="mysql.W003",
+                    id="mysql.unique_charfield_max_length_too_long",
+                    warning=True,
                 )
             )
 

plain/models/backends/postgresql/base.py

@@ -100,7 +100,6 @@ class DatabaseWrapper(BaseDatabaseWrapper):
         "FloatField": "double precision",
         "IntegerField": "integer",
         "BigIntegerField": "bigint",
-        "IPAddressField": "inet",
         "GenericIPAddressField": "inet",
         "JSONField": "jsonb",
         "PositiveBigIntegerField": "bigint",

plain/models/backends/postgresql/operations.py

@@ -51,7 +51,6 @@ class DatabaseOperations(BaseDatabaseOperations):
         internal_type = output_field.get_internal_type()
         if internal_type in (
             "GenericIPAddressField",
-            "IPAddressField",
             "TimeField",
             "UUIDField",
         ):
@@ -165,7 +164,7 @@ class DatabaseOperations(BaseDatabaseOperations):
             "regex",
             "iregex",
         ):
-            if internal_type in ("IPAddressField", "GenericIPAddressField"):
+            if internal_type == "GenericIPAddressField":
                 lookup = "HOST(%s)"
             else:
                 lookup = "%s::text"

plain/models/backends/sqlite3/base.py

@@ -39,6 +39,12 @@ def adapt_datetime(val):
     return val.isoformat(" ")
 
 
+def _get_varchar_column(data):
+    if data["max_length"] is None:
+        return "varchar"
+    return "varchar({max_length})".format(**data)
+
+
 Database.register_converter("bool", b"1".__eq__)
 Database.register_converter("date", decoder(parse_date))
 Database.register_converter("time", decoder(parse_time))
@@ -60,7 +66,7 @@ class DatabaseWrapper(BaseDatabaseWrapper):
         "PrimaryKeyField": "integer",
         "BinaryField": "BLOB",
         "BooleanField": "bool",
-        "CharField": "varchar(%(max_length)s)",
+        "CharField": _get_varchar_column,
         "DateField": "date",
         "DateTimeField": "datetime",
         "DecimalField": "decimal",
@@ -68,7 +74,6 @@ class DatabaseWrapper(BaseDatabaseWrapper):
         "FloatField": "real",
         "IntegerField": "integer",
         "BigIntegerField": "bigint",
-        "IPAddressField": "char(15)",
         "GenericIPAddressField": "char(39)",
         "JSONField": "text",
         "PositiveBigIntegerField": "bigint unsigned",

plain/models/backends/sqlite3/features.py

@@ -31,6 +31,7 @@ class DatabaseFeatures(BaseDatabaseFeatures):
     supports_json_field_contains = False
     supports_update_conflicts = Database.sqlite_version_info >= (3, 24, 0)
     supports_update_conflicts_with_target = supports_update_conflicts
+    supports_unlimited_charfield = True
 
     @cached_property
     def supports_atomic_references_rename(self):