edsl 0.1.39.dev3__py3-none-any.whl → 0.1.39.dev5__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 (341) hide show
  1. edsl/Base.py +413 -332
  2. edsl/BaseDiff.py +260 -260
  3. edsl/TemplateLoader.py +24 -24
  4. edsl/__init__.py +57 -49
  5. edsl/__version__.py +1 -1
  6. edsl/agents/Agent.py +1071 -867
  7. edsl/agents/AgentList.py +551 -413
  8. edsl/agents/Invigilator.py +284 -233
  9. edsl/agents/InvigilatorBase.py +257 -270
  10. edsl/agents/PromptConstructor.py +272 -354
  11. edsl/agents/QuestionInstructionPromptBuilder.py +128 -0
  12. edsl/agents/QuestionTemplateReplacementsBuilder.py +137 -0
  13. edsl/agents/__init__.py +2 -3
  14. edsl/agents/descriptors.py +99 -99
  15. edsl/agents/prompt_helpers.py +129 -129
  16. edsl/agents/question_option_processor.py +172 -0
  17. edsl/auto/AutoStudy.py +130 -117
  18. edsl/auto/StageBase.py +243 -230
  19. edsl/auto/StageGenerateSurvey.py +178 -178
  20. edsl/auto/StageLabelQuestions.py +125 -125
  21. edsl/auto/StagePersona.py +61 -61
  22. edsl/auto/StagePersonaDimensionValueRanges.py +88 -88
  23. edsl/auto/StagePersonaDimensionValues.py +74 -74
  24. edsl/auto/StagePersonaDimensions.py +69 -69
  25. edsl/auto/StageQuestions.py +74 -73
  26. edsl/auto/SurveyCreatorPipeline.py +21 -21
  27. edsl/auto/utilities.py +218 -224
  28. edsl/base/Base.py +279 -279
  29. edsl/config.py +177 -157
  30. edsl/conversation/Conversation.py +290 -290
  31. edsl/conversation/car_buying.py +59 -58
  32. edsl/conversation/chips.py +95 -95
  33. edsl/conversation/mug_negotiation.py +81 -81
  34. edsl/conversation/next_speaker_utilities.py +93 -93
  35. edsl/coop/CoopFunctionsMixin.py +15 -0
  36. edsl/coop/ExpectedParrotKeyHandler.py +125 -0
  37. edsl/coop/PriceFetcher.py +54 -54
  38. edsl/coop/__init__.py +2 -2
  39. edsl/coop/coop.py +1106 -1028
  40. edsl/coop/utils.py +131 -131
  41. edsl/data/Cache.py +573 -555
  42. edsl/data/CacheEntry.py +230 -233
  43. edsl/data/CacheHandler.py +168 -149
  44. edsl/data/RemoteCacheSync.py +186 -78
  45. edsl/data/SQLiteDict.py +292 -292
  46. edsl/data/__init__.py +5 -4
  47. edsl/data/orm.py +10 -10
  48. edsl/data_transfer_models.py +74 -73
  49. edsl/enums.py +202 -175
  50. edsl/exceptions/BaseException.py +21 -21
  51. edsl/exceptions/__init__.py +54 -54
  52. edsl/exceptions/agents.py +54 -42
  53. edsl/exceptions/cache.py +5 -5
  54. edsl/exceptions/configuration.py +16 -16
  55. edsl/exceptions/coop.py +10 -10
  56. edsl/exceptions/data.py +14 -14
  57. edsl/exceptions/general.py +34 -34
  58. edsl/exceptions/inference_services.py +5 -0
  59. edsl/exceptions/jobs.py +33 -33
  60. edsl/exceptions/language_models.py +63 -63
  61. edsl/exceptions/prompts.py +15 -15
  62. edsl/exceptions/questions.py +109 -91
  63. edsl/exceptions/results.py +29 -29
  64. edsl/exceptions/scenarios.py +29 -22
  65. edsl/exceptions/surveys.py +37 -37
  66. edsl/inference_services/AnthropicService.py +106 -87
  67. edsl/inference_services/AvailableModelCacheHandler.py +184 -0
  68. edsl/inference_services/AvailableModelFetcher.py +215 -0
  69. edsl/inference_services/AwsBedrock.py +118 -120
  70. edsl/inference_services/AzureAI.py +215 -217
  71. edsl/inference_services/DeepInfraService.py +18 -18
  72. edsl/inference_services/GoogleService.py +143 -148
  73. edsl/inference_services/GroqService.py +20 -20
  74. edsl/inference_services/InferenceServiceABC.py +80 -147
  75. edsl/inference_services/InferenceServicesCollection.py +138 -97
  76. edsl/inference_services/MistralAIService.py +120 -123
  77. edsl/inference_services/OllamaService.py +18 -18
  78. edsl/inference_services/OpenAIService.py +236 -224
  79. edsl/inference_services/PerplexityService.py +160 -163
  80. edsl/inference_services/ServiceAvailability.py +135 -0
  81. edsl/inference_services/TestService.py +90 -89
  82. edsl/inference_services/TogetherAIService.py +172 -170
  83. edsl/inference_services/data_structures.py +134 -0
  84. edsl/inference_services/models_available_cache.py +118 -118
  85. edsl/inference_services/rate_limits_cache.py +25 -25
  86. edsl/inference_services/registry.py +41 -41
  87. edsl/inference_services/write_available.py +10 -10
  88. edsl/jobs/AnswerQuestionFunctionConstructor.py +223 -0
  89. edsl/jobs/Answers.py +43 -56
  90. edsl/jobs/FetchInvigilator.py +47 -0
  91. edsl/jobs/InterviewTaskManager.py +98 -0
  92. edsl/jobs/InterviewsConstructor.py +50 -0
  93. edsl/jobs/Jobs.py +823 -898
  94. edsl/jobs/JobsChecks.py +172 -147
  95. edsl/jobs/JobsComponentConstructor.py +189 -0
  96. edsl/jobs/JobsPrompts.py +270 -268
  97. edsl/jobs/JobsRemoteInferenceHandler.py +311 -239
  98. edsl/jobs/JobsRemoteInferenceLogger.py +239 -0
  99. edsl/jobs/RequestTokenEstimator.py +30 -0
  100. edsl/jobs/__init__.py +1 -1
  101. edsl/jobs/async_interview_runner.py +138 -0
  102. edsl/jobs/buckets/BucketCollection.py +104 -63
  103. edsl/jobs/buckets/ModelBuckets.py +65 -65
  104. edsl/jobs/buckets/TokenBucket.py +283 -251
  105. edsl/jobs/buckets/TokenBucketAPI.py +211 -0
  106. edsl/jobs/buckets/TokenBucketClient.py +191 -0
  107. edsl/jobs/check_survey_scenario_compatibility.py +85 -0
  108. edsl/jobs/data_structures.py +120 -0
  109. edsl/jobs/decorators.py +35 -0
  110. edsl/jobs/interviews/Interview.py +396 -661
  111. edsl/jobs/interviews/InterviewExceptionCollection.py +99 -99
  112. edsl/jobs/interviews/InterviewExceptionEntry.py +186 -186
  113. edsl/jobs/interviews/InterviewStatistic.py +63 -63
  114. edsl/jobs/interviews/InterviewStatisticsCollection.py +25 -25
  115. edsl/jobs/interviews/InterviewStatusDictionary.py +78 -78
  116. edsl/jobs/interviews/InterviewStatusLog.py +92 -92
  117. edsl/jobs/interviews/ReportErrors.py +66 -66
  118. edsl/jobs/interviews/interview_status_enum.py +9 -9
  119. edsl/jobs/jobs_status_enums.py +9 -0
  120. edsl/jobs/loggers/HTMLTableJobLogger.py +304 -0
  121. edsl/jobs/results_exceptions_handler.py +98 -0
  122. edsl/jobs/runners/JobsRunnerAsyncio.py +151 -466
  123. edsl/jobs/runners/JobsRunnerStatus.py +297 -330
  124. edsl/jobs/tasks/QuestionTaskCreator.py +244 -242
  125. edsl/jobs/tasks/TaskCreators.py +64 -64
  126. edsl/jobs/tasks/TaskHistory.py +470 -450
  127. edsl/jobs/tasks/TaskStatusLog.py +23 -23
  128. edsl/jobs/tasks/task_status_enum.py +161 -163
  129. edsl/jobs/tokens/InterviewTokenUsage.py +27 -27
  130. edsl/jobs/tokens/TokenUsage.py +34 -34
  131. edsl/language_models/ComputeCost.py +63 -0
  132. edsl/language_models/LanguageModel.py +626 -668
  133. edsl/language_models/ModelList.py +164 -155
  134. edsl/language_models/PriceManager.py +127 -0
  135. edsl/language_models/RawResponseHandler.py +106 -0
  136. edsl/language_models/RegisterLanguageModelsMeta.py +184 -184
  137. edsl/language_models/ServiceDataSources.py +0 -0
  138. edsl/language_models/__init__.py +2 -3
  139. edsl/language_models/fake_openai_call.py +15 -15
  140. edsl/language_models/fake_openai_service.py +61 -61
  141. edsl/language_models/key_management/KeyLookup.py +63 -0
  142. edsl/language_models/key_management/KeyLookupBuilder.py +273 -0
  143. edsl/language_models/key_management/KeyLookupCollection.py +38 -0
  144. edsl/language_models/key_management/__init__.py +0 -0
  145. edsl/language_models/key_management/models.py +131 -0
  146. edsl/language_models/model.py +256 -0
  147. edsl/language_models/repair.py +156 -156
  148. edsl/language_models/utilities.py +65 -64
  149. edsl/notebooks/Notebook.py +263 -258
  150. edsl/notebooks/NotebookToLaTeX.py +142 -0
  151. edsl/notebooks/__init__.py +1 -1
  152. edsl/prompts/Prompt.py +352 -362
  153. edsl/prompts/__init__.py +2 -2
  154. edsl/questions/ExceptionExplainer.py +77 -0
  155. edsl/questions/HTMLQuestion.py +103 -0
  156. edsl/questions/QuestionBase.py +518 -664
  157. edsl/questions/QuestionBasePromptsMixin.py +221 -217
  158. edsl/questions/QuestionBudget.py +227 -227
  159. edsl/questions/QuestionCheckBox.py +359 -359
  160. edsl/questions/QuestionExtract.py +180 -182
  161. edsl/questions/QuestionFreeText.py +113 -114
  162. edsl/questions/QuestionFunctional.py +166 -166
  163. edsl/questions/QuestionList.py +223 -231
  164. edsl/questions/QuestionMatrix.py +265 -0
  165. edsl/questions/QuestionMultipleChoice.py +330 -286
  166. edsl/questions/QuestionNumerical.py +151 -153
  167. edsl/questions/QuestionRank.py +314 -324
  168. edsl/questions/Quick.py +41 -41
  169. edsl/questions/SimpleAskMixin.py +74 -73
  170. edsl/questions/__init__.py +27 -26
  171. edsl/questions/{AnswerValidatorMixin.py → answer_validator_mixin.py} +334 -289
  172. edsl/questions/compose_questions.py +98 -98
  173. edsl/questions/data_structures.py +20 -0
  174. edsl/questions/decorators.py +21 -21
  175. edsl/questions/derived/QuestionLikertFive.py +76 -76
  176. edsl/questions/derived/QuestionLinearScale.py +90 -87
  177. edsl/questions/derived/QuestionTopK.py +93 -93
  178. edsl/questions/derived/QuestionYesNo.py +82 -82
  179. edsl/questions/descriptors.py +427 -413
  180. edsl/questions/loop_processor.py +149 -0
  181. edsl/questions/prompt_templates/question_budget.jinja +13 -13
  182. edsl/questions/prompt_templates/question_checkbox.jinja +32 -32
  183. edsl/questions/prompt_templates/question_extract.jinja +11 -11
  184. edsl/questions/prompt_templates/question_free_text.jinja +3 -3
  185. edsl/questions/prompt_templates/question_linear_scale.jinja +11 -11
  186. edsl/questions/prompt_templates/question_list.jinja +17 -17
  187. edsl/questions/prompt_templates/question_multiple_choice.jinja +33 -33
  188. edsl/questions/prompt_templates/question_numerical.jinja +36 -36
  189. edsl/questions/{QuestionBaseGenMixin.py → question_base_gen_mixin.py} +168 -161
  190. edsl/questions/question_registry.py +177 -177
  191. edsl/questions/{RegisterQuestionsMeta.py → register_questions_meta.py} +71 -71
  192. edsl/questions/{ResponseValidatorABC.py → response_validator_abc.py} +188 -174
  193. edsl/questions/response_validator_factory.py +34 -0
  194. edsl/questions/settings.py +12 -12
  195. edsl/questions/templates/budget/answering_instructions.jinja +7 -7
  196. edsl/questions/templates/budget/question_presentation.jinja +7 -7
  197. edsl/questions/templates/checkbox/answering_instructions.jinja +10 -10
  198. edsl/questions/templates/checkbox/question_presentation.jinja +22 -22
  199. edsl/questions/templates/extract/answering_instructions.jinja +7 -7
  200. edsl/questions/templates/likert_five/answering_instructions.jinja +10 -10
  201. edsl/questions/templates/likert_five/question_presentation.jinja +11 -11
  202. edsl/questions/templates/linear_scale/answering_instructions.jinja +5 -5
  203. edsl/questions/templates/linear_scale/question_presentation.jinja +5 -5
  204. edsl/questions/templates/list/answering_instructions.jinja +3 -3
  205. edsl/questions/templates/list/question_presentation.jinja +5 -5
  206. edsl/questions/templates/matrix/__init__.py +1 -0
  207. edsl/questions/templates/matrix/answering_instructions.jinja +5 -0
  208. edsl/questions/templates/matrix/question_presentation.jinja +20 -0
  209. edsl/questions/templates/multiple_choice/answering_instructions.jinja +9 -9
  210. edsl/questions/templates/multiple_choice/question_presentation.jinja +11 -11
  211. edsl/questions/templates/numerical/answering_instructions.jinja +6 -6
  212. edsl/questions/templates/numerical/question_presentation.jinja +6 -6
  213. edsl/questions/templates/rank/answering_instructions.jinja +11 -11
  214. edsl/questions/templates/rank/question_presentation.jinja +15 -15
  215. edsl/questions/templates/top_k/answering_instructions.jinja +8 -8
  216. edsl/questions/templates/top_k/question_presentation.jinja +22 -22
  217. edsl/questions/templates/yes_no/answering_instructions.jinja +6 -6
  218. edsl/questions/templates/yes_no/question_presentation.jinja +11 -11
  219. edsl/results/CSSParameterizer.py +108 -108
  220. edsl/results/Dataset.py +587 -424
  221. edsl/results/DatasetExportMixin.py +594 -731
  222. edsl/results/DatasetTree.py +295 -275
  223. edsl/results/MarkdownToDocx.py +122 -0
  224. edsl/results/MarkdownToPDF.py +111 -0
  225. edsl/results/Result.py +557 -465
  226. edsl/results/Results.py +1183 -1165
  227. edsl/results/ResultsExportMixin.py +45 -43
  228. edsl/results/ResultsGGMixin.py +121 -121
  229. edsl/results/TableDisplay.py +125 -198
  230. edsl/results/TextEditor.py +50 -0
  231. edsl/results/__init__.py +2 -2
  232. edsl/results/file_exports.py +252 -0
  233. edsl/results/{ResultsFetchMixin.py → results_fetch_mixin.py} +33 -33
  234. edsl/results/{Selector.py → results_selector.py} +145 -135
  235. edsl/results/{ResultsToolsMixin.py → results_tools_mixin.py} +98 -98
  236. edsl/results/smart_objects.py +96 -0
  237. edsl/results/table_data_class.py +12 -0
  238. edsl/results/table_display.css +77 -77
  239. edsl/results/table_renderers.py +118 -0
  240. edsl/results/tree_explore.py +115 -115
  241. edsl/scenarios/ConstructDownloadLink.py +109 -0
  242. edsl/scenarios/DocumentChunker.py +102 -0
  243. edsl/scenarios/DocxScenario.py +16 -0
  244. edsl/scenarios/FileStore.py +511 -632
  245. edsl/scenarios/PdfExtractor.py +40 -0
  246. edsl/scenarios/Scenario.py +498 -601
  247. edsl/scenarios/ScenarioHtmlMixin.py +65 -64
  248. edsl/scenarios/ScenarioList.py +1458 -1287
  249. edsl/scenarios/ScenarioListExportMixin.py +45 -52
  250. edsl/scenarios/ScenarioListPdfMixin.py +239 -261
  251. edsl/scenarios/__init__.py +3 -4
  252. edsl/scenarios/directory_scanner.py +96 -0
  253. edsl/scenarios/file_methods.py +85 -0
  254. edsl/scenarios/handlers/__init__.py +13 -0
  255. edsl/scenarios/handlers/csv.py +38 -0
  256. edsl/scenarios/handlers/docx.py +76 -0
  257. edsl/scenarios/handlers/html.py +37 -0
  258. edsl/scenarios/handlers/json.py +111 -0
  259. edsl/scenarios/handlers/latex.py +5 -0
  260. edsl/scenarios/handlers/md.py +51 -0
  261. edsl/scenarios/handlers/pdf.py +68 -0
  262. edsl/scenarios/handlers/png.py +39 -0
  263. edsl/scenarios/handlers/pptx.py +105 -0
  264. edsl/scenarios/handlers/py.py +294 -0
  265. edsl/scenarios/handlers/sql.py +313 -0
  266. edsl/scenarios/handlers/sqlite.py +149 -0
  267. edsl/scenarios/handlers/txt.py +33 -0
  268. edsl/scenarios/{ScenarioJoin.py → scenario_join.py} +131 -127
  269. edsl/scenarios/scenario_selector.py +156 -0
  270. edsl/shared.py +1 -1
  271. edsl/study/ObjectEntry.py +173 -173
  272. edsl/study/ProofOfWork.py +113 -113
  273. edsl/study/SnapShot.py +80 -80
  274. edsl/study/Study.py +521 -528
  275. edsl/study/__init__.py +4 -4
  276. edsl/surveys/ConstructDAG.py +92 -0
  277. edsl/surveys/DAG.py +148 -148
  278. edsl/surveys/EditSurvey.py +221 -0
  279. edsl/surveys/InstructionHandler.py +100 -0
  280. edsl/surveys/Memory.py +31 -31
  281. edsl/surveys/MemoryManagement.py +72 -0
  282. edsl/surveys/MemoryPlan.py +244 -244
  283. edsl/surveys/Rule.py +327 -326
  284. edsl/surveys/RuleCollection.py +385 -387
  285. edsl/surveys/RuleManager.py +172 -0
  286. edsl/surveys/Simulator.py +75 -0
  287. edsl/surveys/Survey.py +1280 -1801
  288. edsl/surveys/SurveyCSS.py +273 -261
  289. edsl/surveys/SurveyExportMixin.py +259 -259
  290. edsl/surveys/{SurveyFlowVisualizationMixin.py → SurveyFlowVisualization.py} +181 -179
  291. edsl/surveys/SurveyQualtricsImport.py +284 -284
  292. edsl/surveys/SurveyToApp.py +141 -0
  293. edsl/surveys/__init__.py +5 -3
  294. edsl/surveys/base.py +53 -53
  295. edsl/surveys/descriptors.py +60 -56
  296. edsl/surveys/instructions/ChangeInstruction.py +48 -49
  297. edsl/surveys/instructions/Instruction.py +56 -65
  298. edsl/surveys/instructions/InstructionCollection.py +82 -77
  299. edsl/templates/error_reporting/base.html +23 -23
  300. edsl/templates/error_reporting/exceptions_by_model.html +34 -34
  301. edsl/templates/error_reporting/exceptions_by_question_name.html +16 -16
  302. edsl/templates/error_reporting/exceptions_by_type.html +16 -16
  303. edsl/templates/error_reporting/interview_details.html +115 -115
  304. edsl/templates/error_reporting/interviews.html +19 -19
  305. edsl/templates/error_reporting/overview.html +4 -4
  306. edsl/templates/error_reporting/performance_plot.html +1 -1
  307. edsl/templates/error_reporting/report.css +73 -73
  308. edsl/templates/error_reporting/report.html +117 -117
  309. edsl/templates/error_reporting/report.js +25 -25
  310. edsl/tools/__init__.py +1 -1
  311. edsl/tools/clusters.py +192 -192
  312. edsl/tools/embeddings.py +27 -27
  313. edsl/tools/embeddings_plotting.py +118 -118
  314. edsl/tools/plotting.py +112 -112
  315. edsl/tools/summarize.py +18 -18
  316. edsl/utilities/PrettyList.py +56 -0
  317. edsl/utilities/SystemInfo.py +28 -28
  318. edsl/utilities/__init__.py +22 -22
  319. edsl/utilities/ast_utilities.py +25 -25
  320. edsl/utilities/data/Registry.py +6 -6
  321. edsl/utilities/data/__init__.py +1 -1
  322. edsl/utilities/data/scooter_results.json +1 -1
  323. edsl/utilities/decorators.py +77 -77
  324. edsl/utilities/gcp_bucket/cloud_storage.py +96 -96
  325. edsl/utilities/interface.py +627 -627
  326. edsl/utilities/is_notebook.py +18 -0
  327. edsl/utilities/is_valid_variable_name.py +11 -0
  328. edsl/utilities/naming_utilities.py +263 -263
  329. edsl/utilities/remove_edsl_version.py +24 -0
  330. edsl/utilities/repair_functions.py +28 -28
  331. edsl/utilities/restricted_python.py +70 -70
  332. edsl/utilities/utilities.py +436 -424
  333. {edsl-0.1.39.dev3.dist-info → edsl-0.1.39.dev5.dist-info}/LICENSE +21 -21
  334. {edsl-0.1.39.dev3.dist-info → edsl-0.1.39.dev5.dist-info}/METADATA +13 -11
  335. edsl-0.1.39.dev5.dist-info/RECORD +358 -0
  336. {edsl-0.1.39.dev3.dist-info → edsl-0.1.39.dev5.dist-info}/WHEEL +1 -1
  337. edsl/language_models/KeyLookup.py +0 -30
  338. edsl/language_models/registry.py +0 -190
  339. edsl/language_models/unused/ReplicateBase.py +0 -83
  340. edsl/results/ResultsDBMixin.py +0 -238
  341. edsl-0.1.39.dev3.dist-info/RECORD +0 -277
