airbyte-cdk 0.72.0__py3-none-any.whl → 6.13.1.dev4106__py3-none-any.whl

Sign up to get free protection for your applications and to get access to all the features.
Files changed (517) hide show
  1. airbyte_cdk/__init__.py +355 -6
  2. airbyte_cdk/cli/__init__.py +1 -0
  3. airbyte_cdk/cli/source_declarative_manifest/__init__.py +5 -0
  4. airbyte_cdk/cli/source_declarative_manifest/_run.py +230 -0
  5. airbyte_cdk/cli/source_declarative_manifest/spec.json +17 -0
  6. airbyte_cdk/config_observation.py +29 -10
  7. airbyte_cdk/connector.py +24 -24
  8. airbyte_cdk/connector_builder/README.md +53 -0
  9. airbyte_cdk/connector_builder/connector_builder_handler.py +37 -11
  10. airbyte_cdk/connector_builder/main.py +45 -13
  11. airbyte_cdk/connector_builder/message_grouper.py +189 -50
  12. airbyte_cdk/connector_builder/models.py +3 -2
  13. airbyte_cdk/destinations/__init__.py +4 -3
  14. airbyte_cdk/destinations/destination.py +54 -20
  15. airbyte_cdk/destinations/vector_db_based/README.md +37 -0
  16. airbyte_cdk/destinations/vector_db_based/config.py +40 -17
  17. airbyte_cdk/destinations/vector_db_based/document_processor.py +56 -17
  18. airbyte_cdk/destinations/vector_db_based/embedder.py +57 -15
  19. airbyte_cdk/destinations/vector_db_based/test_utils.py +14 -4
  20. airbyte_cdk/destinations/vector_db_based/utils.py +8 -2
  21. airbyte_cdk/destinations/vector_db_based/writer.py +24 -5
  22. airbyte_cdk/entrypoint.py +153 -44
  23. airbyte_cdk/exception_handler.py +21 -3
  24. airbyte_cdk/logger.py +30 -44
  25. airbyte_cdk/models/__init__.py +13 -2
  26. airbyte_cdk/models/airbyte_protocol.py +86 -1
  27. airbyte_cdk/models/airbyte_protocol_serializers.py +44 -0
  28. airbyte_cdk/models/file_transfer_record_message.py +13 -0
  29. airbyte_cdk/models/well_known_types.py +1 -1
  30. airbyte_cdk/sources/__init__.py +5 -1
  31. airbyte_cdk/sources/abstract_source.py +125 -79
  32. airbyte_cdk/sources/concurrent_source/__init__.py +7 -2
  33. airbyte_cdk/sources/concurrent_source/concurrent_read_processor.py +102 -36
  34. airbyte_cdk/sources/concurrent_source/concurrent_source.py +29 -36
  35. airbyte_cdk/sources/concurrent_source/concurrent_source_adapter.py +94 -10
  36. airbyte_cdk/sources/concurrent_source/stream_thread_exception.py +25 -0
  37. airbyte_cdk/sources/concurrent_source/thread_pool_manager.py +20 -14
  38. airbyte_cdk/sources/config.py +3 -2
  39. airbyte_cdk/sources/connector_state_manager.py +49 -83
  40. airbyte_cdk/sources/declarative/async_job/job.py +52 -0
  41. airbyte_cdk/sources/declarative/async_job/job_orchestrator.py +497 -0
  42. airbyte_cdk/sources/declarative/async_job/job_tracker.py +75 -0
  43. airbyte_cdk/sources/declarative/async_job/repository.py +35 -0
  44. airbyte_cdk/sources/declarative/async_job/status.py +24 -0
  45. airbyte_cdk/sources/declarative/async_job/timer.py +39 -0
  46. airbyte_cdk/sources/declarative/auth/__init__.py +2 -3
  47. airbyte_cdk/sources/declarative/auth/declarative_authenticator.py +3 -1
  48. airbyte_cdk/sources/declarative/auth/jwt.py +191 -0
  49. airbyte_cdk/sources/declarative/auth/oauth.py +60 -20
  50. airbyte_cdk/sources/declarative/auth/selective_authenticator.py +10 -2
  51. airbyte_cdk/sources/declarative/auth/token.py +28 -10
  52. airbyte_cdk/sources/declarative/auth/token_provider.py +9 -8
  53. airbyte_cdk/sources/declarative/checks/check_stream.py +16 -8
  54. airbyte_cdk/sources/declarative/checks/connection_checker.py +4 -2
  55. airbyte_cdk/sources/declarative/concurrency_level/__init__.py +7 -0
  56. airbyte_cdk/sources/declarative/concurrency_level/concurrency_level.py +50 -0
  57. airbyte_cdk/sources/declarative/concurrent_declarative_source.py +421 -0
  58. airbyte_cdk/sources/declarative/datetime/datetime_parser.py +4 -0
  59. airbyte_cdk/sources/declarative/datetime/min_max_datetime.py +26 -6
  60. airbyte_cdk/sources/declarative/declarative_component_schema.yaml +1213 -88
  61. airbyte_cdk/sources/declarative/declarative_source.py +5 -2
  62. airbyte_cdk/sources/declarative/declarative_stream.py +95 -9
  63. airbyte_cdk/sources/declarative/decoders/__init__.py +23 -2
  64. airbyte_cdk/sources/declarative/decoders/composite_raw_decoder.py +97 -0
  65. airbyte_cdk/sources/declarative/decoders/decoder.py +11 -4
  66. airbyte_cdk/sources/declarative/decoders/json_decoder.py +92 -5
  67. airbyte_cdk/sources/declarative/decoders/noop_decoder.py +21 -0
  68. airbyte_cdk/sources/declarative/decoders/pagination_decoder_decorator.py +39 -0
  69. airbyte_cdk/sources/declarative/decoders/xml_decoder.py +98 -0
  70. airbyte_cdk/sources/declarative/extractors/__init__.py +12 -1
  71. airbyte_cdk/sources/declarative/extractors/dpath_extractor.py +29 -24
  72. airbyte_cdk/sources/declarative/extractors/http_selector.py +4 -5
  73. airbyte_cdk/sources/declarative/extractors/record_extractor.py +2 -3
  74. airbyte_cdk/sources/declarative/extractors/record_filter.py +65 -8
  75. airbyte_cdk/sources/declarative/extractors/record_selector.py +85 -26
  76. airbyte_cdk/sources/declarative/extractors/response_to_file_extractor.py +177 -0
  77. airbyte_cdk/sources/declarative/extractors/type_transformer.py +55 -0
  78. airbyte_cdk/sources/declarative/incremental/__init__.py +25 -3
  79. airbyte_cdk/sources/declarative/incremental/datetime_based_cursor.py +156 -48
  80. airbyte_cdk/sources/declarative/incremental/declarative_cursor.py +13 -0
  81. airbyte_cdk/sources/declarative/incremental/global_substream_cursor.py +350 -0
  82. airbyte_cdk/sources/declarative/incremental/per_partition_cursor.py +159 -74
  83. airbyte_cdk/sources/declarative/incremental/per_partition_with_global.py +200 -0
  84. airbyte_cdk/sources/declarative/incremental/resumable_full_refresh_cursor.py +122 -0
  85. airbyte_cdk/sources/declarative/interpolation/filters.py +27 -1
  86. airbyte_cdk/sources/declarative/interpolation/interpolated_boolean.py +23 -5
  87. airbyte_cdk/sources/declarative/interpolation/interpolated_mapping.py +12 -8
  88. airbyte_cdk/sources/declarative/interpolation/interpolated_nested_mapping.py +13 -6
  89. airbyte_cdk/sources/declarative/interpolation/interpolated_string.py +21 -6
  90. airbyte_cdk/sources/declarative/interpolation/interpolation.py +9 -3
  91. airbyte_cdk/sources/declarative/interpolation/jinja.py +72 -37
  92. airbyte_cdk/sources/declarative/interpolation/macros.py +72 -17
  93. airbyte_cdk/sources/declarative/manifest_declarative_source.py +193 -52
  94. airbyte_cdk/sources/declarative/migrations/legacy_to_per_partition_state_migration.py +98 -0
  95. airbyte_cdk/sources/declarative/migrations/state_migration.py +24 -0
  96. airbyte_cdk/sources/declarative/models/__init__.py +1 -1
  97. airbyte_cdk/sources/declarative/models/declarative_component_schema.py +1329 -595
  98. airbyte_cdk/sources/declarative/parsers/custom_exceptions.py +2 -2
  99. airbyte_cdk/sources/declarative/parsers/manifest_component_transformer.py +26 -4
  100. airbyte_cdk/sources/declarative/parsers/manifest_reference_resolver.py +26 -15
  101. airbyte_cdk/sources/declarative/parsers/model_to_component_factory.py +1699 -226
  102. airbyte_cdk/sources/declarative/partition_routers/__init__.py +24 -4
  103. airbyte_cdk/sources/declarative/partition_routers/async_job_partition_router.py +65 -0
  104. airbyte_cdk/sources/declarative/partition_routers/cartesian_product_stream_slicer.py +176 -0
  105. airbyte_cdk/sources/declarative/partition_routers/list_partition_router.py +39 -9
  106. airbyte_cdk/sources/declarative/partition_routers/partition_router.py +62 -0
  107. airbyte_cdk/sources/declarative/partition_routers/single_partition_router.py +15 -3
  108. airbyte_cdk/sources/declarative/partition_routers/substream_partition_router.py +222 -39
  109. airbyte_cdk/sources/declarative/requesters/error_handlers/__init__.py +19 -5
  110. airbyte_cdk/sources/declarative/requesters/error_handlers/backoff_strategies/__init__.py +3 -1
  111. airbyte_cdk/sources/declarative/requesters/error_handlers/backoff_strategies/constant_backoff_strategy.py +19 -7
  112. airbyte_cdk/sources/declarative/requesters/error_handlers/backoff_strategies/exponential_backoff_strategy.py +19 -7
  113. airbyte_cdk/sources/declarative/requesters/error_handlers/backoff_strategies/header_helper.py +4 -2
  114. airbyte_cdk/sources/declarative/requesters/error_handlers/backoff_strategies/wait_time_from_header_backoff_strategy.py +41 -9
  115. airbyte_cdk/sources/declarative/requesters/error_handlers/backoff_strategies/wait_until_time_from_header_backoff_strategy.py +29 -14
  116. airbyte_cdk/sources/declarative/requesters/error_handlers/backoff_strategy.py +5 -13
  117. airbyte_cdk/sources/declarative/requesters/error_handlers/composite_error_handler.py +32 -16
  118. airbyte_cdk/sources/declarative/requesters/error_handlers/default_error_handler.py +46 -56
  119. airbyte_cdk/sources/declarative/requesters/error_handlers/default_http_response_filter.py +40 -0
  120. airbyte_cdk/sources/declarative/requesters/error_handlers/error_handler.py +6 -32
  121. airbyte_cdk/sources/declarative/requesters/error_handlers/http_response_filter.py +119 -41
  122. airbyte_cdk/sources/declarative/requesters/http_job_repository.py +228 -0
  123. airbyte_cdk/sources/declarative/requesters/http_requester.py +98 -344
  124. airbyte_cdk/sources/declarative/requesters/paginators/__init__.py +14 -3
  125. airbyte_cdk/sources/declarative/requesters/paginators/default_paginator.py +105 -46
  126. airbyte_cdk/sources/declarative/requesters/paginators/no_pagination.py +14 -8
  127. airbyte_cdk/sources/declarative/requesters/paginators/paginator.py +19 -8
  128. airbyte_cdk/sources/declarative/requesters/paginators/strategies/__init__.py +9 -3
  129. airbyte_cdk/sources/declarative/requesters/paginators/strategies/cursor_pagination_strategy.py +53 -21
  130. airbyte_cdk/sources/declarative/requesters/paginators/strategies/offset_increment.py +42 -19
  131. airbyte_cdk/sources/declarative/requesters/paginators/strategies/page_increment.py +25 -12
  132. airbyte_cdk/sources/declarative/requesters/paginators/strategies/pagination_strategy.py +13 -10
  133. airbyte_cdk/sources/declarative/requesters/paginators/strategies/stop_condition.py +26 -13
  134. airbyte_cdk/sources/declarative/requesters/request_options/__init__.py +15 -2
  135. airbyte_cdk/sources/declarative/requesters/request_options/datetime_based_request_options_provider.py +91 -0
  136. airbyte_cdk/sources/declarative/requesters/request_options/default_request_options_provider.py +60 -0
  137. airbyte_cdk/sources/declarative/requesters/request_options/interpolated_nested_request_input_provider.py +31 -14
  138. airbyte_cdk/sources/declarative/requesters/request_options/interpolated_request_input_provider.py +27 -15
  139. airbyte_cdk/sources/declarative/requesters/request_options/interpolated_request_options_provider.py +63 -10
  140. airbyte_cdk/sources/declarative/requesters/request_options/request_options_provider.py +1 -1
  141. airbyte_cdk/sources/declarative/requesters/requester.py +9 -17
  142. airbyte_cdk/sources/declarative/resolvers/__init__.py +41 -0
  143. airbyte_cdk/sources/declarative/resolvers/components_resolver.py +55 -0
  144. airbyte_cdk/sources/declarative/resolvers/config_components_resolver.py +136 -0
  145. airbyte_cdk/sources/declarative/resolvers/http_components_resolver.py +112 -0
  146. airbyte_cdk/sources/declarative/retrievers/__init__.py +6 -2
  147. airbyte_cdk/sources/declarative/retrievers/async_retriever.py +100 -0
  148. airbyte_cdk/sources/declarative/retrievers/retriever.py +1 -3
  149. airbyte_cdk/sources/declarative/retrievers/simple_retriever.py +228 -72
  150. airbyte_cdk/sources/declarative/schema/__init__.py +14 -1
  151. airbyte_cdk/sources/declarative/schema/default_schema_loader.py +5 -3
  152. airbyte_cdk/sources/declarative/schema/dynamic_schema_loader.py +236 -0
  153. airbyte_cdk/sources/declarative/schema/json_file_schema_loader.py +8 -8
  154. airbyte_cdk/sources/declarative/spec/spec.py +12 -5
  155. airbyte_cdk/sources/declarative/stream_slicers/__init__.py +1 -2
  156. airbyte_cdk/sources/declarative/stream_slicers/declarative_partition_generator.py +88 -0
  157. airbyte_cdk/sources/declarative/stream_slicers/stream_slicer.py +9 -14
  158. airbyte_cdk/sources/declarative/transformations/add_fields.py +19 -11
  159. airbyte_cdk/sources/declarative/transformations/flatten_fields.py +52 -0
  160. airbyte_cdk/sources/declarative/transformations/keys_replace_transformation.py +61 -0
  161. airbyte_cdk/sources/declarative/transformations/keys_to_lower_transformation.py +22 -0
  162. airbyte_cdk/sources/declarative/transformations/keys_to_snake_transformation.py +68 -0
  163. airbyte_cdk/sources/declarative/transformations/remove_fields.py +13 -10
  164. airbyte_cdk/sources/declarative/transformations/transformation.py +5 -5
  165. airbyte_cdk/sources/declarative/types.py +19 -110
  166. airbyte_cdk/sources/declarative/yaml_declarative_source.py +31 -10
  167. airbyte_cdk/sources/embedded/base_integration.py +16 -5
  168. airbyte_cdk/sources/embedded/catalog.py +16 -4
  169. airbyte_cdk/sources/embedded/runner.py +19 -3
  170. airbyte_cdk/sources/embedded/tools.py +5 -2
  171. airbyte_cdk/sources/file_based/README.md +152 -0
  172. airbyte_cdk/sources/file_based/__init__.py +24 -0
  173. airbyte_cdk/sources/file_based/availability_strategy/__init__.py +9 -2
  174. airbyte_cdk/sources/file_based/availability_strategy/abstract_file_based_availability_strategy.py +22 -6
  175. airbyte_cdk/sources/file_based/availability_strategy/default_file_based_availability_strategy.py +46 -10
  176. airbyte_cdk/sources/file_based/config/abstract_file_based_spec.py +58 -10
  177. airbyte_cdk/sources/file_based/config/avro_format.py +2 -1
  178. airbyte_cdk/sources/file_based/config/csv_format.py +29 -10
  179. airbyte_cdk/sources/file_based/config/excel_format.py +18 -0
  180. airbyte_cdk/sources/file_based/config/file_based_stream_config.py +16 -4
  181. airbyte_cdk/sources/file_based/config/jsonl_format.py +2 -1
  182. airbyte_cdk/sources/file_based/config/parquet_format.py +2 -1
  183. airbyte_cdk/sources/file_based/config/unstructured_format.py +13 -5
  184. airbyte_cdk/sources/file_based/discovery_policy/__init__.py +6 -2
  185. airbyte_cdk/sources/file_based/discovery_policy/abstract_discovery_policy.py +2 -4
  186. airbyte_cdk/sources/file_based/discovery_policy/default_discovery_policy.py +7 -2
  187. airbyte_cdk/sources/file_based/exceptions.py +52 -15
  188. airbyte_cdk/sources/file_based/file_based_source.py +163 -33
  189. airbyte_cdk/sources/file_based/file_based_stream_reader.py +83 -5
  190. airbyte_cdk/sources/file_based/file_types/__init__.py +14 -1
  191. airbyte_cdk/sources/file_based/file_types/avro_parser.py +75 -24
  192. airbyte_cdk/sources/file_based/file_types/csv_parser.py +116 -34
  193. airbyte_cdk/sources/file_based/file_types/excel_parser.py +196 -0
  194. airbyte_cdk/sources/file_based/file_types/file_transfer.py +37 -0
  195. airbyte_cdk/sources/file_based/file_types/file_type_parser.py +4 -1
  196. airbyte_cdk/sources/file_based/file_types/jsonl_parser.py +24 -8
  197. airbyte_cdk/sources/file_based/file_types/parquet_parser.py +60 -18
  198. airbyte_cdk/sources/file_based/file_types/unstructured_parser.py +145 -41
  199. airbyte_cdk/sources/file_based/remote_file.py +1 -1
  200. airbyte_cdk/sources/file_based/schema_helpers.py +38 -10
  201. airbyte_cdk/sources/file_based/schema_validation_policies/__init__.py +3 -1
  202. airbyte_cdk/sources/file_based/schema_validation_policies/abstract_schema_validation_policy.py +3 -1
  203. airbyte_cdk/sources/file_based/schema_validation_policies/default_schema_validation_policies.py +16 -5
  204. airbyte_cdk/sources/file_based/stream/abstract_file_based_stream.py +50 -13
  205. airbyte_cdk/sources/file_based/stream/concurrent/adapters.py +67 -27
  206. airbyte_cdk/sources/file_based/stream/concurrent/cursor/__init__.py +5 -1
  207. airbyte_cdk/sources/file_based/stream/concurrent/cursor/abstract_concurrent_file_based_cursor.py +14 -23
  208. airbyte_cdk/sources/file_based/stream/concurrent/cursor/file_based_concurrent_cursor.py +54 -18
  209. airbyte_cdk/sources/file_based/stream/concurrent/cursor/file_based_final_state_cursor.py +21 -9
  210. airbyte_cdk/sources/file_based/stream/cursor/abstract_file_based_cursor.py +3 -1
  211. airbyte_cdk/sources/file_based/stream/cursor/default_file_based_cursor.py +27 -10
  212. airbyte_cdk/sources/file_based/stream/default_file_based_stream.py +175 -45
  213. airbyte_cdk/sources/http_logger.py +8 -3
  214. airbyte_cdk/sources/message/__init__.py +7 -1
  215. airbyte_cdk/sources/message/repository.py +18 -4
  216. airbyte_cdk/sources/source.py +42 -38
  217. airbyte_cdk/sources/streams/__init__.py +2 -2
  218. airbyte_cdk/sources/streams/availability_strategy.py +54 -3
  219. airbyte_cdk/sources/streams/call_rate.py +64 -21
  220. airbyte_cdk/sources/streams/checkpoint/__init__.py +26 -0
  221. airbyte_cdk/sources/streams/checkpoint/checkpoint_reader.py +335 -0
  222. airbyte_cdk/sources/{declarative/incremental → streams/checkpoint}/cursor.py +17 -14
  223. airbyte_cdk/sources/streams/checkpoint/per_partition_key_serializer.py +22 -0
  224. airbyte_cdk/sources/streams/checkpoint/resumable_full_refresh_cursor.py +51 -0
  225. airbyte_cdk/sources/streams/checkpoint/substream_resumable_full_refresh_cursor.py +110 -0
  226. airbyte_cdk/sources/streams/concurrent/README.md +7 -0
  227. airbyte_cdk/sources/streams/concurrent/abstract_stream.py +7 -2
  228. airbyte_cdk/sources/streams/concurrent/adapters.py +84 -75
  229. airbyte_cdk/sources/streams/concurrent/availability_strategy.py +30 -2
  230. airbyte_cdk/sources/streams/concurrent/cursor.py +298 -42
  231. airbyte_cdk/sources/streams/concurrent/default_stream.py +12 -3
  232. airbyte_cdk/sources/streams/concurrent/exceptions.py +3 -0
  233. airbyte_cdk/sources/streams/concurrent/helpers.py +14 -3
  234. airbyte_cdk/sources/streams/concurrent/partition_enqueuer.py +12 -3
  235. airbyte_cdk/sources/streams/concurrent/partition_reader.py +10 -3
  236. airbyte_cdk/sources/streams/concurrent/partitions/partition.py +1 -16
  237. airbyte_cdk/sources/streams/concurrent/partitions/stream_slicer.py +21 -0
  238. airbyte_cdk/sources/streams/concurrent/partitions/types.py +15 -5
  239. airbyte_cdk/sources/streams/concurrent/state_converters/abstract_stream_state_converter.py +109 -17
  240. airbyte_cdk/sources/streams/concurrent/state_converters/datetime_stream_state_converter.py +90 -72
  241. airbyte_cdk/sources/streams/core.py +412 -87
  242. airbyte_cdk/sources/streams/http/__init__.py +2 -1
  243. airbyte_cdk/sources/streams/http/availability_strategy.py +12 -101
  244. airbyte_cdk/sources/streams/http/error_handlers/__init__.py +22 -0
  245. airbyte_cdk/sources/streams/http/error_handlers/backoff_strategy.py +28 -0
  246. airbyte_cdk/sources/streams/http/error_handlers/default_backoff_strategy.py +17 -0
  247. airbyte_cdk/sources/streams/http/error_handlers/default_error_mapping.py +86 -0
  248. airbyte_cdk/sources/streams/http/error_handlers/error_handler.py +42 -0
  249. airbyte_cdk/sources/streams/http/error_handlers/error_message_parser.py +19 -0
  250. airbyte_cdk/sources/streams/http/error_handlers/http_status_error_handler.py +110 -0
  251. airbyte_cdk/sources/streams/http/error_handlers/json_error_message_parser.py +52 -0
  252. airbyte_cdk/sources/streams/http/error_handlers/response_models.py +65 -0
  253. airbyte_cdk/sources/streams/http/exceptions.py +27 -7
  254. airbyte_cdk/sources/streams/http/http.py +369 -246
  255. airbyte_cdk/sources/streams/http/http_client.py +531 -0
  256. airbyte_cdk/sources/streams/http/rate_limiting.py +76 -12
  257. airbyte_cdk/sources/streams/http/requests_native_auth/abstract_oauth.py +28 -9
  258. airbyte_cdk/sources/streams/http/requests_native_auth/abstract_token.py +2 -1
  259. airbyte_cdk/sources/streams/http/requests_native_auth/oauth.py +90 -35
  260. airbyte_cdk/sources/streams/http/requests_native_auth/token.py +13 -3
  261. airbyte_cdk/sources/types.py +154 -0
  262. airbyte_cdk/sources/utils/record_helper.py +36 -21
  263. airbyte_cdk/sources/utils/schema_helpers.py +13 -6
  264. airbyte_cdk/sources/utils/slice_logger.py +4 -1
  265. airbyte_cdk/sources/utils/transform.py +54 -20
  266. airbyte_cdk/sql/_util/hashing.py +34 -0
  267. airbyte_cdk/sql/_util/name_normalizers.py +92 -0
  268. airbyte_cdk/sql/constants.py +32 -0
  269. airbyte_cdk/sql/exceptions.py +235 -0
  270. airbyte_cdk/sql/secrets.py +123 -0
  271. airbyte_cdk/sql/shared/__init__.py +15 -0
  272. airbyte_cdk/sql/shared/catalog_providers.py +145 -0
  273. airbyte_cdk/sql/shared/sql_processor.py +786 -0
  274. airbyte_cdk/sql/types.py +160 -0
  275. airbyte_cdk/test/catalog_builder.py +70 -18
  276. airbyte_cdk/test/entrypoint_wrapper.py +117 -42
  277. airbyte_cdk/test/mock_http/__init__.py +1 -1
  278. airbyte_cdk/test/mock_http/matcher.py +6 -0
  279. airbyte_cdk/test/mock_http/mocker.py +57 -10
  280. airbyte_cdk/test/mock_http/request.py +19 -3
  281. airbyte_cdk/test/mock_http/response.py +3 -1
  282. airbyte_cdk/test/mock_http/response_builder.py +32 -16
  283. airbyte_cdk/test/state_builder.py +18 -10
  284. airbyte_cdk/test/utils/__init__.py +1 -0
  285. airbyte_cdk/test/utils/data.py +24 -0
  286. airbyte_cdk/test/utils/http_mocking.py +16 -0
  287. airbyte_cdk/test/utils/manifest_only_fixtures.py +60 -0
  288. airbyte_cdk/test/utils/reading.py +26 -0
  289. airbyte_cdk/utils/__init__.py +2 -1
  290. airbyte_cdk/utils/airbyte_secrets_utils.py +5 -3
  291. airbyte_cdk/utils/analytics_message.py +10 -2
  292. airbyte_cdk/utils/datetime_format_inferrer.py +4 -1
  293. airbyte_cdk/utils/event_timing.py +10 -10
  294. airbyte_cdk/utils/mapping_helpers.py +3 -1
  295. airbyte_cdk/utils/message_utils.py +20 -11
  296. airbyte_cdk/utils/print_buffer.py +75 -0
  297. airbyte_cdk/utils/schema_inferrer.py +198 -28
  298. airbyte_cdk/utils/slice_hasher.py +30 -0
  299. airbyte_cdk/utils/spec_schema_transformations.py +6 -3
  300. airbyte_cdk/utils/stream_status_utils.py +8 -1
  301. airbyte_cdk/utils/traced_exception.py +61 -21
  302. airbyte_cdk-6.13.1.dev4106.dist-info/METADATA +109 -0
  303. airbyte_cdk-6.13.1.dev4106.dist-info/RECORD +349 -0
  304. {airbyte_cdk-0.72.0.dist-info → airbyte_cdk-6.13.1.dev4106.dist-info}/WHEEL +1 -2
  305. airbyte_cdk-6.13.1.dev4106.dist-info/entry_points.txt +3 -0
  306. airbyte_cdk/sources/declarative/create_partial.py +0 -92
  307. airbyte_cdk/sources/declarative/parsers/class_types_registry.py +0 -102
  308. airbyte_cdk/sources/declarative/parsers/default_implementation_registry.py +0 -64
  309. airbyte_cdk/sources/declarative/requesters/error_handlers/response_action.py +0 -16
  310. airbyte_cdk/sources/declarative/requesters/error_handlers/response_status.py +0 -68
  311. airbyte_cdk/sources/declarative/stream_slicers/cartesian_product_stream_slicer.py +0 -114
  312. airbyte_cdk/sources/deprecated/base_source.py +0 -94
  313. airbyte_cdk/sources/deprecated/client.py +0 -99
  314. airbyte_cdk/sources/singer/__init__.py +0 -8
  315. airbyte_cdk/sources/singer/singer_helpers.py +0 -304
  316. airbyte_cdk/sources/singer/source.py +0 -186
  317. airbyte_cdk/sources/streams/concurrent/partitions/record.py +0 -23
  318. airbyte_cdk/sources/streams/http/auth/__init__.py +0 -17
  319. airbyte_cdk/sources/streams/http/auth/core.py +0 -29
  320. airbyte_cdk/sources/streams/http/auth/oauth.py +0 -113
  321. airbyte_cdk/sources/streams/http/auth/token.py +0 -47
  322. airbyte_cdk/sources/streams/utils/stream_helper.py +0 -40
  323. airbyte_cdk/sources/utils/catalog_helpers.py +0 -22
  324. airbyte_cdk/sources/utils/schema_models.py +0 -84
  325. airbyte_cdk-0.72.0.dist-info/METADATA +0 -243
  326. airbyte_cdk-0.72.0.dist-info/RECORD +0 -466
  327. airbyte_cdk-0.72.0.dist-info/top_level.txt +0 -3
  328. source_declarative_manifest/main.py +0 -29
  329. unit_tests/connector_builder/__init__.py +0 -3
  330. unit_tests/connector_builder/test_connector_builder_handler.py +0 -871
  331. unit_tests/connector_builder/test_message_grouper.py +0 -713
  332. unit_tests/connector_builder/utils.py +0 -27
  333. unit_tests/destinations/test_destination.py +0 -243
  334. unit_tests/singer/test_singer_helpers.py +0 -56
  335. unit_tests/singer/test_singer_source.py +0 -112
  336. unit_tests/sources/__init__.py +0 -0
  337. unit_tests/sources/concurrent_source/__init__.py +0 -3
  338. unit_tests/sources/concurrent_source/test_concurrent_source_adapter.py +0 -106
  339. unit_tests/sources/declarative/__init__.py +0 -3
  340. unit_tests/sources/declarative/auth/__init__.py +0 -3
  341. unit_tests/sources/declarative/auth/test_oauth.py +0 -331
  342. unit_tests/sources/declarative/auth/test_selective_authenticator.py +0 -39
  343. unit_tests/sources/declarative/auth/test_session_token_auth.py +0 -182
  344. unit_tests/sources/declarative/auth/test_token_auth.py +0 -200
  345. unit_tests/sources/declarative/auth/test_token_provider.py +0 -73
  346. unit_tests/sources/declarative/checks/__init__.py +0 -3
  347. unit_tests/sources/declarative/checks/test_check_stream.py +0 -146
  348. unit_tests/sources/declarative/decoders/__init__.py +0 -0
  349. unit_tests/sources/declarative/decoders/test_json_decoder.py +0 -16
  350. unit_tests/sources/declarative/external_component.py +0 -13
  351. unit_tests/sources/declarative/extractors/__init__.py +0 -3
  352. unit_tests/sources/declarative/extractors/test_dpath_extractor.py +0 -55
  353. unit_tests/sources/declarative/extractors/test_record_filter.py +0 -55
  354. unit_tests/sources/declarative/extractors/test_record_selector.py +0 -179
  355. unit_tests/sources/declarative/incremental/__init__.py +0 -0
  356. unit_tests/sources/declarative/incremental/test_datetime_based_cursor.py +0 -860
  357. unit_tests/sources/declarative/incremental/test_per_partition_cursor.py +0 -406
  358. unit_tests/sources/declarative/incremental/test_per_partition_cursor_integration.py +0 -332
  359. unit_tests/sources/declarative/interpolation/__init__.py +0 -3
  360. unit_tests/sources/declarative/interpolation/test_filters.py +0 -80
  361. unit_tests/sources/declarative/interpolation/test_interpolated_boolean.py +0 -40
  362. unit_tests/sources/declarative/interpolation/test_interpolated_mapping.py +0 -35
  363. unit_tests/sources/declarative/interpolation/test_interpolated_nested_mapping.py +0 -45
  364. unit_tests/sources/declarative/interpolation/test_interpolated_string.py +0 -25
  365. unit_tests/sources/declarative/interpolation/test_jinja.py +0 -240
  366. unit_tests/sources/declarative/interpolation/test_macros.py +0 -73
  367. unit_tests/sources/declarative/parsers/__init__.py +0 -3
  368. unit_tests/sources/declarative/parsers/test_manifest_component_transformer.py +0 -406
  369. unit_tests/sources/declarative/parsers/test_manifest_reference_resolver.py +0 -139
  370. unit_tests/sources/declarative/parsers/test_model_to_component_factory.py +0 -1841
  371. unit_tests/sources/declarative/parsers/testing_components.py +0 -36
  372. unit_tests/sources/declarative/partition_routers/__init__.py +0 -3
  373. unit_tests/sources/declarative/partition_routers/test_list_partition_router.py +0 -155
  374. unit_tests/sources/declarative/partition_routers/test_single_partition_router.py +0 -14
  375. unit_tests/sources/declarative/partition_routers/test_substream_partition_router.py +0 -404
  376. unit_tests/sources/declarative/requesters/__init__.py +0 -3
  377. unit_tests/sources/declarative/requesters/error_handlers/__init__.py +0 -3
  378. unit_tests/sources/declarative/requesters/error_handlers/backoff_strategies/__init__.py +0 -3
  379. unit_tests/sources/declarative/requesters/error_handlers/backoff_strategies/test_constant_backoff.py +0 -34
  380. unit_tests/sources/declarative/requesters/error_handlers/backoff_strategies/test_exponential_backoff.py +0 -36
  381. unit_tests/sources/declarative/requesters/error_handlers/backoff_strategies/test_header_helper.py +0 -38
  382. unit_tests/sources/declarative/requesters/error_handlers/backoff_strategies/test_wait_time_from_header.py +0 -35
  383. unit_tests/sources/declarative/requesters/error_handlers/backoff_strategies/test_wait_until_time_from_header.py +0 -64
  384. unit_tests/sources/declarative/requesters/error_handlers/test_composite_error_handler.py +0 -213
  385. unit_tests/sources/declarative/requesters/error_handlers/test_default_error_handler.py +0 -178
  386. unit_tests/sources/declarative/requesters/error_handlers/test_http_response_filter.py +0 -121
  387. unit_tests/sources/declarative/requesters/error_handlers/test_response_status.py +0 -44
  388. unit_tests/sources/declarative/requesters/paginators/__init__.py +0 -3
  389. unit_tests/sources/declarative/requesters/paginators/test_cursor_pagination_strategy.py +0 -64
  390. unit_tests/sources/declarative/requesters/paginators/test_default_paginator.py +0 -313
  391. unit_tests/sources/declarative/requesters/paginators/test_no_paginator.py +0 -12
  392. unit_tests/sources/declarative/requesters/paginators/test_offset_increment.py +0 -58
  393. unit_tests/sources/declarative/requesters/paginators/test_page_increment.py +0 -70
  394. unit_tests/sources/declarative/requesters/paginators/test_request_option.py +0 -43
  395. unit_tests/sources/declarative/requesters/paginators/test_stop_condition.py +0 -105
  396. unit_tests/sources/declarative/requesters/request_options/__init__.py +0 -3
  397. unit_tests/sources/declarative/requesters/request_options/test_interpolated_request_options_provider.py +0 -101
  398. unit_tests/sources/declarative/requesters/test_http_requester.py +0 -974
  399. unit_tests/sources/declarative/requesters/test_interpolated_request_input_provider.py +0 -32
  400. unit_tests/sources/declarative/retrievers/__init__.py +0 -3
  401. unit_tests/sources/declarative/retrievers/test_simple_retriever.py +0 -542
  402. unit_tests/sources/declarative/schema/__init__.py +0 -6
  403. unit_tests/sources/declarative/schema/source_test/SourceTest.py +0 -8
  404. unit_tests/sources/declarative/schema/source_test/__init__.py +0 -3
  405. unit_tests/sources/declarative/schema/test_default_schema_loader.py +0 -32
  406. unit_tests/sources/declarative/schema/test_inline_schema_loader.py +0 -19
  407. unit_tests/sources/declarative/schema/test_json_file_schema_loader.py +0 -26
  408. unit_tests/sources/declarative/states/__init__.py +0 -3
  409. unit_tests/sources/declarative/stream_slicers/__init__.py +0 -3
  410. unit_tests/sources/declarative/stream_slicers/test_cartesian_product_stream_slicer.py +0 -225
  411. unit_tests/sources/declarative/test_create_partial.py +0 -83
  412. unit_tests/sources/declarative/test_declarative_stream.py +0 -103
  413. unit_tests/sources/declarative/test_manifest_declarative_source.py +0 -1260
  414. unit_tests/sources/declarative/test_types.py +0 -39
  415. unit_tests/sources/declarative/test_yaml_declarative_source.py +0 -148
  416. unit_tests/sources/file_based/__init__.py +0 -0
  417. unit_tests/sources/file_based/availability_strategy/__init__.py +0 -0
  418. unit_tests/sources/file_based/availability_strategy/test_default_file_based_availability_strategy.py +0 -100
  419. unit_tests/sources/file_based/config/__init__.py +0 -0
  420. unit_tests/sources/file_based/config/test_abstract_file_based_spec.py +0 -28
  421. unit_tests/sources/file_based/config/test_csv_format.py +0 -34
  422. unit_tests/sources/file_based/config/test_file_based_stream_config.py +0 -84
  423. unit_tests/sources/file_based/discovery_policy/__init__.py +0 -0
  424. unit_tests/sources/file_based/discovery_policy/test_default_discovery_policy.py +0 -31
  425. unit_tests/sources/file_based/file_types/__init__.py +0 -0
  426. unit_tests/sources/file_based/file_types/test_avro_parser.py +0 -243
  427. unit_tests/sources/file_based/file_types/test_csv_parser.py +0 -546
  428. unit_tests/sources/file_based/file_types/test_jsonl_parser.py +0 -158
  429. unit_tests/sources/file_based/file_types/test_parquet_parser.py +0 -274
  430. unit_tests/sources/file_based/file_types/test_unstructured_parser.py +0 -593
  431. unit_tests/sources/file_based/helpers.py +0 -70
  432. unit_tests/sources/file_based/in_memory_files_source.py +0 -211
  433. unit_tests/sources/file_based/scenarios/__init__.py +0 -0
  434. unit_tests/sources/file_based/scenarios/avro_scenarios.py +0 -744
  435. unit_tests/sources/file_based/scenarios/check_scenarios.py +0 -220
  436. unit_tests/sources/file_based/scenarios/concurrent_incremental_scenarios.py +0 -2844
  437. unit_tests/sources/file_based/scenarios/csv_scenarios.py +0 -3105
  438. unit_tests/sources/file_based/scenarios/file_based_source_builder.py +0 -91
  439. unit_tests/sources/file_based/scenarios/incremental_scenarios.py +0 -1926
  440. unit_tests/sources/file_based/scenarios/jsonl_scenarios.py +0 -930
  441. unit_tests/sources/file_based/scenarios/parquet_scenarios.py +0 -754
  442. unit_tests/sources/file_based/scenarios/scenario_builder.py +0 -234
  443. unit_tests/sources/file_based/scenarios/unstructured_scenarios.py +0 -608
  444. unit_tests/sources/file_based/scenarios/user_input_schema_scenarios.py +0 -746
  445. unit_tests/sources/file_based/scenarios/validation_policy_scenarios.py +0 -726
  446. unit_tests/sources/file_based/stream/__init__.py +0 -0
  447. unit_tests/sources/file_based/stream/concurrent/__init__.py +0 -0
  448. unit_tests/sources/file_based/stream/concurrent/test_adapters.py +0 -362
  449. unit_tests/sources/file_based/stream/concurrent/test_file_based_concurrent_cursor.py +0 -458
  450. unit_tests/sources/file_based/stream/test_default_file_based_cursor.py +0 -310
  451. unit_tests/sources/file_based/stream/test_default_file_based_stream.py +0 -244
  452. unit_tests/sources/file_based/test_file_based_scenarios.py +0 -320
  453. unit_tests/sources/file_based/test_file_based_stream_reader.py +0 -272
  454. unit_tests/sources/file_based/test_scenarios.py +0 -253
  455. unit_tests/sources/file_based/test_schema_helpers.py +0 -346
  456. unit_tests/sources/fixtures/__init__.py +0 -3
  457. unit_tests/sources/fixtures/source_test_fixture.py +0 -153
  458. unit_tests/sources/message/__init__.py +0 -0
  459. unit_tests/sources/message/test_repository.py +0 -153
  460. unit_tests/sources/streams/__init__.py +0 -0
  461. unit_tests/sources/streams/concurrent/__init__.py +0 -3
  462. unit_tests/sources/streams/concurrent/scenarios/__init__.py +0 -3
  463. unit_tests/sources/streams/concurrent/scenarios/incremental_scenarios.py +0 -250
  464. unit_tests/sources/streams/concurrent/scenarios/stream_facade_builder.py +0 -140
  465. unit_tests/sources/streams/concurrent/scenarios/stream_facade_scenarios.py +0 -452
  466. unit_tests/sources/streams/concurrent/scenarios/test_concurrent_scenarios.py +0 -76
  467. unit_tests/sources/streams/concurrent/scenarios/thread_based_concurrent_stream_scenarios.py +0 -418
  468. unit_tests/sources/streams/concurrent/scenarios/thread_based_concurrent_stream_source_builder.py +0 -142
  469. unit_tests/sources/streams/concurrent/scenarios/utils.py +0 -55
  470. unit_tests/sources/streams/concurrent/test_adapters.py +0 -380
  471. unit_tests/sources/streams/concurrent/test_concurrent_read_processor.py +0 -684
  472. unit_tests/sources/streams/concurrent/test_cursor.py +0 -139
  473. unit_tests/sources/streams/concurrent/test_datetime_state_converter.py +0 -369
  474. unit_tests/sources/streams/concurrent/test_default_stream.py +0 -197
  475. unit_tests/sources/streams/concurrent/test_partition_enqueuer.py +0 -90
  476. unit_tests/sources/streams/concurrent/test_partition_reader.py +0 -67
  477. unit_tests/sources/streams/concurrent/test_thread_pool_manager.py +0 -106
  478. unit_tests/sources/streams/http/__init__.py +0 -0
  479. unit_tests/sources/streams/http/auth/__init__.py +0 -0
  480. unit_tests/sources/streams/http/auth/test_auth.py +0 -173
  481. unit_tests/sources/streams/http/requests_native_auth/__init__.py +0 -0
  482. unit_tests/sources/streams/http/requests_native_auth/test_requests_native_auth.py +0 -423
  483. unit_tests/sources/streams/http/test_availability_strategy.py +0 -180
  484. unit_tests/sources/streams/http/test_http.py +0 -635
  485. unit_tests/sources/streams/test_availability_strategy.py +0 -70
  486. unit_tests/sources/streams/test_call_rate.py +0 -300
  487. unit_tests/sources/streams/test_stream_read.py +0 -405
  488. unit_tests/sources/streams/test_streams_core.py +0 -184
  489. unit_tests/sources/test_abstract_source.py +0 -1442
  490. unit_tests/sources/test_concurrent_source.py +0 -112
  491. unit_tests/sources/test_config.py +0 -92
  492. unit_tests/sources/test_connector_state_manager.py +0 -482
  493. unit_tests/sources/test_http_logger.py +0 -252
  494. unit_tests/sources/test_integration_source.py +0 -86
  495. unit_tests/sources/test_source.py +0 -684
  496. unit_tests/sources/test_source_read.py +0 -460
  497. unit_tests/test/__init__.py +0 -0
  498. unit_tests/test/mock_http/__init__.py +0 -0
  499. unit_tests/test/mock_http/test_matcher.py +0 -53
  500. unit_tests/test/mock_http/test_mocker.py +0 -214
  501. unit_tests/test/mock_http/test_request.py +0 -117
  502. unit_tests/test/mock_http/test_response_builder.py +0 -177
  503. unit_tests/test/test_entrypoint_wrapper.py +0 -240
  504. unit_tests/utils/__init__.py +0 -0
  505. unit_tests/utils/test_datetime_format_inferrer.py +0 -60
  506. unit_tests/utils/test_mapping_helpers.py +0 -54
  507. unit_tests/utils/test_message_utils.py +0 -91
  508. unit_tests/utils/test_rate_limiting.py +0 -26
  509. unit_tests/utils/test_schema_inferrer.py +0 -202
  510. unit_tests/utils/test_secret_utils.py +0 -135
  511. unit_tests/utils/test_stream_status_utils.py +0 -61
  512. unit_tests/utils/test_traced_exception.py +0 -107
  513. /airbyte_cdk/sources/{deprecated → declarative/async_job}/__init__.py +0 -0
  514. {source_declarative_manifest → airbyte_cdk/sources/declarative/migrations}/__init__.py +0 -0
  515. {unit_tests/destinations → airbyte_cdk/sql}/__init__.py +0 -0
  516. {unit_tests/singer → airbyte_cdk/sql/_util}/__init__.py +0 -0
  517. {airbyte_cdk-0.72.0.dist-info → airbyte_cdk-6.13.1.dev4106.dist-info}/LICENSE.txt +0 -0
