adctk.uuid_compat.UUID7Generator Class Reference

Public Member Functions
uuid.UUID	uuid7 (cls)

Protected Member Functions
None	_initialize (cls)

Static Protected Attributes
	_uuid7_func = None

Detailed Description

A wrapper class that provides UUIDv7 generation.

It uses the native standard library `uuid.uuid7` if available (Python >= 3.14).
Otherwise, it falls back to the third-party `uuid_utils`.

Member Function Documentation

_initialize()

None adctk.uuid_compat.UUID7Generator._initialize (   cls )

protected

Dynamically detects the best available UUIDv7 implementation.

    def _initialize(cls) -> None:
        """Dynamically detects the best available UUIDv7 implementation."""
        if hasattr(uuid, "uuid7"):
            cls._uuid7_func = uuid.uuid7
            return
 
        try:
            import uuid_utils
            cls._uuid7_func = uuid_utils.uuid7
            return
        except ImportError:
            pass
 
        try:
            import uuid6
            cls._uuid7_func = uuid6.uuid7
            warnings.warn(
                "Standard 'uuid.uuid7' and 'uuid_utils' not found. "
                "Falling back to slower, pure-Python 'uuid6' package.",
                RuntimeWarning
            )
            return
        except ImportError:
            pass
 
        raise ImportError(
            "No valid UUIDv7 implementation found. Please upgrade to "
            "Python >= 3.14 or install 'uuid-utils' via 'pip install uuid-utils'."
        )
 

uuid7()

uuid.UUID adctk.uuid_compat.UUID7Generator.uuid7

(

cls

)

Generates a UUIDv7 object using the best available backend.

Returns:
    uuid.UUID: A standard Python UUID object.

    def uuid7(cls) -> uuid.UUID:
        """Generates a UUIDv7 object using the best available backend.
        
        Returns:
            uuid.UUID: A standard Python UUID object.
        """
        if cls._uuid7_func is None:
            cls._initialize()
            
        return cls._uuid7_func()
 
 
# ==========================================
# Example Usage
# ==========================================

Member Data Documentation

_uuid7_func

adctk.uuid_compat.UUID7Generator._uuid7_func = None

staticprotected

---

The documentation for this class was generated from the following file:

• src/adctk/uuid_compat.py