cloud-python-vars 0.1.2__tar.gz → 0.2.1__tar.gz

{cloud_python_vars-0.1.2 → cloud_python_vars-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cloud-python-vars
-Version: 0.1.2
+Version: 0.2.1
 Summary: To manage and create raw Python variables on cloud servers.
 Author-email: ThatOnePythonDev <khakhang2h5e@gmail.com>
 Classifier: Programming Language :: Python :: 3
@@ -58,6 +58,14 @@ print(cloudvar.items()) # {'string': 'Hello, World!', 'list': [1, 2, 3, 4]}
 # Clearing everything
 cloudvar.clear()
 print(cloudvar.items()) # {}
+
+# Setting the client's data directly
+cloudvar.set_dict({"key1": ["item1", "item2", "item3"], "key2": "value2", "key3": 3})
+print(cloudvar.items()) # {'key1': ['item1', 'item2', 'item3'], 'key2': 'value2', 'key3': 3}
+
+# __ior__
+cloudvar |= {"key1": "value1", "key3": "value3"}
+print(cloudvar.items()) # {'key1': 'value1', 'key2': 'value2', 'key3': 'value3'}
 ```
 
 ### Example 2 for the class `AsyncCloudVar`.
@@ -100,6 +108,14 @@ async def main(): # Use asynchronous functions for full functionality access.
     await async_cloudvar.clear()
     print(await async_cloudvar.items()) # {}
 
+    # Setting the client's data directly
+    await async_cloudvar.set_dict({"key1": ["item1", "item2", "item3"], "key2": "value2", "key3": 3})
+    print(await async_cloudvar.items()) # {'key1': ['item1', 'item2', 'item3'], 'key2': 'value2', 'key3': 3}
+    
+    # __ior__
+    async_cloudvar |= {"key1": "value1", "key3": "value3"}
+    print(await async_cloudvar.items()) # {'key1': 'value1', 'key2': 'value2', 'key3': 'value3'}
+
 asyncio.run(main())
 ```
 

{cloud_python_vars-0.1.2 → cloud_python_vars-0.2.1}/README.md

@@ -44,6 +44,14 @@ print(cloudvar.items()) # {'string': 'Hello, World!', 'list': [1, 2, 3, 4]}
 # Clearing everything
 cloudvar.clear()
 print(cloudvar.items()) # {}
+
+# Setting the client's data directly
+cloudvar.set_dict({"key1": ["item1", "item2", "item3"], "key2": "value2", "key3": 3})
+print(cloudvar.items()) # {'key1': ['item1', 'item2', 'item3'], 'key2': 'value2', 'key3': 3}
+
+# __ior__
+cloudvar |= {"key1": "value1", "key3": "value3"}
+print(cloudvar.items()) # {'key1': 'value1', 'key2': 'value2', 'key3': 'value3'}
 ```
 
 ### Example 2 for the class `AsyncCloudVar`.
@@ -86,6 +94,14 @@ async def main(): # Use asynchronous functions for full functionality access.
     await async_cloudvar.clear()
     print(await async_cloudvar.items()) # {}
 
+    # Setting the client's data directly
+    await async_cloudvar.set_dict({"key1": ["item1", "item2", "item3"], "key2": "value2", "key3": 3})
+    print(await async_cloudvar.items()) # {'key1': ['item1', 'item2', 'item3'], 'key2': 'value2', 'key3': 3}
+    
+    # __ior__
+    async_cloudvar |= {"key1": "value1", "key3": "value3"}
+    print(await async_cloudvar.items()) # {'key1': 'value1', 'key2': 'value2', 'key3': 'value3'}
+
 asyncio.run(main())
 ```
 

{cloud_python_vars-0.1.2 → cloud_python_vars-0.2.1}/cloud_python_vars.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cloud-python-vars
-Version: 0.1.2
+Version: 0.2.1
 Summary: To manage and create raw Python variables on cloud servers.
 Author-email: ThatOnePythonDev <khakhang2h5e@gmail.com>
 Classifier: Programming Language :: Python :: 3
@@ -58,6 +58,14 @@ print(cloudvar.items()) # {'string': 'Hello, World!', 'list': [1, 2, 3, 4]}
 # Clearing everything
 cloudvar.clear()
 print(cloudvar.items()) # {}
+
+# Setting the client's data directly
+cloudvar.set_dict({"key1": ["item1", "item2", "item3"], "key2": "value2", "key3": 3})
+print(cloudvar.items()) # {'key1': ['item1', 'item2', 'item3'], 'key2': 'value2', 'key3': 3}
+
+# __ior__
+cloudvar |= {"key1": "value1", "key3": "value3"}
+print(cloudvar.items()) # {'key1': 'value1', 'key2': 'value2', 'key3': 'value3'}
 ```
 
 ### Example 2 for the class `AsyncCloudVar`.
@@ -100,6 +108,14 @@ async def main(): # Use asynchronous functions for full functionality access.
     await async_cloudvar.clear()
     print(await async_cloudvar.items()) # {}
 
+    # Setting the client's data directly
+    await async_cloudvar.set_dict({"key1": ["item1", "item2", "item3"], "key2": "value2", "key3": 3})
+    print(await async_cloudvar.items()) # {'key1': ['item1', 'item2', 'item3'], 'key2': 'value2', 'key3': 3}
+    
+    # __ior__
+    async_cloudvar |= {"key1": "value1", "key3": "value3"}
+    print(await async_cloudvar.items()) # {'key1': 'value1', 'key2': 'value2', 'key3': 'value3'}
+
 asyncio.run(main())
 ```
 

{cloud_python_vars-0.1.2 → cloud_python_vars-0.2.1}/cloud_variables.py

@@ -15,18 +15,22 @@ Visit the link https://console.upstash.com/redis to create tokens and urls.
 :meth:`CloudVar.__setitem__`
 :meth:`CloudVar.__getitem__`
 :meth:`CloudVar.__delitem__`
+:meth:`CloudVar.__ior__`
+:meth:`CloudVar.set_dict`
 :meth:`CloudVar.pop`
 :meth:`CloudVar.items`
 :meth:`AsyncCloudVar.__init__`
 :meth:`AsyncCloudVar.__setitem__`
 :meth:`AsyncCloudVar.__getitem__`
 :meth:`AsyncCloudVar.__delitem__`
+:meth:`AsyncCloudVar.__ior__`
+:meth:`AsyncCloudVar.set_dict`
 :meth:`AsyncCloudVar.pop`
 :meth:`AsyncCloudVar.items`
 :meth:`CloudProxy.__init__`
 :meth:`CloudProxy.__repr__`
 
-:Imports:
+Imports:
     * :mod:`__future__`
     * :mod:`typing`
     * :mod:`time`
@@ -40,7 +44,9 @@ The example code for the class `CloudVar`:
 import cloud_variable as cv
 from typing import Any # I love type annotating :)
 
-cloudvar: cv.CloudVar = cv.CloudVar("https://apparent-gopher-******.upstash.io", "******")
+
+# You could use optional delay or tb parameters to customize this too
+cloudvar: cv.CloudVar = cv.CloudVar("https://apparent-gopher-******.upstash.io", "******") # Use your actual values.
 
 while True:
     cloudvar["key"] = "value"
@@ -59,6 +65,12 @@ while True:
 
     # Clearing the entire client data:
     cloudvar.clear()
+
+    # Setting the client data:
+    cloudvar.set_dict({"data": {"score": 100, "player": "Player123"}})
+
+    # Whatever it is idk :P |= / __ior__
+    cloudvar |= {"some_key_here": "some value here 123"}
 ```
 
 The example code for the class `AsyncCloudVar`:
@@ -69,7 +81,8 @@ from typing import Any # I love type annotating :)
 
 
 async def main() -> None: # You're recommended to put this in an asynchronous function.
-    async_cloudvar: cv.AsyncCloudVar = cv.AsyncCloudVar("https://apparent-gopher-******.upstash.io", "******")
+    # You could use optional delay or tb parameters to customize this too
+    async_cloudvar: cv.AsyncCloudVar = cv.AsyncCloudVar("https://apparent-gopher-******.upstash.io", "******") # Use your actual values.
     async_cloudvar.start()
 
     while True:
@@ -90,17 +103,23 @@ async def main() -> None: # You're recommended to put this in an asynchronous fu
         # Clearing the entire client data:
         await async_cloudvar.clear()
 
+        # Setting the data:
+        await async_cloudvar.set_dict("data": {"score": 100, "player": "Player123"})
+
+        # Whatever it is idk :P |= / __ior__
+        async_cloudvar |= {"some_key_here": "some value here 123"}
+
         ... # some long/complex task here
 ```
 """
 
 from __future__ import annotations
 
-from typing import Any, Literal, Never
-
-import time
 import asyncio
 import threading
+import time
+from typing import Any, Literal, override
+
 import upstash_redis as redis
 
 
@@ -120,6 +139,7 @@ class CloudProxy:
 
         self.value: Any = value
 
+    @override
     def __repr__(self) -> str:
         return f"CloudProxy({self.value})"
 
@@ -137,6 +157,9 @@ class CloudVar(redis.Redis):
         rest_retry_interval: float = 3,
         allow_telemetry: bool = True,
         read_your_writes: bool = True,
+        *,
+        delay: float = 0.1,
+        tb: Literal["strict", "log", "ignore"] = "log"
     ) -> None:
         """
         To initialize the class.
@@ -148,6 +171,8 @@ class CloudVar(redis.Redis):
         :param rest_retry_interval: The number of seconds the client waits before retrying a new request. The default is 3.
         :param allow_telemetry: Controls whether the client is allowed to send telemetry data. The default is True.
         :param read_your_writes: Allows whether the client is allowed to read your writes. The default is True.
+        :param delay: The delay to prevent CPU over-usage and network spamming. The default is 0.1.
+        :param tb: Controls what to do when an error occurs. 'strict' for letting it raise, 'log' for catching and logging the error, 'ignore' for passing silently. The default is 'log'.
 
         :type url: str
         :type token: str
@@ -156,6 +181,8 @@ class CloudVar(redis.Redis):
         :type rest_retry_interval: float
         :type allow_telemetry: bool
         :type read_your_writes: bool
+        :type delay: float
+        :type tb: Literal["strict", "log", "ignore"]
         """
 
         super().__init__(url, token, rest_encoding, rest_retries, rest_retry_interval, allow_telemetry, read_your_writes,)
@@ -165,14 +192,23 @@ class CloudVar(redis.Redis):
         self.__thread: threading.Thread = threading.Thread(target=self.__loop)
         self.__thread.start()
 
+        self.delay: float = delay
+        self.tb: str = tb
+
     def __loop(self) -> None:
         try:
             while True:
                 for k, v in self.__data.copy().items():
                     self.set(k, repr(v))
-                time.sleep(0.1)
+                time.sleep(self.delay)
         except Exception as e:
-            print(e.__traceback__)
+            match self.tb:
+                case "strict":
+                    raise
+                case "log":
+                    print(e.__traceback__)
+                case _:
+                    pass
 
     def __setitem__(self, key: str, value: Any) -> None:
         """
@@ -201,10 +237,24 @@ class CloudVar(redis.Redis):
         return self.__data[key].value
 
     def __delitem__(self, key: str) -> None:
-        """Deletes the key from the client."""
+        """
+        Deletes the key from the client.
+
+        :param
+        """
 
         self.pop(key)
 
+    def __ior__(self, other: dict[str, Any]) -> None:
+        """
+        Sets multiple key-value pairs.
+
+        :param other: The dictionary to change the data to.
+        :type other: dict[str, Any]
+        """
+        
+        self.__data |= {k: CloudProxy(v) for k, v in self.items()}
+
     def pop(self, *keys: str) -> tuple[Any, ...]:
         """
         Deletes keys from the client and returns them all as a tuple.
@@ -221,7 +271,7 @@ class CloudVar(redis.Redis):
 
         for key in keys:
             del self.__data[key]
-        
+
         return tuple(values)
 
     def clear(self) -> None:
@@ -245,6 +295,17 @@ class CloudVar(redis.Redis):
 
         return {k: self.get(k) for k in self.keys(r"[\s\S]*") if self.get(k)}
 
+    def set_dict(self, dictionary: dict[str, Any], /) -> None:
+        """
+        Sets the data of the client.
+
+        :param dictionary: The dictionary value.
+        :type dictionary: dict[str, Any]
+        """
+
+        self.clear()
+        self.__data = dictionary
+
 class AsyncCloudVar(redis.AsyncRedis):
     """
     An asynchronous Cloud Variable class that contains some methods for managing cloud variables.
@@ -259,6 +320,9 @@ class AsyncCloudVar(redis.AsyncRedis):
         rest_retry_interval: float = 3,
         allow_telemetry: bool = True,
         read_your_writes: bool = True,
+        *,
+        delay: float = 0.1,
+        tb: Literal["strict", "log", "ignore"] = "log"
     ) -> None:
         """
         To initialize the class.
@@ -284,6 +348,9 @@ class AsyncCloudVar(redis.AsyncRedis):
 
         self.__data: dict[str, CloudProxy] = {}
 
+        self.delay: float = delay
+        self.tb: str = tb
+
     def start(self) -> None:
         """Starts the instance's process."""
 
