edsl 0.1.39.dev2__py3-none-any.whl → 0.1.39.dev3__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 (334) hide show
  1. edsl/Base.py +332 -385
  2. edsl/BaseDiff.py +260 -260
  3. edsl/TemplateLoader.py +24 -24
  4. edsl/__init__.py +49 -57
  5. edsl/__version__.py +1 -1
  6. edsl/agents/Agent.py +867 -1079
  7. edsl/agents/AgentList.py +413 -551
  8. edsl/agents/Invigilator.py +233 -285
  9. edsl/agents/InvigilatorBase.py +270 -254
  10. edsl/agents/PromptConstructor.py +354 -252
  11. edsl/agents/__init__.py +3 -2
  12. edsl/agents/descriptors.py +99 -99
  13. edsl/agents/prompt_helpers.py +129 -129
  14. edsl/auto/AutoStudy.py +117 -117
  15. edsl/auto/StageBase.py +230 -230
  16. edsl/auto/StageGenerateSurvey.py +178 -178
  17. edsl/auto/StageLabelQuestions.py +125 -125
  18. edsl/auto/StagePersona.py +61 -61
  19. edsl/auto/StagePersonaDimensionValueRanges.py +88 -88
  20. edsl/auto/StagePersonaDimensionValues.py +74 -74
  21. edsl/auto/StagePersonaDimensions.py +69 -69
  22. edsl/auto/StageQuestions.py +73 -73
  23. edsl/auto/SurveyCreatorPipeline.py +21 -21
  24. edsl/auto/utilities.py +224 -224
  25. edsl/base/Base.py +279 -279
  26. edsl/config.py +157 -177
  27. edsl/conversation/Conversation.py +290 -290
  28. edsl/conversation/car_buying.py +58 -59
  29. edsl/conversation/chips.py +95 -95
  30. edsl/conversation/mug_negotiation.py +81 -81
  31. edsl/conversation/next_speaker_utilities.py +93 -93
  32. edsl/coop/PriceFetcher.py +54 -54
  33. edsl/coop/__init__.py +2 -2
  34. edsl/coop/coop.py +1028 -1090
  35. edsl/coop/utils.py +131 -131
  36. edsl/data/Cache.py +555 -562
  37. edsl/data/CacheEntry.py +233 -230
  38. edsl/data/CacheHandler.py +149 -170
  39. edsl/data/RemoteCacheSync.py +78 -78
  40. edsl/data/SQLiteDict.py +292 -292
  41. edsl/data/__init__.py +4 -5
  42. edsl/data/orm.py +10 -10
  43. edsl/data_transfer_models.py +73 -74
  44. edsl/enums.py +175 -195
  45. edsl/exceptions/BaseException.py +21 -21
  46. edsl/exceptions/__init__.py +54 -54
  47. edsl/exceptions/agents.py +42 -54
  48. edsl/exceptions/cache.py +5 -5
  49. edsl/exceptions/configuration.py +16 -16
  50. edsl/exceptions/coop.py +10 -10
  51. edsl/exceptions/data.py +14 -14
  52. edsl/exceptions/general.py +34 -34
  53. edsl/exceptions/jobs.py +33 -33
  54. edsl/exceptions/language_models.py +63 -63
  55. edsl/exceptions/prompts.py +15 -15
  56. edsl/exceptions/questions.py +91 -109
  57. edsl/exceptions/results.py +29 -29
  58. edsl/exceptions/scenarios.py +22 -29
  59. edsl/exceptions/surveys.py +37 -37
  60. edsl/inference_services/AnthropicService.py +87 -84
  61. edsl/inference_services/AwsBedrock.py +120 -118
  62. edsl/inference_services/AzureAI.py +217 -215
  63. edsl/inference_services/DeepInfraService.py +18 -18
  64. edsl/inference_services/GoogleService.py +148 -139
  65. edsl/inference_services/GroqService.py +20 -20
  66. edsl/inference_services/InferenceServiceABC.py +147 -80
  67. edsl/inference_services/InferenceServicesCollection.py +97 -122
  68. edsl/inference_services/MistralAIService.py +123 -120
  69. edsl/inference_services/OllamaService.py +18 -18
  70. edsl/inference_services/OpenAIService.py +224 -221
  71. edsl/inference_services/PerplexityService.py +163 -160
  72. edsl/inference_services/TestService.py +89 -92
  73. edsl/inference_services/TogetherAIService.py +170 -170
  74. edsl/inference_services/models_available_cache.py +118 -118
  75. edsl/inference_services/rate_limits_cache.py +25 -25
  76. edsl/inference_services/registry.py +41 -41
  77. edsl/inference_services/write_available.py +10 -10
  78. edsl/jobs/Answers.py +56 -43
  79. edsl/jobs/Jobs.py +898 -757
  80. edsl/jobs/JobsChecks.py +147 -172
  81. edsl/jobs/JobsPrompts.py +268 -270
  82. edsl/jobs/JobsRemoteInferenceHandler.py +239 -287
  83. edsl/jobs/__init__.py +1 -1
  84. edsl/jobs/buckets/BucketCollection.py +63 -104
  85. edsl/jobs/buckets/ModelBuckets.py +65 -65
  86. edsl/jobs/buckets/TokenBucket.py +251 -283
  87. edsl/jobs/interviews/Interview.py +661 -358
  88. edsl/jobs/interviews/InterviewExceptionCollection.py +99 -99
  89. edsl/jobs/interviews/InterviewExceptionEntry.py +186 -186
  90. edsl/jobs/interviews/InterviewStatistic.py +63 -63
  91. edsl/jobs/interviews/InterviewStatisticsCollection.py +25 -25
  92. edsl/jobs/interviews/InterviewStatusDictionary.py +78 -78
  93. edsl/jobs/interviews/InterviewStatusLog.py +92 -92
  94. edsl/jobs/interviews/ReportErrors.py +66 -66
  95. edsl/jobs/interviews/interview_status_enum.py +9 -9
  96. edsl/jobs/runners/JobsRunnerAsyncio.py +466 -421
  97. edsl/jobs/runners/JobsRunnerStatus.py +330 -330
  98. edsl/jobs/tasks/QuestionTaskCreator.py +242 -244
  99. edsl/jobs/tasks/TaskCreators.py +64 -64
  100. edsl/jobs/tasks/TaskHistory.py +450 -449
  101. edsl/jobs/tasks/TaskStatusLog.py +23 -23
  102. edsl/jobs/tasks/task_status_enum.py +163 -161
  103. edsl/jobs/tokens/InterviewTokenUsage.py +27 -27
  104. edsl/jobs/tokens/TokenUsage.py +34 -34
  105. edsl/language_models/KeyLookup.py +30 -0
  106. edsl/language_models/LanguageModel.py +668 -571
  107. edsl/language_models/ModelList.py +155 -153
  108. edsl/language_models/RegisterLanguageModelsMeta.py +184 -184
  109. edsl/language_models/__init__.py +3 -2
  110. edsl/language_models/fake_openai_call.py +15 -15
  111. edsl/language_models/fake_openai_service.py +61 -61
  112. edsl/language_models/registry.py +190 -180
  113. edsl/language_models/repair.py +156 -156
  114. edsl/language_models/unused/ReplicateBase.py +83 -0
  115. edsl/language_models/utilities.py +64 -65
  116. edsl/notebooks/Notebook.py +258 -263
  117. edsl/notebooks/__init__.py +1 -1
  118. edsl/prompts/Prompt.py +362 -352
  119. edsl/prompts/__init__.py +2 -2
  120. edsl/questions/AnswerValidatorMixin.py +289 -334
  121. edsl/questions/QuestionBase.py +664 -509
  122. edsl/questions/QuestionBaseGenMixin.py +161 -165
  123. edsl/questions/QuestionBasePromptsMixin.py +217 -221
  124. edsl/questions/QuestionBudget.py +227 -227
  125. edsl/questions/QuestionCheckBox.py +359 -359
  126. edsl/questions/QuestionExtract.py +182 -182
  127. edsl/questions/QuestionFreeText.py +114 -113
  128. edsl/questions/QuestionFunctional.py +166 -166
  129. edsl/questions/QuestionList.py +231 -229
  130. edsl/questions/QuestionMultipleChoice.py +286 -330
  131. edsl/questions/QuestionNumerical.py +153 -151
  132. edsl/questions/QuestionRank.py +324 -314
  133. edsl/questions/Quick.py +41 -41
  134. edsl/questions/RegisterQuestionsMeta.py +71 -71
  135. edsl/questions/ResponseValidatorABC.py +174 -200
  136. edsl/questions/SimpleAskMixin.py +73 -74
  137. edsl/questions/__init__.py +26 -27
  138. edsl/questions/compose_questions.py +98 -98
  139. edsl/questions/decorators.py +21 -21
  140. edsl/questions/derived/QuestionLikertFive.py +76 -76
  141. edsl/questions/derived/QuestionLinearScale.py +87 -90
  142. edsl/questions/derived/QuestionTopK.py +93 -93
  143. edsl/questions/derived/QuestionYesNo.py +82 -82
  144. edsl/questions/descriptors.py +413 -427
  145. edsl/questions/prompt_templates/question_budget.jinja +13 -13
  146. edsl/questions/prompt_templates/question_checkbox.jinja +32 -32
  147. edsl/questions/prompt_templates/question_extract.jinja +11 -11
  148. edsl/questions/prompt_templates/question_free_text.jinja +3 -3
  149. edsl/questions/prompt_templates/question_linear_scale.jinja +11 -11
  150. edsl/questions/prompt_templates/question_list.jinja +17 -17
  151. edsl/questions/prompt_templates/question_multiple_choice.jinja +33 -33
  152. edsl/questions/prompt_templates/question_numerical.jinja +36 -36
  153. edsl/questions/question_registry.py +177 -177
  154. edsl/questions/settings.py +12 -12
  155. edsl/questions/templates/budget/answering_instructions.jinja +7 -7
  156. edsl/questions/templates/budget/question_presentation.jinja +7 -7
  157. edsl/questions/templates/checkbox/answering_instructions.jinja +10 -10
  158. edsl/questions/templates/checkbox/question_presentation.jinja +22 -22
  159. edsl/questions/templates/extract/answering_instructions.jinja +7 -7
  160. edsl/questions/templates/likert_five/answering_instructions.jinja +10 -10
  161. edsl/questions/templates/likert_five/question_presentation.jinja +11 -11
  162. edsl/questions/templates/linear_scale/answering_instructions.jinja +5 -5
  163. edsl/questions/templates/linear_scale/question_presentation.jinja +5 -5
  164. edsl/questions/templates/list/answering_instructions.jinja +3 -3
  165. edsl/questions/templates/list/question_presentation.jinja +5 -5
  166. edsl/questions/templates/multiple_choice/answering_instructions.jinja +9 -9
  167. edsl/questions/templates/multiple_choice/question_presentation.jinja +11 -11
  168. edsl/questions/templates/numerical/answering_instructions.jinja +6 -6
  169. edsl/questions/templates/numerical/question_presentation.jinja +6 -6
  170. edsl/questions/templates/rank/answering_instructions.jinja +11 -11
  171. edsl/questions/templates/rank/question_presentation.jinja +15 -15
  172. edsl/questions/templates/top_k/answering_instructions.jinja +8 -8
  173. edsl/questions/templates/top_k/question_presentation.jinja +22 -22
  174. edsl/questions/templates/yes_no/answering_instructions.jinja +6 -6
  175. edsl/questions/templates/yes_no/question_presentation.jinja +11 -11
  176. edsl/results/CSSParameterizer.py +108 -108
  177. edsl/results/Dataset.py +424 -587
  178. edsl/results/DatasetExportMixin.py +731 -653
  179. edsl/results/DatasetTree.py +275 -295
  180. edsl/results/Result.py +465 -451
  181. edsl/results/Results.py +1165 -1172
  182. edsl/results/ResultsDBMixin.py +238 -0
  183. edsl/results/ResultsExportMixin.py +43 -45
  184. edsl/results/ResultsFetchMixin.py +33 -33
  185. edsl/results/ResultsGGMixin.py +121 -121
  186. edsl/results/ResultsToolsMixin.py +98 -98
  187. edsl/results/Selector.py +135 -145
  188. edsl/results/TableDisplay.py +198 -125
  189. edsl/results/__init__.py +2 -2
  190. edsl/results/table_display.css +77 -77
  191. edsl/results/tree_explore.py +115 -115
  192. edsl/scenarios/FileStore.py +632 -511
  193. edsl/scenarios/Scenario.py +601 -498
  194. edsl/scenarios/ScenarioHtmlMixin.py +64 -65
  195. edsl/scenarios/ScenarioJoin.py +127 -131
  196. edsl/scenarios/ScenarioList.py +1287 -1430
  197. edsl/scenarios/ScenarioListExportMixin.py +52 -45
  198. edsl/scenarios/ScenarioListPdfMixin.py +261 -239
  199. edsl/scenarios/__init__.py +4 -3
  200. edsl/shared.py +1 -1
  201. edsl/study/ObjectEntry.py +173 -173
  202. edsl/study/ProofOfWork.py +113 -113
  203. edsl/study/SnapShot.py +80 -80
  204. edsl/study/Study.py +528 -521
  205. edsl/study/__init__.py +4 -4
  206. edsl/surveys/DAG.py +148 -148
  207. edsl/surveys/Memory.py +31 -31
  208. edsl/surveys/MemoryPlan.py +244 -244
  209. edsl/surveys/Rule.py +326 -327
  210. edsl/surveys/RuleCollection.py +387 -385
  211. edsl/surveys/Survey.py +1801 -1229
  212. edsl/surveys/SurveyCSS.py +261 -273
  213. edsl/surveys/SurveyExportMixin.py +259 -259
  214. edsl/surveys/{SurveyFlowVisualization.py → SurveyFlowVisualizationMixin.py} +179 -181
  215. edsl/surveys/SurveyQualtricsImport.py +284 -284
  216. edsl/surveys/__init__.py +3 -5
  217. edsl/surveys/base.py +53 -53
  218. edsl/surveys/descriptors.py +56 -60
  219. edsl/surveys/instructions/ChangeInstruction.py +49 -48
  220. edsl/surveys/instructions/Instruction.py +65 -56
  221. edsl/surveys/instructions/InstructionCollection.py +77 -82
  222. edsl/templates/error_reporting/base.html +23 -23
  223. edsl/templates/error_reporting/exceptions_by_model.html +34 -34
  224. edsl/templates/error_reporting/exceptions_by_question_name.html +16 -16
  225. edsl/templates/error_reporting/exceptions_by_type.html +16 -16
  226. edsl/templates/error_reporting/interview_details.html +115 -115
  227. edsl/templates/error_reporting/interviews.html +19 -19
  228. edsl/templates/error_reporting/overview.html +4 -4
  229. edsl/templates/error_reporting/performance_plot.html +1 -1
  230. edsl/templates/error_reporting/report.css +73 -73
  231. edsl/templates/error_reporting/report.html +117 -117
  232. edsl/templates/error_reporting/report.js +25 -25
  233. edsl/tools/__init__.py +1 -1
  234. edsl/tools/clusters.py +192 -192
  235. edsl/tools/embeddings.py +27 -27
  236. edsl/tools/embeddings_plotting.py +118 -118
  237. edsl/tools/plotting.py +112 -112
  238. edsl/tools/summarize.py +18 -18
  239. edsl/utilities/SystemInfo.py +28 -28
  240. edsl/utilities/__init__.py +22 -22
  241. edsl/utilities/ast_utilities.py +25 -25
  242. edsl/utilities/data/Registry.py +6 -6
  243. edsl/utilities/data/__init__.py +1 -1
  244. edsl/utilities/data/scooter_results.json +1 -1
  245. edsl/utilities/decorators.py +77 -77
  246. edsl/utilities/gcp_bucket/cloud_storage.py +96 -96
  247. edsl/utilities/interface.py +627 -627
  248. edsl/utilities/naming_utilities.py +263 -263
  249. edsl/utilities/repair_functions.py +28 -28
  250. edsl/utilities/restricted_python.py +70 -70
  251. edsl/utilities/utilities.py +424 -436
  252. {edsl-0.1.39.dev2.dist-info → edsl-0.1.39.dev3.dist-info}/LICENSE +21 -21
  253. {edsl-0.1.39.dev2.dist-info → edsl-0.1.39.dev3.dist-info}/METADATA +10 -12
  254. edsl-0.1.39.dev3.dist-info/RECORD +277 -0
  255. edsl/agents/QuestionInstructionPromptBuilder.py +0 -128
  256. edsl/agents/QuestionOptionProcessor.py +0 -172
  257. edsl/agents/QuestionTemplateReplacementsBuilder.py +0 -137
  258. edsl/coop/CoopFunctionsMixin.py +0 -15
  259. edsl/coop/ExpectedParrotKeyHandler.py +0 -125
  260. edsl/exceptions/inference_services.py +0 -5
  261. edsl/inference_services/AvailableModelCacheHandler.py +0 -184
  262. edsl/inference_services/AvailableModelFetcher.py +0 -209
  263. edsl/inference_services/ServiceAvailability.py +0 -135
  264. edsl/inference_services/data_structures.py +0 -62
  265. edsl/jobs/AnswerQuestionFunctionConstructor.py +0 -188
  266. edsl/jobs/FetchInvigilator.py +0 -40
  267. edsl/jobs/InterviewTaskManager.py +0 -98
  268. edsl/jobs/InterviewsConstructor.py +0 -48
  269. edsl/jobs/JobsComponentConstructor.py +0 -189
  270. edsl/jobs/JobsRemoteInferenceLogger.py +0 -239
  271. edsl/jobs/RequestTokenEstimator.py +0 -30
  272. edsl/jobs/buckets/TokenBucketAPI.py +0 -211
  273. edsl/jobs/buckets/TokenBucketClient.py +0 -191
  274. edsl/jobs/decorators.py +0 -35
  275. edsl/jobs/jobs_status_enums.py +0 -9
  276. edsl/jobs/loggers/HTMLTableJobLogger.py +0 -304
  277. edsl/language_models/ComputeCost.py +0 -63
  278. edsl/language_models/PriceManager.py +0 -127
  279. edsl/language_models/RawResponseHandler.py +0 -106
  280. edsl/language_models/ServiceDataSources.py +0 -0
  281. edsl/language_models/key_management/KeyLookup.py +0 -63
  282. edsl/language_models/key_management/KeyLookupBuilder.py +0 -273
  283. edsl/language_models/key_management/KeyLookupCollection.py +0 -38
  284. edsl/language_models/key_management/__init__.py +0 -0
  285. edsl/language_models/key_management/models.py +0 -131
  286. edsl/notebooks/NotebookToLaTeX.py +0 -142
  287. edsl/questions/ExceptionExplainer.py +0 -77
  288. edsl/questions/HTMLQuestion.py +0 -103
  289. edsl/questions/LoopProcessor.py +0 -149
  290. edsl/questions/QuestionMatrix.py +0 -265
  291. edsl/questions/ResponseValidatorFactory.py +0 -28
  292. edsl/questions/templates/matrix/__init__.py +0 -1
  293. edsl/questions/templates/matrix/answering_instructions.jinja +0 -5
  294. edsl/questions/templates/matrix/question_presentation.jinja +0 -20
  295. edsl/results/MarkdownToDocx.py +0 -122
  296. edsl/results/MarkdownToPDF.py +0 -111
  297. edsl/results/TextEditor.py +0 -50
  298. edsl/results/smart_objects.py +0 -96
  299. edsl/results/table_data_class.py +0 -12
  300. edsl/results/table_renderers.py +0 -118
  301. edsl/scenarios/ConstructDownloadLink.py +0 -109
  302. edsl/scenarios/DirectoryScanner.py +0 -96
  303. edsl/scenarios/DocumentChunker.py +0 -102
  304. edsl/scenarios/DocxScenario.py +0 -16
  305. edsl/scenarios/PdfExtractor.py +0 -40
  306. edsl/scenarios/ScenarioSelector.py +0 -156
  307. edsl/scenarios/file_methods.py +0 -85
  308. edsl/scenarios/handlers/__init__.py +0 -13
  309. edsl/scenarios/handlers/csv.py +0 -38
  310. edsl/scenarios/handlers/docx.py +0 -76
  311. edsl/scenarios/handlers/html.py +0 -37
  312. edsl/scenarios/handlers/json.py +0 -111
  313. edsl/scenarios/handlers/latex.py +0 -5
  314. edsl/scenarios/handlers/md.py +0 -51
  315. edsl/scenarios/handlers/pdf.py +0 -68
  316. edsl/scenarios/handlers/png.py +0 -39
  317. edsl/scenarios/handlers/pptx.py +0 -105
  318. edsl/scenarios/handlers/py.py +0 -294
  319. edsl/scenarios/handlers/sql.py +0 -313
  320. edsl/scenarios/handlers/sqlite.py +0 -149
  321. edsl/scenarios/handlers/txt.py +0 -33
  322. edsl/surveys/ConstructDAG.py +0 -92
  323. edsl/surveys/EditSurvey.py +0 -221
  324. edsl/surveys/InstructionHandler.py +0 -100
  325. edsl/surveys/MemoryManagement.py +0 -72
  326. edsl/surveys/RuleManager.py +0 -172
  327. edsl/surveys/Simulator.py +0 -75
  328. edsl/surveys/SurveyToApp.py +0 -141
  329. edsl/utilities/PrettyList.py +0 -56
  330. edsl/utilities/is_notebook.py +0 -18
  331. edsl/utilities/is_valid_variable_name.py +0 -11
  332. edsl/utilities/remove_edsl_version.py +0 -24
  333. edsl-0.1.39.dev2.dist-info/RECORD +0 -352
  334. {edsl-0.1.39.dev2.dist-info → edsl-0.1.39.dev3.dist-info}/WHEEL +0 -0
