webscout 7.1__py3-none-any.whl → 7.2__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 (144) 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 +20 -0
  24. webscout/Litlogger/core/logger.py +123 -0
  25. webscout/Litlogger/handlers/__init__.py +12 -0
  26. webscout/Litlogger/handlers/console.py +50 -0
  27. webscout/Litlogger/handlers/file.py +143 -0
  28. webscout/Litlogger/handlers/network.py +174 -0
  29. webscout/Litlogger/styles/__init__.py +7 -0
  30. webscout/Litlogger/styles/colors.py +231 -0
  31. webscout/Litlogger/styles/formats.py +377 -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/Blackboxai.py +3 -3
  38. webscout/Provider/ChatGPTGratis.py +226 -0
  39. webscout/Provider/Cloudflare.py +3 -4
  40. webscout/Provider/DeepSeek.py +218 -0
  41. webscout/Provider/Deepinfra.py +3 -3
  42. webscout/Provider/Free2GPT.py +131 -124
  43. webscout/Provider/Gemini.py +100 -115
  44. webscout/Provider/Glider.py +3 -3
  45. webscout/Provider/Groq.py +5 -1
  46. webscout/Provider/Jadve.py +3 -3
  47. webscout/Provider/Marcus.py +191 -192
  48. webscout/Provider/Netwrck.py +3 -3
  49. webscout/Provider/PI.py +2 -2
  50. webscout/Provider/PizzaGPT.py +2 -3
  51. webscout/Provider/QwenLM.py +311 -0
  52. webscout/Provider/TTI/AiForce/__init__.py +22 -22
  53. webscout/Provider/TTI/AiForce/async_aiforce.py +257 -257
  54. webscout/Provider/TTI/AiForce/sync_aiforce.py +242 -242
  55. webscout/Provider/TTI/Nexra/__init__.py +22 -22
  56. webscout/Provider/TTI/Nexra/async_nexra.py +286 -286
  57. webscout/Provider/TTI/Nexra/sync_nexra.py +258 -258
  58. webscout/Provider/TTI/PollinationsAI/__init__.py +23 -23
  59. webscout/Provider/TTI/PollinationsAI/async_pollinations.py +330 -330
  60. webscout/Provider/TTI/PollinationsAI/sync_pollinations.py +285 -285
  61. webscout/Provider/TTI/artbit/__init__.py +22 -22
  62. webscout/Provider/TTI/artbit/async_artbit.py +184 -184
  63. webscout/Provider/TTI/artbit/sync_artbit.py +176 -176
  64. webscout/Provider/TTI/blackbox/__init__.py +4 -4
  65. webscout/Provider/TTI/blackbox/async_blackbox.py +212 -212
  66. webscout/Provider/TTI/blackbox/sync_blackbox.py +199 -199
  67. webscout/Provider/TTI/deepinfra/__init__.py +4 -4
  68. webscout/Provider/TTI/deepinfra/async_deepinfra.py +227 -227
  69. webscout/Provider/TTI/deepinfra/sync_deepinfra.py +199 -199
  70. webscout/Provider/TTI/huggingface/__init__.py +22 -22
  71. webscout/Provider/TTI/huggingface/async_huggingface.py +199 -199
  72. webscout/Provider/TTI/huggingface/sync_huggingface.py +195 -195
  73. webscout/Provider/TTI/imgninza/__init__.py +4 -4
  74. webscout/Provider/TTI/imgninza/async_ninza.py +214 -214
  75. webscout/Provider/TTI/imgninza/sync_ninza.py +209 -209
  76. webscout/Provider/TTI/talkai/__init__.py +4 -4
  77. webscout/Provider/TTI/talkai/async_talkai.py +229 -229
  78. webscout/Provider/TTI/talkai/sync_talkai.py +207 -207
  79. webscout/Provider/TTS/deepgram.py +182 -182
  80. webscout/Provider/TTS/elevenlabs.py +136 -136
  81. webscout/Provider/TTS/gesserit.py +150 -150
  82. webscout/Provider/TTS/murfai.py +138 -138
  83. webscout/Provider/TTS/parler.py +133 -134
  84. webscout/Provider/TTS/streamElements.py +360 -360
  85. webscout/Provider/TTS/utils.py +280 -280
  86. webscout/Provider/TTS/voicepod.py +116 -116
  87. webscout/Provider/TextPollinationsAI.py +2 -3
  88. webscout/Provider/WiseCat.py +193 -0
  89. webscout/Provider/__init__.py +144 -134
  90. webscout/Provider/cerebras.py +242 -227
  91. webscout/Provider/chatglm.py +204 -204
  92. webscout/Provider/dgaf.py +2 -3
  93. webscout/Provider/gaurish.py +2 -3
  94. webscout/Provider/geminiapi.py +208 -208
  95. webscout/Provider/granite.py +223 -0
  96. webscout/Provider/hermes.py +218 -218
  97. webscout/Provider/llama3mitril.py +179 -179
  98. webscout/Provider/llamatutor.py +3 -3
  99. webscout/Provider/llmchat.py +2 -3
  100. webscout/Provider/meta.py +794 -794
  101. webscout/Provider/multichat.py +331 -331
  102. webscout/Provider/typegpt.py +359 -359
  103. webscout/Provider/yep.py +2 -2
  104. webscout/__main__.py +5 -5
  105. webscout/cli.py +319 -319
  106. webscout/conversation.py +241 -242
  107. webscout/exceptions.py +328 -328
  108. webscout/litagent/__init__.py +28 -28
  109. webscout/litagent/agent.py +2 -3
  110. webscout/litprinter/__init__.py +0 -58
  111. webscout/scout/__init__.py +8 -8
  112. webscout/scout/core.py +884 -884
  113. webscout/scout/element.py +459 -459
  114. webscout/scout/parsers/__init__.py +69 -69
  115. webscout/scout/parsers/html5lib_parser.py +172 -172
  116. webscout/scout/parsers/html_parser.py +236 -236
  117. webscout/scout/parsers/lxml_parser.py +178 -178
  118. webscout/scout/utils.py +38 -38
  119. webscout/swiftcli/__init__.py +811 -811
  120. webscout/update_checker.py +2 -12
  121. webscout/version.py +1 -1
  122. webscout/webscout_search.py +5 -4
  123. webscout/zeroart/__init__.py +54 -54
  124. webscout/zeroart/base.py +60 -60
  125. webscout/zeroart/effects.py +99 -99
  126. webscout/zeroart/fonts.py +816 -816
  127. {webscout-7.1.dist-info → webscout-7.2.dist-info}/METADATA +4 -3
  128. webscout-7.2.dist-info/RECORD +217 -0
  129. webstoken/__init__.py +30 -30
  130. webstoken/classifier.py +189 -189
  131. webstoken/keywords.py +216 -216
  132. webstoken/language.py +128 -128
  133. webstoken/ner.py +164 -164
  134. webstoken/normalizer.py +35 -35
  135. webstoken/processor.py +77 -77
  136. webstoken/sentiment.py +206 -206
  137. webstoken/stemmer.py +73 -73
  138. webstoken/tagger.py +60 -60
  139. webstoken/tokenizer.py +158 -158
  140. webscout-7.1.dist-info/RECORD +0 -198
  141. {webscout-7.1.dist-info → webscout-7.2.dist-info}/LICENSE.md +0 -0
  142. {webscout-7.1.dist-info → webscout-7.2.dist-info}/WHEEL +0 -0
  143. {webscout-7.1.dist-info → webscout-7.2.dist-info}/entry_points.txt +0 -0
  144. {webscout-7.1.dist-info → webscout-7.2.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())