hare-orm 0.13.0__cp315-cp315-win_amd64.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 (2582) hide show
  1. hare/__init__.py +51 -0
  2. hare/__main__.py +8 -0
  3. hare/classes/__init__.py +1 -0
  4. hare/classes/class_path.py +69 -0
  5. hare/classes/class_property.py +18 -0
  6. hare/classes/comparable_values.py +191 -0
  7. hare/classes/constants.py +18 -0
  8. hare/classes/container_traversal.py +29 -0
  9. hare/classes/declared_subclass.py +26 -0
  10. hare/classes/deferred_import.py +45 -0
  11. hare/classes/lazy_exports.py +56 -0
  12. hare/classes/shown_value_repr.py +21 -0
  13. hare/classes/value_descriptions.py +81 -0
  14. hare/cli/__init__.py +3 -0
  15. hare/cli/__main__.py +7 -0
  16. hare/cli/arg_parser_builder.py +451 -0
  17. hare/cli/commands/__init__.py +0 -0
  18. hare/cli/commands/database_shell_commands.py +59 -0
  19. hare/cli/commands/distributed_recovery_commands.py +68 -0
  20. hare/cli/commands/interactive_rename_questions.py +30 -0
  21. hare/cli/commands/migration_commands.py +498 -0
  22. hare/cli/commands/schema_commands.py +115 -0
  23. hare/cli/commands/stub_commands.py +69 -0
  24. hare/cli/config_locator.py +37 -0
  25. hare/cli/constants.py +24 -0
  26. hare/cli/context/__init__.py +9 -0
  27. hare/cli/context/cli_context.py +44 -0
  28. hare/cli/context/command_context.py +155 -0
  29. hare/cli/exceptions.py +9 -0
  30. hare/cli/hare_cli.py +131 -0
  31. hare/cli/messages.py +2 -0
  32. hare/cli/output/__init__.py +1 -0
  33. hare/cli/output/output_formatter.py +142 -0
  34. hare/cli/output/terminal_colors.py +89 -0
  35. hare/cli/parsed_command.py +18 -0
  36. hare/cli/plugins/__init__.py +16 -0
  37. hare/cli/plugins/cli_command.py +43 -0
  38. hare/cli/plugins/cli_command_registry.py +155 -0
  39. hare/cli/plugins/loaded_cli_command.py +13 -0
  40. hare/cli/shell_launcher.py +110 -0
  41. hare/cli/shell_session.py +98 -0
  42. hare/contrib/__init__.py +0 -0
  43. hare/contrib/application_lifecycle.py +233 -0
  44. hare/contrib/factories/__init__.py +39 -0
  45. hare/contrib/factories/constants.py +21 -0
  46. hare/contrib/factories/factory_reference.py +27 -0
  47. hare/contrib/factories/field_declarations/__init__.py +1 -0
  48. hare/contrib/factories/field_declarations/declaration.py +19 -0
  49. hare/contrib/factories/field_declarations/faker.py +49 -0
  50. hare/contrib/factories/field_declarations/iterator.py +36 -0
  51. hare/contrib/factories/field_declarations/lazy_attribute.py +35 -0
  52. hare/contrib/factories/field_declarations/lazy_function.py +22 -0
  53. hare/contrib/factories/field_declarations/many_to_many.py +40 -0
  54. hare/contrib/factories/field_declarations/post_declaration.py +22 -0
  55. hare/contrib/factories/field_declarations/related_factory.py +37 -0
  56. hare/contrib/factories/field_declarations/sequence.py +22 -0
  57. hare/contrib/factories/field_declarations/sub_factory.py +30 -0
  58. hare/contrib/factories/model_factory.py +289 -0
  59. hare/contrib/factories/trait.py +23 -0
  60. hare/contrib/frameworks/__init__.py +14 -0
  61. hare/contrib/frameworks/constants.py +43 -0
  62. hare/contrib/frameworks/error_answers.py +103 -0
  63. hare/contrib/frameworks/exceptions.py +19 -0
  64. hare/contrib/frameworks/fastapi/__init__.py +12 -0
  65. hare/contrib/frameworks/fastapi/constants.py +4 -0
  66. hare/contrib/frameworks/fastapi/hare_exception_handlers.py +102 -0
  67. hare/contrib/frameworks/fastapi/hare_fast_api.py +154 -0
  68. hare/contrib/frameworks/fastapi/middleware/__init__.py +7 -0
  69. hare/contrib/frameworks/fastapi/middleware/request_state_reset_middleware.py +35 -0
  70. hare/contrib/frameworks/fastapi/middleware/transaction_failing_handler.py +69 -0
  71. hare/contrib/frameworks/fastapi/middleware/transaction_middleware.py +72 -0
  72. hare/contrib/frameworks/fastapi/request_query_dependency.py +105 -0
  73. hare/contrib/frameworks/hare_lifecycle.py +71 -0
  74. hare/contrib/frameworks/health_routes.py +83 -0
  75. hare/contrib/frameworks/litestar/__init__.py +14 -0
  76. hare/contrib/frameworks/litestar/constants.py +18 -0
  77. hare/contrib/frameworks/litestar/declarations.py +12 -0
  78. hare/contrib/frameworks/litestar/hare_dto.py +296 -0
  79. hare/contrib/frameworks/litestar/hare_dto_backend.py +28 -0
  80. hare/contrib/frameworks/litestar/hare_dto_extra_fields.py +268 -0
  81. hare/contrib/frameworks/litestar/hare_exception_handlers.py +77 -0
  82. hare/contrib/frameworks/litestar/hare_plugin.py +192 -0
  83. hare/contrib/frameworks/litestar/hare_transfer_function_factory.py +96 -0
  84. hare/contrib/frameworks/litestar/middleware/__init__.py +7 -0
  85. hare/contrib/frameworks/litestar/middleware/request_state_reset_middleware.py +34 -0
  86. hare/contrib/frameworks/litestar/middleware/transaction_middleware.py +35 -0
  87. hare/contrib/frameworks/litestar/request_query_di_plugin.py +112 -0
  88. hare/contrib/frameworks/pages/__init__.py +22 -0
  89. hare/contrib/frameworks/pages/cursor_page_schema.py +25 -0
  90. hare/contrib/frameworks/pages/page_schema.py +25 -0
  91. hare/contrib/frameworks/pages/scroll_page_schema.py +23 -0
  92. hare/contrib/frameworks/parameter_annotation.py +122 -0
  93. hare/contrib/frameworks/request_state.py +16 -0
  94. hare/contrib/frameworks/request_transaction.py +148 -0
  95. hare/contrib/frameworks/robyn/__init__.py +13 -0
  96. hare/contrib/frameworks/robyn/application/__init__.py +11 -0
  97. hare/contrib/frameworks/robyn/application/hare_robyn.py +273 -0
  98. hare/contrib/frameworks/robyn/application/hare_sub_router.py +42 -0
  99. hare/contrib/frameworks/robyn/constants.py +32 -0
  100. hare/contrib/frameworks/robyn/hare_exception_handlers.py +127 -0
  101. hare/contrib/frameworks/robyn/hare_open_api.py +97 -0
  102. hare/contrib/frameworks/robyn/route_handler.py +220 -0
  103. hare/contrib/mypy/__init__.py +11 -0
  104. hare/contrib/mypy/annotation_types.py +208 -0
  105. hare/contrib/mypy/constants.py +87 -0
  106. hare/contrib/mypy/enums.py +20 -0
  107. hare/contrib/mypy/field_names_check.py +223 -0
  108. hare/contrib/mypy/filter_arguments_check.py +130 -0
  109. hare/contrib/mypy/hare_mypy_plugin.py +166 -0
  110. hare/contrib/mypy/instance_attribute_types.py +140 -0
  111. hare/contrib/mypy/model_registry.py +253 -0
  112. hare/contrib/mypy/mypy_types.py +393 -0
  113. hare/contrib/mypy/queryset_extension_methods.py +90 -0
  114. hare/contrib/mypy/values_row_types.py +171 -0
  115. hare/contrib/mypy/values_selection_types.py +99 -0
  116. hare/contrib/mypy/write_arguments_check.py +144 -0
  117. hare/contrib/notify/__init__.py +5 -0
  118. hare/contrib/notify/constants.py +14 -0
  119. hare/contrib/notify/notification_listener.py +358 -0
  120. hare/contrib/opentelemetry/__init__.py +16 -0
  121. hare/contrib/opentelemetry/constants.py +31 -0
  122. hare/contrib/opentelemetry/open_telemetry_instrumentor.py +65 -0
  123. hare/contrib/opentelemetry/pool_metric_instruments.py +274 -0
  124. hare/contrib/opentelemetry/query_spans.py +72 -0
  125. hare/contrib/outbox/__init__.py +75 -0
  126. hare/contrib/outbox/brokers/__init__.py +1 -0
  127. hare/contrib/outbox/brokers/kafka_connection.py +46 -0
  128. hare/contrib/outbox/brokers/rabbitmq_connection.py +58 -0
  129. hare/contrib/outbox/brokers/redis_connection.py +44 -0
  130. hare/contrib/outbox/capture/__init__.py +6 -0
  131. hare/contrib/outbox/capture/change_capture.py +496 -0
  132. hare/contrib/outbox/capture/change_extension.py +22 -0
  133. hare/contrib/outbox/capture/constants.py +18 -0
  134. hare/contrib/outbox/constants.py +30 -0
  135. hare/contrib/outbox/deliveries/__init__.py +26 -0
  136. hare/contrib/outbox/deliveries/callable_delivery.py +39 -0
  137. hare/contrib/outbox/deliveries/constants.py +28 -0
  138. hare/contrib/outbox/deliveries/delivery_batch.py +43 -0
  139. hare/contrib/outbox/deliveries/delivery_result.py +20 -0
  140. hare/contrib/outbox/deliveries/kafka_delivery.py +116 -0
  141. hare/contrib/outbox/deliveries/messages.py +3 -0
  142. hare/contrib/outbox/deliveries/outbox_delivery.py +117 -0
  143. hare/contrib/outbox/deliveries/rabbitmq_delivery.py +58 -0
  144. hare/contrib/outbox/deliveries/redis_streams_delivery.py +106 -0
  145. hare/contrib/outbox/deliveries/topic_router.py +104 -0
  146. hare/contrib/outbox/deliveries/webhook_delivery.py +215 -0
  147. hare/contrib/outbox/deliveries/webhook_target.py +19 -0
  148. hare/contrib/outbox/exceptions.py +7 -0
  149. hare/contrib/outbox/outbox_enqueue.py +325 -0
  150. hare/contrib/outbox/outbox_event.py +330 -0
  151. hare/contrib/outbox/outbox_idempotency.py +307 -0
  152. hare/contrib/outbox/outbox_json_encoding.py +39 -0
  153. hare/contrib/outbox/outbox_message.py +27 -0
  154. hare/contrib/outbox/outbox_release.py +43 -0
  155. hare/contrib/outbox/outbox_validation.py +80 -0
  156. hare/contrib/outbox/outbox_wakeups.py +63 -0
  157. hare/contrib/outbox/relay/__init__.py +17 -0
  158. hare/contrib/outbox/relay/claimed_batch.py +17 -0
  159. hare/contrib/outbox/relay/constants.py +38 -0
  160. hare/contrib/outbox/relay/declarations.py +76 -0
  161. hare/contrib/outbox/relay/outbox_backlog.py +18 -0
  162. hare/contrib/outbox/relay/outbox_relay.py +547 -0
  163. hare/contrib/outbox/relay/outbox_store.py +343 -0
  164. hare/contrib/outbox/relay/topic_selection.py +111 -0
  165. hare/contrib/outbox/wakeups/__init__.py +20 -0
  166. hare/contrib/outbox/wakeups/constants.py +17 -0
  167. hare/contrib/outbox/wakeups/in_process_wakeup.py +21 -0
  168. hare/contrib/outbox/wakeups/kafka_wakeup.py +103 -0
  169. hare/contrib/outbox/wakeups/listen_notify_wakeup.py +83 -0
  170. hare/contrib/outbox/wakeups/outbox_wakeup.py +316 -0
  171. hare/contrib/outbox/wakeups/rabbitmq_wakeup.py +63 -0
  172. hare/contrib/outbox/wakeups/redis_wakeup.py +53 -0
  173. hare/contrib/package_checks.py +25 -0
  174. hare/contrib/pydantic/__init__.py +12 -0
  175. hare/contrib/pydantic/constants.py +43 -0
  176. hare/contrib/pydantic/creation/__init__.py +1 -0
  177. hare/contrib/pydantic/creation/computed_field_schemas.py +86 -0
  178. hare/contrib/pydantic/creation/data_field_schemas.py +254 -0
  179. hare/contrib/pydantic/creation/extra_field_schemas.py +149 -0
  180. hare/contrib/pydantic/creation/field_descriptions.py +17 -0
  181. hare/contrib/pydantic/creation/field_map.py +119 -0
  182. hare/contrib/pydantic/creation/generic_foreign_key_schemas.py +137 -0
  183. hare/contrib/pydantic/creation/generic_foreign_key_tag_reader.py +36 -0
  184. hare/contrib/pydantic/creation/model_annotations.py +122 -0
  185. hare/contrib/pydantic/creation/pydantic_creators.py +194 -0
  186. hare/contrib/pydantic/creation/pydantic_meta_reading.py +146 -0
  187. hare/contrib/pydantic/creation/pydantic_model_creator.py +479 -0
  188. hare/contrib/pydantic/creation/relation_field_schemas.py +280 -0
  189. hare/contrib/pydantic/descriptions/__init__.py +5 -0
  190. hare/contrib/pydantic/descriptions/computed_field_description.py +11 -0
  191. hare/contrib/pydantic/descriptions/model_description.py +68 -0
  192. hare/contrib/pydantic/descriptions/pydantic_field_source.py +95 -0
  193. hare/contrib/pydantic/descriptions/pydantic_meta_data.py +188 -0
  194. hare/contrib/pydantic/descriptions/pydantic_serialization_description.py +99 -0
  195. hare/contrib/pydantic/messages.py +14 -0
  196. hare/contrib/pydantic/models/__init__.py +9 -0
  197. hare/contrib/pydantic/models/orm_validation_source.py +20 -0
  198. hare/contrib/pydantic/models/pydantic_list_model.py +34 -0
  199. hare/contrib/pydantic/models/pydantic_model.py +180 -0
  200. hare/contrib/pydantic_field_aliases.py +28 -0
  201. hare/contrib/pytest/__init__.py +17 -0
  202. hare/contrib/pytest/constants.py +32 -0
  203. hare/contrib/pytest/hare_fixtures.py +139 -0
  204. hare/contrib/pytest/missing_pytest_asyncio_fixtures.py +42 -0
  205. hare/contrib/pytest/plugin.py +49 -0
  206. hare/contrib/repeated_queries/__init__.py +19 -0
  207. hare/contrib/repeated_queries/constants.py +4 -0
  208. hare/contrib/repeated_queries/repeated_query_collection.py +113 -0
  209. hare/contrib/repeated_queries/repeated_query_detector.py +182 -0
  210. hare/contrib/repeated_queries/repeated_query_entry.py +20 -0
  211. hare/contrib/repeated_queries/repeated_query_report.py +31 -0
  212. hare/contrib/repeated_queries/shape_stats.py +18 -0
  213. hare/contrib/request_query/__init__.py +101 -0
  214. hare/contrib/request_query/api_getter/__init__.py +27 -0
  215. hare/contrib/request_query/api_getter/api_enrichment_batch.py +124 -0
  216. hare/contrib/request_query/api_getter/api_getter.py +363 -0
  217. hare/contrib/request_query/api_getter/api_getter_retry.py +72 -0
  218. hare/contrib/request_query/api_getter/api_getter_triggers.py +33 -0
  219. hare/contrib/request_query/api_getter/api_http_requests.py +182 -0
  220. hare/contrib/request_query/api_getter/api_source.py +110 -0
  221. hare/contrib/request_query/api_getter/api_value_mapping.py +64 -0
  222. hare/contrib/request_query/api_getter/api_value_paths.py +123 -0
  223. hare/contrib/request_query/api_getter/constants.py +41 -0
  224. hare/contrib/request_query/api_getter/declarations.py +60 -0
  225. hare/contrib/request_query/api_getter/enums.py +34 -0
  226. hare/contrib/request_query/bounds/__init__.py +6 -0
  227. hare/contrib/request_query/bounds/constants.py +4 -0
  228. hare/contrib/request_query/bounds/lookup_pair_bounds.py +40 -0
  229. hare/contrib/request_query/bounds/parameter_bounds.py +41 -0
  230. hare/contrib/request_query/bounds/range_bounds.py +30 -0
  231. hare/contrib/request_query/constants.py +75 -0
  232. hare/contrib/request_query/declaration/__init__.py +6 -0
  233. hare/contrib/request_query/declaration/constants.py +19 -0
  234. hare/contrib/request_query/declaration/declaration_builder.py +532 -0
  235. hare/contrib/request_query/declaration/filter_declaration.py +25 -0
  236. hare/contrib/request_query/declaration/filter_parameter_builder.py +204 -0
  237. hare/contrib/request_query/declaration/meta_option_checks.py +62 -0
  238. hare/contrib/request_query/declaration/parameter_filter.py +17 -0
  239. hare/contrib/request_query/declaration/request_query_declaration.py +126 -0
  240. hare/contrib/request_query/declaration/request_query_factory.py +131 -0
  241. hare/contrib/request_query/declaration/request_query_generation.py +23 -0
  242. hare/contrib/request_query/declaration/request_query_generation_builder.py +73 -0
  243. hare/contrib/request_query/declaration/request_query_inputs.py +74 -0
  244. hare/contrib/request_query/declaration/request_query_parameters.py +61 -0
  245. hare/contrib/request_query/declaration/request_query_registry.py +89 -0
  246. hare/contrib/request_query/descriptions/__init__.py +11 -0
  247. hare/contrib/request_query/descriptions/constants.py +11 -0
  248. hare/contrib/request_query/descriptions/parameter_choice.py +17 -0
  249. hare/contrib/request_query/descriptions/parameter_describer.py +245 -0
  250. hare/contrib/request_query/descriptions/parameter_description.py +69 -0
  251. hare/contrib/request_query/descriptions/relation_description.py +30 -0
  252. hare/contrib/request_query/enums.py +79 -0
  253. hare/contrib/request_query/exceptions.py +87 -0
  254. hare/contrib/request_query/options/__init__.py +33 -0
  255. hare/contrib/request_query/options/constants.py +25 -0
  256. hare/contrib/request_query/options/deleted_config.py +88 -0
  257. hare/contrib/request_query/options/fields_config.py +74 -0
  258. hare/contrib/request_query/options/filter.py +27 -0
  259. hare/contrib/request_query/options/filter_field.py +54 -0
  260. hare/contrib/request_query/options/in_path.py +12 -0
  261. hare/contrib/request_query/options/include_config.py +52 -0
  262. hare/contrib/request_query/options/latest_versions.py +72 -0
  263. hare/contrib/request_query/options/no_filter.py +11 -0
  264. hare/contrib/request_query/options/ordering_config.py +80 -0
  265. hare/contrib/request_query/options/parameter_field.py +27 -0
  266. hare/contrib/request_query/options/request_option.py +121 -0
  267. hare/contrib/request_query/options/search_config.py +72 -0
  268. hare/contrib/request_query/paginations/__init__.py +1 -0
  269. hare/contrib/request_query/paginations/base_offset_pagination.py +78 -0
  270. hare/contrib/request_query/paginations/constants.py +16 -0
  271. hare/contrib/request_query/paginations/cursor.py +98 -0
  272. hare/contrib/request_query/paginations/cursor_pagination.py +188 -0
  273. hare/contrib/request_query/paginations/cursor_values.py +71 -0
  274. hare/contrib/request_query/paginations/offset_pagination.py +31 -0
  275. hare/contrib/request_query/paginations/pagination.py +112 -0
  276. hare/contrib/request_query/paginations/scroll_pagination.py +31 -0
  277. hare/contrib/request_query/request_query.py +1280 -0
  278. hare/contrib/request_query/request_query_building.py +225 -0
  279. hare/contrib/request_query/results/__init__.py +11 -0
  280. hare/contrib/request_query/results/cursor_page.py +25 -0
  281. hare/contrib/request_query/results/page.py +25 -0
  282. hare/contrib/request_query/results/scroll_page.py +23 -0
  283. hare/contrib/request_query/row_changes.py +80 -0
  284. hare/contrib/request_query/types/__init__.py +15 -0
  285. hare/contrib/request_query/types/comma_separated.py +46 -0
  286. hare/contrib/request_query/types/constants.py +16 -0
  287. hare/contrib/request_query/types/generic_target.py +87 -0
  288. hare/contrib/request_query/types/key_columns.py +60 -0
  289. hare/contrib/request_query/types/text_parameter.py +18 -0
  290. hare/contrib/request_query/value_annotation.py +234 -0
  291. hare/contrib/request_query/value_counter.py +116 -0
  292. hare/contrib/request_query/value_target.py +52 -0
  293. hare/contrib/taskiq/__init__.py +15 -0
  294. hare/contrib/taskiq/constants.py +21 -0
  295. hare/contrib/taskiq/hare_taskiq.py +85 -0
  296. hare/contrib/taskiq/hare_taskiq_middleware.py +184 -0
  297. hare/contrib/taskiq/running_task.py +35 -0
  298. hare/contrib/taskiq/task_tenant_labels.py +157 -0
  299. hare/contrib/taskiq/taskiq_delivery.py +132 -0
  300. hare/contrib/test/__init__.py +39 -0
  301. hare/contrib/test/conditions/__init__.py +10 -0
  302. hare/contrib/test/conditions/condition.py +11 -0
  303. hare/contrib/test/conditions/in_condition.py +21 -0
  304. hare/contrib/test/conditions/not_eq.py +18 -0
  305. hare/contrib/test/conditions/not_in.py +21 -0
  306. hare/contrib/test/constants.py +20 -0
  307. hare/contrib/test/databases/__init__.py +1 -0
  308. hare/contrib/test/databases/declarations.py +20 -0
  309. hare/contrib/test/databases/kept_test_schema.py +51 -0
  310. hare/contrib/test/databases/model_truncation.py +124 -0
  311. hare/contrib/test/databases/postgresql/__init__.py +0 -0
  312. hare/contrib/test/databases/postgresql/constants.py +128 -0
  313. hare/contrib/test/databases/postgresql/reusable_test_schemas.py +208 -0
  314. hare/contrib/test/databases/postgresql/test_database.py +210 -0
  315. hare/contrib/test/databases/resource_cleanup.py +64 -0
  316. hare/contrib/test/databases/reusable_test_databases.py +142 -0
  317. hare/contrib/test/databases/rollback_isolation.py +125 -0
  318. hare/contrib/test/databases/temporary_databases.py +168 -0
  319. hare/contrib/test/databases/test_database_config.py +66 -0
  320. hare/contrib/test/databases/test_database_resource.py +22 -0
  321. hare/contrib/test/exceptions.py +5 -0
  322. hare/contrib/test/features/__init__.py +1 -0
  323. hare/contrib/test/features/feature_conditions.py +65 -0
  324. hare/contrib/test/features/feature_requirements.py +83 -0
  325. hare/contrib/test/isolated_contexts.py +142 -0
  326. hare/contrib/test/messages.py +6 -0
  327. hare/contrib/test/queries/__init__.py +1 -0
  328. hare/contrib/test/queries/query_counter.py +36 -0
  329. hare/contrib/test/queries/query_counting.py +61 -0
  330. hare/contrib/versioning/__init__.py +7 -0
  331. hare/contrib/versioning/constants.py +5 -0
  332. hare/contrib/versioning/versioned_model.py +181 -0
  333. hare/core/__init__.py +4 -0
  334. hare/core/apps/__init__.py +8 -0
  335. hare/core/apps/apps.py +479 -0
  336. hare/core/apps/cross_connection_checks.py +80 -0
  337. hare/core/apps/declarations.py +13 -0
  338. hare/core/apps/enum_member_checks.py +87 -0
  339. hare/core/apps/live_model_registration.py +128 -0
  340. hare/core/apps/many_to_many_linking.py +285 -0
  341. hare/core/apps/model_binding_graph.py +145 -0
  342. hare/core/apps/model_binding_preparation.py +98 -0
  343. hare/core/apps/model_connection_checks.py +277 -0
  344. hare/core/apps/model_discovery.py +143 -0
  345. hare/core/apps/model_name_checks.py +97 -0
  346. hare/core/apps/relation_linking.py +775 -0
  347. hare/core/apps/swappable_models.py +150 -0
  348. hare/core/apps/table_names.py +34 -0
  349. hare/core/caching/__init__.py +1 -0
  350. hare/core/caching/cache.py +201 -0
  351. hare/core/caching/cache_bucket.py +99 -0
  352. hare/core/caching/caches.py +53 -0
  353. hare/core/caching/constants.py +17 -0
  354. hare/core/caching/forgettable_cache.py +16 -0
  355. hare/core/caching/model_cache.py +111 -0
  356. hare/core/config/__init__.py +25 -0
  357. hare/core/config/app_config.py +57 -0
  358. hare/core/config/cli_config.py +35 -0
  359. hare/core/config/config_secrets.py +86 -0
  360. hare/core/config/config_section.py +37 -0
  361. hare/core/config/connection_config.py +59 -0
  362. hare/core/config/constants.py +8 -0
  363. hare/core/config/db_url_config.py +19 -0
  364. hare/core/config/hare_config.py +339 -0
  365. hare/core/config/migration_safety_config.py +37 -0
  366. hare/core/config/migrations_config.py +72 -0
  367. hare/core/connections/__init__.py +1 -0
  368. hare/core/connections/connection_frame.py +44 -0
  369. hare/core/connections/connection_handler.py +507 -0
  370. hare/core/connections/connection_token.py +31 -0
  371. hare/core/connections/connections.py +133 -0
  372. hare/core/connections/messages.py +11 -0
  373. hare/core/connections/model_connection_choice.py +117 -0
  374. hare/core/connections/relation_constraints.py +40 -0
  375. hare/core/constants.py +56 -0
  376. hare/core/enums.py +7 -0
  377. hare/core/extensions/__init__.py +8 -0
  378. hare/core/extensions/constants.py +1 -0
  379. hare/core/extensions/declarations.py +58 -0
  380. hare/core/extensions/extension_loader.py +46 -0
  381. hare/core/extensions/messages.py +8 -0
  382. hare/core/extensions/registry_builder.py +111 -0
  383. hare/core/extensions/registry_snapshot.py +37 -0
  384. hare/core/extensions/snapshot_mapping.py +56 -0
  385. hare/core/hare.py +197 -0
  386. hare/core/hare_context.py +784 -0
  387. hare/core/hare_meta.py +18 -0
  388. hare/core/log.py +6 -0
  389. hare/core/registries.py +74 -0
  390. hare/core/resource_completion.py +77 -0
  391. hare/core/routing/__init__.py +5 -0
  392. hare/core/routing/connection_router.py +114 -0
  393. hare/core/routing/primary_reads.py +52 -0
  394. hare/core/routing/routing.py +30 -0
  395. hare/core/routing/written_connections.py +124 -0
  396. hare/ddl/__init__.py +68 -0
  397. hare/ddl/conditions/__init__.py +1 -0
  398. hare/ddl/conditions/constraint_condition.py +172 -0
  399. hare/ddl/conditions/dialect_condition.py +28 -0
  400. hare/ddl/conditions/enum_members_condition.py +74 -0
  401. hare/ddl/conditions/exclusive_arc_condition.py +81 -0
  402. hare/ddl/conditions/field_condition.py +25 -0
  403. hare/ddl/conditions/messages.py +3 -0
  404. hare/ddl/conditions/tenant_condition.py +70 -0
  405. hare/ddl/conditions/trigger_condition.py +39 -0
  406. hare/ddl/constants.py +87 -0
  407. hare/ddl/constraints/__init__.py +7 -0
  408. hare/ddl/constraints/check_constraint.py +39 -0
  409. hare/ddl/constraints/exclusion_constraint.py +117 -0
  410. hare/ddl/constraints/foreign_key_constraint.py +39 -0
  411. hare/ddl/constraints/unique_constraint.py +146 -0
  412. hare/ddl/ddl_term_sql.py +45 -0
  413. hare/ddl/declared_names.py +47 -0
  414. hare/ddl/enums.py +149 -0
  415. hare/ddl/expressions/__init__.py +0 -0
  416. hare/ddl/expressions/declared_expressions.py +111 -0
  417. hare/ddl/expressions/expression_field_renaming.py +41 -0
  418. hare/ddl/generated_names.py +75 -0
  419. hare/ddl/indexes/__init__.py +11 -0
  420. hare/ddl/indexes/bound_index_key.py +24 -0
  421. hare/ddl/indexes/index.py +516 -0
  422. hare/ddl/indexes/ordered_index_key.py +27 -0
  423. hare/ddl/indexes/partial_index.py +78 -0
  424. hare/ddl/partition_changes.py +31 -0
  425. hare/ddl/raw_sql_term.py +44 -0
  426. hare/ddl/schema_objects/__init__.py +12 -0
  427. hare/ddl/schema_objects/database_function.py +95 -0
  428. hare/ddl/schema_objects/database_sequence.py +87 -0
  429. hare/ddl/schema_objects/dictionary.py +69 -0
  430. hare/ddl/schema_objects/enum_type.py +45 -0
  431. hare/ddl/schema_objects/materialized_view.py +59 -0
  432. hare/ddl/schema_objects/named_schema_object.py +24 -0
  433. hare/ddl/schema_objects/trigger.py +151 -0
  434. hare/ddl/schema_objects/view.py +158 -0
  435. hare/ddl/schema_objects/view_creation_order.py +77 -0
  436. hare/ddl/schema_references.py +110 -0
  437. hare/ddl/schema_requirements.py +91 -0
  438. hare/ddl/security/__init__.py +8 -0
  439. hare/ddl/security/grant.py +104 -0
  440. hare/ddl/security/policy.py +90 -0
  441. hare/ddl/table_options.py +375 -0
  442. hare/declarations/__init__.py +1 -0
  443. hare/declarations/constants.py +4 -0
  444. hare/declarations/declaration_value_serializer.py +940 -0
  445. hare/declarations/declaration_values.py +49 -0
  446. hare/declarations/environment_value.py +30 -0
  447. hare/declarations/global_reference_rewriter.py +78 -0
  448. hare/declarations/import_manager.py +235 -0
  449. hare/declarations/messages.py +1 -0
  450. hare/declarations/runtime_enums.py +69 -0
  451. hare/dialects/__init__.py +0 -0
  452. hare/dialects/base/__init__.py +0 -0
  453. hare/dialects/base/clauses/__init__.py +1 -0
  454. hare/dialects/base/clauses/constants.py +6 -0
  455. hare/dialects/base/clauses/enums.py +51 -0
  456. hare/dialects/base/clauses/limit_returning_conflict_query_clauses.py +193 -0
  457. hare/dialects/base/clauses/merge_when_sql.py +24 -0
  458. hare/dialects/base/clauses/query_clauses.py +708 -0
  459. hare/dialects/base/client/__init__.py +15 -0
  460. hare/dialects/base/client/client_pool_status.py +55 -0
  461. hare/dialects/base/client/client_schema.py +51 -0
  462. hare/dialects/base/client/connect_failure_reports.py +49 -0
  463. hare/dialects/base/client/connection_ping.py +37 -0
  464. hare/dialects/base/client/connection_wrapper.py +119 -0
  465. hare/dialects/base/client/constants.py +53 -0
  466. hare/dialects/base/client/database_client.py +1052 -0
  467. hare/dialects/base/client/declarations.py +43 -0
  468. hare/dialects/base/client/driver_statement_log_filter.py +33 -0
  469. hare/dialects/base/client/enums.py +11 -0
  470. hare/dialects/base/client/password_provider.py +154 -0
  471. hare/dialects/base/client/pool/__init__.py +1 -0
  472. hare/dialects/base/client/pool/pool_connection_wrapper.py +37 -0
  473. hare/dialects/base/client/pool/pool_statistics.py +116 -0
  474. hare/dialects/base/client/schema_cache_invalidation.py +42 -0
  475. hare/dialects/base/client/statement_execution.py +268 -0
  476. hare/dialects/base/client/statement_options.py +65 -0
  477. hare/dialects/base/client/statement_recovery.py +17 -0
  478. hare/dialects/base/client/tenant_clients.py +125 -0
  479. hare/dialects/base/client/transaction_client.py +652 -0
  480. hare/dialects/base/client/transaction_lifecycle/__init__.py +1 -0
  481. hare/dialects/base/client/transaction_lifecycle/pending_statements.py +85 -0
  482. hare/dialects/base/client/transaction_lifecycle/transaction_callbacks.py +190 -0
  483. hare/dialects/base/client/transaction_lifecycle/transaction_ending.py +417 -0
  484. hare/dialects/base/client/transaction_lifecycle/transaction_state.py +36 -0
  485. hare/dialects/base/connection/__init__.py +1 -0
  486. hare/dialects/base/connection/connection_option.py +137 -0
  487. hare/dialects/base/connection/connection_options.py +69 -0
  488. hare/dialects/base/connection/constants.py +18 -0
  489. hare/dialects/base/connection/db_url_config_generator.py +89 -0
  490. hare/dialects/base/connection/db_url_parts.py +98 -0
  491. hare/dialects/base/connection/driver.py +129 -0
  492. hare/dialects/base/connection/messages.py +7 -0
  493. hare/dialects/base/constants.py +41 -0
  494. hare/dialects/base/dialect.py +382 -0
  495. hare/dialects/base/features.py +378 -0
  496. hare/dialects/base/literals/__init__.py +1 -0
  497. hare/dialects/base/literals/constants.py +11 -0
  498. hare/dialects/base/literals/sql_literals.py +315 -0
  499. hare/dialects/base/lookups/__init__.py +1 -0
  500. hare/dialects/base/lookups/filter_operators.py +179 -0
  501. hare/dialects/base/migration_safety/__init__.py +12 -0
  502. hare/dialects/base/migration_safety/add_field_backfill_rule.py +32 -0
  503. hare/dialects/base/migration_safety/add_field_without_default_rule.py +44 -0
  504. hare/dialects/base/migration_safety/alter_field_rewrite_rule.py +34 -0
  505. hare/dialects/base/migration_safety/constants.py +4 -0
  506. hare/dialects/base/migration_safety/delete_model_rule.py +33 -0
  507. hare/dialects/base/migration_safety/migration_safety_rule.py +45 -0
  508. hare/dialects/base/migration_safety/migration_safety_rules.py +74 -0
  509. hare/dialects/base/migration_safety/remove_field_rule.py +31 -0
  510. hare/dialects/base/migration_safety/rename_field_rule.py +41 -0
  511. hare/dialects/base/migration_safety/rename_model_rule.py +42 -0
  512. hare/dialects/base/migration_safety/run_sql_rule.py +27 -0
  513. hare/dialects/base/migration_safety/schema_change_with_run_python_rule.py +49 -0
  514. hare/dialects/base/parameters/__init__.py +1 -0
  515. hare/dialects/base/parameters/large_in_list.py +140 -0
  516. hare/dialects/base/parameters/sql_parameters.py +218 -0
  517. hare/dialects/base/renderers/__init__.py +7 -0
  518. hare/dialects/base/renderers/checked_term_renderers.py +69 -0
  519. hare/dialects/base/renderers/json_renderers.py +60 -0
  520. hare/dialects/base/renderers/term_renderers.py +402 -0
  521. hare/dialects/base/results/__init__.py +9 -0
  522. hare/dialects/base/results/described_result.py +22 -0
  523. hare/dialects/base/results/statement_result.py +69 -0
  524. hare/dialects/base/schema/__init__.py +0 -0
  525. hare/dialects/base/schema/base_schema_editor.py +1355 -0
  526. hare/dialects/base/schema/columns/__init__.py +1 -0
  527. hare/dialects/base/schema/columns/column_backfill.py +347 -0
  528. hare/dialects/base/schema/columns/column_conversion_check.py +62 -0
  529. hare/dialects/base/schema/columns/column_definitions.py +464 -0
  530. hare/dialects/base/schema/columns/column_narrowing_check.py +215 -0
  531. hare/dialects/base/schema/columns/column_renames.py +98 -0
  532. hare/dialects/base/schema/columns/column_type_changes.py +127 -0
  533. hare/dialects/base/schema/constants.py +55 -0
  534. hare/dialects/base/schema/constraints/__init__.py +1 -0
  535. hare/dialects/base/schema/constraints/constraint_names.py +33 -0
  536. hare/dialects/base/schema/constraints/constraint_statements.py +267 -0
  537. hare/dialects/base/schema/data/__init__.py +9 -0
  538. hare/dialects/base/schema/data/model_sql_data.py +50 -0
  539. hare/dialects/base/schema/data/referencing_key_columns.py +30 -0
  540. hare/dialects/base/schema/indexes/__init__.py +1 -0
  541. hare/dialects/base/schema/indexes/generated_index_names.py +204 -0
  542. hare/dialects/base/schema/indexes/index_statements.py +426 -0
  543. hare/dialects/base/schema/plans/__init__.py +0 -0
  544. hare/dialects/base/schema/plans/column_batch_backfill.py +51 -0
  545. hare/dialects/base/schema/plans/column_conversion_precondition.py +38 -0
  546. hare/dialects/base/schema/plans/column_copy.py +36 -0
  547. hare/dialects/base/schema/plans/column_default_backfill.py +42 -0
  548. hare/dialects/base/schema/plans/column_null_precondition.py +26 -0
  549. hare/dialects/base/schema/plans/enums.py +12 -0
  550. hare/dialects/base/schema/plans/relation_target_precondition.py +39 -0
  551. hare/dialects/base/schema/plans/schema_change_plan.py +37 -0
  552. hare/dialects/base/schema/plans/schema_cleanup.py +78 -0
  553. hare/dialects/base/schema/plans/schema_statement.py +26 -0
  554. hare/dialects/base/schema/plans/schema_step.py +26 -0
  555. hare/dialects/base/schema/plans/schema_transaction.py +47 -0
  556. hare/dialects/base/schema/plans/stored_value_rewrite.py +69 -0
  557. hare/dialects/base/schema/plans/stored_value_snapshot.py +10 -0
  558. hare/dialects/base/schema/plans/table_rows_copy.py +46 -0
  559. hare/dialects/base/schema/plans/through_table_copy.py +59 -0
  560. hare/dialects/base/schema/relations/__init__.py +1 -0
  561. hare/dialects/base/schema/relations/foreign_key_rebuild.py +422 -0
  562. hare/dialects/base/schema/relations/many_to_many_through_tables.py +294 -0
  563. hare/dialects/base/schema/runtime_statements/__init__.py +1 -0
  564. hare/dialects/base/schema/runtime_statements/table_clearing.py +68 -0
  565. hare/dialects/base/schema/runtime_statements/table_locks.py +34 -0
  566. hare/dialects/base/schema/runtime_statements/tenant_conditions.py +73 -0
  567. hare/dialects/base/schema/schema_editor_part.py +34 -0
  568. hare/dialects/base/schema/schema_objects/__init__.py +1 -0
  569. hare/dialects/base/schema/schema_objects/database_functions.py +79 -0
  570. hare/dialects/base/schema/schema_objects/dictionaries.py +77 -0
  571. hare/dialects/base/schema/schema_objects/enum_types.py +94 -0
  572. hare/dialects/base/schema/schema_objects/extensions.py +69 -0
  573. hare/dialects/base/schema/schema_objects/grants.py +46 -0
  574. hare/dialects/base/schema/schema_objects/materialized_views.py +126 -0
  575. hare/dialects/base/schema/schema_objects/row_level_security_policies.py +86 -0
  576. hare/dialects/base/schema/schema_objects/schemas.py +68 -0
  577. hare/dialects/base/schema/schema_objects/sequences.py +100 -0
  578. hare/dialects/base/schema/schema_objects/views.py +83 -0
  579. hare/dialects/base/schema/shadow/__init__.py +0 -0
  580. hare/dialects/base/schema/shadow/shadow_database.py +78 -0
  581. hare/dialects/base/schema/tables/__init__.py +1 -0
  582. hare/dialects/base/schema/tables/table_comments.py +91 -0
  583. hare/dialects/base/schema/tables/table_creation.py +764 -0
  584. hare/dialects/base/schema/tables/table_definition.py +39 -0
  585. hare/dialects/base/schema/tables/table_partitions.py +72 -0
  586. hare/dialects/base/schema/tables/table_rebuild.py +252 -0
  587. hare/dialects/base/schema/triggers/__init__.py +1 -0
  588. hare/dialects/base/schema/triggers/trigger_statements.py +90 -0
  589. hare/dialects/base/search/__init__.py +1 -0
  590. hare/dialects/base/search/enums.py +22 -0
  591. hare/dialects/base/search/text_search.py +199 -0
  592. hare/dialects/base/sql_dialect.py +32 -0
  593. hare/dialects/base/transactions/__init__.py +1 -0
  594. hare/dialects/base/transactions/constants.py +5 -0
  595. hare/dialects/base/transactions/contexts/__init__.py +1 -0
  596. hare/dialects/base/transactions/contexts/joined_transaction_context.py +36 -0
  597. hare/dialects/base/transactions/contexts/nested_transaction_context.py +135 -0
  598. hare/dialects/base/transactions/contexts/non_transactional_context.py +32 -0
  599. hare/dialects/base/transactions/contexts/top_level_transaction_context.py +162 -0
  600. hare/dialects/base/transactions/contexts/transaction_context.py +82 -0
  601. hare/dialects/base/transactions/savepoints/__init__.py +1 -0
  602. hare/dialects/base/transactions/savepoints/nested_savepoint_lock.py +125 -0
  603. hare/dialects/base/transactions/savepoints/savepoint_span.py +51 -0
  604. hare/dialects/base/transactions/transaction_callback.py +33 -0
  605. hare/dialects/base/transactions/transaction_statements.py +144 -0
  606. hare/dialects/base/transactions/two_phase_commit.py +159 -0
  607. hare/dialects/base/types/__init__.py +9 -0
  608. hare/dialects/base/types/constants.py +3 -0
  609. hare/dialects/base/types/prepared_converter.py +35 -0
  610. hare/dialects/base/types/result_literal_binding.py +20 -0
  611. hare/dialects/base/types/type_mapping.py +69 -0
  612. hare/dialects/base/types/type_registry.py +587 -0
  613. hare/dialects/clickhouse/__init__.py +1 -0
  614. hare/dialects/clickhouse/clauses/__init__.py +1 -0
  615. hare/dialects/clickhouse/clauses/clickhouse_query_clauses.py +552 -0
  616. hare/dialects/clickhouse/clauses/constants.py +58 -0
  617. hare/dialects/clickhouse/clickhouse_dialect.py +276 -0
  618. hare/dialects/clickhouse/clickhouse_engine.py +181 -0
  619. hare/dialects/clickhouse/clickhouse_introspector.py +266 -0
  620. hare/dialects/clickhouse/clickhouse_table_options.py +820 -0
  621. hare/dialects/clickhouse/client/__init__.py +1 -0
  622. hare/dialects/clickhouse/client/clickhouse_client.py +642 -0
  623. hare/dialects/clickhouse/client/clickhouse_connection.py +30 -0
  624. hare/dialects/clickhouse/client/clickhouse_error_codes.py +26 -0
  625. hare/dialects/clickhouse/client/clickhouse_errors.py +99 -0
  626. hare/dialects/clickhouse/client/clickhouse_external_sets.py +110 -0
  627. hare/dialects/clickhouse/client/clickhouse_insert_values.py +206 -0
  628. hare/dialects/clickhouse/client/clickhouse_key_series.py +92 -0
  629. hare/dialects/clickhouse/client/clickhouse_mutation_recovery.py +61 -0
  630. hare/dialects/clickhouse/client/clickhouse_query_templates.py +77 -0
  631. hare/dialects/clickhouse/client/clickhouse_statement_result.py +15 -0
  632. hare/dialects/clickhouse/client/clickhouse_streamed_row.py +50 -0
  633. hare/dialects/clickhouse/client/clickhouse_transaction_client.py +189 -0
  634. hare/dialects/clickhouse/client/constants.py +218 -0
  635. hare/dialects/clickhouse/client/declarations.py +47 -0
  636. hare/dialects/clickhouse/cluster/__init__.py +0 -0
  637. hare/dialects/clickhouse/cluster/clickhouse_cluster.py +63 -0
  638. hare/dialects/clickhouse/cluster/clickhouse_placement_plan.py +66 -0
  639. hare/dialects/clickhouse/cluster/constants.py +35 -0
  640. hare/dialects/clickhouse/cluster/messages.py +5 -0
  641. hare/dialects/clickhouse/connection/__init__.py +1 -0
  642. hare/dialects/clickhouse/connection/clickhouse_driver.py +40 -0
  643. hare/dialects/clickhouse/constants.py +231 -0
  644. hare/dialects/clickhouse/declarations.py +18 -0
  645. hare/dialects/clickhouse/drivers/__init__.py +1 -0
  646. hare/dialects/clickhouse/drivers/clickhouse_connect/__init__.py +1 -0
  647. hare/dialects/clickhouse/drivers/clickhouse_connect/clickhouse_connect_driver.py +42 -0
  648. hare/dialects/clickhouse/drivers/clickhouse_connect/client/__init__.py +1 -0
  649. hare/dialects/clickhouse/drivers/clickhouse_connect/client/clickhouse_connect_client.py +373 -0
  650. hare/dialects/clickhouse/drivers/clickhouse_connect/client/clickhouse_connect_column_types.py +90 -0
  651. hare/dialects/clickhouse/drivers/clickhouse_connect/client/clickhouse_connect_dynamic_type.py +53 -0
  652. hare/dialects/clickhouse/drivers/clickhouse_connect/client/clickhouse_connect_json_type.py +29 -0
  653. hare/dialects/clickhouse/drivers/clickhouse_connect/client/clickhouse_connect_response.py +94 -0
  654. hare/dialects/clickhouse/drivers/clickhouse_connect/client/clickhouse_connect_shared_variant_type.py +17 -0
  655. hare/dialects/clickhouse/drivers/clickhouse_connect/client/clickhouse_connect_totals_query.py +70 -0
  656. hare/dialects/clickhouse/drivers/clickhouse_connect/client/clickhouse_connect_transaction_client.py +46 -0
  657. hare/dialects/clickhouse/drivers/clickhouse_connect/client/clickhouse_connect_transform.py +52 -0
  658. hare/dialects/clickhouse/drivers/clickhouse_connect/client/clickhouse_json_compact_values.py +81 -0
  659. hare/dialects/clickhouse/drivers/clickhouse_connect/constants.py +36 -0
  660. hare/dialects/clickhouse/drivers/clickhouse_driver/__init__.py +1 -0
  661. hare/dialects/clickhouse/drivers/clickhouse_driver/clickhouse_driver_driver.py +47 -0
  662. hare/dialects/clickhouse/drivers/clickhouse_driver/client/__init__.py +1 -0
  663. hare/dialects/clickhouse/drivers/clickhouse_driver/client/clickhouse_driver_block_input.py +50 -0
  664. hare/dialects/clickhouse/drivers/clickhouse_driver/client/clickhouse_driver_block_output.py +48 -0
  665. hare/dialects/clickhouse/drivers/clickhouse_driver/client/clickhouse_driver_client.py +318 -0
  666. hare/dialects/clickhouse/drivers/clickhouse_driver/client/clickhouse_driver_column_types.py +171 -0
  667. hare/dialects/clickhouse/drivers/clickhouse_driver/client/clickhouse_driver_connections.py +243 -0
  668. hare/dialects/clickhouse/drivers/clickhouse_driver/client/clickhouse_driver_dynamic_column.py +51 -0
  669. hare/dialects/clickhouse/drivers/clickhouse_driver/client/clickhouse_driver_library_client.py +161 -0
  670. hare/dialects/clickhouse/drivers/clickhouse_driver/client/clickhouse_driver_library_connection.py +22 -0
  671. hare/dialects/clickhouse/drivers/clickhouse_driver/client/clickhouse_driver_map_columns.py +39 -0
  672. hare/dialects/clickhouse/drivers/clickhouse_driver/client/clickhouse_driver_moment_columns.py +72 -0
  673. hare/dialects/clickhouse/drivers/clickhouse_driver/client/clickhouse_driver_query_result.py +24 -0
  674. hare/dialects/clickhouse/drivers/clickhouse_driver/client/clickhouse_driver_row_stream.py +161 -0
  675. hare/dialects/clickhouse/drivers/clickhouse_driver/client/clickhouse_driver_transaction_client.py +20 -0
  676. hare/dialects/clickhouse/drivers/clickhouse_driver/client/clickhouse_driver_tuple_columns.py +26 -0
  677. hare/dialects/clickhouse/drivers/clickhouse_driver/client/clickhouse_driver_variant_column.py +76 -0
  678. hare/dialects/clickhouse/drivers/clickhouse_driver/constants.py +86 -0
  679. hare/dialects/clickhouse/drivers/clickhouse_shared_variant_values.py +859 -0
  680. hare/dialects/clickhouse/drivers/constants.py +146 -0
  681. hare/dialects/clickhouse/enums.py +92 -0
  682. hare/dialects/clickhouse/fields/__init__.py +43 -0
  683. hare/dialects/clickhouse/fields/clickhouse_date_field.py +50 -0
  684. hare/dialects/clickhouse/fields/clickhouse_datetime_field.py +168 -0
  685. hare/dialects/clickhouse/fields/clickhouse_integer_field.py +20 -0
  686. hare/dialects/clickhouse/fields/constants.py +40 -0
  687. hare/dialects/clickhouse/fields/declarations.py +82 -0
  688. hare/dialects/clickhouse/fields/dynamic_field.py +127 -0
  689. hare/dialects/clickhouse/fields/fixed_string_field.py +93 -0
  690. hare/dialects/clickhouse/fields/float32_field.py +58 -0
  691. hare/dialects/clickhouse/fields/low_cardinality_field.py +94 -0
  692. hare/dialects/clickhouse/fields/narrowing/__init__.py +6 -0
  693. hare/dialects/clickhouse/fields/narrowing/byte_length_limit.py +22 -0
  694. hare/dialects/clickhouse/fields/narrowing/moment_limit.py +24 -0
  695. hare/dialects/clickhouse/fields/variant_field.py +174 -0
  696. hare/dialects/clickhouse/functions/__init__.py +63 -0
  697. hare/dialects/clickhouse/functions/aggregates/__init__.py +37 -0
  698. hare/dialects/clickhouse/functions/aggregates/arg_extremum.py +23 -0
  699. hare/dialects/clickhouse/functions/aggregates/declarations.py +120 -0
  700. hare/dialects/clickhouse/functions/aggregates/group_array.py +49 -0
  701. hare/dialects/clickhouse/functions/aggregates/median.py +18 -0
  702. hare/dialects/clickhouse/functions/aggregates/parametric_aggregate.py +48 -0
  703. hare/dialects/clickhouse/functions/aggregates/parametric_aggregate_function.py +21 -0
  704. hare/dialects/clickhouse/functions/aggregates/parametric_analytic_function.py +20 -0
  705. hare/dialects/clickhouse/functions/aggregates/quantile.py +75 -0
  706. hare/dialects/clickhouse/functions/aggregates/quantiles.py +61 -0
  707. hare/dialects/clickhouse/functions/aggregates/top_k.py +45 -0
  708. hare/dialects/clickhouse/functions/dict_get.py +241 -0
  709. hare/dialects/clickhouse/indexes/__init__.py +19 -0
  710. hare/dialects/clickhouse/indexes/bloom_filter_index.py +49 -0
  711. hare/dialects/clickhouse/indexes/clickhouse_index.py +145 -0
  712. hare/dialects/clickhouse/indexes/constants.py +14 -0
  713. hare/dialects/clickhouse/indexes/min_max_index.py +22 -0
  714. hare/dialects/clickhouse/indexes/ngram_bloom_filter_index.py +43 -0
  715. hare/dialects/clickhouse/indexes/set_index.py +35 -0
  716. hare/dialects/clickhouse/indexes/token_bloom_filter_index.py +60 -0
  717. hare/dialects/clickhouse/introspection/__init__.py +0 -0
  718. hare/dialects/clickhouse/introspection/clickhouse_catalog_engine.py +91 -0
  719. hare/dialects/clickhouse/introspection/clickhouse_catalog_identities.py +113 -0
  720. hare/dialects/clickhouse/introspection/clickhouse_catalog_parts.py +81 -0
  721. hare/dialects/clickhouse/introspection/clickhouse_catalog_reader.py +76 -0
  722. hare/dialects/clickhouse/introspection/clickhouse_check_constraints.py +40 -0
  723. hare/dialects/clickhouse/introspection/clickhouse_declaration_mapper.py +149 -0
  724. hare/dialects/clickhouse/introspection/clickhouse_observed_table_options.py +239 -0
  725. hare/dialects/clickhouse/introspection/clickhouse_sql_parts.py +217 -0
  726. hare/dialects/clickhouse/introspection/clickhouse_type_parser.py +239 -0
  727. hare/dialects/clickhouse/introspection/constants.py +71 -0
  728. hare/dialects/clickhouse/keeper/__init__.py +0 -0
  729. hare/dialects/clickhouse/keeper/clickhouse_database_keeper_nodes.py +71 -0
  730. hare/dialects/clickhouse/keeper/clickhouse_migration_lock.py +141 -0
  731. hare/dialects/clickhouse/keeper/constants.py +9 -0
  732. hare/dialects/clickhouse/keeper/keeper_session.py +224 -0
  733. hare/dialects/clickhouse/literals/__init__.py +1 -0
  734. hare/dialects/clickhouse/literals/clickhouse_literals.py +375 -0
  735. hare/dialects/clickhouse/lookups/__init__.py +0 -0
  736. hare/dialects/clickhouse/lookups/clickhouse_array_elements_key.py +32 -0
  737. hare/dialects/clickhouse/lookups/clickhouse_filter_operators.py +49 -0
  738. hare/dialects/clickhouse/lookups/clickhouse_global_lookups.py +124 -0
  739. hare/dialects/clickhouse/lookups/clickhouse_json_equality.py +94 -0
  740. hare/dialects/clickhouse/lookups/clickhouse_json_key_existence.py +38 -0
  741. hare/dialects/clickhouse/lookups/clickhouse_json_lookups.py +57 -0
  742. hare/dialects/clickhouse/lookups/clickhouse_json_path_lookups.py +102 -0
  743. hare/dialects/clickhouse/lookups/clickhouse_json_value_text.py +24 -0
  744. hare/dialects/clickhouse/lookups/clickhouse_typed_value_lookups.py +203 -0
  745. hare/dialects/clickhouse/lookups/constants.py +71 -0
  746. hare/dialects/clickhouse/lookups/declarations.py +14 -0
  747. hare/dialects/clickhouse/lookups/global_contains_criterion.py +15 -0
  748. hare/dialects/clickhouse/lookups/in_list/__init__.py +0 -0
  749. hare/dialects/clickhouse/lookups/in_list/clickhouse_large_in_list.py +92 -0
  750. hare/dialects/clickhouse/lookups/in_list/clickhouse_value_set_values.py +44 -0
  751. hare/dialects/clickhouse/migration_safety/__init__.py +9 -0
  752. hare/dialects/clickhouse/migration_safety/clickhouse_migration_safety_rules.py +40 -0
  753. hare/dialects/clickhouse/migration_safety/constants.py +10 -0
  754. hare/dialects/clickhouse/parameters/__init__.py +1 -0
  755. hare/dialects/clickhouse/parameters/clickhouse_parameters.py +63 -0
  756. hare/dialects/clickhouse/query/__init__.py +1 -0
  757. hare/dialects/clickhouse/query/clickhouse_dialect_variants.py +31 -0
  758. hare/dialects/clickhouse/query/clickhouse_queryset_methods.py +349 -0
  759. hare/dialects/clickhouse/query/clickhouse_sql_context.py +51 -0
  760. hare/dialects/clickhouse/query/clickhouse_totals.py +20 -0
  761. hare/dialects/clickhouse/query/constants.py +24 -0
  762. hare/dialects/clickhouse/query/declarations.py +21 -0
  763. hare/dialects/clickhouse/query/totals_result.py +21 -0
  764. hare/dialects/clickhouse/renderers/__init__.py +1 -0
  765. hare/dialects/clickhouse/renderers/clickhouse_aggregate_renderers.py +121 -0
  766. hare/dialects/clickhouse/renderers/clickhouse_assigned_enum_number.py +30 -0
  767. hare/dialects/clickhouse/renderers/clickhouse_cast_renderers.py +50 -0
  768. hare/dialects/clickhouse/renderers/clickhouse_condition_renderers.py +27 -0
  769. hare/dialects/clickhouse/renderers/clickhouse_container_renderers.py +131 -0
  770. hare/dialects/clickhouse/renderers/clickhouse_json_renderers.py +100 -0
  771. hare/dialects/clickhouse/renderers/clickhouse_json_texts.py +34 -0
  772. hare/dialects/clickhouse/renderers/clickhouse_number_renderers.py +76 -0
  773. hare/dialects/clickhouse/renderers/clickhouse_renderers.py +290 -0
  774. hare/dialects/clickhouse/renderers/clickhouse_temporal_renderers.py +276 -0
  775. hare/dialects/clickhouse/renderers/clickhouse_text_renderers.py +119 -0
  776. hare/dialects/clickhouse/renderers/clickhouse_value_casts.py +61 -0
  777. hare/dialects/clickhouse/renderers/clickhouse_window_renderers.py +117 -0
  778. hare/dialects/clickhouse/renderers/constants.py +258 -0
  779. hare/dialects/clickhouse/request_query/__init__.py +8 -0
  780. hare/dialects/clickhouse/request_query/declarations.py +17 -0
  781. hare/dialects/clickhouse/schema/__init__.py +1 -0
  782. hare/dialects/clickhouse/schema/clickhouse_schema_editor.py +314 -0
  783. hare/dialects/clickhouse/schema/columns/__init__.py +1 -0
  784. hare/dialects/clickhouse/schema/columns/clickhouse_column_backfill.py +126 -0
  785. hare/dialects/clickhouse/schema/columns/clickhouse_column_conversion_check.py +179 -0
  786. hare/dialects/clickhouse/schema/columns/clickhouse_column_definitions.py +81 -0
  787. hare/dialects/clickhouse/schema/columns/clickhouse_column_narrowing_check.py +254 -0
  788. hare/dialects/clickhouse/schema/columns/clickhouse_column_renames.py +45 -0
  789. hare/dialects/clickhouse/schema/constants.py +233 -0
  790. hare/dialects/clickhouse/schema/indexes/__init__.py +0 -0
  791. hare/dialects/clickhouse/schema/indexes/clickhouse_index_statements.py +73 -0
  792. hare/dialects/clickhouse/schema/messages.py +53 -0
  793. hare/dialects/clickhouse/schema/runtime_statements/__init__.py +1 -0
  794. hare/dialects/clickhouse/schema/runtime_statements/clickhouse_table_clearing.py +32 -0
  795. hare/dialects/clickhouse/schema/schema_objects/__init__.py +0 -0
  796. hare/dialects/clickhouse/schema/schema_objects/clickhouse_dictionaries.py +186 -0
  797. hare/dialects/clickhouse/schema/schema_objects/clickhouse_materialized_views.py +304 -0
  798. hare/dialects/clickhouse/schema/schema_objects/clickhouse_projection_compiler.py +86 -0
  799. hare/dialects/clickhouse/schema/schema_objects/clickhouse_schemas.py +68 -0
  800. hare/dialects/clickhouse/schema/schema_objects/clickhouse_table_schema_move.py +36 -0
  801. hare/dialects/clickhouse/schema/schema_objects/clickhouse_views.py +66 -0
  802. hare/dialects/clickhouse/schema/shadow/__init__.py +0 -0
  803. hare/dialects/clickhouse/schema/shadow/clickhouse_shadow_database.py +160 -0
  804. hare/dialects/clickhouse/schema/tables/__init__.py +1 -0
  805. hare/dialects/clickhouse/schema/tables/clickhouse_rebuild_check.py +43 -0
  806. hare/dialects/clickhouse/schema/tables/clickhouse_replica_check.py +42 -0
  807. hare/dialects/clickhouse/schema/tables/clickhouse_table_comments.py +52 -0
  808. hare/dialects/clickhouse/schema/tables/clickhouse_table_creation.py +54 -0
  809. hare/dialects/clickhouse/schema/tables/clickhouse_table_partitions.py +239 -0
  810. hare/dialects/clickhouse/schema/tables/clickhouse_table_rebuild.py +470 -0
  811. hare/dialects/clickhouse/schema_objects/__init__.py +6 -0
  812. hare/dialects/clickhouse/schema_objects/clickhouse_dictionary.py +122 -0
  813. hare/dialects/clickhouse/schema_objects/clickhouse_materialized_view.py +175 -0
  814. hare/dialects/clickhouse/schema_objects/clickhouse_projection.py +142 -0
  815. hare/dialects/clickhouse/schema_objects/dictionary_source.py +56 -0
  816. hare/dialects/clickhouse/server_versions.py +5 -0
  817. hare/dialects/clickhouse/spatial/__init__.py +0 -0
  818. hare/dialects/clickhouse/spatial/clickhouse_geometry_values.py +207 -0
  819. hare/dialects/clickhouse/spatial/clickhouse_spatial_renderers.py +262 -0
  820. hare/dialects/clickhouse/spatial/constants.py +67 -0
  821. hare/dialects/clickhouse/transactions/__init__.py +0 -0
  822. hare/dialects/clickhouse/transactions/clickhouse_transaction_statements.py +19 -0
  823. hare/dialects/clickhouse/types/__init__.py +1 -0
  824. hare/dialects/clickhouse/types/clickhouse_address_values.py +35 -0
  825. hare/dialects/clickhouse/types/clickhouse_binary_values.py +58 -0
  826. hare/dialects/clickhouse/types/clickhouse_container_values.py +292 -0
  827. hare/dialects/clickhouse/types/clickhouse_dynamic_values.py +315 -0
  828. hare/dialects/clickhouse/types/clickhouse_enum_types.py +247 -0
  829. hare/dialects/clickhouse/types/clickhouse_json_values.py +239 -0
  830. hare/dialects/clickhouse/types/clickhouse_low_cardinality_values.py +79 -0
  831. hare/dialects/clickhouse/types/clickhouse_nullable_types.py +27 -0
  832. hare/dialects/clickhouse/types/clickhouse_physical_type.py +122 -0
  833. hare/dialects/clickhouse/types/clickhouse_type_names.py +123 -0
  834. hare/dialects/clickhouse/types/clickhouse_types.py +276 -0
  835. hare/dialects/clickhouse/types/clickhouse_variant_values.py +122 -0
  836. hare/dialects/clickhouse/types/constants.py +154 -0
  837. hare/dialects/clickhouse/types/declarations.py +23 -0
  838. hare/dialects/constants.py +32 -0
  839. hare/dialects/dialect_registry.py +307 -0
  840. hare/dialects/enums.py +32 -0
  841. hare/dialects/postgresql/__init__.py +3 -0
  842. hare/dialects/postgresql/clauses/__init__.py +1 -0
  843. hare/dialects/postgresql/clauses/constants.py +44 -0
  844. hare/dialects/postgresql/clauses/postgresql_query_clauses.py +114 -0
  845. hare/dialects/postgresql/client/__init__.py +10 -0
  846. hare/dialects/postgresql/client/constants.py +152 -0
  847. hare/dialects/postgresql/client/pool_timeouts.py +48 -0
  848. hare/dialects/postgresql/client/postgresql_client.py +807 -0
  849. hare/dialects/postgresql/client/postgresql_connect_errors.py +67 -0
  850. hare/dialects/postgresql/client/postgresql_transaction_client.py +84 -0
  851. hare/dialects/postgresql/client/transaction_pooler.py +127 -0
  852. hare/dialects/postgresql/connection/__init__.py +1 -0
  853. hare/dialects/postgresql/connection/constants.py +19 -0
  854. hare/dialects/postgresql/connection/messages.py +3 -0
  855. hare/dialects/postgresql/connection/postgresql_driver.py +90 -0
  856. hare/dialects/postgresql/connection/search_path.py +99 -0
  857. hare/dialects/postgresql/connection/search_path_option.py +19 -0
  858. hare/dialects/postgresql/constants.py +848 -0
  859. hare/dialects/postgresql/declarations.py +19 -0
  860. hare/dialects/postgresql/drivers/__init__.py +0 -0
  861. hare/dialects/postgresql/drivers/asyncpg/__init__.py +0 -0
  862. hare/dialects/postgresql/drivers/asyncpg/asyncpg_date_codec.py +29 -0
  863. hare/dialects/postgresql/drivers/asyncpg/asyncpg_driver.py +45 -0
  864. hare/dialects/postgresql/drivers/asyncpg/asyncpg_extension_type_codecs.py +71 -0
  865. hare/dialects/postgresql/drivers/asyncpg/asyncpg_hstore_codec.py +52 -0
  866. hare/dialects/postgresql/drivers/asyncpg/asyncpg_interval_codec.py +73 -0
  867. hare/dialects/postgresql/drivers/asyncpg/asyncpg_timestamp_codec.py +74 -0
  868. hare/dialects/postgresql/drivers/asyncpg/asyncpg_timestamptz_codec.py +30 -0
  869. hare/dialects/postgresql/drivers/asyncpg/asyncpg_tsvector_codec.py +222 -0
  870. hare/dialects/postgresql/drivers/asyncpg/client/__init__.py +9 -0
  871. hare/dialects/postgresql/drivers/asyncpg/client/asyncpg_client.py +733 -0
  872. hare/dialects/postgresql/drivers/asyncpg/client/asyncpg_parameters.py +98 -0
  873. hare/dialects/postgresql/drivers/asyncpg/client/asyncpg_schema_codecs.py +82 -0
  874. hare/dialects/postgresql/drivers/asyncpg/client/asyncpg_transaction_client.py +202 -0
  875. hare/dialects/postgresql/drivers/asyncpg/client/asyncpg_transaction_connection_wrapper.py +25 -0
  876. hare/dialects/postgresql/drivers/asyncpg/client/constants.py +13 -0
  877. hare/dialects/postgresql/drivers/asyncpg/constants.py +127 -0
  878. hare/dialects/postgresql/drivers/asyncpg/pre_epoch_local_zone.py +27 -0
  879. hare/dialects/postgresql/drivers/constants.py +22 -0
  880. hare/dialects/postgresql/drivers/rust_pg/__init__.py +0 -0
  881. hare/dialects/postgresql/drivers/rust_pg/client/__init__.py +9 -0
  882. hare/dialects/postgresql/drivers/rust_pg/client/rust_pg_client.py +446 -0
  883. hare/dialects/postgresql/drivers/rust_pg/client/rust_pg_transaction_client.py +276 -0
  884. hare/dialects/postgresql/drivers/rust_pg/client/rust_pg_transaction_connection_wrapper.py +53 -0
  885. hare/dialects/postgresql/drivers/rust_pg/constants.py +35 -0
  886. hare/dialects/postgresql/drivers/rust_pg/rust_pg_driver.py +65 -0
  887. hare/dialects/postgresql/enums.py +115 -0
  888. hare/dialects/postgresql/fields/__init__.py +66 -0
  889. hare/dialects/postgresql/fields/citext_field.py +32 -0
  890. hare/dialects/postgresql/fields/constants.py +112 -0
  891. hare/dialects/postgresql/fields/fixed_char_field.py +23 -0
  892. hare/dialects/postgresql/fields/hstore/__init__.py +5 -0
  893. hare/dialects/postgresql/fields/hstore/h_store_field.py +109 -0
  894. hare/dialects/postgresql/fields/hstore/h_store_text.py +86 -0
  895. hare/dialects/postgresql/fields/interval_field.py +38 -0
  896. hare/dialects/postgresql/fields/ltree_field.py +109 -0
  897. hare/dialects/postgresql/fields/multiranges/__init__.py +19 -0
  898. hare/dialects/postgresql/fields/multiranges/declarations.py +55 -0
  899. hare/dialects/postgresql/fields/multiranges/multi_range_field.py +355 -0
  900. hare/dialects/postgresql/fields/naive_datetime_field.py +74 -0
  901. hare/dialects/postgresql/fields/naive_time_field.py +64 -0
  902. hare/dialects/postgresql/fields/native_enum/__init__.py +5 -0
  903. hare/dialects/postgresql/fields/native_enum/native_enum_field.py +23 -0
  904. hare/dialects/postgresql/fields/native_enum/native_enum_field_instance.py +87 -0
  905. hare/dialects/postgresql/fields/network/__init__.py +7 -0
  906. hare/dialects/postgresql/fields/network/cidr_field.py +39 -0
  907. hare/dialects/postgresql/fields/network/inet_field.py +35 -0
  908. hare/dialects/postgresql/fields/network/mac_address_field.py +62 -0
  909. hare/dialects/postgresql/fields/network/network_field.py +84 -0
  910. hare/dialects/postgresql/fields/network/network_limit.py +19 -0
  911. hare/dialects/postgresql/fields/ranges/__init__.py +19 -0
  912. hare/dialects/postgresql/fields/ranges/date_range_field.py +46 -0
  913. hare/dialects/postgresql/fields/ranges/date_time_range_field.py +148 -0
  914. hare/dialects/postgresql/fields/ranges/decimal_range_field.py +48 -0
  915. hare/dialects/postgresql/fields/ranges/declarations.py +17 -0
  916. hare/dialects/postgresql/fields/ranges/int_range_field.py +59 -0
  917. hare/dialects/postgresql/fields/ranges/range.py +43 -0
  918. hare/dialects/postgresql/fields/ranges/range_field.py +365 -0
  919. hare/dialects/postgresql/fields/ts_vector_field.py +159 -0
  920. hare/dialects/postgresql/functions/__init__.py +107 -0
  921. hare/dialects/postgresql/functions/aggregates/__init__.py +21 -0
  922. hare/dialects/postgresql/functions/aggregates/declarations.py +67 -0
  923. hare/dialects/postgresql/functions/aggregates/jsonb_agg.py +46 -0
  924. hare/dialects/postgresql/functions/aggregates/jsonb_agg_field.py +56 -0
  925. hare/dialects/postgresql/functions/aggregates/range_agg.py +23 -0
  926. hare/dialects/postgresql/functions/aggregates/string_agg.py +99 -0
  927. hare/dialects/postgresql/functions/aggregates/string_agg_function.py +13 -0
  928. hare/dialects/postgresql/functions/array/__init__.py +9 -0
  929. hare/dialects/postgresql/functions/array/any_value.py +13 -0
  930. hare/dialects/postgresql/functions/array/array_subquery.py +66 -0
  931. hare/dialects/postgresql/functions/constants.py +8 -0
  932. hare/dialects/postgresql/functions/ltree/__init__.py +7 -0
  933. hare/dialects/postgresql/functions/ltree/subpath.py +54 -0
  934. hare/dialects/postgresql/functions/random_uuid.py +30 -0
  935. hare/dialects/postgresql/functions/statistics/__init__.py +31 -0
  936. hare/dialects/postgresql/functions/statistics/covar_pop.py +49 -0
  937. hare/dialects/postgresql/functions/statistics/declarations.py +84 -0
  938. hare/dialects/postgresql/functions/statistics/regr_count.py +21 -0
  939. hare/dialects/postgresql/functions/statistics/statistic_pair_aggregate.py +55 -0
  940. hare/dialects/postgresql/functions/transaction_now.py +31 -0
  941. hare/dialects/postgresql/functions/trigram/__init__.py +21 -0
  942. hare/dialects/postgresql/functions/trigram/declarations.py +53 -0
  943. hare/dialects/postgresql/functions/trigram/trigram_function.py +65 -0
  944. hare/dialects/postgresql/functions/trigram/trigram_word_similarity.py +19 -0
  945. hare/dialects/postgresql/indexes/__init__.py +25 -0
  946. hare/dialects/postgresql/indexes/constants.py +16 -0
  947. hare/dialects/postgresql/indexes/declarations.py +36 -0
  948. hare/dialects/postgresql/indexes/hnsw_index.py +63 -0
  949. hare/dialects/postgresql/indexes/ivfflat_index.py +37 -0
  950. hare/dialects/postgresql/indexes/postgresql_index.py +112 -0
  951. hare/dialects/postgresql/introspection/__init__.py +0 -0
  952. hare/dialects/postgresql/introspection/constants.py +50 -0
  953. hare/dialects/postgresql/introspection/postgresql_array_literals.py +101 -0
  954. hare/dialects/postgresql/introspection/postgresql_catalog_parts.py +156 -0
  955. hare/dialects/postgresql/introspection/postgresql_catalog_reader.py +109 -0
  956. hare/dialects/postgresql/introspection/postgresql_declaration_mapper.py +610 -0
  957. hare/dialects/postgresql/introspection/postgresql_definitions.py +231 -0
  958. hare/dialects/postgresql/introspection/postgresql_inspected_schema_objects.py +152 -0
  959. hare/dialects/postgresql/introspection/postgresql_object_grants.py +58 -0
  960. hare/dialects/postgresql/introspection/postgresql_object_parts.py +114 -0
  961. hare/dialects/postgresql/literals/__init__.py +1 -0
  962. hare/dialects/postgresql/literals/postgresql_literals.py +138 -0
  963. hare/dialects/postgresql/lookups/__init__.py +0 -0
  964. hare/dialects/postgresql/lookups/array/__init__.py +5 -0
  965. hare/dialects/postgresql/lookups/array/array_length.py +29 -0
  966. hare/dialects/postgresql/lookups/constants.py +62 -0
  967. hare/dialects/postgresql/lookups/hstore/__init__.py +11 -0
  968. hare/dialects/postgresql/lookups/hstore/h_store_value_term.py +18 -0
  969. hare/dialects/postgresql/lookups/hstore/postgresql_h_store_field_lookups.py +72 -0
  970. hare/dialects/postgresql/lookups/hstore/postgresql_h_store_lookups.py +38 -0
  971. hare/dialects/postgresql/lookups/in_list/__init__.py +11 -0
  972. hare/dialects/postgresql/lookups/in_list/array_parameter.py +109 -0
  973. hare/dialects/postgresql/lookups/in_list/postgresql_large_in_list.py +75 -0
  974. hare/dialects/postgresql/lookups/in_list/unnest_row_values.py +30 -0
  975. hare/dialects/postgresql/lookups/json/__init__.py +9 -0
  976. hare/dialects/postgresql/lookups/json/postgresql_json_filter_guards.py +103 -0
  977. hare/dialects/postgresql/lookups/json/postgresql_json_lookups.py +61 -0
  978. hare/dialects/postgresql/lookups/ltree/__init__.py +9 -0
  979. hare/dialects/postgresql/lookups/ltree/postgresql_ltree_field_lookups.py +55 -0
  980. hare/dialects/postgresql/lookups/ltree/postgresql_ltree_lookups.py +35 -0
  981. hare/dialects/postgresql/lookups/multiranges/__init__.py +9 -0
  982. hare/dialects/postgresql/lookups/multiranges/postgresql_multi_range_field_lookups.py +52 -0
  983. hare/dialects/postgresql/lookups/network/__init__.py +1 -0
  984. hare/dialects/postgresql/lookups/network/postgresql_network_field_lookups.py +47 -0
  985. hare/dialects/postgresql/lookups/network/postgresql_network_lookups.py +35 -0
  986. hare/dialects/postgresql/lookups/postgresql_filter_operators.py +109 -0
  987. hare/dialects/postgresql/lookups/postgresql_regex_lookups.py +22 -0
  988. hare/dialects/postgresql/lookups/postgresql_value_encoders.py +159 -0
  989. hare/dialects/postgresql/lookups/ranges/__init__.py +9 -0
  990. hare/dialects/postgresql/lookups/ranges/postgresql_range_field_lookups.py +54 -0
  991. hare/dialects/postgresql/lookups/ranges/postgresql_range_lookups.py +49 -0
  992. hare/dialects/postgresql/lookups/trigram/__init__.py +1 -0
  993. hare/dialects/postgresql/lookups/trigram/postgresql_trigram_lookups.py +76 -0
  994. hare/dialects/postgresql/lookups/unaccent_transform.py +48 -0
  995. hare/dialects/postgresql/migration_safety/__init__.py +9 -0
  996. hare/dialects/postgresql/migration_safety/check_constraint_validation_rule.py +36 -0
  997. hare/dialects/postgresql/migration_safety/constants.py +15 -0
  998. hare/dialects/postgresql/migration_safety/foreign_key_validation_rule.py +74 -0
  999. hare/dialects/postgresql/migration_safety/index_without_concurrently_rule.py +45 -0
  1000. hare/dialects/postgresql/migration_safety/postgresql_migration_safety_rules.py +55 -0
  1001. hare/dialects/postgresql/migration_safety/set_not_null_rule.py +47 -0
  1002. hare/dialects/postgresql/migration_safety/unique_constraint_index_rule.py +71 -0
  1003. hare/dialects/postgresql/migration_safety/volatile_default_rule.py +50 -0
  1004. hare/dialects/postgresql/parameters/__init__.py +1 -0
  1005. hare/dialects/postgresql/parameters/constants.py +83 -0
  1006. hare/dialects/postgresql/parameters/postgresql_parameters.py +100 -0
  1007. hare/dialects/postgresql/partitioning/__init__.py +23 -0
  1008. hare/dialects/postgresql/partitioning/constants.py +49 -0
  1009. hare/dialects/postgresql/partitioning/explicit_partitioning.py +106 -0
  1010. hare/dialects/postgresql/partitioning/hash_partitioning.py +78 -0
  1011. hare/dialects/postgresql/partitioning/list_partitioning.py +56 -0
  1012. hare/dialects/postgresql/partitioning/observed_partitioning.py +211 -0
  1013. hare/dialects/postgresql/partitioning/partitioning.py +284 -0
  1014. hare/dialects/postgresql/partitioning/partitions/__init__.py +1 -0
  1015. hare/dialects/postgresql/partitioning/partitions/default_partition.py +21 -0
  1016. hare/dialects/postgresql/partitioning/partitions/hash_partition.py +18 -0
  1017. hare/dialects/postgresql/partitioning/partitions/list_partition.py +35 -0
  1018. hare/dialects/postgresql/partitioning/partitions/partition.py +72 -0
  1019. hare/dialects/postgresql/partitioning/partitions/range_partition.py +93 -0
  1020. hare/dialects/postgresql/partitioning/range_partitioning.py +61 -0
  1021. hare/dialects/postgresql/postgresql_dialect.py +220 -0
  1022. hare/dialects/postgresql/postgresql_introspector.py +422 -0
  1023. hare/dialects/postgresql/postgresql_table_options.py +153 -0
  1024. hare/dialects/postgresql/query/__init__.py +7 -0
  1025. hare/dialects/postgresql/query/declarations.py +13 -0
  1026. hare/dialects/postgresql/renderers/__init__.py +7 -0
  1027. hare/dialects/postgresql/renderers/constants.py +46 -0
  1028. hare/dialects/postgresql/renderers/postgresql_container_renderers.py +117 -0
  1029. hare/dialects/postgresql/renderers/postgresql_defaults.py +90 -0
  1030. hare/dialects/postgresql/renderers/postgresql_json_renderers.py +58 -0
  1031. hare/dialects/postgresql/renderers/postgresql_number_renderers.py +58 -0
  1032. hare/dialects/postgresql/renderers/postgresql_renderers.py +89 -0
  1033. hare/dialects/postgresql/renderers/postgresql_temporal_renderers.py +183 -0
  1034. hare/dialects/postgresql/renderers/postgresql_text_renderers.py +67 -0
  1035. hare/dialects/postgresql/request_query/__init__.py +8 -0
  1036. hare/dialects/postgresql/request_query/declarations.py +17 -0
  1037. hare/dialects/postgresql/schema/__init__.py +0 -0
  1038. hare/dialects/postgresql/schema/columns/__init__.py +1 -0
  1039. hare/dialects/postgresql/schema/columns/postgresql_column_backfill.py +13 -0
  1040. hare/dialects/postgresql/schema/columns/postgresql_column_narrowing_check.py +110 -0
  1041. hare/dialects/postgresql/schema/columns/postgresql_column_type_changes.py +101 -0
  1042. hare/dialects/postgresql/schema/constants.py +418 -0
  1043. hare/dialects/postgresql/schema/constraints/__init__.py +1 -0
  1044. hare/dialects/postgresql/schema/constraints/postgresql_constraint_statements.py +127 -0
  1045. hare/dialects/postgresql/schema/indexes/__init__.py +1 -0
  1046. hare/dialects/postgresql/schema/indexes/postgresql_index_statements.py +24 -0
  1047. hare/dialects/postgresql/schema/postgresql_schema_editor.py +290 -0
  1048. hare/dialects/postgresql/schema/relations/__init__.py +1 -0
  1049. hare/dialects/postgresql/schema/relations/postgresql_foreign_key_rebuild.py +231 -0
  1050. hare/dialects/postgresql/schema/runtime_statements/__init__.py +1 -0
  1051. hare/dialects/postgresql/schema/runtime_statements/postgresql_foreign_key_deferral.py +110 -0
  1052. hare/dialects/postgresql/schema/runtime_statements/postgresql_table_clearing.py +80 -0
  1053. hare/dialects/postgresql/schema/runtime_statements/postgresql_table_locks.py +27 -0
  1054. hare/dialects/postgresql/schema/runtime_statements/postgresql_tenant_conditions.py +41 -0
  1055. hare/dialects/postgresql/schema/schema_objects/__init__.py +1 -0
  1056. hare/dialects/postgresql/schema/schema_objects/postgresql_database_functions.py +89 -0
  1057. hare/dialects/postgresql/schema/schema_objects/postgresql_enum_replacement.py +142 -0
  1058. hare/dialects/postgresql/schema/schema_objects/postgresql_enum_types.py +199 -0
  1059. hare/dialects/postgresql/schema/schema_objects/postgresql_extensions.py +35 -0
  1060. hare/dialects/postgresql/schema/schema_objects/postgresql_function_arguments.py +39 -0
  1061. hare/dialects/postgresql/schema/schema_objects/postgresql_grants.py +93 -0
  1062. hare/dialects/postgresql/schema/schema_objects/postgresql_materialized_views.py +127 -0
  1063. hare/dialects/postgresql/schema/schema_objects/postgresql_row_level_security_policies.py +126 -0
  1064. hare/dialects/postgresql/schema/schema_objects/postgresql_schemas.py +57 -0
  1065. hare/dialects/postgresql/schema/schema_objects/postgresql_sequences.py +139 -0
  1066. hare/dialects/postgresql/schema/schema_objects/postgresql_views.py +55 -0
  1067. hare/dialects/postgresql/schema/shadow/__init__.py +0 -0
  1068. hare/dialects/postgresql/schema/shadow/postgresql_shadow_database.py +99 -0
  1069. hare/dialects/postgresql/schema/tables/__init__.py +1 -0
  1070. hare/dialects/postgresql/schema/tables/postgresql_table_comments.py +67 -0
  1071. hare/dialects/postgresql/schema/tables/postgresql_table_partitions.py +253 -0
  1072. hare/dialects/postgresql/schema/tables/postgresql_table_rebuild.py +133 -0
  1073. hare/dialects/postgresql/schema/triggers/__init__.py +1 -0
  1074. hare/dialects/postgresql/schema/triggers/postgresql_trigger_statements.py +131 -0
  1075. hare/dialects/postgresql/search/__init__.py +15 -0
  1076. hare/dialects/postgresql/search/configured_search_vector.py +29 -0
  1077. hare/dialects/postgresql/search/constants.py +52 -0
  1078. hare/dialects/postgresql/search/criterion/__init__.py +14 -0
  1079. hare/dialects/postgresql/search/criterion/declarations.py +14 -0
  1080. hare/dialects/postgresql/search/criterion/search_criterion.py +73 -0
  1081. hare/dialects/postgresql/search/criterion/ts_query_function.py +24 -0
  1082. hare/dialects/postgresql/search/criterion/ts_query_invert.py +31 -0
  1083. hare/dialects/postgresql/search/enums.py +12 -0
  1084. hare/dialects/postgresql/search/functions/__init__.py +9 -0
  1085. hare/dialects/postgresql/search/functions/plain_to_ts_query.py +18 -0
  1086. hare/dialects/postgresql/search/functions/to_ts_vector.py +20 -0
  1087. hare/dialects/postgresql/search/lexemes/__init__.py +1 -0
  1088. hare/dialects/postgresql/search/lexemes/combined_lexeme.py +32 -0
  1089. hare/dialects/postgresql/search/lexemes/lexeme.py +75 -0
  1090. hare/dialects/postgresql/search/lexemes/lexeme_combinable.py +66 -0
  1091. hare/dialects/postgresql/search/messages.py +2 -0
  1092. hare/dialects/postgresql/search/postgresql_text_search.py +293 -0
  1093. hare/dialects/postgresql/search/ts_vector_expression_reader.py +87 -0
  1094. hare/dialects/postgresql/search_feature_constants.py +5 -0
  1095. hare/dialects/postgresql/server_versions.py +26 -0
  1096. hare/dialects/postgresql/spatial/__init__.py +7 -0
  1097. hare/dialects/postgresql/spatial/constants.py +123 -0
  1098. hare/dialects/postgresql/spatial/postgresql_spatial_renderers.py +129 -0
  1099. hare/dialects/postgresql/transactions/__init__.py +1 -0
  1100. hare/dialects/postgresql/transactions/constants.py +25 -0
  1101. hare/dialects/postgresql/transactions/postgresql_transaction_statements.py +51 -0
  1102. hare/dialects/postgresql/transactions/postgresql_two_phase_commit.py +88 -0
  1103. hare/dialects/postgresql/types/__init__.py +1 -0
  1104. hare/dialects/postgresql/types/constants.py +96 -0
  1105. hare/dialects/postgresql/types/postgresql_comparison_keys.py +46 -0
  1106. hare/dialects/postgresql/types/postgresql_container_values.py +90 -0
  1107. hare/dialects/postgresql/types/postgresql_physical_type.py +109 -0
  1108. hare/dialects/postgresql/types/postgresql_types.py +211 -0
  1109. hare/dialects/postgresql/validators/__init__.py +15 -0
  1110. hare/dialects/postgresql/validators/keys_validator.py +32 -0
  1111. hare/dialects/postgresql/validators/range_bound_validator.py +33 -0
  1112. hare/dialects/postgresql/validators/range_max_value_validator.py +17 -0
  1113. hare/dialects/postgresql/validators/range_min_value_validator.py +17 -0
  1114. hare/dialects/postgresql/vectors/__init__.py +1 -0
  1115. hare/dialects/postgresql/vectors/constants.py +13 -0
  1116. hare/dialects/postgresql/vectors/postgresql_vector_renderers.py +40 -0
  1117. hare/dialects/postgresql/vectors/postgresql_vector_values.py +93 -0
  1118. hare/dialects/sqlite/__init__.py +0 -0
  1119. hare/dialects/sqlite/clauses/__init__.py +1 -0
  1120. hare/dialects/sqlite/clauses/constants.py +7 -0
  1121. hare/dialects/sqlite/clauses/sqlite_query_clauses.py +100 -0
  1122. hare/dialects/sqlite/client/__init__.py +11 -0
  1123. hare/dialects/sqlite/client/constants.py +101 -0
  1124. hare/dialects/sqlite/client/declarations.py +27 -0
  1125. hare/dialects/sqlite/client/sqlite_client.py +623 -0
  1126. hare/dialects/sqlite/client/sqlite_migration_lock.py +76 -0
  1127. hare/dialects/sqlite/client/sqlite_pragma_scope.py +52 -0
  1128. hare/dialects/sqlite/client/sqlite_transaction_client.py +193 -0
  1129. hare/dialects/sqlite/connection/__init__.py +1 -0
  1130. hare/dialects/sqlite/connection/constants.py +7 -0
  1131. hare/dialects/sqlite/connection/sqlite_driver.py +46 -0
  1132. hare/dialects/sqlite/connection/sqlite_extension_loading.py +28 -0
  1133. hare/dialects/sqlite/constants.py +428 -0
  1134. hare/dialects/sqlite/declarations.py +24 -0
  1135. hare/dialects/sqlite/drivers/__init__.py +1 -0
  1136. hare/dialects/sqlite/drivers/aiosqlite/__init__.py +1 -0
  1137. hare/dialects/sqlite/drivers/aiosqlite/aiosqlite_driver.py +40 -0
  1138. hare/dialects/sqlite/drivers/aiosqlite/client/__init__.py +23 -0
  1139. hare/dialects/sqlite/drivers/aiosqlite/client/aiosqlite_client.py +479 -0
  1140. hare/dialects/sqlite/drivers/aiosqlite/client/aiosqlite_client_with_regexp_support.py +16 -0
  1141. hare/dialects/sqlite/drivers/aiosqlite/client/aiosqlite_connection_wrapper.py +61 -0
  1142. hare/dialects/sqlite/drivers/aiosqlite/client/aiosqlite_statement_timeout_connection_wrapper.py +53 -0
  1143. hare/dialects/sqlite/drivers/aiosqlite/client/aiosqlite_transaction_client.py +233 -0
  1144. hare/dialects/sqlite/drivers/aiosqlite/client/aiosqlite_transaction_connection_wrapper.py +17 -0
  1145. hare/dialects/sqlite/drivers/aiosqlite/constants.py +11 -0
  1146. hare/dialects/sqlite/drivers/constants.py +25 -0
  1147. hare/dialects/sqlite/enums.py +51 -0
  1148. hare/dialects/sqlite/exceptions.py +10 -0
  1149. hare/dialects/sqlite/functions/__init__.py +0 -0
  1150. hare/dialects/sqlite/functions/comparison/__init__.py +11 -0
  1151. hare/dialects/sqlite/functions/comparison/sqlite_cast.py +89 -0
  1152. hare/dialects/sqlite/functions/comparison/sqlite_greatest_least.py +51 -0
  1153. hare/dialects/sqlite/functions/constants.py +57 -0
  1154. hare/dialects/sqlite/functions/datetime/__init__.py +0 -0
  1155. hare/dialects/sqlite/functions/datetime/date_truncation.py +82 -0
  1156. hare/dialects/sqlite/functions/datetime/sqlite_date_part_extraction.py +48 -0
  1157. hare/dialects/sqlite/functions/datetime/sqlite_date_timestamp.py +43 -0
  1158. hare/dialects/sqlite/functions/datetime/sqlite_local_now.py +47 -0
  1159. hare/dialects/sqlite/functions/datetime/temporal_arithmetic_functions.py +145 -0
  1160. hare/dialects/sqlite/functions/json/__init__.py +9 -0
  1161. hare/dialects/sqlite/functions/json/sqlite_json_datetime.py +99 -0
  1162. hare/dialects/sqlite/functions/json/sqlite_json_path.py +117 -0
  1163. hare/dialects/sqlite/functions/regex/__init__.py +5 -0
  1164. hare/dialects/sqlite/functions/regex/sqlite_posix_regex.py +102 -0
  1165. hare/dialects/sqlite/functions/regex/sqlite_regex_criterion.py +18 -0
  1166. hare/dialects/sqlite/functions/sqlite_connection_function.py +17 -0
  1167. hare/dialects/sqlite/functions/sqlite_function_errors.py +45 -0
  1168. hare/dialects/sqlite/functions/sqlite_math_functions.py +207 -0
  1169. hare/dialects/sqlite/functions/sqlite_native_functions.py +54 -0
  1170. hare/dialects/sqlite/functions/statistics/__init__.py +19 -0
  1171. hare/dialects/sqlite/functions/statistics/declarations.py +31 -0
  1172. hare/dialects/sqlite/functions/statistics/sqlite_statistic.py +37 -0
  1173. hare/dialects/sqlite/functions/statistics/sqlite_statistics.py +46 -0
  1174. hare/dialects/sqlite/functions/text/__init__.py +1 -0
  1175. hare/dialects/sqlite/functions/text/sqlite_text_functions.py +130 -0
  1176. hare/dialects/sqlite/indexes/__init__.py +7 -0
  1177. hare/dialects/sqlite/indexes/constants.py +42 -0
  1178. hare/dialects/sqlite/indexes/full_text_index.py +221 -0
  1179. hare/dialects/sqlite/indexes/separate_table_index.py +104 -0
  1180. hare/dialects/sqlite/indexes/spatialite_index.py +230 -0
  1181. hare/dialects/sqlite/introspection/__init__.py +0 -0
  1182. hare/dialects/sqlite/introspection/catalog_index_key.py +19 -0
  1183. hare/dialects/sqlite/introspection/sqlite_catalog_parts.py +127 -0
  1184. hare/dialects/sqlite/introspection/sqlite_catalog_reader.py +130 -0
  1185. hare/dialects/sqlite/introspection/sqlite_column_declarations.py +88 -0
  1186. hare/dialects/sqlite/introspection/sqlite_constraint_clauses.py +74 -0
  1187. hare/dialects/sqlite/introspection/sqlite_declaration_mapper.py +352 -0
  1188. hare/dialects/sqlite/introspection/sqlite_foreign_key_clauses.py +140 -0
  1189. hare/dialects/sqlite/introspection/sqlite_index_info.py +14 -0
  1190. hare/dialects/sqlite/literals/__init__.py +1 -0
  1191. hare/dialects/sqlite/literals/constants.py +10 -0
  1192. hare/dialects/sqlite/literals/sqlite_literals.py +68 -0
  1193. hare/dialects/sqlite/lookups/__init__.py +0 -0
  1194. hare/dialects/sqlite/lookups/constants.py +14 -0
  1195. hare/dialects/sqlite/lookups/in_list/__init__.py +11 -0
  1196. hare/dialects/sqlite/lookups/in_list/json_array_row_values.py +38 -0
  1197. hare/dialects/sqlite/lookups/in_list/json_array_values.py +106 -0
  1198. hare/dialects/sqlite/lookups/in_list/sqlite_large_in_list.py +112 -0
  1199. hare/dialects/sqlite/lookups/json/__init__.py +1 -0
  1200. hare/dialects/sqlite/lookups/json/sqlite_json_filter_guards.py +119 -0
  1201. hare/dialects/sqlite/lookups/json/sqlite_json_lookups.py +51 -0
  1202. hare/dialects/sqlite/lookups/json/sqlite_json_path_lookups.py +56 -0
  1203. hare/dialects/sqlite/lookups/json/sqlite_json_type_criterion.py +13 -0
  1204. hare/dialects/sqlite/lookups/sqlite_filter_operators.py +114 -0
  1205. hare/dialects/sqlite/migration_safety/__init__.py +9 -0
  1206. hare/dialects/sqlite/migration_safety/sqlite_migration_safety_rules.py +33 -0
  1207. hare/dialects/sqlite/parameters/__init__.py +1 -0
  1208. hare/dialects/sqlite/parameters/constants.py +11 -0
  1209. hare/dialects/sqlite/parameters/sqlite_bound_parameter.py +21 -0
  1210. hare/dialects/sqlite/parameters/sqlite_encoded_text.py +6 -0
  1211. hare/dialects/sqlite/parameters/sqlite_parameter_adapters.py +104 -0
  1212. hare/dialects/sqlite/parameters/sqlite_parameters.py +27 -0
  1213. hare/dialects/sqlite/query/__init__.py +7 -0
  1214. hare/dialects/sqlite/query/declarations.py +13 -0
  1215. hare/dialects/sqlite/renderers/__init__.py +7 -0
  1216. hare/dialects/sqlite/renderers/constants.py +39 -0
  1217. hare/dialects/sqlite/renderers/sqlite_defaults.py +86 -0
  1218. hare/dialects/sqlite/renderers/sqlite_json_renderers.py +141 -0
  1219. hare/dialects/sqlite/renderers/sqlite_number_renderers.py +79 -0
  1220. hare/dialects/sqlite/renderers/sqlite_renderers.py +104 -0
  1221. hare/dialects/sqlite/renderers/sqlite_temporal_renderers.py +138 -0
  1222. hare/dialects/sqlite/renderers/sqlite_text_renderers.py +65 -0
  1223. hare/dialects/sqlite/request_query/__init__.py +8 -0
  1224. hare/dialects/sqlite/request_query/declarations.py +16 -0
  1225. hare/dialects/sqlite/schema/__init__.py +0 -0
  1226. hare/dialects/sqlite/schema/columns/__init__.py +1 -0
  1227. hare/dialects/sqlite/schema/columns/sqlite_column_backfill.py +32 -0
  1228. hare/dialects/sqlite/schema/columns/sqlite_column_conversion_check.py +230 -0
  1229. hare/dialects/sqlite/schema/columns/sqlite_column_narrowing_check.py +23 -0
  1230. hare/dialects/sqlite/schema/columns/sqlite_column_type_changes.py +124 -0
  1231. hare/dialects/sqlite/schema/columns/sqlite_kept_values_check.py +30 -0
  1232. hare/dialects/sqlite/schema/constants.py +110 -0
  1233. hare/dialects/sqlite/schema/constraints/__init__.py +1 -0
  1234. hare/dialects/sqlite/schema/constraints/sqlite_constraint_statements.py +33 -0
  1235. hare/dialects/sqlite/schema/indexes/__init__.py +1 -0
  1236. hare/dialects/sqlite/schema/indexes/sqlite_generated_index_names.py +58 -0
  1237. hare/dialects/sqlite/schema/indexes/sqlite_index_statements.py +92 -0
  1238. hare/dialects/sqlite/schema/indexes/sqlite_spatial_index_creation.py +37 -0
  1239. hare/dialects/sqlite/schema/relations/__init__.py +1 -0
  1240. hare/dialects/sqlite/schema/relations/sqlite_foreign_key_rebuild.py +114 -0
  1241. hare/dialects/sqlite/schema/runtime_statements/__init__.py +1 -0
  1242. hare/dialects/sqlite/schema/runtime_statements/sqlite_foreign_key_deferral.py +96 -0
  1243. hare/dialects/sqlite/schema/runtime_statements/sqlite_table_clearing.py +37 -0
  1244. hare/dialects/sqlite/schema/runtime_statements/sqlite_tenant_conditions.py +21 -0
  1245. hare/dialects/sqlite/schema/shadow/__init__.py +0 -0
  1246. hare/dialects/sqlite/schema/shadow/sqlite_shadow_database.py +36 -0
  1247. hare/dialects/sqlite/schema/sqlite_schema_editor.py +492 -0
  1248. hare/dialects/sqlite/schema/tables/__init__.py +1 -0
  1249. hare/dialects/sqlite/schema/tables/sqlite_legacy_rename.py +35 -0
  1250. hare/dialects/sqlite/schema/tables/sqlite_table_comments.py +34 -0
  1251. hare/dialects/sqlite/schema/tables/sqlite_table_rebuild.py +144 -0
  1252. hare/dialects/sqlite/schema/triggers/__init__.py +1 -0
  1253. hare/dialects/sqlite/schema/triggers/sqlite_trigger_statements.py +58 -0
  1254. hare/dialects/sqlite/search/__init__.py +8 -0
  1255. hare/dialects/sqlite/search/constants.py +37 -0
  1256. hare/dialects/sqlite/search/sqlite_full_text_query.py +141 -0
  1257. hare/dialects/sqlite/search/sqlite_search_renderers.py +39 -0
  1258. hare/dialects/sqlite/search/sqlite_text_search.py +317 -0
  1259. hare/dialects/sqlite/search/terms/__init__.py +1 -0
  1260. hare/dialects/sqlite/search/terms/full_text_headline.py +56 -0
  1261. hare/dialects/sqlite/search/terms/full_text_match.py +53 -0
  1262. hare/dialects/sqlite/search/terms/full_text_query.py +42 -0
  1263. hare/dialects/sqlite/search/terms/full_text_query_combination.py +61 -0
  1264. hare/dialects/sqlite/search/terms/full_text_rank.py +34 -0
  1265. hare/dialects/sqlite/search/terms/full_text_row_value.py +103 -0
  1266. hare/dialects/sqlite/search_feature_constants.py +11 -0
  1267. hare/dialects/sqlite/server_versions.py +17 -0
  1268. hare/dialects/sqlite/spatial/__init__.py +0 -0
  1269. hare/dialects/sqlite/spatial/constants.py +173 -0
  1270. hare/dialects/sqlite/spatial/spatialite_blob_reader.py +166 -0
  1271. hare/dialects/sqlite/spatial/spatialite_blob_writer.py +105 -0
  1272. hare/dialects/sqlite/spatial/sqlite_geometry_values.py +76 -0
  1273. hare/dialects/sqlite/spatial/sqlite_spatial_extension.py +76 -0
  1274. hare/dialects/sqlite/spatial/sqlite_spatial_renderers.py +204 -0
  1275. hare/dialects/sqlite/sqlite_dialect.py +143 -0
  1276. hare/dialects/sqlite/sqlite_introspector.py +537 -0
  1277. hare/dialects/sqlite/sqlite_table_options.py +91 -0
  1278. hare/dialects/sqlite/table_option_constants.py +15 -0
  1279. hare/dialects/sqlite/transactions/__init__.py +1 -0
  1280. hare/dialects/sqlite/transactions/constants.py +10 -0
  1281. hare/dialects/sqlite/transactions/sqlite_transaction_statements.py +19 -0
  1282. hare/dialects/sqlite/types/__init__.py +1 -0
  1283. hare/dialects/sqlite/types/constants.py +15 -0
  1284. hare/dialects/sqlite/types/sqlite_physical_type.py +34 -0
  1285. hare/dialects/sqlite/types/sqlite_types.py +85 -0
  1286. hare/dialects/sqlite/vectors/__init__.py +1 -0
  1287. hare/dialects/sqlite/vectors/constants.py +16 -0
  1288. hare/dialects/sqlite/vectors/sqlite_vector_extension.py +106 -0
  1289. hare/dialects/sqlite/vectors/sqlite_vector_renderers.py +55 -0
  1290. hare/dialects/sqlite/vectors/sqlite_vector_values.py +112 -0
  1291. hare/exceptions.py +399 -0
  1292. hare/fields/__init__.py +135 -0
  1293. hare/fields/bound_field.py +44 -0
  1294. hare/fields/composite_primary_key.py +40 -0
  1295. hare/fields/constants.py +128 -0
  1296. hare/fields/data/__init__.py +3 -0
  1297. hare/fields/data/binary_field.py +75 -0
  1298. hare/fields/data/boolean_field.py +76 -0
  1299. hare/fields/data/choices/__init__.py +16 -0
  1300. hare/fields/data/choices/char_enum_field.py +31 -0
  1301. hare/fields/data/choices/char_enum_field_instance.py +133 -0
  1302. hare/fields/data/choices/constants.py +2 -0
  1303. hare/fields/data/choices/int_enum_field.py +24 -0
  1304. hare/fields/data/choices/int_enum_field_instance.py +113 -0
  1305. hare/fields/data/constants.py +127 -0
  1306. hare/fields/data/containers/__init__.py +10 -0
  1307. hare/fields/data/containers/array_field.py +155 -0
  1308. hare/fields/data/containers/constants.py +25 -0
  1309. hare/fields/data/containers/container_field.py +363 -0
  1310. hare/fields/data/containers/container_value_converters.py +21 -0
  1311. hare/fields/data/containers/declarations.py +13 -0
  1312. hare/fields/data/containers/map_field.py +200 -0
  1313. hare/fields/data/containers/nested_field.py +67 -0
  1314. hare/fields/data/containers/tuple_field.py +220 -0
  1315. hare/fields/data/json/__init__.py +7 -0
  1316. hare/fields/data/json/json_codec.py +114 -0
  1317. hare/fields/data/json/json_field.py +382 -0
  1318. hare/fields/data/json/json_path_field.py +77 -0
  1319. hare/fields/data/json/json_text_field.py +13 -0
  1320. hare/fields/data/network/__init__.py +8 -0
  1321. hare/fields/data/network/constants.py +6 -0
  1322. hare/fields/data/network/ip_address_field.py +117 -0
  1323. hare/fields/data/network/ipv4_address_field.py +26 -0
  1324. hare/fields/data/numeric/__init__.py +23 -0
  1325. hare/fields/data/numeric/big_int_field.py +22 -0
  1326. hare/fields/data/numeric/decimal_field.py +201 -0
  1327. hare/fields/data/numeric/float_field.py +116 -0
  1328. hare/fields/data/numeric/int_field.py +302 -0
  1329. hare/fields/data/numeric/positive_big_int_field.py +19 -0
  1330. hare/fields/data/numeric/positive_int_field.py +19 -0
  1331. hare/fields/data/numeric/positive_small_int_field.py +19 -0
  1332. hare/fields/data/numeric/small_int_field.py +22 -0
  1333. hare/fields/data/temporal/__init__.py +11 -0
  1334. hare/fields/data/temporal/date_field.py +109 -0
  1335. hare/fields/data/temporal/datetime_field.py +366 -0
  1336. hare/fields/data/temporal/parse_datetime.py +17 -0
  1337. hare/fields/data/temporal/temporal_values.py +125 -0
  1338. hare/fields/data/temporal/time_delta_field.py +116 -0
  1339. hare/fields/data/temporal/time_field.py +194 -0
  1340. hare/fields/data/text/__init__.py +20 -0
  1341. hare/fields/data/text/char_field.py +69 -0
  1342. hare/fields/data/text/email_field.py +76 -0
  1343. hare/fields/data/text/phone_field.py +107 -0
  1344. hare/fields/data/text/slug_field.py +52 -0
  1345. hare/fields/data/text/string_field.py +39 -0
  1346. hare/fields/data/text/text_field.py +23 -0
  1347. hare/fields/data/text/url_field.py +52 -0
  1348. hare/fields/data/uuid_field.py +114 -0
  1349. hare/fields/database_default.py +28 -0
  1350. hare/fields/db_default_not_set.py +36 -0
  1351. hare/fields/db_defaults/__init__.py +13 -0
  1352. hare/fields/db_defaults/now.py +65 -0
  1353. hare/fields/db_defaults/random_hex.py +30 -0
  1354. hare/fields/db_defaults/sql_default.py +66 -0
  1355. hare/fields/db_defaults/uuid_v7.py +36 -0
  1356. hare/fields/declaration_snapshot.py +60 -0
  1357. hare/fields/encrypted/__init__.py +7 -0
  1358. hare/fields/encrypted/blind_index_field.py +49 -0
  1359. hare/fields/encrypted/constants.py +41 -0
  1360. hare/fields/encrypted/encrypted_field_base.py +149 -0
  1361. hare/fields/encrypted/encrypted_json_field.py +230 -0
  1362. hare/fields/encrypted/encrypted_text_field.py +136 -0
  1363. hare/fields/encrypted/encryption_keyring.py +21 -0
  1364. hare/fields/encrypted/field_encryption.py +358 -0
  1365. hare/fields/enums.py +87 -0
  1366. hare/fields/field.py +1442 -0
  1367. hare/fields/field_meta.py +16 -0
  1368. hare/fields/generated_field.py +199 -0
  1369. hare/fields/generation/__init__.py +0 -0
  1370. hare/fields/generation/generated_column.py +63 -0
  1371. hare/fields/json_values.py +116 -0
  1372. hare/fields/narrowing/__init__.py +7 -0
  1373. hare/fields/narrowing/constants.py +2 -0
  1374. hare/fields/narrowing/day_limit.py +23 -0
  1375. hare/fields/narrowing/decimal_digits_limit.py +20 -0
  1376. hare/fields/narrowing/enum_values_limit.py +40 -0
  1377. hare/fields/narrowing/float_precision_limit.py +21 -0
  1378. hare/fields/narrowing/integer_range_limit.py +22 -0
  1379. hare/fields/narrowing/narrowing_limit.py +26 -0
  1380. hare/fields/narrowing/text_length_limit.py +21 -0
  1381. hare/fields/registrations/__init__.py +1 -0
  1382. hare/fields/registrations/registered_lookup.py +29 -0
  1383. hare/fields/registrations/registered_transform.py +22 -0
  1384. hare/fields/relations/__init__.py +3 -0
  1385. hare/fields/relations/bound_relation.py +30 -0
  1386. hare/fields/relations/constants.py +10 -0
  1387. hare/fields/relations/declarations.py +5 -0
  1388. hare/fields/relations/fields/__init__.py +35 -0
  1389. hare/fields/relations/fields/backward_foreign_key_relation.py +46 -0
  1390. hare/fields/relations/fields/declarations.py +21 -0
  1391. hare/fields/relations/fields/foreign_key_field.py +89 -0
  1392. hare/fields/relations/fields/foreign_key_field_instance.py +129 -0
  1393. hare/fields/relations/fields/generic_foreign_key_field.py +56 -0
  1394. hare/fields/relations/fields/generic_foreign_key_field_instance.py +487 -0
  1395. hare/fields/relations/fields/many_to_many_field.py +61 -0
  1396. hare/fields/relations/fields/many_to_many_field_instance.py +219 -0
  1397. hare/fields/relations/fields/one_to_one_field.py +89 -0
  1398. hare/fields/relations/fields/one_to_one_field_instance.py +45 -0
  1399. hare/fields/relations/fields/relational_field.py +264 -0
  1400. hare/fields/relations/relation_accessors.py +239 -0
  1401. hare/fields/relations/relation_default.py +31 -0
  1402. hare/fields/relations/relation_values.py +122 -0
  1403. hare/fields/relations/swappable_model_reference.py +33 -0
  1404. hare/fields/uuid7.py +47 -0
  1405. hare/fields/validators/__init__.py +63 -0
  1406. hare/fields/validators/enums.py +12 -0
  1407. hare/fields/validators/exceptions.py +52 -0
  1408. hare/fields/validators/formats/__init__.py +1 -0
  1409. hare/fields/validators/formats/comma_separated_integer_list_validator.py +22 -0
  1410. hare/fields/validators/formats/domain_name_validator.py +74 -0
  1411. hare/fields/validators/formats/e164_phone_validator.py +33 -0
  1412. hare/fields/validators/formats/email_validator.py +89 -0
  1413. hare/fields/validators/formats/ipv46_validator.py +23 -0
  1414. hare/fields/validators/formats/ipv4_validator.py +23 -0
  1415. hare/fields/validators/formats/ipv6_validator.py +23 -0
  1416. hare/fields/validators/formats/regex_validator.py +40 -0
  1417. hare/fields/validators/formats/slug_validator.py +37 -0
  1418. hare/fields/validators/formats/url_validator.py +95 -0
  1419. hare/fields/validators/formats/uuid_version_validator.py +27 -0
  1420. hare/fields/validators/limits/__init__.py +1 -0
  1421. hare/fields/validators/limits/length_validator.py +20 -0
  1422. hare/fields/validators/limits/max_digits_validator.py +48 -0
  1423. hare/fields/validators/limits/max_length_validator.py +25 -0
  1424. hare/fields/validators/limits/max_value_validator.py +22 -0
  1425. hare/fields/validators/limits/min_length_validator.py +25 -0
  1426. hare/fields/validators/limits/min_value_validator.py +22 -0
  1427. hare/fields/validators/limits/numeric_validator.py +22 -0
  1428. hare/fields/validators/validator.py +34 -0
  1429. hare/gis/__init__.py +52 -0
  1430. hare/gis/aggregates/__init__.py +5 -0
  1431. hare/gis/aggregates/declarations.py +42 -0
  1432. hare/gis/aggregates/spatial_aggregate.py +61 -0
  1433. hare/gis/constants.py +127 -0
  1434. hare/gis/enums.py +74 -0
  1435. hare/gis/fields/__init__.py +23 -0
  1436. hare/gis/fields/declarations.py +61 -0
  1437. hare/gis/fields/extent_field.py +63 -0
  1438. hare/gis/fields/geometry_field.py +287 -0
  1439. hare/gis/fields/made_line_field.py +85 -0
  1440. hare/gis/functions/__init__.py +55 -0
  1441. hare/gis/functions/buffer.py +29 -0
  1442. hare/gis/functions/constants.py +16 -0
  1443. hare/gis/functions/declarations.py +188 -0
  1444. hare/gis/functions/dwithin.py +43 -0
  1445. hare/gis/functions/simplify.py +29 -0
  1446. hare/gis/functions/spatial_function.py +166 -0
  1447. hare/gis/functions/spatial_output_domain.py +62 -0
  1448. hare/gis/functions/transform.py +36 -0
  1449. hare/gis/geometries/__init__.py +19 -0
  1450. hare/gis/geometries/declarations.py +38 -0
  1451. hare/gis/geometries/geometry.py +295 -0
  1452. hare/gis/geometries/geometry_collection.py +62 -0
  1453. hare/gis/geometries/line_string.py +46 -0
  1454. hare/gis/geometries/multi_geometry.py +75 -0
  1455. hare/gis/geometries/point.py +65 -0
  1456. hare/gis/geometries/polygon.py +91 -0
  1457. hare/gis/geometry_arguments.py +60 -0
  1458. hare/gis/lookups/__init__.py +3 -0
  1459. hare/gis/lookups/spatial_field_lookups.py +220 -0
  1460. hare/gis/readers/__init__.py +11 -0
  1461. hare/gis/readers/constants.py +31 -0
  1462. hare/gis/readers/ewkb_reader.py +148 -0
  1463. hare/gis/readers/geo_json_reader.py +53 -0
  1464. hare/gis/readers/wkt_reader.py +212 -0
  1465. hare/gis/spatial_distances.py +17 -0
  1466. hare/gis/spatial_features.py +33 -0
  1467. hare/gis/terms/__init__.py +11 -0
  1468. hare/gis/terms/geometry_value.py +47 -0
  1469. hare/gis/terms/spatial_aggregate_function.py +30 -0
  1470. hare/gis/terms/spatial_function_term.py +39 -0
  1471. hare/gis/terms/spatial_relation_term.py +39 -0
  1472. hare/health/__init__.py +19 -0
  1473. hare/health/constants.py +29 -0
  1474. hare/health/criteria/__init__.py +27 -0
  1475. hare/health/criteria/acquire_wait_time.py +41 -0
  1476. hare/health/criteria/all_of.py +33 -0
  1477. hare/health/criteria/declarations.py +33 -0
  1478. hare/health/criteria/health_criterion.py +46 -0
  1479. hare/health/criteria/ping_failed.py +27 -0
  1480. hare/health/criteria/ping_latency.py +29 -0
  1481. hare/health/criteria/pool_count_criterion.py +37 -0
  1482. hare/health/criteria/pool_saturation.py +35 -0
  1483. hare/health/criteria/waiting_requests.py +33 -0
  1484. hare/health/declarations.py +85 -0
  1485. hare/health/enums.py +14 -0
  1486. hare/health/health_check.py +233 -0
  1487. hare/health/health_report.py +65 -0
  1488. hare/inspectdb/__init__.py +38 -0
  1489. hare/inspectdb/constants.py +104 -0
  1490. hare/inspectdb/enums.py +16 -0
  1491. hare/inspectdb/exceptions.py +72 -0
  1492. hare/inspectdb/generation/__init__.py +1 -0
  1493. hare/inspectdb/generation/catalog_diagnostic_comments.py +15 -0
  1494. hare/inspectdb/generation/declarations.py +45 -0
  1495. hare/inspectdb/generation/inspected_column_defaults.py +75 -0
  1496. hare/inspectdb/generation/inspected_field_rules.py +86 -0
  1497. hare/inspectdb/generation/inspected_model.py +35 -0
  1498. hare/inspectdb/generation/inspected_model_builder.py +1174 -0
  1499. hare/inspectdb/generation/inspected_models.py +180 -0
  1500. hare/inspectdb/generation/many_to_many_tables.py +222 -0
  1501. hare/inspectdb/generation/model_factory.py +107 -0
  1502. hare/inspectdb/generation/model_naming.py +91 -0
  1503. hare/inspectdb/generation/model_source_builder.py +130 -0
  1504. hare/inspectdb/introspection/__init__.py +28 -0
  1505. hare/inspectdb/introspection/catalog_diagnostic.py +18 -0
  1506. hare/inspectdb/introspection/catalog_identities.py +123 -0
  1507. hare/inspectdb/introspection/catalog_snapshot.py +49 -0
  1508. hare/inspectdb/introspection/catalog_sql.py +104 -0
  1509. hare/inspectdb/introspection/column_info.py +67 -0
  1510. hare/inspectdb/introspection/composite_foreign_key_info.py +27 -0
  1511. hare/inspectdb/introspection/constants.py +8 -0
  1512. hare/inspectdb/introspection/database_catalog.py +263 -0
  1513. hare/inspectdb/introspection/foreign_key_info.py +25 -0
  1514. hare/inspectdb/introspection/index_info.py +267 -0
  1515. hare/inspectdb/introspection/inspected_field_specification.py +48 -0
  1516. hare/inspectdb/introspection/schema_introspector.py +531 -0
  1517. hare/inspectdb/introspection/schema_part.py +83 -0
  1518. hare/inspectdb/introspection/table_info.py +103 -0
  1519. hare/inspectdb/introspection/table_parts.py +132 -0
  1520. hare/inspectdb/messages.py +38 -0
  1521. hare/inspectdb/schema_inspector.py +330 -0
  1522. hare/instrumentation/__init__.py +31 -0
  1523. hare/instrumentation/capture/__init__.py +9 -0
  1524. hare/instrumentation/capture/capture_needs.py +54 -0
  1525. hare/instrumentation/capture/captured_change.py +38 -0
  1526. hare/instrumentation/capture/captured_write.py +227 -0
  1527. hare/instrumentation/capture/change_capturing.py +519 -0
  1528. hare/instrumentation/capture/change_sink.py +76 -0
  1529. hare/instrumentation/change_events.py +258 -0
  1530. hare/instrumentation/constants.py +32 -0
  1531. hare/instrumentation/declarations.py +198 -0
  1532. hare/instrumentation/enums.py +35 -0
  1533. hare/instrumentation/observers/__init__.py +1 -0
  1534. hare/instrumentation/observers/observer.py +70 -0
  1535. hare/instrumentation/observers/observer_dispatcher.py +212 -0
  1536. hare/instrumentation/observers/observer_set.py +219 -0
  1537. hare/instrumentation/observers/observers.py +379 -0
  1538. hare/instrumentation/pools/__init__.py +1 -0
  1539. hare/instrumentation/pools/declarations.py +17 -0
  1540. hare/instrumentation/pools/duration_records.py +49 -0
  1541. hare/instrumentation/pools/enums.py +8 -0
  1542. hare/instrumentation/pools/messages.py +1 -0
  1543. hare/instrumentation/pools/pool_metrics.py +50 -0
  1544. hare/instrumentation/pools/pool_metrics_recorder.py +93 -0
  1545. hare/instrumentation/pools/pool_registry.py +65 -0
  1546. hare/instrumentation/pools/sample_window.py +32 -0
  1547. hare/instrumentation/queries/__init__.py +1 -0
  1548. hare/instrumentation/queries/query_tags.py +93 -0
  1549. hare/instrumentation/queries/query_wrapper.py +37 -0
  1550. hare/lazy_loading/__init__.py +1 -0
  1551. hare/lazy_loading/lazy_pattern.py +45 -0
  1552. hare/lazy_loading/pydantic_classes.py +96 -0
  1553. hare/migrations/__init__.py +90 -0
  1554. hare/migrations/api/__init__.py +28 -0
  1555. hare/migrations/api/checkmigrations.py +40 -0
  1556. hare/migrations/api/makemigrations.py +76 -0
  1557. hare/migrations/api/migrate.py +38 -0
  1558. hare/migrations/api/migration_request_parser.py +52 -0
  1559. hare/migrations/api/migration_session.py +138 -0
  1560. hare/migrations/api/plan.py +19 -0
  1561. hare/migrations/api/sqlmigrate.py +31 -0
  1562. hare/migrations/api/squashmigrations.py +49 -0
  1563. hare/migrations/autodetection/__init__.py +4 -0
  1564. hare/migrations/autodetection/constants.py +49 -0
  1565. hare/migrations/autodetection/cross_app_view_changes.py +296 -0
  1566. hare/migrations/autodetection/diffs/__init__.py +1 -0
  1567. hare/migrations/autodetection/diffs/constraint_diff.py +47 -0
  1568. hare/migrations/autodetection/diffs/declarations.py +71 -0
  1569. hare/migrations/autodetection/diffs/declared_schema_object_diff.py +47 -0
  1570. hare/migrations/autodetection/diffs/grant_diff.py +24 -0
  1571. hare/migrations/autodetection/diffs/index_diff.py +61 -0
  1572. hare/migrations/autodetection/diffs/materialized_view_diff.py +35 -0
  1573. hare/migrations/autodetection/diffs/partition_diff.py +107 -0
  1574. hare/migrations/autodetection/diffs/policy_diff.py +46 -0
  1575. hare/migrations/autodetection/diffs/schema_object_comparison.py +47 -0
  1576. hare/migrations/autodetection/diffs/schema_object_diff.py +197 -0
  1577. hare/migrations/autodetection/diffs/state_field_diff.py +616 -0
  1578. hare/migrations/autodetection/diffs/state_model_diff.py +508 -0
  1579. hare/migrations/autodetection/diffs/trigger_diff.py +49 -0
  1580. hare/migrations/autodetection/diffs/view_diff.py +21 -0
  1581. hare/migrations/autodetection/field_comparable_values.py +20 -0
  1582. hare/migrations/autodetection/migration_autodetector.py +342 -0
  1583. hare/migrations/autodetection/migration_splitter.py +157 -0
  1584. hare/migrations/autodetection/native_prerequisites.py +65 -0
  1585. hare/migrations/autodetection/operation_generator.py +1330 -0
  1586. hare/migrations/autodetection/operation_sorter.py +308 -0
  1587. hare/migrations/autodetection/rename_questions.py +138 -0
  1588. hare/migrations/autodetection/schema_object_operations.py +214 -0
  1589. hare/migrations/autodetection/split_migration.py +24 -0
  1590. hare/migrations/autodetection/state_signatures.py +156 -0
  1591. hare/migrations/constants.py +110 -0
  1592. hare/migrations/drift/__init__.py +15 -0
  1593. hare/migrations/drift/column_mismatch.py +14 -0
  1594. hare/migrations/drift/constants.py +69 -0
  1595. hare/migrations/drift/detect_drift.py +40 -0
  1596. hare/migrations/drift/detect_drift_for_alias.py +92 -0
  1597. hare/migrations/drift/drift_result.py +36 -0
  1598. hare/migrations/drift/messages.py +16 -0
  1599. hare/migrations/drift/object_mismatch.py +13 -0
  1600. hare/migrations/drift/shadow/__init__.py +0 -0
  1601. hare/migrations/drift/shadow/column_field_names.py +30 -0
  1602. hare/migrations/drift/shadow/observed_table.py +91 -0
  1603. hare/migrations/drift/shadow/schema_comparison.py +893 -0
  1604. hare/migrations/drift/shadow/shadow_drift.py +390 -0
  1605. hare/migrations/drift/shadow/shadow_state.py +90 -0
  1606. hare/migrations/exceptions.py +69 -0
  1607. hare/migrations/execution/__init__.py +3 -0
  1608. hare/migrations/execution/connection_migration_plan.py +13 -0
  1609. hare/migrations/execution/connections_plan.py +207 -0
  1610. hare/migrations/execution/constants.py +4 -0
  1611. hare/migrations/execution/executor/__init__.py +11 -0
  1612. hare/migrations/execution/executor/migration_executor.py +678 -0
  1613. hare/migrations/execution/executor/migration_target.py +9 -0
  1614. hare/migrations/execution/executor/plan_step.py +26 -0
  1615. hare/migrations/execution/migration_runner.py +350 -0
  1616. hare/migrations/execution/prepared_operation_execution.py +205 -0
  1617. hare/migrations/execution/swappable_setting_check.py +236 -0
  1618. hare/migrations/loading/__init__.py +4 -0
  1619. hare/migrations/loading/graph/__init__.py +13 -0
  1620. hare/migrations/loading/graph/dummy_node.py +22 -0
  1621. hare/migrations/loading/graph/migration_graph.py +266 -0
  1622. hare/migrations/loading/graph/migration_key.py +14 -0
  1623. hare/migrations/loading/graph/node.py +43 -0
  1624. hare/migrations/loading/migration_definitions.py +54 -0
  1625. hare/migrations/loading/migration_loader.py +332 -0
  1626. hare/migrations/loading/migrations_modules.py +246 -0
  1627. hare/migrations/loading/recorder/__init__.py +9 -0
  1628. hare/migrations/loading/recorder/migration_recorder.py +136 -0
  1629. hare/migrations/loading/recorder/noop_recorder.py +25 -0
  1630. hare/migrations/making/__init__.py +1 -0
  1631. hare/migrations/making/declared_attribute_values.py +27 -0
  1632. hare/migrations/making/migration_changes.py +27 -0
  1633. hare/migrations/making/migration_checks.py +117 -0
  1634. hare/migrations/making/migration_maker.py +293 -0
  1635. hare/migrations/making/migration_optimizer.py +75 -0
  1636. hare/migrations/making/migration_squasher.py +193 -0
  1637. hare/migrations/making/squashed_migration.py +24 -0
  1638. hare/migrations/messages.py +10 -0
  1639. hare/migrations/migration.py +161 -0
  1640. hare/migrations/operations/__init__.py +135 -0
  1641. hare/migrations/operations/columns/__init__.py +11 -0
  1642. hare/migrations/operations/columns/alter_column_not_null_safe.py +158 -0
  1643. hare/migrations/operations/columns/backfill_column.py +136 -0
  1644. hare/migrations/operations/constants.py +10 -0
  1645. hare/migrations/operations/constraints/__init__.py +15 -0
  1646. hare/migrations/operations/constraints/add_constraint.py +140 -0
  1647. hare/migrations/operations/constraints/declarations.py +13 -0
  1648. hare/migrations/operations/constraints/rename_constraint.py +21 -0
  1649. hare/migrations/operations/constraints/validate_constraint.py +60 -0
  1650. hare/migrations/operations/database_functions/__init__.py +10 -0
  1651. hare/migrations/operations/database_functions/add_function.py +28 -0
  1652. hare/migrations/operations/database_functions/alter_function.py +30 -0
  1653. hare/migrations/operations/database_functions/remove_function.py +20 -0
  1654. hare/migrations/operations/database_functions/rename_function.py +21 -0
  1655. hare/migrations/operations/declared_uniqueness_checks.py +74 -0
  1656. hare/migrations/operations/dependencies/__init__.py +1 -0
  1657. hare/migrations/operations/dependencies/constants.py +9 -0
  1658. hare/migrations/operations/dependencies/native_dependencies.py +42 -0
  1659. hare/migrations/operations/dependencies/operation_dependency.py +105 -0
  1660. hare/migrations/operations/dependencies/prepared_operation_graph.py +197 -0
  1661. hare/migrations/operations/dependencies/relation_dependencies.py +235 -0
  1662. hare/migrations/operations/dictionaries/__init__.py +10 -0
  1663. hare/migrations/operations/dictionaries/add_dictionary.py +28 -0
  1664. hare/migrations/operations/dictionaries/alter_dictionary.py +29 -0
  1665. hare/migrations/operations/dictionaries/remove_dictionary.py +20 -0
  1666. hare/migrations/operations/dictionaries/rename_dictionary.py +21 -0
  1667. hare/migrations/operations/enum_types/__init__.py +7 -0
  1668. hare/migrations/operations/enum_types/alter_enum_type.py +77 -0
  1669. hare/migrations/operations/enum_types/create_enum_type.py +53 -0
  1670. hare/migrations/operations/enum_types/drop_enum_type.py +68 -0
  1671. hare/migrations/operations/enum_types/enum_type_operation.py +109 -0
  1672. hare/migrations/operations/enums.py +24 -0
  1673. hare/migrations/operations/extensions/__init__.py +15 -0
  1674. hare/migrations/operations/extensions/create_collation.py +82 -0
  1675. hare/migrations/operations/extensions/create_extension.py +48 -0
  1676. hare/migrations/operations/extensions/remove_collation.py +35 -0
  1677. hare/migrations/operations/extensions/remove_extension.py +49 -0
  1678. hare/migrations/operations/fields/__init__.py +11 -0
  1679. hare/migrations/operations/fields/add_field.py +131 -0
  1680. hare/migrations/operations/fields/alter_field.py +134 -0
  1681. hare/migrations/operations/fields/field_add_remove_operation.py +45 -0
  1682. hare/migrations/operations/fields/field_like.py +14 -0
  1683. hare/migrations/operations/fields/remove_field.py +358 -0
  1684. hare/migrations/operations/fields/rename_field.py +779 -0
  1685. hare/migrations/operations/grants/__init__.py +8 -0
  1686. hare/migrations/operations/grants/add_grant.py +31 -0
  1687. hare/migrations/operations/grants/remove_grant.py +35 -0
  1688. hare/migrations/operations/hare_operation.py +164 -0
  1689. hare/migrations/operations/indexes/__init__.py +13 -0
  1690. hare/migrations/operations/indexes/add_index.py +42 -0
  1691. hare/migrations/operations/indexes/declarations.py +12 -0
  1692. hare/migrations/operations/indexes/remove_index.py +73 -0
  1693. hare/migrations/operations/materialized_views/__init__.py +17 -0
  1694. hare/migrations/operations/materialized_views/add_materialized_view.py +37 -0
  1695. hare/migrations/operations/materialized_views/alter_materialized_view.py +32 -0
  1696. hare/migrations/operations/materialized_views/refresh_materialized_view.py +66 -0
  1697. hare/migrations/operations/materialized_views/remove_materialized_view.py +40 -0
  1698. hare/migrations/operations/materialized_views/rename_materialized_view.py +23 -0
  1699. hare/migrations/operations/model_bound_operation.py +94 -0
  1700. hare/migrations/operations/models/__init__.py +12 -0
  1701. hare/migrations/operations/models/alter_model_options.py +176 -0
  1702. hare/migrations/operations/models/alter_model_schema.py +146 -0
  1703. hare/migrations/operations/models/alter_model_table.py +61 -0
  1704. hare/migrations/operations/models/create_model.py +369 -0
  1705. hare/migrations/operations/models/delete_model.py +115 -0
  1706. hare/migrations/operations/models/model_table_operation.py +50 -0
  1707. hare/migrations/operations/models/rename_model.py +160 -0
  1708. hare/migrations/operations/models/table_renaming_operation.py +121 -0
  1709. hare/migrations/operations/operation.py +269 -0
  1710. hare/migrations/operations/operation_rewrite.py +19 -0
  1711. hare/migrations/operations/partitions/__init__.py +13 -0
  1712. hare/migrations/operations/partitions/add_partition.py +36 -0
  1713. hare/migrations/operations/partitions/partition_operation.py +103 -0
  1714. hare/migrations/operations/partitions/remove_partition.py +42 -0
  1715. hare/migrations/operations/partitions/rename_partition.py +45 -0
  1716. hare/migrations/operations/policies/__init__.py +11 -0
  1717. hare/migrations/operations/policies/add_policy.py +28 -0
  1718. hare/migrations/operations/policies/alter_policy.py +30 -0
  1719. hare/migrations/operations/policies/alter_row_level_security.py +99 -0
  1720. hare/migrations/operations/policies/remove_policy.py +21 -0
  1721. hare/migrations/operations/policies/rename_policy.py +21 -0
  1722. hare/migrations/operations/schema_objects/__init__.py +11 -0
  1723. hare/migrations/operations/schema_objects/add_schema_object.py +119 -0
  1724. hare/migrations/operations/schema_objects/alter_schema_object.py +93 -0
  1725. hare/migrations/operations/schema_objects/object_types/__init__.py +1 -0
  1726. hare/migrations/operations/schema_objects/object_types/constraint_object_type.py +96 -0
  1727. hare/migrations/operations/schema_objects/object_types/dictionary_object_type.py +46 -0
  1728. hare/migrations/operations/schema_objects/object_types/function_object_type.py +51 -0
  1729. hare/migrations/operations/schema_objects/object_types/grant_object_type.py +76 -0
  1730. hare/migrations/operations/schema_objects/object_types/index_object_type.py +145 -0
  1731. hare/migrations/operations/schema_objects/object_types/materialized_view_object_type.py +53 -0
  1732. hare/migrations/operations/schema_objects/object_types/policy_object_type.py +48 -0
  1733. hare/migrations/operations/schema_objects/object_types/schema_object_type.py +244 -0
  1734. hare/migrations/operations/schema_objects/object_types/sequence_object_type.py +50 -0
  1735. hare/migrations/operations/schema_objects/object_types/trigger_object_type.py +46 -0
  1736. hare/migrations/operations/schema_objects/object_types/view_object_type.py +59 -0
  1737. hare/migrations/operations/schema_objects/remove_schema_object.py +110 -0
  1738. hare/migrations/operations/schema_objects/rename_schema_object.py +121 -0
  1739. hare/migrations/operations/schemas/__init__.py +11 -0
  1740. hare/migrations/operations/schemas/create_schema.py +46 -0
  1741. hare/migrations/operations/schemas/drop_schema.py +49 -0
  1742. hare/migrations/operations/sequences/__init__.py +10 -0
  1743. hare/migrations/operations/sequences/add_sequence.py +28 -0
  1744. hare/migrations/operations/sequences/alter_sequence.py +46 -0
  1745. hare/migrations/operations/sequences/remove_sequence.py +29 -0
  1746. hare/migrations/operations/sequences/rename_sequence.py +21 -0
  1747. hare/migrations/operations/special/__init__.py +16 -0
  1748. hare/migrations/operations/special/app_operation.py +92 -0
  1749. hare/migrations/operations/special/run_python.py +88 -0
  1750. hare/migrations/operations/special/run_sql.py +100 -0
  1751. hare/migrations/operations/special/separate_database_and_state.py +98 -0
  1752. hare/migrations/operations/special/synchronize_key_series.py +43 -0
  1753. hare/migrations/operations/triggers/__init__.py +15 -0
  1754. hare/migrations/operations/triggers/add_trigger.py +28 -0
  1755. hare/migrations/operations/triggers/alter_trigger.py +28 -0
  1756. hare/migrations/operations/triggers/remove_trigger.py +20 -0
  1757. hare/migrations/operations/triggers/rename_trigger.py +21 -0
  1758. hare/migrations/operations/views/__init__.py +10 -0
  1759. hare/migrations/operations/views/add_view.py +29 -0
  1760. hare/migrations/operations/views/alter_view.py +29 -0
  1761. hare/migrations/operations/views/remove_view.py +20 -0
  1762. hare/migrations/operations/views/rename_view.py +21 -0
  1763. hare/migrations/reports/__init__.py +12 -0
  1764. hare/migrations/reports/operation_effect.py +28 -0
  1765. hare/migrations/reports/operation_plan.py +23 -0
  1766. hare/migrations/safety/__init__.py +16 -0
  1767. hare/migrations/safety/declarations.py +12 -0
  1768. hare/migrations/safety/enums.py +39 -0
  1769. hare/migrations/safety/migration_risk.py +33 -0
  1770. hare/migrations/safety/migration_safety_checker.py +165 -0
  1771. hare/migrations/safety/migration_safety_context.py +192 -0
  1772. hare/migrations/safety/migration_table_rows.py +125 -0
  1773. hare/migrations/state/__init__.py +11 -0
  1774. hare/migrations/state/migration_environment.py +152 -0
  1775. hare/migrations/state/model_state.py +499 -0
  1776. hare/migrations/state/model_state_map.py +48 -0
  1777. hare/migrations/state/prepared_operation.py +33 -0
  1778. hare/migrations/state/prepared_operation_states.py +66 -0
  1779. hare/migrations/state/state.py +322 -0
  1780. hare/migrations/state/state_apps.py +270 -0
  1781. hare/migrations/state/state_rendering.py +71 -0
  1782. hare/migrations/state/state_snapshot.py +30 -0
  1783. hare/migrations/state/state_values.py +54 -0
  1784. hare/migrations/swappable_dependency.py +44 -0
  1785. hare/migrations/writer/__init__.py +7 -0
  1786. hare/migrations/writer/constants.py +26 -0
  1787. hare/migrations/writer/migration_writer.py +238 -0
  1788. hare/models/__init__.py +20 -0
  1789. hare/models/class_building/__init__.py +1 -0
  1790. hare/models/class_building/abstract_meta_inheritance.py +137 -0
  1791. hare/models/class_building/blind_indexes.py +54 -0
  1792. hare/models/class_building/constants.py +44 -0
  1793. hare/models/class_building/extension_model_options.py +23 -0
  1794. hare/models/class_building/field_comments.py +129 -0
  1795. hare/models/class_building/generic_foreign_keys.py +346 -0
  1796. hare/models/class_building/generic_schema_binding.py +16 -0
  1797. hare/models/class_building/lazy_relation_fields.py +108 -0
  1798. hare/models/class_building/model_definition_checks.py +753 -0
  1799. hare/models/class_building/model_field_collection.py +196 -0
  1800. hare/models/class_building/model_managers.py +54 -0
  1801. hare/models/class_building/model_options.py +80 -0
  1802. hare/models/class_building/primary_key_declaration.py +205 -0
  1803. hare/models/class_building/schema_object_declarations.py +106 -0
  1804. hare/models/constants.py +99 -0
  1805. hare/models/deletion/__init__.py +0 -0
  1806. hare/models/deletion/cascade/__init__.py +1 -0
  1807. hare/models/deletion/cascade/cascade_deletion.py +841 -0
  1808. hare/models/deletion/cascade/cascade_policy.py +189 -0
  1809. hare/models/deletion/cascade/cascade_restore.py +167 -0
  1810. hare/models/deletion/cascade/declarations.py +55 -0
  1811. hare/models/deletion/cascade/deletion_collector.py +661 -0
  1812. hare/models/deletion/cascade/deletion_graph.py +511 -0
  1813. hare/models/deletion/cascade/deletion_plan.py +82 -0
  1814. hare/models/deletion/cascade/deletion_scope.py +63 -0
  1815. hare/models/deletion/cascade/prepared_deletion.py +171 -0
  1816. hare/models/deletion/cascade/protect_constraint_deferral.py +91 -0
  1817. hare/models/deletion/cascade/related_rows.py +466 -0
  1818. hare/models/deletion/cascade/tenant_schema_visits.py +105 -0
  1819. hare/models/deletion/constants.py +31 -0
  1820. hare/models/deletion/deletion_routes.py +59 -0
  1821. hare/models/deletion/enums.py +22 -0
  1822. hare/models/deletion/instance_deletion.py +293 -0
  1823. hare/models/deletion/preview/__init__.py +1 -0
  1824. hare/models/deletion/preview/delete_preview.py +105 -0
  1825. hare/models/deletion/preview/delete_preview_builder.py +322 -0
  1826. hare/models/deletion/soft_deletion.py +197 -0
  1827. hare/models/enums.py +65 -0
  1828. hare/models/instances/__init__.py +1 -0
  1829. hare/models/instances/dirty_fields.py +122 -0
  1830. hare/models/instances/field_snapshot.py +133 -0
  1831. hare/models/instances/instance_attachment.py +68 -0
  1832. hare/models/instances/instance_connections.py +60 -0
  1833. hare/models/instances/instance_copies.py +191 -0
  1834. hare/models/instances/instance_initialization.py +521 -0
  1835. hare/models/instances/instance_origins.py +22 -0
  1836. hare/models/instances/instance_refresh.py +219 -0
  1837. hare/models/instances/instance_saving.py +407 -0
  1838. hare/models/model.py +904 -0
  1839. hare/models/model_binding.py +1148 -0
  1840. hare/models/model_declaration.py +99 -0
  1841. hare/models/model_meta.py +195 -0
  1842. hare/models/tenancy/__init__.py +1 -0
  1843. hare/models/tenancy/constants.py +16 -0
  1844. hare/models/tenancy/tenancy.py +442 -0
  1845. hare/models/tenancy/tenant_connection_checks.py +57 -0
  1846. hare/models/tenancy/tenant_row_level_security.py +116 -0
  1847. hare/models/tenancy/tenant_schemas.py +240 -0
  1848. hare/models/tenancy/update_relation_tenants.py +141 -0
  1849. hare/models/uniqueness/__init__.py +0 -0
  1850. hare/models/uniqueness/declared_uniqueness.py +94 -0
  1851. hare/models/write/__init__.py +3 -0
  1852. hare/models/write/bound_rows.py +39 -0
  1853. hare/models/write/declarations.py +76 -0
  1854. hare/models/write/generated_keys.py +73 -0
  1855. hare/models/write/insert/__init__.py +1 -0
  1856. hare/models/write/insert/insert_conflict.py +87 -0
  1857. hare/models/write/insert/insert_statement.py +155 -0
  1858. hare/models/write/instance_capture.py +191 -0
  1859. hare/models/write/instance_snapshot.py +127 -0
  1860. hare/models/write/instance_update_guard.py +48 -0
  1861. hare/models/write/instance_update_guard_mismatch.py +5 -0
  1862. hare/models/write/instance_values.py +145 -0
  1863. hare/models/write/instance_writer.py +954 -0
  1864. hare/models/write/returned_values.py +395 -0
  1865. hare/models/write/rollback_restores.py +166 -0
  1866. hare/models/write/rules/__init__.py +2 -0
  1867. hare/models/write/rules/constants.py +67 -0
  1868. hare/models/write/rules/enums.py +18 -0
  1869. hare/models/write/rules/relation_key_values.py +52 -0
  1870. hare/models/write/rules/row_write_rules.py +625 -0
  1871. hare/models/write/rules/tenant_write_rules.py +306 -0
  1872. hare/models/write/rules/written_instances.py +51 -0
  1873. hare/models/write/rules/written_target_checks.py +79 -0
  1874. hare/models/write/update/__init__.py +1 -0
  1875. hare/models/write/update/expression_assignment.py +211 -0
  1876. hare/models/write/update/update_parameter_slot.py +43 -0
  1877. hare/models/write/write_finalizer.py +117 -0
  1878. hare/models/write/write_steps.py +104 -0
  1879. hare/native/__init__.py +1 -0
  1880. hare/native/native_modules.py +14 -0
  1881. hare/numbers/__init__.py +1 -0
  1882. hare/numbers/finite_numbers.py +27 -0
  1883. hare/py.typed +0 -0
  1884. hare/query/__init__.py +0 -0
  1885. hare/query/constants.py +54 -0
  1886. hare/query/enums.py +125 -0
  1887. hare/query/execution/__init__.py +0 -0
  1888. hare/query/execution/bound_query.py +161 -0
  1889. hare/query/execution/bound_write.py +67 -0
  1890. hare/query/execution/dependent_condition.py +56 -0
  1891. hare/query/execution/messages.py +13 -0
  1892. hare/query/execution/prepared_write.py +40 -0
  1893. hare/query/execution/query_dependency.py +20 -0
  1894. hare/query/execution/query_execution.py +305 -0
  1895. hare/query/execution/write_statements.py +70 -0
  1896. hare/query/expressions/__init__.py +65 -0
  1897. hare/query/expressions/aggregate.py +398 -0
  1898. hare/query/expressions/aggregate_paths/__init__.py +9 -0
  1899. hare/query/expressions/aggregate_paths/aggregate_crossing.py +20 -0
  1900. hare/query/expressions/aggregate_paths/aggregated_multi_valued_paths.py +593 -0
  1901. hare/query/expressions/aggregate_paths/constants.py +10 -0
  1902. hare/query/expressions/arithmetic/__init__.py +1 -0
  1903. hare/query/expressions/arithmetic/arithmetic_operators.py +57 -0
  1904. hare/query/expressions/arithmetic/combinable_expression.py +47 -0
  1905. hare/query/expressions/arithmetic/combined_expression.py +614 -0
  1906. hare/query/expressions/arithmetic/constants.py +19 -0
  1907. hare/query/expressions/bound_expression.py +103 -0
  1908. hare/query/expressions/case/__init__.py +1 -0
  1909. hare/query/expressions/case/case.py +241 -0
  1910. hare/query/expressions/case/when.py +118 -0
  1911. hare/query/expressions/compatibility/__init__.py +9 -0
  1912. hare/query/expressions/compatibility/constants.py +104 -0
  1913. hare/query/expressions/compatibility/output_field_compatibility.py +243 -0
  1914. hare/query/expressions/compatibility/result_branch.py +46 -0
  1915. hare/query/expressions/conditions/__init__.py +1 -0
  1916. hare/query/expressions/conditions/condition_value.py +61 -0
  1917. hare/query/expressions/conditions/q.py +544 -0
  1918. hare/query/expressions/conditions/query_modifier.py +118 -0
  1919. hare/query/expressions/constants.py +126 -0
  1920. hare/query/expressions/declarations.py +12 -0
  1921. hare/query/expressions/dialect_expressions.py +116 -0
  1922. hare/query/expressions/enums.py +41 -0
  1923. hare/query/expressions/expression.py +138 -0
  1924. hare/query/expressions/expression_context.py +90 -0
  1925. hare/query/expressions/expression_result.py +41 -0
  1926. hare/query/expressions/f.py +240 -0
  1927. hare/query/expressions/frames/__init__.py +12 -0
  1928. hare/query/expressions/frames/constants.py +14 -0
  1929. hare/query/expressions/frames/declarations.py +22 -0
  1930. hare/query/expressions/frames/window_frame.py +126 -0
  1931. hare/query/expressions/function.py +564 -0
  1932. hare/query/expressions/joins/__init__.py +1 -0
  1933. hare/query/expressions/joins/array_join.py +145 -0
  1934. hare/query/expressions/joins/array_join_element.py +27 -0
  1935. hare/query/expressions/joins/asof_join.py +281 -0
  1936. hare/query/expressions/joins/filtered_relation.py +307 -0
  1937. hare/query/expressions/joins/json_table.py +151 -0
  1938. hare/query/expressions/joins/json_table_column.py +21 -0
  1939. hare/query/expressions/joins/lateral.py +91 -0
  1940. hare/query/expressions/joins/merge_source_row.py +44 -0
  1941. hare/query/expressions/joins/named_columns.py +37 -0
  1942. hare/query/expressions/joins/named_join.py +221 -0
  1943. hare/query/expressions/numeric/__init__.py +11 -0
  1944. hare/query/expressions/numeric/numeric_type.py +18 -0
  1945. hare/query/expressions/numeric/numeric_typing.py +309 -0
  1946. hare/query/expressions/numeric/unrounded_decimal_field.py +16 -0
  1947. hare/query/expressions/ordering.py +110 -0
  1948. hare/query/expressions/raw_sql.py +168 -0
  1949. hare/query/expressions/structure/__init__.py +0 -0
  1950. hare/query/expressions/structure/declarations.py +20 -0
  1951. hare/query/expressions/structure/enums.py +12 -0
  1952. hare/query/expressions/structure/expression_declaration.py +58 -0
  1953. hare/query/expressions/structure/expression_structure.py +55 -0
  1954. hare/query/expressions/structure/expression_traversal.py +175 -0
  1955. hare/query/expressions/structure/messages.py +1 -0
  1956. hare/query/expressions/subqueries/__init__.py +1 -0
  1957. hare/query/expressions/subqueries/cte_rows.py +44 -0
  1958. hare/query/expressions/subqueries/declarations.py +8 -0
  1959. hare/query/expressions/subqueries/exists.py +198 -0
  1960. hare/query/expressions/subqueries/outer_reference.py +163 -0
  1961. hare/query/expressions/subqueries/outer_scope.py +74 -0
  1962. hare/query/expressions/subqueries/recursive_rows.py +187 -0
  1963. hare/query/expressions/subqueries/subquery.py +260 -0
  1964. hare/query/expressions/temporal/__init__.py +9 -0
  1965. hare/query/expressions/temporal/constants.py +52 -0
  1966. hare/query/expressions/temporal/temporal_arithmetic.py +246 -0
  1967. hare/query/expressions/temporal/temporal_operand.py +25 -0
  1968. hare/query/expressions/term_expression.py +28 -0
  1969. hare/query/expressions/value.py +281 -0
  1970. hare/query/expressions/value_references/__init__.py +43 -0
  1971. hare/query/expressions/value_references/composite_key_value_reference.py +60 -0
  1972. hare/query/expressions/value_references/container_value_reference.py +32 -0
  1973. hare/query/expressions/value_references/encoded_value_reference.py +52 -0
  1974. hare/query/expressions/value_references/expression_arguments.py +159 -0
  1975. hare/query/expressions/value_references/like_value_reference.py +48 -0
  1976. hare/query/expressions/value_references/list_parameter_value_reference.py +54 -0
  1977. hare/query/expressions/value_references/list_value_reference.py +56 -0
  1978. hare/query/expressions/value_references/literal_value_reference.py +41 -0
  1979. hare/query/expressions/value_references/open_range_value_reference.py +58 -0
  1980. hare/query/expressions/value_references/range_value_reference.py +55 -0
  1981. hare/query/expressions/value_references/related_key_value_reference.py +81 -0
  1982. hare/query/expressions/value_references/related_value_reference.py +35 -0
  1983. hare/query/expressions/value_references/row_list_value_reference.py +71 -0
  1984. hare/query/expressions/value_references/scalar_value_reference.py +50 -0
  1985. hare/query/expressions/value_references/value_reference_types.py +55 -0
  1986. hare/query/expressions/value_references/write_value_reference.py +50 -0
  1987. hare/query/expressions/window.py +222 -0
  1988. hare/query/filters/__init__.py +21 -0
  1989. hare/query/filters/constants.py +94 -0
  1990. hare/query/filters/lookups/__init__.py +1 -0
  1991. hare/query/filters/lookups/annotation_container_lookups.py +40 -0
  1992. hare/query/filters/lookups/constants.py +60 -0
  1993. hare/query/filters/lookups/containers/__init__.py +3 -0
  1994. hare/query/filters/lookups/containers/container_field_lookups.py +71 -0
  1995. hare/query/filters/lookups/containers/container_lookups.py +78 -0
  1996. hare/query/filters/lookups/containers/container_value_encoders.py +92 -0
  1997. hare/query/filters/lookups/date_part_lookups.py +291 -0
  1998. hare/query/filters/lookups/dialect_implemented_operators.py +39 -0
  1999. hare/query/filters/lookups/field_lookup.py +74 -0
  2000. hare/query/filters/lookups/field_lookups.py +272 -0
  2001. hare/query/filters/lookups/field_transforms.py +103 -0
  2002. hare/query/filters/lookups/json/__init__.py +1 -0
  2003. hare/query/filters/lookups/json/json_filter_guards.py +393 -0
  2004. hare/query/filters/lookups/json/json_filter_parser.py +92 -0
  2005. hare/query/filters/lookups/json/json_lookups.py +67 -0
  2006. hare/query/filters/lookups/json/json_path_lookups.py +181 -0
  2007. hare/query/filters/lookups/lookups.py +387 -0
  2008. hare/query/filters/lookups/value_encoders.py +240 -0
  2009. hare/query/filters/resolution/__init__.py +1 -0
  2010. hare/query/filters/resolution/annotation_filters.py +314 -0
  2011. hare/query/filters/resolution/composite_key_filters.py +453 -0
  2012. hare/query/filters/resolution/filter_kwargs.py +695 -0
  2013. hare/query/filters/resolution/filter_values.py +601 -0
  2014. hare/query/filters/resolution/json_path_filters.py +230 -0
  2015. hare/query/filters/resolution/lookup_support.py +83 -0
  2016. hare/query/filters/resolution/relation_filters.py +511 -0
  2017. hare/query/filters/resolution/sensitive_filter_keys.py +108 -0
  2018. hare/query/filters/resolution/to_many_filters.py +432 -0
  2019. hare/query/functions/__init__.py +185 -0
  2020. hare/query/functions/aggregates/__init__.py +9 -0
  2021. hare/query/functions/aggregates/array_agg.py +48 -0
  2022. hare/query/functions/aggregates/avg.py +19 -0
  2023. hare/query/functions/aggregates/constants.py +5 -0
  2024. hare/query/functions/aggregates/count.py +100 -0
  2025. hare/query/functions/aggregates/declarations.py +51 -0
  2026. hare/query/functions/aggregates/statistic_aggregate.py +52 -0
  2027. hare/query/functions/aggregates/statistic_result_aggregate.py +36 -0
  2028. hare/query/functions/aggregates/sum.py +23 -0
  2029. hare/query/functions/comparison/__init__.py +9 -0
  2030. hare/query/functions/comparison/cast.py +111 -0
  2031. hare/query/functions/comparison/coalesce.py +106 -0
  2032. hare/query/functions/comparison/collate.py +51 -0
  2033. hare/query/functions/comparison/declarations.py +21 -0
  2034. hare/query/functions/comparison/function_arguments.py +70 -0
  2035. hare/query/functions/comparison/greatest_least_function.py +125 -0
  2036. hare/query/functions/comparison/null_if.py +69 -0
  2037. hare/query/functions/containers/__init__.py +7 -0
  2038. hare/query/functions/containers/array_item.py +76 -0
  2039. hare/query/functions/datetime/__init__.py +55 -0
  2040. hare/query/functions/datetime/date_function_source.py +31 -0
  2041. hare/query/functions/datetime/declarations.py +193 -0
  2042. hare/query/functions/datetime/extract.py +97 -0
  2043. hare/query/functions/datetime/now.py +26 -0
  2044. hare/query/functions/datetime/trunc.py +125 -0
  2045. hare/query/functions/json/__init__.py +6 -0
  2046. hare/query/functions/json/json_array.py +37 -0
  2047. hare/query/functions/json/json_object.py +170 -0
  2048. hare/query/functions/math/__init__.py +53 -0
  2049. hare/query/functions/math/declarations.py +192 -0
  2050. hare/query/functions/math/enums.py +14 -0
  2051. hare/query/functions/math/math_function.py +120 -0
  2052. hare/query/functions/math/mod.py +47 -0
  2053. hare/query/functions/math/pi.py +21 -0
  2054. hare/query/functions/math/random.py +22 -0
  2055. hare/query/functions/math/round.py +75 -0
  2056. hare/query/functions/text/__init__.py +55 -0
  2057. hare/query/functions/text/concat.py +99 -0
  2058. hare/query/functions/text/declarations.py +198 -0
  2059. hare/query/functions/text/l_pad.py +17 -0
  2060. hare/query/functions/text/length.py +45 -0
  2061. hare/query/functions/text/r_pad.py +17 -0
  2062. hare/query/functions/text/replace.py +17 -0
  2063. hare/query/functions/text/text_function.py +113 -0
  2064. hare/query/functions/window/__init__.py +45 -0
  2065. hare/query/functions/window/aggregate_window_function.py +39 -0
  2066. hare/query/functions/window/avg.py +18 -0
  2067. hare/query/functions/window/constants.py +3 -0
  2068. hare/query/functions/window/count.py +57 -0
  2069. hare/query/functions/window/declarations.py +153 -0
  2070. hare/query/functions/window/distribution_window_function.py +21 -0
  2071. hare/query/functions/window/field_window_function.py +159 -0
  2072. hare/query/functions/window/n_tile.py +41 -0
  2073. hare/query/functions/window/nth_value.py +65 -0
  2074. hare/query/functions/window/offset_window_function.py +107 -0
  2075. hare/query/functions/window/rank_like_window_function.py +21 -0
  2076. hare/query/functions/window/statistic_result_window_function.py +25 -0
  2077. hare/query/functions/window/statistic_window_function.py +36 -0
  2078. hare/query/functions/window/sum.py +26 -0
  2079. hare/query/functions/window/window_function.py +139 -0
  2080. hare/query/generic_foreign_keys/__init__.py +3 -0
  2081. hare/query/generic_foreign_keys/constants.py +21 -0
  2082. hare/query/generic_foreign_keys/generic_foreign_key_filters.py +250 -0
  2083. hare/query/generic_foreign_keys/generic_foreign_key_paths.py +183 -0
  2084. hare/query/generic_foreign_keys/generic_foreign_key_types.py +131 -0
  2085. hare/query/grouping/__init__.py +14 -0
  2086. hare/query/grouping/declarations.py +21 -0
  2087. hare/query/grouping/grouping.py +78 -0
  2088. hare/query/grouping/grouping_expressions.py +41 -0
  2089. hare/query/grouping/grouping_set.py +67 -0
  2090. hare/query/grouping/grouping_sets.py +55 -0
  2091. hare/query/hare_column_names.py +73 -0
  2092. hare/query/key_columns.py +428 -0
  2093. hare/query/key_comparison.py +50 -0
  2094. hare/query/lookup_info/__init__.py +12 -0
  2095. hare/query/lookup_info/bound_lookup_path.py +131 -0
  2096. hare/query/lookup_info/bound_ordering.py +82 -0
  2097. hare/query/lookup_info/declarations.py +27 -0
  2098. hare/query/lookup_info/lookup_info.py +94 -0
  2099. hare/query/lookup_info/lookup_info_builder.py +855 -0
  2100. hare/query/lookup_info/lookup_path.py +118 -0
  2101. hare/query/lookup_info/lookup_paths.py +375 -0
  2102. hare/query/lookup_info/ordering_info.py +49 -0
  2103. hare/query/lookup_info/value_paths.py +143 -0
  2104. hare/query/managers/__init__.py +1 -0
  2105. hare/query/managers/base_manager.py +20 -0
  2106. hare/query/managers/manager.py +141 -0
  2107. hare/query/plans/__init__.py +4 -0
  2108. hare/query/plans/call_signatures/__init__.py +1 -0
  2109. hare/query/plans/call_signatures/call_signature_plans.py +259 -0
  2110. hare/query/plans/constants.py +83 -0
  2111. hare/query/plans/description/__init__.py +11 -0
  2112. hare/query/plans/description/declared_plan_parts.py +17 -0
  2113. hare/query/plans/description/filter_plan_descriptions.py +248 -0
  2114. hare/query/plans/description/hashable_values.py +22 -0
  2115. hare/query/plans/description/plan_context.py +45 -0
  2116. hare/query/plans/description/plan_describer_compiler.py +285 -0
  2117. hare/query/plans/description/plan_description.py +66 -0
  2118. hare/query/plans/description/plan_parts.py +147 -0
  2119. hare/query/plans/description/plannable.py +69 -0
  2120. hare/query/plans/description/term_plan_descriptions.py +91 -0
  2121. hare/query/plans/enums.py +96 -0
  2122. hare/query/plans/plan_origins.py +99 -0
  2123. hare/query/plans/recording/__init__.py +1 -0
  2124. hare/query/plans/recording/plan_recording.py +111 -0
  2125. hare/query/plans/recording/scope_value_source.py +61 -0
  2126. hare/query/plans/statement/__init__.py +1 -0
  2127. hare/query/plans/statement/declarations.py +64 -0
  2128. hare/query/plans/statement/declared_plan_slots.py +17 -0
  2129. hare/query/plans/statement/parameter_preparation.py +162 -0
  2130. hare/query/plans/statement/parameter_slot.py +47 -0
  2131. hare/query/plans/statement/query_key_compiler.py +226 -0
  2132. hare/query/plans/statement/raw_sql_plan.py +43 -0
  2133. hare/query/plans/statement/statement_plan.py +214 -0
  2134. hare/query/plans/statement/statement_plan_descriptions.py +488 -0
  2135. hare/query/plans/statement/statement_plan_runs.py +414 -0
  2136. hare/query/plans/statement/statement_plans.py +97 -0
  2137. hare/query/query_connection.py +196 -0
  2138. hare/query/queryset/__init__.py +19 -0
  2139. hare/query/queryset/annotation_access_tracker.py +20 -0
  2140. hare/query/queryset/arguments/__init__.py +1 -0
  2141. hare/query/queryset/arguments/annotation_arguments.py +223 -0
  2142. hare/query/queryset/arguments/collection_arguments.py +29 -0
  2143. hare/query/queryset/arguments/filter_arguments.py +398 -0
  2144. hare/query/queryset/arguments/ordering_arguments.py +258 -0
  2145. hare/query/queryset/arguments/values_arguments.py +180 -0
  2146. hare/query/queryset/combination/__init__.py +1 -0
  2147. hare/query/queryset/combination/combination.py +58 -0
  2148. hare/query/queryset/combination/queryset_combination.py +183 -0
  2149. hare/query/queryset/concrete_field_paths.py +107 -0
  2150. hare/query/queryset/constants.py +89 -0
  2151. hare/query/queryset/date_lists.py +80 -0
  2152. hare/query/queryset/declarations.py +7 -0
  2153. hare/query/queryset/extensions/__init__.py +11 -0
  2154. hare/query/queryset/extensions/declarations.py +12 -0
  2155. hare/query/queryset/extensions/enums.py +8 -0
  2156. hare/query/queryset/extensions/query_set_extension.py +81 -0
  2157. hare/query/queryset/extensions/query_set_extension_call.py +19 -0
  2158. hare/query/queryset/extensions/query_set_extension_query.py +152 -0
  2159. hare/query/queryset/extensions/query_set_extension_result.py +31 -0
  2160. hare/query/queryset/extensions/query_set_extensions.py +222 -0
  2161. hare/query/queryset/lazy_relation_names.py +32 -0
  2162. hare/query/queryset/model_query.py +152 -0
  2163. hare/query/queryset/objects_by_key.py +102 -0
  2164. hare/query/queryset/options/__init__.py +1 -0
  2165. hare/query/queryset/options/query_option.py +42 -0
  2166. hare/query/queryset/options/query_options.py +301 -0
  2167. hare/query/queryset/pending_calls/__init__.py +1 -0
  2168. hare/query/queryset/pending_calls/calls_before_setup.py +163 -0
  2169. hare/query/queryset/pending_calls/pending_filter_calls.py +144 -0
  2170. hare/query/queryset/query_specification.py +1039 -0
  2171. hare/query/queryset/queryset.py +2658 -0
  2172. hare/query/queryset/relations/__init__.py +3 -0
  2173. hare/query/queryset/relations/many_to_many/__init__.py +1 -0
  2174. hare/query/queryset/relations/many_to_many/linked_keys.py +144 -0
  2175. hare/query/queryset/relations/many_to_many/linked_rows_dependency.py +26 -0
  2176. hare/query/queryset/relations/many_to_many/many_to_many_members.py +210 -0
  2177. hare/query/queryset/relations/many_to_many/many_to_many_scope_checks.py +336 -0
  2178. hare/query/queryset/relations/many_to_many/through_defaults.py +254 -0
  2179. hare/query/queryset/relations/many_to_many/through_row_inserting.py +543 -0
  2180. hare/query/queryset/relations/many_to_many/through_row_unlinking.py +362 -0
  2181. hare/query/queryset/relations/many_to_many/through_rows.py +180 -0
  2182. hare/query/queryset/relations/many_to_many/through_values.py +23 -0
  2183. hare/query/queryset/relations/many_to_many_relation.py +451 -0
  2184. hare/query/queryset/relations/related_queryset/__init__.py +9 -0
  2185. hare/query/queryset/relations/related_queryset/declarations.py +16 -0
  2186. hare/query/queryset/relations/related_queryset/related_query_set.py +414 -0
  2187. hare/query/queryset/relations/related_queryset/related_rows_iterator.py +43 -0
  2188. hare/query/queryset/relations/related_queryset/relation_rows.py +74 -0
  2189. hare/query/queryset/relations/related_queryset/unsaved_owner_condition.py +37 -0
  2190. hare/query/queryset/relations/reverse_relation.py +594 -0
  2191. hare/query/queryset/row_multiplication.py +171 -0
  2192. hare/query/queryset/schema_object_calls.py +45 -0
  2193. hare/query/queryset/selection/__init__.py +1 -0
  2194. hare/query/queryset/selection/statement_selection.py +255 -0
  2195. hare/query/queryset/selection/values_selection.py +65 -0
  2196. hare/query/queryset/single_rows/__init__.py +1 -0
  2197. hare/query/queryset/single_rows/get_exception_argument.py +7 -0
  2198. hare/query/queryset/single_rows/get_exceptions.py +102 -0
  2199. hare/query/queryset/single_rows/none_awaitable_type.py +21 -0
  2200. hare/query/queryset/single_rows/query_set_single.py +50 -0
  2201. hare/query/queryset/single_rows/single_row.py +154 -0
  2202. hare/query/queryset/specification_copying.py +152 -0
  2203. hare/query/queryset/table_sample.py +60 -0
  2204. hare/query/raw_sql/__init__.py +6 -0
  2205. hare/query/raw_sql/execute_sql.py +72 -0
  2206. hare/query/raw_sql/sql_query_result.py +38 -0
  2207. hare/query/relation_loading/__init__.py +14 -0
  2208. hare/query/relation_loading/constants.py +8 -0
  2209. hare/query/relation_loading/prefetching/__init__.py +1 -0
  2210. hare/query/relation_loading/prefetching/declarations.py +76 -0
  2211. hare/query/relation_loading/prefetching/direct_relation_prefetch.py +81 -0
  2212. hare/query/relation_loading/prefetching/enums.py +23 -0
  2213. hare/query/relation_loading/prefetching/many_to_many_prefetch.py +494 -0
  2214. hare/query/relation_loading/prefetching/prefetch.py +232 -0
  2215. hare/query/relation_loading/prefetching/prefetch_checks.py +81 -0
  2216. hare/query/relation_loading/prefetching/prefetch_keys.py +29 -0
  2217. hare/query/relation_loading/prefetching/prefetch_plan.py +211 -0
  2218. hare/query/relation_loading/prefetching/prefetch_related_objects.py +111 -0
  2219. hare/query/relation_loading/prefetching/prefetch_request.py +59 -0
  2220. hare/query/relation_loading/prefetching/prefetch_result.py +64 -0
  2221. hare/query/relation_loading/prefetching/prefetcher.py +276 -0
  2222. hare/query/relation_loading/prefetching/related_rows_fetch.py +106 -0
  2223. hare/query/relation_loading/prefetching/reverse_relation_prefetch.py +82 -0
  2224. hare/query/relation_loading/prefetching/sliced_prefetch.py +192 -0
  2225. hare/query/relation_loading/select.py +26 -0
  2226. hare/query/rows/__init__.py +3 -0
  2227. hare/query/rows/constants.py +9 -0
  2228. hare/query/rows/model_rows/__init__.py +1 -0
  2229. hare/query/rows/model_rows/combined_model_rows.py +273 -0
  2230. hare/query/rows/model_rows/grouped_model_rows.py +51 -0
  2231. hare/query/rows/model_rows/model_columns.py +71 -0
  2232. hare/query/rows/model_rows/model_rows.py +489 -0
  2233. hare/query/rows/native/__init__.py +1 -0
  2234. hare/query/rows/native/hydration_layout.py +63 -0
  2235. hare/query/rows/row_layout.py +46 -0
  2236. hare/query/rows/values_rows/__init__.py +1 -0
  2237. hare/query/rows/values_rows/combined_values_rows.py +155 -0
  2238. hare/query/rows/values_rows/dict_rows.py +25 -0
  2239. hare/query/rows/values_rows/flat_rows.py +16 -0
  2240. hare/query/rows/values_rows/named_rows.py +37 -0
  2241. hare/query/rows/values_rows/tuple_rows.py +21 -0
  2242. hare/query/rows/values_rows/value_field.py +21 -0
  2243. hare/query/rows/values_rows/values_rows.py +212 -0
  2244. hare/query/scopes/__init__.py +23 -0
  2245. hare/query/scopes/constants.py +9 -0
  2246. hare/query/scopes/row_scope.py +32 -0
  2247. hare/query/scopes/row_scope_binding.py +60 -0
  2248. hare/query/scopes/row_scope_provider.py +25 -0
  2249. hare/query/scopes/row_scopes.py +274 -0
  2250. hare/query/scopes/row_visibility.py +86 -0
  2251. hare/query/scopes/scope_join_conditions.py +314 -0
  2252. hare/query/scopes/soft_delete_scope.py +17 -0
  2253. hare/query/scopes/tenants/__init__.py +1 -0
  2254. hare/query/scopes/tenants/all_tenants.py +11 -0
  2255. hare/query/scopes/tenants/model_tenants.py +235 -0
  2256. hare/query/scopes/tenants/tenant_scope.py +70 -0
  2257. hare/query/scopes/tenants/tenant_values.py +52 -0
  2258. hare/query/statements/__init__.py +30 -0
  2259. hare/query/statements/awaitable_query.py +556 -0
  2260. hare/query/statements/building/__init__.py +1 -0
  2261. hare/query/statements/building/keyset_bounds.py +241 -0
  2262. hare/query/statements/building/query_annotations.py +411 -0
  2263. hare/query/statements/building/query_conditions.py +228 -0
  2264. hare/query/statements/building/query_ctes.py +71 -0
  2265. hare/query/statements/building/query_grouping.py +362 -0
  2266. hare/query/statements/building/query_joins.py +208 -0
  2267. hare/query/statements/building/query_ordering.py +119 -0
  2268. hare/query/statements/building/row_locks.py +223 -0
  2269. hare/query/statements/constants.py +165 -0
  2270. hare/query/statements/projections/__init__.py +0 -0
  2271. hare/query/statements/projections/declarations.py +25 -0
  2272. hare/query/statements/projections/derived_projection.py +203 -0
  2273. hare/query/statements/projections/projected_value.py +24 -0
  2274. hare/query/statements/query_sql.py +184 -0
  2275. hare/query/statements/rows_source_query.py +57 -0
  2276. hare/query/statements/select/__init__.py +4 -0
  2277. hare/query/statements/select/combined/__init__.py +1 -0
  2278. hare/query/statements/select/combined/combined_branches.py +402 -0
  2279. hare/query/statements/select/combined/combined_derived_queries.py +216 -0
  2280. hare/query/statements/select/combined/combined_plan_descriptions.py +46 -0
  2281. hare/query/statements/select/combined_query.py +355 -0
  2282. hare/query/statements/select/grouped_model_rows_query.py +19 -0
  2283. hare/query/statements/select/iterator_page_query.py +104 -0
  2284. hare/query/statements/select/model_rows/__init__.py +1 -0
  2285. hare/query/statements/select/model_rows/instance_hydration.py +204 -0
  2286. hare/query/statements/select/model_rows/model_rows_plan_descriptions.py +123 -0
  2287. hare/query/statements/select/model_rows/only_defer_fields.py +346 -0
  2288. hare/query/statements/select/model_rows/select_related_joins.py +112 -0
  2289. hare/query/statements/select/model_rows_query.py +489 -0
  2290. hare/query/statements/select/raw_sql_query.py +182 -0
  2291. hare/query/statements/select/rows_query.py +294 -0
  2292. hare/query/statements/select/select_query.py +128 -0
  2293. hare/query/statements/select/values/__init__.py +1 -0
  2294. hare/query/statements/select/values/constants.py +9 -0
  2295. hare/query/statements/select/values/values_distinct.py +44 -0
  2296. hare/query/statements/select/values/values_grouping.py +119 -0
  2297. hare/query/statements/select/values/values_output.py +270 -0
  2298. hare/query/statements/select/values/window_filter_wrapping.py +66 -0
  2299. hare/query/statements/select/values_query.py +734 -0
  2300. hare/query/statements/summary/__init__.py +3 -0
  2301. hare/query/statements/summary/aggregate_query.py +749 -0
  2302. hare/query/statements/summary/contains_query.py +114 -0
  2303. hare/query/statements/summary/count_query.py +142 -0
  2304. hare/query/statements/summary/exists_query.py +157 -0
  2305. hare/query/statements/summary/rows_summary_query.py +309 -0
  2306. hare/query/statements/summary/summary_source.py +22 -0
  2307. hare/query/statements/write/__init__.py +3 -0
  2308. hare/query/statements/write/bulk/__init__.py +1 -0
  2309. hare/query/statements/write/bulk/bulk_objects.py +70 -0
  2310. hare/query/statements/write/bulk/bulk_update_checks.py +114 -0
  2311. hare/query/statements/write/bulk/bulk_update_query.py +1014 -0
  2312. hare/query/statements/write/bulk/bulk_write_batches.py +192 -0
  2313. hare/query/statements/write/bulk/create/__init__.py +1 -0
  2314. hare/query/statements/write/bulk/create/bulk_create_query.py +791 -0
  2315. hare/query/statements/write/bulk/create/bulk_create_reports.py +374 -0
  2316. hare/query/statements/write/bulk/create/conflict_clause.py +176 -0
  2317. hare/query/statements/write/bulk/create/copy_insert.py +83 -0
  2318. hare/query/statements/write/bulk/create/declarations.py +30 -0
  2319. hare/query/statements/write/bulk/create/default_rows_insert.py +91 -0
  2320. hare/query/statements/write/bulk/create/inline_insert.py +38 -0
  2321. hare/query/statements/write/bulk/create/multi_row_insert.py +316 -0
  2322. hare/query/statements/write/bulk/create/prepared_bulk_insert.py +107 -0
  2323. hare/query/statements/write/bulk/create/returned_rows_matching.py +271 -0
  2324. hare/query/statements/write/bulk/create/template_insert.py +159 -0
  2325. hare/query/statements/write/bulk/declarations.py +61 -0
  2326. hare/query/statements/write/create_or_update.py +212 -0
  2327. hare/query/statements/write/declarations.py +26 -0
  2328. hare/query/statements/write/delete_query.py +453 -0
  2329. hare/query/statements/write/insert_from_query.py +403 -0
  2330. hare/query/statements/write/matching_rows_query.py +323 -0
  2331. hare/query/statements/write/merge/__init__.py +1 -0
  2332. hare/query/statements/write/merge/merge_query.py +889 -0
  2333. hare/query/statements/write/merge/merge_when.py +87 -0
  2334. hare/query/statements/write/restore_query.py +128 -0
  2335. hare/query/statements/write/returning/__init__.py +1 -0
  2336. hare/query/statements/write/returning/delete_returning_query.py +184 -0
  2337. hare/query/statements/write/returning/returned_rows.py +301 -0
  2338. hare/query/statements/write/returning/update_returning_query.py +117 -0
  2339. hare/query/statements/write/update_query.py +800 -0
  2340. hare/search/__init__.py +29 -0
  2341. hare/search/constants.py +4 -0
  2342. hare/search/enums.py +26 -0
  2343. hare/search/messages.py +1 -0
  2344. hare/search/query/__init__.py +8 -0
  2345. hare/search/query/combined_search_query.py +46 -0
  2346. hare/search/query/declarations.py +9 -0
  2347. hare/search/query/search_query.py +63 -0
  2348. hare/search/query/search_query_combinable.py +40 -0
  2349. hare/search/search_arguments.py +72 -0
  2350. hare/search/search_features.py +35 -0
  2351. hare/search/search_headline.py +184 -0
  2352. hare/search/search_rank.py +108 -0
  2353. hare/search/types.py +16 -0
  2354. hare/search/vector/__init__.py +7 -0
  2355. hare/search/vector/combined_search_vector.py +27 -0
  2356. hare/search/vector/search_vector.py +79 -0
  2357. hare/search/vector/search_vector_combinable.py +30 -0
  2358. hare/sql/__init__.py +73 -0
  2359. hare/sql/analytics/__init__.py +17 -0
  2360. hare/sql/analytics/count.py +15 -0
  2361. hare/sql/analytics/current_row.py +12 -0
  2362. hare/sql/analytics/declarations.py +22 -0
  2363. hare/sql/analytics/row_number.py +15 -0
  2364. hare/sql/builder/__init__.py +29 -0
  2365. hare/sql/builder/joins/__init__.py +16 -0
  2366. hare/sql/builder/joins/join.py +70 -0
  2367. hare/sql/builder/joins/join_on.py +73 -0
  2368. hare/sql/builder/joins/joiner.py +38 -0
  2369. hare/sql/builder/queries/__init__.py +17 -0
  2370. hare/sql/builder/queries/constants.py +9 -0
  2371. hare/sql/builder/queries/correlated_subqueries.py +564 -0
  2372. hare/sql/builder/queries/pagination_sql.py +18 -0
  2373. hare/sql/builder/queries/query.py +114 -0
  2374. hare/sql/builder/queries/query_builder.py +1108 -0
  2375. hare/sql/builder/queries/query_sql_rendering.py +457 -0
  2376. hare/sql/builder/queries/set_operation_query.py +217 -0
  2377. hare/sql/builder/returned_value.py +19 -0
  2378. hare/sql/builder/tables/__init__.py +22 -0
  2379. hare/sql/builder/tables/aliased_query.py +46 -0
  2380. hare/sql/builder/tables/array_join_source.py +38 -0
  2381. hare/sql/builder/tables/asof_join_source.py +29 -0
  2382. hare/sql/builder/tables/cte.py +17 -0
  2383. hare/sql/builder/tables/database.py +12 -0
  2384. hare/sql/builder/tables/declarations.py +6 -0
  2385. hare/sql/builder/tables/json_table_query.py +75 -0
  2386. hare/sql/builder/tables/lateral_query.py +26 -0
  2387. hare/sql/builder/tables/schema.py +36 -0
  2388. hare/sql/builder/tables/selectable.py +112 -0
  2389. hare/sql/builder/tables/table.py +172 -0
  2390. hare/sql/builder/tables/trigger_row.py +14 -0
  2391. hare/sql/builder/update_from_values.py +34 -0
  2392. hare/sql/builder_methods.py +59 -0
  2393. hare/sql/constants.py +80 -0
  2394. hare/sql/enums.py +134 -0
  2395. hare/sql/exceptions.py +31 -0
  2396. hare/sql/functions/__init__.py +79 -0
  2397. hare/sql/functions/address_text.py +20 -0
  2398. hare/sql/functions/cast.py +22 -0
  2399. hare/sql/functions/cast_to.py +38 -0
  2400. hare/sql/functions/coalesce.py +16 -0
  2401. hare/sql/functions/count.py +16 -0
  2402. hare/sql/functions/datetime/__init__.py +1 -0
  2403. hare/sql/functions/datetime/date.py +19 -0
  2404. hare/sql/functions/datetime/date_as_timestamp.py +26 -0
  2405. hare/sql/functions/datetime/date_trunc.py +43 -0
  2406. hare/sql/functions/datetime/datetime_as_text.py +19 -0
  2407. hare/sql/functions/datetime/datetime_cast.py +46 -0
  2408. hare/sql/functions/datetime/extract.py +72 -0
  2409. hare/sql/functions/datetime/now.py +17 -0
  2410. hare/sql/functions/datetime/temporal_difference.py +29 -0
  2411. hare/sql/functions/datetime/temporal_shift.py +46 -0
  2412. hare/sql/functions/datetime/timestamp_comparand.py +21 -0
  2413. hare/sql/functions/declarations.py +27 -0
  2414. hare/sql/functions/distinct_option_function.py +35 -0
  2415. hare/sql/functions/greatest_least.py +23 -0
  2416. hare/sql/functions/grouping_function.py +15 -0
  2417. hare/sql/functions/json/__init__.py +1 -0
  2418. hare/sql/functions/json/json_array.py +17 -0
  2419. hare/sql/functions/json/json_object.py +17 -0
  2420. hare/sql/functions/json/json_sort_key.py +18 -0
  2421. hare/sql/functions/json/json_value.py +22 -0
  2422. hare/sql/functions/length.py +14 -0
  2423. hare/sql/functions/numeric_cast.py +18 -0
  2424. hare/sql/functions/random_number.py +16 -0
  2425. hare/sql/functions/round.py +21 -0
  2426. hare/sql/functions/statistic.py +10 -0
  2427. hare/sql/functions/std_dev.py +15 -0
  2428. hare/sql/functions/text/__init__.py +1 -0
  2429. hare/sql/functions/text/collate.py +49 -0
  2430. hare/sql/functions/text/concat.py +21 -0
  2431. hare/sql/functions/text/concat_function.py +58 -0
  2432. hare/sql/functions/text/lower.py +15 -0
  2433. hare/sql/functions/text/replace.py +15 -0
  2434. hare/sql/functions/text/upper.py +15 -0
  2435. hare/sql/identifiers.py +118 -0
  2436. hare/sql/order.py +59 -0
  2437. hare/sql/sql_context.py +159 -0
  2438. hare/sql/terms/__init__.py +90 -0
  2439. hare/sql/terms/arithmetic_expression.py +82 -0
  2440. hare/sql/terms/array.py +134 -0
  2441. hare/sql/terms/bracket.py +14 -0
  2442. hare/sql/terms/case/__init__.py +1 -0
  2443. hare/sql/terms/case/case.py +99 -0
  2444. hare/sql/terms/case/when_then.py +13 -0
  2445. hare/sql/terms/constants.py +5 -0
  2446. hare/sql/terms/containers/__init__.py +35 -0
  2447. hare/sql/terms/containers/array_element_term.py +60 -0
  2448. hare/sql/terms/containers/array_slice_term.py +30 -0
  2449. hare/sql/terms/containers/constants.py +6 -0
  2450. hare/sql/terms/containers/container_function.py +25 -0
  2451. hare/sql/terms/containers/container_literal.py +39 -0
  2452. hare/sql/terms/containers/declarations.py +61 -0
  2453. hare/sql/terms/containers/map_value_term.py +32 -0
  2454. hare/sql/terms/containers/tuple_element_term.py +23 -0
  2455. hare/sql/terms/criteria/__init__.py +37 -0
  2456. hare/sql/terms/criteria/basic_criterion.py +70 -0
  2457. hare/sql/terms/criteria/between_criterion.py +15 -0
  2458. hare/sql/terms/criteria/complex_criterion.py +60 -0
  2459. hare/sql/terms/criteria/contains_criterion.py +82 -0
  2460. hare/sql/terms/criteria/criterion.py +72 -0
  2461. hare/sql/terms/criteria/declarations.py +13 -0
  2462. hare/sql/terms/criteria/empty_criterion.py +40 -0
  2463. hare/sql/terms/criteria/is_distinct_from_criterion.py +31 -0
  2464. hare/sql/terms/criteria/is_not_true_criterion.py +30 -0
  2465. hare/sql/terms/criteria/json_attribute_criterion.py +57 -0
  2466. hare/sql/terms/criteria/like.py +62 -0
  2467. hare/sql/terms/criteria/nested_criterion.py +55 -0
  2468. hare/sql/terms/criteria/not_criterion.py +58 -0
  2469. hare/sql/terms/criteria/null_criterion.py +25 -0
  2470. hare/sql/terms/criteria/range_criterion.py +29 -0
  2471. hare/sql/terms/criteria/true_criterion.py +15 -0
  2472. hare/sql/terms/enums.py +18 -0
  2473. hare/sql/terms/field.py +65 -0
  2474. hare/sql/terms/functions/__init__.py +30 -0
  2475. hare/sql/terms/functions/aggregate_function.py +104 -0
  2476. hare/sql/terms/functions/analytic_function.py +119 -0
  2477. hare/sql/terms/functions/custom_function.py +27 -0
  2478. hare/sql/terms/functions/decimal_mod.py +28 -0
  2479. hare/sql/terms/functions/float_mod.py +27 -0
  2480. hare/sql/terms/functions/function.py +111 -0
  2481. hare/sql/terms/functions/interval.py +130 -0
  2482. hare/sql/terms/functions/mod.py +25 -0
  2483. hare/sql/terms/functions/pow.py +14 -0
  2484. hare/sql/terms/functions/window_frame_analytic_function.py +64 -0
  2485. hare/sql/terms/functions/window_frame_edge.py +19 -0
  2486. hare/sql/terms/grouping/__init__.py +14 -0
  2487. hare/sql/terms/grouping/declarations.py +21 -0
  2488. hare/sql/terms/grouping/grouping_element.py +33 -0
  2489. hare/sql/terms/grouping/grouping_sets_element.py +35 -0
  2490. hare/sql/terms/index.py +17 -0
  2491. hare/sql/terms/infix_operator.py +36 -0
  2492. hare/sql/terms/json.py +28 -0
  2493. hare/sql/terms/messages.py +1 -0
  2494. hare/sql/terms/negative.py +29 -0
  2495. hare/sql/terms/node.py +161 -0
  2496. hare/sql/terms/node_structure.py +229 -0
  2497. hare/sql/terms/node_traversal.py +41 -0
  2498. hare/sql/terms/parameters/__init__.py +1 -0
  2499. hare/sql/terms/parameters/list_parameter.py +26 -0
  2500. hare/sql/terms/parameters/parameter.py +35 -0
  2501. hare/sql/terms/parameters/parameterized_value_wrapper.py +21 -0
  2502. hare/sql/terms/parameters/parameterizer.py +98 -0
  2503. hare/sql/terms/parameters/query_parameters.py +74 -0
  2504. hare/sql/terms/parameters/recording_parameterizer.py +27 -0
  2505. hare/sql/terms/qualified_outer_field.py +59 -0
  2506. hare/sql/terms/select_reference.py +61 -0
  2507. hare/sql/terms/star.py +29 -0
  2508. hare/sql/terms/structure_identity.py +22 -0
  2509. hare/sql/terms/subqueries/__init__.py +1 -0
  2510. hare/sql/terms/subqueries/exists_term.py +118 -0
  2511. hare/sql/terms/subqueries/outer_aggregate_term.py +52 -0
  2512. hare/sql/terms/term.py +329 -0
  2513. hare/sql/terms/term_identity_text.py +60 -0
  2514. hare/sql/terms/tuple.py +30 -0
  2515. hare/sql/terms/values/__init__.py +1 -0
  2516. hare/sql/terms/values/literal_value.py +24 -0
  2517. hare/sql/terms/values/null_value.py +12 -0
  2518. hare/sql/terms/values/old_row_value.py +30 -0
  2519. hare/sql/terms/values/row_value_list.py +17 -0
  2520. hare/sql/terms/values/value_wrapper.py +132 -0
  2521. hare/sql/types/__init__.py +1 -0
  2522. hare/sql/types/sql_types.py +16 -0
  2523. hare/stubs/__init__.py +2 -0
  2524. hare/stubs/class_stub_editor.py +85 -0
  2525. hare/stubs/constants.py +15 -0
  2526. hare/stubs/messages.py +1 -0
  2527. hare/stubs/model_stub.py +397 -0
  2528. hare/stubs/module_stub.py +110 -0
  2529. hare/stubs/module_stub_exports.py +56 -0
  2530. hare/stubs/stub_imports.py +99 -0
  2531. hare/stubs/stub_writer.py +61 -0
  2532. hare/stubs/value_type_text.py +149 -0
  2533. hare/time/__init__.py +12 -0
  2534. hare/time/constants.py +22 -0
  2535. hare/time/system_clock.py +32 -0
  2536. hare/time/system_zone.py +116 -0
  2537. hare/time/timezone.py +263 -0
  2538. hare/time/zone_names.py +108 -0
  2539. hare/time/zone_settings.py +161 -0
  2540. hare/transactions/__init__.py +29 -0
  2541. hare/transactions/atomic/__init__.py +1 -0
  2542. hare/transactions/atomic/atomic.py +144 -0
  2543. hare/transactions/atomic/atomic_attempt.py +73 -0
  2544. hare/transactions/atomic/atomic_attempts.py +74 -0
  2545. hare/transactions/constants.py +38 -0
  2546. hare/transactions/distributed/__init__.py +9 -0
  2547. hare/transactions/distributed/declarations.py +49 -0
  2548. hare/transactions/distributed/distributed_coordinator.py +744 -0
  2549. hare/transactions/distributed/distributed_decision.py +18 -0
  2550. hare/transactions/distributed/distributed_decision_store.py +61 -0
  2551. hare/transactions/distributed/distributed_recovery.py +139 -0
  2552. hare/transactions/distributed/distributed_transactions.py +31 -0
  2553. hare/transactions/distributed/messages.py +1 -0
  2554. hare/transactions/distributed/stale_prepared_transaction.py +23 -0
  2555. hare/transactions/enums.py +56 -0
  2556. hare/transactions/messages.py +1 -0
  2557. hare/transactions/transaction_group.py +131 -0
  2558. hare/transactions/transaction_group_exit.py +20 -0
  2559. hare/transactions/transaction_options.py +86 -0
  2560. hare/transactions/transactions.py +220 -0
  2561. hare/typing_info/__init__.py +4 -0
  2562. hare/typing_info/bound_models.py +49 -0
  2563. hare/typing_info/constants.py +13 -0
  2564. hare/typing_info/declarations.py +52 -0
  2565. hare/typing_info/filter_value_types.py +155 -0
  2566. hare/typing_info/write_value_types.py +120 -0
  2567. hare/vectors/__init__.py +18 -0
  2568. hare/vectors/constants.py +10 -0
  2569. hare/vectors/declarations.py +41 -0
  2570. hare/vectors/enums.py +14 -0
  2571. hare/vectors/terms/__init__.py +6 -0
  2572. hare/vectors/terms/vector_distance_term.py +22 -0
  2573. hare/vectors/terms/vector_literal.py +18 -0
  2574. hare/vectors/vector_distance_expression.py +92 -0
  2575. hare/vectors/vector_field.py +170 -0
  2576. hare/warnings.py +13 -0
  2577. hare_orm-0.13.0.dist-info/LICENSE +27 -0
  2578. hare_orm-0.13.0.dist-info/METADATA +343 -0
  2579. hare_orm-0.13.0.dist-info/RECORD +2582 -0
  2580. hare_orm-0.13.0.dist-info/WHEEL +5 -0
  2581. hare_orm-0.13.0.dist-info/entry_points.txt +6 -0
  2582. rust/native.cp315-win_amd64.pyd +0 -0
