plain.models 0.40.0__py3-none-any.whl → 0.41.0__py3-none-any.whl

plain/models/AGENTS.md

@@ -0,0 +1,4 @@
+# Plain Models AGENTS.md
+
+- Use the `plain makemigrations` command to create new migrations. Only write migrations by hand if they are custom data migrations.
+- Use `plain migrate --backup` to run migrations.

plain/models/CHANGELOG.md

@@ -1,5 +1,29 @@
 # plain-models changelog
 
+## [0.41.0](https://github.com/dropseed/plain/releases/plain-models@0.41.0) (2025-09-09)
+
+### What's changed
+
+- Python 3.13 is now the minimum required version ([d86e307](https://github.com/dropseed/plain/commit/d86e307))
+- Removed the `earliest()`, `latest()`, and `get_latest_by` model meta option - use `order_by().first()` and `order_by().last()` instead ([b6093a8](https://github.com/dropseed/plain/commit/b6093a8))
+- Removed automatic ordering in `first()` and `last()` queryset methods - they now respect the existing queryset ordering without adding default ordering ([adc19a6](https://github.com/dropseed/plain/commit/adc19a6))
+- Added code location attributes to database operation tracing, showing the source file, line number, and function where the query originated ([da36a17](https://github.com/dropseed/plain/commit/da36a17))
+
+### Upgrade instructions
+
+- Replace usage of `earliest()`, `latest()`, and model `Meta` `get_latest_by` queryset methods with equivalent `order_by().first()` or `order_by().last()` calls
+- The `first()` and `last()` methods no longer automatically add ordering by `id` - explicitly add `.order_by()` to your querysets or `ordering` to your models `Meta` class if needed
+
+## [0.40.1](https://github.com/dropseed/plain/releases/plain-models@0.40.1) (2025-09-03)
+
+### What's changed
+
+- Internal documentation updates for agent commands ([df3edbf0bd](https://github.com/dropseed/plain/commit/df3edbf0bd))
+
+### Upgrade instructions
+
+- No changes required
+
 ## [0.40.0](https://github.com/dropseed/plain/releases/plain-models@0.40.0) (2025-08-05)
 
 ### What's changed

plain/models/migrations/operations/models.py

@@ -450,7 +450,6 @@ class AlterModelOptions(ModelOptionOperation):
         "base_manager_name",
         "default_manager_name",
         "default_related_name",
-        "get_latest_by",
         "ordering",
     ]
 

plain/models/options.py

@@ -25,7 +25,6 @@ DEFAULT_NAMES = (
     "db_table",
     "db_table_comment",
     "ordering",
-    "get_latest_by",
     "package_label",
     "models_registry",
     "default_related_name",
@@ -74,7 +73,6 @@ class Options:
         self.constraints = []
         self.object_name = None
         self.package_label = package_label
-        self.get_latest_by = None
         self.required_db_features = []
         self.required_db_vendor = None
         self.meta = meta

plain/models/otel.py

@@ -1,4 +1,5 @@
 import re
+import traceback
 from contextlib import contextmanager
 from typing import Any
 
@@ -8,6 +9,13 @@ from opentelemetry.semconv._incubating.attributes.db_attributes import (
     DB_QUERY_PARAMETER_TEMPLATE,
     DB_USER,
 )
+from opentelemetry.semconv.attributes.code_attributes import (
+    CODE_COLUMN_NUMBER,
+    CODE_FILE_PATH,
+    CODE_FUNCTION_NAME,
+    CODE_LINE_NUMBER,
+    CODE_STACKTRACE,
+)
 from opentelemetry.semconv.attributes.db_attributes import (
     DB_COLLECTION_NAME,
     DB_NAMESPACE,
@@ -126,6 +134,8 @@ def db_span(db, sql: Any, *, many: bool = False, params=None):
         DB_OPERATION_NAME: operation,
     }
 
+    attrs.update(_get_code_attributes())
+
     # Add collection name if detected
     if collection_name:
         attrs[DB_COLLECTION_NAME] = collection_name
@@ -173,3 +183,43 @@ def suppress_db_tracing():
         yield
     finally:
         otel_context.detach(token)
+
+
+def _get_code_attributes():
+    """Extract code context attributes for the current database query.
+
+    Returns a dict of OpenTelemetry code attributes.
+    """
+    stack = traceback.extract_stack()
+
+    # Find the user code frame
+    for frame in reversed(stack):
+        filepath = frame.filename
+        if not filepath:
+            continue
+
+        if "/plain/models/" in filepath:
+            continue
+
+        if filepath.endswith("contextlib.py"):
+            continue
+
+        # Found user code - build attributes dict
+        attrs = {}
+
+        if filepath:
+            attrs[CODE_FILE_PATH] = filepath
+        if frame.lineno:
+            attrs[CODE_LINE_NUMBER] = frame.lineno
+        if frame.name:
+            attrs[CODE_FUNCTION_NAME] = frame.name
+        if frame.colno:
+            attrs[CODE_COLUMN_NUMBER] = frame.colno
+
+        # Add full stack trace only in DEBUG mode (expensive)
+        if settings.DEBUG:
+            attrs[CODE_STACKTRACE] = "".join(traceback.format_stack())
+
+        return attrs
+
+    return {}

plain/models/query.py

@@ -873,59 +873,14 @@ class QuerySet:
             )
         return params
 
-    def _earliest(self, *fields):
-        """
-        Return the earliest object according to fields (if given) or by the
-        model's Meta.get_latest_by.
-        """
-        if fields:
-            order_by = fields
-        else:
-            order_by = getattr(self.model._meta, "get_latest_by")
-            if order_by and not isinstance(order_by, tuple | list):
-                order_by = (order_by,)
-        if order_by is None:
-            raise ValueError(
-                "earliest() and latest() require either fields as positional "
-                "arguments or 'get_latest_by' in the model's Meta."
-            )
-        obj = self._chain()
-        obj.query.set_limits(high=1)
-        obj.query.clear_ordering(force=True)
-        obj.query.add_ordering(*order_by)
-        return obj.get()
-
-    def earliest(self, *fields):
-        if self.query.is_sliced:
-            raise TypeError("Cannot change a query once a slice has been taken.")
-        return self._earliest(*fields)
-
-    def latest(self, *fields):
-        """
-        Return the latest object according to fields (if given) or by the
-        model's Meta.get_latest_by.
-        """
-        if self.query.is_sliced:
-            raise TypeError("Cannot change a query once a slice has been taken.")
-        return self.reverse()._earliest(*fields)
-
     def first(self):
         """Return the first object of a query or None if no match is found."""
-        if self.ordered:
-            queryset = self
-        else:
-            self._check_ordering_first_last_queryset_aggregation(method="first")
-            queryset = self.order_by("id")
-        for obj in queryset[:1]:
+        for obj in self[:1]:
             return obj
 
     def last(self):
         """Return the last object of a query or None if no match is found."""
-        if self.ordered:
-            queryset = self.reverse()
-        else:
-            self._check_ordering_first_last_queryset_aggregation(method="last")
-            queryset = self.order_by("-id")
+        queryset = self.reverse()
         for obj in queryset[:1]:
             return obj
 
@@ -1763,16 +1718,6 @@ class QuerySet:
         if self.query.combinator or other.query.combinator:
             raise TypeError(f"Cannot use {operator_} operator with combined queryset.")
 
-    def _check_ordering_first_last_queryset_aggregation(self, method):
-        if isinstance(self.query.group_by, tuple) and not any(
-            col.output_field is self.model._meta.get_field("id")
-            for col in self.query.group_by
-        ):
-            raise TypeError(
-                f"Cannot use QuerySet.{method}() on an unordered queryset performing "
-                f"aggregation. Add an ordering with order_by()."
-            )
-
 
 class InstanceCheckMeta(type):
     def __instancecheck__(self, instance):

{plain_models-0.40.0.dist-info → plain_models-0.41.0.dist-info}/METADATA

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: plain.models
-Version: 0.40.0
+Version: 0.41.0
 Summary: Model your data and store it in a database.
 Author-email: Dave Gaeddert <dave.gaeddert@dropseed.dev>
 License-File: LICENSE
-Requires-Python: >=3.11
+Requires-Python: >=3.13
 Requires-Dist: plain<1.0.0
 Requires-Dist: sqlparse>=0.3.1
 Description-Content-Type: text/markdown

{plain_models-0.40.0.dist-info → plain_models-0.41.0.dist-info}/RECORD

@@ -1,4 +1,5 @@
-plain/models/CHANGELOG.md,sha256=aNi4zsWMbFRKdV1O5x9Du-fKepQl3jj6x7Ksu3rcIXI,9295
+plain/models/AGENTS.md,sha256=xQQW-z-DehnCUyjiGSBfLqUjoSUdo_W1b0JmwYmWieA,209
+plain/models/CHANGELOG.md,sha256=2A4tByZg03dkzz_A5larJoF2eZx6rDtNPrAto0f2i1I,10788
 plain/models/README.md,sha256=uibhtLwH-JUGzpW3tCFUrQo19i2RAvet1EkpyItdFxM,7269
 plain/models/__init__.py,sha256=LJhlJauhTfUySY2hTJ9qBhCbEKMxTDKpeVrjYXZnsCw,2964
 plain/models/aggregates.py,sha256=P0mhsMl1VZt2CVHMuCHnNI8SxZ9citjDLEgioN6NOpo,7240
@@ -20,10 +21,10 @@ plain/models/forms.py,sha256=FUBgt1P-4JmSQeigdITYqZPYqDI89XZQfPtdr8ffgsc,25816
 plain/models/indexes.py,sha256=fazIZPJgCX5_Bhwk7MQy3YbWOxpHvaCe1dDLGGldTuY,11540
 plain/models/lookups.py,sha256=eCsxQXUcOoAa_U_fAAd3edcgXI1wfyFW8hPgUh8TwTo,24776
 plain/models/manager.py,sha256=zc2W-vTTk3zkDXCds5-TCXgLhVmM4PdQb-qtu-njeLQ,5827
-plain/models/options.py,sha256=jiFlj1jQ9FH4uNrNePGEWwfrs8rLvDaHTIw9d1zMgAk,23627
-plain/models/otel.py,sha256=OCG6ZXbaQmAwvjjAHwH6ISFXJ651W942m2dFu87Pmi8,5893
+plain/models/options.py,sha256=1EtFAXG3RqwoT8DzRKUmZvfXlhk98MvCf4q4FG6jBN4,23572
+plain/models/otel.py,sha256=BtNx0ZqDmBD9nzWV6FboEJ2j8kxPDmNhSl52VfXF-bY,7168
 plain/models/preflight.py,sha256=PlS1S2YHEpSKZ57KbTP6TbED98dDDXYSBUk6xMIpgsI,8136
-plain/models/query.py,sha256=T_1H533CuxaenHEWKovRq-4QF2rTqGtq_4vw7BnfWgY,92653
+plain/models/query.py,sha256=i9wDYzi3hjlLSjUih3yykwERLZT23m1gZ56jqmZth7Y,90520
 plain/models/query_utils.py,sha256=Ny7PZJ5GduDrdzAT2ALtcKge780QP3w-ARTBqHNOu6U,14178
 plain/models/registry.py,sha256=5yxVgT_W8GlyL2bsGT2HvMQB5sKolXucP2qrhr7Wlnk,8126
 plain/models/transaction.py,sha256=KqkRDT6aqMgbPA_ch7qO8a9NyDvwY_2FaxM7FkBkcgY,9357
@@ -102,7 +103,7 @@ plain/models/migrations/writer.py,sha256=N8Rnjv5ccsA_CTcS7zZyppzyHFOUQVJy0l6RZYj
 plain/models/migrations/operations/__init__.py,sha256=C8VTJbzvFgt7AXTPvtuY8HF1FC8rqNvsXMOCW26UV9E,802
 plain/models/migrations/operations/base.py,sha256=JsKGjM6ouvEbFHzV14km7YjkpOUC4PoUR1M2yGZ82bE,4323
 plain/models/migrations/operations/fields.py,sha256=ARL945rbztAnMsbd0lvQRsQJEmxYA3gDof0-4aOTeC4,11255
-plain/models/migrations/operations/models.py,sha256=bdsEhCCi6UJVxKaNA4wJUGrU9ZmeqZZItJUBZ-2a4TM,26855
+plain/models/migrations/operations/models.py,sha256=kZc9zYK3Q3NyLV98oj-RYRyocIbFdt4QNyryOrQJAMM,26830
 plain/models/migrations/operations/special.py,sha256=SiL_7u3rSj35uhc8JPmFHtItt_k_EgbLhY-TEXfmkaI,5162
 plain/models/sql/__init__.py,sha256=FoRCcab-kh_XY8C4eldgLy9-zuk-M63Nyi9cFsYjclU,225
 plain/models/sql/compiler.py,sha256=UzqJljjKfjidz8TW0tr8CucLF2Y0xmdsW9Rpnm_1Sc4,84701
@@ -114,8 +115,8 @@ plain/models/sql/where.py,sha256=ezE9Clt2BmKo-I7ARsgqZ_aVA-1UdayCwr6ULSWZL6c,126
 plain/models/test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 plain/models/test/pytest.py,sha256=KD5-mxonBxOYIhUh9Ql5uJOIiC9R4t-LYfb6sjA0UdE,3486
 plain/models/test/utils.py,sha256=S3d6zf3OFWDxB_kBJr0tDvwn51bjwDVWKPumv37N-p8,467
-plain_models-0.40.0.dist-info/METADATA,sha256=jIaS3eoDJumh9HhSOzA-bXfTYB75h5MketBZH37kV0Q,7581
-plain_models-0.40.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-plain_models-0.40.0.dist-info/entry_points.txt,sha256=IYJAW9MpL3PXyXFWmKmALagAGXC_5rzBn2eEGJlcV04,112
-plain_models-0.40.0.dist-info/licenses/LICENSE,sha256=m0D5O7QoH9l5Vz_rrX_9r-C8d9UNr_ciK6Qwac7o6yo,3175
-plain_models-0.40.0.dist-info/RECORD,,
+plain_models-0.41.0.dist-info/METADATA,sha256=9Qxx7j7nc5sZ-bYTz1IEcV4Bql9c_mHj1ar9qkg9O6g,7581
+plain_models-0.41.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+plain_models-0.41.0.dist-info/entry_points.txt,sha256=IYJAW9MpL3PXyXFWmKmALagAGXC_5rzBn2eEGJlcV04,112
+plain_models-0.41.0.dist-info/licenses/LICENSE,sha256=m0D5O7QoH9l5Vz_rrX_9r-C8d9UNr_ciK6Qwac7o6yo,3175
+plain_models-0.41.0.dist-info/RECORD,,