@@ -1,287 +1,239 @@
1
- from typing import Optional, Union, Literal, TYPE_CHECKING, NewType
2
-
3
-
4
- Seconds = NewType("Seconds", float)
5
- JobUUID = NewType("JobUUID", str)
6
-
7
- from edsl.exceptions.coop import CoopServerResponseError
8
-
9
- if TYPE_CHECKING:
10
- from edsl.results.Results import Results
11
- from edsl.jobs.Jobs import Jobs
12
- from edsl.coop.coop import RemoteInferenceResponse, RemoteInferenceCreationInfo
13
- from edsl.jobs.JobsRemoteInferenceLogger import JobLogger
14
-
15
- from edsl.coop.coop import RemoteInferenceResponse, RemoteInferenceCreationInfo
16
-
17
- from edsl.jobs.jobs_status_enums import JobsStatus
18
- from edsl.coop.utils import VisibilityType
19
-
20
-
21
- class JobsRemoteInferenceHandler:
22
- def __init__(self, jobs: "Jobs", verbose: bool = False, poll_interval: Seconds = 1):
23
- """ """
24
- self.jobs = jobs
25
- self.verbose = verbose
26
- self.poll_interval = poll_interval
27
-
28
- self._remote_job_creation_data: Union[None, RemoteInferenceCreationInfo] = None
29
- self._job_uuid: Union[None, JobUUID] = None # Will be set when job is created
30
- self.logger: Union[None, JobLogger] = None # Will be initialized when needed
31
-
32
- @property
33
- def remote_job_creation_data(self) -> RemoteInferenceCreationInfo:
34
- return self._remote_job_creation_data
35
-
36
- @property
37
- def job_uuid(self) -> JobUUID:
38
- return self._job_uuid
39
-
40
- def use_remote_inference(self, disable_remote_inference: bool) -> bool:
41
- import requests
42
-
43
- if disable_remote_inference:
44
- return False
45
- if not disable_remote_inference:
46
- try:
47
- from edsl.coop.coop import Coop
48
-
49
- user_edsl_settings = Coop().edsl_settings
50
- return user_edsl_settings.get("remote_inference", False)
51
- except requests.ConnectionError:
52
- pass
53
- except CoopServerResponseError as e:
54
- pass
55
-
56
- return False
57
-
58
- def create_remote_inference_job(
59
- self,
60
- iterations: int = 1,
61
- remote_inference_description: Optional[str] = None,
62
- remote_inference_results_visibility: Optional[VisibilityType] = "unlisted",
63
- ) -> None:
64
- from edsl.config import CONFIG
65
- from edsl.coop.coop import Coop
66
-
67
- # Initialize logger
68
- from edsl.utilities.is_notebook import is_notebook
69
- from edsl.jobs.JobsRemoteInferenceLogger import JupyterJobLogger
70
- from edsl.jobs.JobsRemoteInferenceLogger import StdOutJobLogger
71
- from edsl.jobs.loggers.HTMLTableJobLogger import HTMLTableJobLogger
72
-
73
- if is_notebook():
74
- self.logger = HTMLTableJobLogger(verbose=self.verbose)
75
- else:
76
- self.logger = StdOutJobLogger(verbose=self.verbose)
77
-
78
- coop = Coop()
79
- self.logger.update(
80
- "Remote inference activated. Sending job to server...",
81
- status=JobsStatus.QUEUED,
82
- )
83
- remote_job_creation_data = coop.remote_inference_create(
84
- self.jobs,
85
- description=remote_inference_description,
86
- status="queued",
87
- iterations=iterations,
88
- initial_results_visibility=remote_inference_results_visibility,
89
- )
90
- self.logger.update(
91
- "Your survey is running at the Expected Parrot server...",
92
- status=JobsStatus.RUNNING,
93
- )
94
-
95
- job_uuid = remote_job_creation_data.get("uuid")
96
- self.logger.update(
97
- message=f"Job sent to server. (Job uuid={job_uuid}).",
98
- status=JobsStatus.RUNNING,
99
- )
100
- self.logger.add_info("job_uuid", job_uuid)
101
-
102
- expected_parrot_url = CONFIG.get("EXPECTED_PARROT_URL")
103
- remote_inference_url = f"{expected_parrot_url}/home/remote-inference"
104
-
105
- self.logger.update(
106
- f"Job details are available at your Coop account {remote_inference_url}{remote_inference_url}",
107
- status=JobsStatus.RUNNING,
108
- )
109
- progress_bar_url = f"{expected_parrot_url}/home/remote-job-progress/{job_uuid}"
110
- self.logger.add_info("progress_bar_url", progress_bar_url)
111
- self.logger.update(
112
- f"View job progress here: {progress_bar_url}", status=JobsStatus.RUNNING
113
- )
114
-
115
- self._remote_job_creation_data = remote_job_creation_data
116
- self._job_uuid = job_uuid
117
-
118
- @staticmethod
119
- def check_status(
120
- job_uuid: JobUUID,
121
- ) -> RemoteInferenceResponse:
122
- from edsl.coop.coop import Coop
123
-
124
- coop = Coop()
125
- return coop.remote_inference_get(job_uuid)
126
-
127
- def poll_remote_inference_job(self) -> Union[None, "Results"]:
128
- return self._poll_remote_inference_job(
129
- self.remote_job_creation_data, verbose=self.verbose
130
- )
131
-
132
- def _poll_remote_inference_job(
133
- self,
134
- remote_job_creation_data: RemoteInferenceCreationInfo,
135
- verbose: bool = False,
136
- poll_interval: Optional[Seconds] = None,
137
- testing_simulated_response=None,
138
- ) -> Union[None, "Results"]:
139
- import time
140
- from datetime import datetime
141
- from edsl.config import CONFIG
142
- from edsl.results.Results import Results
143
-
144
- if poll_interval is None:
145
- poll_interval = self.poll_interval
146
-
147
- job_uuid = remote_job_creation_data.get("uuid")
148
- expected_parrot_url = CONFIG.get("EXPECTED_PARROT_URL")
149
-
150
- if testing_simulated_response is not None:
151
- remote_job_data_fetcher = lambda job_uuid: testing_simulated_response
152
- object_fetcher = (
153
- lambda results_uuid, expected_object_type: Results.example()
154
- )
155
- else:
156
- from edsl.coop.coop import Coop
157
-
158
- coop = Coop()
159
- remote_job_data_fetcher = coop.remote_inference_get
160
- object_fetcher = coop.get
161
-
162
- job_in_queue = True
163
- while job_in_queue:
164
- remote_job_data: RemoteInferenceResponse = remote_job_data_fetcher(job_uuid)
165
- status = remote_job_data.get("status")
166
-
167
- if status == "cancelled":
168
- self.logger.update(
169
- messaged="Job cancelled by the user.", status=JobsStatus.CANCELLED
170
- )
171
- self.logger.update(
172
- f"See {expected_parrot_url}/home/remote-inference for more details.",
173
- status=JobsStatus.CANCELLED,
174
- )
175
- return None
176
-
177
- elif status == "failed":
178
- latest_error_report_url = remote_job_data.get("latest_error_report_url")
179
- if latest_error_report_url:
180
- self.logger.update("Job failed.", status=JobsStatus.FAILED)
181
- self.logger.update(
182
- f"Error report: {latest_error_report_url}", "failed"
183
- )
184
- self.logger.add_info("error_report_url", latest_error_report_url)
185
- self.logger.update(
186
- "Need support? Visit Discord: https://discord.com/invite/mxAYkjfy9m",
187
- status=JobsStatus.FAILED,
188
- )
189
- else:
190
- self.logger.update("Job failed.", "failed")
191
- self.logger.update(
192
- f"See {expected_parrot_url}/home/remote-inference for details.",
193
- status=JobsStatus.FAILED,
194
- )
195
-
196
- results_uuid = remote_job_data.get("results_uuid")
197
- if results_uuid:
198
- self.logger.add_info("results_uuid", results_uuid)
199
- results = object_fetcher(
200
- results_uuid, expected_object_type="results"
201
- )
202
- results.job_uuid = job_uuid
203
- results.results_uuid = results_uuid
204
- return results
205
- else:
206
- return None
207
-
208
- elif status == "completed":
209
- results_uuid = remote_job_data.get("results_uuid")
210
- self.logger.add_info("results_uuid", results_uuid)
211
- results_url = remote_job_data.get("results_url")
212
- self.logger.add_info("results_url", results_url)
213
- results = object_fetcher(results_uuid, expected_object_type="results")
214
- self.logger.update(
215
- f"Job completed and Results stored on Coop: {results_url}",
216
- status=JobsStatus.COMPLETED,
217
- )
218
- results.job_uuid = job_uuid
219
- results.results_uuid = results_uuid
220
- return results
221
-
222
- else:
223
- time_checked = datetime.now().strftime("%Y-%m-%d %I:%M:%S %p")
224
- self.logger.update(
225
- f"Job status: {status} - last update: {time_checked}",
226
- status=JobsStatus.RUNNING,
227
- )
228
- time.sleep(poll_interval)
229
-
230
- def use_remote_inference(self, disable_remote_inference: bool) -> bool:
231
- import requests
232
-
233
- if disable_remote_inference:
234
- return False
235
- if not disable_remote_inference:
236
- try:
237
- from edsl.coop.coop import Coop
238
-
239
- user_edsl_settings = Coop().edsl_settings
240
- return user_edsl_settings.get("remote_inference", False)
241
- except requests.ConnectionError:
242
- pass
243
- except CoopServerResponseError as e:
244
- pass
245
-
246
- return False
247
-
248
- async def create_and_poll_remote_job(
249
- self,
250
- iterations: int = 1,
251
- remote_inference_description: Optional[str] = None,
252
- remote_inference_results_visibility: Optional[VisibilityType] = "unlisted",
253
- ) -> Union["Results", None]:
254
- """
255
- Creates and polls a remote inference job asynchronously.
256
- Reuses existing synchronous methods but runs them in an async context.
257
-
258
- :param iterations: Number of times to run each interview
259
- :param remote_inference_description: Optional description for the remote job
260
- :param remote_inference_results_visibility: Visibility setting for results
261
- :return: Results object if successful, None if job fails or is cancelled
262
- """
263
- import asyncio
264
- from functools import partial
265
-
266
- # Create job using existing method
267
- loop = asyncio.get_event_loop()
268
- remote_job_creation_data = await loop.run_in_executor(
269
- None,
270
- partial(
271
- self.create_remote_inference_job,
272
- iterations=iterations,
273
- remote_inference_description=remote_inference_description,
274
- remote_inference_results_visibility=remote_inference_results_visibility,
275
- ),
276
- )
277
-
278
- # Poll using existing method but with async sleep
279
- return await loop.run_in_executor(
280
- None, partial(self.poll_remote_inference_job, remote_job_creation_data)
281
- )
282
-
283
-
284
- if __name__ == "__main__":
285
- import doctest
286
-
287
- doctest.testmod(optionflags=doctest.ELLIPSIS)
1
+ from typing import Optional, Union, Literal
2
+ import requests
3
+ import sys
4
+ from edsl.exceptions.coop import CoopServerResponseError
5
+
6
+ # from edsl.enums import VisibilityType
7
+ from edsl.results import Results
8
+
9
+
10
+ class JobsRemoteInferenceHandler:
11
+ def __init__(self, jobs, verbose=False, poll_interval=3):
12
+ """
13
+ >>> from edsl.jobs import Jobs
14
+ >>> jh = JobsRemoteInferenceHandler(Jobs.example(), verbose=True)
15
+ >>> jh.use_remote_inference(True)
16
+ False
17
+ >>> jh._poll_remote_inference_job({'uuid':1234}, testing_simulated_response={"status": "failed"}) # doctest: +NORMALIZE_WHITESPACE
18
+ Job failed.
19
+ ...
20
+ >>> jh._poll_remote_inference_job({'uuid':1234}, testing_simulated_response={"status": "completed"}) # doctest: +NORMALIZE_WHITESPACE
21
+ Job completed and Results stored on Coop: None.
22
+ Results(...)
23
+ """
24
+ self.jobs = jobs
25
+ self.verbose = verbose
26
+ self.poll_interval = poll_interval
27
+
28
+ self._remote_job_creation_data = None
29
+ self._job_uuid = None
30
+
31
+ @property
32
+ def remote_job_creation_data(self):
33
+ return self._remote_job_creation_data
34
+
35
+ @property
36
+ def job_uuid(self):
37
+ return self._job_uuid
38
+
39
+ def use_remote_inference(self, disable_remote_inference: bool) -> bool:
40
+ if disable_remote_inference:
41
+ return False
42
+ if not disable_remote_inference:
43
+ try:
44
+ from edsl import Coop
45
+
46
+ user_edsl_settings = Coop().edsl_settings
47
+ return user_edsl_settings.get("remote_inference", False)
48
+ except requests.ConnectionError:
49
+ pass
50
+ except CoopServerResponseError as e:
51
+ pass
52
+
53
+ return False
54
+
55
+ def create_remote_inference_job(
56
+ self,
57
+ iterations: int = 1,
58
+ remote_inference_description: Optional[str] = None,
59
+ remote_inference_results_visibility: Optional["VisibilityType"] = "unlisted",
60
+ verbose=False,
61
+ ):
62
+ """ """
63
+ from edsl.config import CONFIG
64
+ from edsl.coop.coop import Coop
65
+ from rich import print as rich_print
66
+
67
+ coop = Coop()
68
+ print("Remote inference activated. Sending job to server...")
69
+ remote_job_creation_data = coop.remote_inference_create(
70
+ self.jobs,
71
+ description=remote_inference_description,
72
+ status="queued",
73
+ iterations=iterations,
74
+ initial_results_visibility=remote_inference_results_visibility,
75
+ )
76
+ job_uuid = remote_job_creation_data.get("uuid")
77
+ print(f"Job sent to server. (Job uuid={job_uuid}).")
78
+
79
+ expected_parrot_url = CONFIG.get("EXPECTED_PARROT_URL")
80
+ progress_bar_url = f"{expected_parrot_url}/home/remote-job-progress/{job_uuid}"
81
+
82
+ rich_print(
83
+ f"View job progress here: [#38bdf8][link={progress_bar_url}]{progress_bar_url}[/link][/#38bdf8]"
84
+ )
85
+
86
+ self._remote_job_creation_data = remote_job_creation_data
87
+ self._job_uuid = job_uuid
88
+ # return remote_job_creation_data
89
+
90
+ @staticmethod
91
+ def check_status(job_uuid):
92
+ from edsl.coop.coop import Coop
93
+
94
+ coop = Coop()
95
+ return coop.remote_inference_get(job_uuid)
96
+
97
+ def poll_remote_inference_job(self):
98
+ return self._poll_remote_inference_job(
99
+ self.remote_job_creation_data, verbose=self.verbose
100
+ )
101
+
102
+ def _poll_remote_inference_job(
103
+ self,
104
+ remote_job_creation_data: dict,
105
+ verbose=False,
106
+ poll_interval: Optional[float] = None,
107
+ testing_simulated_response: Optional[dict] = None,
108
+ ) -> Union[Results, None]:
109
+ import time
110
+ from datetime import datetime
111
+ from edsl.config import CONFIG
112
+ from edsl.coop.coop import Coop
113
+
114
+ if poll_interval is None:
115
+ poll_interval = self.poll_interval
116
+
117
+ expected_parrot_url = CONFIG.get("EXPECTED_PARROT_URL")
118
+
119
+ job_uuid = remote_job_creation_data.get("uuid")
120
+ coop = Coop()
121
+
122
+ if testing_simulated_response is not None:
123
+ remote_job_data_fetcher = lambda job_uuid: testing_simulated_response
124
+ object_fetcher = (
125
+ lambda results_uuid, expected_object_type: Results.example()
126
+ )
127
+ else:
128
+ remote_job_data_fetcher = coop.remote_inference_get
129
+ object_fetcher = coop.get
130
+
131
+ job_in_queue = True
132
+ while job_in_queue:
133
+ remote_job_data = remote_job_data_fetcher(job_uuid)
134
+ status = remote_job_data.get("status")
135
+ if status == "cancelled":
136
+ print("\r" + " " * 80 + "\r", end="")
137
+ print("Job cancelled by the user.")
138
+ print(
139
+ f"See {expected_parrot_url}/home/remote-inference for more details."
140
+ )
141
+ return None
142
+ elif status == "failed":
143
+ print("\r" + " " * 80 + "\r", end="")
144
+ # write to stderr
145
+ latest_error_report_url = remote_job_data.get("latest_error_report_url")
146
+ if latest_error_report_url:
147
+ print("Job failed.")
148
+ print(
149
+ f"Your job generated exceptions. Details on these exceptions can be found in the following report: {latest_error_report_url}"
150
+ )
151
+ print(
152
+ f"Need support? Post a message at the Expected Parrot Discord channel (https://discord.com/invite/mxAYkjfy9m) or send an email to info@expectedparrot.com."
153
+ )
154
+ else:
155
+ print("Job failed.")
156
+ print(
157
+ f"See {expected_parrot_url}/home/remote-inference for more details."
158
+ )
159
+ return None
160
+ elif status == "completed":
161
+ results_uuid = remote_job_data.get("results_uuid")
162
+ results_url = remote_job_data.get("results_url")
163
+ results = object_fetcher(results_uuid, expected_object_type="results")
164
+ print("\r" + " " * 80 + "\r", end="")
165
+ print(f"Job completed and Results stored on Coop: {results_url}.")
166
+ return results
167
+ else:
168
+ duration = poll_interval
169
+ time_checked = datetime.now().strftime("%Y-%m-%d %I:%M:%S %p")
170
+ frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"]
171
+ start_time = time.time()
172
+ i = 0
173
+ while time.time() - start_time < duration:
174
+ print(
175
+ f"\r{frames[i % len(frames)]} Job status: {status} - last update: {time_checked}",
176
+ end="",
177
+ flush=True,
178
+ )
179
+ time.sleep(0.1)
180
+ i += 1
181
+
182
+ def use_remote_inference(self, disable_remote_inference: bool) -> bool:
183
+ if disable_remote_inference:
184
+ return False
185
+ if not disable_remote_inference:
186
+ try:
187
+ from edsl import Coop
188
+
189
+ user_edsl_settings = Coop().edsl_settings
190
+ return user_edsl_settings.get("remote_inference", False)
191
+ except requests.ConnectionError:
192
+ pass
193
+ except CoopServerResponseError as e:
194
+ pass
195
+
196
+ return False
197
+
198
+ async def create_and_poll_remote_job(
199
+ self,
200
+ iterations: int = 1,
201
+ remote_inference_description: Optional[str] = None,
202
+ remote_inference_results_visibility: Optional[
203
+ Literal["private", "public", "unlisted"]
204
+ ] = "unlisted",
205
+ ) -> Union[Results, None]:
206
+ """
207
+ Creates and polls a remote inference job asynchronously.
208
+ Reuses existing synchronous methods but runs them in an async context.
209
+
210
+ :param iterations: Number of times to run each interview
211
+ :param remote_inference_description: Optional description for the remote job
212
+ :param remote_inference_results_visibility: Visibility setting for results
213
+ :return: Results object if successful, None if job fails or is cancelled
214
+ """
215
+ import asyncio
216
+ from functools import partial
217
+
218
+ # Create job using existing method
219
+ loop = asyncio.get_event_loop()
220
+ remote_job_creation_data = await loop.run_in_executor(
221
+ None,
222
+ partial(
223
+ self.create_remote_inference_job,
224
+ iterations=iterations,
225
+ remote_inference_description=remote_inference_description,
226
+ remote_inference_results_visibility=remote_inference_results_visibility,
227
+ ),
228
+ )
229
+
230
+ # Poll using existing method but with async sleep
231
+ return await loop.run_in_executor(
232
+ None, partial(self.poll_remote_inference_job, remote_job_creation_data)
233
+ )
234
+
235
+
236
+ if __name__ == "__main__":
237
+ import doctest
238
+
239
+ doctest.testmod(optionflags=doctest.ELLIPSIS)
edsl/jobs/__init__.py CHANGED
@@ -1 +1 @@
1
- from edsl.jobs.Jobs import Jobs
1
+ from edsl.jobs.Jobs import Jobs