pycraftcore 5.1.0__tar.gz → 5.2.0__tar.gz

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 (241) hide show
  1. {pycraftcore-5.1.0/src/pycraftcore.egg-info → pycraftcore-5.2.0}/PKG-INFO +49 -13
  2. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/Readme.md +47 -12
  3. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/pyproject.toml +2 -2
  4. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/repository/adapter/__init__.py +14 -1
  5. pycraftcore-5.2.0/src/pycraftcore/repository/adapter/sql/sqlalchemy/__init__.py +17 -0
  6. pycraftcore-5.2.0/src/pycraftcore/repository/adapter/sql/sqlalchemy/adapter.py +21 -0
  7. pycraftcore-5.2.0/src/pycraftcore/repository/adapter/sql/sqlalchemy/engine_builder.py +8 -0
  8. pycraftcore-5.2.0/src/pycraftcore/repository/adapter/sql/sqlalchemy/factory.py +33 -0
  9. pycraftcore-5.2.0/src/pycraftcore/repository/adapter/sql/sqlalchemy/postgresql_engine_builder.py +29 -0
  10. pycraftcore-5.2.0/src/pycraftcore/repository/adapter/sql/sqlalchemy/sqlite_engine_builder.py +34 -0
  11. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/repository/adapter/sql/sqlite/__init__.py +2 -0
  12. pycraftcore-5.2.0/src/pycraftcore/repository/adapter/sql/sqlite/database_file.py +18 -0
  13. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/repository/adapter/sql/sqlite/factory.py +5 -22
  14. pycraftcore-5.2.0/src/pycraftcore/repository/adapter/sql/sqlite/pragmas.py +5 -0
  15. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/repository/port/repository.py +0 -2
  16. {pycraftcore-5.1.0 → pycraftcore-5.2.0/src/pycraftcore.egg-info}/PKG-INFO +49 -13
  17. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore.egg-info/SOURCES.txt +8 -0
  18. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore.egg-info/requires.txt +1 -0
  19. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/LICENSE +0 -0
  20. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/setup.cfg +0 -0
  21. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/__init__.py +0 -0
  22. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/application_configuration/__init__.py +0 -0
  23. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/application_configuration/adapter/__init__.py +0 -0
  24. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/application_configuration/adapter/load_application_configuration.py +0 -0
  25. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/application_configuration/adapter/omega_configuration_reader.py +0 -0
  26. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/application_configuration/adapter/schema.py +0 -0
  27. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/application_configuration/enum/__init__.py +0 -0
  28. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/application_configuration/enum/connector_type.py +0 -0
  29. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/application_configuration/enum/file_operation_action.py +0 -0
  30. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/application_configuration/enum/operation_type.py +0 -0
  31. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/application_configuration/enum/run_type_application.py +0 -0
  32. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/application_configuration/enum/run_type_environment.py +0 -0
  33. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/application_configuration/enum/server_type.py +0 -0
  34. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/application_configuration/model/__init__.py +0 -0
  35. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/application_configuration/model/configuration.py +0 -0
  36. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/application_configuration/model/connector.py +0 -0
  37. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/application_configuration/model/operation.py +0 -0
  38. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/application_configuration/model/server.py +0 -0
  39. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/application_configuration/port/__init__.py +0 -0
  40. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/application_configuration/port/configuration.py +0 -0
  41. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/application_configuration/port/configuration_reader.py +0 -0
  42. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/authentication/__init__.py +0 -0
  43. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/authentication/model/__init__.py +0 -0
  44. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/authentication/model/auth_type.py +0 -0
  45. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/authentication/model/basic_auth.py +0 -0
  46. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/authentication/model/no_auth.py +0 -0
  47. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/authentication/model/token_auth.py +0 -0
  48. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/circuit_breaker/__init__.py +0 -0
  49. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/circuit_breaker/adapter/__init__.py +0 -0
  50. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/circuit_breaker/adapter/aiobreaker_circuit_breaker_policy.py +0 -0
  51. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/circuit_breaker/configuration/__init__.py +0 -0
  52. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/circuit_breaker/configuration/circuit_breaker_configuration.py +0 -0
  53. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/circuit_breaker/enum/__init__.py +0 -0
  54. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/circuit_breaker/enum/circuit_breaker_status.py +0 -0
  55. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/circuit_breaker/exception/__init__.py +0 -0
  56. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/circuit_breaker/exception/circuit_breaker_open_exception.py +0 -0
  57. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/circuit_breaker/port/__init__.py +0 -0
  58. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/circuit_breaker/port/async_circuit_breaker.py +0 -0
  59. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/computation_engine/__init__.py +0 -0
  60. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/computation_engine/adapter/__init__.py +0 -0
  61. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/computation_engine/adapter/compute_engine.py +0 -0
  62. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/computation_engine/adapter/numpy_arithmetic_operation.py +0 -0
  63. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/computation_engine/adapter/scipy_calculus_operation.py +0 -0
  64. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/computation_engine/const_typing.py +0 -0
  65. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/computation_engine/port/__init__.py +0 -0
  66. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/computation_engine/port/arithmetic_operation.py +0 -0
  67. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/computation_engine/port/calculus_operation.py +0 -0
  68. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/computation_engine/port/engine.py +0 -0
  69. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/context/__init__.py +0 -0
  70. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/context/request_id_context.py +0 -0
  71. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/__init__.py +0 -0
  72. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/__init__.py +0 -0
  73. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/extension/__init__.py +0 -0
  74. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/extension/csv/__init__.py +0 -0
  75. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/extension/csv/csv_reader.py +0 -0
  76. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/extension/csv/csv_writer.py +0 -0
  77. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/extension/json/__init__.py +0 -0
  78. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/extension/json/json_reader.py +0 -0
  79. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/extension/json/json_writer.py +0 -0
  80. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/extension/markdown/__init__.py +0 -0
  81. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/extension/markdown/markdown_reader.py +0 -0
  82. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/extension/markdown/markdown_writer.py +0 -0
  83. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/extension/svg/__init__.py +0 -0
  84. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/extension/svg/svg_reader.py +0 -0
  85. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/extension/svg/svg_writer.py +0 -0
  86. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/extension/txt/__init__.py +0 -0
  87. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/extension/txt/txt_reader.py +0 -0
  88. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/extension/txt/txt_writer.py +0 -0
  89. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/extension/yml/__init__.py +0 -0
  90. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/extension/yml/yml_reader.py +0 -0
  91. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/extension/yml/yml_writer.py +0 -0
  92. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/factory.py +0 -0
  93. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/handler.py +0 -0
  94. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/provider.py +0 -0
  95. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/adapter/strategy.py +0 -0
  96. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/enum/__init__.py +0 -0
  97. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/enum/read_chunk_mode.py +0 -0
  98. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/port/__init__.py +0 -0
  99. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/port/file_handler_factory.py +0 -0
  100. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/port/file_handler_provider.py +0 -0
  101. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/port/reader.py +0 -0
  102. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/port/writer.py +0 -0
  103. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/schema/__init__.py +0 -0
  104. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/file_handler/schema/file_manifest.py +0 -0
  105. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/http/__init__.py +0 -0
  106. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/http/adapter/__init__.py +0 -0
  107. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/http/adapter/aiohttp_client.py +0 -0
  108. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/http/adapter/httpx_client.py +0 -0
  109. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/http/configuration/__init__.py +0 -0
  110. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/http/configuration/client_configuration.py +0 -0
  111. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/http/configuration/http_client_configuration.py +0 -0
  112. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/http/configuration/limits_configuration.py +0 -0
  113. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/http/configuration/security_configuration.py +0 -0
  114. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/http/enum/__init__.py +0 -0
  115. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/http/enum/http_method.py +0 -0
  116. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/http/policy/__init__.py +0 -0
  117. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/http/policy/http_error_policy.py +0 -0
  118. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/http/port/__init__.py +0 -0
  119. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/http/port/async_http_client.py +0 -0
  120. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/logger/__init__.py +0 -0
  121. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/logger/adapter/__init__.py +0 -0
  122. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/logger/adapter/standard_logger.py +0 -0
  123. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/logger/configuration.py +0 -0
  124. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/logger/enum/__init__.py +0 -0
  125. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/logger/enum/log_level.py +0 -0
  126. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/logger/port/__init__.py +0 -0
  127. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/logger/port/logger.py +0 -0
  128. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/profiler/__init__.py +0 -0
  129. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/profiler/profiled.py +0 -0
  130. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/py.typed +0 -0
  131. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/query_language/__init__.py +0 -0
  132. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/query_language/adapter/__init__.py +0 -0
  133. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/query_language/adapter/sql/__init__.py +0 -0
  134. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/query_language/adapter/sql/adapter.py +0 -0
  135. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/query_language/adapter/sql/factory.py +0 -0
  136. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/query_language/constants/__init__.py +0 -0
  137. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/query_language/constants/sql/__init__.py +0 -0
  138. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/query_language/constants/sql/allowed_sql_root_statements.py +0 -0
  139. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/query_language/constants/sql/forbidden_sql_statements.py +0 -0
  140. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/query_language/port/__init__.py +0 -0
  141. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/query_language/port/query_handler.py +0 -0
  142. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/repository/__init__.py +0 -0
  143. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/repository/adapter/no_sql/__init__.py +0 -0
  144. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/repository/adapter/no_sql/mongodb/__init__.py +0 -0
  145. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/repository/adapter/no_sql/mongodb/adapter.py +0 -0
  146. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/repository/adapter/no_sql/mongodb/factory.py +0 -0
  147. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/repository/adapter/no_sql/mongodb/mapper.py +0 -0
  148. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/repository/adapter/no_sql/mongodb/schema.py +0 -0
  149. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/repository/adapter/sql/__init__.py +0 -0
  150. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/repository/adapter/sql/postgresql/__init__.py +0 -0
  151. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/repository/adapter/sql/postgresql/adapter.py +0 -0
  152. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/repository/adapter/sql/postgresql/factory.py +0 -0
  153. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/repository/adapter/sql/postgresql/mapper.py +0 -0
  154. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/repository/adapter/sql/postgresql/schema.py +0 -0
  155. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/repository/adapter/sql/sqlite/adapter.py +0 -0
  156. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/repository/adapter/sql/sqlite/mapper.py +0 -0
  157. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/repository/adapter/sql/sqlite/schema.py +0 -0
  158. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/repository/port/__init__.py +0 -0
  159. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/resilient_http/__init__.py +0 -0
  160. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/resilient_http/adapter/__init__.py +0 -0
  161. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/resilient_http/adapter/resilient_client.py +0 -0
  162. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/resilient_http/adapter/resilient_http_client_factory.py +0 -0
  163. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/resilient_http/adapter/resilient_transport.py +0 -0
  164. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/resilient_http/adapter/resilient_transport_factory.py +0 -0
  165. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/resilient_http/configuration/__init__.py +0 -0
  166. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/resilient_http/configuration/resilient_http_configuration.py +0 -0
  167. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/resilient_http/port/__init__.py +0 -0
  168. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/resilient_http/port/async_resilient_http_client.py +0 -0
  169. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/retry/__init__.py +0 -0
  170. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/retry/adapter/__init__.py +0 -0
  171. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/retry/adapter/tenacity_retry_policy.py +0 -0
  172. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/retry/configuration/__init__.py +0 -0
  173. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/retry/configuration/retry_configuration.py +0 -0
  174. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/retry/port/__init__.py +0 -0
  175. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/retry/port/retry.py +0 -0
  176. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/runtime/__init__.py +0 -0
  177. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/runtime/adapter/__init__.py +0 -0
  178. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/runtime/adapter/python/__init__.py +0 -0
  179. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/runtime/adapter/python/adapter.py +0 -0
  180. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/runtime/adapter/python/factory.py +0 -0
  181. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/runtime/adapter/python/host_bridge_server.py +0 -0
  182. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/runtime/adapter/python/python_runner_template.py +0 -0
  183. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/runtime/port/__init__.py +0 -0
  184. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/runtime/port/code.py +0 -0
  185. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/runtime/schema/__init__.py +0 -0
  186. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/runtime/schema/code_result.py +0 -0
  187. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/runtime/schema/code_stdout.py +0 -0
  188. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/runtime/schema/host_bridge.py +0 -0
  189. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/runtime/schema/safe_code_settings.py +0 -0
  190. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/serializer/__init__.py +0 -0
  191. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/serializer/adapter/__init__.py +0 -0
  192. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/serializer/adapter/binary_serializer.py +0 -0
  193. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/serializer/adapter/dictionary_serializer.py +0 -0
  194. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/serializer/adapter/json_serializer.py +0 -0
  195. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/serializer/port/__init__.py +0 -0
  196. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/serializer/port/serializer.py +0 -0
  197. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/telemetry/__init__.py +0 -0
  198. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/telemetry/adapter/__init__.py +0 -0
  199. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/telemetry/adapter/null_telemetry.py +0 -0
  200. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/telemetry/adapter/open_telemetry.py +0 -0
  201. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/telemetry/adapter/open_telemetry_logger_provider.py +0 -0
  202. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/telemetry/adapter/open_telemetry_meter_provider.py +0 -0
  203. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/telemetry/adapter/open_telemetry_provider.py +0 -0
  204. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/telemetry/adapter/open_telemetry_tracer.py +0 -0
  205. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/telemetry/port/__init__.py +0 -0
  206. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/telemetry/port/logger_provider.py +0 -0
  207. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/telemetry/port/meter_provider.py +0 -0
  208. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/telemetry/port/telemetry.py +0 -0
  209. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/telemetry/port/trace_provider.py +0 -0
  210. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/telemetry/port/tracer.py +0 -0
  211. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web/__init__.py +0 -0
  212. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web/actuator/__init__.py +0 -0
  213. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web/actuator/actuator.py +0 -0
  214. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web/actuator/enum/__init__.py +0 -0
  215. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web/actuator/enum/health_status.py +0 -0
  216. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web/actuator/schema/__init__.py +0 -0
  217. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web/actuator/schema/actuator_response.py +0 -0
  218. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web/asgi.py +0 -0
  219. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web/middleware/__init__.py +0 -0
  220. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web/middleware/request_id_middleware.py +0 -0
  221. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web/schema/__init__.py +0 -0
  222. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web/schema/api_settings.py +0 -0
  223. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web/sse.py +0 -0
  224. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web/streaming.py +0 -0
  225. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web_blacksheep/__init__.py +0 -0
  226. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web_blacksheep/actuator_router.py +0 -0
  227. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web_blacksheep/app_factory.py +0 -0
  228. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web_blacksheep/detail_handler.py +0 -0
  229. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web_blacksheep/event_stream.py +0 -0
  230. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web_fastapi/__init__.py +0 -0
  231. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web_fastapi/actuator_router.py +0 -0
  232. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web_fastapi/app_factory.py +0 -0
  233. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web_fastapi/detail_handler.py +0 -0
  234. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web_fastapi/event_stream.py +0 -0
  235. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web_litestar/__init__.py +0 -0
  236. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web_litestar/actuator_router.py +0 -0
  237. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web_litestar/app_factory.py +0 -0
  238. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web_litestar/detail_handler.py +0 -0
  239. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore/web_litestar/event_stream.py +0 -0
  240. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore.egg-info/dependency_links.txt +0 -0
  241. {pycraftcore-5.1.0 → pycraftcore-5.2.0}/src/pycraftcore.egg-info/top_level.txt +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: pycraftcore