@@ -0,0 +1,236 @@
1
+ #
2
+ # Copyright (c) 2024 Airbyte, Inc., all rights reserved.
3
+ #
4
+
5
+
6
+ from copy import deepcopy
7
+ from dataclasses import InitVar, dataclass, field
8
+ from typing import Any, List, Mapping, MutableMapping, Optional, Union
9
+
10
+ import dpath
11
+ from typing_extensions import deprecated
12
+
13
+ from airbyte_cdk.sources.declarative.interpolation.interpolated_string import InterpolatedString
14
+ from airbyte_cdk.sources.declarative.retrievers.retriever import Retriever
15
+ from airbyte_cdk.sources.declarative.schema.schema_loader import SchemaLoader
16
+ from airbyte_cdk.sources.declarative.transformations import RecordTransformation
17
+ from airbyte_cdk.sources.source import ExperimentalClassWarning
18
+ from airbyte_cdk.sources.types import Config, StreamSlice, StreamState
19
+
20
+ AIRBYTE_DATA_TYPES: Mapping[str, Mapping[str, Any]] = {
21
+ "string": {"type": ["null", "string"]},
22
+ "boolean": {"type": ["null", "boolean"]},
23
+ "date": {"type": ["null", "string"], "format": "date"},
24
+ "timestamp_without_timezone": {
25
+ "type": ["null", "string"],
26
+ "format": "date-time",
27
+ "airbyte_type": "timestamp_without_timezone",
28
+ },
29
+ "timestamp_with_timezone": {"type": ["null", "string"], "format": "date-time"},
30
+ "time_without_timezone": {
31
+ "type": ["null", "string"],
32
+ "format": "time",
33
+ "airbyte_type": "time_without_timezone",
34
+ },
35
+ "time_with_timezone": {
36
+ "type": ["null", "string"],
37
+ "format": "time",
38
+ "airbyte_type": "time_with_timezone",
39
+ },
40
+ "integer": {"type": ["null", "integer"]},
41
+ "number": {"type": ["null", "number"]},
42
+ "array": {"type": ["null", "array"]},
43
+ "object": {"type": ["null", "object"]},
44
+ }
45
+
46
+
47
+ @deprecated("This class is experimental. Use at your own risk.", category=ExperimentalClassWarning)
48
+ @dataclass(frozen=True)
49
+ class TypesMap:
50
+ """
51
+ Represents a mapping between a current type and its corresponding target type.
52
+ """
53
+
54
+ target_type: Union[List[str], str]
55
+ current_type: Union[List[str], str]
56
+
57
+
58
+ @deprecated("This class is experimental. Use at your own risk.", category=ExperimentalClassWarning)
59
+ @dataclass
60
+ class SchemaTypeIdentifier:
61
+ """
62
+ Identifies schema details for dynamic schema extraction and processing.
63
+ """
64
+
65
+ key_pointer: List[Union[InterpolatedString, str]]
66
+ parameters: InitVar[Mapping[str, Any]]
67
+ type_pointer: Optional[List[Union[InterpolatedString, str]]] = None
68
+ types_mapping: Optional[List[TypesMap]] = None
69
+ schema_pointer: Optional[List[Union[InterpolatedString, str]]] = None
70
+
71
+ def __post_init__(self, parameters: Mapping[str, Any]) -> None:
72
+ self.schema_pointer = (
73
+ self._update_pointer(self.schema_pointer, parameters) if self.schema_pointer else []
74
+ ) # type: ignore[assignment] # This is reqired field in model
75
+ self.key_pointer = self._update_pointer(self.key_pointer, parameters) # type: ignore[assignment] # This is reqired field in model
76
+ self.type_pointer = (
77
+ self._update_pointer(self.type_pointer, parameters) if self.type_pointer else None
78
+ )
79
+
80
+ @staticmethod
81
+ def _update_pointer(
82
+ pointer: Optional[List[Union[InterpolatedString, str]]], parameters: Mapping[str, Any]
83
+ ) -> Optional[List[Union[InterpolatedString, str]]]:
84
+ return (
85
+ [
86
+ InterpolatedString.create(path, parameters=parameters)
87
+ if isinstance(path, str)
88
+ else path
89
+ for path in pointer
90
+ ]
91
+ if pointer
92
+ else None
93
+ )
94
+
95
+
96
+ @deprecated("This class is experimental. Use at your own risk.", category=ExperimentalClassWarning)
97
+ @dataclass
98
+ class DynamicSchemaLoader(SchemaLoader):
99
+ """
100
+ Dynamically loads a JSON Schema by extracting data from retrieved records.
101
+ """
102
+
103
+ retriever: Retriever
104
+ config: Config
105
+ parameters: InitVar[Mapping[str, Any]]
106
+ schema_type_identifier: SchemaTypeIdentifier
107
+ schema_transformations: List[RecordTransformation] = field(default_factory=lambda: [])
108
+
109
+ def get_json_schema(self) -> Mapping[str, Any]:
110
+ """
111
+ Constructs a JSON Schema based on retrieved data.
112
+ """
113
+ properties = {}
114
+ retrieved_record = next(self.retriever.read_records({}), None) # type: ignore[call-overload] # read_records return Iterable data type
115
+
116
+ raw_schema = (
117
+ self._extract_data(
118
+ retrieved_record, # type: ignore[arg-type] # Expected that retrieved_record will be only Mapping[str, Any]
119
+ self.schema_type_identifier.schema_pointer,
120
+ )
121
+ if retrieved_record
122
+ else []
123
+ )
124
+
125
+ for property_definition in raw_schema:
126
+ key = self._get_key(property_definition, self.schema_type_identifier.key_pointer)
127
+ value = self._get_type(
128
+ property_definition,
129
+ self.schema_type_identifier.type_pointer,
130
+ )
131
+ properties[key] = value
132
+
133
+ transformed_properties = self._transform(properties, {})
134
+
135
+ return {
136
+ "$schema": "http://json-schema.org/draft-07/schema#",
137
+ "type": "object",
138
+ "properties": transformed_properties,
139
+ }
140
+
141
+ def _transform(
142
+ self,
143
+ properties: Mapping[str, Any],
144
+ stream_state: StreamState,
145
+ stream_slice: Optional[StreamSlice] = None,
146
+ ) -> Mapping[str, Any]:
147
+ for transformation in self.schema_transformations:
148
+ transformation.transform(
149
+ properties, # type: ignore # properties has type Mapping[str, Any], but Dict[str, Any] expected
150
+ config=self.config,
151
+ )
152
+ return properties
153
+
154
+ def _get_key(
155
+ self,
156
+ raw_schema: MutableMapping[str, Any],
157
+ field_key_path: List[Union[InterpolatedString, str]],
158
+ ) -> str:
159
+ """
160
+ Extracts the key field from the schema using the specified path.
161
+ """
162
+ field_key = self._extract_data(raw_schema, field_key_path)
163
+ if not isinstance(field_key, str):
164
+ raise ValueError(f"Expected key to be a string. Got {field_key}")
165
+ return field_key
166
+
167
+ def _get_type(
168
+ self,
169
+ raw_schema: MutableMapping[str, Any],
170
+ field_type_path: Optional[List[Union[InterpolatedString, str]]],
171
+ ) -> Union[Mapping[str, Any], List[Mapping[str, Any]]]:
172
+ """
173
+ Determines the JSON Schema type for a field, supporting nullable and combined types.
174
+ """
175
+ raw_field_type = (
176
+ self._extract_data(raw_schema, field_type_path, default="string")
177
+ if field_type_path
178
+ else "string"
179
+ )
180
+ mapped_field_type = self._replace_type_if_not_valid(raw_field_type)
181
+ if (
182
+ isinstance(mapped_field_type, list)
183
+ and len(mapped_field_type) == 2
184
+ and all(isinstance(item, str) for item in mapped_field_type)
185
+ ):
186
+ first_type = self._get_airbyte_type(mapped_field_type[0])
187
+ second_type = self._get_airbyte_type(mapped_field_type[1])
188
+ return {"oneOf": [first_type, second_type]}
189
+ elif isinstance(mapped_field_type, str):
190
+ return self._get_airbyte_type(mapped_field_type)
191
+ else:
192
+ raise ValueError(
193
+ f"Invalid data type. Available string or two items list of string. Got {mapped_field_type}."
194
+ )
195
+
196
+ def _replace_type_if_not_valid(
197
+ self, field_type: Union[List[str], str]
198
+ ) -> Union[List[str], str]:
199
+ """
200
+ Replaces a field type if it matches a type mapping in `types_map`.
201
+ """
202
+ if self.schema_type_identifier.types_mapping:
203
+ for types_map in self.schema_type_identifier.types_mapping:
204
+ if field_type == types_map.current_type:
205
+ return types_map.target_type
206
+ return field_type
207
+
208
+ @staticmethod
209
+ def _get_airbyte_type(field_type: str) -> Mapping[str, Any]:
210
+ """
211
+ Maps a field type to its corresponding Airbyte type definition.
212
+ """
213
+ if field_type not in AIRBYTE_DATA_TYPES:
214
+ raise ValueError(f"Invalid Airbyte data type: {field_type}")
215
+
216
+ return deepcopy(AIRBYTE_DATA_TYPES[field_type])
217
+
218
+ def _extract_data(
219
+ self,
220
+ body: Mapping[str, Any],
221
+ extraction_path: Optional[List[Union[InterpolatedString, str]]] = None,
222
+ default: Any = None,
223
+ ) -> Any:
224
+ """
225
+ Extracts data from the body based on the provided extraction path.
226
+ """
227
+
228
+ if not extraction_path:
229
+ return body
230
+
231
+ path = [
232
+ node.eval(self.config) if not isinstance(node, str) else node
233
+ for node in extraction_path
234
+ ]
235
+
236
+ return dpath.get(body, path, default=default) # type: ignore # extracted will be a MutableMapping, given input data structure
@@ -6,11 +6,11 @@ import json
6
6
  import pkgutil
