fix: add warning message when using fallback value for a primary key (#529)

Add warning to indicate that the `nanoid` / `uuid-utils` libraries are missing and behavior is falling back to a built-in.

Author: Harshal6927

advanced_alchemy/mixins/nanoid.py

@@ -1,4 +1,5 @@
-from typing import TYPE_CHECKING
+import logging
+from typing import TYPE_CHECKING, Any
 
 from sqlalchemy.orm import Mapped, declarative_mixin, mapped_column
 
@@ -12,10 +13,17 @@
 else:
     from uuid import uuid4 as nanoid  # type: ignore[assignment,unused-ignore]
 
+logger = logging.getLogger("advanced_alchemy")
+
 
 @declarative_mixin
 class NanoIDPrimaryKey(SentinelMixin):
     """Nano ID Primary Key Field Mixin."""
 
+    def __init_subclass__(cls, **kwargs: Any) -> None:
+        super().__init_subclass__(**kwargs)
+        if not NANOID_INSTALLED and not cls.__module__.startswith("advanced_alchemy"):  # pragma: no cover
+            logger.warning("`fastnanoid` not installed, falling back to `uuid4` for NanoID generation.")
+
     id: Mapped[str] = mapped_column(default=nanoid, primary_key=True)
     """Nano ID Primary key column."""

advanced_alchemy/mixins/uuid.py

@@ -1,4 +1,5 @@
-from typing import TYPE_CHECKING
+import logging
+from typing import TYPE_CHECKING, Any
 from uuid import UUID, uuid4
 
 from sqlalchemy.orm import Mapped, declarative_mixin, mapped_column
@@ -18,6 +19,8 @@
     uuid6 = uuid4  # type: ignore[assignment, unused-ignore]
     uuid7 = uuid4  # type: ignore[assignment, unused-ignore]
 
+logger = logging.getLogger("advanced_alchemy")
+
 
 @declarative_mixin
 class UUIDPrimaryKey(SentinelMixin):
@@ -31,6 +34,11 @@ class UUIDPrimaryKey(SentinelMixin):
 class UUIDv6PrimaryKey(SentinelMixin):
     """UUID v6 Primary Key Field Mixin."""
 
+    def __init_subclass__(cls, **kwargs: Any) -> None:
+        super().__init_subclass__(**kwargs)
+        if not UUID_UTILS_INSTALLED and not cls.__module__.startswith("advanced_alchemy"):  # pragma: no cover
+            logger.warning("`uuid-utils` not installed, falling back to `uuid4` for UUID v6 generation.")
+
     id: Mapped[UUID] = mapped_column(default=uuid6, primary_key=True)
     """UUID Primary key column."""
 
@@ -39,5 +47,10 @@ class UUIDv6PrimaryKey(SentinelMixin):
 class UUIDv7PrimaryKey(SentinelMixin):
     """UUID v7 Primary Key Field Mixin."""
 
+    def __init_subclass__(cls, **kwargs: Any) -> None:
+        super().__init_subclass__(**kwargs)
+        if not UUID_UTILS_INSTALLED and not cls.__module__.startswith("advanced_alchemy"):  # pragma: no cover
+            logger.warning("`uuid-utils` not installed, falling back to `uuid4` for UUID v7 generation.")
+
     id: Mapped[UUID] = mapped_column(default=uuid7, primary_key=True)
     """UUID Primary key column."""