django-display-ids 0.5.0__py3-none-any.whl → 0.5.1__py3-none-any.whl

django_display_ids/managers.py

@@ -187,6 +187,69 @@ class DisplayIDQuerySet(models.QuerySet[M]):
         # Execute the query
         return self.get(**lookup)
 
+    def resolve_identifier(
+        self,
+        value: str | uuid.UUID,
+        *,
+        strategies: tuple[StrategyName, ...] | None = None,
+        prefix: str | None = None,
+    ) -> uuid.UUID:
+        """Resolve an identifier to a UUID without fetching the object.
+
+        For UUID and display_id identifiers, the UUID is extracted by parsing
+        alone — no database query is needed. Only slug identifiers require a
+        database lookup.
+
+        This is useful for cursor-based pagination where you need the UUID
+        value to build a WHERE clause but don't need the full model instance.
+
+        Args:
+            value: The identifier string (display ID, UUID, or slug),
+                or a UUID instance (returned as-is).
+            strategies: Strategies to try. Defaults to settings.
+            prefix: Expected display ID prefix for validation.
+
+        Returns:
+            The resolved UUID value.
+
+        Raises:
+            Model.DoesNotExist: If the identifier cannot be parsed or
+                no matching object exists (slug lookup).
+            Model.MultipleObjectsReturned: If multiple objects match (slug).
+        """
+        model = self.model
+        uuid_field = self._get_uuid_field()
+
+        # UUID objects are returned as-is
+        if isinstance(value, uuid.UUID):
+            return value
+
+        slug_field = self._get_slug_field()
+        expected_prefix = prefix or self._get_model_prefix()
+        lookup_strategies = strategies or self._get_strategies()
+
+        # Skip slug strategy if the model has no slug field
+        if not self._has_slug_field(slug_field):
+            lookup_strategies = tuple(s for s in lookup_strategies if s != "slug")
+
+        # Parse the identifier
+        try:
+            result = parse_identifier(
+                value, lookup_strategies, expected_prefix=expected_prefix
+            )
+        except DisplayIDLookupError as e:
+            raise model.DoesNotExist(  # type: ignore[attr-defined]
+                f"{model.__name__}: {e}"
+            ) from e
+
+        # UUID and display_id strategies yield a UUID directly — no DB query
+        if result.strategy in ("uuid", "display_id"):
+            return result.uuid  # type: ignore[return-value]
+
+        # Slug strategy requires a DB lookup
+        obj = self.get(**{slug_field: result.slug})
+        return getattr(obj, uuid_field)  # type: ignore[no-any-return]
+
     def get_by_identifiers(
         self,
         values: Sequence[str | uuid.UUID],
@@ -335,6 +398,21 @@ class DisplayIDManager(models.Manager[M]):
             value, strategies=strategies, prefix=prefix
         )
 
+    def resolve_identifier(
+        self,
+        value: str | uuid.UUID,
+        *,
+        strategies: tuple[StrategyName, ...] | None = None,
+        prefix: str | None = None,
+    ) -> uuid.UUID:
+        """Resolve an identifier to a UUID without fetching the object.
+
+        See DisplayIDQuerySet.resolve_identifier for details.
+        """
+        return self.get_queryset().resolve_identifier(
+            value, strategies=strategies, prefix=prefix
+        )
+
     def get_by_identifiers(
         self,
         values: Sequence[str | uuid.UUID],

{django_display_ids-0.5.0.dist-info → django_display_ids-0.5.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: django-display-ids
-Version: 0.5.0
+Version: 0.5.1
 Summary: Stripe-like prefixed IDs for Django. Works with existing UUIDs — no schema changes.
 Keywords: django,stripe,uuid,base62,prefixed-id,drf,shortuuid,nanoid,ulid
 License: MIT

{django_display_ids-0.5.0.dist-info → django_display_ids-0.5.1.dist-info}/RECORD

@@ -11,7 +11,7 @@ django_display_ids/converters.py,sha256=KGD5FYWkuXztO-6TvTtPwMP7xbnAXAaYuk9LvIpx
 django_display_ids/encoding.py,sha256=csIwUZaQKSOLwRU6-DWGTNGvSxmroyK0Yt7TBCo0AFE,2945
 django_display_ids/examples.py,sha256=gap5NNPTmE7B5uxiYKoMoK8G-OEtL1Ek0W039l6oJ9I,2689
 django_display_ids/exceptions.py,sha256=68Kmp9Qdyg3LtzmXfDHIWRuI7MW3M2acZ3C6Wi8zFEw,4489
-django_display_ids/managers.py,sha256=tQ1ryAIClAg-mhDp5CgkCEqxld9XVMe6fl-u__DSiOI,11831
+django_display_ids/managers.py,sha256=Oy0uOb2n7OSXXH2yCN2Cec5O2tvYty4cYIzJkmHbj_8,14716
 django_display_ids/models.py,sha256=_hmgAR4HC3I-5wU2DND6uNLjEllu1Y9eaXeBQ9dWMNI,4313
 django_display_ids/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 django_display_ids/resolver.py,sha256=blyLo06tIYrYqOA9Ir260tzs9njX1GMAE6ICDJTwfGk,3485
@@ -20,6 +20,6 @@ django_display_ids/templatetags/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm
 django_display_ids/templatetags/display_ids.py,sha256=4KHE8r8mgSKb7LgIuXJaJB_3UGrzRZvTdLqSCYQtb5I,1157
 django_display_ids/typing.py,sha256=hxX2QVYtkvFXZBH9ZskbV98N-uOhX_XAMoO-UOBRnEA,568
 django_display_ids/views.py,sha256=OOhv5G6ake8Siv-yAFFA1s2wOuNng9NYETS1feDygio,4662
-django_display_ids-0.5.0.dist-info/WHEEL,sha256=iHtWm8nRfs0VRdCYVXocAWFW8ppjHL-uTJkAdZJKOBM,80
-django_display_ids-0.5.0.dist-info/METADATA,sha256=twAX7DSsXtTAbGl5IJbZaJ7MrjndlQV1TVin1nhsLhI,5249
-django_display_ids-0.5.0.dist-info/RECORD,,
+django_display_ids-0.5.1.dist-info/WHEEL,sha256=iHtWm8nRfs0VRdCYVXocAWFW8ppjHL-uTJkAdZJKOBM,80
+django_display_ids-0.5.1.dist-info/METADATA,sha256=WImPRXMdSGsx6FU099koONUtetahmJhAV1LVgzNi1jQ,5249
+django_display_ids-0.5.1.dist-info/RECORD,,