cloud-python-vars 0.2.0__py3-none-any.whl → 0.2.1__py3-none-any.whl

{cloud_python_vars-0.2.0.dist-info → cloud_python_vars-0.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cloud-python-vars
-Version: 0.2.0
+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.2.1.dist-info/RECORD

@@ -0,0 +1,6 @@
+cloud_variables.py,sha256=OpH68A3eJJu0I3x2U1F_JkBPSq7wSPPJqJU85DFPiBs,14400
+cloud_python_vars-0.2.1.dist-info/licenses/LICENSE,sha256=QrYZJWmrewKHOtQwd1ymTUDpPzhnXt9Fhv6PGf-JfGs,35788
+cloud_python_vars-0.2.1.dist-info/METADATA,sha256=grelx0CWMnxTPn5vQ-C2u0iUx5IRgzd_pieyGe53JzU,3890
+cloud_python_vars-0.2.1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+cloud_python_vars-0.2.1.dist-info/top_level.txt,sha256=DxTkZ9m7oYGS873O2K7iiP6cP4t0LRqo9jL1wn-Voog,16
+cloud_python_vars-0.2.1.dist-info/RECORD,,

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,6 +103,12 @@ 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
 ```
 """
@@ -138,6 +157,7 @@ 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:
@@ -217,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.
@@ -261,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.
@@ -275,6 +320,7 @@ 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:
@@ -357,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.2.0.dist-info/RECORD

@@ -1,6 +0,0 @@
-cloud_variables.py,sha256=5Yfsd697M9hZG0fvk7eiGglknHVx57HzFf_akPjJNpI,12359
-cloud_python_vars-0.2.0.dist-info/licenses/LICENSE,sha256=QrYZJWmrewKHOtQwd1ymTUDpPzhnXt9Fhv6PGf-JfGs,35788
-cloud_python_vars-0.2.0.dist-info/METADATA,sha256=7hQbkTHZZC7MIM3Ifd9d_erQFg0aG237e-pCnqAxpUE,3088
-cloud_python_vars-0.2.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-cloud_python_vars-0.2.0.dist-info/top_level.txt,sha256=DxTkZ9m7oYGS873O2K7iiP6cP4t0LRqo9jL1wn-Voog,16
-cloud_python_vars-0.2.0.dist-info/RECORD,,