7
7
  import sys
8
8
  from dataclasses import InitVar, dataclass, field
9
- from typing import Any, Mapping, Union
9
+ from typing import Any, Mapping, Tuple, Union
10
10
 
11
11
  from airbyte_cdk.sources.declarative.interpolation.interpolated_string import InterpolatedString
12
12
  from airbyte_cdk.sources.declarative.schema.schema_loader import SchemaLoader
13
- from airbyte_cdk.sources.declarative.types import Config
13
+ from airbyte_cdk.sources.types import Config
14
14
  from airbyte_cdk.sources.utils.schema_helpers import ResourceSchemaLoader
15
15
 
16
16
 
@@ -18,7 +18,7 @@ def _default_file_path() -> str:
18
18
  # Schema files are always in "source_<connector_name>/schemas/<stream_name>.json
19
19
  # The connector's module name can be inferred by looking at the modules loaded and look for the one starting with source_
20
20
  source_modules = [
21
- k for k, v in sys.modules.items() if "source_" in k
21
+ k for k, v in sys.modules.items() if "source_" in k and "airbyte_cdk" not in k
22
22
  ] # example: ['source_exchange_rates', 'source_exchange_rates.source']
23
23
  if source_modules:
24
24
  module = source_modules[0].split(".")[0]
@@ -43,9 +43,9 @@ class JsonFileSchemaLoader(ResourceSchemaLoader, SchemaLoader):
43
43
 