@@ -293,12 +360,18 @@ class AsyncCloudVar(redis.AsyncRedis):
             try:
                 while True:
                     for k, v in self.__data.copy().items():
-                        await self.set(k, repr(v))
+                        _ = await self.set(k, repr(v))
                     await asyncio.sleep(0.1)
             except Exception as e:
-                print(e.__traceback__)
+                match self.tb:
+                    case "strict":
+                        raise
+                    case "log":
+                        print(e.__traceback__)
+                    case _:
+                        pass
 
-        asyncio.create_task(task())
+        _ = asyncio.create_task(task())
 
     def __setitem__(self, key: str, value: Any) -> None:
         """
@@ -330,6 +403,27 @@ class AsyncCloudVar(redis.AsyncRedis):
         """Deletes the key from the client."""
 
         await self.pop(key)
+        
+    def __ior__(self, other: dict[str, Any]) -> None:
+        """
+        Sets multiple key-value pairs.
+
+        :param other: The dictionary to change the data to.
+        :type other: dict[str, Any]
+        """
+        
+        self.__data |= {k: CloudProxy(v) for k, v in other.items()}
+
+    async def set_dict(self, dictionary: dict[str, Any]) -> None:
+        """
+        Sets the data of the client.
+
+        :param dictionary: The dictionary value.
+        :type dictionary: dict[str, Any]
+        """
+
+        await self.clear()
+        self.__data = {k: CloudProxy(v) for k, v in dictionary.items()}
 
     async def pop(self, *keys: str) -> tuple[Any, ...]:
         """

{cloud_python_vars-0.1.2 → cloud_python_vars-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cloud-python-vars"
-version = "0.1.2"
+version = "0.2.1"
 authors = [
   { name="ThatOnePythonDev", email="khakhang2h5e@gmail.com" },
 ]