feat!: remove the unused CacheError exception

changelog.d/130.removed.md

@@ -0,0 +1,3 @@
+**`fastapi_cachex.exceptions.CacheError` is removed.** Nothing in the package
+ever raised it, and it had emitted a `DeprecationWarning` since 0.3.8. Catch
+`CacheXError` instead.

docs/api/types.md

@@ -3,7 +3,3 @@
 ::: fastapi_cachex.types
 
 ::: fastapi_cachex.exceptions
-
-`fastapi_cachex.exceptions.CacheError` is deprecated since 0.3.8 and not listed
-above. Nothing in the package raises it, and accessing it emits a
-`DeprecationWarning`. Catch `CacheXError` instead. It will be removed in 0.4.0.

fastapi_cachex/exceptions.py

@@ -1,28 +1,10 @@
 """Custom exception classes for FastAPI-CacheX."""
 
-import warnings
-from typing import TYPE_CHECKING
-
 
 class CacheXError(Exception):
     """Base class for all exceptions in FastAPI-CacheX."""
 
 
-class _CacheError(CacheXError):
-    """Exception raised for cache-related errors.
-
-    .. deprecated:: 0.3.8
-        Never raised by FastAPI-CacheX. Catch :class:`CacheXError` instead.
-        Will be removed in version 0.4.0.
-    """
-
-
-_CacheError.__name__ = _CacheError.__qualname__ = "CacheError"
-
-if TYPE_CHECKING:
-    CacheError = _CacheError
-
-
 class BackendNotFoundError(CacheXError):
     """Exception raised when a cache backend is not found."""
 
@@ -42,17 +24,3 @@ class RequestNotFoundError(CacheXError):
 
 class LockTimeoutError(CacheXError, TimeoutError):
     """Exception raised when acquiring a lock or waiting for stampede protection times out."""
-
-
-def __getattr__(name: str) -> type[CacheXError]:
-    """Return the deprecated ``CacheError`` with a ``DeprecationWarning``."""
-    if name == "CacheError":
-        warnings.warn(
-            "CacheError is deprecated and never raised, catch CacheXError instead. "
-            "Will be removed in version 0.4.0.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
-        return _CacheError
-    msg = f"module {__name__!r} has no attribute {name!r}"
-    raise AttributeError(msg)