3
- Version: 5.1.0
3
+ Version: 5.2.0
4
4
  Summary: Provides reusable technical infrastructure and adapter implementations for Python applications
5
5
  Author-email: Toufik Saouchi <toufik.saouchi@gmail.com>
6
6
  License-Expression: MIT
@@ -82,6 +82,7 @@ Requires-Dist: aiosqlite; extra == "repository"
82
82
  Requires-Dist: pymongo; extra == "repository"
83
83
  Requires-Dist: psycopg[binary]; extra == "repository"
84
84
  Requires-Dist: psycopg-pool; extra == "repository"
85
+ Requires-Dist: sqlalchemy[asyncio]>=2; extra == "repository"
85
86
  Requires-Dist: orjson; extra == "repository"
86
87
  Requires-Dist: pydantic>=2; extra == "repository"
87
88
  Requires-Dist: pycraftcore[application_configuration,authentication]; extra == "repository"
@@ -131,7 +132,7 @@ A shared technical foundation for Python services: configuration, logging, telem
131
132
  │ set up application_configuration · logger · telemetry · context │
132
133
  │ talk out http · resilient_http (retry + circuit_breaker) │
133
134
  │ serve web: ASGI APIs on Litestar, FastAPI or BlackSheep │
134
- │ store repository: SQLite · PostgreSQL · MongoDB │
135
+ │ store repository: SQLite · PostgreSQL · MongoDB · SQLAlchemy │
135
136
  │ run safely query_language (read-only SQL) · runtime (Python sandbox) │
