lionagi 0.5.5__py3-none-any.whl → 0.6.0__py3-none-any.whl

Sign up to get free protection for your applications and to get access to all the features.
Files changed (428) hide show
  1. lionagi/__init__.py +16 -24
  2. lionagi/{core/_class_registry.py → _class_registry.py} +51 -10
  3. lionagi/_errors.py +35 -0
  4. lionagi/libs/__init__.py +3 -0
  5. lionagi/libs/compress/__init__.py +3 -0
  6. lionagi/libs/compress/models.py +6 -2
  7. lionagi/libs/compress/utils.py +4 -16
  8. lionagi/libs/file/__init__.py +3 -0
  9. lionagi/libs/file/chunk.py +4 -0
  10. lionagi/libs/file/file_ops.py +4 -0
  11. lionagi/libs/file/params.py +4 -41
  12. lionagi/libs/file/process.py +4 -0
  13. lionagi/libs/file/save.py +5 -1
  14. lionagi/libs/{parse/flatten → nested}/flatten.py +4 -0
  15. lionagi/libs/{parse/nested → nested}/nfilter.py +4 -0
  16. lionagi/libs/{parse/nested → nested}/nget.py +6 -1
  17. lionagi/libs/{parse/nested → nested}/ninsert.py +5 -1
  18. lionagi/libs/{parse/nested → nested}/nmerge.py +4 -0
  19. lionagi/libs/{parse/nested → nested}/npop.py +5 -2
  20. lionagi/libs/{parse/nested → nested}/nset.py +6 -1
  21. lionagi/libs/{parse/flatten → nested}/unflatten.py +4 -0
  22. lionagi/libs/{parse/nested → nested}/utils.py +5 -1
  23. lionagi/libs/package/__init__.py +3 -0
  24. lionagi/libs/package/imports.py +6 -2
  25. lionagi/libs/package/management.py +7 -3
  26. lionagi/libs/package/params.py +4 -0
  27. lionagi/libs/package/system.py +4 -0
  28. lionagi/libs/parse.py +30 -0
  29. lionagi/libs/{parse/json → schema}/as_readable.py +10 -4
  30. lionagi/libs/{parse/string_parse/code_block.py → schema/extract_code_block.py} +4 -0
  31. lionagi/libs/{parse/string_parse/docstring.py → schema/extract_docstring.py} +4 -0
  32. lionagi/libs/{parse/string_parse/function_.py → schema/function_to_schema.py} +21 -9
  33. lionagi/libs/{parse/json/schema.py → schema/json_schema.py} +5 -1
  34. lionagi/libs/validate/common_field_validators.py +170 -0
  35. lionagi/libs/{parse/validate/keys.py → validate/fuzzy_match_keys.py} +42 -8
  36. lionagi/libs/{parse/validate/mapping.py → validate/fuzzy_validate_mapping.py} +41 -6
  37. lionagi/libs/{string_similarity/algorithms.py → validate/string_similarity.py} +115 -1
  38. lionagi/libs/{parse/validate/boolean.py → validate/validate_boolean.py} +42 -3
  39. lionagi/operations/__init__.py +13 -3
  40. lionagi/operations/brainstorm/__init__.py +3 -3
  41. lionagi/operations/brainstorm/brainstorm.py +33 -19
  42. lionagi/operations/brainstorm/prompt.py +4 -0
  43. lionagi/operations/plan/__init__.py +4 -0
  44. lionagi/operations/plan/plan.py +16 -13
  45. lionagi/operations/plan/prompt.py +4 -0
  46. lionagi/operations/select/__init__.py +4 -0
  47. lionagi/operations/select/prompt.py +4 -0
  48. lionagi/operations/select/select.py +1 -1
  49. lionagi/operations/select/utils.py +4 -4
  50. lionagi/{strategies → operations/strategies}/base.py +6 -2
  51. lionagi/{strategies → operations/strategies}/concurrent.py +8 -5
  52. lionagi/{strategies → operations/strategies}/concurrent_chunk.py +6 -3
  53. lionagi/{strategies → operations/strategies}/concurrent_sequential_chunk.py +8 -4
  54. lionagi/{strategies → operations/strategies}/params.py +10 -6
  55. lionagi/{strategies → operations/strategies}/sequential.py +6 -2
  56. lionagi/{strategies → operations/strategies}/sequential_chunk.py +7 -3
  57. lionagi/{strategies → operations/strategies}/sequential_concurrent_chunk.py +9 -4
  58. lionagi/{strategies → operations/strategies}/utils.py +6 -3
  59. lionagi/{core/models/__init__.py → operations/types.py} +3 -1
  60. lionagi/operations/utils.py +6 -3
  61. lionagi/operatives/action/function_calling.py +136 -0
  62. lionagi/operatives/action/manager.py +239 -0
  63. lionagi/operatives/action/request_response_model.py +90 -0
  64. lionagi/operatives/action/tool.py +141 -0
  65. lionagi/{protocols/operatives/action.py → operatives/action/utils.py} +52 -90
  66. lionagi/{core → operatives}/forms/base.py +9 -4
  67. lionagi/{core → operatives}/forms/form.py +8 -13
  68. lionagi/{core → operatives}/forms/report.py +5 -3
  69. lionagi/operatives/instruct/base.py +79 -0
  70. lionagi/operatives/instruct/instruct.py +105 -0
  71. lionagi/operatives/instruct/instruct_collection.py +52 -0
  72. lionagi/operatives/instruct/node.py +13 -0
  73. lionagi/{protocols/operatives → operatives/instruct}/prompts.py +0 -34
  74. lionagi/{protocols/operatives → operatives/instruct}/reason.py +14 -7
  75. lionagi/{integrations/anthropic_/version.py → operatives/manager.py} +5 -1
  76. lionagi/operatives/models/field_model.py +194 -0
  77. lionagi/operatives/models/model_params.py +307 -0
  78. lionagi/{core → operatives}/models/note.py +20 -28
  79. lionagi/{core → operatives}/models/operable_model.py +153 -71
  80. lionagi/{core → operatives}/models/schema_model.py +4 -3
  81. lionagi/{protocols/operatives → operatives}/operative.py +10 -7
  82. lionagi/{protocols/operatives → operatives}/step.py +67 -26
  83. lionagi/operatives/types.py +69 -0
  84. lionagi/protocols/_adapter.py +224 -0
  85. lionagi/protocols/_concepts.py +94 -0
  86. lionagi/protocols/generic/element.py +460 -0
  87. lionagi/protocols/generic/event.py +177 -0
  88. lionagi/protocols/generic/log.py +237 -0
  89. lionagi/{core → protocols}/generic/pile.py +172 -131
  90. lionagi/protocols/generic/processor.py +316 -0
  91. lionagi/protocols/generic/progression.py +500 -0
  92. lionagi/protocols/graph/edge.py +166 -0
  93. lionagi/protocols/graph/graph.py +290 -0
  94. lionagi/protocols/graph/node.py +109 -0
  95. lionagi/protocols/mail/exchange.py +116 -0
  96. lionagi/protocols/mail/mail.py +25 -0
  97. lionagi/protocols/mail/mailbox.py +47 -0
  98. lionagi/protocols/mail/manager.py +168 -0
  99. lionagi/protocols/mail/package.py +55 -0
  100. lionagi/protocols/messages/action_request.py +165 -0
  101. lionagi/protocols/messages/action_response.py +132 -0
  102. lionagi/{core/communication → protocols/messages}/assistant_response.py +55 -79
  103. lionagi/protocols/messages/base.py +73 -0
  104. lionagi/protocols/messages/instruction.py +582 -0
  105. lionagi/protocols/messages/manager.py +429 -0
  106. lionagi/protocols/messages/message.py +216 -0
  107. lionagi/protocols/messages/system.py +115 -0
  108. lionagi/protocols/messages/templates/assistant_response.jinja2 +6 -0
  109. lionagi/{core/communication → protocols/messages}/templates/instruction_message.jinja2 +2 -2
  110. lionagi/protocols/types.py +96 -0
  111. lionagi/service/__init__.py +10 -12
  112. lionagi/service/endpoints/base.py +517 -0
  113. lionagi/service/endpoints/chat_completion.py +102 -0
  114. lionagi/service/endpoints/match_endpoint.py +60 -0
  115. lionagi/service/endpoints/rate_limited_processor.py +145 -0
  116. lionagi/service/endpoints/token_calculator.py +209 -0
  117. lionagi/service/imodel.py +263 -96
  118. lionagi/service/manager.py +45 -0
  119. lionagi/service/providers/anthropic_/messages.py +64 -0
  120. lionagi/service/providers/groq_/chat_completions.py +56 -0
  121. lionagi/service/providers/openai_/chat_completions.py +62 -0
  122. lionagi/service/providers/openrouter_/chat_completions.py +62 -0
  123. lionagi/service/providers/perplexity_/__init__.py +3 -0
  124. lionagi/service/providers/perplexity_/chat_completions.py +40 -0
  125. lionagi/session/__init__.py +3 -0
  126. lionagi/session/branch.py +1287 -0
  127. lionagi/session/session.py +296 -0
  128. lionagi/settings.py +62 -118
  129. lionagi/utils.py +2386 -0
  130. lionagi/version.py +1 -1
  131. {lionagi-0.5.5.dist-info → lionagi-0.6.0.dist-info}/METADATA +7 -6
  132. lionagi-0.6.0.dist-info/RECORD +160 -0
  133. lionagi/core/action/action_manager.py +0 -289
  134. lionagi/core/action/base.py +0 -109
  135. lionagi/core/action/function_calling.py +0 -153
  136. lionagi/core/action/tool.py +0 -202
  137. lionagi/core/action/types.py +0 -16
  138. lionagi/core/communication/action_request.py +0 -163
  139. lionagi/core/communication/action_response.py +0 -149
  140. lionagi/core/communication/base_mail.py +0 -49
  141. lionagi/core/communication/instruction.py +0 -376
  142. lionagi/core/communication/message.py +0 -286
  143. lionagi/core/communication/message_manager.py +0 -543
  144. lionagi/core/communication/system.py +0 -116
  145. lionagi/core/communication/templates/assistant_response.jinja2 +0 -2
  146. lionagi/core/communication/types.py +0 -27
  147. lionagi/core/communication/utils.py +0 -256
  148. lionagi/core/forms/types.py +0 -13
  149. lionagi/core/generic/component.py +0 -422
  150. lionagi/core/generic/edge.py +0 -163
  151. lionagi/core/generic/element.py +0 -199
  152. lionagi/core/generic/graph.py +0 -377
  153. lionagi/core/generic/log.py +0 -151
  154. lionagi/core/generic/log_manager.py +0 -320
  155. lionagi/core/generic/node.py +0 -11
  156. lionagi/core/generic/progression.py +0 -395
  157. lionagi/core/generic/types.py +0 -23
  158. lionagi/core/generic/utils.py +0 -53
  159. lionagi/core/models/base.py +0 -28
  160. lionagi/core/models/field_model.py +0 -145
  161. lionagi/core/models/model_params.py +0 -194
  162. lionagi/core/models/types.py +0 -19
  163. lionagi/core/session/branch.py +0 -130
  164. lionagi/core/session/branch_mixins.py +0 -581
  165. lionagi/core/session/session.py +0 -163
  166. lionagi/core/session/types.py +0 -8
  167. lionagi/core/typing/__init__.py +0 -9
  168. lionagi/core/typing/_concepts.py +0 -173
  169. lionagi/core/typing/_id.py +0 -104
  170. lionagi/core/typing/_pydantic.py +0 -33
  171. lionagi/core/typing/_typing.py +0 -54
  172. lionagi/integrations/__init__.py +0 -0
  173. lionagi/integrations/_services.py +0 -17
  174. lionagi/integrations/anthropic_/AnthropicModel.py +0 -268
  175. lionagi/integrations/anthropic_/AnthropicService.py +0 -127
  176. lionagi/integrations/anthropic_/anthropic_max_output_token_data.yaml +0 -12
  177. lionagi/integrations/anthropic_/anthropic_price_data.yaml +0 -34
  178. lionagi/integrations/anthropic_/api_endpoints/api_request.py +0 -277
  179. lionagi/integrations/anthropic_/api_endpoints/data_models.py +0 -40
  180. lionagi/integrations/anthropic_/api_endpoints/match_response.py +0 -119
  181. lionagi/integrations/anthropic_/api_endpoints/messages/request/message_models.py +0 -14
  182. lionagi/integrations/anthropic_/api_endpoints/messages/request/request_body.py +0 -74
  183. lionagi/integrations/anthropic_/api_endpoints/messages/response/__init__.py +0 -0
  184. lionagi/integrations/anthropic_/api_endpoints/messages/response/content_models.py +0 -32
  185. lionagi/integrations/anthropic_/api_endpoints/messages/response/response_body.py +0 -101
  186. lionagi/integrations/anthropic_/api_endpoints/messages/response/usage_models.py +0 -25
  187. lionagi/integrations/groq_/GroqModel.py +0 -325
  188. lionagi/integrations/groq_/GroqService.py +0 -156
  189. lionagi/integrations/groq_/api_endpoints/__init__.py +0 -0
  190. lionagi/integrations/groq_/api_endpoints/data_models.py +0 -187
  191. lionagi/integrations/groq_/api_endpoints/groq_request.py +0 -288
  192. lionagi/integrations/groq_/api_endpoints/match_response.py +0 -106
  193. lionagi/integrations/groq_/api_endpoints/response_utils.py +0 -105
  194. lionagi/integrations/groq_/groq_max_output_token_data.yaml +0 -21
  195. lionagi/integrations/groq_/groq_price_data.yaml +0 -58
  196. lionagi/integrations/groq_/groq_rate_limits.yaml +0 -105
  197. lionagi/integrations/groq_/version.py +0 -5
  198. lionagi/integrations/litellm_/imodel.py +0 -76
  199. lionagi/integrations/ollama_/OllamaModel.py +0 -244
  200. lionagi/integrations/ollama_/OllamaService.py +0 -142
  201. lionagi/integrations/ollama_/api_endpoints/api_request.py +0 -179
  202. lionagi/integrations/ollama_/api_endpoints/chat_completion/message_models.py +0 -31
  203. lionagi/integrations/ollama_/api_endpoints/chat_completion/request_body.py +0 -46
  204. lionagi/integrations/ollama_/api_endpoints/chat_completion/response_body.py +0 -67
  205. lionagi/integrations/ollama_/api_endpoints/chat_completion/tool_models.py +0 -49
  206. lionagi/integrations/ollama_/api_endpoints/completion/__init__.py +0 -0
  207. lionagi/integrations/ollama_/api_endpoints/completion/request_body.py +0 -72
  208. lionagi/integrations/ollama_/api_endpoints/completion/response_body.py +0 -59
  209. lionagi/integrations/ollama_/api_endpoints/data_models.py +0 -15
  210. lionagi/integrations/ollama_/api_endpoints/embedding/__init__.py +0 -0
  211. lionagi/integrations/ollama_/api_endpoints/embedding/request_body.py +0 -33
  212. lionagi/integrations/ollama_/api_endpoints/embedding/response_body.py +0 -29
  213. lionagi/integrations/ollama_/api_endpoints/match_data_model.py +0 -62
  214. lionagi/integrations/ollama_/api_endpoints/match_response.py +0 -190
  215. lionagi/integrations/ollama_/api_endpoints/model/copy_model.py +0 -13
  216. lionagi/integrations/ollama_/api_endpoints/model/create_model.py +0 -28
  217. lionagi/integrations/ollama_/api_endpoints/model/delete_model.py +0 -11
  218. lionagi/integrations/ollama_/api_endpoints/model/list_model.py +0 -60
  219. lionagi/integrations/ollama_/api_endpoints/model/pull_model.py +0 -34
  220. lionagi/integrations/ollama_/api_endpoints/model/push_model.py +0 -35
  221. lionagi/integrations/ollama_/api_endpoints/model/show_model.py +0 -36
  222. lionagi/integrations/ollama_/api_endpoints/option_models.py +0 -68
  223. lionagi/integrations/openai_/OpenAIModel.py +0 -419
  224. lionagi/integrations/openai_/OpenAIService.py +0 -435
  225. lionagi/integrations/openai_/__init__.py +0 -0
  226. lionagi/integrations/openai_/api_endpoints/__init__.py +0 -3
  227. lionagi/integrations/openai_/api_endpoints/api_request.py +0 -277
  228. lionagi/integrations/openai_/api_endpoints/audio/__init__.py +0 -9
  229. lionagi/integrations/openai_/api_endpoints/audio/speech_models.py +0 -34
  230. lionagi/integrations/openai_/api_endpoints/audio/transcription_models.py +0 -136
  231. lionagi/integrations/openai_/api_endpoints/audio/translation_models.py +0 -41
  232. lionagi/integrations/openai_/api_endpoints/audio/types.py +0 -41
  233. lionagi/integrations/openai_/api_endpoints/batch/__init__.py +0 -17
  234. lionagi/integrations/openai_/api_endpoints/batch/batch_models.py +0 -146
  235. lionagi/integrations/openai_/api_endpoints/batch/cancel_batch.py +0 -7
  236. lionagi/integrations/openai_/api_endpoints/batch/create_batch.py +0 -26
  237. lionagi/integrations/openai_/api_endpoints/batch/list_batch.py +0 -37
  238. lionagi/integrations/openai_/api_endpoints/batch/request_object_models.py +0 -65
  239. lionagi/integrations/openai_/api_endpoints/batch/retrieve_batch.py +0 -7
  240. lionagi/integrations/openai_/api_endpoints/batch/types.py +0 -4
  241. lionagi/integrations/openai_/api_endpoints/chat_completions/__init__.py +0 -1
  242. lionagi/integrations/openai_/api_endpoints/chat_completions/request/__init__.py +0 -39
  243. lionagi/integrations/openai_/api_endpoints/chat_completions/request/message_models.py +0 -121
  244. lionagi/integrations/openai_/api_endpoints/chat_completions/request/request_body.py +0 -221
  245. lionagi/integrations/openai_/api_endpoints/chat_completions/request/response_format.py +0 -71
  246. lionagi/integrations/openai_/api_endpoints/chat_completions/request/stream_options.py +0 -14
  247. lionagi/integrations/openai_/api_endpoints/chat_completions/request/tool_choice_models.py +0 -17
  248. lionagi/integrations/openai_/api_endpoints/chat_completions/request/tool_models.py +0 -54
  249. lionagi/integrations/openai_/api_endpoints/chat_completions/request/types.py +0 -18
  250. lionagi/integrations/openai_/api_endpoints/chat_completions/response/__init__.py +0 -0
  251. lionagi/integrations/openai_/api_endpoints/chat_completions/response/choice_models.py +0 -62
  252. lionagi/integrations/openai_/api_endpoints/chat_completions/response/function_models.py +0 -16
  253. lionagi/integrations/openai_/api_endpoints/chat_completions/response/log_prob_models.py +0 -47
  254. lionagi/integrations/openai_/api_endpoints/chat_completions/response/message_models.py +0 -25
  255. lionagi/integrations/openai_/api_endpoints/chat_completions/response/response_body.py +0 -99
  256. lionagi/integrations/openai_/api_endpoints/chat_completions/response/types.py +0 -8
  257. lionagi/integrations/openai_/api_endpoints/chat_completions/response/usage_models.py +0 -24
  258. lionagi/integrations/openai_/api_endpoints/chat_completions/util.py +0 -46
  259. lionagi/integrations/openai_/api_endpoints/data_models.py +0 -23
  260. lionagi/integrations/openai_/api_endpoints/embeddings/__init__.py +0 -3
  261. lionagi/integrations/openai_/api_endpoints/embeddings/request_body.py +0 -79
  262. lionagi/integrations/openai_/api_endpoints/embeddings/response_body.py +0 -67
  263. lionagi/integrations/openai_/api_endpoints/files/__init__.py +0 -11
  264. lionagi/integrations/openai_/api_endpoints/files/delete_file.py +0 -20
  265. lionagi/integrations/openai_/api_endpoints/files/file_models.py +0 -56
  266. lionagi/integrations/openai_/api_endpoints/files/list_files.py +0 -27
  267. lionagi/integrations/openai_/api_endpoints/files/retrieve_file.py +0 -9
  268. lionagi/integrations/openai_/api_endpoints/files/upload_file.py +0 -38
  269. lionagi/integrations/openai_/api_endpoints/fine_tuning/__init__.py +0 -37
  270. lionagi/integrations/openai_/api_endpoints/fine_tuning/cancel_jobs.py +0 -9
  271. lionagi/integrations/openai_/api_endpoints/fine_tuning/create_jobs.py +0 -133
  272. lionagi/integrations/openai_/api_endpoints/fine_tuning/fine_tuning_job_checkpoint_models.py +0 -58
  273. lionagi/integrations/openai_/api_endpoints/fine_tuning/fine_tuning_job_event_models.py +0 -31
  274. lionagi/integrations/openai_/api_endpoints/fine_tuning/fine_tuning_job_models.py +0 -140
  275. lionagi/integrations/openai_/api_endpoints/fine_tuning/list_fine_tuning_checkpoints.py +0 -51
  276. lionagi/integrations/openai_/api_endpoints/fine_tuning/list_fine_tuning_events.py +0 -42
  277. lionagi/integrations/openai_/api_endpoints/fine_tuning/list_fine_tuning_jobs.py +0 -31
  278. lionagi/integrations/openai_/api_endpoints/fine_tuning/retrieve_jobs.py +0 -9
  279. lionagi/integrations/openai_/api_endpoints/fine_tuning/training_format.py +0 -30
  280. lionagi/integrations/openai_/api_endpoints/images/__init__.py +0 -9
  281. lionagi/integrations/openai_/api_endpoints/images/image_edit_models.py +0 -69
  282. lionagi/integrations/openai_/api_endpoints/images/image_models.py +0 -56
  283. lionagi/integrations/openai_/api_endpoints/images/image_variation_models.py +0 -56
  284. lionagi/integrations/openai_/api_endpoints/images/response_body.py +0 -30
  285. lionagi/integrations/openai_/api_endpoints/match_data_model.py +0 -197
  286. lionagi/integrations/openai_/api_endpoints/match_response.py +0 -336
  287. lionagi/integrations/openai_/api_endpoints/models/__init__.py +0 -7
  288. lionagi/integrations/openai_/api_endpoints/models/delete_fine_tuned_model.py +0 -17
  289. lionagi/integrations/openai_/api_endpoints/models/models_models.py +0 -31
  290. lionagi/integrations/openai_/api_endpoints/models/retrieve_model.py +0 -9
  291. lionagi/integrations/openai_/api_endpoints/moderations/__init__.py +0 -3
  292. lionagi/integrations/openai_/api_endpoints/moderations/request_body.py +0 -20
  293. lionagi/integrations/openai_/api_endpoints/moderations/response_body.py +0 -139
  294. lionagi/integrations/openai_/api_endpoints/uploads/__init__.py +0 -19
  295. lionagi/integrations/openai_/api_endpoints/uploads/add_upload_part.py +0 -11
  296. lionagi/integrations/openai_/api_endpoints/uploads/cancel_upload.py +0 -7
  297. lionagi/integrations/openai_/api_endpoints/uploads/complete_upload.py +0 -18
  298. lionagi/integrations/openai_/api_endpoints/uploads/create_upload.py +0 -17
  299. lionagi/integrations/openai_/api_endpoints/uploads/uploads_models.py +0 -52
  300. lionagi/integrations/openai_/image_token_calculator/__init__.py +0 -0
  301. lionagi/integrations/openai_/image_token_calculator/image_token_calculator.py +0 -98
  302. lionagi/integrations/openai_/image_token_calculator/openai_image_token_data.yaml +0 -15
  303. lionagi/integrations/openai_/openai_max_output_token_data.yaml +0 -12
  304. lionagi/integrations/openai_/openai_price_data.yaml +0 -26
  305. lionagi/integrations/openai_/version.py +0 -1
  306. lionagi/integrations/pandas_/__init__.py +0 -24
  307. lionagi/integrations/pandas_/extend_df.py +0 -61
  308. lionagi/integrations/pandas_/read.py +0 -103
  309. lionagi/integrations/pandas_/remove_rows.py +0 -61
  310. lionagi/integrations/pandas_/replace_keywords.py +0 -65
  311. lionagi/integrations/pandas_/save.py +0 -131
  312. lionagi/integrations/pandas_/search_keywords.py +0 -69
  313. lionagi/integrations/pandas_/to_df.py +0 -196
  314. lionagi/integrations/pandas_/update_cells.py +0 -54
  315. lionagi/integrations/perplexity_/PerplexityModel.py +0 -274
  316. lionagi/integrations/perplexity_/PerplexityService.py +0 -118
  317. lionagi/integrations/perplexity_/api_endpoints/__init__.py +0 -0
  318. lionagi/integrations/perplexity_/api_endpoints/api_request.py +0 -171
  319. lionagi/integrations/perplexity_/api_endpoints/chat_completions/__init__.py +0 -0
  320. lionagi/integrations/perplexity_/api_endpoints/chat_completions/request/__init__.py +0 -0
  321. lionagi/integrations/perplexity_/api_endpoints/chat_completions/request/request_body.py +0 -121
  322. lionagi/integrations/perplexity_/api_endpoints/chat_completions/response/__init__.py +0 -0
  323. lionagi/integrations/perplexity_/api_endpoints/chat_completions/response/response_body.py +0 -146
  324. lionagi/integrations/perplexity_/api_endpoints/data_models.py +0 -63
  325. lionagi/integrations/perplexity_/api_endpoints/match_response.py +0 -26
  326. lionagi/integrations/perplexity_/perplexity_max_output_token_data.yaml +0 -3
  327. lionagi/integrations/perplexity_/perplexity_price_data.yaml +0 -10
  328. lionagi/integrations/perplexity_/version.py +0 -1
  329. lionagi/integrations/pydantic_/__init__.py +0 -8
  330. lionagi/integrations/pydantic_/break_down_annotation.py +0 -81
  331. lionagi/integrations/pydantic_/new_model.py +0 -208
  332. lionagi/libs/constants.py +0 -98
  333. lionagi/libs/file/path.py +0 -301
  334. lionagi/libs/file/types.py +0 -22
  335. lionagi/libs/func/__init__.py +0 -0
  336. lionagi/libs/func/async_calls/__init__.py +0 -24
  337. lionagi/libs/func/async_calls/alcall.py +0 -210
  338. lionagi/libs/func/async_calls/bcall.py +0 -130
  339. lionagi/libs/func/async_calls/mcall.py +0 -134
  340. lionagi/libs/func/async_calls/pcall.py +0 -149
  341. lionagi/libs/func/async_calls/rcall.py +0 -217
  342. lionagi/libs/func/async_calls/tcall.py +0 -114
  343. lionagi/libs/func/async_calls/ucall.py +0 -85
  344. lionagi/libs/func/decorators.py +0 -277
  345. lionagi/libs/func/lcall.py +0 -57
  346. lionagi/libs/func/params.py +0 -64
  347. lionagi/libs/func/throttle.py +0 -119
  348. lionagi/libs/func/types.py +0 -39
  349. lionagi/libs/func/utils.py +0 -96
  350. lionagi/libs/package/types.py +0 -26
  351. lionagi/libs/parse/__init__.py +0 -1
  352. lionagi/libs/parse/flatten/__init__.py +0 -9
  353. lionagi/libs/parse/flatten/params.py +0 -52
  354. lionagi/libs/parse/json/__init__.py +0 -27
  355. lionagi/libs/parse/json/extract.py +0 -102
  356. lionagi/libs/parse/json/parse.py +0 -179
  357. lionagi/libs/parse/json/to_json.py +0 -71
  358. lionagi/libs/parse/nested/__init__.py +0 -33
  359. lionagi/libs/parse/nested/to_flat_list.py +0 -64
  360. lionagi/libs/parse/params.py +0 -0
  361. lionagi/libs/parse/string_parse/__init__.py +0 -11
  362. lionagi/libs/parse/type_convert/__init__.py +0 -19
  363. lionagi/libs/parse/type_convert/params.py +0 -145
  364. lionagi/libs/parse/type_convert/to_dict.py +0 -333
  365. lionagi/libs/parse/type_convert/to_list.py +0 -186
  366. lionagi/libs/parse/type_convert/to_num.py +0 -358
  367. lionagi/libs/parse/type_convert/to_str.py +0 -195
  368. lionagi/libs/parse/types.py +0 -9
  369. lionagi/libs/parse/validate/__init__.py +0 -14
  370. lionagi/libs/parse/validate/params.py +0 -62
  371. lionagi/libs/parse/xml/__init__.py +0 -10
  372. lionagi/libs/parse/xml/convert.py +0 -56
  373. lionagi/libs/parse/xml/parser.py +0 -93
  374. lionagi/libs/string_similarity/__init__.py +0 -32
  375. lionagi/libs/string_similarity/matcher.py +0 -102
  376. lionagi/libs/string_similarity/utils.py +0 -15
  377. lionagi/libs/utils.py +0 -266
  378. lionagi/protocols/adapters/__init__.py +0 -0
  379. lionagi/protocols/adapters/adapter.py +0 -79
  380. lionagi/protocols/adapters/json_adapter.py +0 -43
  381. lionagi/protocols/adapters/pandas_adapter.py +0 -96
  382. lionagi/protocols/configs/__init__.py +0 -0
  383. lionagi/protocols/configs/branch_config.py +0 -86
  384. lionagi/protocols/configs/id_config.py +0 -15
  385. lionagi/protocols/configs/imodel_config.py +0 -73
  386. lionagi/protocols/configs/log_config.py +0 -93
  387. lionagi/protocols/configs/retry_config.py +0 -29
  388. lionagi/protocols/configs/types.py +0 -15
  389. lionagi/protocols/operatives/instruct.py +0 -194
  390. lionagi/protocols/operatives/types.py +0 -19
  391. lionagi/protocols/registries/_component_registry.py +0 -23
  392. lionagi/protocols/registries/_pile_registry.py +0 -30
  393. lionagi/service/complete_request_info.py +0 -11
  394. lionagi/service/rate_limiter.py +0 -108
  395. lionagi/service/service.py +0 -41
  396. lionagi/service/service_match_util.py +0 -131
  397. lionagi/service/service_util.py +0 -72
  398. lionagi/service/token_calculator.py +0 -51
  399. lionagi/strategies/__init__.py +0 -0
  400. lionagi/strategies/types.py +0 -21
  401. lionagi-0.5.5.dist-info/RECORD +0 -374
  402. /lionagi/{core → libs/nested}/__init__.py +0 -0
  403. /lionagi/{core/action → libs/schema}/__init__.py +0 -0
  404. /lionagi/{core/communication → libs/validate}/__init__.py +0 -0
  405. /lionagi/{core/forms → operations/strategies}/__init__.py +0 -0
  406. /lionagi/{core/generic → operatives}/__init__.py +0 -0
  407. /lionagi/{core/session → operatives/action}/__init__.py +0 -0
  408. /lionagi/{integrations/anthropic_ → operatives/forms}/__init__.py +0 -0
  409. /lionagi/{core → operatives}/forms/utils.py +0 -0
  410. /lionagi/{integrations/anthropic_/api_endpoints → operatives/instruct}/__init__.py +0 -0
  411. /lionagi/{integrations/anthropic_/api_endpoints/messages → operatives/models}/__init__.py +0 -0
  412. /lionagi/{integrations/anthropic_/api_endpoints/messages/request → protocols/generic}/__init__.py +0 -0
  413. /lionagi/{integrations/groq_ → protocols/graph}/__init__.py +0 -0
  414. /lionagi/{integrations/litellm_ → protocols/mail}/__init__.py +0 -0
  415. /lionagi/{integrations/ollama_ → protocols/messages}/__init__.py +0 -0
  416. /lionagi/{core/communication → protocols/messages}/templates/README.md +0 -0
  417. /lionagi/{core/communication → protocols/messages}/templates/action_request.jinja2 +0 -0
  418. /lionagi/{core/communication → protocols/messages}/templates/action_response.jinja2 +0 -0
  419. /lionagi/{core/communication → protocols/messages}/templates/system_message.jinja2 +0 -0
  420. /lionagi/{core/communication → protocols/messages}/templates/tool_schemas.jinja2 +0 -0
  421. /lionagi/{integrations/ollama_/api_endpoints → service/endpoints}/__init__.py +0 -0
  422. /lionagi/{integrations/ollama_/api_endpoints/chat_completion → service/providers}/__init__.py +0 -0
  423. /lionagi/{integrations/ollama_/api_endpoints/model → service/providers/anthropic_}/__init__.py +0 -0
  424. /lionagi/{integrations/perplexity_ → service/providers/groq_}/__init__.py +0 -0
  425. /lionagi/{protocols/operatives → service/providers/openai_}/__init__.py +0 -0
  426. /lionagi/{protocols/registries → service/providers/openrouter_}/__init__.py +0 -0
  427. {lionagi-0.5.5.dist-info → lionagi-0.6.0.dist-info}/WHEEL +0 -0
  428. {lionagi-0.5.5.dist-info → lionagi-0.6.0.dist-info}/licenses/LICENSE +0 -0