44
44
  config: Config
45
45
  parameters: InitVar[Mapping[str, Any]]
46
- file_path: Union[InterpolatedString, str] = field(default=None)
46
+ file_path: Union[InterpolatedString, str] = field(default="")
47
47
 
48
- def __post_init__(self, parameters: Mapping[str, Any]):
48
+ def __post_init__(self, parameters: Mapping[str, Any]) -> None:
49
49
  if not self.file_path:
50
50
  self.file_path = _default_file_path()
51
51
  self.file_path = InterpolatedString.create(self.file_path, parameters=parameters)
@@ -66,11 +66,11 @@ class JsonFileSchemaLoader(ResourceSchemaLoader, SchemaLoader):
66
66
  self.package_name = resource
67
67
  return self._resolve_schema_references(raw_schema)
68
68
 
69
- def _get_json_filepath(self):
70
- return self.file_path.eval(self.config)
69
+ def _get_json_filepath(self) -> Any:
70
+ return self.file_path.eval(self.config) # type: ignore # file_path is always cast to an interpolated string
71
71
 
72
72
  @staticmethod
73
- def extract_resource_and_schema_path(json_schema_path: str) -> (str, str):
73
+ def extract_resource_and_schema_path(json_schema_path: str) -> Tuple[str, str]:
74
74
  """
75
75
  When the connector is running on a docker container, package_data is accessible from the resource (source_<name>), so we extract
76
76
  the resource from the first part of the schema path and the remaining path is used to find the schema file. This is a slight
@@ -5,7 +5,11 @@
5
5
  from dataclasses import InitVar, dataclass
6
6
  from typing import Any, Mapping, Optional
7
7
 
8
- from airbyte_cdk.models.airbyte_protocol import ConnectorSpecification
8
+ from airbyte_cdk.models import (
9
+ AdvancedAuth,
10
+ ConnectorSpecification,
11
+ ConnectorSpecificationSerializer,
12
+ )
9
13
  from airbyte_cdk.sources.declarative.models.declarative_component_schema import AuthFlow
10
14
 
11
15
 
@@ -29,13 +33,16 @@ class Spec:
29
33
  Returns the connector specification according the spec block defined in the low code connector manifest.
30
34
  """
