plain.models 0.44.0__tar.gz → 0.46.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (138) hide show
  1. {plain_models-0.44.0 → plain_models-0.46.0}/PKG-INFO +1 -1
  2. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/CHANGELOG.md +23 -0
  3. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/base/validation.py +1 -1
  4. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/mysql/base.py +0 -1
  5. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/mysql/validation.py +16 -16
  6. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/postgresql/base.py +0 -1
  7. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/postgresql/operations.py +1 -2
  8. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/sqlite3/base.py +7 -2
  9. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/sqlite3/features.py +1 -0
  10. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/base.py +206 -234
  11. plain_models-0.46.0/plain/models/config.py +16 -0
  12. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/fields/__init__.py +117 -227
  13. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/fields/json.py +22 -22
  14. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/fields/mixins.py +11 -10
  15. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/fields/related.py +131 -119
  16. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/migrations/state.py +1 -1
  17. plain_models-0.46.0/plain/models/preflight.py +221 -0
  18. {plain_models-0.44.0 → plain_models-0.46.0}/pyproject.toml +1 -1
  19. plain_models-0.44.0/plain/models/config.py +0 -24
  20. plain_models-0.44.0/plain/models/preflight.py +0 -214
  21. {plain_models-0.44.0 → plain_models-0.46.0}/.gitignore +0 -0
  22. {plain_models-0.44.0 → plain_models-0.46.0}/LICENSE +0 -0
  23. {plain_models-0.44.0 → plain_models-0.46.0}/README.md +0 -0
  24. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/AGENTS.md +0 -0
  25. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/README.md +0 -0
  26. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/__init__.py +0 -0
  27. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/aggregates.py +0 -0
  28. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/__init__.py +0 -0
  29. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/base/__init__.py +0 -0
  30. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/base/base.py +0 -0
  31. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/base/client.py +0 -0
  32. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/base/creation.py +0 -0
  33. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/base/features.py +0 -0
  34. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/base/introspection.py +0 -0
  35. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/base/operations.py +0 -0
  36. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/base/schema.py +0 -0
  37. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/ddl_references.py +0 -0
  38. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/mysql/__init__.py +0 -0
  39. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/mysql/client.py +0 -0
  40. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/mysql/compiler.py +0 -0
  41. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/mysql/creation.py +0 -0
  42. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/mysql/features.py +0 -0
  43. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/mysql/introspection.py +0 -0
  44. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/mysql/operations.py +0 -0
  45. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/mysql/schema.py +0 -0
  46. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/postgresql/__init__.py +0 -0
  47. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/postgresql/client.py +0 -0
  48. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/postgresql/creation.py +0 -0
  49. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/postgresql/features.py +0 -0
  50. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/postgresql/introspection.py +0 -0
  51. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/postgresql/schema.py +0 -0
  52. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/sqlite3/__init__.py +0 -0
  53. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/sqlite3/_functions.py +0 -0
  54. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/sqlite3/client.py +0 -0
  55. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/sqlite3/creation.py +0 -0
  56. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/sqlite3/introspection.py +0 -0
  57. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/sqlite3/operations.py +0 -0
  58. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/sqlite3/schema.py +0 -0
  59. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backends/utils.py +0 -0
  60. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backups/__init__.py +0 -0
  61. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backups/cli.py +0 -0
  62. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backups/clients.py +0 -0
  63. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/backups/core.py +0 -0
  64. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/cli.py +0 -0
  65. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/connections.py +0 -0
  66. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/constants.py +0 -0
  67. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/constraints.py +0 -0
  68. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/database_url.py +0 -0
  69. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/db.py +0 -0
  70. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/default_settings.py +0 -0
  71. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/deletion.py +0 -0
  72. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/entrypoints.py +0 -0
  73. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/enums.py +0 -0
  74. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/exceptions.py +0 -0
  75. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/expressions.py +0 -0
  76. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/fields/related_descriptors.py +0 -0
  77. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/fields/related_lookups.py +0 -0
  78. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/fields/related_managers.py +0 -0
  79. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/fields/reverse_related.py +0 -0
  80. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/forms.py +0 -0
  81. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/functions/__init__.py +0 -0
  82. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/functions/comparison.py +0 -0
  83. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/functions/datetime.py +0 -0
  84. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/functions/math.py +0 -0
  85. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/functions/mixins.py +0 -0
  86. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/functions/text.py +0 -0
  87. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/functions/window.py +0 -0
  88. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/indexes.py +0 -0
  89. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/lookups.py +0 -0
  90. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/migrations/__init__.py +0 -0
  91. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/migrations/autodetector.py +0 -0
  92. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/migrations/exceptions.py +0 -0
  93. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/migrations/executor.py +0 -0
  94. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/migrations/graph.py +0 -0
  95. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/migrations/loader.py +0 -0
  96. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/migrations/migration.py +0 -0
  97. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/migrations/operations/__init__.py +0 -0
  98. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/migrations/operations/base.py +0 -0
  99. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/migrations/operations/fields.py +0 -0
  100. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/migrations/operations/models.py +0 -0
  101. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/migrations/operations/special.py +0 -0
  102. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/migrations/optimizer.py +0 -0
  103. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/migrations/questioner.py +0 -0
  104. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/migrations/recorder.py +0 -0
  105. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/migrations/serializer.py +0 -0
  106. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/migrations/utils.py +0 -0
  107. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/migrations/writer.py +0 -0
  108. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/options.py +0 -0
  109. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/otel.py +0 -0
  110. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/query.py +0 -0
  111. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/query_utils.py +0 -0
  112. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/registry.py +0 -0
  113. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/sql/__init__.py +0 -0
  114. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/sql/compiler.py +0 -0
  115. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/sql/constants.py +0 -0
  116. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/sql/datastructures.py +0 -0
  117. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/sql/query.py +0 -0
  118. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/sql/subqueries.py +0 -0
  119. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/sql/where.py +0 -0
  120. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/test/__init__.py +0 -0
  121. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/test/pytest.py +0 -0
  122. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/test/utils.py +0 -0
  123. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/transaction.py +0 -0
  124. {plain_models-0.44.0 → plain_models-0.46.0}/plain/models/utils.py +0 -0
  125. {plain_models-0.44.0 → plain_models-0.46.0}/tests/app/examples/migrations/0001_initial.py +0 -0
  126. {plain_models-0.44.0 → plain_models-0.46.0}/tests/app/examples/migrations/0002_test_field_removed.py +0 -0
  127. {plain_models-0.44.0 → plain_models-0.46.0}/tests/app/examples/migrations/0003_deleteparent_childsetnull_childsetdefault_and_more.py +0 -0
  128. {plain_models-0.44.0 → plain_models-0.46.0}/tests/app/examples/migrations/__init__.py +0 -0
  129. {plain_models-0.44.0 → plain_models-0.46.0}/tests/app/examples/models.py +0 -0
  130. {plain_models-0.44.0 → plain_models-0.46.0}/tests/app/settings.py +0 -0
  131. {plain_models-0.44.0 → plain_models-0.46.0}/tests/app/urls.py +0 -0
  132. {plain_models-0.44.0 → plain_models-0.46.0}/tests/test_database_url.py +0 -0
  133. {plain_models-0.44.0 → plain_models-0.46.0}/tests/test_delete_behaviors.py +0 -0
  134. {plain_models-0.44.0 → plain_models-0.46.0}/tests/test_exceptions.py +0 -0
  135. {plain_models-0.44.0 → plain_models-0.46.0}/tests/test_manager_assignment.py +0 -0
  136. {plain_models-0.44.0 → plain_models-0.46.0}/tests/test_models.py +0 -0
  137. {plain_models-0.44.0 → plain_models-0.46.0}/tests/test_related_descriptors.py +0 -0
  138. {plain_models-0.44.0 → plain_models-0.46.0}/tests/test_related_manager_api.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: plain.models
