gemini-webapi 1.17.1__py3-none-any.whl → 1.17.2__py3-none-any.whl

gemini_webapi/client.py

@@ -68,7 +68,7 @@ class GeminiClient(GemMixin):
     __slots__ = [
         "cookies",
         "proxy",
-        "running",
+        "_running",
         "client",
         "access_token",
         "timeout",
@@ -91,7 +91,7 @@ class GeminiClient(GemMixin):
         super().__init__()
         self.cookies = {}
         self.proxy = proxy
-        self.running: bool = False
+        self._running: bool = False
         self.client: AsyncClient | None = None
         self.access_token: str | None = None
         self.timeout: float = 300
@@ -152,7 +152,7 @@ class GeminiClient(GemMixin):
             )
             self.access_token = access_token
             self.cookies = valid_cookies
-            self.running = True
+            self._running = True
 
             self.timeout = timeout
             self.auto_close = auto_close
@@ -188,7 +188,7 @@ class GeminiClient(GemMixin):
         if delay:
             await asyncio.sleep(delay)
 
-        self.running = False
+        self._running = False
 
         if self.close_task:
             self.close_task.cancel()
@@ -229,7 +229,7 @@ class GeminiClient(GemMixin):
 
             if new_1psidts:
                 self.cookies["__Secure-1PSIDTS"] = new_1psidts
-                if self.running:
+                if self._running:
                     self.client.cookies.set("__Secure-1PSIDTS", new_1psidts)
                 logger.debug("Cookies refreshed. New __Secure-1PSIDTS applied.")
 
@@ -380,7 +380,7 @@ class GeminiClient(GemMixin):
 
                 try:
                     error_code = get_nested_value(response_json, [0, 5, 2, 0, 1, 0], -1)