31
35
 
32
- obj = {"connectionSpecification": self.connection_specification}
36
+ obj: dict[str, Mapping[str, Any] | str | AdvancedAuth] = {
37
+ "connectionSpecification": self.connection_specification
38
+ }
33
39
 
34
40
  if self.documentation_url:
35
41
  obj["documentationUrl"] = self.documentation_url
36
42
  if self.advanced_auth:
37
- obj["advanced_auth"] = self.advanced_auth
38
- obj["advanced_auth"].auth_flow_type = obj["advanced_auth"].auth_flow_type.value # Get enum value
43
+ self.advanced_auth.auth_flow_type = self.advanced_auth.auth_flow_type.value # type: ignore # We know this is always assigned to an AuthFlow which has the auth_flow_type field
44
+ # Map CDK AuthFlow model to protocol AdvancedAuth model
45
+ obj["advanced_auth"] = self.advanced_auth.dict()
39
46
 
40
47
  # We remap these keys to camel case because that's the existing format expected by the rest of the platform
41
- return ConnectorSpecification.parse_obj(obj)
48
+ return ConnectorSpecificationSerializer.load(obj)
@@ -2,7 +2,6 @@
2
2
  # Copyright (c) 2023 Airbyte, Inc., all rights reserved.
3
3
  #