136
137
  │ utilities file_handler · serializer · computation_engine · profiler │
137
138
  │ … new modules, same port + adapter shape │
@@ -172,11 +173,11 @@ A bare `pycraftcore` installs no third-party packages: only `authentication`, `c
172
173
  | `application_configuration` | omegaconf, pydantic, python-dotenv | `http`, `logger`, `authentication` |
173
174
  | `telemetry` | opentelemetry (api, sdk, otlp exporter, logging instrumentation) | `application_configuration`, `context` |
174
175
  | `resilient_http` | aiohttp, httpx | `circuit_breaker`, `http`, `retry`, `telemetry` |
175
- | `repository` | aiosqlite, pymongo, psycopg, psycopg-pool, orjson, pydantic | `application_configuration`, `authentication` |
176
+ | `repository` | aiosqlite, pymongo, psycopg, psycopg-pool, sqlalchemy, orjson, pydantic | `application_configuration`, `authentication` |
176
177
 
177
178
  List every module your code imports, even when one extra already brings in another. That way your service stays correct if these links change. For the Python sandbox, use `runtime-sandbox` rather than `runtime`: the sandboxed code runs on your service's interpreter, so the libraries it may import (pandas, numpy, matplotlib, dateutil) must be installed there.
178
179
 
179
- Development builds (tags on `develop`, such as `5.1.0rc1`) are published to TestPyPI; use them for testing only. Their dependencies come from PyPI, so add it as an extra index, and name the version, since pip skips pre-releases otherwise:
180
+ Development builds (tags on `develop`, such as `v5.1.0-rc.1`, published as `5.1.0rc1`) are published to TestPyPI; use them for testing only. Their dependencies come from PyPI, so add it as an extra index, and name the version, since pip skips pre-releases otherwise:
180
181
 
181
182
  ```bash
182
183
  pip install -i https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ "pycraftcore[http]==5.1.0rc1"
