webscout 7.1__py3-none-any.whl → 7.3__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of webscout might be problematic. Click here for more details.

Files changed (154) hide show
  1. webscout/AIauto.py +191 -191
  2. webscout/AIbase.py +122 -122
  3. webscout/AIutel.py +440 -440
  4. webscout/Bard.py +343 -161
  5. webscout/DWEBS.py +489 -492
  6. webscout/Extra/YTToolkit/YTdownloader.py +995 -995
  7. webscout/Extra/YTToolkit/__init__.py +2 -2
  8. webscout/Extra/YTToolkit/transcriber.py +476 -479
  9. webscout/Extra/YTToolkit/ytapi/channel.py +307 -307
  10. webscout/Extra/YTToolkit/ytapi/playlist.py +58 -58
  11. webscout/Extra/YTToolkit/ytapi/pool.py +7 -7
  12. webscout/Extra/YTToolkit/ytapi/utils.py +62 -62
  13. webscout/Extra/YTToolkit/ytapi/video.py +103 -103
  14. webscout/Extra/autocoder/__init__.py +9 -9
  15. webscout/Extra/autocoder/autocoder_utiles.py +199 -199
  16. webscout/Extra/autocoder/rawdog.py +5 -7
  17. webscout/Extra/autollama.py +230 -230
  18. webscout/Extra/gguf.py +3 -3
  19. webscout/Extra/weather.py +171 -171
  20. webscout/LLM.py +442 -442
  21. webscout/Litlogger/__init__.py +67 -681
  22. webscout/Litlogger/core/__init__.py +6 -0
  23. webscout/Litlogger/core/level.py +23 -0
  24. webscout/Litlogger/core/logger.py +166 -0
  25. webscout/Litlogger/handlers/__init__.py +12 -0
  26. webscout/Litlogger/handlers/console.py +33 -0
  27. webscout/Litlogger/handlers/file.py +143 -0
  28. webscout/Litlogger/handlers/network.py +173 -0
  29. webscout/Litlogger/styles/__init__.py +7 -0
  30. webscout/Litlogger/styles/colors.py +249 -0
  31. webscout/Litlogger/styles/formats.py +460 -0
  32. webscout/Litlogger/styles/text.py +87 -0
  33. webscout/Litlogger/utils/__init__.py +6 -0
  34. webscout/Litlogger/utils/detectors.py +154 -0
  35. webscout/Litlogger/utils/formatters.py +200 -0
  36. webscout/Provider/AISEARCH/DeepFind.py +250 -250
  37. webscout/Provider/AISEARCH/ISou.py +277 -0
  38. webscout/Provider/AISEARCH/__init__.py +2 -1
  39. webscout/Provider/Blackboxai.py +3 -3
  40. webscout/Provider/ChatGPTGratis.py +226 -0
  41. webscout/Provider/Cloudflare.py +3 -4
  42. webscout/Provider/DeepSeek.py +218 -0
  43. webscout/Provider/Deepinfra.py +40 -24
  44. webscout/Provider/Free2GPT.py +131 -124
  45. webscout/Provider/Gemini.py +100 -115
  46. webscout/Provider/Glider.py +3 -3
  47. webscout/Provider/Groq.py +5 -1
  48. webscout/Provider/Jadve.py +3 -3
  49. webscout/Provider/Marcus.py +191 -192
  50. webscout/Provider/Netwrck.py +3 -3
  51. webscout/Provider/PI.py +2 -2
  52. webscout/Provider/PizzaGPT.py +2 -3
  53. webscout/Provider/QwenLM.py +311 -0
  54. webscout/Provider/TTI/AiForce/__init__.py +22 -22
  55. webscout/Provider/TTI/AiForce/async_aiforce.py +257 -257
  56. webscout/Provider/TTI/AiForce/sync_aiforce.py +242 -242
  57. webscout/Provider/TTI/FreeAIPlayground/__init__.py +9 -0
  58. webscout/Provider/TTI/FreeAIPlayground/async_freeaiplayground.py +206 -0
  59. webscout/Provider/TTI/FreeAIPlayground/sync_freeaiplayground.py +192 -0
  60. webscout/Provider/TTI/Nexra/__init__.py +22 -22
  61. webscout/Provider/TTI/Nexra/async_nexra.py +286 -286
  62. webscout/Provider/TTI/Nexra/sync_nexra.py +258 -258
  63. webscout/Provider/TTI/PollinationsAI/__init__.py +23 -23
  64. webscout/Provider/TTI/PollinationsAI/async_pollinations.py +330 -330
  65. webscout/Provider/TTI/PollinationsAI/sync_pollinations.py +285 -285
  66. webscout/Provider/TTI/__init__.py +2 -1
  67. webscout/Provider/TTI/artbit/__init__.py +22 -22
  68. webscout/Provider/TTI/artbit/async_artbit.py +184 -184
  69. webscout/Provider/TTI/artbit/sync_artbit.py +176 -176
  70. webscout/Provider/TTI/blackbox/__init__.py +4 -4
  71. webscout/Provider/TTI/blackbox/async_blackbox.py +212 -212
  72. webscout/Provider/TTI/blackbox/sync_blackbox.py +199 -199
  73. webscout/Provider/TTI/deepinfra/__init__.py +4 -4
  74. webscout/Provider/TTI/deepinfra/async_deepinfra.py +227 -227
  75. webscout/Provider/TTI/deepinfra/sync_deepinfra.py +199 -199
  76. webscout/Provider/TTI/huggingface/__init__.py +22 -22
  77. webscout/Provider/TTI/huggingface/async_huggingface.py +199 -199
  78. webscout/Provider/TTI/huggingface/sync_huggingface.py +195 -195
  79. webscout/Provider/TTI/imgninza/__init__.py +4 -4
  80. webscout/Provider/TTI/imgninza/async_ninza.py +214 -214
  81. webscout/Provider/TTI/imgninza/sync_ninza.py +209 -209
  82. webscout/Provider/TTI/talkai/__init__.py +4 -4
  83. webscout/Provider/TTI/talkai/async_talkai.py +229 -229
  84. webscout/Provider/TTI/talkai/sync_talkai.py +207 -207
  85. webscout/Provider/TTS/deepgram.py +182 -182
  86. webscout/Provider/TTS/elevenlabs.py +136 -136
  87. webscout/Provider/TTS/gesserit.py +150 -150
  88. webscout/Provider/TTS/murfai.py +138 -138
  89. webscout/Provider/TTS/parler.py +133 -134
  90. webscout/Provider/TTS/streamElements.py +360 -360
  91. webscout/Provider/TTS/utils.py +280 -280
  92. webscout/Provider/TTS/voicepod.py +116 -116
  93. webscout/Provider/TextPollinationsAI.py +28 -8
  94. webscout/Provider/WiseCat.py +193 -0
  95. webscout/Provider/__init__.py +146 -134
  96. webscout/Provider/cerebras.py +242 -227
  97. webscout/Provider/chatglm.py +204 -204
  98. webscout/Provider/dgaf.py +2 -3
  99. webscout/Provider/freeaichat.py +221 -0
  100. webscout/Provider/gaurish.py +2 -3
  101. webscout/Provider/geminiapi.py +208 -208
  102. webscout/Provider/granite.py +223 -0
  103. webscout/Provider/hermes.py +218 -218
  104. webscout/Provider/llama3mitril.py +179 -179
  105. webscout/Provider/llamatutor.py +3 -3
  106. webscout/Provider/llmchat.py +2 -3
  107. webscout/Provider/meta.py +794 -794
  108. webscout/Provider/multichat.py +331 -331
  109. webscout/Provider/typegpt.py +359 -359
  110. webscout/Provider/yep.py +3 -3
  111. webscout/__init__.py +1 -0
  112. webscout/__main__.py +5 -5
  113. webscout/cli.py +319 -319
  114. webscout/conversation.py +241 -242
  115. webscout/exceptions.py +328 -328
  116. webscout/litagent/__init__.py +28 -28
  117. webscout/litagent/agent.py +2 -3
  118. webscout/litprinter/__init__.py +0 -58
  119. webscout/scout/__init__.py +8 -8
  120. webscout/scout/core.py +884 -884
  121. webscout/scout/element.py +459 -459
  122. webscout/scout/parsers/__init__.py +69 -69
  123. webscout/scout/parsers/html5lib_parser.py +172 -172
  124. webscout/scout/parsers/html_parser.py +236 -236
  125. webscout/scout/parsers/lxml_parser.py +178 -178
  126. webscout/scout/utils.py +38 -38
  127. webscout/swiftcli/__init__.py +811 -811
  128. webscout/update_checker.py +2 -12
  129. webscout/version.py +1 -1
  130. webscout/webscout_search.py +87 -6
  131. webscout/webscout_search_async.py +58 -1
  132. webscout/yep_search.py +297 -0
  133. webscout/zeroart/__init__.py +54 -54
  134. webscout/zeroart/base.py +60 -60
  135. webscout/zeroart/effects.py +99 -99
  136. webscout/zeroart/fonts.py +816 -816
  137. {webscout-7.1.dist-info → webscout-7.3.dist-info}/METADATA +62 -22
  138. webscout-7.3.dist-info/RECORD +223 -0
  139. {webscout-7.1.dist-info → webscout-7.3.dist-info}/WHEEL +1 -1
  140. webstoken/__init__.py +30 -30
  141. webstoken/classifier.py +189 -189
  142. webstoken/keywords.py +216 -216
  143. webstoken/language.py +128 -128
  144. webstoken/ner.py +164 -164
  145. webstoken/normalizer.py +35 -35
  146. webstoken/processor.py +77 -77
  147. webstoken/sentiment.py +206 -206
  148. webstoken/stemmer.py +73 -73
  149. webstoken/tagger.py +60 -60
  150. webstoken/tokenizer.py +158 -158
  151. webscout-7.1.dist-info/RECORD +0 -198
  152. {webscout-7.1.dist-info → webscout-7.3.dist-info}/LICENSE.md +0 -0
  153. {webscout-7.1.dist-info → webscout-7.3.dist-info}/entry_points.txt +0 -0
  154. {webscout-7.1.dist-info → webscout-7.3.dist-info}/top_level.txt +0 -0
