levelfour 0.1.0__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 (208) hide show
  1. levelfour/__init__.py +495 -0
  2. levelfour/api_keys/__init__.py +34 -0
  3. levelfour/api_keys/client.py +337 -0
  4. levelfour/api_keys/raw_client.py +621 -0
  5. levelfour/api_keys/types/__init__.py +34 -0
  6. levelfour/api_keys/types/create_api_key_request_scope.py +5 -0
  7. levelfour/async_levelfour_client.py +39 -0
  8. levelfour/base_client.py +346 -0
  9. levelfour/client.py +54 -0
  10. levelfour/core/__init__.py +127 -0
  11. levelfour/core/api_error.py +23 -0
  12. levelfour/core/client_wrapper.py +105 -0
  13. levelfour/core/datetime_utils.py +70 -0
  14. levelfour/core/file.py +67 -0
  15. levelfour/core/force_multipart.py +18 -0
  16. levelfour/core/http_client.py +776 -0
  17. levelfour/core/http_response.py +59 -0
  18. levelfour/core/http_sse/__init__.py +42 -0
  19. levelfour/core/http_sse/_api.py +112 -0
  20. levelfour/core/http_sse/_decoders.py +61 -0
  21. levelfour/core/http_sse/_exceptions.py +7 -0
  22. levelfour/core/http_sse/_models.py +17 -0
  23. levelfour/core/jsonable_encoder.py +108 -0
  24. levelfour/core/logging.py +107 -0
  25. levelfour/core/pagination.py +82 -0
  26. levelfour/core/pydantic_utilities.py +577 -0
  27. levelfour/core/query_encoder.py +58 -0
  28. levelfour/core/remove_none_from_dict.py +11 -0
  29. levelfour/core/request_options.py +35 -0
  30. levelfour/core/serialization.py +276 -0
  31. levelfour/errors/__init__.py +40 -0
  32. levelfour/errors/forbidden_error.py +11 -0
  33. levelfour/errors/unauthorized_error.py +11 -0
  34. levelfour/errors/unprocessable_entity_error.py +11 -0
  35. levelfour/evaluation/__init__.py +4 -0
  36. levelfour/evaluation/client.py +102 -0
  37. levelfour/evaluation/raw_client.py +141 -0
  38. levelfour/exceptions.py +63 -0
  39. levelfour/health/__init__.py +4 -0
  40. levelfour/health/client.py +163 -0
  41. levelfour/health/raw_client.py +164 -0
  42. levelfour/integrations/__init__.py +0 -0
  43. levelfour/integrations/django.py +26 -0
  44. levelfour/integrations/fastapi.py +39 -0
  45. levelfour/integrations/telemetry.py +66 -0
  46. levelfour/levelfour_client.py +47 -0
  47. levelfour/pagination.py +84 -0
  48. levelfour/pr_analysis/__init__.py +4 -0
  49. levelfour/pr_analysis/client.py +408 -0
  50. levelfour/pr_analysis/raw_client.py +620 -0
  51. levelfour/pr_analysis_actions/__init__.py +4 -0
  52. levelfour/pr_analysis_actions/client.py +588 -0
  53. levelfour/pr_analysis_actions/raw_client.py +939 -0
  54. levelfour/pr_analysis_installations/__init__.py +4 -0
  55. levelfour/pr_analysis_installations/client.py +470 -0
  56. levelfour/pr_analysis_installations/raw_client.py +868 -0
  57. levelfour/providers/__init__.py +34 -0
  58. levelfour/providers/client.py +1504 -0
  59. levelfour/providers/raw_client.py +2398 -0
  60. levelfour/providers/types/__init__.py +36 -0
  61. levelfour/providers/types/list_spending_breakdown_providers_response.py +11 -0
  62. levelfour/py.typed +0 -0
  63. levelfour/recommendations/__init__.py +4 -0
  64. levelfour/recommendations/client.py +1018 -0
  65. levelfour/recommendations/raw_client.py +1810 -0
  66. levelfour/savings/__init__.py +4 -0
  67. levelfour/savings/client.py +401 -0
  68. levelfour/savings/raw_client.py +624 -0
  69. levelfour/spending/__init__.py +34 -0
  70. levelfour/spending/client.py +437 -0
  71. levelfour/spending/raw_client.py +684 -0
  72. levelfour/spending/types/__init__.py +34 -0
  73. levelfour/spending/types/list_breakdown_spending_response.py +12 -0
  74. levelfour/types/__init__.py +413 -0
  75. levelfour/types/accept_terms_data.py +25 -0
  76. levelfour/types/accept_terms_response.py +27 -0
  77. levelfour/types/action_request.py +42 -0
  78. levelfour/types/api_key_created_data.py +28 -0
  79. levelfour/types/api_key_data.py +27 -0
  80. levelfour/types/authentication_error.py +5 -0
  81. levelfour/types/authorization_error.py +5 -0
  82. levelfour/types/bad_request_error.py +5 -0
  83. levelfour/types/comparison_item.py +32 -0
  84. levelfour/types/complete_wizard_data.py +27 -0
  85. levelfour/types/complete_wizard_response.py +27 -0
  86. levelfour/types/conflict_error.py +5 -0
  87. levelfour/types/cost_breakdown_data.py +35 -0
  88. levelfour/types/cost_breakdown_item.py +71 -0
  89. levelfour/types/cost_breakdown_raw_data.py +37 -0
  90. levelfour/types/cost_breakdown_raw_response.py +27 -0
  91. levelfour/types/cost_breakdown_response.py +27 -0
  92. levelfour/types/costs_breakdown_chart_data.py +48 -0
  93. levelfour/types/costs_breakdown_chart_response.py +27 -0
  94. levelfour/types/costs_breakdown_data_point.py +46 -0
  95. levelfour/types/costs_breakdown_grouped_chart_data.py +52 -0
  96. levelfour/types/costs_breakdown_grouped_chart_response.py +27 -0
  97. levelfour/types/costs_breakdown_grouped_data_point.py +36 -0
  98. levelfour/types/costs_breakdown_totals.py +41 -0
  99. levelfour/types/create_api_key_response.py +23 -0
  100. levelfour/types/daily_spending_breakdown_data.py +42 -0
  101. levelfour/types/daily_spending_breakdown_response.py +27 -0
  102. levelfour/types/daily_spending_data_point.py +31 -0
  103. levelfour/types/dashboard_summary_data.py +72 -0
  104. levelfour/types/dashboard_summary_response.py +27 -0
  105. levelfour/types/delete_endpoint_data.py +20 -0
  106. levelfour/types/delete_endpoint_response.py +23 -0
  107. levelfour/types/endpoint_data.py +23 -0
  108. levelfour/types/error_response.py +23 -0
  109. levelfour/types/error_response_error.py +21 -0
  110. levelfour/types/evaluation_status_data.py +71 -0
  111. levelfour/types/evaluation_status_response.py +27 -0
  112. levelfour/types/execution_log_command.py +21 -0
  113. levelfour/types/execution_log_entry.py +23 -0
  114. levelfour/types/execution_step_schema.py +23 -0
  115. levelfour/types/http_validation_error.py +20 -0
  116. levelfour/types/implementation_method_data.py +25 -0
  117. levelfour/types/implementation_method_response.py +27 -0
  118. levelfour/types/implementation_step.py +27 -0
  119. levelfour/types/internal_server_error.py +5 -0
  120. levelfour/types/list_api_keys_data.py +21 -0
  121. levelfour/types/list_api_keys_response.py +23 -0
  122. levelfour/types/list_endpoints_response.py +23 -0
  123. levelfour/types/metric_data_point.py +27 -0
  124. levelfour/types/metric_series.py +40 -0
  125. levelfour/types/metric_series_entry.py +25 -0
  126. levelfour/types/monthly_spending_data.py +27 -0
  127. levelfour/types/monthly_spending_data_point.py +31 -0
  128. levelfour/types/monthly_spending_response.py +27 -0
  129. levelfour/types/not_found_error.py +5 -0
  130. levelfour/types/pagination_meta.py +51 -0
  131. levelfour/types/processing_recommendation_item.py +61 -0
  132. levelfour/types/processing_recommendations_data.py +28 -0
  133. levelfour/types/processing_recommendations_response.py +27 -0
  134. levelfour/types/provider.py +46 -0
  135. levelfour/types/provider_breakdown_data.py +31 -0
  136. levelfour/types/provider_breakdown_item.py +77 -0
  137. levelfour/types/provider_breakdown_response.py +27 -0
  138. levelfour/types/provider_filter_options_data.py +51 -0
  139. levelfour/types/provider_filter_options_response.py +27 -0
  140. levelfour/types/provider_potential_savings_summary_data.py +46 -0
  141. levelfour/types/provider_potential_savings_summary_response.py +27 -0
  142. levelfour/types/provider_recommendations_summary_data.py +37 -0
  143. levelfour/types/provider_recommendations_summary_response.py +27 -0
  144. levelfour/types/provider_saved_summary_data.py +56 -0
  145. levelfour/types/provider_saved_summary_response.py +27 -0
  146. levelfour/types/provider_service_breakdown_data.py +65 -0
  147. levelfour/types/provider_service_breakdown_item.py +72 -0
  148. levelfour/types/provider_service_breakdown_raw_data.py +62 -0
  149. levelfour/types/provider_service_breakdown_raw_response.py +27 -0
  150. levelfour/types/provider_service_breakdown_response.py +27 -0
  151. levelfour/types/provider_service_costs_breakdown_data.py +62 -0
  152. levelfour/types/provider_service_costs_breakdown_response.py +27 -0
  153. levelfour/types/provider_service_costs_data_point.py +36 -0
  154. levelfour/types/provider_spending.py +61 -0
  155. levelfour/types/provider_spending_summary_data.py +67 -0
  156. levelfour/types/provider_spending_summary_response.py +27 -0
  157. levelfour/types/provider_timeline_data.py +57 -0
  158. levelfour/types/provider_timeline_response.py +27 -0
  159. levelfour/types/provider_top_service.py +36 -0
  160. levelfour/types/providers_summary_data.py +24 -0
  161. levelfour/types/providers_summary_response.py +27 -0
  162. levelfour/types/rate_limit_error.py +5 -0
  163. levelfour/types/recommendation_actions.py +60 -0
  164. levelfour/types/recommendation_detail.py +42 -0
  165. levelfour/types/recommendation_detail_response.py +27 -0
  166. levelfour/types/recommendation_filter_options_data.py +41 -0
  167. levelfour/types/recommendation_filter_options_response.py +27 -0
  168. levelfour/types/recommendation_item.py +36 -0
  169. levelfour/types/recommendation_wizard_data.py +173 -0
  170. levelfour/types/recommendation_wizard_data_metrics.py +7 -0
  171. levelfour/types/recommendation_wizard_response.py +27 -0
  172. levelfour/types/recommendations_breakdown_data.py +26 -0
  173. levelfour/types/recommendations_breakdown_response.py +27 -0
  174. levelfour/types/recommendations_overview_data.py +51 -0
  175. levelfour/types/recommendations_overview_response.py +27 -0
  176. levelfour/types/register_endpoint_response.py +23 -0
  177. levelfour/types/resource_change.py +42 -0
  178. levelfour/types/resource_snapshot.py +21 -0
  179. levelfour/types/revoke_api_key_data.py +20 -0
  180. levelfour/types/revoke_api_key_response.py +23 -0
  181. levelfour/types/risk_assessment.py +29 -0
  182. levelfour/types/risk_factor.py +27 -0
  183. levelfour/types/saved_breakdown_data.py +31 -0
  184. levelfour/types/saved_breakdown_response.py +27 -0
  185. levelfour/types/saved_by_provider_breakdown_data.py +31 -0
  186. levelfour/types/saved_by_provider_breakdown_response.py +27 -0
  187. levelfour/types/saved_by_provider_item.py +76 -0
  188. levelfour/types/saved_item.py +35 -0
  189. levelfour/types/saved_provider_summary.py +36 -0
  190. levelfour/types/saved_summary_data.py +57 -0
  191. levelfour/types/saved_summary_response.py +27 -0
  192. levelfour/types/savings_decision_data.py +28 -0
  193. levelfour/types/savings_decision_response.py +27 -0
  194. levelfour/types/spending_by_date_item.py +36 -0
  195. levelfour/types/top_recommendation.py +56 -0
  196. levelfour/types/trigger_info.py +22 -0
  197. levelfour/types/update_tag_data.py +20 -0
  198. levelfour/types/update_tag_response.py +23 -0
  199. levelfour/types/validation_error.py +24 -0
  200. levelfour/types/validation_error_loc_item.py +5 -0
  201. levelfour/webhooks/__init__.py +4 -0
  202. levelfour/webhooks/client.py +273 -0
  203. levelfour/webhooks/raw_client.py +483 -0
  204. levelfour/webhooks/verifier.py +61 -0
  205. levelfour-0.1.0.dist-info/METADATA +12 -0
  206. levelfour-0.1.0.dist-info/RECORD +208 -0
  207. levelfour-0.1.0.dist-info/WHEEL +5 -0
  208. levelfour-0.1.0.dist-info/top_level.txt +1 -0