-                    match ErrorCode(error_code):
+                    match error_code:
                         case ErrorCode.USAGE_LIMIT_EXCEEDED:
                             raise UsageLimitExceeded(
                                 f"Failed to generate contents. Usage limit of {model.model_name} model has exceeded. Please try switching to another model."

gemini_webapi/types/image.py

@@ -71,9 +71,10 @@ class Image(BaseModel):
         """
 
         filename = filename or self.url.split("/")[-1].split("?")[0]
-        try:
-            filename = re.search(r"^(.*\.\w+)", filename).group()
-        except AttributeError:
+        match = re.search(r"^(.*\.\w+)", filename)
+        if match:
+            filename = match.group()
+        else:
             if verbose:
                 logger.warning(f"Invalid filename: {filename}")
             if skip_invalid_filename:
@@ -137,19 +138,33 @@ class GeneratedImage(Image):
         return v
 
     # @override
-    async def save(self, full_size=True, **kwargs) -> str | None:
+    async def save(
+        self,
+        path: str = "temp",
+        filename: str | None = None,
+        cookies: dict | None = None,
+        verbose: bool = False,
+        skip_invalid_filename: bool = False,
+        full_size: bool = True,
+    ) -> str | None:
         """
         Save the image to disk.
 
         Parameters
         ----------
+        path: `str`, optional
+            Path to save the image, by default will save to "./temp".
         filename: `str`, optional
             Filename to save the image, generated images are always in .png format, but file extension will not be included in the URL.
             And since the URL ends with a long hash, by default will use timestamp + end of the hash as the filename.
+        cookies: `dict`, optional
+            Cookies used for requesting the content of the image. If not provided, will use the cookies from the GeneratedImage instance.
+        verbose : `bool`, optional
+            If True, will print the path of the saved file or warning for invalid file name, by default False.
+        skip_invalid_filename: `bool`, optional
+            If True, will only save the image if the file name and extension are valid, by default False.
         full_size: `bool`, optional
-            If True, will modify the default preview (512*512) URL to get the full size image.
-        kwargs: `dict`, optional
-            Other arguments to pass to `Image.save`.
+            If True, will modify the default preview (512*512) URL to get the full size image, by default True.
 
         Returns
         -------
@@ -161,8 +176,10 @@ class GeneratedImage(Image):
             self.url += "=s2048"
 
         return await super().save(
-            filename=kwargs.pop("filename", None)
+            path=path,
+            filename=filename
             or f"{datetime.now().strftime('%Y%m%d%H%M%S')}_{self.url[-10:]}.png",
-            cookies=self.cookies,
-            **kwargs,
+            cookies=cookies or self.cookies,
+            verbose=verbose,
+            skip_invalid_filename=skip_invalid_filename,
         )

gemini_webapi/utils/decorators.py

@@ -1,10 +1,11 @@
 import asyncio
 import functools
+from collections.abc import Callable
 
 from ..exceptions import APIError, ImageGenerationError
 
 
-def running(retry: int = 0) -> callable:
+def running(retry: int = 0) -> Callable:
     """
     Decorator to check if GeminiClient is running before making a request.
 
@@ -18,7 +19,7 @@ def running(retry: int = 0) -> callable:
         @functools.wraps(func)
         async def wrapper(client, *args, retry=retry, **kwargs):
             try:
-                if not client.running:
+                if not client._running:
                     await client.init(
                         timeout=client.timeout,
                         auto_close=client.auto_close,
@@ -27,7 +28,7 @@ def running(retry: int = 0) -> callable:
                         refresh_interval=client.refresh_interval,
                         verbose=False,
                     )
-                    if client.running:
+                    if client._running:
                         return await func(client, *args, **kwargs)
 
                     # Should not reach here

gemini_webapi/utils/parsing.py

@@ -30,8 +30,8 @@ def get_nested_value(data: list, path: list[int], default: Any = None) -> Any:
                 current_repr = f"{current_repr[:197]}..."
 
             logger.debug(
-                f"{type(e).__name__}: parsing failed at path {path} (index {i}, key '{key}') "
-                f"while attempting to get value from `{current_repr}`"
+                f"Safe navigation: path {path} ended at index {i} (key '{key}'), "
+                f"returning default. <Debug: {type(e).__name__}; Context: {current_repr}>"
             )
             return default
 

{gemini_webapi-1.17.1.dist-info → gemini_webapi-1.17.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gemini-webapi
-Version: 1.17.1
+Version: 1.17.2
 Summary: ✨ An elegant async Python wrapper for Google Gemini web app
 Author: UZQueen
 License:                     GNU AFFERO GENERAL PUBLIC LICENSE

{gemini_webapi-1.17.1.dist-info → gemini_webapi-1.17.2.dist-info}/RECORD

@@ -1,5 +1,5 @@
 gemini_webapi/__init__.py,sha256=7ELCiUoI10ea3daeJxnv0UwqLVKpM7rxsgOZsPMstO8,150
-gemini_webapi/client.py,sha256=zcsJHaZAi_lOIOtwQ-6PqS2S6-8m_Jt3rZRK7cH0EBQ,29288
+gemini_webapi/client.py,sha256=6A1K6Tq1cXdW_RGwLIFtDE0jhS1WAtrGvGqAY5-FREc,29282
 gemini_webapi/constants.py,sha256=tm9y8oKuD3QhKXUbVXZKroYCoPpqgBJdSTwoeue43Ss,3295
 gemini_webapi/exceptions.py,sha256=qkXrIpr0L7LtGbq3VcTO8D1xZ50pJtt0dDRp5I3uDSg,1038
 gemini_webapi/components/__init__.py,sha256=wolxuAJJ32-jmHOKgpsesexP7hXea1JMo5vI52wysTI,48
@@ -8,18 +8,18 @@ gemini_webapi/types/__init__.py,sha256=1DU4JEw2KHQJbtOgOuvoEXtzQCMwAkyo0koSFVdT9
 gemini_webapi/types/candidate.py,sha256=67BhY75toE5mVuB21cmHcTFtw332V_KmCjr3-9VTbJo,1477
 gemini_webapi/types/gem.py,sha256=3Ppjq9V22Zp4Lb9a9ZnDviDKQpfSQf8UZxqOEjeEWd4,4070
 gemini_webapi/types/grpc.py,sha256=S64h1oeC7ZJC50kmS_C2CQ7WVTanhJ4kqTFx5ZYayXI,917
-gemini_webapi/types/image.py,sha256=NhW1QY2Agzb6UbrIjZLnqxqukabDSGbmoCsVguzko10,5395
+gemini_webapi/types/image.py,sha256=JotV2FA8XdIKPHCRIExEOwnE-167AQ-Qoy3bIIREvw4,6185
 gemini_webapi/types/modeloutput.py,sha256=h07kQOkL5r-oPLvZ59uVtO1eP4FGy5ZpzuYQzAeQdr8,1196
 gemini_webapi/utils/__init__.py,sha256=k8hV2zn6tD_BEpd1Xya6ED0deijsmzb1e9XxdFhJzIE,418
-gemini_webapi/utils/decorators.py,sha256=AuY6sU1_6_ZqeL92dTAi3eRPQ7zubB5VuBZEiz16aBM,1741
+gemini_webapi/utils/decorators.py,sha256=uzIXoZOC0_Om19bbVXf_nw2w2NhI2qJL1o45FU6o6fI,1780
 gemini_webapi/utils/get_access_token.py,sha256=VjrHW8VMN3LPs6zCdXQtraWygurOjTY0SJZhe49aQwc,7265
 gemini_webapi/utils/load_browser_cookies.py,sha256=OHCfe27DpV_rloIDgW9Xpeb0mkfzbYONNiholw0ElXU,1791
 gemini_webapi/utils/logger.py,sha256=0VcxhVLhHBRDQutNCpapP1y_MhPoQ2ud1uIFLqxC3Z8,958
-gemini_webapi/utils/parsing.py,sha256=z-t0bDbXVIa0-3_ZmTK19PvL6zBM5vuy56z2jv1Yu1I,2105
+gemini_webapi/utils/parsing.py,sha256=CJPf7V0R_EJz1srrbVQBuOOQkLFyZovqLOHwEFYbSbY,2113
 gemini_webapi/utils/rotate_1psidts.py,sha256=XjEeQnZS3ZI6wOl0Zb5CvsbIrg0BVVNas7cE6f3x_XE,1802
 gemini_webapi/utils/upload_file.py,sha256=SJOMr6kryK_ClrKmqI96fqZBNFOMPsyAvFINAGAU3rk,1468
-gemini_webapi-1.17.1.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
-gemini_webapi-1.17.1.dist-info/METADATA,sha256=OlCVaM8XIgS_w6zxowLrxLxc5ksPf-3W27oodzH2_MM,61763
-gemini_webapi-1.17.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-gemini_webapi-1.17.1.dist-info/top_level.txt,sha256=dtWtug_ZrmnUqCYuu8NmGzTgWglHeNzhHU_hXmqZGWE,14
-gemini_webapi-1.17.1.dist-info/RECORD,,
+gemini_webapi-1.17.2.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
+gemini_webapi-1.17.2.dist-info/METADATA,sha256=PgjuOn0s9cY4sccrBUAglaLxu-SSaefZbQRnyzOc1Cg,61763
+gemini_webapi-1.17.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+gemini_webapi-1.17.2.dist-info/top_level.txt,sha256=dtWtug_ZrmnUqCYuu8NmGzTgWglHeNzhHU_hXmqZGWE,14
+gemini_webapi-1.17.2.dist-info/RECORD,,