@@ -0,0 +1,556 @@
1
+ from __future__ import annotations
2
+
3
+ from collections.abc import Generator, Sequence
4
+ from copy import copy
5
+ from typing import TYPE_CHECKING, Any, ClassVar, Generic, Self, TypeVar
6
+
7
+ from hare.dialects.base.client.database_client import DatabaseClient
8
+ from hare.exceptions import (
9
+ ConfigurationError,
10
+ QueryError,
11
+ )
12
+ from hare.query.execution.bound_query import BoundQuery
13
+ from hare.query.execution.query_execution import QueryExecution
14
+ from hare.query.expressions import (
15
+ Q,
16
+ )
17
+ from hare.query.expressions.constants import UNBINDABLE_VALUE_ORIGIN
18
+ from hare.query.expressions.subqueries.outer_scope import OuterScope
19
+ from hare.query.expressions.value_references.value_reference_types import RecordedValueReferences
20
+ from hare.query.plans.constants import EXPRESSIONS_NESTED_TOO_DEEPLY_MESSAGE
21
+ from hare.query.plans.description.plan_description import PlanDescription
22
+ from hare.query.plans.plan_origins import PlanOrigins
23
+ from hare.query.plans.recording.plan_recording import PlanRecording
24
+ from hare.query.plans.statement.declarations import CallPlanHit, RenderedStatement
25
+ from hare.query.plans.statement.query_key_compiler import QueryKeyCompiler
26
+ from hare.query.plans.statement.statement_plan import StatementPlan
27
+ from hare.query.plans.statement.statement_plan_descriptions import StatementPlanDescriptions
28
+ from hare.query.plans.statement.statement_plan_runs import StatementPlanRuns
29
+ from hare.query.plans.statement.statement_plans import StatementPlans
30
+ from hare.query.queryset.extensions.enums import ExtensionPhase
31
+ from hare.query.queryset.extensions.query_set_extensions import QuerySetExtensions
32
+ from hare.query.queryset.pending_calls.pending_filter_calls import PendingFilterCalls
33
+ from hare.query.scopes.row_scope_binding import RowScopeBinding
34
+ from hare.query.scopes.row_scopes import RowScopes
35
+ from hare.query.statements.building.query_joins import QueryJoins
36
+ from hare.sql.builder.queries.query_builder import QueryBuilder
37
+ from hare.sql.terms.criteria.basic_criterion import BasicCriterion
38
+
39
+ if TYPE_CHECKING:
40
+ from hare.core.hare_context import HareContext
41
+ from hare.models import Model
42
+ from hare.models.model_binding import ModelBinding
43
+
44
+ TModel = TypeVar("TModel", bound="Model")
45
+
46
+
47
+ class AwaitableQuery(BoundQuery[TModel], Generic[TModel], abstract=True):
48
+ """The base of the queries a queryset runs: built into SQL, kept as a plan, awaited for the result."""
49
+
50
+ #: Whether this type of query only reads - a read is retried on a lost connection, a write
51
+ #: never: retried blindly it could take effect twice.
52
+ is_read_only: ClassVar[bool] = False
53
+
54
+ #: Whether an implicit GROUP BY always includes the primary key - one group per row. True for
55
+ #: every query standing for model rows; False for .values()/.values_list(), which group by the
56
+ #: fields they name.
57
+ group_by_must_include_primary_key: ClassVar[bool] = True
58
+
59
+ #: Whether QueryOrdering.get_ordering() may reference a selected annotation by its SELECT alias. False for
60
+ #: UPDATE/DELETE, whose ordered pk subquery selects only the primary key.
61
+ ordering_can_reference_annotation_alias: ClassVar[bool] = True
62
+
63
+ #: Whether an annotated aggregate's value is never read - only whether the query returned a row
64
+ #: (exists()). Two aggregated to-many relations in one query, which inflate each other's counts,
65
+ #: are fine then.
66
+ aggregate_value_is_unused: ClassVar[bool] = False
67
+
68
+ #: Whether a filter reading a window function is applied to the query wrapped as a derived
69
+ #: table instead of rejected - True for .values()/.values_list() (ValuesQuery).
70
+ window_filter_wrapping_supported: ClassVar[bool] = False
71
+
72
+ def __init_subclass__(cls, **kwargs: Any) -> None:
73
+ super().__init_subclass__(**kwargs)
74
+ # The description of the statement of each declaration of the class's plan slots.
75
+ QueryKeyCompiler.compile_declared(cls)
76
+
77
+ #: The statement being built.
78
+ query: QueryBuilder
79
+
80
+ def _apply_connection(self, connection: DatabaseClient | None) -> None:
81
+ """Binds this query to the connection it runs on - the statement being built starts
82
+ over in that connection's builder.
83
+
84
+ Args:
85
+ connection: The database connection to use for this query.
86
+ """
87
+ super()._apply_connection(connection)
88
+ if connection is not None and hasattr(self, "query"):
89
+ self.query = connection.query_class.get_empty_builder()
90
+ self._bound_extensions = None
91
+ self._extension_result = None
92
+
93
+ def __init__(
94
+ self, model: type[TModel], *, binding: ModelBinding | None = None, context: HareContext | None = None
95
+ ) -> None:
96
+ super().__init__(model, binding=binding, context=context)
97
+ self._init_build_state()
98
+
99
+ def __await__(self) -> Generator[Any, None, Any]:
100
+ return QueryExecution.run(self).__await__()
101
+
102
+ async def _execute_bound(self) -> Any:
103
+ """Execute after dependencies have supplied the values needed to build this statement."""
104
+ raise NotImplementedError
105
+
106
+ def _get_filter_annotations(self) -> dict[str, Any]:
107
+ """The annotations a filter of this query reads - by name, before a field of that name.
108
+
109
+ Returns:
110
+ The annotations.
111
+ """
112
+ return self._annotations
113
+
114
+ def _get_annotation_column_aliases(self, name: str) -> tuple[str, ...]:
115
+ """The selected SQL names of one source annotation, independent of its expression references."""
116
+ return (name,)
117
+
118
+ def _get_row_join_lookups(self) -> list[str]:
119
+ """Lookups this query joins outside ``QueryConditions.get_filters()`` - its ordering and selected fields -
120
+ whose to-many hops count towards the aggregate fan-out check.
121
+
122
+ Returns:
123
+ The lookups.
124
+ """
125
+ return []
126
+
127
+ def _get_group_key_lookups(self) -> list[str]:
128
+ """Field lookups of this query's GROUP BY keys - the explicit ``.group_by()`` fields.
129
+
130
+ Returns:
131
+ The lookups.
132
+ """
133
+ return QueryJoins.get_field_lookups(self, self._group_bys)
134
+
135
+ def _aggregates_per_model_row(self) -> bool:
136
+ """Whether a query selecting chosen columns computes its aggregates per model row - they
137
+ were annotated before ``.values()``/``.values_list()``, like Django.
138
+
139
+ Returns:
140
+ False - only a ``.values()``/``.values_list()`` query decides otherwise.
141
+ """
142
+ return False
143
+
144
+ def _annotation_renders_as_expression(self, annotation_name: str) -> bool:
145
+ """Whether a GROUP BY/ORDER BY of an annotation renders its full expression rather than
146
+ its SELECT alias.
147
+
148
+ Args:
149
+ annotation_name: The annotation name.
150
+
151
+ Returns:
152
+ True when the annotation isn't selected, or ORDER BY can't reference an alias.
153
+ """
154
+ return annotation_name in self._alias_keys or not self.ordering_can_reference_annotation_alias
155
+
156
+ def _get_filter_value_query(self) -> AwaitableQuery[Any]:
157
+ """The query a filter compares with when this query is its value.
158
+
159
+ Returns:
160
+ This query itself; a bare queryset selects its primary key instead.
161
+ """
162
+ return self
163
+
164
+ def _get_scoped_copy(self) -> Self:
165
+ """A copy of this query with its default scope applied - what a query built into another one (a
166
+ subquery, a CTE body, a set operation's branch) describes in its ``get_plan_description()``.
167
+
168
+ Returns:
169
+ The copy.
170
+ """
171
+ if self._pending_filter_calls:
172
+ # Built once, so every copy holds the same conditions (_build_conditions_for_copies()).
173
+ PendingFilterCalls.build_pending_filter_calls(self)
174
+ scoped_query = copy(self)
175
+ scoped_query._plan_origin = self
176
+ scoped_query._apply_ambient_scope()
177
+ return scoped_query
178
+
179
+ def _get_statements(self, parameters_inline: bool) -> list[tuple[str, list[Any]]]:
180
+ rendered = self._make_query()
181
+ if parameters_inline:
182
+ return [
183
+ (
184
+ self.query.get_sql(self._connection.sql_context),
185
+ [],
186
+ )
187
+ ]
188
+ if rendered is not None:
189
+ return [(rendered.sql, rendered.parameters)]
190
+ sql, values = self.query.get_parameterized_sql(self._connection.sql_context)
191
+ return [(sql, values)]
192
+
193
+ def _get_read_columns(self) -> set[tuple[str, str]]:
194
+ self._make_query()
195
+ return self.query.get_read_columns()
196
+
197
+ def _make_query(
198
+ self, *, value_wrapper_references: RecordedValueReferences | None = None, for_execution: bool = False
199
+ ) -> CallPlanHit | RenderedStatement | None:
200
+ """Builds ``self.query`` for the context the query runs in: its default scope first.
201
+
202
+ Args:
203
+ value_wrapper_references: The enclosing statement's recorded value references, if supplied.
204
+ for_execution: Whether the query can run on a previously prepared plan.
205
+
206
+ Raises:
207
+ QueryError: An expression is nested deeper than the query can be built.
208
+ """
209
+ scope_token = None
210
+ if RowScopeBinding.current.get() is None:
211
+ scope_token = RowScopeBinding.current.set(RowScopeBinding())
212
+ try:
213
+ return self._make_query_steps(
214
+ value_wrapper_references=value_wrapper_references, for_execution=for_execution
215
+ )
216
+ except RecursionError:
217
+ # Built and written level by level - an expression nested hundreds of levels deep
218
+ # (F("n") + 1 + 1 ...) is deeper than Python's stack.
219
+ raise QueryError(EXPRESSIONS_NESTED_TOO_DEEPLY_MESSAGE) from None
220
+ finally:
221
+ if scope_token is not None:
222
+ RowScopeBinding.current.reset(scope_token)
223
+
224
+ def _make_query_steps(
225
+ self, *, value_wrapper_references: RecordedValueReferences | None, for_execution: bool
226
+ ) -> CallPlanHit | RenderedStatement | None:
227
+ """Prepare scopes, build the statement and apply any deferred extensions."""
228
+ QuerySetExtensions.bind(self)
229
+ self._extension_result = None
230
+ self._statement_plan = None
231
+ self._deferred_plan_record = None
232
+ self._extension_value_wrapper_references = None
233
+ self._extension_calls_built_in = False
234
+ self._apply_ambient_scope()
235
+ hit = self._build_query(value_wrapper_references=value_wrapper_references, for_execution=for_execution)
236
+ if self._extension_calls and not isinstance(hit, CallPlanHit):
237
+ hit = self._apply_extension_calls()
238
+ return hit
239
+
240
+ def _apply_extension_calls(self) -> RenderedStatement | None:
241
+ """Applies the calls of the dialect's QuerySet methods to the query just built, then
242
+ records its plan - the plan's SQL text holds the calls. A query run on its plan has them
243
+ in the text already.
244
+
245
+ Raises:
246
+ UnSupportedError: The connection's dialect has no implementation of a called method.
247
+ """
248
+ deferred_plan_record = self._deferred_plan_record
249
+ # Late extensions can add scoped JOINs too. They contribute to the same recording
250
+ # as the statement's earlier build, before that recording is published as a plan.
251
+ plan_recording = deferred_plan_record.get("plan_recording") if deferred_plan_record is not None else None
252
+ token = PlanRecording.current.set(plan_recording) if plan_recording is not None else None
253
+ try:
254
+ QuerySetExtensions.apply(
255
+ self,
256
+ self._extension_value_wrapper_references,
257
+ phase=ExtensionPhase.STATEMENT if self._extension_calls_built_in else None,
258
+ )
259
+ finally:
260
+ if token is not None:
261
+ PlanRecording.current.reset(token)
262
+ if deferred_plan_record is not None:
263
+ self._deferred_plan_record = None
264
+ # A copy of the plan's query with other values in its terms would miss the calls.
265
+ return StatementPlanRuns.record_plan(self, **deferred_plan_record, extension_calls_applied=True)
266
+ return None
267
+
268
+ def _apply_extension_calls_to_row_source(self) -> None:
269
+ """Applies the calls of the dialect's QuerySet methods to the query reading the rows, before the
270
+ build wraps it in a derived table - a call naming how the table is read (its merged rows,
271
+ a sample of them, a filter before the others) belongs to the query reading it.
272
+
273
+ Raises:
274
+ UnSupportedError: The connection's dialect has no implementation of a called method.
275
+ """
276
+ if self._extension_calls:
277
+ QuerySetExtensions.apply(
278
+ self,
279
+ self._extension_value_wrapper_references,
280
+ phase=ExtensionPhase.ROW_SOURCE,
281
+ )
282
+ self._extension_calls_built_in = True
283
+
284
+ def reads_rows_in_derived_table(self) -> bool:
285
+ """Whether the build reads the rows in a derived table its outer query filters, orders and
286
+ slices - for a filter on a window function.
287
+
288
+ Returns:
289
+ True when it does.
290
+ """
291
+ return self._window_filter_criterion is not None
292
+
293
+ def _make_query_to_run(self) -> tuple[str, list[Any]]:
294
+ """Builds the query to be run by itself - the only build a plan's compiled statement may stand
295
+ in for. A query shown with ``.sql()``/``explain()`` or built into another one is built with
296
+ ``_make_query()``. A query of a queryset made by simple calls alone looked its plan up by the
297
+ key of the calls before it was made (``StatementPlanRuns.find_call_plan()``).
298
+ """
299
+ hit = self._make_query(for_execution=True)
300
+ return (hit.sql, hit.parameters) if hit is not None else self._get_parameterized_sql()
301
+
302
+ def _get_call_signature_type_part(self) -> tuple[Any, Sequence[Any]]:
303
+ """What the key of the calls and the values bound hold of this type of query beyond its
304
+ calls - the values a write assigns, say. Only read: a query not made to run is asked too.
305
+
306
+ Returns:
307
+ The structure (None when the query isn't run by the key of its calls) and the values,
308
+ bound after the calls' own.
309
+ """
310
+ return (), ()
311
+
312
+ def _get_call_plan_reading(self, plan: StatementPlan) -> Any:
313
+ """What reading the result of ``plan`` takes beyond the plan, kept with it under the key of the
314
+ calls - a function of that key alone. None by default.
315
+
316
+ Args:
317
+ plan: The plan just found or recorded for this query.
318
+ """
319
+ return None
320
+
321
+ def _get_parameterized_sql(self) -> tuple[str, list[Any]]:
322
+ """Render the built statement for a full build or SQL inspection.
323
+
324
+ Returns:
325
+ The SQL text and its parameters.
326
+ """
327
+ return self.query.get_parameterized_sql(self._connection.sql_context)
328
+
329
+ #: Whether a plan's statement takes the LIMIT and OFFSET of the query running on it.
330
+ plan_binds_slice: ClassVar[bool] = False
331
+
332
+ def _build_query(
333
+ self, *, value_wrapper_references: RecordedValueReferences | None = None, for_execution: bool = False
334
+ ) -> CallPlanHit | RenderedStatement | None:
335
+ """Builds ``self.query`` - the one way a query of any type is built: prepared, then run on
336
+ the plan kept for it (``StatementPlans``), or built in full and kept as the plan.
337
+
338
+ Args:
339
+ value_wrapper_references: The list of an enclosing query this query, built into it (a
340
+ subquery, a CTE body, a branch of a set operation), records its value references
341
+ into - in full, with no plan of its own looked up or kept. A query that keeps no
342
+ plan records an empty reference there, so the enclosing query keeps none either.
343
+ for_execution: True when a matching plan may supply SQL and bound values for execution.
344
+ """
345
+ records_for_caller = value_wrapper_references is not None
346
+ # The conditions the build folds into JOINs are recorded from the start - preparing builds
347
+ # JOINs too (.only() across a relation). Built into another query, they record into that
348
+ # query's recording.
349
+ plan_recording = PlanRecording()
350
+ recording_token = None if records_for_caller else PlanRecording.current.set(plan_recording)
351
+ try:
352
+ QueryJoins.reset_joined_tables(self)
353
+ self._annotation_output_fields = {}
354
+ self._add_ordering_expression_aliases()
355
+ self._prepare_build()
356
+ if records_for_caller:
357
+ if not self._keeps_plan_built_into_another():
358
+ value_wrapper_references.append((UNBINDABLE_VALUE_ORIGIN, None)) # type: ignore[union-attr]
359
+ self._extension_value_wrapper_references = value_wrapper_references
360
+ self._build_statement(value_wrapper_references, records_for_caller=True)
361
+ return None
362
+ # A setting written into the SQL text as it is (a sample's percent and seed) keeps no plan.
363
+ description, plan = (None, None) if self._options.keeps_no_plan() else self._get_plan()
364
+ if for_execution and description is not None and plan is not None:
365
+ hit = StatementPlanRuns.bind_plan(self, plan, description.values)
366
+ if hit is not None:
367
+ self._annotation_output_fields = dict(hit.plan.annotation_output_fields)
368
+ self._statement_plan = hit.plan
369
+ return hit
370
+ value_wrapper_references = [] if description is not None else None
371
+ self._extension_value_wrapper_references = value_wrapper_references
372
+ # Described again with the origins of its values before the build changes the query - as
373
+ # a later query of the key describes itself.
374
+ origins_description = self._get_origins_description() if description is not None else None
375
+ keeps_plan = self._build_statement(value_wrapper_references, records_for_caller=False)
376
+ finally:
377
+ if recording_token is not None:
378
+ PlanRecording.current.reset(recording_token)
379
+ if description is not None and keeps_plan:
380
+ return StatementPlanRuns.record_plan(
381
+ self,
382
+ description.structure,
383
+ value_wrapper_references,
384
+ origins_description,
385
+ plan_recording=plan_recording,
386
+ result_reading=self._prepare_plan_reading(),
387
+ )
388
+ return None
389
+
390
+ def _prepare_build(self) -> None:
391
+ """Works out what both a run on a plan and a full build need - called before the plan is
392
+ looked up, so a check made here is made on a plan hit too."""
393
+
394
+ def _orders_rows(self) -> bool:
395
+ """Whether the statement orders its rows - by ``Meta.ordering`` when given no ordering."""
396
+ return False
397
+
398
+ def _add_ordering_expression_aliases(self) -> None:
399
+ """Makes each expression of ``Meta.ordering`` the query orders by an alias of its own
400
+ (``ModelBinding.ordering_expressions``) - before the query is described, so its values bind as
401
+ an alias's do."""
402
+ model_binding: ModelBinding = self._binding # type: ignore[assignment]
403
+ ordering_expressions = model_binding.ordering_expressions
404
+ if not ordering_expressions or not self._orders_rows():
405
+ return
406
+ aliases = {
407
+ name: ordering_expressions[name]
408
+ for name, _order in self._apply_default_ordering(self._orderings)
409
+ if name in ordering_expressions and name not in self._annotations
410
+ }
411
+ if aliases:
412
+ self._annotations = {**self._annotations, **aliases}
413
+ self._alias_keys = self._alias_keys | frozenset(aliases)
414
+
415
+ def _keeps_plan_built_into_another(self) -> bool:
416
+ """Whether this query, built into another one, lets that query keep a plan - it records
417
+ every value it holds.
418
+
419
+ Returns:
420
+ True when it does.
421
+ """
422
+ # The enclosing query's key holds this query's structure; whether a query correlated to it
423
+ # aliases its own table is decided by the two tables alone, in that key as well.
424
+ outer_context_token = OuterScope.current_expression_context.set(None)
425
+ try:
426
+ return StatementPlanDescriptions.query_is_plannable(self)
427
+ finally:
428
+ OuterScope.current_expression_context.reset(outer_context_token)
429
+
430
+ def _get_build_plan_description(self) -> PlanDescription | None:
431
+ """Describes the statement this query builds - the structure is the plan key, the values
432
+ are bound into the plan's statement.
433
+
434
+ Returns:
435
+ The description, None for a query that keeps no plan.
436
+ """
437
+ return None
438
+
439
+ def _describe_statement(self, built_into_another: bool) -> PlanDescription | None:
440
+ """Describes this query's statement from its class's ``plan_slots`` - generated for a class
441
+ declaring them (``QueryKeyCompiler``).
442
+
443
+ Args:
444
+ built_into_another: Whether the query is built into another one - the dialect and the
445
+ connection are that query's, and its slice is among its values.
446
+
447
+ Returns:
448
+ The description, None for a query that keeps no plan.
449
+ """
450
+ raise NotImplementedError(f"{type(self).__name__} declares no plan_slots")
451
+
452
+ def _get_plan(self) -> tuple[PlanDescription | None, StatementPlan | None]:
453
+ """The description of this query's statement and the plan kept under its key.
454
+
455
+ Returns:
456
+ ``(None, None)`` for a query that keeps no plan; the description alone for the first
457
+ query of its key.
458
+ """
459
+ description = self._get_build_plan_description()
460
+ if description is None:
461
+ return None, None
462
+ # A plan kept under the key is the answer to whether the query keeps one - except inside a
463
+ # correlated subquery, where that also depends on the enclosing query.
464
+ model_binding: ModelBinding = self._binding # type: ignore[assignment]
465
+ plan = (
466
+ StatementPlans.find(model_binding, description.structure)
467
+ if OuterScope.current_expression_context.get() is None
468
+ else None
469
+ )
470
+ if plan is None and not StatementPlanDescriptions.query_state_is_plannable(self):
471
+ return None, None
472
+ return description, plan
473
+
474
+ def _find_plan_from_description(self) -> tuple[PlanDescription | None, StatementPlan | None]:
475
+ """Find the plan when the description itself determines whether it can be used."""
476
+ description = self._get_build_plan_description()
477
+ if description is None:
478
+ return None, None
479
+ model_binding: ModelBinding = self._binding # type: ignore[assignment]
480
+ return description, StatementPlans.find(model_binding, description.structure)
481
+
482
+ def _get_origins_description(self) -> PlanDescription | None:
483
+ """This query's description with the origin of each value, made before the build."""
484
+ return PlanOrigins.describe(self._get_build_plan_description)
485
+
486
+ def _prepare_plan_reading(self) -> Any:
487
+ """The result reading metadata to store with a plan of the built query, or None."""
488
+ return None
489
+
490
+ def _build_statement(
491
+ self, value_wrapper_references: RecordedValueReferences | None, *, records_for_caller: bool
492
+ ) -> bool:
493
+ """Builds ``self.query`` in full.
494
+
495
+ Args:
496
+ value_wrapper_references: The list the value references are recorded into, None when no plan
497
+ is recorded.
498
+ records_for_caller: Whether the list is an enclosing query's - the query is built into
499
+ it.
500
+
501
+ Returns:
502
+ False when the statement built can't be kept as a plan after all.
503
+ """
504
+ raise NotImplementedError()
505
+
506
+ def _apply_ambient_scope(self) -> None:
507
+ """Resolves the tenant the query runs for and, for a query under its model's default scope,
508
+ puts that scope's filters in front of its own - replacing the ones a previous compilation
509
+ put there.
510
+
511
+ Raises:
512
+ ConfigurationError: ``Hare.init()`` hasn't run.
513
+ QueryError: The model is tenant-scoped and no tenant is active.
514
+ """
515
+ model_binding: ModelBinding = self._binding # type: ignore[assignment]
516
+ if not model_binding.basetable.get_table_name():
517
+ raise ConfigurationError(
518
+ f"Can't run a query on {self.model.__name__} - Hare.init() hasn't set up its connections yet"
519
+ )
520
+ # Resolved once per build - every JOIN and every query made from this one is scoped to
521
+ # the same tenant as its own filters.
522
+ visibility = self._visibility = self._visibility.get_for_active_tenant()
523
+ ambient_filters = RowScopes.of(model_binding).get_filters(
524
+ visibility, uses_default_scope=self._uses_default_scope
525
+ )
526
+ ambient_q_objects = [Q(**{field_name: value}) for field_name, value in ambient_filters]
527
+ provider_condition = RowScopeBinding.get_condition(self._row_scope_provider, self.model, visibility)
528
+ if provider_condition is not None:
529
+ ambient_q_objects.append(copy(provider_condition))
530
+ for ambient_q in ambient_q_objects:
531
+ ambient_q._plan_origin = self
532
+ self._ambient_conditions = tuple(ambient_q_objects)
533
+
534
+ def _make_embedded_subquery(self, value_wrapper_references: RecordedValueReferences | None) -> None:
535
+ """Build an expression or CTE body and record whether its caller can keep a plan."""
536
+ if value_wrapper_references is not None and self.plannable:
537
+ self._make_subquery(value_wrapper_references=value_wrapper_references)
538
+ else:
539
+ self._make_subquery()
540
+ if value_wrapper_references is not None:
541
+ value_wrapper_references.append((UNBINDABLE_VALUE_ORIGIN, None))
542
+
543
+ def _make_subquery(self, *, value_wrapper_references: RecordedValueReferences | None = None) -> None:
544
+ """Builds ``self.query`` to be embedded in an enclosing query; a ``.none()`` queryset
545
+ gets an always-false condition there, since it never reaches the ``_is_none`` check done
546
+ at execution time.
547
+
548
+ Args:
549
+ value_wrapper_references: The enclosing statement's recorded value references, if supplied.
550
+ """
551
+ self._make_query(value_wrapper_references=value_wrapper_references)
552
+ self._apply_none_as_subquery()
553
+
554
+ def _apply_none_as_subquery(self) -> None:
555
+ if self._is_none:
556
+ self.query = self.query.where(BasicCriterion.always_false())
@@ -0,0 +1 @@
1
+ from __future__ import annotations