@@ -0,0 +1,620 @@
1
+ # This file was auto-generated by Fern from our API Definition.
2
+
3
+ import typing
4
+ from json.decoder import JSONDecodeError
5
+
6
+ from ..core.api_error import ApiError
7
+ from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
8
+ from ..core.http_response import AsyncHttpResponse, HttpResponse
9
+ from ..core.pydantic_utilities import parse_obj_as
10
+ from ..core.request_options import RequestOptions
11
+ from ..core.serialization import convert_and_respect_annotation_metadata
12
+ from ..errors.forbidden_error import ForbiddenError
13
+ from ..errors.unauthorized_error import UnauthorizedError
14
+ from ..errors.unprocessable_entity_error import UnprocessableEntityError
15
+ from ..types.authentication_error import AuthenticationError
16
+ from ..types.authorization_error import AuthorizationError
17
+ from ..types.http_validation_error import HttpValidationError
18
+ from ..types.resource_change import ResourceChange
19
+ from ..types.resource_snapshot import ResourceSnapshot
20
+
21
+ # this is used as the default value for optional parameters
22
+ OMIT = typing.cast(typing.Any, ...)
23
+
24
+
25
+ class RawPrAnalysisClient:
26
+ def __init__(self, *, client_wrapper: SyncClientWrapper):
27
+ self._client_wrapper = client_wrapper
28
+
29
+ def analyze(
30
+ self,
31
+ *,
32
+ repository: str,
33
+ pr_number: int,
34
+ resource_changes: typing.Sequence[ResourceChange],
35
+ head_resources: typing.Optional[typing.Sequence[ResourceSnapshot]] = OMIT,
36
+ region: typing.Optional[str] = OMIT,
37
+ head_sha: typing.Optional[str] = OMIT,
38
+ request_options: typing.Optional[RequestOptions] = None,
39
+ ) -> HttpResponse[typing.Any]:
40
+ """
41
+ Parameters
42
+ ----------
43
+ repository : str
44
+ GitHub repository full name, e.g. acme/infrastructure
45
+
46
+ pr_number : int
47
+ Pull request number
48
+
49
+ resource_changes : typing.Sequence[ResourceChange]
50
+ List of Terraform resource changes
51
+
52
+ head_resources : typing.Optional[typing.Sequence[ResourceSnapshot]]
53
+
54
+ region : typing.Optional[str]
55
+
56
+ head_sha : typing.Optional[str]
57
+
58
+ request_options : typing.Optional[RequestOptions]
59
+ Request-specific configuration.
60
+
61
+ Returns
62
+ -------
63
+ HttpResponse[typing.Any]
64
+ Successful Response
65
+ """
66
+ _response = self._client_wrapper.httpx_client.request(
67
+ "api/v1/pr-analysis/analyze",
68
+ method="POST",
69
+ json={
70
+ "repository": repository,
71
+ "pr_number": pr_number,
72
+ "resource_changes": convert_and_respect_annotation_metadata(
73
+ object_=resource_changes, annotation=typing.Sequence[ResourceChange], direction="write"
74
+ ),
75
+ "head_resources": convert_and_respect_annotation_metadata(
76
+ object_=head_resources, annotation=typing.Sequence[ResourceSnapshot], direction="write"
77
+ ),
78
+ "region": region,
79
+ "head_sha": head_sha,
80
+ },
81
+ headers={
82
+ "content-type": "application/json",
83
+ },
84
+ request_options=request_options,
85
+ omit=OMIT,
86
+ )
87
+ try:
88
+ if _response is None or not _response.text.strip():
89
+ return HttpResponse(response=_response, data=None)
90
+ if 200 <= _response.status_code < 300:
91
+ _data = typing.cast(
92
+ typing.Any,
93
+ parse_obj_as(
94
+ type_=typing.Any, # type: ignore
95
+ object_=_response.json(),
96
+ ),
97
+ )
98
+ return HttpResponse(response=_response, data=_data)
99
+ if _response.status_code == 401:
100
+ raise UnauthorizedError(
101
+ headers=dict(_response.headers),
102
+ body=typing.cast(
103
+ AuthenticationError,
104
+ parse_obj_as(
105
+ type_=AuthenticationError, # type: ignore
106
+ object_=_response.json(),
107
+ ),
108
+ ),
109
+ )
110
+ if _response.status_code == 403:
111
+ raise ForbiddenError(
112
+ headers=dict(_response.headers),
113
+ body=typing.cast(
114
+ AuthorizationError,
115
+ parse_obj_as(
116
+ type_=AuthorizationError, # type: ignore
117
+ object_=_response.json(),
118
+ ),
119
+ ),
120
+ )
121
+ if _response.status_code == 422:
122
+ raise UnprocessableEntityError(
123
+ headers=dict(_response.headers),
124
+ body=typing.cast(
125
+ HttpValidationError,
126
+ parse_obj_as(
127
+ type_=HttpValidationError, # type: ignore
128
+ object_=_response.json(),
129
+ ),
130
+ ),
131
+ )
132
+ _response_json = _response.json()
133
+ except JSONDecodeError:
134
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
135
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
136
+
137
+ def explain(
138
+ self,
139
+ *,
140
+ repository: str,
141
+ pr_number: int,
142
+ resource_key: str,
143
+ request_options: typing.Optional[RequestOptions] = None,
144
+ ) -> HttpResponse[typing.Any]:
145
+ """
146
+ Parameters
147
+ ----------
148
+ repository : str
149
+
150
+ pr_number : int
151
+
152
+ resource_key : str
153
+
154
+ request_options : typing.Optional[RequestOptions]
155
+ Request-specific configuration.
156
+
157
+ Returns
158
+ -------
159
+ HttpResponse[typing.Any]
160
+ Successful Response
161
+ """
162
+ _response = self._client_wrapper.httpx_client.request(
163
+ "api/v1/pr-analysis/explain",
164
+ method="POST",
165
+ json={
166
+ "repository": repository,
167
+ "pr_number": pr_number,
168
+ "resource_key": resource_key,
169
+ },
170
+ headers={
171
+ "content-type": "application/json",
172
+ },
173
+ request_options=request_options,
174
+ omit=OMIT,
175
+ )
176
+ try:
177
+ if _response is None or not _response.text.strip():
178
+ return HttpResponse(response=_response, data=None)
179
+ if 200 <= _response.status_code < 300:
180
+ _data = typing.cast(
181
+ typing.Any,
182
+ parse_obj_as(
183
+ type_=typing.Any, # type: ignore
184
+ object_=_response.json(),
185
+ ),
186
+ )
187
+ return HttpResponse(response=_response, data=_data)
188
+ if _response.status_code == 401:
189
+ raise UnauthorizedError(
190
+ headers=dict(_response.headers),
191
+ body=typing.cast(
192
+ AuthenticationError,
193
+ parse_obj_as(
194
+ type_=AuthenticationError, # type: ignore
195
+ object_=_response.json(),
196
+ ),
197
+ ),
198
+ )
199
+ if _response.status_code == 403:
200
+ raise ForbiddenError(
201
+ headers=dict(_response.headers),
202
+ body=typing.cast(
203
+ AuthorizationError,
204
+ parse_obj_as(
205
+ type_=AuthorizationError, # type: ignore
206
+ object_=_response.json(),
207
+ ),
208
+ ),
209
+ )
210
+ if _response.status_code == 422:
211
+ raise UnprocessableEntityError(
212
+ headers=dict(_response.headers),
213
+ body=typing.cast(
214
+ HttpValidationError,
215
+ parse_obj_as(
216
+ type_=HttpValidationError, # type: ignore
217
+ object_=_response.json(),
218
+ ),
219
+ ),
220
+ )
221
+ _response_json = _response.json()
222
+ except JSONDecodeError:
223
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
224
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
225
+
226
+ def whatif(
227
+ self,
228
+ *,
229
+ repository: str,
230
+ pr_number: int,
231
+ resource_key: str,
232
+ attribute: str,
233
+ hypothetical_value: str,
234
+ request_options: typing.Optional[RequestOptions] = None,
235
+ ) -> HttpResponse[typing.Any]:
236
+ """
237
+ Parameters
238
+ ----------
239
+ repository : str
240
+
241
+ pr_number : int
242
+
243
+ resource_key : str
244
+
245
+ attribute : str
246
+
247
+ hypothetical_value : str
248
+
249
+ request_options : typing.Optional[RequestOptions]
250
+ Request-specific configuration.
251
+
252
+ Returns
253
+ -------
254
+ HttpResponse[typing.Any]
255
+ Successful Response
256
+ """
257
+ _response = self._client_wrapper.httpx_client.request(
258
+ "api/v1/pr-analysis/whatif",
259
+ method="POST",
260
+ json={
261
+ "repository": repository,
262
+ "pr_number": pr_number,
263
+ "resource_key": resource_key,
264
+ "attribute": attribute,
265
+ "hypothetical_value": hypothetical_value,
266
+ },
267
+ headers={
268
+ "content-type": "application/json",
269
+ },
270
+ request_options=request_options,
271
+ omit=OMIT,
272
+ )
273
+ try:
274
+ if _response is None or not _response.text.strip():
275
+ return HttpResponse(response=_response, data=None)
276
+ if 200 <= _response.status_code < 300:
277
+ _data = typing.cast(
278
+ typing.Any,
279
+ parse_obj_as(
280
+ type_=typing.Any, # type: ignore
281
+ object_=_response.json(),
282
+ ),
283
+ )
284
+ return HttpResponse(response=_response, data=_data)
285
+ if _response.status_code == 401:
286
+ raise UnauthorizedError(
287
+ headers=dict(_response.headers),
288
+ body=typing.cast(
289
+ AuthenticationError,
290
+ parse_obj_as(
291
+ type_=AuthenticationError, # type: ignore
292
+ object_=_response.json(),
293
+ ),
294
+ ),
295
+ )
296
+ if _response.status_code == 403:
297
+ raise ForbiddenError(
298
+ headers=dict(_response.headers),
299
+ body=typing.cast(
300
+ AuthorizationError,
301
+ parse_obj_as(
302
+ type_=AuthorizationError, # type: ignore
303
+ object_=_response.json(),
304
+ ),
305
+ ),
306
+ )
307
+ if _response.status_code == 422:
308
+ raise UnprocessableEntityError(
309
+ headers=dict(_response.headers),
310
+ body=typing.cast(
311
+ HttpValidationError,
312
+ parse_obj_as(
313
+ type_=HttpValidationError, # type: ignore
314
+ object_=_response.json(),
315
+ ),
316
+ ),
317
+ )
318
+ _response_json = _response.json()
319
+ except JSONDecodeError:
320
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
321
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
322
+
323
+
324
+ class AsyncRawPrAnalysisClient:
325
+ def __init__(self, *, client_wrapper: AsyncClientWrapper):
326
+ self._client_wrapper = client_wrapper
327
+
328
+ async def analyze(
329
+ self,
330
+ *,
331
+ repository: str,
332
+ pr_number: int,
333
+ resource_changes: typing.Sequence[ResourceChange],
334
+ head_resources: typing.Optional[typing.Sequence[ResourceSnapshot]] = OMIT,
335
+ region: typing.Optional[str] = OMIT,
336
+ head_sha: typing.Optional[str] = OMIT,
337
+ request_options: typing.Optional[RequestOptions] = None,
338
+ ) -> AsyncHttpResponse[typing.Any]:
339
+ """
340
+ Parameters
341
+ ----------
342
+ repository : str
343
+ GitHub repository full name, e.g. acme/infrastructure
344
+
345
+ pr_number : int
346
+ Pull request number
347
+
348
+ resource_changes : typing.Sequence[ResourceChange]
349
+ List of Terraform resource changes
350
+
351
+ head_resources : typing.Optional[typing.Sequence[ResourceSnapshot]]
352
+
353
+ region : typing.Optional[str]
354
+
355
+ head_sha : typing.Optional[str]
356
+
357
+ request_options : typing.Optional[RequestOptions]
358
+ Request-specific configuration.
359
+
360
+ Returns
361
+ -------
362
+ AsyncHttpResponse[typing.Any]
363
+ Successful Response
364
+ """
365
+ _response = await self._client_wrapper.httpx_client.request(
366
+ "api/v1/pr-analysis/analyze",
367
+ method="POST",
368
+ json={
369
+ "repository": repository,
370
+ "pr_number": pr_number,
371
+ "resource_changes": convert_and_respect_annotation_metadata(
372
+ object_=resource_changes, annotation=typing.Sequence[ResourceChange], direction="write"
373
+ ),
374
+ "head_resources": convert_and_respect_annotation_metadata(
375
+ object_=head_resources, annotation=typing.Sequence[ResourceSnapshot], direction="write"
376
+ ),
377
+ "region": region,
378
+ "head_sha": head_sha,
379
+ },
380
+ headers={
381
+ "content-type": "application/json",
382
+ },
383
+ request_options=request_options,
384
+ omit=OMIT,
385
+ )
386
+ try:
387
+ if _response is None or not _response.text.strip():
388
+ return AsyncHttpResponse(response=_response, data=None)
389
+ if 200 <= _response.status_code < 300:
390
+ _data = typing.cast(
391
+ typing.Any,
392
+ parse_obj_as(
393
+ type_=typing.Any, # type: ignore
394
+ object_=_response.json(),
395
+ ),
396
+ )
397
+ return AsyncHttpResponse(response=_response, data=_data)
398
+ if _response.status_code == 401:
399
+ raise UnauthorizedError(
400
+ headers=dict(_response.headers),
401
+ body=typing.cast(
402
+ AuthenticationError,
403
+ parse_obj_as(
404
+ type_=AuthenticationError, # type: ignore
405
+ object_=_response.json(),
406
+ ),
407
+ ),
408
+ )
409
+ if _response.status_code == 403:
410
+ raise ForbiddenError(
411
+ headers=dict(_response.headers),
412
+ body=typing.cast(
413
+ AuthorizationError,
414
+ parse_obj_as(
415
+ type_=AuthorizationError, # type: ignore
416
+ object_=_response.json(),
417
+ ),
418
+ ),
419
+ )
420
+ if _response.status_code == 422:
421
+ raise UnprocessableEntityError(
422
+ headers=dict(_response.headers),
423
+ body=typing.cast(
424
+ HttpValidationError,
425
+ parse_obj_as(
426
+ type_=HttpValidationError, # type: ignore
427
+ object_=_response.json(),
428
+ ),
429
+ ),
430
+ )
431
+ _response_json = _response.json()
432
+ except JSONDecodeError:
433
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
434
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
435
+
436
+ async def explain(
437
+ self,
438
+ *,
439
+ repository: str,
440
+ pr_number: int,
441
+ resource_key: str,
442
+ request_options: typing.Optional[RequestOptions] = None,
443
+ ) -> AsyncHttpResponse[typing.Any]:
444
+ """
445
+ Parameters
446
+ ----------
447
+ repository : str
448
+
449
+ pr_number : int
450
+
451
+ resource_key : str
452
+
453
+ request_options : typing.Optional[RequestOptions]
454
+ Request-specific configuration.
455
+
456
+ Returns
457
+ -------
458
+ AsyncHttpResponse[typing.Any]
459
+ Successful Response
460
+ """
461
+ _response = await self._client_wrapper.httpx_client.request(
462
+ "api/v1/pr-analysis/explain",
463
+ method="POST",
464
+ json={
465
+ "repository": repository,
466
+ "pr_number": pr_number,
467
+ "resource_key": resource_key,
468
+ },
469
+ headers={
470
+ "content-type": "application/json",
471
+ },
472
+ request_options=request_options,
473
+ omit=OMIT,
474
+ )
475
+ try:
476
+ if _response is None or not _response.text.strip():
477
+ return AsyncHttpResponse(response=_response, data=None)
478
+ if 200 <= _response.status_code < 300:
479
+ _data = typing.cast(
480
+ typing.Any,
481
+ parse_obj_as(
482
+ type_=typing.Any, # type: ignore
483
+ object_=_response.json(),
484
+ ),
485
+ )
486
+ return AsyncHttpResponse(response=_response, data=_data)
487
+ if _response.status_code == 401:
488
+ raise UnauthorizedError(
489
+ headers=dict(_response.headers),
490
+ body=typing.cast(
491
+ AuthenticationError,
492
+ parse_obj_as(
493
+ type_=AuthenticationError, # type: ignore
494
+ object_=_response.json(),
495
+ ),
496
+ ),
497
+ )
498
+ if _response.status_code == 403:
499
+ raise ForbiddenError(
500
+ headers=dict(_response.headers),
501
+ body=typing.cast(
502
+ AuthorizationError,
503
+ parse_obj_as(
504
+ type_=AuthorizationError, # type: ignore
505
+ object_=_response.json(),
506
+ ),
507
+ ),
508
+ )
509
+ if _response.status_code == 422:
510
+ raise UnprocessableEntityError(
511
+ headers=dict(_response.headers),
512
+ body=typing.cast(
513
+ HttpValidationError,
514
+ parse_obj_as(
515
+ type_=HttpValidationError, # type: ignore
516
+ object_=_response.json(),
517
+ ),
518
+ ),
519
+ )
520
+ _response_json = _response.json()
521
+ except JSONDecodeError:
522
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
523
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
524
+
525
+ async def whatif(
526
+ self,
527
+ *,
528
+ repository: str,
529
+ pr_number: int,
530
+ resource_key: str,
531
+ attribute: str,
532
+ hypothetical_value: str,
533
+ request_options: typing.Optional[RequestOptions] = None,
534
+ ) -> AsyncHttpResponse[typing.Any]:
535
+ """
536
+ Parameters
537
+ ----------
538
+ repository : str
539
+
540
+ pr_number : int
541
+
542
+ resource_key : str
543
+
544
+ attribute : str
545
+
546
+ hypothetical_value : str
547
+
548
+ request_options : typing.Optional[RequestOptions]
549
+ Request-specific configuration.
550
+
551
+ Returns
552
+ -------
553
+ AsyncHttpResponse[typing.Any]
554
+ Successful Response
555
+ """
556
+ _response = await self._client_wrapper.httpx_client.request(
557
+ "api/v1/pr-analysis/whatif",
558
+ method="POST",
559
+ json={
560
+ "repository": repository,
561
+ "pr_number": pr_number,
562
+ "resource_key": resource_key,
563
+ "attribute": attribute,
564
+ "hypothetical_value": hypothetical_value,
565
+ },
566
+ headers={
567
+ "content-type": "application/json",
568
+ },
569
+ request_options=request_options,
570
+ omit=OMIT,
571
+ )
572
+ try:
573
+ if _response is None or not _response.text.strip():
574
+ return AsyncHttpResponse(response=_response, data=None)
575
+ if 200 <= _response.status_code < 300:
576
+ _data = typing.cast(
577
+ typing.Any,
578
+ parse_obj_as(
579
+ type_=typing.Any, # type: ignore
580
+ object_=_response.json(),
581
+ ),
582
+ )
583
+ return AsyncHttpResponse(response=_response, data=_data)
584
+ if _response.status_code == 401:
585
+ raise UnauthorizedError(
586
+ headers=dict(_response.headers),
587
+ body=typing.cast(
588
+ AuthenticationError,
589
+ parse_obj_as(
590
+ type_=AuthenticationError, # type: ignore
591
+ object_=_response.json(),
592
+ ),
593
+ ),
594
+ )
595
+ if _response.status_code == 403:
596
+ raise ForbiddenError(
597
+ headers=dict(_response.headers),
598
+ body=typing.cast(
599
+ AuthorizationError,
600
+ parse_obj_as(
601
+ type_=AuthorizationError, # type: ignore
602
+ object_=_response.json(),
603
+ ),
604
+ ),
605
+ )
606
+ if _response.status_code == 422:
607
+ raise UnprocessableEntityError(
608
+ headers=dict(_response.headers),
609
+ body=typing.cast(
610
+ HttpValidationError,
611
+ parse_obj_as(
612
+ type_=HttpValidationError, # type: ignore
613
+ object_=_response.json(),
614
+ ),
615
+ ),
616
+ )
617
+ _response_json = _response.json()
618
+ except JSONDecodeError:
619
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
620
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
@@ -0,0 +1,4 @@
1
+ # This file was auto-generated by Fern from our API Definition.
2
+
3
+ # isort: skip_file
4
+