persidict 0.37.2__py3-none-any.whl → 0.103.0__py3-none-any.whl

persidict/jokers.py

@@ -1,99 +0,0 @@
-"""Special singleton markers used to modify values in PersiDict without data payload.
-
-This module defines two singleton flags used as "joker" values when writing to
-persistent dictionaries:
-
-- KEEP_CURRENT: keep the current value unchanged.
-- DELETE_CURRENT: delete the current value if it exists.
-
-These flags are intended to be passed as the value part in dict-style
-assignments (e.g., d[key] = KEEP_CURRENT) and are interpreted by PersiDict
-implementations.
-
-Examples:
-    >>> from persidict.jokers import KEEP_CURRENT, DELETE_CURRENT
-    >>> d[key] = KEEP_CURRENT  # Do not alter existing value
-    >>> d[key] = DELETE_CURRENT  # Remove key if present
-"""
-from typing import Any
-
-from parameterizable import (
-    ParameterizableClass
-    , register_parameterizable_class)
-
-
-class Joker(ParameterizableClass):
-    """Base class for singleton joker flags.
-
-    Implements a per-subclass singleton pattern and integrates with the
-    parameterizable framework. Subclasses represent value-less commands that
-    alter persistence behavior when assigned to a key.
-
-    Note:
-        This class uses a singleton pattern where each subclass maintains
-        exactly one instance that is returned on every instantiation.
-    """
-    _instances: dict[type, "Joker"] = {}
-
-    def get_params(self) -> dict[str, Any]:
-        """Return parameters for parameterizable API.
-
-        Returns:
-            dict[str, Any]: Always an empty dict for joker flags.
-        """
-        return {}
-
-    def __new__(cls):
-        """Create or return the singleton instance for the subclass.
-        
-        Args:
-            cls: The class for which to create or retrieve the singleton instance.
-            
-        Returns:
-            Joker: The singleton instance for the specified class.
-        """
-        if cls not in Joker._instances:
-            Joker._instances[cls] = super().__new__(cls)
-        return Joker._instances[cls]
-
-
-class KeepCurrentFlag(Joker):
-    """Flag instructing PersiDict to keep the current value unchanged.
-
-    Usage:
-        Assign this flag instead of a real value to indicate that an existing
-        value should not be modified.
-
-    Examples:
-        >>> d[key] = KEEP_CURRENT
-
-    Note:
-        This is a singleton class; constructing it repeatedly returns the same
-        instance.
-    """
-    pass
-
-class DeleteCurrentFlag(Joker):
-    """Flag instructing PersiDict to delete the current value for a key.
-
-    Usage:
-        Assign this flag instead of a real value to remove the key if it
-        exists. If the key is absent, implementations will typically no-op.
-
-    Examples:
-        >>> d[key] = DELETE_CURRENT
-
-    Note:
-        This is a singleton class; constructing it repeatedly returns the same
-        instance.
-    """
-    pass
-
-register_parameterizable_class(KeepCurrentFlag)
-register_parameterizable_class(DeleteCurrentFlag)
-
-_KeepCurrent = KeepCurrentFlag()
-KEEP_CURRENT = KeepCurrentFlag()
-
-_DeleteCurrent = DeleteCurrentFlag()
-DELETE_CURRENT = DeleteCurrentFlag()

persidict-0.37.2.dist-info/RECORD

@@ -1,14 +0,0 @@
-persidict/.DS_Store,sha256=1lFlJ5EFymdzGAUAaI30vcaaLHt3F1LwpG7xILf9jsM,6148
-persidict/__init__.py,sha256=CDOSJGgCnyRTkGUTzaeg3Cqsxwx0-0EFieOtldXwAls,1380
-persidict/file_dir_dict.py,sha256=Wll343YPkYGyg3mLaOLwBakYLBPNieqKdWpxORIIwwA,29548
-persidict/jokers.py,sha256=gTu7g2l2MIgBc3-hjvUrcwcgWs6tcbLyxB0u57M3bfU,3012
-persidict/overlapping_multi_dict.py,sha256=UFyPEG2GbMmMHY48UmcaLHpsaxMqRH3bc_UA8S90yJo,5947
-persidict/persi_dict.py,sha256=CKVHy8YELLRVgLWgo0Akbd8RznCVxqt8JHszIjqA_sI,23176
-persidict/s3_dict.py,sha256=44jJPinE0bNHiCw2apFRzNZ_4IxIWOirIsLJqrObnuI,21428
-persidict/safe_chars.py,sha256=H-cL9waCmDtwaRR5Y4b4oTzcBx09nc8wn8u61SVZDY0,1728
-persidict/safe_str_tuple.py,sha256=YBTcYjUKIffznOawXb9xKjz4HaKdklrgyVtegJFmr5w,7202
-persidict/safe_str_tuple_signing.py,sha256=mpOfx_xyprc0_c60XPB_EihI3vR1gOn6T03iCx1HwwQ,7494
-persidict/write_once_dict.py,sha256=Fthmpltm2yK3FmpbNGV7KQVLhsroQenxwavG8Z95Jts,11649
-persidict-0.37.2.dist-info/WHEEL,sha256=Pi5uDq5Fdo_Rr-HD5h9BiPn9Et29Y9Sh8NhcJNnFU1c,79
-persidict-0.37.2.dist-info/METADATA,sha256=nJavGC2ccuT1wyD4egOVyAfYb2K6zbrAwvCJKfq33Cw,12387
-persidict-0.37.2.dist-info/RECORD,,