@@ -1,52 +0,0 @@
1
- from typing import Optional
2
-
3
- from pydantic import Field
4
-
5
- from ..data_models import OpenAIEndpointResponseBody
6
- from ..files.file_models import OpenAIFileResponseBody, Purpose
7
-
8
-
9
- class OpenAIUploadResponseBody(OpenAIEndpointResponseBody):
10
- id: str = Field(description="The Upload unique identifier.")
11
-
12
- created_at: int = Field(
13
- description="The Unix timestamp (in seconds) for when the Upload was created.",
14
- )
15
-
16
- filename: str = Field(description="The name of the file to be uploaded.")
17
-
18
- bytes: int = Field(
19
- description="The intended number of bytes to be uploaded."
20
- )
21
-
22
- purpose: Purpose = Field(description="The intended purpose of the file.")
23
-
24
- status: str = Field(description="The status of the Upload.")
25
-
26
- expires_at: int = Field(
27
- description="The Unix timestamp (in seconds) for when the Upload expires."
28
- )
29
-
30
- object: str = Field(
31
- description="The object type, which is always 'upload'."
32
- )
33
-
34
- file: OpenAIFileResponseBody | None = Field(
35
- None, description="The File object created after completion."
36
- )
37
-
38
-
39
- class OpenAIUploadPartResponseBody(OpenAIUploadResponseBody):
40
- id: str = Field(description="The upload Part unique identifier.")
41
-
42
- created_at: int = Field(
43
- description="The Unix timestamp (in seconds) for when the Part was created.",
44
- )
45
-
46
- upload_id: str = Field(
47
- description="The ID of the Upload object that this Part was added to."
48
- )
49
-
50
- object: str = Field(
51
- description="The object type, which is always 'upload.part'."
52
- )
@@ -1,98 +0,0 @@
1
- import base64
2
- import math
3
- import os
4
- from io import BytesIO
5
- from typing import Literal
6
-
7
- from pydantic import BaseModel, Field, field_validator
8
-
9
- image_token_config_file_name = os.path.join(
10
- os.path.dirname(__file__), "openai_image_token_data.yaml"
11
- )
12
-
13
-
14
- class _ModuelImportClass:
15
-
16
- from lionagi.libs.package.imports import check_import
17
-
18
- yaml = check_import("yaml", pip_name="pyyaml")
19
- Image = check_import("PIL.Image", pip_name="Pillow")
20
- aiohttp = check_import("aiohttp")
21
-
22
-
23
- class OpenAIImageTokenCalculator(BaseModel):
24
- model: str = Field(description="ID of the model to use.")
25
-
26
- @field_validator("model")
27
- @classmethod
28
- def validate_model_image_function(cls, value: str):
29
- with open(image_token_config_file_name) as file:
30
- token_config = _ModuelImportClass.yaml.safe_load(file)
31
-
32
- token_config = token_config.get(value, None)
33
-
34
- if token_config is None:
35
- raise ValueError("The model does not have vision capabilities.")
36
- return value
37
-
38
- @staticmethod
39
- async def get_image_size(url: str):
40
- if url.startswith("data:image/jpeg;base64,"):
41
- # base64 encoded format
42
- image_base64 = url.split("data:image/jpeg;base64,")[1]
43
- image_base64.strip("{}")
44
- image_data = base64.b64decode(image_base64)
45
- image = _ModuelImportClass.Image.open(BytesIO(image_data))
46
- else:
47
- # image url
48
- async with _ModuelImportClass.aiohttp.ClientSession() as client:
49
- async with client.get(url=url) as response:
50
- response.raise_for_status()
51
-
52
- content = await response.read()
53
-
54
- image = _ModuelImportClass.Image.open(BytesIO(content))
55
-
56
- return image.size
57
-
58
- async def calculate(
59
- self, url: str, detail: Literal["low", "high", "auto"] = "auto"
60
- ):
61
- if detail not in ["low", "high", "auto"]:
62
- raise ValueError(
63
- "Invalid detail option. Valid options are: low, high, auto"
64
- )
65
-
66
- with open(image_token_config_file_name) as file:
67
- token_config = _ModuelImportClass.yaml.safe_load(file)
68
-
69
- token_config = token_config.get(self.model, None)
70
-
71
- if token_config is None:
72
- raise ValueError("The model does not have vision capabilities.")
73
-
74
- width, height = await self.get_image_size(url)
75
-
76
- if detail == "low":
77
- return token_config["base"]
78
- if detail == "auto":
79
- # TODO: check "auto" option condition
80
- if width <= 512 and height <= 512:
81
- return token_config["base"]
82
-
83
- # Scale to fit within a 2048 x 2048 square
84
- if max(width, height) > 2048:
85
- scale_factor = 2048 / max(width, height)
86
- width = int(width * scale_factor)
87
- height = int(height * scale_factor)
88
-
89
- # Scale such that the shortest side is 768px
90
- if min(width, height) > 768:
91
- scale_factor = 768 / min(width, height)
92
- width = int(width * scale_factor)
93
- height = int(height * scale_factor)
94
-
95
- # Calculate the number of 512px squares
96
- num_squares = math.ceil(width / 512) * math.ceil(height / 512)
97
-
98
- return num_squares * token_config["tile"] + token_config["base"]
@@ -1,15 +0,0 @@
1
- gpt-4o:
2
- base: 85
3
- tile: 170
4
- gpt-4o-2024-05-13:
5
- base: 85
6
- tile: 170
7
- gpt-4o-2024-08-06:
8
- base: 85
9
- tile: 170
10
- gpt-4o-mini:
11
- base: 2833
12
- tile: 5667
13
- gpt-4o-mini-2024-07-18:
14
- base: 2833
15
- tile: 5667
@@ -1,12 +0,0 @@
1
- gpt-4o: 4096
2
- gpt-4o-2024-05-13: 4096
3
- gpt-4o-2024-08-06: 16384
4
- gpt-4o-mini: 16384
5
- gpt-4o-mini-2024-07-18: 16384
6
- gpt-4-turbo: 4096
7
- gpt-4-turbo-2024-04-09: 4096
8
- gpt-4-turbo-preview: 4096
9
- gpt-4-0125-preview: 4096
10
- gpt-4-1106-preview: 4096
11
- gpt-4: 8192
12
- gpt-4-0613: 8192
@@ -1,26 +0,0 @@
1
- model:
2
- gpt-4o:
3
- input_tokens: 0.000005
4
- output_tokens: 0.000015
5
- input_tokens_with_batch: 0.0000025
6
- output_tokens_with_batch: 0.0000075
7
- gpt-4o-2024-08-06:
8
- input_tokens: 0.0000025
9
- output_tokens: 0.00001
10
- input_tokens_with_batch: 0.00000125
11
- output_tokens_with_batch: 0.000005
12
- gpt-4o-2024-05-13:
13
- input_tokens: 0.000005
14
- output_tokens: 0.000015
15
- input_tokens_with_batch: 0.0000025
16
- output_tokens_with_batch: 0.0000075
17
- gpt-4o-mini:
18
- input_tokens: 0.00000015
19
- output_tokens: 0.0000006
20
- input_tokens_with_batch: 0.000000075
21
- output_tokens_with_batch: 0.0000003
22
- gpt-4o-mini-2024-07-18:
23
- input_tokens: 0.00000015
24
- output_tokens: 0.0000006
25
- input_tokens_with_batch: 0.000000075
26
- output_tokens_with_batch: 0.0000003
@@ -1 +0,0 @@
1
- __version__ = "1.0.3"
@@ -1,24 +0,0 @@
1
- # Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
2
- #
3
- # SPDX-License-Identifier: Apache-2.0
4
- from .extend_df import extend_dataframe
5
- from .read import read_csv, read_json
6
- from .remove_rows import remove_rows
7
- from .replace_keywords import replace_keywords
8
- from .save import to_csv, to_excel
9
- from .search_keywords import search_dataframe_keywords
10
- from .to_df import to_df
11
- from .update_cells import update_cells
12
-
13
- __all__ = [
14
- "to_df",
15
- "replace_keywords",
16
- "search_dataframe_keywords",
17
- "read_csv",
18
- "read_json",
19
- "to_csv",
20
- "to_excel",
21
- "extend_dataframe",
22
- "remove_rows",
23
- "update_cells",
24
- ]
@@ -1,61 +0,0 @@
1
- # Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
2
- #
3
- # SPDX-License-Identifier: Apache-2.0
4
- from typing import Any, Literal
5
-
6
- import pandas as pd
7
-
8
- from lionagi.integrations.pandas_.to_df import to_df
9
-
10
-
11
- def extend_dataframe(
12
- dataframes: list[pd.DataFrame],
13
- unique_col: str = "node_id",
14
- keep: Literal["first", "last", False] = "first",
15
- ignore_index: bool = False,
16
- sort: bool = False,
17
- **kwargs: Any,
18
- ) -> pd.DataFrame:
19
- """
20
- Merges multiple DataFrames while ensuring no duplicate entries based on a specified unique column.
21
-
22
- Args:
23
- dataframes: List of DataFrames to merge, with the first being the primary DataFrame.
24
- unique_col: The column name to check for duplicate entries. Defaults to 'node_id'.
25
- keep: Determines which duplicates to keep. 'first' keeps the first occurrence,
26
- 'last' keeps the last occurrence, and False drops all duplicates.
27
- ignore_index: If True, the resulting axis will be labeled 0, 1, …, n - 1.
28
- sort: If True, sort the join keys lexicographically in the result DataFrame.
29
- **kwargs: Additional keyword arguments for `drop_duplicates`.
30
-
31
- Returns:
32
- A DataFrame combined from all input DataFrames with duplicates removed based on the unique column.
33
-
34
- Raises:
35
- ValueError: If all DataFrames are empty or if there's an error in extending.
36
-
37
- Example:
38
- >>> df1 = pd.DataFrame({'node_id': [1, 2], 'value': ['a', 'b']})
39
- >>> df2 = pd.DataFrame({'node_id': [2, 3], 'value': ['c', 'd']})
40
- >>> extend_dataframe([df1, df2], keep='last', ignore_index=True)
41
- node_id value
42
- 0 1 a
43
- 1 2 c
44
- 2 3 d
45
- """
46
- try:
47
- if all(df.empty for df in dataframes):
48
- raise ValueError("All input DataFrames are empty.")
49
-
50
- combined = pd.concat(dataframes, ignore_index=ignore_index, sort=sort)
51
- result = combined.drop_duplicates(
52
- subset=[unique_col], keep=keep, **kwargs
53
- )
54
-
55
- if result.empty:
56
- raise ValueError("No data left after removing duplicates.")
57
-
58
- return to_df(result)
59
-
60
- except Exception as e:
61
- raise ValueError(f"Error in extending DataFrames: {e}") from e
@@ -1,103 +0,0 @@
1
- # Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
2
- #
3
- # SPDX-License-Identifier: Apache-2.0
4
- from typing import Any, Literal
5
-
6
- import pandas as pd
7
-
8
- from .to_df import to_df
9
-
10
-
11
- def read_csv(
12
- filepath: str,
13
- chunk_size: int | None = None,
14
- low_memory: bool = False,
15
- return_as: Literal["dataframe", "json", "jsonl", "dict"] = "dataframe",
16
- **kwargs: Any,
17
- ) -> pd.DataFrame | str | list | dict:
18
- """
19
- Reads a CSV file into a DataFrame with optional chunking for large files.
20
-
21
- Args:
22
- filepath: The path to the CSV file to read.
23
- chunk_size: Number of rows to read at a time. If specified, returns an iterable.
24
- low_memory: Internally process the file in chunks to conserve memory (slower).
25
- **kwargs: Additional keyword arguments to pass to pandas.read_csv function.
26
-
27
- Returns:
28
- A DataFrame containing the data read from the CSV file, or a TextFileReader
29
- if chunk_size is specified.
30
-
31
- Example:
32
- >>> df = read_csv('large_file.csv', chunk_size=10000)
33
- >>> for chunk in df:
34
- ... process_chunk(chunk)
35
- """
36
- try:
37
- if chunk_size:
38
- return pd.read_csv(
39
- filepath, chunksize=chunk_size, low_memory=low_memory, **kwargs
40
- )
41
- df = pd.read_csv(filepath, low_memory=low_memory, **kwargs)
42
- df = to_df(df)
43
- if return_as == "dataframe":
44
- return df
45
- if return_as == "json":
46
- return df.to_json(orient="records")
47
- if return_as == "jsonl":
48
- return df.to_json(orient="records", lines=True)
49
- if return_as == "dict":
50
- return df.to_dict(orient="records")
51
-
52
- except Exception as e:
53
- raise OSError(f"Error reading CSV file: {e}") from e
54
-
55
-
56
- def read_json(
57
- filepath: str,
58
- orient: str | None = None,
59
- lines: bool = False,
60
- chunk_size: int | None = None,
61
- return_as: Literal["dataframe", "json", "jsonl", "dict"] = "dataframe",
62
- **kwargs: Any,
63
- ) -> pd.DataFrame | pd.io.json._json.JsonReader:
64
- """
65
- Reads a JSON file into a DataFrame with options for different JSON formats.
66
-
67
- Args:
68
- filepath: The path to the JSON file to read.
69
- orient: Indication of expected JSON string format.
70
- Allowed values are: 'split', 'records', 'index', 'columns', 'values', 'table'.
71
- lines: Read the file as a json object per line.
72
- chunk_size: Number of lines to read at a time. If specified, returns an iterable.
73
- **kwargs: Additional keyword arguments to pass to pandas.read_json function.
74
-
75
- Returns:
76
- A DataFrame containing the data read from the JSON file, or a JsonReader
77
- if chunk_size is specified.
78
-
79
- Example:
80
- >>> df = read_json('data.json', orient='records', lines=True)
81
- """
82
- try:
83
- if chunk_size:
84
- return pd.read_json(
85
- filepath,
86
- orient=orient,
87
- lines=lines,
88
- chunksize=chunk_size,
89
- **kwargs,
90
- )
91
- df = pd.read_json(filepath, orient=orient, lines=lines, **kwargs)
92
- df = to_df(df)
93
- if return_as == "dataframe":
94
- return df
95
- if return_as == "json":
96
- return df.to_json(orient="records")
97
- if return_as == "jsonl":
98
- return df.to_json(orient="records", lines=True)
99
- if return_as == "dict":
100
- return df.to_dict(orient="records")
101
-
102
- except Exception as e:
103
- raise OSError(f"Error reading JSON file: {e}") from e
@@ -1,61 +0,0 @@
1
- # Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
2
- #
3
- # SPDX-License-Identifier: Apache-2.0
4
- import pandas as pd
5
-
6
- from .to_df import to_df
7
-
8
-
9
- def remove_rows(
10
- df: pd.DataFrame,
11
- rows: int | slice | list[int],
12
- from_end: bool = False,
13
- reset_index: bool = False,
14
- ) -> pd.DataFrame:
15
- """
16
- Removes specified rows from a DataFrame.
17
-
18
- Args:
19
- df: The DataFrame from which to remove rows.
20
- rows: The row(s) to remove. Can be an integer, slice, or list of integers.
21
- from_end: If True, count rows from the end of the DataFrame.
22
- reset_index: If True, reset the index after removing rows.
23
-
24
- Returns:
25
- A DataFrame with the specified rows removed.
26
-
27
- Raises:
28
- ValueError: If the specified rows are invalid.
29
-
30
- Example:
31
- >>> df = pd.DataFrame({'A': range(10)})
32
- >>> remove_rows(df, [0, 2, 4], reset_index=True)
33
- A
34
- 0 1
35
- 1 3
36
- 2 5
37
- 3 6
38
- 4 7
39
- 5 8
40
- 6 9
41
- """
42
- if df.empty:
43
- return df.copy()
44
-
45
- if isinstance(rows, int):
46
- rows = [rows]
47
- elif isinstance(rows, slice):
48
- rows = list(range(*rows.indices(len(df))))
49
-
50
- if from_end:
51
- rows = [len(df) - 1 - r for r in rows]
52
-
53
- try:
54
- result = df.drop(df.index[rows])
55
- except IndexError as e:
56
- raise ValueError(f"Invalid row selection: {e}") from e
57
-
58
- if reset_index:
59
- result = result.reset_index(drop=True)
60
-
61
- return to_df(result)
@@ -1,65 +0,0 @@
1
- # Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
2
- #
3
- # SPDX-License-Identifier: Apache-2.0
4
- import pandas as pd
5
-
6
- from .to_df import to_df
7
-
8
-
9
- def replace_keywords(
10
- df: pd.DataFrame,
11
- keyword: str | dict[str, str],
12
- replacement: str | None = None,
13
- *,
14
- column: str | list[str] = "content",
15
- case_sensitive: bool = False,
16
- regex: bool = False,
17
- inplace: bool = False,
18
- ) -> pd.DataFrame | None:
19
- """
20
- Replaces occurrences of specified keyword(s) with replacement string(s) in DataFrame column(s).
21
-
22
- Args:
23
- df: The DataFrame to modify.
24
- keyword: The keyword to be replaced. Can be a string or a dictionary of {old: new} pairs.
25
- replacement: The string to replace the keyword with. Ignored if keyword is a dict.
26
- column: The column(s) in which to perform the replacement. Can be a string or list of strings.
27
- case_sensitive: If True, performs a case-sensitive replacement.
28
- regex: If True, treat keyword(s) as regular expressions.
29
- inplace: If True, modifies the DataFrame in place and returns None.
30
-
31
- Returns:
32
- Modified DataFrame if inplace is False, None otherwise.
33
-
34
- Example:
35
- >>> df = pd.DataFrame({'content': ['apple pie', 'banana split', 'cherry pie']})
36
- >>> replace_keyword(df, {'pie': 'tart', 'split': 'smoothie'}, column='content')
37
- content
38
- 0 apple tart
39
- 1 banana smoothie
40
- 2 cherry tart
41
- """
42
- df_ = df if inplace else df.copy()
43
-
44
- if isinstance(column, str):
45
- column = [column]
46
-
47
- if isinstance(keyword, dict):
48
- for col in column:
49
- df_[col] = df_[col].replace(
50
- to_replace=keyword,
51
- regex=regex,
52
- case=case_sensitive,
53
- )
54
- else:
55
- for col in column:
56
- df_[col] = df_[col].replace(
57
- to_replace=keyword,
58
- value=replacement,
59
- regex=regex,
60
- case=case_sensitive,
61
- )
62
-
63
- if inplace:
64
- return None
65
- return to_df(df_)
@@ -1,131 +0,0 @@
1
- # Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
2
- #
3
- # SPDX-License-Identifier: Apache-2.0
4
- from pathlib import Path
5
- from typing import Any
6
-
7
- from lionagi.integrations.pandas_.to_df import to_df
8
- from lionagi.libs.file.types import create_path
9
-
10
-
11
- def to_csv(
12
- input_: Any,
13
- /,
14
- *,
15
- directory: str | Path,
16
- filename: str,
17
- timestamp: bool = False,
18
- random_hash_digits: int = 0,
19
- drop_how: str = "all",
20
- drop_kwargs: dict[str, Any] | None = None,
21
- reset_index: bool = True,
22
- concat_kwargs: dict[str, Any] | None = None,
23
- df_kwargs: dict[str, Any] | None = None,
24
- path_kwargs: dict[str, Any] | None = None,
25
- verbose: bool = False,
26
- ) -> None:
27
- """
28
- Convert input to a DataFrame and save it as a CSV file.
29
-
30
- Args:
31
- input_: The input data to convert to a DataFrame.
32
- directory: The directory to save the CSV file.
33
- filename: The name of the CSV file (without extension).
34
- timestamp: If True, add a timestamp to the filename.
35
- random_hash_digits: Number of random hash digits to add to the filename.
36
- drop_how: How to drop NA values in the DataFrame.
37
- drop_kwargs: Additional keyword arguments for dropna().
38
- reset_index: If True, reset the index of the DataFrame.
39
- concat_kwargs: Keyword arguments for pandas.concat().
40
- df_kwargs: Additional keyword arguments for to_df().
41
- path_kwargs: Additional keyword arguments for create_path().
42
- verbose: If True, print the file path after saving.
43
-
44
- Returns:
45
- None
46
- """
47
- df = to_df(
48
- input_,
49
- drop_how=drop_how,
50
- drop_kwargs=drop_kwargs,
51
- reset_index=reset_index,
52
- concat_kwargs=concat_kwargs,
53
- **(df_kwargs or {}),
54
- )
55
-
56
- fp = create_path(
57
- directory=directory,
58
- filename=filename,
59
- timestamp=timestamp,
60
- random_hash_digits=random_hash_digits,
61
- extension="csv",
62
- **(path_kwargs or {}),
63
- )
64
-
65
- df.to_csv(fp, index=False)
66
-
67
- if verbose:
68
- print(f"Data saved to {fp}")
69
-
70
-
71
- def to_excel(
72
- input_: Any,
73
- /,
74
- *,
75
- directory: str | Path,
76
- filename: str,
77
- timestamp: bool = False,
78
- random_hash_digits: int = 0,
79
- drop_how: str = "all",
80
- drop_kwargs: dict[str, Any] | None = None,
81
- reset_index: bool = True,
82
- concat_kwargs: dict[str, Any] | None = None,
83
- df_kwargs: dict[str, Any] | None = None,
84
- path_kwargs: dict[str, Any] | None = None,
85
- verbose: bool = False,
86
- ) -> None:
87
- """
88
- Convert input to a DataFrame and save it as an Excel file.
89
-
90
- Args:
91
- input_: The input data to convert to a DataFrame.
92
- directory: The directory to save the Excel file.
93
- filename: The name of the Excel file (without extension).
94
- timestamp: If True, add a timestamp to the filename.
95
- random_hash_digits: Number of random hash digits to add to the filename.
96
- drop_how: How to drop NA values in the DataFrame.
97
- drop_kwargs: Additional keyword arguments for dropna().
98
- reset_index: If True, reset the index of the DataFrame.
99
- concat_kwargs: Keyword arguments for pandas.concat().
100
- df_kwargs: Additional keyword arguments for to_df().
101
- path_kwargs: Additional keyword arguments for create_path().
102
- verbose: If True, print the file path after saving.
103
-
104
- Returns:
105
- None
106
- """
107
- df = to_df(
108
- input_,
109
- drop_how=drop_how,
110
- drop_kwargs=drop_kwargs,
111
- reset_index=reset_index,
112
- concat_kwargs=concat_kwargs,
113
- **(df_kwargs or {}),
114
- )
115
-
116
- fp = create_path(
117
- directory=directory,
118
- filename=filename,
119
- timestamp=timestamp,
120
- random_hash_digits=random_hash_digits,
121
- extension="xlsx",
122
- **(path_kwargs or {}),
123
- )
124
-
125
- df.to_excel(fp, index=False)
126
-
127
- if verbose:
128
- print(f"Data saved to {fp}")
129
-
130
-
131
- __all__ = ["to_csv", "to_excel"]