@@ -1,99 +1,99 @@
1
- from collections import UserDict
2
-
3
- from edsl.jobs.interviews.InterviewExceptionEntry import InterviewExceptionEntry
4
-
5
-
6
- class InterviewExceptionCollection(UserDict):
7
- """A collection of exceptions that occurred during the interview."""
8
-
9
- def __init__(self):
10
- super().__init__()
11
- self.fixed = set()
12
-
13
- def unfixed_exceptions(self) -> list:
14
- """Return a list of unfixed exceptions."""
15
- return {k: v for k, v in self.data.items() if k not in self.fixed}
16
-
17
- def num_unfixed(self) -> list:
18
- """Return a list of unfixed questions."""
19
- return len([k for k in self.data.keys() if k not in self.fixed])
20
-
21
- def record_fixed_question(self, question_name: str) -> None:
22
- """Record that a question has been fixed."""
23
- self.fixed.add(question_name)
24
-
25
- def add(self, question_name: str, entry: InterviewExceptionEntry) -> None:
26
- """Add an exception entry to the collection."""
27
- question_name = question_name
28
- if question_name not in self.data:
29
- self.data[question_name] = []
30
- self.data[question_name].append(entry)
31
-
32
- def to_dict(self, include_traceback=True) -> dict:
33
- """Return the collection of exceptions as a dictionary."""
34
- newdata = {k: [e.to_dict() for e in v] for k, v in self.data.items()}
35
- return newdata
36
-
37
- @classmethod
38
- def from_dict(cls, data: dict) -> "InterviewExceptionCollection":
39
- """Create an InterviewExceptionCollection from a dictionary."""
40
- collection = cls()
41
- for question_name, entries in data.items():
42
- for entry in entries:
43
- collection.add(question_name, InterviewExceptionEntry.from_dict(entry))
44
- return collection
45
-
46
- def _repr_html_(self) -> str:
47
- from edsl.utilities.utilities import data_to_html
48
-
49
- return data_to_html(self.to_dict(include_traceback=True))
50
-
51
- def ascii_table(self, traceback: bool = False) -> None:
52
- headers = ["Question name", "Exception", "Time", "Traceback"]
53
- from tabulate import tabulate
54
-
55
- data = []
56
- for question, exceptions in self.data.items():
57
- for exception in exceptions:
58
- if traceback:
59
- row = [
60
- question,
61
- exception["exception"],
62
- exception["time"],
63
- exception["traceback"],
64
- ]
65
- else:
66
- row = [question, exception["exception"], exception["time"]]
67
- data.append(row)
68
-
69
- print(tabulate(data, headers=headers, tablefmt="grid"))
70
-
71
- def print(self, traceback=False):
72
- """Print the collection of exceptions."""
73
- console = Console()
74
- table = Table(show_header=True, header_style="bold magenta")
75
- table.add_column("Question name", style="dim", width=12)
76
- table.add_column("Exception", width=32)
77
- table.add_column("Time", justify="right")
78
- table.add_column("Traceback", min_width=20)
79
-
80
- for queue, exceptions in self.data.items():
81
- for exception in exceptions:
82
- if traceback:
83
- traceback_string = exception["traceback"].replace("\n", "\n\n")
84
- else:
85
- traceback_string = ""
86
- table.add_row(
87
- queue,
88
- exception["exception"],
89
- str(exception["time"]),
90
- traceback_string, # Adding extra newlines for better readability
91
- )
92
-
93
- console.print(table)
94
-
95
-
96
- if __name__ == "__main__":
97
- import doctest
98
-
99
- doctest.testmod(optionflags=doctest.ELLIPSIS)
1
+ from collections import UserDict
2
+
3
+ from edsl.jobs.interviews.InterviewExceptionEntry import InterviewExceptionEntry
4
+
5
+
6
+ class InterviewExceptionCollection(UserDict):
7
+ """A collection of exceptions that occurred during the interview."""
8
+
9
+ def __init__(self):
10
+ super().__init__()
11
+ self.fixed = set()
12
+
13
+ def unfixed_exceptions(self) -> list:
14
+ """Return a list of unfixed exceptions."""
15
+ return {k: v for k, v in self.data.items() if k not in self.fixed}
16
+
17
+ def num_unfixed(self) -> list:
18
+ """Return a list of unfixed questions."""
19
+ return len([k for k in self.data.keys() if k not in self.fixed])
20
+
21
+ def record_fixed_question(self, question_name: str) -> None:
22
+ """Record that a question has been fixed."""
23
+ self.fixed.add(question_name)
24
+
25
+ def add(self, question_name: str, entry: InterviewExceptionEntry) -> None:
26
+ """Add an exception entry to the collection."""
27
+ question_name = question_name
28
+ if question_name not in self.data:
29
+ self.data[question_name] = []
30
+ self.data[question_name].append(entry)
31
+
32
+ def to_dict(self, include_traceback=True) -> dict:
33
+ """Return the collection of exceptions as a dictionary."""
34
+ newdata = {k: [e.to_dict() for e in v] for k, v in self.data.items()}
35
+ return newdata
36
+
37
+ @classmethod
38
+ def from_dict(cls, data: dict) -> "InterviewExceptionCollection":
39
+ """Create an InterviewExceptionCollection from a dictionary."""
40
+ collection = cls()
41
+ for question_name, entries in data.items():
42
+ for entry in entries:
43
+ collection.add(question_name, InterviewExceptionEntry.from_dict(entry))
44
+ return collection
45
+
46
+ def _repr_html_(self) -> str:
47
+ from edsl.utilities.utilities import data_to_html
48
+
49
+ return data_to_html(self.to_dict(include_traceback=True))
50
+
51
+ def ascii_table(self, traceback: bool = False) -> None:
52
+ headers = ["Question name", "Exception", "Time", "Traceback"]
53
+ from tabulate import tabulate
54
+
55
+ data = []
56
+ for question, exceptions in self.data.items():
57
+ for exception in exceptions:
58
+ if traceback:
59
+ row = [
60
+ question,
61
+ exception["exception"],
62
+ exception["time"],
63
+ exception["traceback"],
64
+ ]
65
+ else:
66
+ row = [question, exception["exception"], exception["time"]]
67
+ data.append(row)
68
+
69
+ print(tabulate(data, headers=headers, tablefmt="grid"))
70
+
71
+ def print(self, traceback=False):
72
+ """Print the collection of exceptions."""
73
+ console = Console()
74
+ table = Table(show_header=True, header_style="bold magenta")
75
+ table.add_column("Question name", style="dim", width=12)
76
+ table.add_column("Exception", width=32)
77
+ table.add_column("Time", justify="right")
78
+ table.add_column("Traceback", min_width=20)
79
+
80
+ for queue, exceptions in self.data.items():
81
+ for exception in exceptions:
82
+ if traceback:
83
+ traceback_string = exception["traceback"].replace("\n", "\n\n")
84
+ else:
85
+ traceback_string = ""
86
+ table.add_row(
87
+ queue,
88
+ exception["exception"],
89
+ str(exception["time"]),
90
+ traceback_string, # Adding extra newlines for better readability
91
+ )
92
+
93
+ console.print(table)
94
+
95
+
96
+ if __name__ == "__main__":
97
+ import doctest
98
+
99
+ doctest.testmod(optionflags=doctest.ELLIPSIS)
@@ -1,186 +1,186 @@
1
- import traceback
2
- import datetime
3
-
4
-
5
- class InterviewExceptionEntry:
6
- """Class to record an exception that occurred during the interview."""
7
-
8
- def __init__(
9
- self,
10
- *,
11
- exception: Exception,
12
- invigilator: "Invigilator",
13
- traceback_format="text",
14
- answers=None,
15
- ):
16
- self.time = datetime.datetime.now().isoformat()
17
- self.exception = exception
18
- # self.failed_question = failed_question
19
- self.invigilator = invigilator
20
- self.traceback_format = traceback_format
21
- self.answers = answers
22
-
23
- @property
24
- def question_type(self):
25
- # return self.failed_question.question.question_type
26
- return self.invigilator.question.question_type
27
-
28
- @property
29
- def name(self):
30
- return repr(self.exception)
31
-
32
- @property
33
- def rendered_prompts(self):
34
- return self.invigilator.get_prompts()
35
-
36
- @property
37
- def key_sequence(self):
38
- return self.invigilator.model.key_sequence
39
-
40
- @property
41
- def generated_token_string(self):
42
- # return "POO"
43
- if self.invigilator.raw_model_response is None:
44
- return "No raw model response available."
45
- else:
46
- return self.invigilator.model.get_generated_token_string(
47
- self.invigilator.raw_model_response
48
- )
49
-
50
- @property
51
- def raw_model_response(self):
52
- import json
53
-
54
- if self.invigilator.raw_model_response is None:
55
- return "No raw model response available."
56
- return json.dumps(self.invigilator.raw_model_response, indent=2)
57
-
58
- def __getitem__(self, key):
59
- # Support dict-like access obj['a']
60
- return str(getattr(self, key))
61
-
62
- @classmethod
63
- def example(cls):
64
- from edsl import QuestionFreeText
65
- from edsl.language_models import LanguageModel
66
-
67
- m = LanguageModel.example(test_model=True)
68
- q = QuestionFreeText.example(exception_to_throw=ValueError)
69
- results = q.by(m).run(
70
- skip_retry=True,
71
- print_exceptions=False,
72
- raise_validation_errors=True,
73
- disable_remote_cache=True,
74
- disable_remote_inference=True,
75
- )
76
- return results.task_history.exceptions[0]["how_are_you"][0]
77
-
78
- @property
79
- def code_to_reproduce(self):
80
- return self.code(run=False)
81
-
82
- def code(self, run=True):
83
- lines = []
84
- lines.append("from edsl import Question, Model, Scenario, Agent")
85
-
86
- lines.append(f"q = {repr(self.invigilator.question)}")
87
- lines.append(f"scenario = {repr(self.invigilator.scenario)}")
88
- lines.append(f"agent = {repr(self.invigilator.agent)}")
89
- lines.append(f"m = Model('{self.invigilator.model.model}')")
90
- lines.append("results = q.by(m).by(agent).by(scenario).run()")
91
- code_str = "\n".join(lines)
92
-
93
- if run:
94
- # Create a new namespace to avoid polluting the global namespace
95
- namespace = {}
96
- exec(code_str, namespace)
97
- return namespace["results"]
98
- return code_str
99
-
100
- @property
101
- def traceback(self):
102
- """Return the exception as HTML."""
103
- if self.traceback_format == "html":
104
- return self.html_traceback
105
- else:
106
- return self.text_traceback
107
-
108
- @property
109
- def text_traceback(self):
110
- """
111
- >>> entry = InterviewExceptionEntry.example()
112
- >>> entry.text_traceback
113
- 'Traceback (most recent call last):...'
114
- """
115
- e = self.exception
116
- tb_str = "".join(traceback.format_exception(type(e), e, e.__traceback__))
117
- return tb_str
118
-
119
- @property
120
- def html_traceback(self):
121
- from rich.console import Console
122
- from rich.table import Table
123
- from rich.traceback import Traceback
124
-
125
- from io import StringIO
126
-
127
- html_output = StringIO()
128
-
129
- console = Console(file=html_output, record=True)
130
-
131
- tb = Traceback.from_exception(
132
- type(self.exception),
133
- self.exception,
134
- self.exception.__traceback__,
135
- show_locals=True,
136
- )
137
- console.print(tb)
138
- return html_output.getvalue()
139
-
140
- @staticmethod
141
- def serialize_exception(exception: Exception) -> dict:
142
- return {
143
- "type": type(exception).__name__,
144
- "message": str(exception),
145
- "traceback": "".join(
146
- traceback.format_exception(
147
- type(exception), exception, exception.__traceback__
148
- )
149
- ),
150
- }
151
-
152
- @staticmethod
153
- def deserialize_exception(data: dict) -> Exception:
154
- try:
155
- exception_class = globals()[data["type"]]
156
- except KeyError:
157
- exception_class = Exception
158
- return exception_class(data["message"])
159
-
160
- def to_dict(self) -> dict:
161
- """Return the exception as a dictionary.
162
-
163
- >>> entry = InterviewExceptionEntry.example()
164
- >>> _ = entry.to_dict()
165
- """
166
- return {
167
- "exception": self.serialize_exception(self.exception),
168
- "time": self.time,
169
- "traceback": self.traceback,
170
- "invigilator": self.invigilator.to_dict(),
171
- }
172
-
173
- @classmethod
174
- def from_dict(cls, data: dict) -> "InterviewExceptionEntry":
175
- """Create an InterviewExceptionEntry from a dictionary."""
176
- from edsl.agents.Invigilator import InvigilatorAI
177
-
178
- exception = cls.deserialize_exception(data["exception"])
179
- invigilator = InvigilatorAI.from_dict(data["invigilator"])
180
- return cls(exception=exception, invigilator=invigilator)
181
-
182
-
183
- if __name__ == "__main__":
184
- import doctest
185
-
186
- doctest.testmod(optionflags=doctest.ELLIPSIS)
1
+ import traceback
2
+ import datetime
3
+
4
+
5
+ class InterviewExceptionEntry:
6
+ """Class to record an exception that occurred during the interview."""
7
+
8
+ def __init__(
9
+ self,
10
+ *,
11
+ exception: Exception,
12
+ invigilator: "Invigilator",
13
+ traceback_format="text",
14
+ answers=None,
15
+ ):
16
+ self.time = datetime.datetime.now().isoformat()
17
+ self.exception = exception
18
+ # self.failed_question = failed_question
19
+ self.invigilator = invigilator
20
+ self.traceback_format = traceback_format
21
+ self.answers = answers
22
+
23
+ @property
24
+ def question_type(self):
25
+ # return self.failed_question.question.question_type
26
+ return self.invigilator.question.question_type
27
+
28
+ @property
29
+ def name(self):
30
+ return repr(self.exception)
31
+
32
+ @property
33
+ def rendered_prompts(self):
34
+ return self.invigilator.get_prompts()
35
+
36
+ @property
37
+ def key_sequence(self):
38
+ return self.invigilator.model.key_sequence
39
+
40
+ @property
41
+ def generated_token_string(self):
42
+ # return "POO"
43
+ if self.invigilator.raw_model_response is None:
44
+ return "No raw model response available."
45
+ else:
46
+ return self.invigilator.model.get_generated_token_string(
47
+ self.invigilator.raw_model_response
48
+ )
49
+
50
+ @property
51
+ def raw_model_response(self):
52
+ import json
53
+
54
+ if self.invigilator.raw_model_response is None:
55
+ return "No raw model response available."
56
+ return json.dumps(self.invigilator.raw_model_response, indent=2)
57
+
58
+ def __getitem__(self, key):
59
+ # Support dict-like access obj['a']
60
+ return str(getattr(self, key))
61
+
62
+ @classmethod
63
+ def example(cls):
64
+ from edsl import QuestionFreeText
65
+ from edsl.language_models import LanguageModel
66
+
67
+ m = LanguageModel.example(test_model=True)
68
+ q = QuestionFreeText.example(exception_to_throw=ValueError)
69
+ results = q.by(m).run(
70
+ skip_retry=True,
71
+ print_exceptions=False,
72
+ raise_validation_errors=True,
73
+ disable_remote_cache=True,
74
+ disable_remote_inference=True,
75
+ )
76
+ return results.task_history.exceptions[0]["how_are_you"][0]
77
+
78
+ @property
79
+ def code_to_reproduce(self):
80
+ return self.code(run=False)
81
+
82
+ def code(self, run=True):
83
+ lines = []
84
+ lines.append("from edsl import Question, Model, Scenario, Agent")
85
+
86
+ lines.append(f"q = {repr(self.invigilator.question)}")
87
+ lines.append(f"scenario = {repr(self.invigilator.scenario)}")
88
+ lines.append(f"agent = {repr(self.invigilator.agent)}")
89
+ lines.append(f"m = Model('{self.invigilator.model.model}')")
90
+ lines.append("results = q.by(m).by(agent).by(scenario).run()")
91
+ code_str = "\n".join(lines)
92
+
93
+ if run:
94
+ # Create a new namespace to avoid polluting the global namespace
95
+ namespace = {}
96
+ exec(code_str, namespace)
97
+ return namespace["results"]
98
+ return code_str
99
+
100
+ @property
101
+ def traceback(self):
102
+ """Return the exception as HTML."""
103
+ if self.traceback_format == "html":
104
+ return self.html_traceback
105
+ else:
106
+ return self.text_traceback
107
+
108
+ @property
109
+ def text_traceback(self):
110
+ """
111
+ >>> entry = InterviewExceptionEntry.example()
112
+ >>> entry.text_traceback
113
+ 'Traceback (most recent call last):...'
114
+ """
115
+ e = self.exception
116
+ tb_str = "".join(traceback.format_exception(type(e), e, e.__traceback__))
117
+ return tb_str
118
+
119
+ @property
120
+ def html_traceback(self):
121
+ from rich.console import Console
122
+ from rich.table import Table
123
+ from rich.traceback import Traceback
124
+
125
+ from io import StringIO
126
+
127
+ html_output = StringIO()
128
+
129
+ console = Console(file=html_output, record=True)
130
+
131
+ tb = Traceback.from_exception(
132
+ type(self.exception),
133
+ self.exception,
134
+ self.exception.__traceback__,
135
+ show_locals=True,
136
+ )
137
+ console.print(tb)
138
+ return html_output.getvalue()
139
+
140
+ @staticmethod
141
+ def serialize_exception(exception: Exception) -> dict:
142
+ return {
143
+ "type": type(exception).__name__,
144
+ "message": str(exception),
145
+ "traceback": "".join(
146
+ traceback.format_exception(
147
+ type(exception), exception, exception.__traceback__
148
+ )
149
+ ),
150
+ }
151
+
152
+ @staticmethod
153
+ def deserialize_exception(data: dict) -> Exception:
154
+ try:
155
+ exception_class = globals()[data["type"]]
156
+ except KeyError:
157
+ exception_class = Exception
158
+ return exception_class(data["message"])
159
+
160
+ def to_dict(self) -> dict:
161
+ """Return the exception as a dictionary.
162
+
163
+ >>> entry = InterviewExceptionEntry.example()
164
+ >>> _ = entry.to_dict()
165
+ """
166
+ return {
167
+ "exception": self.serialize_exception(self.exception),
168
+ "time": self.time,
169
+ "traceback": self.traceback,
170
+ "invigilator": self.invigilator.to_dict(),
171
+ }
172
+
173
+ @classmethod
174
+ def from_dict(cls, data: dict) -> "InterviewExceptionEntry":
175
+ """Create an InterviewExceptionEntry from a dictionary."""
176
+ from edsl.agents.Invigilator import InvigilatorAI
177
+
178
+ exception = cls.deserialize_exception(data["exception"])
179
+ invigilator = InvigilatorAI.from_dict(data["invigilator"])
180
+ return cls(exception=exception, invigilator=invigilator)
181
+
182
+
183
+ if __name__ == "__main__":
184
+ import doctest
185
+
186
+ doctest.testmod(optionflags=doctest.ELLIPSIS)