@@ -198,7 +199,7 @@ Each module stands on its own: use the ones you need. The modules today (new one
198
199
  | `web_litestar`, `web_fastapi`, `web_blacksheep` | One toolkit per framework: build the app with pycraftcore's conventions and write your routes with the framework's own features |
199
200
  | `resilient_http` | An HTTP transport with retries and a circuit breaker built in |
200
201
  | `retry`, `circuit_breaker` | The two policies on their own, for any async call |
201
- | `repository` | Async repositories built from a database connector — today SQLite (pooled), PostgreSQL and MongoDB |
202
+ | `repository` | Async repositories built from a database connector — today SQLite (pooled), PostgreSQL, MongoDB, and SQLAlchemy (PostgreSQL or SQLite, for libraries that need an engine) |
202
203
  | `query_language` | Checks that a SQL statement is read-only, and translates between dialects, before it reaches a database |
203
204
  | `runtime` | Runs untrusted Python in a separate process with memory, time and module limits; optionally lets it call your functions |
204
205
  | `file_handler` | Read and write files by extension (today csv, json, yml, md, txt, svg); a new format is a new reader/writer pair |
@@ -447,6 +448,40 @@ await factory.disconnect()
447
448
 
448
449
  `PostgresRepositoryFactory` / `PostgresSettingsMapper` and `MongoRepositoryFactory` / `MongoSettingsMapper` work the same way, and so will any database added later: a factory, a settings mapper and a repository behind the same `AsyncRepository` port.
449
450
 
451
+ Every factory has three methods: `connect()` gives the `AsyncRepository`, `connection()` gives the driver's own client, and `disconnect()` closes both. Use `connection()` to hand the database to a library that brings its own code, such as LangGraph's checkpointers (`MongoClient`, an aiosqlite connection).
452
+
453
+ #### SQLAlchemy
454
+
455
+ For a library that asks for a SQLAlchemy engine, `SqlAlchemyRepositoryFactory` manages one: it builds it once, checks it answers, and disposes of it. How the engine is built is injected, as an engine builder made from the existing PostgreSQL or SQLite settings, so the factory never knows which database it's on:
456
+
457
+ ```python
458
+ from pycraftcore.repository.adapter import (
459
+ PostgresEngineBuilder,
460
+ PostgresSettingsMapper,
461
+ SqlAlchemyRepositoryFactory,
462
+ SqliteEngineBuilder,
463
+ SqliteSettingsMapper,
464
+ )
465
+
466
+ postgres = PostgresEngineBuilder(PostgresSettingsMapper(config.connector.database("tasks"))())
467
+ sqlite = SqliteEngineBuilder(SqliteSettingsMapper(config.connector.database("tasks_fallback"))())
468
+
469
+ factory = SqlAlchemyRepositoryFactory(postgres) # or sqlite: same factory
470
+ await factory.ping() # raises when the database can't be reached
471
+ engine = await factory.connection() # an AsyncEngine, for the library
472
+ await factory.disconnect() # disposes the engine
473
+ ```
474
+
475
+ | Builder | Settings | Engine |
476
+ |---|---|---|
477
+ | `PostgresEngineBuilder` | `PostgresConnector` | `postgresql+psycopg`, a pool of `pool.max` connections checked before use (`pool_pre_ping`), so a database restart doesn't leave dead connections |
478
+ | `SqliteEngineBuilder` | `SqliteConnector` | `sqlite+aiosqlite` on the file `SqliteDatabaseFile` prepares (`<host>/<default_name>.db`, folder created); every connection it opens gets the same PRAGMAs as `SqliteRepositoryFactory` (WAL, a 5-second busy timeout, `synchronous=NORMAL`) |
479
+
480
+ - Both builders use the drivers the other adapters use, so there's no other driver to install.
481
+ - Another database is another class with a `build() -> AsyncEngine` method (the `SqlAlchemyEngineBuilder` protocol); the factory doesn't change.
482
+ - `connect()` also gives an `AsyncRepository`. Its `execute(query, parameters)` takes the driver's own placeholders, as the other SQL adapters do: `%s` for PostgreSQL, `?` for SQLite. Each call runs in its own transaction.
483
+ - The factory builds the engine and nothing else: tables belong to the code that owns them, through its own models or migrations.
484
+
450
485
  ### Read-only SQL
451
486
 
452
487
  ```python
@@ -544,7 +579,7 @@ Every push and pull request runs the checks; only a tag publishes, and the branc
544
579
  ```text
545
580
  feature/… ──PR──► develop ──PR──► main
546
581
  │ │
547
- tag vX.Y.ZrcN tag vX.Y.Z
582
+ tag vX.Y.Z-rc.N tag vX.Y.Z
548
583
  ▼ ▼
549
584
  TestPyPI PyPI
550
585
  ```
@@ -553,12 +588,13 @@ Every push and pull request runs the checks; only a tag publishes, and the branc
553
588
  |---|---|---|
554
589
  | Pull request to `develop` or `main` | LINT, TYPECHECK, TEST, EXTRAS, BUILD | nothing |
555
590
  | Push to `develop` or `main` | the same | nothing |
556
- | Tag `v…` on a commit of `main` | the same + RELEASE TARGET + PUBLISH | PyPI |
557
- | Tag `v…` on a commit of `develop` only | the same + RELEASE TARGET + PUBLISH | TestPyPI |
558
- | Tag on neither | RELEASE TARGET fails | nothing |
591
+ | Tag `vX.Y.Z-rc.N` on a commit only on `develop` | the same + RELEASE TARGET + PUBLISH | TestPyPI |
592
+ | Tag `vX.Y.Z` on a commit of `main` | the same + RELEASE TARGET + PUBLISH | PyPI |
593
+ | Tag on neither branch, a pre-release on `main`, a final version only on `develop` | RELEASE TARGET fails | nothing |
559
594
 
560
- - The tag is the version: `v5.1.0` builds `5.1.0` and `v5.1.0rc1` builds `5.1.0rc1`, whatever `pyproject.toml` says (the run notes it when they differ). Keep `pyproject.toml` on the next version anyway, for local builds.
561
- - A tag name is used once, so tags on `develop` are pre-releases (`vX.Y.ZrcN`, `vX.Y.Z.devN`) and the final `vX.Y.Z` goes on `main`. PyPI and TestPyPI both refuse a version they already have.
595
+ - The tag is the version: `v5.1.0` builds `5.1.0` and `v5.1.0-rc.1` builds `5.1.0rc1` (the Python spelling), whatever `pyproject.toml` says (the run notes it when they differ). Keep `pyproject.toml` on the next version anyway, for local builds.
596
+ - A tag name is used once, so tags on `develop` are pre-releases (`vX.Y.Z-rc.N`) and the final `vX.Y.Z` goes on `main`. PyPI and TestPyPI both refuse a version they already have.
597
+ - RELEASE TARGET is the same job in every repository with this pipeline (agent-runtime, agent-toolbox, homelab-ui, pricelab): only what a channel publishes differs.
562
598
  - A commit on both branches (after `main` is merged back into `develop`) counts as `main`.
563
599
  - PUBLISH runs in the `production` environment, with `TEST_PYPI_TOKEN`, `RELEASE_PYPI_TOKEN` and the `TEST_PYPI_URL` variable.
564
600
 
@@ -566,8 +602,8 @@ Try a version on TestPyPI:
566
602
 
567
603
  ```bash
568
604
  git switch develop && git pull
569
- git tag v5.1.0rc1
570
- git push origin v5.1.0rc1
605
+ git tag v5.1.0-rc.1
606
+ git push origin v5.1.0-rc.1
571
607
  ```
572
608
 
573
609
  Release it:
@@ -14,7 +14,7 @@ A shared technical foundation for Python services: configuration, logging, telem
14
14
  │ set up application_configuration · logger · telemetry · context │
15
15
  │ talk out http · resilient_http (retry + circuit_breaker) │
16
16
  │ serve web: ASGI APIs on Litestar, FastAPI or BlackSheep │
17
- │ store repository: SQLite · PostgreSQL · MongoDB │
17
+ │ store repository: SQLite · PostgreSQL · MongoDB · SQLAlchemy │
18
18
  │ run safely query_language (read-only SQL) · runtime (Python sandbox) │
19
19
  │ utilities file_handler · serializer · computation_engine · profiler │
20
20
  │ … new modules, same port + adapter shape │
@@ -55,11 +55,11 @@ A bare `pycraftcore` installs no third-party packages: only `authentication`, `c
55
55
  | `application_configuration` | omegaconf, pydantic, python-dotenv | `http`, `logger`, `authentication` |
56
56
  | `telemetry` | opentelemetry (api, sdk, otlp exporter, logging instrumentation) | `application_configuration`, `context` |
57
57
  | `resilient_http` | aiohttp, httpx | `circuit_breaker`, `http`, `retry`, `telemetry` |
58
- | `repository` | aiosqlite, pymongo, psycopg, psycopg-pool, orjson, pydantic | `application_configuration`, `authentication` |
58
+ | `repository` | aiosqlite, pymongo, psycopg, psycopg-pool, sqlalchemy, orjson, pydantic | `application_configuration`, `authentication` |
59
59
 
60
60
  List every module your code imports, even when one extra already brings in another. That way your service stays correct if these links change. For the Python sandbox, use `runtime-sandbox` rather than `runtime`: the sandboxed code runs on your service's interpreter, so the libraries it may import (pandas, numpy, matplotlib, dateutil) must be installed there.
61
61
 
62
- Development builds (tags on `develop`, such as `5.1.0rc1`) are published to TestPyPI; use them for testing only. Their dependencies come from PyPI, so add it as an extra index, and name the version, since pip skips pre-releases otherwise:
62
+ Development builds (tags on `develop`, such as `v5.1.0-rc.1`, published as `5.1.0rc1`) are published to TestPyPI; use them for testing only. Their dependencies come from PyPI, so add it as an extra index, and name the version, since pip skips pre-releases otherwise:
63
63
 
64
64
  ```bash
65
65
  pip install -i https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ "pycraftcore[http]==5.1.0rc1"
@@ -81,7 +81,7 @@ Each module stands on its own: use the ones you need. The modules today (new one
81
81
  | `web_litestar`, `web_fastapi`, `web_blacksheep` | One toolkit per framework: build the app with pycraftcore's conventions and write your routes with the framework's own features |
82
82
  | `resilient_http` | An HTTP transport with retries and a circuit breaker built in |
83
83
  | `retry`, `circuit_breaker` | The two policies on their own, for any async call |
84
- | `repository` | Async repositories built from a database connector — today SQLite (pooled), PostgreSQL and MongoDB |
84
+ | `repository` | Async repositories built from a database connector — today SQLite (pooled), PostgreSQL, MongoDB, and SQLAlchemy (PostgreSQL or SQLite, for libraries that need an engine) |
85
85
  | `query_language` | Checks that a SQL statement is read-only, and translates between dialects, before it reaches a database |
86
86
  | `runtime` | Runs untrusted Python in a separate process with memory, time and module limits; optionally lets it call your functions |
87
87
  | `file_handler` | Read and write files by extension (today csv, json, yml, md, txt, svg); a new format is a new reader/writer pair |
@@ -330,6 +330,40 @@ await factory.disconnect()
330
330
 
331
331
  `PostgresRepositoryFactory` / `PostgresSettingsMapper` and `MongoRepositoryFactory` / `MongoSettingsMapper` work the same way, and so will any database added later: a factory, a settings mapper and a repository behind the same `AsyncRepository` port.
332
332
 
333
+ Every factory has three methods: `connect()` gives the `AsyncRepository`, `connection()` gives the driver's own client, and `disconnect()` closes both. Use `connection()` to hand the database to a library that brings its own code, such as LangGraph's checkpointers (`MongoClient`, an aiosqlite connection).
334
+
335
+ #### SQLAlchemy
336
+
337
+ For a library that asks for a SQLAlchemy engine, `SqlAlchemyRepositoryFactory` manages one: it builds it once, checks it answers, and disposes of it. How the engine is built is injected, as an engine builder made from the existing PostgreSQL or SQLite settings, so the factory never knows which database it's on:
338
+
339
+ ```python
340
+ from pycraftcore.repository.adapter import (
341
+ PostgresEngineBuilder,
342
+ PostgresSettingsMapper,
343
+ SqlAlchemyRepositoryFactory,
344
+ SqliteEngineBuilder,
345
+ SqliteSettingsMapper,
346
+ )
347
+
348
+ postgres = PostgresEngineBuilder(PostgresSettingsMapper(config.connector.database("tasks"))())
349
+ sqlite = SqliteEngineBuilder(SqliteSettingsMapper(config.connector.database("tasks_fallback"))())
350
+
351
+ factory = SqlAlchemyRepositoryFactory(postgres) # or sqlite: same factory
352
+ await factory.ping() # raises when the database can't be reached
353
+ engine = await factory.connection() # an AsyncEngine, for the library
354
+ await factory.disconnect() # disposes the engine
355
+ ```
356
+
357
+ | Builder | Settings | Engine |
358
+ |---|---|---|
359
+ | `PostgresEngineBuilder` | `PostgresConnector` | `postgresql+psycopg`, a pool of `pool.max` connections checked before use (`pool_pre_ping`), so a database restart doesn't leave dead connections |
360
+ | `SqliteEngineBuilder` | `SqliteConnector` | `sqlite+aiosqlite` on the file `SqliteDatabaseFile` prepares (`<host>/<default_name>.db`, folder created); every connection it opens gets the same PRAGMAs as `SqliteRepositoryFactory` (WAL, a 5-second busy timeout, `synchronous=NORMAL`) |
361
+
362
+ - Both builders use the drivers the other adapters use, so there's no other driver to install.
363
+ - Another database is another class with a `build() -> AsyncEngine` method (the `SqlAlchemyEngineBuilder` protocol); the factory doesn't change.
364
+ - `connect()` also gives an `AsyncRepository`. Its `execute(query, parameters)` takes the driver's own placeholders, as the other SQL adapters do: `%s` for PostgreSQL, `?` for SQLite. Each call runs in its own transaction.
365
+ - The factory builds the engine and nothing else: tables belong to the code that owns them, through its own models or migrations.
366
+
333
367
  ### Read-only SQL
334
368
 
335
369
  ```python
@@ -427,7 +461,7 @@ Every push and pull request runs the checks; only a tag publishes, and the branc
427
461
  ```text
428
462
  feature/… ──PR──► develop ──PR──► main
429
463
  │ │
430
- tag vX.Y.ZrcN tag vX.Y.Z
464
+ tag vX.Y.Z-rc.N tag vX.Y.Z
431
465
  ▼ ▼
432
466
  TestPyPI PyPI
433
467
  ```
@@ -436,12 +470,13 @@ Every push and pull request runs the checks; only a tag publishes, and the branc
436
470
  |---|---|---|
437
471
  | Pull request to `develop` or `main` | LINT, TYPECHECK, TEST, EXTRAS, BUILD | nothing |
438
472
  | Push to `develop` or `main` | the same | nothing |
439
- | Tag `v…` on a commit of `main` | the same + RELEASE TARGET + PUBLISH | PyPI |
440
- | Tag `v…` on a commit of `develop` only | the same + RELEASE TARGET + PUBLISH | TestPyPI |
441
- | Tag on neither | RELEASE TARGET fails | nothing |
473
+ | Tag `vX.Y.Z-rc.N` on a commit only on `develop` | the same + RELEASE TARGET + PUBLISH | TestPyPI |
474
+ | Tag `vX.Y.Z` on a commit of `main` | the same + RELEASE TARGET + PUBLISH | PyPI |
475
+ | Tag on neither branch, a pre-release on `main`, a final version only on `develop` | RELEASE TARGET fails | nothing |
442
476
 
443
- - The tag is the version: `v5.1.0` builds `5.1.0` and `v5.1.0rc1` builds `5.1.0rc1`, whatever `pyproject.toml` says (the run notes it when they differ). Keep `pyproject.toml` on the next version anyway, for local builds.
444
- - A tag name is used once, so tags on `develop` are pre-releases (`vX.Y.ZrcN`, `vX.Y.Z.devN`) and the final `vX.Y.Z` goes on `main`. PyPI and TestPyPI both refuse a version they already have.
477
+ - The tag is the version: `v5.1.0` builds `5.1.0` and `v5.1.0-rc.1` builds `5.1.0rc1` (the Python spelling), whatever `pyproject.toml` says (the run notes it when they differ). Keep `pyproject.toml` on the next version anyway, for local builds.
478
+ - A tag name is used once, so tags on `develop` are pre-releases (`vX.Y.Z-rc.N`) and the final `vX.Y.Z` goes on `main`. PyPI and TestPyPI both refuse a version they already have.
479
+ - RELEASE TARGET is the same job in every repository with this pipeline (agent-runtime, agent-toolbox, homelab-ui, pricelab): only what a channel publishes differs.
445
480
  - A commit on both branches (after `main` is merged back into `develop`) counts as `main`.
446
481
  - PUBLISH runs in the `production` environment, with `TEST_PYPI_TOKEN`, `RELEASE_PYPI_TOKEN` and the `TEST_PYPI_URL` variable.
447
482
 
@@ -449,8 +484,8 @@ Try a version on TestPyPI:
449
484
 
450
485
  ```bash
451
486
  git switch develop && git pull
452
- git tag v5.1.0rc1
453
- git push origin v5.1.0rc1
487
+ git tag v5.1.0-rc.1
488
+ git push origin v5.1.0-rc.1
454
489
  ```
455
490
 
456
491
  Release it:
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "pycraftcore"
7
- version = "5.1.0"
7
+ version = "5.2.0"
8
8
  authors = [
9
9
  { name = "Toufik Saouchi", email = "toufik.saouchi@gmail.com" },
10
10
  ]
@@ -49,7 +49,7 @@ web_blacksheep = ["blacksheep", "pycraftcore[web]"]
49
49
  resilient_http = ["aiohttp", "httpx", "pycraftcore[circuit_breaker, http, logger, retry, telemetry]"]
50
50
  application_configuration = ["omegaconf", "pydantic>=2", "python-dotenv", "pycraftcore[logger, http, authentication]"]
51
51
  telemetry = ["opentelemetry-api", "opentelemetry-sdk", "opentelemetry-exporter-otlp", "opentelemetry-instrumentation-logging", "pycraftcore[application_configuration, context]"]
52
- repository = ["aiosqlite", "pymongo", "psycopg[binary]", "psycopg-pool", "orjson", "pydantic>=2", "pycraftcore[application_configuration, authentication]"]
52
+ repository = ["aiosqlite", "pymongo", "psycopg[binary]", "psycopg-pool", "sqlalchemy[asyncio]>=2", "orjson", "pydantic>=2", "pycraftcore[application_configuration, authentication]"]
53
53
  runtime-sandbox = ["pandas", "numpy", "matplotlib", "python-dateutil", "pycraftcore[runtime]"]
54
54
 
55
55
  all = [
@@ -6,7 +6,14 @@ from pycraftcore.repository.adapter.sql.postgresql.adapter import PostgresReposi
6
6
  from pycraftcore.repository.adapter.sql.postgresql.factory import PostgresRepositoryFactory
7
7
  from pycraftcore.repository.adapter.sql.postgresql.mapper import PostgresSettingsMapper
8
8
  from pycraftcore.repository.adapter.sql.postgresql.schema import PostgresConnector
9
- from pycraftcore.repository.adapter.sql.sqlite import SqliteConnector
9
+ from pycraftcore.repository.adapter.sql.sqlalchemy import (
10
+ PostgresEngineBuilder,
11
+ SqlAlchemyEngineBuilder,
12
+ SqlAlchemyRepository,
13
+ SqlAlchemyRepositoryFactory,
14
+ SqliteEngineBuilder,
15
+ )
16
+ from pycraftcore.repository.adapter.sql.sqlite import SqliteConnector, SqliteDatabaseFile
10
17
  from pycraftcore.repository.adapter.sql.sqlite.factory import SqliteRepositoryFactory
11
18
  from pycraftcore.repository.adapter.sql.sqlite.adapter import SqliteRepository
12
19
  from pycraftcore.repository.adapter.sql.sqlite.mapper import SqliteSettingsMapper
@@ -15,6 +22,7 @@ from pycraftcore.repository.adapter.sql.sqlite.mapper import SqliteSettingsMappe
15
22
  __all__ = [
16
23
  "SqliteRepositoryFactory",
17
24
  "SqliteConnector",
25
+ "SqliteDatabaseFile",
18
26
  "SqliteRepository",
19
27
  "SqliteSettingsMapper",
20
28
  "MongoRepositoryFactory",
@@ -25,4 +33,9 @@ __all__ = [
25
33
  "PostgresConnector",
26
34
  "PostgresRepository",
27
35
  "PostgresSettingsMapper",
36
+ "SqlAlchemyRepositoryFactory",
37
+ "SqlAlchemyEngineBuilder",
38
+ "SqlAlchemyRepository",
39
+ "PostgresEngineBuilder",
40
+ "SqliteEngineBuilder",
28
41
  ]
@@ -0,0 +1,17 @@
1
+ from pycraftcore.repository.adapter.sql.sqlalchemy.adapter import SqlAlchemyRepository
2
+ from pycraftcore.repository.adapter.sql.sqlalchemy.engine_builder import SqlAlchemyEngineBuilder
3
+ from pycraftcore.repository.adapter.sql.sqlalchemy.factory import SqlAlchemyRepositoryFactory
4
+ from pycraftcore.repository.adapter.sql.sqlalchemy.postgresql_engine_builder import (
5
+ PostgresEngineBuilder,
6
+ )
7
+ from pycraftcore.repository.adapter.sql.sqlalchemy.sqlite_engine_builder import (
8
+ SqliteEngineBuilder,
9
+ )
10
+
11
+ __all__ = [
12
+ "PostgresEngineBuilder",
13
+ "SqliteEngineBuilder",
14
+ "SqlAlchemyEngineBuilder",
15
+ "SqlAlchemyRepository",
16
+ "SqlAlchemyRepositoryFactory",
17
+ ]
@@ -0,0 +1,21 @@
1
+ from typing import Any
2
+
3
+ from sqlalchemy.ext.asyncio import AsyncEngine
4
+
5
+
6
+ class SqlAlchemyRepository:
7
+ def __init__(self, engine: AsyncEngine) -> None:
8
+ self._engine = engine
9
+
10
+ async def execute(
11
+ self,
12
+ query: str,
13
+ parameters: tuple[Any, ...] = (),
14
+ ) -> list[dict[str, Any]]:
15
+ async with self._engine.begin() as connection:
16
+ result = await connection.exec_driver_sql(query, parameters)
17
+
18
+ if not result.returns_rows:
19
+ return []
20
+
21
+ return [dict(row) for row in result.mappings().all()]
@@ -0,0 +1,8 @@
1
+ from typing import Protocol, runtime_checkable
2
+
3
+ from sqlalchemy.ext.asyncio import AsyncEngine
4
+
5
+
6
+ @runtime_checkable
7
+ class SqlAlchemyEngineBuilder(Protocol):
8
+ def build(self) -> AsyncEngine: ...
@@ -0,0 +1,33 @@
1
+ from sqlalchemy.ext.asyncio import AsyncEngine
2
+
3
+ from pycraftcore.repository.adapter.sql.sqlalchemy.adapter import SqlAlchemyRepository
4
+ from pycraftcore.repository.adapter.sql.sqlalchemy.engine_builder import SqlAlchemyEngineBuilder
5
+ from pycraftcore.repository.port.repository import AsyncRepository
6
+
7
+
8
+ class SqlAlchemyRepositoryFactory:
9
+ def __init__(self, builder: SqlAlchemyEngineBuilder) -> None:
10
+ self._builder = builder
11
+ self._engine: AsyncEngine | None = None
12
+ self._repository: AsyncRepository | None = None
13
+
14
+ async def connection(self) -> AsyncEngine:
15
+ if self._engine is None:
16
+ self._engine = self._builder.build()
17
+ return self._engine
18
+
19
+ async def connect(self) -> AsyncRepository:
20
+ if self._repository is None:
21
+ self._repository = SqlAlchemyRepository(await self.connection())
22
+ return self._repository
23
+
24
+ async def disconnect(self) -> None:
25
+ if self._engine is not None:
26
+ await self._engine.dispose()
27
+ self._engine = None
28
+ self._repository = None
29
+
30
+ async def ping(self) -> None:
31
+ engine = await self.connection()
32
+ async with engine.connect() as connection:
33
+ await connection.exec_driver_sql("SELECT 1")
@@ -0,0 +1,29 @@
1
+ from sqlalchemy import URL
2
+ from sqlalchemy.ext.asyncio import AsyncEngine, create_async_engine
3
+
4
+ from pycraftcore.repository.adapter.sql.postgresql.schema import PostgresConnector
5
+
6
+ DRIVER: str = "postgresql+psycopg"
7
+
8
+
9
+ class PostgresEngineBuilder:
10
+ def __init__(self, settings: PostgresConnector) -> None:
11
+ self._settings = settings
12
+
13
+ def build(self) -> AsyncEngine:
14
+ return create_async_engine(
15
+ self._url(),
16
+ pool_size=self._settings.max_pool_size,
17
+ max_overflow=0,
18
+ pool_pre_ping=True,
19
+ )
20
+
21
+ def _url(self) -> URL:
22
+ return URL.create(
23
+ DRIVER,
24
+ username=self._settings.user,
25
+ password=self._settings.password,
26
+ host=self._settings.host,
27
+ port=self._settings.port,
28
+ database=self._settings.default_name,
29
+ )
@@ -0,0 +1,34 @@
1
+ from typing import Any
2
+
3
+ from sqlalchemy import URL, event
4
+ from sqlalchemy.ext.asyncio import AsyncEngine, create_async_engine
5
+
6
+ from pycraftcore.repository.adapter.sql.sqlite.database_file import SqliteDatabaseFile
7
+ from pycraftcore.repository.adapter.sql.sqlite.pragmas import SQLITE_PRAGMAS
8
+ from pycraftcore.repository.adapter.sql.sqlite.schema import SqliteConnector
9
+
10
+ DRIVER: str = "sqlite+aiosqlite"
11
+
12
+
13
+ class SqliteEngineBuilder:
14
+ def __init__(self, settings: SqliteConnector) -> None:
15
+ self._settings = settings
16
+ self._file = SqliteDatabaseFile(settings.path, settings.default_name)
17
+
18
+ def build(self) -> AsyncEngine:
19
+ engine = create_async_engine(
20
+ URL.create(DRIVER, database=str(self._file.prepare())),
21
+ pool_size=self._settings.max_pool_size,
22
+ max_overflow=0,
23
+ )
24
+ event.listen(engine.sync_engine, "connect", _apply_pragmas)
25
+ return engine
26
+
27
+
28
+ def _apply_pragmas(dbapi_connection: Any, _record: Any) -> None:
29
+ cursor = dbapi_connection.cursor()
30
+ try:
31
+ for pragma in SQLITE_PRAGMAS:
32
+ cursor.execute(pragma)
33
+ finally:
34
+ cursor.close()
@@ -1,10 +1,12 @@
1
1
  from pycraftcore.repository.adapter.sql.sqlite.adapter import SqliteRepository
2
+ from pycraftcore.repository.adapter.sql.sqlite.database_file import SqliteDatabaseFile
2
3
  from pycraftcore.repository.adapter.sql.sqlite.factory import SqliteRepositoryFactory
3
4
  from pycraftcore.repository.adapter.sql.sqlite.mapper import SqliteSettingsMapper
4
5
  from pycraftcore.repository.adapter.sql.sqlite.schema import SqliteConnector
5
6
 
6
7
  __all__ = [
7
8
  "SqliteRepositoryFactory",
9
+ "SqliteDatabaseFile",
8
10
  "SqliteConnector",
9
11
  "SqliteRepository",
10
12
  "SqliteSettingsMapper",
@@ -0,0 +1,18 @@
1
+ from dataclasses import dataclass
2
+ from pathlib import Path
3
+
4
+ DATABASE_SUFFIX: str = ".db"
5
+
6
+
7
+ @dataclass(frozen=True, slots=True)
8
+ class SqliteDatabaseFile:
9
+ directory: str
10
+ name: str
11
+
12
+ @property
13
+ def path(self) -> Path:
14
+ return Path(self.directory) / f"{self.name}{DATABASE_SUFFIX}"
15
+
16
+ def prepare(self) -> Path:
17
+ self.path.parent.mkdir(parents=True, exist_ok=True)
18
+ return self.path
@@ -1,29 +1,24 @@
1
- from pathlib import Path
2
1
  from sqlite3 import Row
3
2
 
4
3
  from aiosqlite import Connection, connect
5
4
 
6
5
  from pycraftcore.repository.port.repository import AsyncRepository
7
6
  from pycraftcore.repository.adapter.sql.sqlite import SqliteRepository
7
+ from pycraftcore.repository.adapter.sql.sqlite.database_file import SqliteDatabaseFile
8
+ from pycraftcore.repository.adapter.sql.sqlite.pragmas import SQLITE_PRAGMAS
8
9
  from pycraftcore.repository.adapter.sql.sqlite.schema import SqliteConnector
9
10
 
10
- _PRAGMAS: tuple[str, ...] = (
11
- "PRAGMA journal_mode=WAL",
12
- "PRAGMA busy_timeout=5000",
13
- "PRAGMA synchronous=NORMAL",
14
- )
15
-
16
11
 
17
12
  class SqliteRepositoryFactory:
18
13
  def __init__(self, settings: SqliteConnector):
19
14
  self._settings = settings
15
+ self._file = SqliteDatabaseFile(settings.path, settings.default_name)
20
16
  self._client: Connection | None = None
21
17
  self._pool: list[Connection] | None = None
22
18
  self._repository: AsyncRepository | None = None
23
19
 
24
20
  async def connection(self) -> Connection:
25
21
  if self._client is None:
26
- self._create_repository_directory(self._settings.path)
27
22
  self._client = await self._open_connection()
28
23
 
29
24
  return self._client
@@ -33,7 +28,6 @@ class SqliteRepositoryFactory:
33
28
  if self._repository is not None:
34
29
  return self._repository
35
30
 
36
- self._create_repository_directory(self._settings.path)
37
31
  self._pool = [await self._open_connection() for _ in range(self._settings.max_pool_size)]
38
32
  self._repository = SqliteRepository(self._pool)
39
33
  return self._repository
@@ -50,21 +44,10 @@ class SqliteRepositoryFactory:
50
44
  self._repository = None
51
45
 
52
46
  async def _open_connection(self) -> Connection:
53
- client = await connect(
54
- self._set_repository_file(self._settings.path, self._settings.default_name)
55
- )
47
+ client = await connect(str(self._file.prepare()))
56
48
  client.row_factory = Row
57
49
 
58
- for pragma in _PRAGMAS:
50
+ for pragma in SQLITE_PRAGMAS:
59
51
  await client.execute(pragma)
60
52
 
61
53
  return client
62
-
63
- @staticmethod
64
- def _create_repository_directory(path: str) -> None:
65
- directory: Path = Path(path)
66
- directory.mkdir(parents=True, exist_ok=True)
67
-
68
- @staticmethod
69
- def _set_repository_file(path: str, repository_name: str = "sqlite") -> str:
70
- return str(Path(path) / f"{repository_name}.db")
@@ -0,0 +1,5 @@
1
+ SQLITE_PRAGMAS: tuple[str, ...] = (
2
+ "PRAGMA journal_mode=WAL",
3
+ "PRAGMA busy_timeout=5000",
4
+ "PRAGMA synchronous=NORMAL",
5
+ )
@@ -1,5 +1,3 @@
1
- from __future__ import annotations
2
-
3
1
  from typing import Any, Protocol, runtime_checkable
4
2
 
5
3