edsl 0.1.39.dev1__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 (256) hide show
  1. edsl/Base.py +332 -332
  2. edsl/BaseDiff.py +260 -260
  3. edsl/TemplateLoader.py +24 -24
  4. edsl/__init__.py +49 -49
  5. edsl/__version__.py +1 -1
  6. edsl/agents/Agent.py +867 -867
  7. edsl/agents/AgentList.py +413 -413
  8. edsl/agents/Invigilator.py +233 -233
  9. edsl/agents/InvigilatorBase.py +270 -265
  10. edsl/agents/PromptConstructor.py +354 -354
  11. edsl/agents/__init__.py +3 -3
  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 -157
  27. edsl/conversation/Conversation.py +290 -290
  28. edsl/conversation/car_buying.py +58 -58
  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 -1028
  35. edsl/coop/utils.py +131 -131
  36. edsl/data/Cache.py +555 -555
  37. edsl/data/CacheEntry.py +233 -233
  38. edsl/data/CacheHandler.py +149 -149
  39. edsl/data/RemoteCacheSync.py +78 -78
  40. edsl/data/SQLiteDict.py +292 -292
  41. edsl/data/__init__.py +4 -4
  42. edsl/data/orm.py +10 -10
  43. edsl/data_transfer_models.py +73 -73
  44. edsl/enums.py +175 -175
  45. edsl/exceptions/BaseException.py +21 -21
  46. edsl/exceptions/__init__.py +54 -54
  47. edsl/exceptions/agents.py +42 -42
  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 -91
  57. edsl/exceptions/results.py +29 -29
  58. edsl/exceptions/scenarios.py +22 -22
  59. edsl/exceptions/surveys.py +37 -37
  60. edsl/inference_services/AnthropicService.py +87 -87
  61. edsl/inference_services/AwsBedrock.py +120 -120
  62. edsl/inference_services/AzureAI.py +217 -217
  63. edsl/inference_services/DeepInfraService.py +18 -18
  64. edsl/inference_services/GoogleService.py +148 -148
  65. edsl/inference_services/GroqService.py +20 -20
  66. edsl/inference_services/InferenceServiceABC.py +147 -147
  67. edsl/inference_services/InferenceServicesCollection.py +97 -97
  68. edsl/inference_services/MistralAIService.py +123 -123
  69. edsl/inference_services/OllamaService.py +18 -18
  70. edsl/inference_services/OpenAIService.py +224 -224
  71. edsl/inference_services/PerplexityService.py +163 -163
  72. edsl/inference_services/TestService.py +89 -89
  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 -56
  79. edsl/jobs/Jobs.py +898 -898
  80. edsl/jobs/JobsChecks.py +147 -147
  81. edsl/jobs/JobsPrompts.py +268 -268
  82. edsl/jobs/JobsRemoteInferenceHandler.py +239 -239
  83. edsl/jobs/__init__.py +1 -1
  84. edsl/jobs/buckets/BucketCollection.py +63 -63
  85. edsl/jobs/buckets/ModelBuckets.py +65 -65
  86. edsl/jobs/buckets/TokenBucket.py +251 -251
  87. edsl/jobs/interviews/Interview.py +661 -661
  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 -466
  97. edsl/jobs/runners/JobsRunnerStatus.py +330 -330
  98. edsl/jobs/tasks/QuestionTaskCreator.py +242 -242
  99. edsl/jobs/tasks/TaskCreators.py +64 -64
  100. edsl/jobs/tasks/TaskHistory.py +450 -450
  101. edsl/jobs/tasks/TaskStatusLog.py +23 -23
  102. edsl/jobs/tasks/task_status_enum.py +163 -163
  103. edsl/jobs/tokens/InterviewTokenUsage.py +27 -27
  104. edsl/jobs/tokens/TokenUsage.py +34 -34
  105. edsl/language_models/KeyLookup.py +30 -30
  106. edsl/language_models/LanguageModel.py +668 -668
  107. edsl/language_models/ModelList.py +155 -155
  108. edsl/language_models/RegisterLanguageModelsMeta.py +184 -184
  109. edsl/language_models/__init__.py +3 -3
  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 -190
  113. edsl/language_models/repair.py +156 -156
  114. edsl/language_models/unused/ReplicateBase.py +83 -83
  115. edsl/language_models/utilities.py +64 -64
  116. edsl/notebooks/Notebook.py +258 -258
  117. edsl/notebooks/__init__.py +1 -1
  118. edsl/prompts/Prompt.py +362 -362
  119. edsl/prompts/__init__.py +2 -2
  120. edsl/questions/AnswerValidatorMixin.py +289 -289
  121. edsl/questions/QuestionBase.py +664 -664
  122. edsl/questions/QuestionBaseGenMixin.py +161 -161
  123. edsl/questions/QuestionBasePromptsMixin.py +217 -217
  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 -114
  128. edsl/questions/QuestionFunctional.py +166 -166
  129. edsl/questions/QuestionList.py +231 -231
  130. edsl/questions/QuestionMultipleChoice.py +286 -286
  131. edsl/questions/QuestionNumerical.py +153 -153
  132. edsl/questions/QuestionRank.py +324 -324
  133. edsl/questions/Quick.py +41 -41
  134. edsl/questions/RegisterQuestionsMeta.py +71 -71
  135. edsl/questions/ResponseValidatorABC.py +174 -174
  136. edsl/questions/SimpleAskMixin.py +73 -73
  137. edsl/questions/__init__.py +26 -26
  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 -87
  142. edsl/questions/derived/QuestionTopK.py +93 -93
  143. edsl/questions/derived/QuestionYesNo.py +82 -82
  144. edsl/questions/descriptors.py +413 -413
  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 -424
  178. edsl/results/DatasetExportMixin.py +731 -731
  179. edsl/results/DatasetTree.py +275 -275
  180. edsl/results/Result.py +465 -465
  181. edsl/results/Results.py +1165 -1165
  182. edsl/results/ResultsDBMixin.py +238 -238
  183. edsl/results/ResultsExportMixin.py +43 -43
  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 -135
  188. edsl/results/TableDisplay.py +198 -198
  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 -632
  193. edsl/scenarios/Scenario.py +601 -601
  194. edsl/scenarios/ScenarioHtmlMixin.py +64 -64
  195. edsl/scenarios/ScenarioJoin.py +127 -127
  196. edsl/scenarios/ScenarioList.py +1287 -1287
  197. edsl/scenarios/ScenarioListExportMixin.py +52 -52
  198. edsl/scenarios/ScenarioListPdfMixin.py +261 -261
  199. edsl/scenarios/__init__.py +4 -4
  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 -528
  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 -326
  210. edsl/surveys/RuleCollection.py +387 -387
  211. edsl/surveys/Survey.py +1801 -1801
  212. edsl/surveys/SurveyCSS.py +261 -261
  213. edsl/surveys/SurveyExportMixin.py +259 -259
  214. edsl/surveys/SurveyFlowVisualizationMixin.py +179 -179
  215. edsl/surveys/SurveyQualtricsImport.py +284 -284
  216. edsl/surveys/__init__.py +3 -3
  217. edsl/surveys/base.py +53 -53
  218. edsl/surveys/descriptors.py +56 -56
  219. edsl/surveys/instructions/ChangeInstruction.py +49 -49
  220. edsl/surveys/instructions/Instruction.py +65 -65
  221. edsl/surveys/instructions/InstructionCollection.py +77 -77
  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 -424
  252. {edsl-0.1.39.dev1.dist-info → edsl-0.1.39.dev3.dist-info}/LICENSE +21 -21
  253. {edsl-0.1.39.dev1.dist-info → edsl-0.1.39.dev3.dist-info}/METADATA +1 -1
  254. edsl-0.1.39.dev3.dist-info/RECORD +277 -0
  255. edsl-0.1.39.dev1.dist-info/RECORD +0 -277
  256. {edsl-0.1.39.dev1.dist-info → edsl-0.1.39.dev3.dist-info}/WHEEL +0 -0
