pz-cli 5.0.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (399) hide show
  1. pz_cli-5.0.0.dist-info/METADATA +51 -0
  2. pz_cli-5.0.0.dist-info/RECORD +399 -0
  3. pz_cli-5.0.0.dist-info/WHEEL +4 -0
  4. pz_cli-5.0.0.dist-info/entry_points.txt +5 -0
  5. pz_core/__init__.py +64 -0
  6. pz_core/__main__.py +7 -0
  7. pz_core/app.py +45 -0
  8. pz_core/assembly/__init__.py +17 -0
  9. pz_core/assembly/app_discovery.py +1240 -0
  10. pz_core/assembly/apps/__init__.py +25 -0
  11. pz_core/assembly/apps/compiler.py +824 -0
  12. pz_core/assembly/apps/providers.py +188 -0
  13. pz_core/assembly/cli/__init__.py +9 -0
  14. pz_core/assembly/cli/compiler.py +166 -0
  15. pz_core/assembly/diagnostics/__init__.py +21 -0
  16. pz_core/assembly/diagnostics/checks.py +257 -0
  17. pz_core/assembly/diagnostics/dev_sources.py +569 -0
  18. pz_core/assembly/events/__init__.py +5 -0
  19. pz_core/assembly/events/compiler.py +219 -0
  20. pz_core/assembly/extensions/__init__.py +5 -0
  21. pz_core/assembly/extensions/compiler.py +696 -0
  22. pz_core/assembly/infra/__init__.py +6 -0
  23. pz_core/assembly/infra/compiler.py +272 -0
  24. pz_core/assembly/lifecycle/__init__.py +5 -0
  25. pz_core/assembly/lifecycle/compiler.py +95 -0
  26. pz_core/assembly/middlewares/__init__.py +19 -0
  27. pz_core/assembly/middlewares/compiler.py +508 -0
  28. pz_core/assembly/project/__init__.py +7 -0
  29. pz_core/assembly/project/compiler.py +9 -0
  30. pz_core/assembly/project/context.py +17 -0
  31. pz_core/assembly/project/discovery.py +227 -0
  32. pz_core/assembly/resources/__init__.py +19 -0
  33. pz_core/assembly/resources/compiler.py +310 -0
  34. pz_core/assembly/resources/settings.py +129 -0
  35. pz_core/assembly/routes/__init__.py +7 -0
  36. pz_core/assembly/routes/compiler.py +400 -0
  37. pz_core/assembly/runtime_manifests/__init__.py +13 -0
  38. pz_core/assembly/runtime_manifests/compiler.py +159 -0
  39. pz_core/assembly/settings/__init__.py +17 -0
  40. pz_core/assembly/settings/compiler.py +786 -0
  41. pz_core/assembly/settings/host_project_overrides.py +82 -0
  42. pz_core/assembly/settings/host_runtime_endpoint.py +207 -0
  43. pz_core/authoring/__init__.py +79 -0
  44. pz_core/authoring/app_init_service.py +946 -0
  45. pz_core/authoring/app_versions.py +814 -0
  46. pz_core/authoring/cli.py +192 -0
  47. pz_core/authoring/commands.py +1810 -0
  48. pz_core/authoring/conflicts.py +180 -0
  49. pz_core/authoring/dev_bindings.py +916 -0
  50. pz_core/authoring/dev_git.py +1087 -0
  51. pz_core/authoring/dev_import.py +1061 -0
  52. pz_core/authoring/dev_manifest.py +522 -0
  53. pz_core/authoring/dev_sources.py +1638 -0
  54. pz_core/authoring/env_cli.py +454 -0
  55. pz_core/authoring/files.py +109 -0
  56. pz_core/authoring/ide_projection.py +1129 -0
  57. pz_core/authoring/naming.py +58 -0
  58. pz_core/authoring/official_dev_sources.py +432 -0
  59. pz_core/authoring/official_sources.json +156 -0
  60. pz_core/authoring/orchestration_service.py +558 -0
  61. pz_core/authoring/project_default.jsonc +53 -0
  62. pz_core/authoring/project_defaults.py +88 -0
  63. pz_core/authoring/project_metadata_service.py +199 -0
  64. pz_core/authoring/project_settings_checks.py +51 -0
  65. pz_core/authoring/project_settings_cli.py +299 -0
  66. pz_core/authoring/project_settings_service.py +1700 -0
  67. pz_core/authoring/project_state.py +399 -0
  68. pz_core/authoring/publish_git.py +423 -0
  69. pz_core/authoring/publish_lock.py +188 -0
  70. pz_core/authoring/publish_source.py +195 -0
  71. pz_core/authoring/release.py +1382 -0
  72. pz_core/authoring/repo_keys.py +29 -0
  73. pz_core/authoring/root_cli.py +28 -0
  74. pz_core/authoring/scaffold_service.py +325 -0
  75. pz_core/authoring/sync_service.py +787 -0
  76. pz_core/authoring/templates/app/__init__.py +1 -0
  77. pz_core/authoring/templates/app/api.py +25 -0
  78. pz_core/authoring/templates/app/apps.py +31 -0
  79. pz_core/authoring/templates/app/auth_package_init.py +14 -0
  80. pz_core/authoring/templates/app/auth_readme.py +29 -0
  81. pz_core/authoring/templates/app/configs_package_init.py +14 -0
  82. pz_core/authoring/templates/app/default_env.py +18 -0
  83. pz_core/authoring/templates/app/default_jsonc.py +25 -0
  84. pz_core/authoring/templates/app/locales_readme.py +25 -0
  85. pz_core/authoring/templates/app/migrations_readme.py +19 -0
  86. pz_core/authoring/templates/app/models.py +14 -0
  87. pz_core/authoring/templates/app/package_init.py +8 -0
  88. pz_core/authoring/templates/app/pages_base.py +161 -0
  89. pz_core/authoring/templates/app/pages_readme.py +25 -0
  90. pz_core/authoring/templates/app/public.py +31 -0
  91. pz_core/authoring/templates/app/pyproject.py +77 -0
  92. pz_core/authoring/templates/app/readme.py +74 -0
  93. pz_core/authoring/templates/app/settings.py +46 -0
  94. pz_core/authoring/templates/app/static_app_js.py +24 -0
  95. pz_core/authoring/templates/app/static_readme.py +31 -0
  96. pz_core/authoring/templates/app/template_config_page.py +23 -0
  97. pz_core/authoring/templates/app/template_index_html.py +28 -0
  98. pz_core/authoring/templates/app/templates_readme.py +32 -0
  99. pz_core/authoring/templates/app/urls.py +36 -0
  100. pz_core/authoring/templates/app/views.py +36 -0
  101. pz_core/authoring/templates/project/__init__.py +1 -0
  102. pz_core/authoring/templates/project/agents.py +51 -0
  103. pz_core/authoring/templates/project/apps_container_readme.py +37 -0
  104. pz_core/authoring/templates/project/main_py.py +59 -0
  105. pz_core/authoring/templates/project/project_env.py +19 -0
  106. pz_core/authoring/templates/project/pyproject.py +26 -0
  107. pz_core/authoring/templates/project/pz_env_env.py +65 -0
  108. pz_core/authoring/templates/project/pz_env_jsonc.py +69 -0
  109. pz_core/authoring/templates/project/pz_jsonc.py +12 -0
  110. pz_core/authoring/templates/project/readme.py +94 -0
  111. pz_core/authoring/templates/project/root_gitkeep.py +8 -0
  112. pz_core/authoring/templates/shared/__init__.py +5 -0
  113. pz_core/authoring/templates/shared/text.py +10 -0
  114. pz_core/authoring/venv_service.py +87 -0
  115. pz_core/authoring/workspace.py +167 -0
  116. pz_core/cli.py +291 -0
  117. pz_core/cli_options.py +74 -0
  118. pz_core/core/__init__.py +3 -0
  119. pz_core/core/errors/__init__.py +5 -0
  120. pz_core/core/errors/models.py +117 -0
  121. pz_core/core/events/__init__.py +5 -0
  122. pz_core/core/events/registry.py +54 -0
  123. pz_core/core/extensions/__init__.py +51 -0
  124. pz_core/core/extensions/registry.py +790 -0
  125. pz_core/core/health/__init__.py +6 -0
  126. pz_core/core/health/contracts.py +10 -0
  127. pz_core/core/middlewares/__init__.py +6 -0
  128. pz_core/core/middlewares/models.py +24 -0
  129. pz_core/core/routing/__init__.py +5 -0
  130. pz_core/core/routing/models.py +21 -0
  131. pz_core/core/settings_contracts.py +25 -0
  132. pz_core/docs/README.md +20 -0
  133. pz_core/docs/distribution-README.md +438 -0
  134. pz_core/docs/pz/345/221/275/344/273/244/346/200/273/350/247/210.md +1011 -0
  135. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/00-pz/346/236/266/346/236/204/346/200/273/347/272/262.md +240 -0
  136. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/01-/347/233/256/345/275/225/344/270/216/345/210/206/345/261/202/350/247/204/350/214/203.md +216 -0
  137. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/02-/345/214/205/344/270/216/345/210/206/345/217/221/350/247/204/350/214/203.md +403 -0
  138. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/03-App/346/234/200/345/260/217/345/255/220/345/214/205/350/247/204/350/214/203.md +571 -0
  139. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/04-Settings/344/270/216/351/205/215/347/275/256/350/247/204/350/214/203.md +1177 -0
  140. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/05-/350/265/204/346/272/220/344/270/216/350/277/220/350/241/214/347/233/256/345/275/225/350/247/204/350/214/203.md +575 -0
  141. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/06-/346/225/260/346/215/256/345/272/223/344/270/216/345/217/257/351/200/211/345/237/272/347/241/200/350/256/276/346/226/275/350/247/204/350/214/203.md +499 -0
  142. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/07-App/346/233/277/346/215/242/350/247/204/350/214/203.md +206 -0
  143. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/08-/345/271/263/345/217/260/347/272/247App/344/270/216/350/277/220/350/241/214/346/227/266/345/215/225/344/276/213/350/247/204/350/214/203.md +445 -0
  144. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/09-CLI/344/270/216Worker/345/205/245/345/217/243/350/247/204/350/214/203.md +950 -0
  145. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/10-/346/265/213/350/257/225/344/270/216/345/245/221/347/272/246/350/247/204/350/214/203.md +1001 -0
  146. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/11-/344/273/223/345/272/223/347/234/237/347/233/270/346/272/220/345/234/260/345/233/276.md +102 -0
  147. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/12-/346/236/204/345/273/272/344/270/216/345/217/221/345/270/203/346/243/200/346/237/245/346/270/205/345/215/225.md +171 -0
  148. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/13-/346/255/243/345/274/217Facade/346/200/273/350/241/250.md +402 -0
  149. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/14-/345/210/206/345/261/202/344/270/216/346/211/251/345/261/225/350/247/204/350/214/203.md +550 -0
  150. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/15-/345/255/220/345/214/205/345/274/200/345/217/221/344/275/277/347/224/250/346/211/213/345/206/214.md +1004 -0
  151. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/16-/346/211/251/345/261/225/347/202/271/346/255/243/345/274/217/345/215/217/350/256/256/346/270/205/345/215/225.md +352 -0
  152. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/17-pz.protocols.v1/346/255/243/345/274/217/345/215/217/350/256/256.md +266 -0
  153. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/18-/346/211/251/345/261/225/347/202/271/345/206/262/347/252/201/350/243/201/345/206/263/346/200/273/350/241/250.md +131 -0
  154. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/19-/351/224/231/350/257/257/347/240/201/344/270/216/350/257/212/346/226/255/345/215/217/350/256/256.md +176 -0
  155. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/20-/347/247/201/346/234/211/345/214/205/344/273/223/344/270/216/347/273/237/344/270/200/350/256/244/350/257/201/351/203/250/347/275/262/350/247/204/350/214/203.md +243 -0
  156. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/21-contrib/347/272/246/345/256/232/344/270/216Provider/346/216/245/345/205/245/350/247/204/350/214/203.md +365 -0
  157. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/22-/345/244/232/345/233/275/350/257/255/350/250/200/350/265/204/346/272/220/346/262/273/347/220/206/344/270/216/346/214/211/351/234/200/345/212/240/350/275/275/350/247/204/350/214/203.md +912 -0
  158. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/23-/351/246/226/345/261/217/345/261/225/347/244/272/344/270/216/351/246/226/345/270/247/347/250/263/345/256/232/350/247/204/350/214/203.md +269 -0
  159. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/24-pz/345/220/257/345/212/250/344/270/216/350/277/220/350/241/214/346/227/266/347/274/226/350/257/221/346/265/201/347/250/213.md +245 -0
  160. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/25-/351/235/242/345/220/221/345/257/271/350/261/241/345/274/200/345/217/221/350/247/204/350/214/203.md +300 -0
  161. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/README.md +98 -0
  162. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/archive//344/270/255/351/227/264/346/200/201/00-legacy_core/346/240/207/345/207/206pip/345/214/205/345/214/226/351/207/215/346/236/204/346/200/273/347/272/262.md +1073 -0
  163. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/archive//344/270/255/351/227/264/346/200/201/01-/347/233/256/345/275/225/344/270/216/345/210/206/345/261/202/351/207/215/346/236/204/346/211/247/350/241/214/346/226/271/346/241/210.md +224 -0
  164. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/archive//344/270/255/351/227/264/346/200/201/02-/345/214/205/344/270/216/345/210/206/345/217/221/350/247/204/350/214/203-/345/220/253/345/216/206/345/217/262/345/217/243/345/276/204.md +671 -0
  165. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/archive//344/270/255/351/227/264/346/200/201/13-/344/270/200/346/254/241/346/200/247/345/256/236/346/226/275/346/270/205/345/215/225.md +387 -0
  166. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/archive//344/270/255/351/227/264/346/200/201/14-/345/255/220/345/214/205/351/200/202/351/205/215/346/224/271/351/200/240/346/270/205/345/215/225.md +592 -0
  167. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/archive//344/270/255/351/227/264/346/200/201/15-infra/350/243/201/345/211/252/344/270/216/350/220/275/344/275/215/346/270/205/345/215/225.md +81 -0
  168. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/archive//344/270/255/351/227/264/346/200/201/19-core/345/215/225/344/270/200/346/255/243/345/274/217/346/226/271/346/241/210/346/224/266/346/225/233/346/211/247/350/241/214/346/270/205/345/215/225.md +161 -0
  169. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/archive//344/270/255/351/227/264/346/200/201/25-/345/215/217/350/256/256/345/210/260/346/272/220/347/240/201/345/267/256/350/267/235/346/270/205/345/215/225.md +377 -0
  170. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/archive//344/270/255/351/227/264/346/200/201/26-cutover/345/256/214/345/267/245/346/243/200/346/237/245/346/270/205/345/215/225.md +117 -0
  171. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/archive//344/270/255/351/227/264/346/200/201/29-/345/244/232/345/233/275/350/257/255/350/250/200/350/265/204/346/272/220/346/262/273/347/220/206/344/270/216/346/214/211/351/234/200/345/212/240/350/275/275/350/247/204/350/214/203-/345/220/253/350/277/201/347/247/273/347/255/226/347/225/245.md +956 -0
  172. pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/archive//344/270/255/351/227/264/346/200/201/99-/350/265/204/346/272/220/346/224/266/345/217/243/345/220/216/347/273/255TODO.md +84 -0
  173. pz_core/docs//345/217/221/347/211/210/345/211/215/346/270/205/345/215/225-4.0.11.md +84 -0
  174. pz_core/docs//346/226/260/346/211/213/346/214/207/345/215/227.md +422 -0
  175. pz_core/infra/__init__.py +17 -0
  176. pz_core/infra/db/__init__.py +23 -0
  177. pz_core/infra/db/contracts.py +73 -0
  178. pz_core/infra/health/__init__.py +5 -0
  179. pz_core/infra/health/contracts.py +8 -0
  180. pz_core/infra/kv/__init__.py +5 -0
  181. pz_core/infra/kv/contracts.py +17 -0
  182. pz_core/infra/observability/__init__.py +23 -0
  183. pz_core/infra/observability/contracts.py +142 -0
  184. pz_core/infra/resilience/__init__.py +5 -0
  185. pz_core/infra/resilience/contracts.py +17 -0
  186. pz_core/infra/resources/__init__.py +5 -0
  187. pz_core/infra/resources/contracts.py +16 -0
  188. pz_core/infra/settings/__init__.py +17 -0
  189. pz_core/infra/settings/models.py +81 -0
  190. pz_core/infra/storage/__init__.py +5 -0
  191. pz_core/infra/storage/ports.py +27 -0
  192. pz_core/project_root_commands.py +282 -0
  193. pz_core/project_runtime_cli.py +344 -0
  194. pz_core/project_sources.py +253 -0
  195. pz_core/pz_launcher.py +209 -0
  196. pz_core/root_cli.py +70 -0
  197. pz_core/runtime/__init__.py +229 -0
  198. pz_core/runtime/access.py +86 -0
  199. pz_core/runtime/adapters/__init__.py +5 -0
  200. pz_core/runtime/adapters/base.py +18 -0
  201. pz_core/runtime/asyncio_bridge.py +18 -0
  202. pz_core/runtime/bindings/__init__.py +5 -0
  203. pz_core/runtime/bindings/container.py +50 -0
  204. pz_core/runtime/cli/__init__.py +5 -0
  205. pz_core/runtime/cli/_args.py +67 -0
  206. pz_core/runtime/cli/app_commands.py +417 -0
  207. pz_core/runtime/cli/check.py +214 -0
  208. pz_core/runtime/cli/db.py +297 -0
  209. pz_core/runtime/cli/main.py +89 -0
  210. pz_core/runtime/cli/resources.py +280 -0
  211. pz_core/runtime/discovery.py +23 -0
  212. pz_core/runtime/environment_integrity.py +157 -0
  213. pz_core/runtime/errors.py +5 -0
  214. pz_core/runtime/events.py +87 -0
  215. pz_core/runtime/facades/__init__.py +38 -0
  216. pz_core/runtime/facades/_capabilities.py +46 -0
  217. pz_core/runtime/facades/cache.py +103 -0
  218. pz_core/runtime/facades/database.py +71 -0
  219. pz_core/runtime/facades/events.py +380 -0
  220. pz_core/runtime/facades/health.py +101 -0
  221. pz_core/runtime/facades/mail.py +121 -0
  222. pz_core/runtime/facades/observability.py +102 -0
  223. pz_core/runtime/facades/providers.py +75 -0
  224. pz_core/runtime/facades/resources.py +52 -0
  225. pz_core/runtime/facades/storage.py +296 -0
  226. pz_core/runtime/health/__init__.py +5 -0
  227. pz_core/runtime/health/service.py +102 -0
  228. pz_core/runtime/host.py +188 -0
  229. pz_core/runtime/host_runner.py +282 -0
  230. pz_core/runtime/http/__init__.py +20 -0
  231. pz_core/runtime/http/app.py +576 -0
  232. pz_core/runtime/http_timing.py +173 -0
  233. pz_core/runtime/invocation.py +29 -0
  234. pz_core/runtime/json_safe.py +47 -0
  235. pz_core/runtime/lifecycle/__init__.py +25 -0
  236. pz_core/runtime/lifecycle/manager.py +533 -0
  237. pz_core/runtime/plan.py +214 -0
  238. pz_core/runtime/plan_context.py +33 -0
  239. pz_core/runtime/plan_snapshot.py +177 -0
  240. pz_core/runtime/registries/__init__.py +27 -0
  241. pz_core/runtime/registries/capabilities.py +101 -0
  242. pz_core/runtime/registries/providers.py +396 -0
  243. pz_core/runtime/resource_assets.py +344 -0
  244. pz_core/runtime/run_cli.py +211 -0
  245. pz_core/runtime/settings.py +888 -0
  246. pz_core/runtime/worker/__init__.py +21 -0
  247. pz_core/runtime/worker/engine.py +921 -0
  248. pz_core/runtime/worker/runtime.py +25 -0
  249. pz_core/testing/__init__.py +15 -0
  250. pz_core/testing/doc_route_contracts.py +305 -0
  251. pz_core/utils/__init__.py +44 -0
  252. pz_core/utils/env.py +65 -0
  253. pz_core/utils/project_jsonc/__init__.py +29 -0
  254. pz_core/utils/project_jsonc/document.py +420 -0
  255. pz_core/utils/project_settings.py +99 -0
  256. pz_foundation/__init__.py +50 -0
  257. pz_foundation/_contracts.py +81 -0
  258. pz_foundation/_errors.py +34 -0
  259. pz_foundation/api.py +14 -0
  260. pz_foundation/apps.py +127 -0
  261. pz_foundation/auth/__init__.py +1 -0
  262. pz_foundation/cache_control.py +233 -0
  263. pz_foundation/cli/__init__.py +2 -0
  264. pz_foundation/cli/workers.py +565 -0
  265. pz_foundation/configs/__init__.py +0 -0
  266. pz_foundation/configs/default.env +15 -0
  267. pz_foundation/configs/default.jsonc +452 -0
  268. pz_foundation/db/__init__.py +94 -0
  269. pz_foundation/db/aerich_executor.py +664 -0
  270. pz_foundation/db/config.py +358 -0
  271. pz_foundation/db/connection_manager.py +689 -0
  272. pz_foundation/db/connection_probe.py +204 -0
  273. pz_foundation/db/database.py +1291 -0
  274. pz_foundation/db/deps.py +47 -0
  275. pz_foundation/db/lifecycle_status.py +85 -0
  276. pz_foundation/db/migrations.py +477 -0
  277. pz_foundation/db/mysql.py +57 -0
  278. pz_foundation/db/postgresql.py +409 -0
  279. pz_foundation/db/production_pool_fallback.py +143 -0
  280. pz_foundation/db/public.py +45 -0
  281. pz_foundation/db/session.py +369 -0
  282. pz_foundation/db/sqlite.py +15 -0
  283. pz_foundation/db/tortoise_manager.py +724 -0
  284. pz_foundation/db/tortoise_psycopg.py +148 -0
  285. pz_foundation/docs/README.md +18 -0
  286. pz_foundation/docs/distribution-README.md +319 -0
  287. pz_foundation/docs/infra/350/243/201/345/211/252/344/270/216/350/220/275/344/275/215/350/257/264/346/230/216.md +39 -0
  288. pz_foundation/docs//345/205/254/345/274/200/345/205/215/350/264/271/346/216/245/345/217/243/351/230/262/346/273/245/347/224/250/344/270/216/344/272/272/346/234/272/346/240/241/351/252/214.md +680 -0
  289. pz_foundation/docs//350/256/276/350/256/241/346/226/207/346/241/243.md +288 -0
  290. pz_foundation/docs//350/267/257/347/224/261/344/270/216URL/345/244/204/347/220/206/350/247/204/350/214/203.md +119 -0
  291. pz_foundation/health.py +105 -0
  292. pz_foundation/host/__init__.py +11 -0
  293. pz_foundation/host/builder.py +34 -0
  294. pz_foundation/host/cache_runtime.py +44 -0
  295. pz_foundation/host/db/__init__.py +17 -0
  296. pz_foundation/host/db/aerich_config.py +36 -0
  297. pz_foundation/host/db/config.py +106 -0
  298. pz_foundation/host/db/connection_manager.py +48 -0
  299. pz_foundation/host/db/deps.py +5 -0
  300. pz_foundation/host/db/orm_retry_patch.py +566 -0
  301. pz_foundation/host/db/request_adapter.py +325 -0
  302. pz_foundation/host/db/router.py +28 -0
  303. pz_foundation/host/db/session.py +284 -0
  304. pz_foundation/host/db/tortoise_manager.py +10 -0
  305. pz_foundation/host/idempotency.py +132 -0
  306. pz_foundation/host/lifespan.py +247 -0
  307. pz_foundation/host/redis_runtime.py +100 -0
  308. pz_foundation/host/web.py +790 -0
  309. pz_foundation/infra_provider.py +236 -0
  310. pz_foundation/kv/__init__.py +25 -0
  311. pz_foundation/kv/cache.py +1166 -0
  312. pz_foundation/kv/deps.py +84 -0
  313. pz_foundation/kv/public.py +25 -0
  314. pz_foundation/kv/redis_manager.py +1531 -0
  315. pz_foundation/lazy_exports.py +43 -0
  316. pz_foundation/lazy_imports.py +124 -0
  317. pz_foundation/lifecycle.py +392 -0
  318. pz_foundation/managed_workers.py +1117 -0
  319. pz_foundation/middlewares/__init__.py +26 -0
  320. pz_foundation/middlewares/_settings.py +250 -0
  321. pz_foundation/middlewares/analytics.py +124 -0
  322. pz_foundation/middlewares/cache_control.py +156 -0
  323. pz_foundation/middlewares/compression.py +202 -0
  324. pz_foundation/middlewares/cors.py +62 -0
  325. pz_foundation/middlewares/geo_country.py +44 -0
  326. pz_foundation/middlewares/inner_router.py +50 -0
  327. pz_foundation/middlewares/rate_limited/__init__.py +3 -0
  328. pz_foundation/middlewares/rate_limited/key_limiter.py +115 -0
  329. pz_foundation/middlewares/request_logging.py +104 -0
  330. pz_foundation/middlewares/route_owner.py +309 -0
  331. pz_foundation/middlewares/security_csrf.py +44 -0
  332. pz_foundation/middlewares/security_headers/__init__.py +4 -0
  333. pz_foundation/middlewares/security_headers/conflicts.py +44 -0
  334. pz_foundation/middlewares/security_headers/csp_nonce.py +200 -0
  335. pz_foundation/middlewares/security_headers/security_headers.py +44 -0
  336. pz_foundation/migrations/__init__.py +1 -0
  337. pz_foundation/migrations/pz_foundation/__init__.py +1 -0
  338. pz_foundation/models.py +22 -0
  339. pz_foundation/notifications/__init__.py +23 -0
  340. pz_foundation/notifications/email.py +542 -0
  341. pz_foundation/notifications/public.py +31 -0
  342. pz_foundation/observability/__init__.py +71 -0
  343. pz_foundation/observability/http.py +34 -0
  344. pz_foundation/observability/logger/__init__.py +49 -0
  345. pz_foundation/observability/logger/_bot_settings.py +126 -0
  346. pz_foundation/observability/logger/bot_message.py +592 -0
  347. pz_foundation/observability/logger/core.py +385 -0
  348. pz_foundation/observability/logger/delivery_audit.py +84 -0
  349. pz_foundation/observability/logger/feishu_bot.py +199 -0
  350. pz_foundation/observability/logger/telegram_bot.py +194 -0
  351. pz_foundation/observability/metrics.py +365 -0
  352. pz_foundation/observability/runtime.py +68 -0
  353. pz_foundation/public.py +405 -0
  354. pz_foundation/resources/__init__.py +12 -0
  355. pz_foundation/resources/builder.py +900 -0
  356. pz_foundation/resources/images.py +363 -0
  357. pz_foundation/root_cli.py +20 -0
  358. pz_foundation/routing/__init__.py +203 -0
  359. pz_foundation/routing/canonical.py +486 -0
  360. pz_foundation/routing/convertors.py +82 -0
  361. pz_foundation/routing/declarations.py +843 -0
  362. pz_foundation/routing/exports.py +148 -0
  363. pz_foundation/routing/loaders.py +138 -0
  364. pz_foundation/routing/manifest.py +215 -0
  365. pz_foundation/routing/manifest_provider.py +47 -0
  366. pz_foundation/routing/mounts.py +101 -0
  367. pz_foundation/routing/ordering.py +172 -0
  368. pz_foundation/routing/registry.py +133 -0
  369. pz_foundation/routing/utils.py +28 -0
  370. pz_foundation/runtime.py +234 -0
  371. pz_foundation/settings.py +253 -0
  372. pz_foundation/settings_normalization.py +130 -0
  373. pz_foundation/storage/__init__.py +25 -0
  374. pz_foundation/storage/local.py +209 -0
  375. pz_foundation/storage/public.py +106 -0
  376. pz_foundation/storage/s3.py +116 -0
  377. pz_foundation/storage/service.py +234 -0
  378. pz_foundation/urls.py +19 -0
  379. pz_foundation/utils/__init__.py +6 -0
  380. pz_foundation/utils/merge.py +160 -0
  381. pz_foundation/worker_replicas.py +55 -0
  382. pz_settings_center/__init__.py +5 -0
  383. pz_settings_center/api/__init__.py +5 -0
  384. pz_settings_center/api/runtime_overrides.py +360 -0
  385. pz_settings_center/apps.py +28 -0
  386. pz_settings_center/configs/__init__.py +0 -0
  387. pz_settings_center/configs/default.env +2 -0
  388. pz_settings_center/configs/default.jsonc +1 -0
  389. pz_settings_center/docs/01-settings_center/350/203/275/345/212/233/350/276/271/347/225/214.md +124 -0
  390. pz_settings_center/docs/README.md +12 -0
  391. pz_settings_center/docs/distribution-README.md +150 -0
  392. pz_settings_center/docs//350/256/276/350/256/241/346/226/207/346/241/243.md +48 -0
  393. pz_settings_center/integration_payload.py +18 -0
  394. pz_settings_center/project_helpers.py +405 -0
  395. pz_settings_center/public.py +139 -0
  396. pz_settings_center/routing_helpers.py +73 -0
  397. pz_settings_center/runtime_override_provider.py +61 -0
  398. pz_settings_center/typed_settings.py +324 -0
  399. pz_settings_center/urls.py +9 -0