3
- Version: 0.44.0
3
+ Version: 0.46.0
4
4
  Summary: Model your data and store it in a database.
5
5
  Author-email: Dave Gaeddert <dave.gaeddert@dropseed.dev>
6
6
  License-File: LICENSE
@@ -1,5 +1,28 @@
1
1
  # plain-models changelog
2
2
 
3
+ ## [0.46.0](https://github.com/dropseed/plain/releases/plain-models@0.46.0) (2025-09-25)
4
+
5
+ ### What's changed
6
+
7
+ - 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))
8
+ - 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))
9
+ - Removed deprecated field types: `CommaSeparatedIntegerField`, `IPAddressField`, and `NullBooleanField` ([345295dc](https://github.com/dropseed/plain/commit/345295dc8a))
10
+ - Removed `system_check_deprecated_details` and `system_check_removed_details` from fields ([e3a7d2dd](https://github.com/dropseed/plain/commit/e3a7d2dd10))
11
+
12
+ ### Upgrade instructions
13
+
14
+ - Remove any usage of the deprecated field types `CommaSeparatedIntegerField`, `IPAddressField`, and `NullBooleanField` - use `CharField`, `GenericIPAddressField`, and `BooleanField(null=True)` respectively
15
+
16
+ ## [0.45.0](https://github.com/dropseed/plain/releases/plain-models@0.45.0) (2025-09-21)
17
+
18
+ ### What's changed
19
+
20
+ - 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))
21
+
22
+ ### Upgrade instructions
23
+
24
+ - No changes required
25
+
3
26
  ## [0.44.0](https://github.com/dropseed/plain/releases/plain-models@0.44.0) (2025-09-19)
4
27
 
5
28
  ### What's changed
@@ -4,7 +4,7 @@ class BaseDatabaseValidation:
4
4
  def __init__(self, connection):
5
5
  self.connection = connection
6
6
 
7
- def check(self, **kwargs):
7
+ def preflight(self):
8
8
  return []
9
9
 
10
10
  def check_field(self, field, **kwargs):
@@ -102,7 +102,6 @@ class DatabaseWrapper(BaseDatabaseWrapper):
102
102
  "FloatField": "double precision",
103
103
  "IntegerField": "integer",
104
104
  "BigIntegerField": "bigint",
105
- "IPAddressField": "char(15)",
106
105
  "GenericIPAddressField": "char(39)",
107
106
  "JSONField": "json",
108
107
  "PositiveBigIntegerField": "bigint UNSIGNED",
@@ -3,25 +3,24 @@ from plain.models.backends.base.validation import BaseDatabaseValidation
3
3
 
4
4
 
5
5
  class DatabaseValidation(BaseDatabaseValidation):
6
- def check(self, **kwargs):
7
- issues = super().check(**kwargs)
8
- issues.extend(self._check_sql_mode(**kwargs))
6
+ def preflight(self):
7
+ issues = super().preflight()
8
+ issues.extend(self._check_sql_mode())
9
9
  return issues
10
10
 
11
- def _check_sql_mode(self, **kwargs):
11
+ def _check_sql_mode(self):
12
12
  if not (
13
13
  self.connection.sql_mode & {"STRICT_TRANS_TABLES", "STRICT_ALL_TABLES"}
14
14
  ):
15
15
  return [
16
- preflight.Warning(
17
- f"{self.connection.display_name} Strict Mode is not set for the database connection",
18
- hint=(
19
- f"{self.connection.display_name}'s Strict Mode fixes many data integrity problems in "
20
- f"{self.connection.display_name}, such as data truncation upon insertion, by "
21
- "escalating warnings into errors. It is strongly "
22
- "recommended you activate it.",
23
- ),
24
- id="mysql.W002",
16
+ preflight.PreflightResult(
17
+ fix=f"{self.connection.display_name} Strict Mode is not set for the database connection. "
18
+ f"{self.connection.display_name}'s Strict Mode fixes many data integrity problems in "
19
+ f"{self.connection.display_name}, such as data truncation upon insertion, by "
20
+ "escalating warnings into errors. It is strongly "
21
+ "recommended you activate it.",
22
+ id="mysql.strict_mode_not_enabled",
23
+ warning=True,
25
24
  )
26
25
  ]
27
26
  return []
@@ -40,11 +39,12 @@ class DatabaseValidation(BaseDatabaseValidation):
40
39
  and (field.max_length is None or int(field.max_length) > 255)
41
40
  ):
42
41
  errors.append(
43
- preflight.Warning(
44
- f"{self.connection.display_name} may not allow unique CharFields to have a max_length "
42
+ preflight.PreflightResult(
43
+ fix=f"{self.connection.display_name} may not allow unique CharFields to have a max_length "
45
44
  "> 255.",
46
45
  obj=field,
47
- id="mysql.W003",
46
+ id="mysql.unique_charfield_max_length_too_long",
47
+ warning=True,
48
48
  )
49
49
  )
50
50
 
@@ -100,7 +100,6 @@ class DatabaseWrapper(BaseDatabaseWrapper):
100
100
  "FloatField": "double precision",
101
101
  "IntegerField": "integer",
102
102
  "BigIntegerField": "bigint",
103
- "IPAddressField": "inet",
104
103
  "GenericIPAddressField": "inet",
105
104
  "JSONField": "jsonb",
106
105
  "PositiveBigIntegerField": "bigint",
@@ -51,7 +51,6 @@ class DatabaseOperations(BaseDatabaseOperations):
51
51
  internal_type = output_field.get_internal_type()
52
52
  if internal_type in (
53
53
  "GenericIPAddressField",
54
- "IPAddressField",
55
54
  "TimeField",
56
55
  "UUIDField",
57
56
  ):
@@ -165,7 +164,7 @@ class DatabaseOperations(BaseDatabaseOperations):
165
164
  "regex",
166
165
  "iregex",
167
166
  ):
168
- if internal_type in ("IPAddressField", "GenericIPAddressField"):
167
+ if internal_type == "GenericIPAddressField":
169
168
  lookup = "HOST(%s)"
170
169
  else:
171
170
  lookup = "%s::text"
@@ -39,6 +39,12 @@ def adapt_datetime(val):
39
39
  return val.isoformat(" ")
40
40
 
41
41
 
42
+ def _get_varchar_column(data):
43
+ if data["max_length"] is None:
44
+ return "varchar"
45
+ return "varchar({max_length})".format(**data)
46
+
47
+
42
48
  Database.register_converter("bool", b"1".__eq__)
43
49
  Database.register_converter("date", decoder(parse_date))
44
50
  Database.register_converter("time", decoder(parse_time))
@@ -60,7 +66,7 @@ class DatabaseWrapper(BaseDatabaseWrapper):
60
66
  "PrimaryKeyField": "integer",
61
67
  "BinaryField": "BLOB",
62
68
  "BooleanField": "bool",
63
- "CharField": "varchar(%(max_length)s)",
69
+ "CharField": _get_varchar_column,
64
70
  "DateField": "date",
65
71
  "DateTimeField": "datetime",
66
72
  "DecimalField": "decimal",
@@ -68,7 +74,6 @@ class DatabaseWrapper(BaseDatabaseWrapper):
68
74
  "FloatField": "real",
69
75
  "IntegerField": "integer",
70
76
  "BigIntegerField": "bigint",
71
- "IPAddressField": "char(15)",
72
77
  "GenericIPAddressField": "char(39)",
73
78
  "JSONField": "text",
74
79
  "PositiveBigIntegerField": "bigint unsigned",
@@ -31,6 +31,7 @@ class DatabaseFeatures(BaseDatabaseFeatures):
31
31
  supports_json_field_contains = False
32
32
  supports_update_conflicts = Database.sqlite_version_info >= (3, 24, 0)
33
33
  supports_update_conflicts_with_target = supports_update_conflicts
34
+ supports_unlimited_charfield = True
34
35
 
35
36
  @cached_property
36
37
  def supports_atomic_references_rename(self):