kkpyutil 1.40.1__tar.gz → 1.42.0__tar.gz

{kkpyutil-1.40.1 → kkpyutil-1.42.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: kkpyutil
-Version: 1.40.1
+Version: 1.42.0
 Summary: Building blocks for sysadmin and DevOps
 Home-page: https://github.com/kakyoism/kkpyutil/
 License: MIT

{kkpyutil-1.40.1 → kkpyutil-1.42.0}/kkpyutil.py

@@ -74,14 +74,58 @@ if PLATFORM == 'Windows':
 
 # region classes
 
+# class ClassicSingleton:
+#     _instances = {}
+#
+#     def __new__(cls, *args, **kwargs):
+#         if cls not in cls._instances:
+#             print(f"Creating new instance for {cls}")
+#             cls._instances[cls] = super(ClassicSingleton, cls).__new__(cls, *args, **kwargs)
+#         else:
+#             print(f"Reusing instance for {cls}")
+#         return cls._instances[cls]
+
+
+class ClassicSingleton:
+    _instances = {}
+
+    @classmethod
+    def instance(cls, *args, **kwargs):
+        if cls not in cls._instances:
+            # Create instance using `object.__new__` directly to avoid triggering overridden `__new__`
+            cls._instances[cls] = object.__new__(cls)
+            cls._instances[cls].__init__(*args, **kwargs)
+        return cls._instances[cls]
+
+    def __new__(cls, *args, **kwargs):
+        if cls in cls._instances:
+            # Allow the instance to exist if already created
+            return cls._instances[cls]
+            # Otherwise, raise error if someone tries to use `cls()` directly
+        raise RuntimeError("Use `cls.instance()` to access the singleton instance.")
+
+
+class BorgSingleton:
+    """
+    - Borg pattern: all instances share the same state, but not the same identity
+    - override _shared_borg_state to avoid child polluting states of parent instances
+    - ref: https://www.geeksforgeeks.org/singleton-pattern-in-python-a-complete-guide/
+    """
+    _shared_borg_state = {}
+
+    def __new__(cls, *args, **kwargs):
+        obj = super(BorgSingleton, cls).__new__(cls, *args, **kwargs)
+        obj.__dict__ = cls._shared_borg_state
+        return obj
+
+
 class SingletonDecorator:
     """
-    Decorator to build Singleton class, single-inheritance only.
-    Usage:
+    - Decorator to build Singleton class, single-inheritance only.
+    - Usage:
         class MyClass: ...
         myobj = SingletonDecorator(MyClass, args, kwargs)
     """
-
     def __init__(self, klass, *args, **kwargs):
         self.klass = klass
         self.instance = None

{kkpyutil-1.40.1 → kkpyutil-1.42.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "kkpyutil"
-version = "1.40.1"
+version = "1.42.0"
 description = "Building blocks for sysadmin and DevOps"
 authors = ["Beinan Li <li.beinan@gmail.com>"]
 maintainers = ["Beinan Li <li.beinan@gmail.com>"]