@@ -1,214 +1,214 @@
1
- import aiohttp
2
- import asyncio
3
- import json
4
- import os
5
- from typing import List, Dict, Optional, Union, AsyncGenerator
6
- import aiofiles
7
-
8
- from webscout.AIbase import AsyncImageProvider
9
- from webscout import exceptions
10
- from webscout.litagent import agent # Import our fire user agent generator 🔥
11
- from webscout.Litlogger import LitLogger # For that cyberpunk logging swag ⚡
12
-
13
- # Initialize our fire logger 🚀
14
- logger = LitLogger("AsyncNinjaImager", "MODERN_EMOJI")
15
-
16
- class AsyncNinjaImager(AsyncImageProvider):
17
- """
18
- Async image provider for NinjaChat.ai - Your go-to for fire AI art! 🎨
19
-
20
- >>> # Generate some fire art asynchronously! 🔥
21
- >>> async def generate_art():
22
- ... imager = AsyncNinjaImager(logging=True)
23
- ... images = await imager.generate("Epic dragon breathing fire", amount=2)
24
- ... paths = await imager.save(images)
25
- ... print(paths)
26
- >>> asyncio.run(generate_art())
27
- ['epic_dragon_0.png', 'epic_dragon_1.png']
28
-
29
- >>> # Turn off logging for stealth mode 🥷
30
- >>> async def stealth_art():
31
- ... quiet_imager = AsyncNinjaImager(logging=False)
32
- ... images = await quiet_imager.generate("Cyberpunk city at night")
33
- ... paths = await quiet_imager.save(images)
34
- >>> asyncio.run(stealth_art())
35
- """
36
-
37
- AVAILABLE_MODELS = {
38
- "stable-diffusion": "https://www.ninjachat.ai/api/image-generator",
39
- "flux-dev": "https://www.ninjachat.ai/api/flux-image-generator",
40
- }
41
-
42
- def __init__(self, timeout: int = 60, proxies: dict = {}, logging: bool = True):
43
- """Initialize your async NinjaChatImager with custom settings! ⚙️
44
-
45
- Args:
46
- timeout (int): Request timeout in seconds (default: 60)
47
- proxies (dict): Proxy settings for requests (default: {})
48
- logging (bool): Enable fire logging (default: True)
49
- """
50
- self.headers = {
51
- "Accept": "*/*",
52
- "Accept-Encoding": "gzip, deflate, br, zstd",
53
- "Accept-Language": "en-US,en;q=0.9,en-IN;q=0.8",
54
- "Content-Type": "application/json",
55
- "DNT": "1",
56
- "Origin": "https://www.ninjachat.ai",
57
- "Priority": "u=1, i",
58
- "Referer": "https://www.ninjachat.ai/image-generation",
59
- "Sec-CH-UA": '"Microsoft Edge";v="129", "Not=A?Brand";v="8", "Chromium";v="129"',
60
- "Sec-CH-UA-Mobile": "?0",
61
- "Sec-CH-UA-Platform": '"Windows"',
62
- "Sec-Fetch-Dest": "empty",
63
- "Sec-Fetch-Mode": "cors",
64
- "Sec-Fetch-Site": "same-origin",
65
- "User-Agent": agent.random() # Using our fire random agent! 🔥
66
- }
67
- self.timeout = timeout
68
- self.proxies = proxies
69
- self.prompt = "AI-generated image - webscout"
70
- self.image_extension = "png"
71
- self.logging = logging
72
- if self.logging:
73
- logger.info("AsyncNinjaImager initialized! Ready to create some fire art! 🚀")
74
-
75
- async def generate(
76
- self, prompt: str, amount: int = 1, model: str = "flux-dev"
77
- ) -> List[bytes]:
78
- """Generate some fire images from your prompt! 🎨
79
-
80
- Args:
81
- prompt (str): Your creative prompt
82
- amount (int): How many images to generate
83
- model (str): Which model to use (default: flux-dev)
84
-
85
- Returns:
86
- List[bytes]: Your generated images as bytes
87
- """
88
- assert bool(prompt), "Prompt cannot be null"
89
- assert isinstance(amount, int) and amount > 0, "Amount should be a positive integer"
90
-
91
- if model not in self.AVAILABLE_MODELS:
92
- raise exceptions.ModelNotFoundError(
93
- f"Model '{model}' not found. Available models: {', '.join(self.AVAILABLE_MODELS)}"
94
- )
95
-
96
- self.prompt = prompt
97
- url = self.AVAILABLE_MODELS[model]
98
-
99
- payload = {
100
- "prompt": prompt,
101
- "model": model if model == "flux-dev" else "stable-diffusion",
102
- "negativePrompt": "",
103
- "cfg": 7,
104
- "aspectRatio": "1:1",
105
- "outputFormat": self.image_extension,
106
- "numOutputs": amount,
107
- "outputQuality": 90
108
- }
109
-
110
- if self.logging:
111
- logger.info(f"Generating {amount} images with {model}... 🎨")
112
-
113
- response = []
114
- async with aiohttp.ClientSession(headers=self.headers) as session:
115
- try:
116
- async with session.post(url, json=payload, timeout=self.timeout) as resp:
117
- if resp.status != 200:
118
- if self.logging:
119
- logger.error(f"Request failed with status {resp.status} 😢")
120
- raise exceptions.FailedToGenerateResponseError(
121
- f"Request failed with status code: {resp.status}, {await resp.text()}"
122
- )
123
-
124
- data = await resp.json()
125
-
126
- if 'output' not in data:
127
- if self.logging:
128
- logger.error("Invalid API response format 😢")
129
- raise exceptions.InvalidResponseError("Invalid API response format: 'output' key missing.")
130
-
131
- for img_url in data['output']:
132
- async with session.get(img_url) as img_resp:
133
- img_resp.raise_for_status()
134
- response.append(await img_resp.read())
135
- if self.logging:
136
- logger.success(f"Generated image {len(response)}/{amount}! 🎨")
137
-
138
- except aiohttp.ClientError as e:
139
- if self.logging:
140
- logger.error(f"Connection error: {e} 😢")
141
- raise exceptions.APIConnectionError(f"An error occurred during the request: {e}")
142
- except json.JSONDecodeError as e:
143
- if self.logging:
144
- logger.error(f"Failed to parse response: {e} 😢")
145
- raise exceptions.InvalidResponseError(f"Failed to parse JSON response: {e}")
146
-
147
- if self.logging:
148
- logger.success("All images generated successfully! 🎉")
149
- return response
150
-
151
- async def save(
152
- self,
153
- response: Union[List[bytes], AsyncGenerator[bytes, None]],
154
- name: str = None,
155
- dir: str = os.getcwd(),
156
- filenames_prefix: str = "",
157
- ) -> List[str]:
158
- """Save your fire images! 💾
159
-
160
- Args:
161
- response (Union[List[bytes], AsyncGenerator[bytes, None]]): Image data
162
- name (str, optional): Base name for saved files
163
- dir (str, optional): Where to save the images
164
- filenames_prefix (str, optional): Prefix for filenames
165
-
166
- Returns:
167
- List[str]: List of saved filenames
168
- """
169
- if not os.path.exists(dir):
170
- os.makedirs(dir)
171
- if self.logging:
172
- logger.info(f"Created directory: {dir} 📁")
173
-
174
- name = self.prompt if name is None else name
175
- saved_paths = []
176
-
177
- async def save_single_image(image_bytes: bytes, index: int) -> str:
178
- filename = f"{filenames_prefix}{name}_{index}.{self.image_extension}"
179
- filepath = os.path.join(dir, filename)
180
-
181
- async with aiofiles.open(filepath, "wb") as f:
182
- await f.write(image_bytes)
183
-
184
- if self.logging:
185
- logger.success(f"Saved image to: {filepath} 💾")
186
- return filename
187
-
188
- if isinstance(response, list):
189
- image_list = response
190
- else:
191
- image_list = [chunk async for chunk in response]
192
-
193
- if self.logging:
194
- logger.info(f"Saving {len(image_list)} images... 💾")
195
-
196
- tasks = [save_single_image(img, i) for i, img in enumerate(image_list)]
197
- saved_paths = await asyncio.gather(*tasks)
198
-
199
- if self.logging:
200
- logger.success(f"All images saved successfully! Check {dir} 🎉")
201
- return saved_paths
202
-
203
-
204
- if __name__ == "__main__":
205
- async def main():
206
- bot = AsyncNinjaImager()
207
- try:
208
- resp = await bot.generate("A shiny red sports car speeding down a scenic mountain road", 1)
209
- paths = await bot.save(resp)
210
- print(paths)
211
- except Exception as e:
212
- print(f"An error occurred: {e}")
213
-
214
- asyncio.run(main())
1
+ import aiohttp
2
+ import asyncio
3
+ import json
4
+ import os
5
+ from typing import List, Dict, Optional, Union, AsyncGenerator
6
+ import aiofiles
7
+
8
+ from webscout.AIbase import AsyncImageProvider
9
+ from webscout import exceptions
10
+ from webscout.litagent import agent # Import our fire user agent generator 🔥
11
+ from webscout.Litlogger import Logger # For that cyberpunk logging swag ⚡
12
+
13
+ # Initialize our fire logger 🚀
14
+ logger = Logger("AsyncNinjaImager")
15
+
16
+ class AsyncNinjaImager(AsyncImageProvider):
17
+ """
18
+ Async image provider for NinjaChat.ai - Your go-to for fire AI art! 🎨
19
+
20
+ >>> # Generate some fire art asynchronously! 🔥
21
+ >>> async def generate_art():
22
+ ... imager = AsyncNinjaImager(logging=True)
23
+ ... images = await imager.generate("Epic dragon breathing fire", amount=2)
24
+ ... paths = await imager.save(images)
25
+ ... print(paths)
26
+ >>> asyncio.run(generate_art())
27
+ ['epic_dragon_0.png', 'epic_dragon_1.png']
28
+
29
+ >>> # Turn off logging for stealth mode 🥷
30
+ >>> async def stealth_art():
31
+ ... quiet_imager = AsyncNinjaImager(logging=False)
32
+ ... images = await quiet_imager.generate("Cyberpunk city at night")
33
+ ... paths = await quiet_imager.save(images)
34
+ >>> asyncio.run(stealth_art())
35
+ """
36
+
37
+ AVAILABLE_MODELS = {
38
+ "stable-diffusion": "https://www.ninjachat.ai/api/image-generator",
39
+ "flux-dev": "https://www.ninjachat.ai/api/flux-image-generator",
40
+ }
41
+
42
+ def __init__(self, timeout: int = 60, proxies: dict = {}, logging: bool = True):
43
+ """Initialize your async NinjaChatImager with custom settings! ⚙️
44
+
45
+ Args:
46
+ timeout (int): Request timeout in seconds (default: 60)
47
+ proxies (dict): Proxy settings for requests (default: {})
48
+ logging (bool): Enable fire logging (default: True)
49
+ """
50
+ self.headers = {
51
+ "Accept": "*/*",
52
+ "Accept-Encoding": "gzip, deflate, br, zstd",
53
+ "Accept-Language": "en-US,en;q=0.9,en-IN;q=0.8",
54
+ "Content-Type": "application/json",
55
+ "DNT": "1",
56
+ "Origin": "https://www.ninjachat.ai",
57
+ "Priority": "u=1, i",
58
+ "Referer": "https://www.ninjachat.ai/image-generation",
59
+ "Sec-CH-UA": '"Microsoft Edge";v="129", "Not=A?Brand";v="8", "Chromium";v="129"',
60
+ "Sec-CH-UA-Mobile": "?0",
61
+ "Sec-CH-UA-Platform": '"Windows"',
62
+ "Sec-Fetch-Dest": "empty",
63
+ "Sec-Fetch-Mode": "cors",
64
+ "Sec-Fetch-Site": "same-origin",
65
+ "User-Agent": agent.random() # Using our fire random agent! 🔥
66
+ }
67
+ self.timeout = timeout
68
+ self.proxies = proxies
69
+ self.prompt = "AI-generated image - webscout"
70
+ self.image_extension = "png"
71
+ self.logging = logging
72
+ if self.logging:
73
+ logger.info("AsyncNinjaImager initialized! Ready to create some fire art! 🚀")
74
+
75
+ async def generate(
76
+ self, prompt: str, amount: int = 1, model: str = "flux-dev"
77
+ ) -> List[bytes]:
78
+ """Generate some fire images from your prompt! 🎨
79
+
80
+ Args:
81
+ prompt (str): Your creative prompt
82
+ amount (int): How many images to generate
83
+ model (str): Which model to use (default: flux-dev)
84
+
85
+ Returns:
86
+ List[bytes]: Your generated images as bytes
87
+ """
88
+ assert bool(prompt), "Prompt cannot be null"
89
+ assert isinstance(amount, int) and amount > 0, "Amount should be a positive integer"
90
+
91
+ if model not in self.AVAILABLE_MODELS:
92
+ raise exceptions.ModelNotFoundError(
93
+ f"Model '{model}' not found. Available models: {', '.join(self.AVAILABLE_MODELS)}"
94
+ )
95
+
96
+ self.prompt = prompt
97
+ url = self.AVAILABLE_MODELS[model]
98
+
99
+ payload = {
100
+ "prompt": prompt,
101
+ "model": model if model == "flux-dev" else "stable-diffusion",
102
+ "negativePrompt": "",
103
+ "cfg": 7,
104
+ "aspectRatio": "1:1",
105
+ "outputFormat": self.image_extension,
106
+ "numOutputs": amount,
107
+ "outputQuality": 90
108
+ }
109
+
110
+ if self.logging:
111
+ logger.info(f"Generating {amount} images with {model}... 🎨")
112
+
113
+ response = []
114
+ async with aiohttp.ClientSession(headers=self.headers) as session:
115
+ try:
116
+ async with session.post(url, json=payload, timeout=self.timeout) as resp:
117
+ if resp.status != 200:
118
+ if self.logging:
119
+ logger.error(f"Request failed with status {resp.status} 😢")
120
+ raise exceptions.FailedToGenerateResponseError(
121
+ f"Request failed with status code: {resp.status}, {await resp.text()}"
122
+ )
123
+
124
+ data = await resp.json()
125
+
126
+ if 'output' not in data:
127
+ if self.logging:
128
+ logger.error("Invalid API response format 😢")
129
+ raise exceptions.InvalidResponseError("Invalid API response format: 'output' key missing.")
130
+
131
+ for img_url in data['output']:
132
+ async with session.get(img_url) as img_resp:
133
+ img_resp.raise_for_status()
134
+ response.append(await img_resp.read())
135
+ if self.logging:
136
+ logger.success(f"Generated image {len(response)}/{amount}! 🎨")
137
+
138
+ except aiohttp.ClientError as e:
139
+ if self.logging:
140
+ logger.error(f"Connection error: {e} 😢")
141
+ raise exceptions.APIConnectionError(f"An error occurred during the request: {e}")
142
+ except json.JSONDecodeError as e:
143
+ if self.logging:
144
+ logger.error(f"Failed to parse response: {e} 😢")
145
+ raise exceptions.InvalidResponseError(f"Failed to parse JSON response: {e}")
146
+
147
+ if self.logging:
148
+ logger.success("All images generated successfully! 🎉")
149
+ return response
150
+
151
+ async def save(
152
+ self,
153
+ response: Union[List[bytes], AsyncGenerator[bytes, None]],
154
+ name: str = None,
155
+ dir: str = os.getcwd(),
156
+ filenames_prefix: str = "",
157
+ ) -> List[str]:
158
+ """Save your fire images! 💾
159
+
160
+ Args:
161
+ response (Union[List[bytes], AsyncGenerator[bytes, None]]): Image data
162
+ name (str, optional): Base name for saved files
163
+ dir (str, optional): Where to save the images
164
+ filenames_prefix (str, optional): Prefix for filenames
165
+
166
+ Returns:
167
+ List[str]: List of saved filenames
168
+ """
169
+ if not os.path.exists(dir):
170
+ os.makedirs(dir)
171
+ if self.logging:
172
+ logger.info(f"Created directory: {dir} 📁")
173
+
174
+ name = self.prompt if name is None else name
175
+ saved_paths = []
176
+
177
+ async def save_single_image(image_bytes: bytes, index: int) -> str:
178
+ filename = f"{filenames_prefix}{name}_{index}.{self.image_extension}"
179
+ filepath = os.path.join(dir, filename)
180
+
181
+ async with aiofiles.open(filepath, "wb") as f:
182
+ await f.write(image_bytes)
183
+
184
+ if self.logging:
185
+ logger.success(f"Saved image to: {filepath} 💾")
186
+ return filename
187
+
188
+ if isinstance(response, list):
189
+ image_list = response
190
+ else:
191
+ image_list = [chunk async for chunk in response]
192
+
193
+ if self.logging:
194
+ logger.info(f"Saving {len(image_list)} images... 💾")
195
+
196
+ tasks = [save_single_image(img, i) for i, img in enumerate(image_list)]
197
+ saved_paths = await asyncio.gather(*tasks)
198
+
199
+ if self.logging:
200
+ logger.success(f"All images saved successfully! Check {dir} 🎉")
201
+ return saved_paths
202
+
203
+
204
+ if __name__ == "__main__":
205
+ async def main():
206
+ bot = AsyncNinjaImager()
207
+ try:
208
+ resp = await bot.generate("A shiny red sports car speeding down a scenic mountain road", 1)
209
+ paths = await bot.save(resp)
210
+ print(paths)
211
+ except Exception as e:
212
+ print(f"An error occurred: {e}")
213
+
214
+ asyncio.run(main())