4
4
 
5
- from airbyte_cdk.sources.declarative.stream_slicers.cartesian_product_stream_slicer import CartesianProductStreamSlicer
6
5
  from airbyte_cdk.sources.declarative.stream_slicers.stream_slicer import StreamSlicer
7
6
 
8
- __all__ = ["CartesianProductStreamSlicer", "StreamSlicer"]
7
+ __all__ = ["StreamSlicer"]
@@ -0,0 +1,88 @@
1
+ # Copyright (c) 2024 Airbyte, Inc., all rights reserved.
2
+
3
+ from typing import Any, Iterable, Mapping, Optional
4
+
5
+ from airbyte_cdk.sources.declarative.retrievers import Retriever
6
+ from airbyte_cdk.sources.message import MessageRepository
7
+ from airbyte_cdk.sources.streams.concurrent.partitions.partition import Partition
8
+ from airbyte_cdk.sources.streams.concurrent.partitions.partition_generator import PartitionGenerator
9
+ from airbyte_cdk.sources.streams.concurrent.partitions.stream_slicer import StreamSlicer
10
+ from airbyte_cdk.sources.types import Record, StreamSlice
11
+ from airbyte_cdk.utils.slice_hasher import SliceHasher
12
+
13
+
14
+ class DeclarativePartitionFactory:
15
+ def __init__(
16
+ self,
17
+ stream_name: str,
18
+ json_schema: Mapping[str, Any],
19
+ retriever: Retriever,
20
+ message_repository: MessageRepository,
21
+ ) -> None:
22
+ """
23
+ The DeclarativePartitionFactory takes a retriever_factory and not a retriever directly. The reason is that our components are not
24
+ thread safe and classes like `DefaultPaginator` may not work because multiple threads can access and modify a shared field across each other.
25
+ In order to avoid these problems, we will create one retriever per thread which should make the processing thread-safe.
26
+ """
27
+ self._stream_name = stream_name
28
+ self._json_schema = json_schema
29
+ self._retriever = retriever
30
+ self._message_repository = message_repository
31
+
32
+ def create(self, stream_slice: StreamSlice) -> Partition:
33
+ return DeclarativePartition(
34
+ self._stream_name,
35
+ self._json_schema,
36
+ self._retriever,
37
+ self._message_repository,
38
+ stream_slice,
39
+ )
40
+
41
+
42
+ class DeclarativePartition(Partition):
43
+ def __init__(
44
+ self,
45
+ stream_name: str,
46
+ json_schema: Mapping[str, Any],
47
+ retriever: Retriever,
48
+ message_repository: MessageRepository,
49
+ stream_slice: StreamSlice,
50
+ ):
51
+ self._stream_name = stream_name
52
+ self._json_schema = json_schema
53
+ self._retriever = retriever
54
+ self._message_repository = message_repository
55
+ self._stream_slice = stream_slice
56
+ self._hash = SliceHasher.hash(self._stream_name, self._stream_slice)
57
+
58
+ def read(self) -> Iterable[Record]:
59
+ for stream_data in self._retriever.read_records(self._json_schema, self._stream_slice):
60
+ if isinstance(stream_data, Mapping):
61
+ yield Record(
62
+ data=stream_data,
63
+ stream_name=self.stream_name(),
64
+ associated_slice=self._stream_slice,
65
+ )
66
+ else:
67
+ self._message_repository.emit_message(stream_data)
68
+
69
+ def to_slice(self) -> Optional[Mapping[str, Any]]:
70
+ return self._stream_slice
71
+
72
+ def stream_name(self) -> str:
73
+ return self._stream_name
74
+
75
+ def __hash__(self) -> int:
76
+ return self._hash
77
+
78
+
79
+ class StreamSlicerPartitionGenerator(PartitionGenerator):
80
+ def __init__(
81
+ self, partition_factory: DeclarativePartitionFactory, stream_slicer: StreamSlicer
82
+ ) -> None:
83
+ self._partition_factory = partition_factory
84
+ self._stream_slicer = stream_slicer
85
+
86
+ def generate(self) -> Iterable[Partition]:
87
+ for stream_slice in self._stream_slicer.stream_slices():
88
+ yield self._partition_factory.create(stream_slice)
@@ -2,16 +2,17 @@
2
2
  # Copyright (c) 2023 Airbyte, Inc., all rights reserved.
