webscout 8.2.2__py3-none-any.whl → 2026.1.19__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.
Files changed (483) hide show
  1. webscout/AIauto.py +524 -143
  2. webscout/AIbase.py +247 -123
  3. webscout/AIutel.py +68 -132
  4. webscout/Bard.py +1072 -535
  5. webscout/Extra/GitToolkit/__init__.py +2 -2
  6. webscout/Extra/GitToolkit/gitapi/__init__.py +20 -12
  7. webscout/Extra/GitToolkit/gitapi/gist.py +142 -0
  8. webscout/Extra/GitToolkit/gitapi/organization.py +91 -0
  9. webscout/Extra/GitToolkit/gitapi/repository.py +308 -195
  10. webscout/Extra/GitToolkit/gitapi/search.py +162 -0
  11. webscout/Extra/GitToolkit/gitapi/trending.py +236 -0
  12. webscout/Extra/GitToolkit/gitapi/user.py +128 -96
  13. webscout/Extra/GitToolkit/gitapi/utils.py +82 -62
  14. webscout/Extra/YTToolkit/README.md +443 -0
  15. webscout/Extra/YTToolkit/YTdownloader.py +953 -957
  16. webscout/Extra/YTToolkit/__init__.py +3 -3
  17. webscout/Extra/YTToolkit/transcriber.py +595 -476
  18. webscout/Extra/YTToolkit/ytapi/README.md +230 -0
  19. webscout/Extra/YTToolkit/ytapi/__init__.py +22 -6
  20. webscout/Extra/YTToolkit/ytapi/captions.py +190 -0
  21. webscout/Extra/YTToolkit/ytapi/channel.py +302 -307
  22. webscout/Extra/YTToolkit/ytapi/errors.py +13 -13
  23. webscout/Extra/YTToolkit/ytapi/extras.py +178 -45
  24. webscout/Extra/YTToolkit/ytapi/hashtag.py +120 -0
  25. webscout/Extra/YTToolkit/ytapi/https.py +89 -88
  26. webscout/Extra/YTToolkit/ytapi/patterns.py +61 -61
  27. webscout/Extra/YTToolkit/ytapi/playlist.py +59 -59
  28. webscout/Extra/YTToolkit/ytapi/pool.py +8 -8
  29. webscout/Extra/YTToolkit/ytapi/query.py +143 -40
  30. webscout/Extra/YTToolkit/ytapi/shorts.py +122 -0
  31. webscout/Extra/YTToolkit/ytapi/stream.py +68 -63
  32. webscout/Extra/YTToolkit/ytapi/suggestions.py +97 -0
  33. webscout/Extra/YTToolkit/ytapi/utils.py +66 -62
  34. webscout/Extra/YTToolkit/ytapi/video.py +189 -18
  35. webscout/Extra/__init__.py +2 -3
  36. webscout/Extra/gguf.py +1298 -682
  37. webscout/Extra/tempmail/README.md +488 -0
  38. webscout/Extra/tempmail/__init__.py +28 -28
  39. webscout/Extra/tempmail/async_utils.py +143 -141
  40. webscout/Extra/tempmail/base.py +172 -161
  41. webscout/Extra/tempmail/cli.py +191 -187
  42. webscout/Extra/tempmail/emailnator.py +88 -84
  43. webscout/Extra/tempmail/mail_tm.py +378 -361
  44. webscout/Extra/tempmail/temp_mail_io.py +304 -292
  45. webscout/Extra/weather.py +196 -194
  46. webscout/Extra/weather_ascii.py +17 -15
  47. webscout/Provider/AISEARCH/PERPLEXED_search.py +175 -0
  48. webscout/Provider/AISEARCH/Perplexity.py +237 -304
  49. webscout/Provider/AISEARCH/README.md +106 -0
  50. webscout/Provider/AISEARCH/__init__.py +16 -10
  51. webscout/Provider/AISEARCH/brave_search.py +298 -0
  52. webscout/Provider/AISEARCH/iask_search.py +130 -209
  53. webscout/Provider/AISEARCH/monica_search.py +200 -246
  54. webscout/Provider/AISEARCH/webpilotai_search.py +242 -281
  55. webscout/Provider/Algion.py +413 -0
  56. webscout/Provider/Andi.py +74 -69
  57. webscout/Provider/Apriel.py +313 -0
  58. webscout/Provider/Ayle.py +323 -0
  59. webscout/Provider/ChatSandbox.py +329 -0
  60. webscout/Provider/ClaudeOnline.py +365 -0
  61. webscout/Provider/Cohere.py +232 -208
  62. webscout/Provider/DeepAI.py +367 -0
  63. webscout/Provider/Deepinfra.py +343 -173
  64. webscout/Provider/EssentialAI.py +217 -0
  65. webscout/Provider/ExaAI.py +274 -261
  66. webscout/Provider/Gemini.py +60 -54
  67. webscout/Provider/GithubChat.py +385 -367
  68. webscout/Provider/Gradient.py +286 -0
  69. webscout/Provider/Groq.py +556 -670
  70. webscout/Provider/HadadXYZ.py +323 -0
  71. webscout/Provider/HeckAI.py +392 -233
  72. webscout/Provider/HuggingFace.py +387 -0
  73. webscout/Provider/IBM.py +340 -0
  74. webscout/Provider/Jadve.py +317 -266
  75. webscout/Provider/K2Think.py +306 -0
  76. webscout/Provider/Koboldai.py +221 -381
  77. webscout/Provider/Netwrck.py +273 -228
  78. webscout/Provider/Nvidia.py +310 -0
  79. webscout/Provider/OPENAI/DeepAI.py +489 -0
  80. webscout/Provider/OPENAI/K2Think.py +423 -0
  81. webscout/Provider/OPENAI/PI.py +463 -0
  82. webscout/Provider/OPENAI/README.md +890 -0
  83. webscout/Provider/OPENAI/TogetherAI.py +405 -0
  84. webscout/Provider/OPENAI/TwoAI.py +255 -0
  85. webscout/Provider/OPENAI/__init__.py +148 -25
  86. webscout/Provider/OPENAI/ai4chat.py +348 -0
  87. webscout/Provider/OPENAI/akashgpt.py +436 -0
  88. webscout/Provider/OPENAI/algion.py +303 -0
  89. webscout/Provider/OPENAI/ayle.py +365 -0
  90. webscout/Provider/OPENAI/base.py +253 -46
  91. webscout/Provider/OPENAI/cerebras.py +296 -0
  92. webscout/Provider/OPENAI/chatgpt.py +514 -193
  93. webscout/Provider/OPENAI/chatsandbox.py +233 -0
  94. webscout/Provider/OPENAI/deepinfra.py +403 -272
  95. webscout/Provider/OPENAI/e2b.py +2370 -1350
  96. webscout/Provider/OPENAI/elmo.py +278 -0
  97. webscout/Provider/OPENAI/exaai.py +186 -138
  98. webscout/Provider/OPENAI/freeassist.py +446 -0
  99. webscout/Provider/OPENAI/gradient.py +448 -0
  100. webscout/Provider/OPENAI/groq.py +380 -0
  101. webscout/Provider/OPENAI/hadadxyz.py +292 -0
  102. webscout/Provider/OPENAI/heckai.py +100 -104
  103. webscout/Provider/OPENAI/huggingface.py +321 -0
  104. webscout/Provider/OPENAI/ibm.py +425 -0
  105. webscout/Provider/OPENAI/llmchat.py +253 -0
  106. webscout/Provider/OPENAI/llmchatco.py +378 -327
  107. webscout/Provider/OPENAI/meta.py +541 -0
  108. webscout/Provider/OPENAI/netwrck.py +110 -84
  109. webscout/Provider/OPENAI/nvidia.py +317 -0
  110. webscout/Provider/OPENAI/oivscode.py +348 -0
  111. webscout/Provider/OPENAI/openrouter.py +328 -0
  112. webscout/Provider/OPENAI/pydantic_imports.py +1 -0
  113. webscout/Provider/OPENAI/sambanova.py +397 -0
  114. webscout/Provider/OPENAI/sonus.py +126 -115
  115. webscout/Provider/OPENAI/textpollinations.py +218 -133
  116. webscout/Provider/OPENAI/toolbaz.py +136 -166
  117. webscout/Provider/OPENAI/typefully.py +419 -0
  118. webscout/Provider/OPENAI/typliai.py +279 -0
  119. webscout/Provider/OPENAI/utils.py +314 -211
  120. webscout/Provider/OPENAI/wisecat.py +103 -125
  121. webscout/Provider/OPENAI/writecream.py +185 -156
  122. webscout/Provider/OPENAI/x0gpt.py +227 -136
  123. webscout/Provider/OPENAI/zenmux.py +380 -0
  124. webscout/Provider/OpenRouter.py +386 -0
  125. webscout/Provider/Openai.py +337 -496
  126. webscout/Provider/PI.py +443 -344
  127. webscout/Provider/QwenLM.py +346 -254
  128. webscout/Provider/STT/__init__.py +28 -0
  129. webscout/Provider/STT/base.py +303 -0
  130. webscout/Provider/STT/elevenlabs.py +264 -0
  131. webscout/Provider/Sambanova.py +317 -0
  132. webscout/Provider/TTI/README.md +69 -0
  133. webscout/Provider/TTI/__init__.py +37 -12
  134. webscout/Provider/TTI/base.py +147 -0
  135. webscout/Provider/TTI/claudeonline.py +393 -0
  136. webscout/Provider/TTI/magicstudio.py +292 -0
  137. webscout/Provider/TTI/miragic.py +180 -0
  138. webscout/Provider/TTI/pollinations.py +331 -0
  139. webscout/Provider/TTI/together.py +334 -0
  140. webscout/Provider/TTI/utils.py +14 -0
  141. webscout/Provider/TTS/README.md +186 -0
  142. webscout/Provider/TTS/__init__.py +43 -7
  143. webscout/Provider/TTS/base.py +523 -0
  144. webscout/Provider/TTS/deepgram.py +286 -156
  145. webscout/Provider/TTS/elevenlabs.py +189 -111
  146. webscout/Provider/TTS/freetts.py +218 -0
  147. webscout/Provider/TTS/murfai.py +288 -113
  148. webscout/Provider/TTS/openai_fm.py +364 -0
  149. webscout/Provider/TTS/parler.py +203 -111
  150. webscout/Provider/TTS/qwen.py +334 -0
  151. webscout/Provider/TTS/sherpa.py +286 -0
  152. webscout/Provider/TTS/speechma.py +693 -180
  153. webscout/Provider/TTS/streamElements.py +275 -333
  154. webscout/Provider/TTS/utils.py +280 -280
  155. webscout/Provider/TextPollinationsAI.py +221 -121
  156. webscout/Provider/TogetherAI.py +450 -0
  157. webscout/Provider/TwoAI.py +309 -199
  158. webscout/Provider/TypliAI.py +311 -0
  159. webscout/Provider/UNFINISHED/ChatHub.py +219 -0
  160. webscout/Provider/{OPENAI/glider.py → UNFINISHED/ChutesAI.py} +160 -145
  161. webscout/Provider/UNFINISHED/GizAI.py +300 -0
  162. webscout/Provider/UNFINISHED/Marcus.py +218 -0
  163. webscout/Provider/UNFINISHED/Qodo.py +481 -0
  164. webscout/Provider/UNFINISHED/XenAI.py +330 -0
  165. webscout/Provider/{Youchat.py → UNFINISHED/Youchat.py} +64 -47
  166. webscout/Provider/UNFINISHED/aihumanizer.py +41 -0
  167. webscout/Provider/UNFINISHED/grammerchecker.py +37 -0
  168. webscout/Provider/UNFINISHED/liner.py +342 -0
  169. webscout/Provider/UNFINISHED/liner_api_request.py +246 -0
  170. webscout/Provider/UNFINISHED/samurai.py +231 -0
  171. webscout/Provider/WiseCat.py +256 -196
  172. webscout/Provider/WrDoChat.py +390 -0
  173. webscout/Provider/__init__.py +115 -198
  174. webscout/Provider/ai4chat.py +181 -202
  175. webscout/Provider/akashgpt.py +330 -342
  176. webscout/Provider/cerebras.py +397 -242
  177. webscout/Provider/cleeai.py +236 -213
  178. webscout/Provider/elmo.py +291 -234
  179. webscout/Provider/geminiapi.py +343 -208
  180. webscout/Provider/julius.py +245 -223
  181. webscout/Provider/learnfastai.py +333 -266
  182. webscout/Provider/llama3mitril.py +230 -180
  183. webscout/Provider/llmchat.py +308 -213
  184. webscout/Provider/llmchatco.py +321 -311
  185. webscout/Provider/meta.py +996 -794
  186. webscout/Provider/oivscode.py +332 -0
  187. webscout/Provider/searchchat.py +316 -293
  188. webscout/Provider/sonus.py +264 -208
  189. webscout/Provider/toolbaz.py +359 -320
  190. webscout/Provider/turboseek.py +332 -219
  191. webscout/Provider/typefully.py +262 -280
  192. webscout/Provider/x0gpt.py +332 -256
  193. webscout/__init__.py +31 -38
  194. webscout/__main__.py +5 -5
  195. webscout/cli.py +585 -293
  196. webscout/client.py +1497 -0
  197. webscout/conversation.py +140 -565
  198. webscout/exceptions.py +383 -339
  199. webscout/litagent/__init__.py +29 -29
  200. webscout/litagent/agent.py +492 -455
  201. webscout/litagent/constants.py +60 -60
  202. webscout/models.py +505 -181
  203. webscout/optimizers.py +32 -378
  204. webscout/prompt_manager.py +376 -274
  205. webscout/sanitize.py +1514 -0
  206. webscout/scout/README.md +452 -0
  207. webscout/scout/__init__.py +8 -8
  208. webscout/scout/core/__init__.py +7 -7
  209. webscout/scout/core/crawler.py +330 -140
  210. webscout/scout/core/scout.py +800 -568
  211. webscout/scout/core/search_result.py +51 -96
  212. webscout/scout/core/text_analyzer.py +64 -63
  213. webscout/scout/core/text_utils.py +412 -277
  214. webscout/scout/core/web_analyzer.py +54 -52
  215. webscout/scout/element.py +872 -460
  216. webscout/scout/parsers/__init__.py +70 -69
  217. webscout/scout/parsers/html5lib_parser.py +182 -172
  218. webscout/scout/parsers/html_parser.py +238 -236
  219. webscout/scout/parsers/lxml_parser.py +203 -178
  220. webscout/scout/utils.py +38 -37
  221. webscout/search/__init__.py +47 -0
  222. webscout/search/base.py +201 -0
  223. webscout/search/bing_main.py +45 -0
  224. webscout/search/brave_main.py +92 -0
  225. webscout/search/duckduckgo_main.py +57 -0
  226. webscout/search/engines/__init__.py +127 -0
  227. webscout/search/engines/bing/__init__.py +15 -0
  228. webscout/search/engines/bing/base.py +35 -0
  229. webscout/search/engines/bing/images.py +114 -0
  230. webscout/search/engines/bing/news.py +96 -0
  231. webscout/search/engines/bing/suggestions.py +36 -0
  232. webscout/search/engines/bing/text.py +109 -0
  233. webscout/search/engines/brave/__init__.py +19 -0
  234. webscout/search/engines/brave/base.py +47 -0
  235. webscout/search/engines/brave/images.py +213 -0
  236. webscout/search/engines/brave/news.py +353 -0
  237. webscout/search/engines/brave/suggestions.py +318 -0
  238. webscout/search/engines/brave/text.py +167 -0
  239. webscout/search/engines/brave/videos.py +364 -0
  240. webscout/search/engines/duckduckgo/__init__.py +25 -0
  241. webscout/search/engines/duckduckgo/answers.py +80 -0
  242. webscout/search/engines/duckduckgo/base.py +189 -0
  243. webscout/search/engines/duckduckgo/images.py +100 -0
  244. webscout/search/engines/duckduckgo/maps.py +183 -0
  245. webscout/search/engines/duckduckgo/news.py +70 -0
  246. webscout/search/engines/duckduckgo/suggestions.py +22 -0
  247. webscout/search/engines/duckduckgo/text.py +221 -0
  248. webscout/search/engines/duckduckgo/translate.py +48 -0
  249. webscout/search/engines/duckduckgo/videos.py +80 -0
  250. webscout/search/engines/duckduckgo/weather.py +84 -0
  251. webscout/search/engines/mojeek.py +61 -0
  252. webscout/search/engines/wikipedia.py +77 -0
  253. webscout/search/engines/yahoo/__init__.py +41 -0
  254. webscout/search/engines/yahoo/answers.py +19 -0
  255. webscout/search/engines/yahoo/base.py +34 -0
  256. webscout/search/engines/yahoo/images.py +323 -0
  257. webscout/search/engines/yahoo/maps.py +19 -0
  258. webscout/search/engines/yahoo/news.py +258 -0
  259. webscout/search/engines/yahoo/suggestions.py +140 -0
  260. webscout/search/engines/yahoo/text.py +273 -0
  261. webscout/search/engines/yahoo/translate.py +19 -0
  262. webscout/search/engines/yahoo/videos.py +302 -0
  263. webscout/search/engines/yahoo/weather.py +220 -0
  264. webscout/search/engines/yandex.py +67 -0
  265. webscout/search/engines/yep/__init__.py +13 -0
  266. webscout/search/engines/yep/base.py +34 -0
  267. webscout/search/engines/yep/images.py +101 -0
  268. webscout/search/engines/yep/suggestions.py +38 -0
  269. webscout/search/engines/yep/text.py +99 -0
  270. webscout/search/http_client.py +172 -0
  271. webscout/search/results.py +141 -0
  272. webscout/search/yahoo_main.py +57 -0
  273. webscout/search/yep_main.py +48 -0
  274. webscout/server/__init__.py +48 -0
  275. webscout/server/config.py +78 -0
  276. webscout/server/exceptions.py +69 -0
  277. webscout/server/providers.py +286 -0
  278. webscout/server/request_models.py +131 -0
  279. webscout/server/request_processing.py +404 -0
  280. webscout/server/routes.py +642 -0
  281. webscout/server/server.py +351 -0
  282. webscout/server/ui_templates.py +1171 -0
  283. webscout/swiftcli/__init__.py +79 -809
  284. webscout/swiftcli/core/__init__.py +7 -0
  285. webscout/swiftcli/core/cli.py +574 -0
  286. webscout/swiftcli/core/context.py +98 -0
  287. webscout/swiftcli/core/group.py +268 -0
  288. webscout/swiftcli/decorators/__init__.py +28 -0
  289. webscout/swiftcli/decorators/command.py +243 -0
  290. webscout/swiftcli/decorators/options.py +247 -0
  291. webscout/swiftcli/decorators/output.py +392 -0
  292. webscout/swiftcli/exceptions.py +21 -0
  293. webscout/swiftcli/plugins/__init__.py +9 -0
  294. webscout/swiftcli/plugins/base.py +134 -0
  295. webscout/swiftcli/plugins/manager.py +269 -0
  296. webscout/swiftcli/utils/__init__.py +58 -0
  297. webscout/swiftcli/utils/formatting.py +251 -0
  298. webscout/swiftcli/utils/parsing.py +368 -0
  299. webscout/update_checker.py +280 -136
  300. webscout/utils.py +28 -14
  301. webscout/version.py +2 -1
  302. webscout/version.py.bak +3 -0
  303. webscout/zeroart/__init__.py +218 -55
  304. webscout/zeroart/base.py +70 -60
  305. webscout/zeroart/effects.py +155 -99
  306. webscout/zeroart/fonts.py +1799 -816
  307. webscout-2026.1.19.dist-info/METADATA +638 -0
  308. webscout-2026.1.19.dist-info/RECORD +312 -0
  309. {webscout-8.2.2.dist-info → webscout-2026.1.19.dist-info}/WHEEL +1 -1
  310. webscout-2026.1.19.dist-info/entry_points.txt +4 -0
  311. webscout-2026.1.19.dist-info/top_level.txt +1 -0
  312. inferno/__init__.py +0 -6
  313. inferno/__main__.py +0 -9
  314. inferno/cli.py +0 -6
  315. webscout/DWEBS.py +0 -477
  316. webscout/Extra/autocoder/__init__.py +0 -9
  317. webscout/Extra/autocoder/autocoder.py +0 -849
  318. webscout/Extra/autocoder/autocoder_utiles.py +0 -332
  319. webscout/LLM.py +0 -442
  320. webscout/Litlogger/__init__.py +0 -67
  321. webscout/Litlogger/core/__init__.py +0 -6
  322. webscout/Litlogger/core/level.py +0 -23
  323. webscout/Litlogger/core/logger.py +0 -165
  324. webscout/Litlogger/handlers/__init__.py +0 -12
  325. webscout/Litlogger/handlers/console.py +0 -33
  326. webscout/Litlogger/handlers/file.py +0 -143
  327. webscout/Litlogger/handlers/network.py +0 -173
  328. webscout/Litlogger/styles/__init__.py +0 -7
  329. webscout/Litlogger/styles/colors.py +0 -249
  330. webscout/Litlogger/styles/formats.py +0 -458
  331. webscout/Litlogger/styles/text.py +0 -87
  332. webscout/Litlogger/utils/__init__.py +0 -6
  333. webscout/Litlogger/utils/detectors.py +0 -153
  334. webscout/Litlogger/utils/formatters.py +0 -200
  335. webscout/Local/__init__.py +0 -12
  336. webscout/Local/__main__.py +0 -9
  337. webscout/Local/api.py +0 -576
  338. webscout/Local/cli.py +0 -516
  339. webscout/Local/config.py +0 -75
  340. webscout/Local/llm.py +0 -287
  341. webscout/Local/model_manager.py +0 -253
  342. webscout/Local/server.py +0 -721
  343. webscout/Local/utils.py +0 -93
  344. webscout/Provider/AI21.py +0 -177
  345. webscout/Provider/AISEARCH/DeepFind.py +0 -250
  346. webscout/Provider/AISEARCH/ISou.py +0 -256
  347. webscout/Provider/AISEARCH/felo_search.py +0 -228
  348. webscout/Provider/AISEARCH/genspark_search.py +0 -208
  349. webscout/Provider/AISEARCH/hika_search.py +0 -194
  350. webscout/Provider/AISEARCH/scira_search.py +0 -324
  351. webscout/Provider/Aitopia.py +0 -292
  352. webscout/Provider/AllenAI.py +0 -413
  353. webscout/Provider/Blackboxai.py +0 -229
  354. webscout/Provider/C4ai.py +0 -432
  355. webscout/Provider/ChatGPTClone.py +0 -226
  356. webscout/Provider/ChatGPTES.py +0 -237
  357. webscout/Provider/ChatGPTGratis.py +0 -194
  358. webscout/Provider/Chatify.py +0 -175
  359. webscout/Provider/Cloudflare.py +0 -273
  360. webscout/Provider/DeepSeek.py +0 -196
  361. webscout/Provider/ElectronHub.py +0 -709
  362. webscout/Provider/ExaChat.py +0 -342
  363. webscout/Provider/Free2GPT.py +0 -241
  364. webscout/Provider/GPTWeb.py +0 -193
  365. webscout/Provider/Glider.py +0 -211
  366. webscout/Provider/HF_space/__init__.py +0 -0
  367. webscout/Provider/HF_space/qwen_qwen2.py +0 -206
  368. webscout/Provider/HuggingFaceChat.py +0 -462
  369. webscout/Provider/Hunyuan.py +0 -272
  370. webscout/Provider/LambdaChat.py +0 -392
  371. webscout/Provider/Llama.py +0 -200
  372. webscout/Provider/Llama3.py +0 -204
  373. webscout/Provider/Marcus.py +0 -148
  374. webscout/Provider/OLLAMA.py +0 -396
  375. webscout/Provider/OPENAI/c4ai.py +0 -367
  376. webscout/Provider/OPENAI/chatgptclone.py +0 -460
  377. webscout/Provider/OPENAI/exachat.py +0 -433
  378. webscout/Provider/OPENAI/freeaichat.py +0 -352
  379. webscout/Provider/OPENAI/opkfc.py +0 -488
  380. webscout/Provider/OPENAI/scirachat.py +0 -463
  381. webscout/Provider/OPENAI/standardinput.py +0 -425
  382. webscout/Provider/OPENAI/typegpt.py +0 -346
  383. webscout/Provider/OPENAI/uncovrAI.py +0 -455
  384. webscout/Provider/OPENAI/venice.py +0 -413
  385. webscout/Provider/OPENAI/yep.py +0 -327
  386. webscout/Provider/OpenGPT.py +0 -199
  387. webscout/Provider/Perplexitylabs.py +0 -415
  388. webscout/Provider/Phind.py +0 -535
  389. webscout/Provider/PizzaGPT.py +0 -198
  390. webscout/Provider/Reka.py +0 -214
  391. webscout/Provider/StandardInput.py +0 -278
  392. webscout/Provider/TTI/AiForce/__init__.py +0 -22
  393. webscout/Provider/TTI/AiForce/async_aiforce.py +0 -224
  394. webscout/Provider/TTI/AiForce/sync_aiforce.py +0 -245
  395. webscout/Provider/TTI/FreeAIPlayground/__init__.py +0 -9
  396. webscout/Provider/TTI/FreeAIPlayground/async_freeaiplayground.py +0 -181
  397. webscout/Provider/TTI/FreeAIPlayground/sync_freeaiplayground.py +0 -180
  398. webscout/Provider/TTI/ImgSys/__init__.py +0 -23
  399. webscout/Provider/TTI/ImgSys/async_imgsys.py +0 -202
  400. webscout/Provider/TTI/ImgSys/sync_imgsys.py +0 -195
  401. webscout/Provider/TTI/MagicStudio/__init__.py +0 -2
  402. webscout/Provider/TTI/MagicStudio/async_magicstudio.py +0 -111
  403. webscout/Provider/TTI/MagicStudio/sync_magicstudio.py +0 -109
  404. webscout/Provider/TTI/Nexra/__init__.py +0 -22
  405. webscout/Provider/TTI/Nexra/async_nexra.py +0 -286
  406. webscout/Provider/TTI/Nexra/sync_nexra.py +0 -258
  407. webscout/Provider/TTI/PollinationsAI/__init__.py +0 -23
  408. webscout/Provider/TTI/PollinationsAI/async_pollinations.py +0 -311
  409. webscout/Provider/TTI/PollinationsAI/sync_pollinations.py +0 -265
  410. webscout/Provider/TTI/aiarta/__init__.py +0 -2
  411. webscout/Provider/TTI/aiarta/async_aiarta.py +0 -482
  412. webscout/Provider/TTI/aiarta/sync_aiarta.py +0 -440
  413. webscout/Provider/TTI/artbit/__init__.py +0 -22
  414. webscout/Provider/TTI/artbit/async_artbit.py +0 -155
  415. webscout/Provider/TTI/artbit/sync_artbit.py +0 -148
  416. webscout/Provider/TTI/fastflux/__init__.py +0 -22
  417. webscout/Provider/TTI/fastflux/async_fastflux.py +0 -261
  418. webscout/Provider/TTI/fastflux/sync_fastflux.py +0 -252
  419. webscout/Provider/TTI/huggingface/__init__.py +0 -22
  420. webscout/Provider/TTI/huggingface/async_huggingface.py +0 -199
  421. webscout/Provider/TTI/huggingface/sync_huggingface.py +0 -195
  422. webscout/Provider/TTI/piclumen/__init__.py +0 -23
  423. webscout/Provider/TTI/piclumen/async_piclumen.py +0 -268
  424. webscout/Provider/TTI/piclumen/sync_piclumen.py +0 -233
  425. webscout/Provider/TTI/pixelmuse/__init__.py +0 -4
  426. webscout/Provider/TTI/pixelmuse/async_pixelmuse.py +0 -249
  427. webscout/Provider/TTI/pixelmuse/sync_pixelmuse.py +0 -182
  428. webscout/Provider/TTI/talkai/__init__.py +0 -4
  429. webscout/Provider/TTI/talkai/async_talkai.py +0 -229
  430. webscout/Provider/TTI/talkai/sync_talkai.py +0 -207
  431. webscout/Provider/TTS/gesserit.py +0 -127
  432. webscout/Provider/TeachAnything.py +0 -187
  433. webscout/Provider/Venice.py +0 -219
  434. webscout/Provider/VercelAI.py +0 -234
  435. webscout/Provider/WebSim.py +0 -228
  436. webscout/Provider/Writecream.py +0 -211
  437. webscout/Provider/WritingMate.py +0 -197
  438. webscout/Provider/aimathgpt.py +0 -189
  439. webscout/Provider/askmyai.py +0 -158
  440. webscout/Provider/asksteve.py +0 -203
  441. webscout/Provider/bagoodex.py +0 -145
  442. webscout/Provider/chatglm.py +0 -205
  443. webscout/Provider/copilot.py +0 -428
  444. webscout/Provider/freeaichat.py +0 -271
  445. webscout/Provider/gaurish.py +0 -244
  446. webscout/Provider/geminiprorealtime.py +0 -160
  447. webscout/Provider/granite.py +0 -187
  448. webscout/Provider/hermes.py +0 -219
  449. webscout/Provider/koala.py +0 -268
  450. webscout/Provider/labyrinth.py +0 -340
  451. webscout/Provider/lepton.py +0 -194
  452. webscout/Provider/llamatutor.py +0 -192
  453. webscout/Provider/multichat.py +0 -325
  454. webscout/Provider/promptrefine.py +0 -193
  455. webscout/Provider/scira_chat.py +0 -277
  456. webscout/Provider/scnet.py +0 -187
  457. webscout/Provider/talkai.py +0 -194
  458. webscout/Provider/tutorai.py +0 -252
  459. webscout/Provider/typegpt.py +0 -232
  460. webscout/Provider/uncovr.py +0 -312
  461. webscout/Provider/yep.py +0 -376
  462. webscout/litprinter/__init__.py +0 -59
  463. webscout/scout/core.py +0 -881
  464. webscout/tempid.py +0 -128
  465. webscout/webscout_search.py +0 -1346
  466. webscout/webscout_search_async.py +0 -877
  467. webscout/yep_search.py +0 -297
  468. webscout-8.2.2.dist-info/METADATA +0 -734
  469. webscout-8.2.2.dist-info/RECORD +0 -309
  470. webscout-8.2.2.dist-info/entry_points.txt +0 -5
  471. webscout-8.2.2.dist-info/top_level.txt +0 -3
  472. webstoken/__init__.py +0 -30
  473. webstoken/classifier.py +0 -189
  474. webstoken/keywords.py +0 -216
  475. webstoken/language.py +0 -128
  476. webstoken/ner.py +0 -164
  477. webstoken/normalizer.py +0 -35
  478. webstoken/processor.py +0 -77
  479. webstoken/sentiment.py +0 -206
  480. webstoken/stemmer.py +0 -73
  481. webstoken/tagger.py +0 -60
  482. webstoken/tokenizer.py +0 -158
  483. {webscout-8.2.2.dist-info → webscout-2026.1.19.dist-info/licenses}/LICENSE.md +0 -0