@@ -0,0 +1,309 @@
1
+ from __future__ import annotations
2
+
3
+ from collections.abc import Iterable
4
+ from dataclasses import dataclass
5
+
6
+ from fastapi.responses import RedirectResponse
7
+ from fastapi.routing import APIRoute
8
+ from starlette.routing import compile_path
9
+ from starlette.types import ASGIApp, Receive, Scope, Send
10
+
11
+ from pz_foundation.routing.manifest import require_foundation_url_manifest
12
+ from pz_foundation.routing.canonical import (
13
+ canonical_redirect_target,
14
+ rewrite_prefixless_default_language_path,
15
+ split_public_language_path,
16
+ )
17
+ from pz_foundation.routing.ordering import classify_route_type
18
+ from pz_foundation.routing.utils import _join_path_prefix
19
+
20
+
21
+ SKIP_DEFAULT_LANGUAGE_PREFIXLESS_HINT = "route_owner.skip_default_language_prefixless"
22
+
23
+
24
+ @dataclass(frozen=True, slots=True)
25
+ class _RouteMatcherSpec:
26
+ path: str
27
+ name: str = ""
28
+ route_hints: tuple[str, ...] = ()
29
+
30
+
31
+ @dataclass(frozen=True, slots=True)
32
+ class _RouteMatcher:
33
+ pattern: object
34
+ path: str
35
+ name: str = ""
36
+ route_hints: tuple[str, ...] = ()
37
+
38
+
39
+ def _normalize_languages(value) -> tuple[str, ...]:
40
+ if isinstance(value, str):
41
+ raw_items = [value]
42
+ elif isinstance(value, (list, tuple, set)):
43
+ raw_items = list(value)
44
+ else:
45
+ raw_items = []
46
+ out: list[str] = []
47
+ seen: set[str] = set()
48
+ for item in raw_items:
49
+ text = str(item or "").strip()
50
+ if not text or text in seen:
51
+ continue
52
+ seen.add(text)
53
+ out.append(text)
54
+ return tuple(out)
55
+
56
+
57
+ def _compiled_path_matchers(routes: Iterable[_RouteMatcherSpec]) -> tuple[_RouteMatcher, ...]:
58
+ matchers: list[_RouteMatcher] = []
59
+ seen: set[str] = set()
60
+ for route in routes:
61
+ normalized = str(route.path or "").strip()
62
+ if not normalized or normalized in seen:
63
+ continue
64
+ seen.add(normalized)
65
+ path_regex, _path_format, _param_convertors = compile_path(normalized)
66
+ matchers.append(
67
+ _RouteMatcher(
68
+ pattern=path_regex,
69
+ path=normalized,
70
+ name=str(route.name or "").strip(),
71
+ route_hints=tuple(str(item or "").strip() for item in route.route_hints if str(item or "").strip()),
72
+ )
73
+ )
74
+ return tuple(matchers)
75
+
76
+
77
+ def _host_route_manifest_specs(host_app) -> tuple[_RouteMatcherSpec, ...]:
78
+ state = getattr(host_app, "state", None)
79
+ manifest = getattr(state, "pz_route_manifest", None)
80
+ entries = tuple(getattr(manifest, "entries", ()) or ())
81
+ if not entries:
82
+ return ()
83
+ specs: list[_RouteMatcherSpec] = []
84
+ seen: set[str] = set()
85
+ for entry in entries:
86
+ path_prefix = str(getattr(entry, "path_prefix", "") or "").strip()
87
+ route_hints = tuple(str(item or "").strip() for item in getattr(entry, "route_hints", ()) or () if str(item or "").strip())
88
+ router = getattr(entry, "router", None)
89
+ for route in tuple(getattr(router, "routes", ()) or ()):
90
+ if not isinstance(route, APIRoute):
91
+ continue
92
+ raw_path = str(getattr(route, "path", "") or "").strip()
93
+ if not raw_path:
94
+ continue
95
+ mounted_path = _join_path_prefix(path_prefix, raw_path)
96
+ if classify_route_type(mounted_path) == "generic":
97
+ continue
98
+ if mounted_path in seen:
99
+ continue
100
+ seen.add(mounted_path)
101
+ specs.append(
102
+ _RouteMatcherSpec(
103
+ path=mounted_path,
104
+ name=str(getattr(route, "name", "") or ""),
105
+ route_hints=route_hints,
106
+ )
107
+ )
108
+ return tuple(specs)
109
+
110
+
111
+ def _url_manifest_route_specs(plan) -> tuple[_RouteMatcherSpec, ...]:
112
+ entries = tuple(getattr(require_foundation_url_manifest(plan), "entries", ()) or ())
113
+ specs: list[_RouteMatcherSpec] = []
114
+ seen: set[str] = set()
115
+ for entry in entries:
116
+ path_prefix = str(getattr(entry, "path_prefix", "") or "").strip()
117
+ route_hints = tuple(str(item or "").strip() for item in getattr(entry, "route_hints", ()) or () if str(item or "").strip())
118
+ for route in tuple(getattr(entry, "routes", ()) or ()):
119
+ if str(getattr(route, "route_type", "") or "http") != "http":
120
+ continue
121
+ raw_path = str(getattr(route, "path", "") or "").strip()
122
+ if not raw_path:
123
+ continue
124
+ mounted_path = _join_path_prefix(path_prefix, raw_path)
125
+ if classify_route_type(mounted_path) == "generic":
126
+ continue
127
+ if mounted_path in seen:
128
+ continue
129
+ seen.add(mounted_path)
130
+ specs.append(
131
+ _RouteMatcherSpec(
132
+ path=mounted_path,
133
+ name=str(getattr(route, "name", "") or ""),
134
+ route_hints=route_hints,
135
+ )
136
+ )
137
+ return tuple(specs)
138
+
139
+
140
+ class DefaultLanguageRouteOwnerMiddleware:
141
+ """Rewrite default-language prefixless public paths to declared lang routes.
142
+
143
+ Subpackages declare `/{lang}/...` as the formal route. For the site's default
144
+ language, the external canonical URL is prefixless, so this middleware lets
145
+ `/login/` be served by the same handler as `/en/login/` without requiring
146
+ each subpackage to hand-write a second route.
147
+ """
148
+
149
+ def __init__(
150
+ self,
151
+ app: ASGIApp,
152
+ *,
153
+ plan=None,
154
+ route_paths: Iterable[str] | None = None,
155
+ host_app=None,
156
+ **_kwargs,
157
+ ) -> None:
158
+ self.app = app
159
+ settings = getattr(plan, "settings", None) if plan is not None else None
160
+ self.default_language = "en"
161
+ self.supported_languages = ("en",)
162
+ self.language_aliases: dict[str, str] = {}
163
+ if settings is not None:
164
+ try:
165
+ self.default_language = str(settings.get("routing", "default_language", default="en") or "en").strip() or "en"
166
+ except Exception:
167
+ self.default_language = "en"
168
+ try:
169
+ languages = settings.get("routing", "all_supported_languages", default=("en",)) or ("en",)
170
+ except Exception:
171
+ languages = ("en",)
172
+ self.supported_languages = _normalize_languages(languages) or (self.default_language,)
173
+ try:
174
+ aliases = settings.get("routing", "language_aliases", default={}) or {}
175
+ except Exception:
176
+ aliases = {}
177
+ if isinstance(aliases, dict):
178
+ self.language_aliases = {
179
+ str(alias).strip().strip("/"): str(target).strip().strip("/")
180
+ for alias, target in aliases.items()
181
+ if str(alias).strip().strip("/") and str(target).strip().strip("/")
182
+ }
183
+ host_manifest_specs = _host_route_manifest_specs(host_app)
184
+ declared_specs = (
185
+ host_manifest_specs
186
+ or (
187
+ tuple(_RouteMatcherSpec(path=str(path or "")) for path in tuple(route_paths))
188
+ if route_paths is not None
189
+ else _url_manifest_route_specs(plan)
190
+ )
191
+ )
192
+ self._route_matchers = _compiled_path_matchers(declared_specs)
193
+
194
+ def _matching_routes(self, path: str) -> tuple[_RouteMatcher, ...]:
195
+ normalized_path = str(path or "").strip() or "/"
196
+ return tuple(matcher for matcher in self._route_matchers if matcher.pattern.match(normalized_path))
197
+
198
+ def _route_exists(self, path: str) -> bool:
199
+ return bool(self._matching_routes(path))
200
+
201
+ def _route_skips_default_language_prefixless(self, path: str) -> bool:
202
+ return any(SKIP_DEFAULT_LANGUAGE_PREFIXLESS_HINT in matcher.route_hints for matcher in self._matching_routes(path))
203
+
204
+ def _path_uses_default_language_prefix(self, path: str) -> bool:
205
+ _tail, path_language = split_public_language_path(
206
+ path,
207
+ supported_languages=self.supported_languages,
208
+ language_aliases=self.language_aliases,
209
+ )
210
+ return bool(path_language and path_language.casefold() == self.default_language.casefold())
211
+
212
+ def _canonical_redirect_target(self, path: str) -> str | None:
213
+ target_path = canonical_redirect_target(
214
+ path,
215
+ default_language=self.default_language,
216
+ supported_languages=self.supported_languages,
217
+ language_aliases=self.language_aliases,
218
+ )
219
+ if not target_path:
220
+ return None
221
+ return None if target_path == path else target_path
222
+
223
+ def _prefixless_default_language_rewrite_target(self, path: str) -> str | None:
224
+ return rewrite_prefixless_default_language_path(
225
+ path,
226
+ default_language=self.default_language,
227
+ supported_languages=self.supported_languages,
228
+ language_aliases=self.language_aliases,
229
+ )
230
+
231
+ def _canonical_target_is_declared(self, target_path: str) -> bool:
232
+ if self._route_exists(target_path):
233
+ return True
234
+ rewritten_path = self._prefixless_default_language_rewrite_target(target_path)
235
+ return bool(rewritten_path and self._route_exists(rewritten_path))
236
+
237
+ def _should_skip_default_language_prefixless_redirect(self, path: str, target_path: str) -> bool:
238
+ if not self._path_uses_default_language_prefix(path):
239
+ return False
240
+ if self._route_exists(target_path):
241
+ return False
242
+ if self._route_skips_default_language_prefixless(path):
243
+ return True
244
+ rewritten_target_path = self._prefixless_default_language_rewrite_target(target_path)
245
+ return bool(rewritten_target_path and self._route_skips_default_language_prefixless(rewritten_target_path))
246
+
247
+ def _declared_slash_redirect_target(self, path: str) -> str | None:
248
+ normalized_path = str(path or "").strip() or "/"
249
+ if normalized_path == "/" or self._route_exists(normalized_path):
250
+ return None
251
+ if normalized_path.endswith("/"):
252
+ target_path = normalized_path.rstrip("/") or "/"
253
+ else:
254
+ target_path = f"{normalized_path}/"
255
+ if target_path != normalized_path and self._route_exists(target_path):
256
+ return target_path
257
+ return None
258
+
259
+ @staticmethod
260
+ def _redirect_status_code(scope: Scope) -> int:
261
+ method = str(scope.get("method") or "GET").upper()
262
+ return 301 if method in {"GET", "HEAD"} else 308
263
+
264
+ async def _redirect(self, scope: Scope, receive: Receive, send: Send, target_path: str) -> None:
265
+ raw_query = scope.get("query_string", b"")
266
+ query = ""
267
+ if isinstance(raw_query, bytes) and raw_query:
268
+ query = "?" + raw_query.decode("latin-1")
269
+ await RedirectResponse(url=f"{target_path}{query}", status_code=self._redirect_status_code(scope))(
270
+ scope,
271
+ receive,
272
+ send,
273
+ )
274
+
275
+ async def __call__(self, scope: Scope, receive: Receive, send: Send) -> None:
276
+ if scope.get("type") != "http":
277
+ await self.app(scope, receive, send)
278
+ return
279
+
280
+ path = str(scope.get("path") or "/")
281
+ target_path = self._canonical_redirect_target(path)
282
+ if (
283
+ target_path
284
+ and not self._should_skip_default_language_prefixless_redirect(path, target_path)
285
+ and (self._route_exists(path) or self._canonical_target_is_declared(target_path))
286
+ ):
287
+ await self._redirect(scope, receive, send, target_path)
288
+ return
289
+
290
+ declared_target_path = self._declared_slash_redirect_target(path)
291
+ if declared_target_path:
292
+ await self._redirect(scope, receive, send, declared_target_path)
293
+ return
294
+
295
+ rewritten_path = self._prefixless_default_language_rewrite_target(path)
296
+ if rewritten_path and self._route_exists(rewritten_path):
297
+ if self._route_skips_default_language_prefixless(rewritten_path) and not self._route_exists(path):
298
+ await self.app(scope, receive, send)
299
+ return
300
+ rewritten_scope = dict(scope)
301
+ rewritten_scope.setdefault("pz_original_path", path)
302
+ rewritten_scope["path"] = rewritten_path
303
+ await self.app(rewritten_scope, receive, send)
304
+ return
305
+
306
+ await self.app(scope, receive, send)
307
+
308
+
309
+ __all__ = ["DefaultLanguageRouteOwnerMiddleware"]
@@ -0,0 +1,44 @@
1
+ from __future__ import annotations
2
+
3
+ from fastapi import Request
4
+ from fastapi.responses import JSONResponse
5
+ from starlette.types import ASGIApp, Receive, Scope, Send
6
+
7
+ from ._settings import core_settings_payload, read_bool, read_list
8
+
9
+
10
+ class SecurityCSRFMiddleware:
11
+ def __init__(self, app: ASGIApp) -> None:
12
+ self.app = app
13
+ payload = core_settings_payload()
14
+ self.enabled = read_bool(payload, "security_csrf_enabled", False)
15
+ self.header = str(payload.get("security_csrf_header") or "X-CSRF-Token")
16
+ self.cookie = str(payload.get("security_csrf_cookie") or "csrf_token")
17
+ self.safe_methods = set(read_list(payload, "security_csrf_safe_methods", default=("GET", "HEAD", "OPTIONS")))
18
+ self.exempt_paths = read_list(payload, "security_csrf_exempt_paths", default=())
19
+ self.mode = str(payload.get("security_csrf_mode") or "protect_list")
20
+ self.protected_prefixes = read_list(payload, "security_csrf_protected_paths", default=("/api/",))
21
+
22
+ async def __call__(self, scope: Scope, receive: Receive, send: Send) -> None:
23
+ if scope.get("type") != "http":
24
+ await self.app(scope, receive, send)
25
+ return
26
+ request = Request(scope, receive=receive)
27
+ if not self.enabled or request.method.upper() in self.safe_methods:
28
+ await self.app(scope, receive, send)
29
+ return
30
+ path = request.url.path or "/"
31
+ if any(path == prefix or path.startswith(prefix) for prefix in self.exempt_paths):
32
+ await self.app(scope, receive, send)
33
+ return
34
+ should_protect = path.startswith("/api/") if self.mode == "protect_all" else any(path.startswith(prefix) for prefix in self.protected_prefixes)
35
+ if should_protect:
36
+ header_token = request.headers.get(self.header)
37
+ cookie_token = request.cookies.get(self.cookie)
38
+ if not header_token or not cookie_token or header_token != cookie_token:
39
+ await JSONResponse(status_code=403, content={"code": "forbidden", "message": "CSRF validation failed"})(scope, receive, send)
40
+ return
41
+ await self.app(scope, receive, send)
42
+
43
+
44
+ __all__ = ["SecurityCSRFMiddleware"]
@@ -0,0 +1,4 @@
1
+ from .csp_nonce import CSPNonceSecurityHeadersMiddleware
2
+ from .security_headers import SecurityHeadersMiddleware
3
+
4
+ __all__ = ["CSPNonceSecurityHeadersMiddleware", "SecurityHeadersMiddleware"]
@@ -0,0 +1,44 @@
1
+ from __future__ import annotations
2
+
3
+ from .._settings import core_settings_payload
4
+
5
+ CONFLICT_ERR_STATIC_CSP_WITH_NONCE = (
6
+ "配置冲突:security_headers_csp 已设置,同时启用了 CSPNonceSecurityHeadersMiddleware。"
7
+ )
8
+ CONFLICT_ERR_DUP_MIDDLEWARES = (
9
+ "配置冲突:同时启用了 CSPNonceSecurityHeadersMiddleware 与 SecurityHeadersMiddleware。"
10
+ )
11
+
12
+
13
+ def assert_security_headers_no_conflict() -> None:
14
+ payload = core_settings_payload()
15
+ middleware_items = payload.get("middleware") if isinstance(payload.get("middleware"), list) else []
16
+ paths: list[str] = []
17
+ for item in middleware_items:
18
+ if isinstance(item, str):
19
+ value = item.strip()
20
+ if value:
21
+ paths.append(value)
22
+ elif isinstance(item, (list, tuple)) and item:
23
+ value = str(item[0]).strip()
24
+ if value:
25
+ paths.append(value)
26
+ nonce_paths = {
27
+ "pz_foundation.middlewares.security_headers.csp_nonce:CSPNonceSecurityHeadersMiddleware",
28
+ }
29
+ minimal_paths = {
30
+ "pz_foundation.middlewares.security_headers.security_headers:SecurityHeadersMiddleware",
31
+ }
32
+ has_nonce = any(path in nonce_paths for path in paths)
33
+ has_minimal = any(path in minimal_paths for path in paths)
34
+ if payload.get("security_headers_csp") and has_nonce:
35
+ raise RuntimeError(CONFLICT_ERR_STATIC_CSP_WITH_NONCE)
36
+ if has_nonce and has_minimal:
37
+ raise RuntimeError(CONFLICT_ERR_DUP_MIDDLEWARES)
38
+
39
+
40
+ __all__ = [
41
+ "CONFLICT_ERR_DUP_MIDDLEWARES",
42
+ "CONFLICT_ERR_STATIC_CSP_WITH_NONCE",
43
+ "assert_security_headers_no_conflict",
44
+ ]
@@ -0,0 +1,200 @@
1
+ from __future__ import annotations
2
+
3
+ import re
4
+ import secrets
5
+ from urllib.parse import urlsplit
6
+
7
+ import pz_settings_center.public as settings_center
8
+ from starlette.datastructures import MutableHeaders
9
+ from starlette.requests import Request
10
+ from starlette.types import ASGIApp, Message, Receive, Scope, Send
11
+
12
+ from .._settings import core_settings_payload, read_bool, read_list
13
+ from .conflicts import assert_security_headers_no_conflict
14
+
15
+ _LOOPBACK_HOSTS = {"127.0.0.1", "localhost", "0.0.0.0"}
16
+ _HTML_CONTENT_TYPES = ("text/html", "application/xhtml+xml")
17
+
18
+
19
+ def _normalize_origin(value: str) -> str | None:
20
+ candidate = str(value or "").strip()
21
+ if not candidate:
22
+ return None
23
+ parsed = urlsplit(candidate)
24
+ if not parsed.scheme or not parsed.netloc:
25
+ return None
26
+ return f"{parsed.scheme}://{parsed.netloc}"
27
+
28
+
29
+ def _loopback_runtime_aliases() -> tuple[str, ...]:
30
+ try:
31
+ base_url = str(settings_center.settings.project.base_url or "").strip()
32
+ except Exception:
33
+ return ()
34
+ normalized = _normalize_origin(base_url)
35
+ if not normalized:
36
+ return ()
37
+ parsed = urlsplit(normalized)
38
+ host = str(parsed.hostname or "").strip().lower()
39
+ if host not in _LOOPBACK_HOSTS:
40
+ return ()
41
+ port = f":{parsed.port}" if parsed.port is not None else ""
42
+ aliases = (
43
+ f"{parsed.scheme}://127.0.0.1{port}",
44
+ f"{parsed.scheme}://localhost{port}",
45
+ )
46
+ deduped: list[str] = []
47
+ for alias in aliases:
48
+ if alias not in deduped:
49
+ deduped.append(alias)
50
+ return tuple(deduped)
51
+
52
+
53
+ def _sync_loopback_domains(domains: tuple[str, ...]) -> tuple[str, ...]:
54
+ runtime_aliases = _loopback_runtime_aliases()
55
+ if not runtime_aliases:
56
+ return domains
57
+ out: list[str] = []
58
+ replaced = False
59
+ for domain in domains:
60
+ normalized = _normalize_origin(domain)
61
+ if normalized is not None:
62
+ host = str(urlsplit(normalized).hostname or "").strip().lower()
63
+ if host in _LOOPBACK_HOSTS:
64
+ for alias in runtime_aliases:
65
+ if alias not in out:
66
+ out.append(alias)
67
+ replaced = True
68
+ continue
69
+ if normalized not in out:
70
+ out.append(normalized)
71
+ continue
72
+ literal = str(domain).strip()
73
+ if literal and literal not in out:
74
+ out.append(literal)
75
+ return tuple(out) if replaced else domains
76
+
77
+
78
+ class CSPNonceSecurityHeadersMiddleware:
79
+ def __init__(self, app: ASGIApp) -> None:
80
+ self.app = app
81
+ assert_security_headers_no_conflict()
82
+ payload = core_settings_payload()
83
+ self.script_src_domains = read_list(payload, "security_headers_script_src_domains", default=())
84
+ self.connect_src_domains = _sync_loopback_domains(
85
+ read_list(payload, "security_headers_connect_src_domains", default=())
86
+ )
87
+ self.img_src_domains = _sync_loopback_domains(
88
+ read_list(payload, "security_headers_img_src_domains", default=())
89
+ )
90
+ self.frame_src_domains = read_list(payload, "security_headers_frame_src_domains", default=())
91
+ self.frame_options_exempt_paths = read_list(
92
+ payload,
93
+ "security_headers_frame_options_exempt_paths",
94
+ default=(),
95
+ )
96
+ self.allow_all_https = read_bool(payload, "security_headers_allow_all_https", False)
97
+ self.all_domains = read_list(payload, "security_headers_all_domains", default=())
98
+ self.frame_options = str(payload.get("security_headers_frame_options") or "DENY")
99
+ self.content_type_options = str(payload.get("security_headers_content_type_options") or "nosniff")
100
+ self.referrer_policy = str(payload.get("security_headers_referrer_policy") or "strict-origin-when-cross-origin")
101
+
102
+ def _build_csp(self, nonce: str) -> str:
103
+ wildcard = ("https:",) if self.allow_all_https else ()
104
+ parts = [
105
+ "default-src 'self'",
106
+ " ".join(("script-src", "'self'", f"'nonce-{nonce}'", *wildcard, *self.all_domains, *self.script_src_domains)),
107
+ " ".join(("connect-src", "'self'", *wildcard, *self.all_domains, *self.connect_src_domains)),
108
+ " ".join(("img-src", "'self'", "data:", "blob:", *wildcard, *self.all_domains, *self.img_src_domains)),
109
+ " ".join(("media-src", "'self'", "data:", "blob:", *wildcard, *self.all_domains)),
110
+ "style-src 'self' 'unsafe-inline'",
111
+ "font-src 'self' data:",
112
+ "object-src 'none'",
113
+ "base-uri 'none'",
114
+ " ".join(("frame-src", "'self'", *wildcard, *self.all_domains, *self.frame_src_domains)),
115
+ ]
116
+ return "; ".join(part.strip() for part in parts if part.strip())
117
+
118
+ @staticmethod
119
+ def _inject_nonce(body: bytes, nonce: str) -> bytes:
120
+ html = body.decode("utf-8", errors="replace")
121
+ inline_script_pattern = re.compile(r"(<script)(?![^>]*\bsrc\s*=)([^>]*>)", re.IGNORECASE)
122
+ nonce_attr_pattern = re.compile(r"\snonce\s*=\s*(\"[^\"]*\"|'[^']*'|[^\s>]+)", re.IGNORECASE)
123
+
124
+ def rewrite_inline_script(match: re.Match[str]) -> str:
125
+ attrs = nonce_attr_pattern.sub("", match.group(2))
126
+ return f'{match.group(1)} nonce="{nonce}"{attrs}'
127
+
128
+ rewritten = inline_script_pattern.sub(rewrite_inline_script, html)
129
+ return rewritten.encode("utf-8")
130
+
131
+ @staticmethod
132
+ def _is_html_response(content_type: str) -> bool:
133
+ normalized = str(content_type or "").strip().lower()
134
+ return any(media_type in normalized for media_type in _HTML_CONTENT_TYPES)
135
+
136
+ def _frame_options_for_path(self, path: str) -> str | None:
137
+ normalized_path = str(path or "").strip() or "/"
138
+ for prefix in self.frame_options_exempt_paths:
139
+ normalized_prefix = str(prefix or "").strip()
140
+ if not normalized_prefix:
141
+ continue
142
+ if normalized_path == normalized_prefix or normalized_path.startswith(normalized_prefix.rstrip("/") + "/"):
143
+ return None
144
+ return self.frame_options
145
+
146
+ async def __call__(self, scope: Scope, receive: Receive, send: Send) -> None:
147
+ if scope.get("type") != "http":
148
+ await self.app(scope, receive, send)
149
+ return
150
+ request = Request(scope, receive=receive)
151
+ frame_options = self._frame_options_for_path(request.url.path)
152
+ nonce = secrets.token_urlsafe(16)
153
+ request.state.csp_nonce = nonce
154
+ response_start: Message | None = None
155
+ body_chunks: list[bytes] = []
156
+ should_buffer = False
157
+
158
+ async def send_wrapper(message: Message) -> None:
159
+ nonlocal response_start, should_buffer
160
+ if message["type"] == "http.response.start":
161
+ response_start = {
162
+ "type": "http.response.start",
163
+ "status": message["status"],
164
+ "headers": list(message.get("headers", [])),
165
+ }
166
+ headers = MutableHeaders(scope=response_start)
167
+ if frame_options is None:
168
+ try:
169
+ del headers["X-Frame-Options"]
170
+ except KeyError:
171
+ pass
172
+ else:
173
+ headers["X-Frame-Options"] = frame_options
174
+ headers["X-Content-Type-Options"] = self.content_type_options
175
+ headers["Referrer-Policy"] = self.referrer_policy
176
+ ctype = (headers.get("content-type") or "").lower()
177
+ enc = (headers.get("content-encoding") or "").lower()
178
+ should_apply_csp = self._is_html_response(ctype)
179
+ if should_apply_csp:
180
+ headers["Content-Security-Policy"] = self._build_csp(nonce)
181
+ should_buffer = should_apply_csp and not enc
182
+ if not should_buffer:
183
+ await send(response_start)
184
+ return
185
+ if message["type"] != "http.response.body" or not should_buffer or response_start is None:
186
+ await send(message)
187
+ return
188
+ body_chunks.append(message.get("body", b""))
189
+ if message.get("more_body", False):
190
+ return
191
+ rewritten = self._inject_nonce(b"".join(body_chunks), nonce)
192
+ headers = MutableHeaders(scope=response_start)
193
+ headers["Content-Length"] = str(len(rewritten))
194
+ await send(response_start)
195
+ await send({"type": "http.response.body", "body": rewritten, "more_body": False})
196
+
197
+ await self.app(scope, receive, send_wrapper)
198
+
199
+
200
+ __all__ = ["CSPNonceSecurityHeadersMiddleware"]
@@ -0,0 +1,44 @@
1
+ from __future__ import annotations
2
+
3
+ from starlette.types import ASGIApp, Message, Receive, Scope, Send
4
+
5
+ from .._settings import core_settings_payload, read_list
6
+ from .conflicts import assert_security_headers_no_conflict
7
+
8
+
9
+ class SecurityHeadersMiddleware:
10
+ def __init__(self, app: ASGIApp) -> None:
11
+ self.app = app
12
+ assert_security_headers_no_conflict()
13
+ payload = core_settings_payload()
14
+ raw_headers = payload.get("security_headers_raw_headers")
15
+ if isinstance(raw_headers, list):
16
+ compiled = []
17
+ for item in raw_headers:
18
+ if isinstance(item, (list, tuple)) and len(item) == 2:
19
+ compiled.append((str(item[0]).encode("latin-1"), str(item[1]).encode("latin-1")))
20
+ self._headers = compiled
21
+ else:
22
+ frame = str(payload.get("security_headers_frame_options") or "DENY")
23
+ referrer = str(payload.get("security_headers_referrer_policy") or "strict-origin-when-cross-origin")
24
+ content = str(payload.get("security_headers_content_type_options") or "nosniff")
25
+ self._headers = [
26
+ (b"x-frame-options", frame.encode("latin-1")),
27
+ (b"referrer-policy", referrer.encode("latin-1")),
28
+ (b"x-content-type-options", content.encode("latin-1")),
29
+ ]
30
+
31
+ async def __call__(self, scope: Scope, receive: Receive, send: Send) -> None:
32
+ if scope.get("type") != "http":
33
+ await self.app(scope, receive, send)
34
+ return
35
+
36
+ async def send_wrapper(message: Message) -> None:
37
+ if message["type"] == "http.response.start":
38
+ message["headers"] = list(message.get("headers", [])) + list(self._headers)
39
+ await send(message)
40
+
41
+ await self.app(scope, receive, send_wrapper)
42
+
43
+
44
+ __all__ = ["SecurityHeadersMiddleware"]
@@ -0,0 +1 @@
1
+
@@ -0,0 +1,22 @@
1
+ from __future__ import annotations
2
+
3
+ from dataclasses import dataclass
4
+
5
+
6
+ @dataclass(frozen=True, slots=True)
7
+ class FoundationCapability:
8
+ name: str
9
+ facade: str
10
+
11
+
12
+ SUPPORTED_FOUNDATION_CAPABILITIES: tuple[FoundationCapability, ...] = (
13
+ FoundationCapability(name="cache", facade="CacheFacade"),
14
+ FoundationCapability(name="database", facade="DatabaseFacade"),
15
+ FoundationCapability(name="health", facade="HealthFacade"),
16
+ FoundationCapability(name="mail", facade="MailFacade"),
17
+ FoundationCapability(name="observability", facade="ObservabilityFacade"),
18
+ FoundationCapability(name="storage", facade="StorageFacade"),
19
+ )
20
+
21
+
22
+ __all__ = ["FoundationCapability", "SUPPORTED_FOUNDATION_CAPABILITIES"]