3
3
  #
4
4
 
5
- from abc import abstractmethod
6
- from dataclasses import dataclass
7
- from typing import Iterable
5
+ from abc import ABC
8
6
 
9
- from airbyte_cdk.sources.declarative.requesters.request_options.request_options_provider import RequestOptionsProvider
10
- from airbyte_cdk.sources.declarative.types import StreamSlice
7
+ from airbyte_cdk.sources.declarative.requesters.request_options.request_options_provider import (
8
+ RequestOptionsProvider,
9
+ )
10
+ from airbyte_cdk.sources.streams.concurrent.partitions.stream_slicer import (
11
+ StreamSlicer as ConcurrentStreamSlicer,
12
+ )
11
13
 
12
14
 
13
- @dataclass
14
- class StreamSlicer(RequestOptionsProvider):
15
+ class StreamSlicer(ConcurrentStreamSlicer, RequestOptionsProvider, ABC):
15
16
  """
16
17
  Slices the stream into a subset of records.
17
18
  Slices enable state checkpointing and data retrieval parallelization.
@@ -21,10 +22,4 @@ class StreamSlicer(RequestOptionsProvider):
21
22
  See the stream slicing section of the docs for more information.
22
23
  """
23
24
 
24
- @abstractmethod
25
- def stream_slices(self) -> Iterable[StreamSlice]:
26
- """
27
- Defines stream slices
28
-
29
- :return: List of stream slices
30
- """
25
+ pass
@@ -3,12 +3,13 @@
3
3
  #