@@ -1,184 +1,184 @@
1
- from abc import ABC, ABCMeta
2
- from typing import Any, List, Callable
3
- import inspect
4
- from typing import get_type_hints
5
- from edsl.exceptions.language_models import LanguageModelAttributeTypeError
6
- from edsl.enums import InferenceServiceType
7
-
8
-
9
- class RegisterLanguageModelsMeta(ABCMeta):
10
- """Metaclass to register output elements in a registry i.e., those that have a parent."""
11
-
12
- _registry = {} # Initialize the registry as a dictionary
13
- REQUIRED_CLASS_ATTRIBUTES = ["_model_", "_parameters_", "_inference_service_"]
14
-
15
- def __init__(cls, name, bases, dct):
16
- """Register the class in the registry if it has a _model_ attribute."""
17
- super(RegisterLanguageModelsMeta, cls).__init__(name, bases, dct)
18
- # if name != "LanguageModel":
19
- if (model_name := getattr(cls, "_model_", None)) is not None:
20
- RegisterLanguageModelsMeta.check_required_class_variables(
21
- cls, RegisterLanguageModelsMeta.REQUIRED_CLASS_ATTRIBUTES
22
- )
23
-
24
- ## Check that model name is valid
25
- # if not LanguageModelType.is_value_valid(model_name):
26
- # acceptable_values = [item.value for item in LanguageModelType]
27
- # raise LanguageModelAttributeTypeError(
28
- # f"""A LanguageModel's model must be one of {LanguageModelType} values, which are
29
- # {acceptable_values}. You passed {model_name}."""
30
- # )
31
-
32
- if not InferenceServiceType.is_value_valid(
33
- inference_service := getattr(cls, "_inference_service_", None)
34
- ):
35
- acceptable_values = [item.value for item in InferenceServiceType]
36
- raise LanguageModelAttributeTypeError(
37
- f"""A LanguageModel's model must have an _inference_service_ value from
38
- {acceptable_values}. You passed {inference_service}."""
39
- )
40
-
41
- # LanguageModel children have to implement the async_execute_model_call method
42
- RegisterLanguageModelsMeta.verify_method(
43
- candidate_class=cls,
44
- method_name="async_execute_model_call",
45
- expected_return_type=dict[str, Any],
46
- required_parameters=[("user_prompt", str), ("system_prompt", str)],
47
- must_be_async=True,
48
- )
49
- # LanguageModel children have to implement the parse_response method
50
- RegisterLanguageModelsMeta._registry[model_name] = cls
51
-
52
- @classmethod
53
- def get_registered_classes(cls):
54
- """Return the registry."""
55
- return cls._registry
56
-
57
- @staticmethod
58
- def check_required_class_variables(
59
- candidate_class: "LanguageModel", required_attributes: List[str] = None
60
- ):
61
- """Check if a class has the required attributes.
62
-
63
- >>> class M:
64
- ... _model_ = "m"
65
- ... _parameters_ = {}
66
- >>> RegisterLanguageModelsMeta.check_required_class_variables(M, ["_model_", "_parameters_"])
67
- >>> class M2:
68
- ... _model_ = "m"
69
- >>> RegisterLanguageModelsMeta.check_required_class_variables(M2, ["_model_", "_parameters_"])
70
- Traceback (most recent call last):
71
- ...
72
- Exception: Class M2 does not have required attribute _parameters_
73
- """
74
- required_attributes = required_attributes or []
75
- for attribute in required_attributes:
76
- if not hasattr(candidate_class, attribute):
77
- raise Exception(
78
- f"Class {candidate_class.__name__} does not have required attribute {attribute}"
79
- )
80
-
81
- @staticmethod
82
- def verify_method(
83
- candidate_class: "LanguageModel",
84
- method_name: str,
85
- expected_return_type: Any,
86
- required_parameters: List[tuple[str, Any]] = None,
87
- must_be_async: bool = False,
88
- ):
89
- """Verify that a method is defined in a class, has the correct return type, and has the correct parameters."""
90
- RegisterLanguageModelsMeta._check_method_defined(candidate_class, method_name)
91
-
92
- required_parameters = required_parameters or []
93
- method = getattr(candidate_class, method_name)
94
- # signature = inspect.signature(method)
95
-
96
- RegisterLanguageModelsMeta._check_return_type(method, expected_return_type)
97
-
98
- if must_be_async:
99
- RegisterLanguageModelsMeta._check_is_coroutine(method)
100
-
101
- # Check the parameters
102
- # params = signature.parameters
103
- # for param_name, param_type in required_parameters:
104
- # RegisterLanguageModelsMeta._verify_parameter(
105
- # params, param_name, param_type, method_name
106
- # )
107
-
108
- @staticmethod
109
- def _check_method_defined(cls, method_name):
110
- """Check if a method is defined in a class.
111
-
112
- Example:
113
- >>> class M:
114
- ... def f(self): pass
115
- >>> RegisterLanguageModelsMeta._check_method_defined(M, "f")
116
- >>> RegisterLanguageModelsMeta._check_method_defined(M, "g")
117
- Traceback (most recent call last):
118
- ...
119
- NotImplementedError: g method must be implemented.
120
- """
121
- if not hasattr(cls, method_name):
122
- raise NotImplementedError(f"{method_name} method must be implemented.")
123
-
124
- @staticmethod
125
- def _check_is_coroutine(func: Callable):
126
- """Check to make sure it's a coroutine function.
127
-
128
- Example:
129
-
130
- >>> def f(): pass
131
- >>> RegisterLanguageModelsMeta._check_is_coroutine(f)
132
- Traceback (most recent call last):
133
- ...
134
- TypeError: A LangugeModel class with method f must be an asynchronous method.
135
- """
136
- if not inspect.iscoroutinefunction(func):
137
- raise TypeError(
138
- f"A LangugeModel class with method {func.__name__} must be an asynchronous method."
139
- )
140
-
141
- @staticmethod
142
- def _verify_parameter(params, param_name, param_type, method_name):
143
- """Verify that a parameter is defined in a method and has the correct type."""
144
- pass
145
- # if param_name not in params:
146
- # raise TypeError(
147
- # f"""Parameter "{param_name}" of method "{method_name}" must be defined.
148
- # """
149
- # )
150
- # if params[param_name].annotation != param_type:
151
- # raise TypeError(
152
- # f"""Parameter "{param_name}" of method "{method_name}" must be of type {param_type.__name__}.
153
- # Got {params[param_name].annotation} instead.
154
- # """
155
- # )
156
-
157
- @staticmethod
158
- def _check_return_type(method, expected_return_type):
159
- """
160
- Check if the return type of a method is as expected.
161
-
162
- Example:
163
- """
164
- pass
165
- # if inspect.isroutine(method):
166
- # # return_type = inspect.signature(method).return_annotation
167
- # return_type = get_type_hints(method)["return"]
168
- # if return_type != expected_return_type:
169
- # raise TypeError(
170
- # f"Return type of {method.__name__} must be {expected_return_type}. Got {return_type}."
171
- # )
172
-
173
- @classmethod
174
- def model_names_to_classes(cls):
175
- """Return a dictionary of model names to classes."""
176
- d = {}
177
- for classname, cls in cls._registry.items():
178
- if hasattr(cls, "_model_"):
179
- d[cls._model_] = cls
180
- else:
181
- raise Exception(
182
- f"Class {classname} does not have a _model_ class attribute."
183
- )
184
- return d
1
+ from abc import ABC, ABCMeta
2
+ from typing import Any, List, Callable
3
+ import inspect
4
+ from typing import get_type_hints
5
+ from edsl.exceptions.language_models import LanguageModelAttributeTypeError
6
+ from edsl.enums import InferenceServiceType
7
+
8
+
9
+ class RegisterLanguageModelsMeta(ABCMeta):
10
+ """Metaclass to register output elements in a registry i.e., those that have a parent."""
11
+
12
+ _registry = {} # Initialize the registry as a dictionary
13
+ REQUIRED_CLASS_ATTRIBUTES = ["_model_", "_parameters_", "_inference_service_"]
14
+
15
+ def __init__(cls, name, bases, dct):
16
+ """Register the class in the registry if it has a _model_ attribute."""
17
+ super(RegisterLanguageModelsMeta, cls).__init__(name, bases, dct)
18
+ # if name != "LanguageModel":
19
+ if (model_name := getattr(cls, "_model_", None)) is not None:
20
+ RegisterLanguageModelsMeta.check_required_class_variables(
21
+ cls, RegisterLanguageModelsMeta.REQUIRED_CLASS_ATTRIBUTES
22
+ )
23
+
24
+ ## Check that model name is valid
25
+ # if not LanguageModelType.is_value_valid(model_name):
26
+ # acceptable_values = [item.value for item in LanguageModelType]
27
+ # raise LanguageModelAttributeTypeError(
28
+ # f"""A LanguageModel's model must be one of {LanguageModelType} values, which are
29
+ # {acceptable_values}. You passed {model_name}."""
30
+ # )
31
+
32
+ if not InferenceServiceType.is_value_valid(
33
+ inference_service := getattr(cls, "_inference_service_", None)
34
+ ):
35
+ acceptable_values = [item.value for item in InferenceServiceType]
36
+ raise LanguageModelAttributeTypeError(
37
+ f"""A LanguageModel's model must have an _inference_service_ value from
38
+ {acceptable_values}. You passed {inference_service}."""
39
+ )
40
+
41
+ # LanguageModel children have to implement the async_execute_model_call method
42
+ RegisterLanguageModelsMeta.verify_method(
43
+ candidate_class=cls,
44
+ method_name="async_execute_model_call",
45
+ expected_return_type=dict[str, Any],
46
+ required_parameters=[("user_prompt", str), ("system_prompt", str)],
47
+ must_be_async=True,
48
+ )
49
+ # LanguageModel children have to implement the parse_response method
50
+ RegisterLanguageModelsMeta._registry[model_name] = cls
51
+
52
+ @classmethod
53
+ def get_registered_classes(cls):
54
+ """Return the registry."""
55
+ return cls._registry
56
+
57
+ @staticmethod
58
+ def check_required_class_variables(
59
+ candidate_class: "LanguageModel", required_attributes: List[str] = None
60
+ ):
61
+ """Check if a class has the required attributes.
62
+
63
+ >>> class M:
64
+ ... _model_ = "m"
65
+ ... _parameters_ = {}
66
+ >>> RegisterLanguageModelsMeta.check_required_class_variables(M, ["_model_", "_parameters_"])
67
+ >>> class M2:
68
+ ... _model_ = "m"
69
+ >>> RegisterLanguageModelsMeta.check_required_class_variables(M2, ["_model_", "_parameters_"])
70
+ Traceback (most recent call last):
71
+ ...
72
+ Exception: Class M2 does not have required attribute _parameters_
73
+ """
74
+ required_attributes = required_attributes or []
75
+ for attribute in required_attributes:
76
+ if not hasattr(candidate_class, attribute):
77
+ raise Exception(
78
+ f"Class {candidate_class.__name__} does not have required attribute {attribute}"
79
+ )
80
+
81
+ @staticmethod
82
+ def verify_method(
83
+ candidate_class: "LanguageModel",
84
+ method_name: str,
85
+ expected_return_type: Any,
86
+ required_parameters: List[tuple[str, Any]] = None,
87
+ must_be_async: bool = False,
88
+ ):
89
+ """Verify that a method is defined in a class, has the correct return type, and has the correct parameters."""
90
+ RegisterLanguageModelsMeta._check_method_defined(candidate_class, method_name)
91
+
92
+ required_parameters = required_parameters or []
93
+ method = getattr(candidate_class, method_name)
94
+ # signature = inspect.signature(method)
95
+
96
+ RegisterLanguageModelsMeta._check_return_type(method, expected_return_type)
97
+
98
+ if must_be_async:
99
+ RegisterLanguageModelsMeta._check_is_coroutine(method)
100
+
101
+ # Check the parameters
102
+ # params = signature.parameters
103
+ # for param_name, param_type in required_parameters:
104
+ # RegisterLanguageModelsMeta._verify_parameter(
105
+ # params, param_name, param_type, method_name
106
+ # )
107
+
108
+ @staticmethod
109
+ def _check_method_defined(cls, method_name):
110
+ """Check if a method is defined in a class.
111
+
112
+ Example:
113
+ >>> class M:
114
+ ... def f(self): pass
115
+ >>> RegisterLanguageModelsMeta._check_method_defined(M, "f")
116
+ >>> RegisterLanguageModelsMeta._check_method_defined(M, "g")
117
+ Traceback (most recent call last):
118
+ ...
119
+ NotImplementedError: g method must be implemented.
120
+ """
121
+ if not hasattr(cls, method_name):
122
+ raise NotImplementedError(f"{method_name} method must be implemented.")
123
+
124
+ @staticmethod
125
+ def _check_is_coroutine(func: Callable):
126
+ """Check to make sure it's a coroutine function.
127
+
128
+ Example:
129
+
130
+ >>> def f(): pass
131
+ >>> RegisterLanguageModelsMeta._check_is_coroutine(f)
132
+ Traceback (most recent call last):
133
+ ...
134
+ TypeError: A LangugeModel class with method f must be an asynchronous method.
135
+ """
136
+ if not inspect.iscoroutinefunction(func):
137
+ raise TypeError(
138
+ f"A LangugeModel class with method {func.__name__} must be an asynchronous method."
139
+ )
140
+
141
+ @staticmethod
142
+ def _verify_parameter(params, param_name, param_type, method_name):
143
+ """Verify that a parameter is defined in a method and has the correct type."""
144
+ pass
145
+ # if param_name not in params:
146
+ # raise TypeError(
147
+ # f"""Parameter "{param_name}" of method "{method_name}" must be defined.
148
+ # """
149
+ # )
150
+ # if params[param_name].annotation != param_type:
151
+ # raise TypeError(
152
+ # f"""Parameter "{param_name}" of method "{method_name}" must be of type {param_type.__name__}.
153
+ # Got {params[param_name].annotation} instead.
154
+ # """
155
+ # )
156
+
157
+ @staticmethod
158
+ def _check_return_type(method, expected_return_type):
159
+ """
160
+ Check if the return type of a method is as expected.
161
+
162
+ Example:
163
+ """
164
+ pass
165
+ # if inspect.isroutine(method):
166
+ # # return_type = inspect.signature(method).return_annotation
167
+ # return_type = get_type_hints(method)["return"]
168
+ # if return_type != expected_return_type:
169
+ # raise TypeError(
170
+ # f"Return type of {method.__name__} must be {expected_return_type}. Got {return_type}."
171
+ # )
172
+
173
+ @classmethod
174
+ def model_names_to_classes(cls):
175
+ """Return a dictionary of model names to classes."""
176
+ d = {}
177
+ for classname, cls in cls._registry.items():
178
+ if hasattr(cls, "_model_"):
179
+ d[cls._model_] = cls
180
+ else:
181
+ raise Exception(
182
+ f"Class {classname} does not have a _model_ class attribute."
183
+ )
184
+ return d
@@ -1,3 +1,3 @@
1
- from edsl.language_models.LanguageModel import LanguageModel
2
- from edsl.language_models.registry import Model
3
- from edsl.language_models.KeyLookup import KeyLookup
1
+ from edsl.language_models.LanguageModel import LanguageModel
2
+ from edsl.language_models.registry import Model
3
+ from edsl.language_models.KeyLookup import KeyLookup
@@ -1,15 +1,15 @@
1
- from openai import AsyncOpenAI
2
- import asyncio
3
-
4
- client = AsyncOpenAI(base_url="http://127.0.0.1:8000/v1", api_key="fake_key")
5
-
6
-
7
- async def main():
8
- response = await client.chat.completions.create(
9
- model="gpt-3.5-turbo", messages=[{"role": "user", "content": "Question XX42"}]
10
- )
11
- print(response)
12
-
13
-
14
- if __name__ == "__main__":
15
- asyncio.run(main())
1
+ from openai import AsyncOpenAI
2
+ import asyncio
3
+
4
+ client = AsyncOpenAI(base_url="http://127.0.0.1:8000/v1", api_key="fake_key")
5
+
6
+
7
+ async def main():
8
+ response = await client.chat.completions.create(
9
+ model="gpt-3.5-turbo", messages=[{"role": "user", "content": "Question XX42"}]
10
+ )
11
+ print(response)
12
+
13
+
14
+ if __name__ == "__main__":
15
+ asyncio.run(main())
@@ -1,61 +1,61 @@
1
- import threading
2
- import asyncio
3
- from fastapi import FastAPI, Request
4
- from fastapi.responses import JSONResponse
5
- import uvicorn
6
- import json
7
- from typing import Any
8
-
9
- app = FastAPI()
10
-
11
-
12
- async def generate_response(question_number: int) -> dict:
13
- # Simulate some asynchronous work
14
- await asyncio.sleep(1)
15
- return {
16
- "id": "chatcmpl-123",
17
- "object": "chat.completion",
18
- "created": 1677652288,
19
- "model": "gpt-3.5-turbo-0613",
20
- "choices": [
21
- {
22
- "index": 0,
23
- "message": {
24
- "role": "assistant",
25
- "content": json.dumps(
26
- {"answer": f"SPAM for question {question_number}!"}
27
- ),
28
- },
29
- "finish_reason": "stop",
30
- }
31
- ],
32
- "usage": {"prompt_tokens": 9, "completion_tokens": 12, "total_tokens": 21},
33
- }
34
-
35
-
36
- @app.post("/v1/chat/completions")
37
- async def chat_completions(request: Request):
38
- body = await request.json()
39
- user_prompt = body["messages"][-1]["content"]
40
- question_number = int(user_prompt.split("XX")[1])
41
-
42
- response = await generate_response(question_number)
43
- return JSONResponse(content=response)
44
-
45
-
46
- def run_server():
47
- uvicorn.run(app, host="127.0.0.1", port=8000)
48
-
49
-
50
- if __name__ == "__main__":
51
- # Start the server in a separate thread
52
- server_thread = threading.Thread(target=run_server)
53
- server_thread.start()
54
-
55
- # Your main code here
56
- # ...
57
-
58
- # To use this with the OpenAI SDK:
59
- # from openai import AsyncOpenAI
60
- # client = AsyncOpenAI(base_url="http://127.0.0.1:8000/v1", api_key="fake_key")
61
- # response = await client.chat.completions.create(model="gpt-3.5-turbo", messages=[...])
1
+ import threading
2
+ import asyncio
3
+ from fastapi import FastAPI, Request
4
+ from fastapi.responses import JSONResponse
5
+ import uvicorn
6
+ import json
7
+ from typing import Any
8
+
9
+ app = FastAPI()
10
+
11
+
12
+ async def generate_response(question_number: int) -> dict:
13
+ # Simulate some asynchronous work
14
+ await asyncio.sleep(1)
15
+ return {
16
+ "id": "chatcmpl-123",
17
+ "object": "chat.completion",
18
+ "created": 1677652288,
19
+ "model": "gpt-3.5-turbo-0613",
20
+ "choices": [
21
+ {
22
+ "index": 0,
23
+ "message": {
24
+ "role": "assistant",
25
+ "content": json.dumps(
26
+ {"answer": f"SPAM for question {question_number}!"}
27
+ ),
28
+ },
29
+ "finish_reason": "stop",
30
+ }
31
+ ],
32
+ "usage": {"prompt_tokens": 9, "completion_tokens": 12, "total_tokens": 21},
33
+ }
34
+
35
+
36
+ @app.post("/v1/chat/completions")
37
+ async def chat_completions(request: Request):
38
+ body = await request.json()
39
+ user_prompt = body["messages"][-1]["content"]
40
+ question_number = int(user_prompt.split("XX")[1])
41
+
42
+ response = await generate_response(question_number)
43
+ return JSONResponse(content=response)
44
+
45
+
46
+ def run_server():
47
+ uvicorn.run(app, host="127.0.0.1", port=8000)
48
+
49
+
50
+ if __name__ == "__main__":
51
+ # Start the server in a separate thread
52
+ server_thread = threading.Thread(target=run_server)
53
+ server_thread.start()
54
+
55
+ # Your main code here
56
+ # ...
57
+
58
+ # To use this with the OpenAI SDK:
59
+ # from openai import AsyncOpenAI
60
+ # client = AsyncOpenAI(base_url="http://127.0.0.1:8000/v1", api_key="fake_key")
61
+ # response = await client.chat.completions.create(model="gpt-3.5-turbo", messages=[...])