@@ -1,809 +1,79 @@
1
- """
2
- SwiftCLI - A powerful Python CLI framework
3
-
4
- A modern, feature-rich CLI framework for building awesome command-line applications.
5
- Built with love for the Python community!
6
-
7
- Basic Usage:
8
- >>> from swiftcli import CLI
9
- >>> app = CLI(name="my-app", help="My awesome CLI app")
10
- >>> @app.command()
11
- ... def hello(name: str):
12
- ... '''Say hello to someone'''
13
- ... print(f"Hello {name}!")
14
- >>> app.run()
15
-
16
- Advanced Usage:
17
- >>> @app.group()
18
- ... def db():
19
- ... '''Database commands'''
20
- ... pass
21
- >>>
22
- >>> @db.command()
23
- ... def migrate():
24
- ... '''Run database migrations'''
25
- ... print("Running migrations...")
26
-
27
- For more examples, check out the documentation!
28
- """
29
-
30
- import importlib
31
- import os
32
- import sys
33
- import inspect
34
- from typing import Any, Dict, List, Optional, Callable
35
- from functools import wraps
36
- from pathlib import Path
37
- from rich.console import Console
38
- from rich.table import Table
39
- from rich.progress import Progress, SpinnerColumn, TextColumn
40
-
41
- # Console setup
42
- console = Console()
43
-
44
- class UsageError(Exception):
45
- """Raised when CLI is used incorrectly"""
46
- pass
47
-
48
- class BadParameter(UsageError):
49
- """Raised when a parameter is invalid"""
50
- pass
51
-
52
- class Context:
53
- """
54
- Context object that holds state for the CLI app.
55
-
56
- Attributes:
57
- cli (CLI): The CLI application instance.
58
- parent (Context): The parent context.
59
- command (str): The current command.
60
- obj (Any): The current object.
61
- params (Dict[str, Any]): The current parameters.
62
- """
63
- def __init__(
64
- self,
65
- cli: 'CLI',
66
- parent: Optional['Context'] = None,
67
- command: Optional[str] = None,
68
- obj: Any = None
69
- ):
70
- self.cli = cli
71
- self.parent = parent
72
- self.command = command
73
- self.obj = obj
74
- self.params = {}
75
-
76
- class Plugin:
77
- """
78
- Base class for SwiftCLI plugins.
79
-
80
- Attributes:
81
- app (CLI): The CLI application instance.
82
- enabled (bool): Whether the plugin is enabled.
83
- config (Dict[str, Any]): The plugin configuration.
84
- """
85
- def __init__(self):
86
- self.app = None
87
- self.enabled = True
88
- self.config: Dict[str, Any] = {}
89
-
90
- def init_app(self, app):
91
- """Initialize plugin with CLI app instance"""
92
- self.app = app
93
-
94
- def before_command(self, command: str, args: List[str]) -> Optional[bool]:
95
- """Called before command execution"""
96
- pass
97
-
98
- def after_command(self, command: str, args: List[str], result: Any):
99
- """Called after command execution"""
100
- pass
101
-
102
- def on_error(self, command: str, error: Exception):
103
- """Called when command raises an error"""
104
- pass
105
-
106
- def on_help(self, command: str) -> Optional[str]:
107
- """Called when help is requested for a command"""
108
- pass
109
-
110
- def on_completion(self, command: str, incomplete: str) -> List[str]:
111
- """Called when shell completion is requested"""
112
- return []
113
-
114
- class PluginManager:
115
- """
116
- Manages SwiftCLI plugins.
117
-
118
- Attributes:
119
- plugins (List[Plugin]): The list of plugins.
120
- plugin_dir (str): The plugin directory.
121
- """
122
- def __init__(self):
123
- self.plugins: List[Plugin] = []
124
- self.plugin_dir = os.path.expanduser("~/.swiftcli/plugins")
125
- os.makedirs(self.plugin_dir, exist_ok=True)
126
- sys.path.append(self.plugin_dir)
127
-
128
- def register(self, plugin: Plugin):
129
- """Register a new plugin"""
130
- self.plugins.append(plugin)
131
-
132
- def load_plugins(self):
133
- """Load all plugins from plugin directory"""
134
- for file in Path(self.plugin_dir).glob("*.py"):
135
- if file.name.startswith("_"):
136
- continue
137
- try:
138
- module = importlib.import_module(file.stem)
139
- for attr_name in dir(module):
140
- attr = getattr(module, attr_name)
141
- if (isinstance(attr, type) and
142
- issubclass(attr, Plugin) and
143
- attr is not Plugin):
144
- plugin = attr()
145
- self.register(plugin)
146
- except Exception as e:
147
- console.print(f"[red]Error loading plugin {file.name}: {e}[/red]")
148
-
149
- def before_command(self, command: str, args: List[str]) -> bool:
150
- """Run before_command hooks"""
151
- for plugin in self.plugins:
152
- if not plugin.enabled:
153
- continue
154
- try:
155
- result = plugin.before_command(command, args)
156
- if result is False:
157
- return False
158
- except Exception as e:
159
- console.print(f"[red]Error in plugin {plugin.__class__.__name__}: {e}[/red]")
160
- return True
161
-
162
- def after_command(self, command: str, args: List[str], result: Any):
163
- """Run after_command hooks"""
164
- for plugin in self.plugins:
165
- if not plugin.enabled:
166
- continue
167
- try:
168
- plugin.after_command(command, args, result)
169
- except Exception as e:
170
- console.print(f"[red]Error in plugin {plugin.__class__.__name__}: {e}[/red]")
171
-
172
- def on_error(self, command: str, error: Exception):
173
- """Run error hooks"""
174
- for plugin in self.plugins:
175
- if not plugin.enabled:
176
- continue
177
- try:
178
- plugin.on_error(command, error)
179
- except Exception as e:
180
- console.print(f"[red]Error in plugin {plugin.__class__.__name__}: {e}[/red]")
181
-
182
- class Group:
183
- """
184
- Command group that can contain subcommands and be chained.
185
-
186
- Basic Usage:
187
- >>> @app.group()
188
- ... def db():
189
- ... '''Database commands'''
190
- ... pass
191
- >>> @db.command()
192
- ... def migrate():
193
- ... '''Run migrations'''
194
- ... pass
195
-
196
- Advanced Usage:
197
- >>> @app.group(chain=True)
198
- ... def process():
199
- ... '''Process data'''
200
- ... pass
201
- >>> @process.command()
202
- ... def validate():
203
- ... '''Validate data'''
204
- ... pass
205
- """
206
- def __init__(
207
- self,
208
- name: str = None,
209
- help: str = None,
210
- chain: bool = False,
211
- invoke_without_command: bool = False
212
- ):
213
- self.name = name
214
- self.help = help
215
- self.chain = chain
216
- self.invoke_without_command = invoke_without_command
217
- self.commands = {}
218
-
219
- def command(
220
- self,
221
- name: str = None,
222
- help: str = None,
223
- aliases: List[str] = None,
224
- hidden: bool = False
225
- ):
226
- """Register a new command"""
227
- def decorator(f):
228
- cmd_name = name or f.__name__
229
- self.commands[cmd_name] = {
230
- 'func': f,
231
- 'help': help or f.__doc__,
232
- 'aliases': aliases or [],
233
- 'hidden': hidden
234
- }
235
- return f
236
- return decorator
237
-
238
- def group(self, *args, **kwargs):
239
- """Create a subgroup"""
240
- def decorator(f):
241
- subgroup = Group(*args, **kwargs)
242
- self.commands[subgroup.name] = subgroup
243
- return subgroup
244
- return decorator
245
-
246
- def run(self, args: List[str]):
247
- """Run the group command"""
248
- if not args or args[0] in ['-h', '--help']:
249
- self._print_help()
250
- return
251
-
252
- command_name = args[0]
253
- command_args = args[1:]
254
-
255
- if command_name not in self.commands:
256
- console.print(f"[red]Unknown command: {command_name}[/red]")
257
- self._print_help()
258
- return 1
259
-
260
- command = self.commands[command_name]
261
- try:
262
- result = command['func'](**self._parse_args(command, command_args))
263
- if self.chain and result is not None:
264
- return result
265
- except Exception as e:
266
- console.print(f"[red]Error: {str(e)}[/red]")
267
- return 1
268
-
269
- def _parse_args(self, command: Dict, args: List[str]) -> Dict[str, Any]:
270
- """Parse command arguments"""
271
- params = {}
272
- func = command['func']
273
- sig = inspect.signature(func)
274
-
275
- # Handle options
276
- if hasattr(func, '_options'):
277
- for opt in func._options:
278
- # Get the destination parameter name from the longest option
279
- param_decls = sorted(opt['param_decls'], key=len, reverse=True)
280
- param_name = param_decls[0].lstrip('-').replace('-', '_')
281
-
282
- # If there's a parameter name in the signature, use that instead
283
- for param in sig.parameters.values():
284
- if param.name in [d.lstrip('-').replace('-', '_') for d in param_decls]:
285
- param_name = param.name
286
- break
287
-
288
- found = False
289
- multiple_values = []
290
-
291
- # Check for long and short options
292
- i = 0
293
- while i < len(args):
294
- if args[i] in opt['param_decls']:
295
- if opt.get('is_flag', False):
296
- if opt.get('multiple', False):
297
- multiple_values.append(True)
298
- else:
299
- params[param_name] = True
300
- else:
301
- if i + 1 < len(args):
302
- value = args[i + 1]
303
- # Convert value to the correct type
304
- if 'type' in opt:
305
- try:
306
- value = opt['type'](value)
307
- except ValueError:
308
- raise UsageError(f"Invalid value for {args[i]}: {value}")
309
-
310
- if opt.get('multiple', False):
311
- multiple_values.append(value)
312
- else:
313
- params[param_name] = value
314
- args.pop(i + 1)
315
- else:
316
- raise UsageError(f"Option {args[i]} requires a value")
317
- args.pop(i)
318
- found = True
319
- if not opt.get('multiple', False):
320
- break
321
- else:
322
- i += 1
323
-
324
- # Set multiple values if any
325
- if multiple_values:
326
- params[param_name] = multiple_values
327
-
328
- # Handle required options
329
- if not found and opt.get('required', False):
330
- raise UsageError(f"Option {opt['param_decls'][0]} is required")
331
-
332
- # Set default value if not found
333
- if not found and 'default' in opt:
334
- params[param_name] = opt['default']
335
-
336
- # Handle arguments
337
- if hasattr(func, '_arguments'):
338
- for i, arg in enumerate(func._arguments):
339
- if i < len(args):
340
- value = args[i]
341
- # Convert value to the correct type
342
- if 'type' in arg:
343
- try:
344
- value = arg['type'](value)
345
- except ValueError:
346
- raise UsageError(f"Invalid value for {arg['name']}: {value}")
347
- params[arg['name']] = value
348
- elif arg.get('required', True):
349
- raise UsageError(f"Argument {arg['name']} is required")
350
- elif 'default' in arg:
351
- params[arg['name']] = arg['default']
352
-
353
- # Handle environment variables
354
- if hasattr(func, '_envvars'):
355
- for env in func._envvars:
356
- value = os.environ.get(env['name'])
357
- if env.get('required', False) and not value:
358
- raise UsageError(f"Environment variable {env['name']} is required")
359
- if value:
360
- # Convert value to the correct type
361
- if 'type' in env:
362
- try:
363
- value = env['type'](value)
364
- except ValueError:
365
- raise UsageError(f"Invalid value for {env['name']}: {value}")
366
- params[env['name'].lower()] = value
367
-
368
- return params
369
-
370
- def _print_help(self):
371
- """Print group help message"""
372
- console.print(f"\n{self.name} commands:")
373
- if self.help:
374
- console.print(f"\n{self.help}")
375
-
376
- for name, cmd in self.commands.items():
377
- if not cmd.get('hidden', False):
378
- console.print(f" {name:20} {cmd['help'] or ''}")
379
-
380
- console.print("\nUse -h or --help with any command for more info")
381
-
382
- class CLI:
383
- """
384
- The main CLI application class that handles all command registration and execution.
385
-
386
- Basic Usage:
387
- >>> from swiftcli import CLI
388
- >>> app = CLI("myapp")
389
- >>> @app.command()
390
- ... def greet(name: str):
391
- ... print(f"Hello {name}!")
392
- >>> app.run()
393
-
394
- Advanced Usage:
395
- >>> app = CLI("myapp", version="1.0.0")
396
- >>> @app.group()
397
- ... def config():
398
- ... '''Manage configuration'''
399
- ... pass
400
- >>> @config.command()
401
- ... def set(key: str, value: str):
402
- ... '''Set config value'''
403
- ... print(f"Setting {key}={value}")
404
- """
405
- def __init__(
406
- self,
407
- name: str = None,
408
- help: str = None,
409
- version: str = None,
410
- chain: bool = False
411
- ):
412
- self.name = name
413
- self.help = help
414
- self.version = version
415
- self.chain = chain
416
- self.commands = {}
417
- self.groups = {}
418
- self.plugin_manager = PluginManager()
419
-
420
- def command(
421
- self,
422
- name: str = None,
423
- help: str = None,
424
- aliases: List[str] = None,
425
- hidden: bool = False
426
- ):
427
- """
428
- Decorator to register a new command.
429
-
430
- Basic Usage:
431
- >>> @app.command()
432
- ... def hello(name: str):
433
- ... '''Say hello'''
434
- ... print(f"Hello {name}!")
435
-
436
- Advanced Usage:
437
- >>> @app.command(name="greet", aliases=["hi", "hey"])
438
- ... def hello(name: str):
439
- ... '''Greet someone'''
440
- ... print(f"Hello {name}!")
441
- """
442
- def decorator(f):
443
- cmd_name = name or f.__name__
444
- self.commands[cmd_name] = {
445
- 'func': f,
446
- 'help': help or f.__doc__,
447
- 'aliases': aliases or [],
448
- 'hidden': hidden
449
- }
450
- return f
451
- return decorator
452
-
453
- def group(
454
- self,
455
- name: str = None,
456
- help: str = None,
457
- chain: bool = False,
458
- **kwargs
459
- ):
460
- """Create a command group"""
461
- def decorator(f):
462
- if hasattr(f, '_group'):
463
- group_info = f._group
464
- group = Group(
465
- name=group_info['name'],
466
- help=group_info['help'],
467
- chain=group_info['chain'],
468
- invoke_without_command=group_info['invoke_without_command']
469
- )
470
- else:
471
- group = Group(
472
- name=name or f.__name__,
473
- help=help or f.__doc__,
474
- chain=chain
475
- )
476
- self.groups[group.name] = group
477
- return group
478
- return decorator
479
-
480
- def run(self, args: List[str] = None):
481
- """Run the CLI application"""
482
- args = args or sys.argv[1:]
483
-
484
- if not args or args[0] in ['-h', '--help']:
485
- self._print_help()
486
- return
487
-
488
- if args[0] in ['-v', '--version'] and self.version:
489
- console.print(self.version)
490
- return
491
-
492
- command_name = args[0]
493
- command_args = args[1:]
494
-
495
- # Check if it's a group command
496
- if command_name in self.groups:
497
- group = self.groups[command_name]
498
- if len(command_args) == 0:
499
- if not group.invoke_without_command:
500
- group._print_help()
501
- return
502
- else:
503
- return group.run(command_args)
504
-
505
- # Regular command
506
- if command_name not in self.commands:
507
- console.print(f"[red]Unknown command: {command_name}[/red]")
508
- self._print_help()
509
- return 1
510
-
511
- command = self.commands[command_name]
512
- try:
513
- ctx = Context(self, command=command_name)
514
- result = command['func'](**self._parse_args(command, command_args))
515
-
516
- if self.chain and result is not None:
517
- return result
518
-
519
- except Exception as e:
520
- console.print(f"[red]Error: {str(e)}[/red]")
521
- return 1
522
-
523
- def _parse_args(self, command: Dict, args: List[str]) -> Dict[str, Any]:
524
- """Parse command arguments"""
525
- params = {}
526
- func = command['func']
527
- sig = inspect.signature(func)
528
-
529
- # Handle options
530
- if hasattr(func, '_options'):
531
- for opt in func._options:
532
- # Get the destination parameter name from the longest option
533
- param_decls = sorted(opt['param_decls'], key=len, reverse=True)
534
- param_name = param_decls[0].lstrip('-').replace('-', '_')
535
-
536
- # If there's a parameter name in the signature, use that instead
537
- for param in sig.parameters.values():
538
- if param.name in [d.lstrip('-').replace('-', '_') for d in param_decls]:
539
- param_name = param.name
540
- break
541
-
542
- found = False
543
- multiple_values = []
544
-
545
- # Check for long and short options
546
- i = 0
547
- while i < len(args):
548
- if args[i] in opt['param_decls']:
549
- if opt.get('is_flag', False):
550
- if opt.get('multiple', False):
551
- multiple_values.append(True)
552
- else:
553
- params[param_name] = True
554
- else:
555
- if i + 1 < len(args):
556
- value = args[i + 1]
557
- # Convert value to the correct type
558
- if 'type' in opt:
559
- try:
560
- value = opt['type'](value)
561
- except ValueError:
562
- raise UsageError(f"Invalid value for {args[i]}: {value}")
563
-
564
- if opt.get('multiple', False):
565
- multiple_values.append(value)
566
- else:
567
- params[param_name] = value
568
- args.pop(i + 1)
569
- else:
570
- raise UsageError(f"Option {args[i]} requires a value")
571
- args.pop(i)
572
- found = True
573
- if not opt.get('multiple', False):
574
- break
575
- else:
576
- i += 1
577
-
578
- # Set multiple values if any
579
- if multiple_values:
580
- params[param_name] = multiple_values
581
-
582
- # Handle required options
583
- if not found and opt.get('required', False):
584
- raise UsageError(f"Option {opt['param_decls'][0]} is required")
585
-
586
- # Set default value if not found
587
- if not found and 'default' in opt:
588
- params[param_name] = opt['default']
589
-
590
- # Handle arguments
591
- if hasattr(func, '_arguments'):
592
- for i, arg in enumerate(func._arguments):
593
- if i < len(args):
594
- value = args[i]
595
- # Convert value to the correct type
596
- if 'type' in arg:
597
- try:
598
- value = arg['type'](value)
599
- except ValueError:
600
- raise UsageError(f"Invalid value for {arg['name']}: {value}")
601
- params[arg['name']] = value
602
- elif arg.get('required', True):
603
- raise UsageError(f"Argument {arg['name']} is required")
604
- elif 'default' in arg:
605
- params[arg['name']] = arg['default']
606
-
607
- # Handle environment variables
608
- if hasattr(func, '_envvars'):
609
- for env in func._envvars:
610
- value = os.environ.get(env['name'])
611
- if env.get('required', False) and not value:
612
- raise UsageError(f"Environment variable {env['name']} is required")
613
- if value:
614
- # Convert value to the correct type
615
- if 'type' in env:
616
- try:
617
- value = env['type'](value)
618
- except ValueError:
619
- raise UsageError(f"Invalid value for {env['name']}: {value}")
620
- params[env['name'].lower()] = value
621
-
622
- return params
623
-
624
- def _print_help(self):
625
- """Print main help message"""
626
- console.print(f"\n{self.name or 'CLI Application'}")
627
- if self.help:
628
- console.print(f"\n{self.help}")
629
-
630
- console.print("\nCommands:")
631
- for name, cmd in self.commands.items():
632
- if not cmd.get('hidden', False):
633
- console.print(f" {name:20} {cmd['help'] or ''}")
634
-
635
- for name, group in self.groups.items():
636
- console.print(f"\n{name} commands:")
637
- for cmd_name, cmd in group.commands.items():
638
- if not cmd.get('hidden', False):
639
- console.print(f" {name} {cmd_name:20} {cmd['help'] or ''}")
640
-
641
- console.print("\nUse -h or --help with any command for more info")
642
-
643
- def command(
644
- name: str = None,
645
- help: str = None,
646
- aliases: List[str] = None,
647
- hidden: bool = False
648
- ):
649
- """
650
- Decorator to register a new command.
651
-
652
- Basic Usage:
653
- >>> @app.command()
654
- ... def hello(name: str):
655
- ... '''Say hello'''
656
- ... print(f"Hello {name}!")
657
-
658
- Advanced Usage:
659
- >>> @app.command(name="greet", aliases=["hi", "hey"])
660
- ... def hello(name: str):
661
- ... '''Greet someone'''
662
- ... print(f"Hello {name}!")
663
- """
664
- def decorator(f: Callable) -> Callable:
665
- f._command = {
666
- 'name': name or f.__name__,
667
- 'help': help or f.__doc__,
668
- 'aliases': aliases or [],
669
- 'hidden': hidden
670
- }
671
- return f
672
- return decorator
673
-
674
- def option(*param_decls, **attrs):
675
- """
676
- Decorator to add an option to a command.
677
-
678
- Basic Usage:
679
- >>> @app.command()
680
- ... @option("--count", type=int, default=1)
681
- ... def repeat(count: int, message: str):
682
- ... '''Repeat a message'''
683
- ... for _ in range(count):
684
- ... print(message)
685
-
686
- Advanced Usage:
687
- >>> @app.command()
688
- ... @option("--format", "-f", type=click.Choice(["json", "yaml"]))
689
- ... def export(format: str):
690
- ... '''Export data'''
691
- ... print(f"Exporting as {format}")
692
- """
693
- def decorator(f: Callable) -> Callable:
694
- if not hasattr(f, '_options'):
695
- f._options = []
696
-
697
- # Set default values
698
- attrs.setdefault('type', str)
699
- attrs.setdefault('required', False)
700
- attrs.setdefault('default', None)
701
- attrs.setdefault('help', None)
702
- attrs.setdefault('is_flag', False)
703
- attrs.setdefault('multiple', False)
704
- attrs.setdefault('count', False)
705
- attrs.setdefault('prompt', False)
706
- attrs.setdefault('hide_input', False)
707
- attrs.setdefault('confirmation_prompt', False)
708
- attrs.setdefault('choices', None)
709
- attrs.setdefault('callback', None)
710
- attrs.setdefault('show_default', True)
711
- attrs.setdefault('hidden', False)
712
-
713
- f._options.append({
714
- 'param_decls': param_decls,
715
- **attrs
716
- })
717
- return f
718
- return decorator
719
-
720
- def argument(name: str, **attrs):
721
- """Argument decorator"""
722
- def decorator(f: Callable) -> Callable:
723
- if not hasattr(f, '_arguments'):
724
- f._arguments = []
725
- f._arguments.append({
726
- 'name': name,
727
- **attrs
728
- })
729
- return f
730
- return decorator
731
-
732
- def group(
733
- name: str = None,
734
- help: str = None,
735
- chain: bool = False,
736
- invoke_without_command: bool = False
737
- ):
738
- """Group decorator"""
739
- def decorator(f: Callable) -> Callable:
740
- f._group = {
741
- 'name': name or f.__name__,
742
- 'help': help or f.__doc__,
743
- 'chain': chain,
744
- 'invoke_without_command': invoke_without_command
745
- }
746
- return f
747
- return decorator
748
-
749
- def pass_context(f: Callable) -> Callable:
750
- """Pass context decorator"""
751
- f._pass_context = True
752
- return f
753
-
754
- def envvar(name: str, help: str = None, required: bool = False):
755
- """Environment variable decorator"""
756
- def decorator(f: Callable) -> Callable:
757
- if not hasattr(f, '_envvars'):
758
- f._envvars = []
759
- f._envvars.append({
760
- 'name': name,
761
- 'help': help,
762
- 'required': required
763
- })
764
- return f
765
- return decorator
766
-
767
- def config_file(path: str = None, auto_create: bool = True):
768
- """Configuration file decorator"""
769
- def decorator(f: Callable) -> Callable:
770
- f._config = {
771
- 'path': path,
772
- 'auto_create': auto_create
773
- }
774
- return f
775
- return decorator
776
-
777
- def table_output(headers: List[str], style: str = None):
778
- """Table output decorator"""
779
- def decorator(f: Callable) -> Callable:
780
- @wraps(f)
781
- def wrapper(*args, **kwargs):
782
- result = f(*args, **kwargs)
783
- if result:
784
- table = Table(show_header=True, header_style="bold blue")
785
- for header in headers:
786
- table.add_column(header)
787
- for row in result:
788
- table.add_row(*[str(cell) for cell in row])
789
- console.print(table)
790
- return result
791
- return wrapper
792
- return decorator
793
-
794
- def progress(description: str = None):
795
- """Progress decorator"""
796
- def decorator(f: Callable) -> Callable:
797
- @wraps(f)
798
- def wrapper(*args, **kwargs):
799
- with Progress(
800
- SpinnerColumn(),
801
- TextColumn("[progress.description]{task.description}"),
802
- transient=True,
803
- ) as progress:
804
- task = progress.add_task(description or f.__name__, total=None)
805
- result = f(*args, **kwargs)
806
- progress.update(task, completed=True)
807
- return result
808
- return wrapper
809
- return decorator
1
+ """
2
+ SwiftCLI - Build Beautiful Command-Line Applications at Light Speed
3
+
4
+ A modern, feature-rich CLI framework for building awesome command-line applications.
5
+ Built with love for the Python community!
6
+
7
+ Basic Usage:
8
+ >>> from swiftcli import CLI
9
+ >>> app = CLI(name="my-app", help="My awesome CLI app")
10
+ >>> @app.command()
11
+ ... def hello(name: str):
12
+ ... '''Say hello to someone'''
13
+ ... print(f"Hello {name}!")
14
+ >>> app.run()
15
+
16
+ For more examples and documentation, visit:
17
+ https://github.com/OEvortex/Webscout/tree/main/webscout/swiftcli
18
+ """
19
+
20
+ from .core.cli import CLI
21
+ from .core.context import Context
22
+ from .core.group import Group
23
+
24
+ # Command decorators
25
+ from .decorators.command import argument, command, flag, group, pass_context
26
+
27
+ # Option decorators
28
+ from .decorators.options import config_file, envvar, help_option, option, version_option
29
+
30
+ # Output decorators
31
+ from .decorators.output import (
32
+ format_output,
33
+ json_output,
34
+ pager_output,
35
+ panel_output,
36
+ progress,
37
+ table_output,
38
+ yaml_output,
39
+ )
40
+ from .exceptions import BadParameter, ConfigError, PluginError, SwiftCLIException, UsageError
41
+ from .plugins.base import Plugin
42
+
43
+ __all__ = [
44
+ # Core classes
45
+ 'CLI',
46
+ 'Group',
47
+ 'Context',
48
+ 'Plugin',
49
+
50
+ # Exceptions
51
+ 'SwiftCLIException',
52
+ 'UsageError',
53
+ 'BadParameter',
54
+ 'ConfigError',
55
+ 'PluginError',
56
+
57
+ # Command decorators
58
+ 'command',
59
+ 'group',
60
+ 'argument',
61
+ 'flag',
62
+ 'pass_context',
63
+
64
+ # Option decorators
65
+ 'option',
66
+ 'envvar',
67
+ 'config_file',
68
+ 'version_option',
69
+ 'help_option',
70
+
71
+ # Output decorators
72
+ 'table_output',
73
+ 'progress',
74
+ 'panel_output',
75
+ 'format_output',
76
+ 'pager_output',
77
+ 'json_output',
78
+ 'yaml_output'
79
+ ]