4
4
 
5
5
  from dataclasses import InitVar, dataclass, field
6
- from typing import Any, List, Mapping, Optional, Type, Union
6
+ from typing import Any, Dict, List, Mapping, Optional, Type, Union
7
+
8
+ import dpath
7
9
 
8
- import dpath.util
9
10
  from airbyte_cdk.sources.declarative.interpolation.interpolated_string import InterpolatedString
10
11
  from airbyte_cdk.sources.declarative.transformations import RecordTransformation
11
- from airbyte_cdk.sources.declarative.types import Config, FieldPointer, Record, StreamSlice, StreamState
12
+ from airbyte_cdk.sources.types import Config, FieldPointer, StreamSlice, StreamState
12
13
 
13
14
 
14
15
  @dataclass(frozen=True)
@@ -85,12 +86,16 @@ class AddFields(RecordTransformation):
85
86
 
86
87
  fields: List[AddedFieldDefinition]
87
88
  parameters: InitVar[Mapping[str, Any]]
88
- _parsed_fields: List[ParsedAddFieldDefinition] = field(init=False, repr=False, default_factory=list)
89
+ _parsed_fields: List[ParsedAddFieldDefinition] = field(
90
+ init=False, repr=False, default_factory=list
91
+ )
89
92
 
90
93
  def __post_init__(self, parameters: Mapping[str, Any]) -> None:
91
94
  for add_field in self.fields:
92
95
  if len(add_field.path) < 1:
93
- raise ValueError(f"Expected a non-zero-length path for the AddFields transformation {add_field}")
96
+ raise ValueError(
97
+ f"Expected a non-zero-length path for the AddFields transformation {add_field}"
98
+ )
94
99
 
95
100
  if not isinstance(add_field.value, InterpolatedString):
96
101
  if not isinstance(add_field.value, str):
@@ -106,25 +111,28 @@ class AddFields(RecordTransformation):
106
111
  )
107
112
  else:
108
113
  self._parsed_fields.append(
109
- ParsedAddFieldDefinition(add_field.path, add_field.value, value_type=add_field.value_type, parameters={})
114
+ ParsedAddFieldDefinition(
115
+ add_field.path,
116
+ add_field.value,
117
+ value_type=add_field.value_type,
118
+ parameters={},
119
+ )
110
120
  )
111
121
 
112
122
  def transform(
113
123
  self,
114
- record: Record,
124
+ record: Dict[str, Any],
115
125
  config: Optional[Config] = None,
116
126
  stream_state: Optional[StreamState] = None,
117
127
  stream_slice: Optional[StreamSlice] = None,
118
- ) -> Record:
128
+ ) -> None:
119
129
  if config is None:
120
130
  config = {}
121
131
  kwargs = {"record": record, "stream_state": stream_state, "stream_slice": stream_slice}
122
132
  for parsed_field in self._parsed_fields:
123
133
  valid_types = (parsed_field.value_type,) if parsed_field.value_type else None
124
134
  value = parsed_field.value.eval(config, valid_types=valid_types, **kwargs)
125
- dpath.util.new(record, parsed_field.path, value)
126
-
127
- return record
135
+ dpath.new(record, parsed_field.path, value)
128
136
 
129
137
  def __eq__(self, other: Any) -> bool:
130
138
  return bool(self.__dict__ == other.__dict__)
@@ -0,0 +1,52 @@
1
+ #
2
+ # Copyright (c) 2024 Airbyte, Inc., all rights reserved.
3
+ #
4
+
5
+ from dataclasses import dataclass
6
+ from typing import Any, Dict, Optional
7
+
8
+ from airbyte_cdk.sources.declarative.transformations import RecordTransformation
9
+ from airbyte_cdk.sources.types import Config, StreamSlice, StreamState
10
+
11
+
12
+ @dataclass
13
+ class FlattenFields(RecordTransformation):
14
+ flatten_lists: bool = True
15
+
16
+ def transform(
17
+ self,
18
+ record: Dict[str, Any],
19
+ config: Optional[Config] = None,
20
+ stream_state: Optional[StreamState] = None,
21
+ stream_slice: Optional[StreamSlice] = None,
22
+ ) -> None:
23
+ transformed_record = self.flatten_record(record)
24
+ record.clear()
25
+ record.update(transformed_record)
26
+
27
+ def flatten_record(self, record: Dict[str, Any]) -> Dict[str, Any]:
28
+ stack = [(record, "_")]
29
+ transformed_record: Dict[str, Any] = {}
30
+ force_with_parent_name = False
31
+
32
+ while stack:
33
+ current_record, parent_key = stack.pop()
34
+
35
+ if isinstance(current_record, dict):
36
+ for current_key, value in current_record.items():
37
+ new_key = (
38
+ f"{parent_key}.{current_key}"
39
+ if (current_key in transformed_record or force_with_parent_name)
40
+ else current_key
41
+ )
42
+ stack.append((value, new_key))
43
+
44
+ elif isinstance(current_record, list) and self.flatten_lists:
45
+ for i, item in enumerate(current_record):
46
+ force_with_parent_name = True
47
+ stack.append((item, f"{parent_key}.{i}"))
48
+
49
+ else:
50
+ transformed_record[parent_key] = current_record
51
+
52
+ return transformed_record
@@ -0,0 +1,61 @@
1
+ #
2
+ # Copyright (c) 2024 Airbyte, Inc., all rights reserved.
3
+ #
4
+
5
+ from dataclasses import InitVar, dataclass
6
+ from typing import Any, Dict, Mapping, Optional
7
+
8
+ from airbyte_cdk import InterpolatedString
9
+ from airbyte_cdk.sources.declarative.transformations import RecordTransformation
10
+ from airbyte_cdk.sources.types import Config, StreamSlice, StreamState
11
+
12
+
13
+ @dataclass
14
+ class KeysReplaceTransformation(RecordTransformation):
15
+ """
16
+ Transformation that applies keys names replacement.
17
+
18
+ Example usage:
19
+ - type: KeysReplace
20
+ old: " "
21
+ new: "_"
22
+ Result:
23
+ from: {"created time": ..., "customer id": ..., "user id": ...}
24
+ to: {"created_time": ..., "customer_id": ..., "user_id": ...}
25
+ """
26
+
27
+ old: str
28
+ new: str
29
+ parameters: InitVar[Mapping[str, Any]]
30
+
31
+ def __post_init__(self, parameters: Mapping[str, Any]) -> None:
32
+ self._old = InterpolatedString.create(self.old, parameters=parameters)
33
+ self._new = InterpolatedString.create(self.new, parameters=parameters)
34
+
35
+ def transform(
36
+ self,
37
+ record: Dict[str, Any],
38
+ config: Optional[Config] = None,
39
+ stream_state: Optional[StreamState] = None,
40
+ stream_slice: Optional[StreamSlice] = None,
41
+ ) -> None:
42
+ if config is None:
43
+ config = {}
44
+
45
+ kwargs = {"record": record, "stream_state": stream_state, "stream_slice": stream_slice}
46
+ old_key = str(self._old.eval(config, **kwargs))
47
+ new_key = str(self._new.eval(config, **kwargs))
48
+
49
+ def _transform(data: Dict[str, Any]) -> Dict[str, Any]:
50
+ result = {}
51
+ for key, value in data.items():
52
+ updated_key = key.replace(old_key, new_key)
53
+ if isinstance(value, dict):
54
+ result[updated_key] = _transform(value)
55
+ else:
56
+ result[updated_key] = value
57
+ return result
58
+
59
+ transformed_record = _transform(record)
60
+ record.clear()
61
+ record.update(transformed_record)
@@ -0,0 +1,22 @@
1
+ #
2
+ # Copyright (c) 2023 Airbyte, Inc., all rights reserved.
3
+ #
4
+
5
+ from dataclasses import dataclass
6
+ from typing import Any, Dict, Optional
7
+
8
+ from airbyte_cdk.sources.declarative.transformations import RecordTransformation
9
+ from airbyte_cdk.sources.types import Config, StreamSlice, StreamState
10
+
11
+
12
+ @dataclass
13
+ class KeysToLowerTransformation(RecordTransformation):
14
+ def transform(
15
+ self,
16
+ record: Dict[str, Any],
17
+ config: Optional[Config] = None,
18
+ stream_state: Optional[StreamState] = None,
19
+ stream_slice: Optional[StreamSlice] = None,
20
+ ) -> None:
21
+ for key in set(record.keys()):
22
+ record[key.lower()] = record.pop(key)