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.
- pz_cli-5.0.0.dist-info/METADATA +51 -0
- pz_cli-5.0.0.dist-info/RECORD +399 -0
- pz_cli-5.0.0.dist-info/WHEEL +4 -0
- pz_cli-5.0.0.dist-info/entry_points.txt +5 -0
- pz_core/__init__.py +64 -0
- pz_core/__main__.py +7 -0
- pz_core/app.py +45 -0
- pz_core/assembly/__init__.py +17 -0
- pz_core/assembly/app_discovery.py +1240 -0
- pz_core/assembly/apps/__init__.py +25 -0
- pz_core/assembly/apps/compiler.py +824 -0
- pz_core/assembly/apps/providers.py +188 -0
- pz_core/assembly/cli/__init__.py +9 -0
- pz_core/assembly/cli/compiler.py +166 -0
- pz_core/assembly/diagnostics/__init__.py +21 -0
- pz_core/assembly/diagnostics/checks.py +257 -0
- pz_core/assembly/diagnostics/dev_sources.py +569 -0
- pz_core/assembly/events/__init__.py +5 -0
- pz_core/assembly/events/compiler.py +219 -0
- pz_core/assembly/extensions/__init__.py +5 -0
- pz_core/assembly/extensions/compiler.py +696 -0
- pz_core/assembly/infra/__init__.py +6 -0
- pz_core/assembly/infra/compiler.py +272 -0
- pz_core/assembly/lifecycle/__init__.py +5 -0
- pz_core/assembly/lifecycle/compiler.py +95 -0
- pz_core/assembly/middlewares/__init__.py +19 -0
- pz_core/assembly/middlewares/compiler.py +508 -0
- pz_core/assembly/project/__init__.py +7 -0
- pz_core/assembly/project/compiler.py +9 -0
- pz_core/assembly/project/context.py +17 -0
- pz_core/assembly/project/discovery.py +227 -0
- pz_core/assembly/resources/__init__.py +19 -0
- pz_core/assembly/resources/compiler.py +310 -0
- pz_core/assembly/resources/settings.py +129 -0
- pz_core/assembly/routes/__init__.py +7 -0
- pz_core/assembly/routes/compiler.py +400 -0
- pz_core/assembly/runtime_manifests/__init__.py +13 -0
- pz_core/assembly/runtime_manifests/compiler.py +159 -0
- pz_core/assembly/settings/__init__.py +17 -0
- pz_core/assembly/settings/compiler.py +786 -0
- pz_core/assembly/settings/host_project_overrides.py +82 -0
- pz_core/assembly/settings/host_runtime_endpoint.py +207 -0
- pz_core/authoring/__init__.py +79 -0
- pz_core/authoring/app_init_service.py +946 -0
- pz_core/authoring/app_versions.py +814 -0
- pz_core/authoring/cli.py +192 -0
- pz_core/authoring/commands.py +1810 -0
- pz_core/authoring/conflicts.py +180 -0
- pz_core/authoring/dev_bindings.py +916 -0
- pz_core/authoring/dev_git.py +1087 -0
- pz_core/authoring/dev_import.py +1061 -0
- pz_core/authoring/dev_manifest.py +522 -0
- pz_core/authoring/dev_sources.py +1638 -0
- pz_core/authoring/env_cli.py +454 -0
- pz_core/authoring/files.py +109 -0
- pz_core/authoring/ide_projection.py +1129 -0
- pz_core/authoring/naming.py +58 -0
- pz_core/authoring/official_dev_sources.py +432 -0
- pz_core/authoring/official_sources.json +156 -0
- pz_core/authoring/orchestration_service.py +558 -0
- pz_core/authoring/project_default.jsonc +53 -0
- pz_core/authoring/project_defaults.py +88 -0
- pz_core/authoring/project_metadata_service.py +199 -0
- pz_core/authoring/project_settings_checks.py +51 -0
- pz_core/authoring/project_settings_cli.py +299 -0
- pz_core/authoring/project_settings_service.py +1700 -0
- pz_core/authoring/project_state.py +399 -0
- pz_core/authoring/publish_git.py +423 -0
- pz_core/authoring/publish_lock.py +188 -0
- pz_core/authoring/publish_source.py +195 -0
- pz_core/authoring/release.py +1382 -0
- pz_core/authoring/repo_keys.py +29 -0
- pz_core/authoring/root_cli.py +28 -0
- pz_core/authoring/scaffold_service.py +325 -0
- pz_core/authoring/sync_service.py +787 -0
- pz_core/authoring/templates/app/__init__.py +1 -0
- pz_core/authoring/templates/app/api.py +25 -0
- pz_core/authoring/templates/app/apps.py +31 -0
- pz_core/authoring/templates/app/auth_package_init.py +14 -0
- pz_core/authoring/templates/app/auth_readme.py +29 -0
- pz_core/authoring/templates/app/configs_package_init.py +14 -0
- pz_core/authoring/templates/app/default_env.py +18 -0
- pz_core/authoring/templates/app/default_jsonc.py +25 -0
- pz_core/authoring/templates/app/locales_readme.py +25 -0
- pz_core/authoring/templates/app/migrations_readme.py +19 -0
- pz_core/authoring/templates/app/models.py +14 -0
- pz_core/authoring/templates/app/package_init.py +8 -0
- pz_core/authoring/templates/app/pages_base.py +161 -0
- pz_core/authoring/templates/app/pages_readme.py +25 -0
- pz_core/authoring/templates/app/public.py +31 -0
- pz_core/authoring/templates/app/pyproject.py +77 -0
- pz_core/authoring/templates/app/readme.py +74 -0
- pz_core/authoring/templates/app/settings.py +46 -0
- pz_core/authoring/templates/app/static_app_js.py +24 -0
- pz_core/authoring/templates/app/static_readme.py +31 -0
- pz_core/authoring/templates/app/template_config_page.py +23 -0
- pz_core/authoring/templates/app/template_index_html.py +28 -0
- pz_core/authoring/templates/app/templates_readme.py +32 -0
- pz_core/authoring/templates/app/urls.py +36 -0
- pz_core/authoring/templates/app/views.py +36 -0
- pz_core/authoring/templates/project/__init__.py +1 -0
- pz_core/authoring/templates/project/agents.py +51 -0
- pz_core/authoring/templates/project/apps_container_readme.py +37 -0
- pz_core/authoring/templates/project/main_py.py +59 -0
- pz_core/authoring/templates/project/project_env.py +19 -0
- pz_core/authoring/templates/project/pyproject.py +26 -0
- pz_core/authoring/templates/project/pz_env_env.py +65 -0
- pz_core/authoring/templates/project/pz_env_jsonc.py +69 -0
- pz_core/authoring/templates/project/pz_jsonc.py +12 -0
- pz_core/authoring/templates/project/readme.py +94 -0
- pz_core/authoring/templates/project/root_gitkeep.py +8 -0
- pz_core/authoring/templates/shared/__init__.py +5 -0
- pz_core/authoring/templates/shared/text.py +10 -0
- pz_core/authoring/venv_service.py +87 -0
- pz_core/authoring/workspace.py +167 -0
- pz_core/cli.py +291 -0
- pz_core/cli_options.py +74 -0
- pz_core/core/__init__.py +3 -0
- pz_core/core/errors/__init__.py +5 -0
- pz_core/core/errors/models.py +117 -0
- pz_core/core/events/__init__.py +5 -0
- pz_core/core/events/registry.py +54 -0
- pz_core/core/extensions/__init__.py +51 -0
- pz_core/core/extensions/registry.py +790 -0
- pz_core/core/health/__init__.py +6 -0
- pz_core/core/health/contracts.py +10 -0
- pz_core/core/middlewares/__init__.py +6 -0
- pz_core/core/middlewares/models.py +24 -0
- pz_core/core/routing/__init__.py +5 -0
- pz_core/core/routing/models.py +21 -0
- pz_core/core/settings_contracts.py +25 -0
- pz_core/docs/README.md +20 -0
- pz_core/docs/distribution-README.md +438 -0
- pz_core/docs/pz/345/221/275/344/273/244/346/200/273/350/247/210.md +1011 -0
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- pz_core/docs/pz/350/247/204/350/214/203/344/270/216/344/275/277/347/224/250/README.md +98 -0
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- pz_core/docs//345/217/221/347/211/210/345/211/215/346/270/205/345/215/225-4.0.11.md +84 -0
- pz_core/docs//346/226/260/346/211/213/346/214/207/345/215/227.md +422 -0
- pz_core/infra/__init__.py +17 -0
- pz_core/infra/db/__init__.py +23 -0
- pz_core/infra/db/contracts.py +73 -0
- pz_core/infra/health/__init__.py +5 -0
- pz_core/infra/health/contracts.py +8 -0
- pz_core/infra/kv/__init__.py +5 -0
- pz_core/infra/kv/contracts.py +17 -0
- pz_core/infra/observability/__init__.py +23 -0
- pz_core/infra/observability/contracts.py +142 -0
- pz_core/infra/resilience/__init__.py +5 -0
- pz_core/infra/resilience/contracts.py +17 -0
- pz_core/infra/resources/__init__.py +5 -0
- pz_core/infra/resources/contracts.py +16 -0
- pz_core/infra/settings/__init__.py +17 -0
- pz_core/infra/settings/models.py +81 -0
- pz_core/infra/storage/__init__.py +5 -0
- pz_core/infra/storage/ports.py +27 -0
- pz_core/project_root_commands.py +282 -0
- pz_core/project_runtime_cli.py +344 -0
- pz_core/project_sources.py +253 -0
- pz_core/pz_launcher.py +209 -0
- pz_core/root_cli.py +70 -0
- pz_core/runtime/__init__.py +229 -0
- pz_core/runtime/access.py +86 -0
- pz_core/runtime/adapters/__init__.py +5 -0
- pz_core/runtime/adapters/base.py +18 -0
- pz_core/runtime/asyncio_bridge.py +18 -0
- pz_core/runtime/bindings/__init__.py +5 -0
- pz_core/runtime/bindings/container.py +50 -0
- pz_core/runtime/cli/__init__.py +5 -0
- pz_core/runtime/cli/_args.py +67 -0
- pz_core/runtime/cli/app_commands.py +417 -0
- pz_core/runtime/cli/check.py +214 -0
- pz_core/runtime/cli/db.py +297 -0
- pz_core/runtime/cli/main.py +89 -0
- pz_core/runtime/cli/resources.py +280 -0
- pz_core/runtime/discovery.py +23 -0
- pz_core/runtime/environment_integrity.py +157 -0
- pz_core/runtime/errors.py +5 -0
- pz_core/runtime/events.py +87 -0
- pz_core/runtime/facades/__init__.py +38 -0
- pz_core/runtime/facades/_capabilities.py +46 -0
- pz_core/runtime/facades/cache.py +103 -0
- pz_core/runtime/facades/database.py +71 -0
- pz_core/runtime/facades/events.py +380 -0
- pz_core/runtime/facades/health.py +101 -0
- pz_core/runtime/facades/mail.py +121 -0
- pz_core/runtime/facades/observability.py +102 -0
- pz_core/runtime/facades/providers.py +75 -0
- pz_core/runtime/facades/resources.py +52 -0
- pz_core/runtime/facades/storage.py +296 -0
- pz_core/runtime/health/__init__.py +5 -0
- pz_core/runtime/health/service.py +102 -0
- pz_core/runtime/host.py +188 -0
- pz_core/runtime/host_runner.py +282 -0
- pz_core/runtime/http/__init__.py +20 -0
- pz_core/runtime/http/app.py +576 -0
- pz_core/runtime/http_timing.py +173 -0
- pz_core/runtime/invocation.py +29 -0
- pz_core/runtime/json_safe.py +47 -0
- pz_core/runtime/lifecycle/__init__.py +25 -0
- pz_core/runtime/lifecycle/manager.py +533 -0
- pz_core/runtime/plan.py +214 -0
- pz_core/runtime/plan_context.py +33 -0
- pz_core/runtime/plan_snapshot.py +177 -0
- pz_core/runtime/registries/__init__.py +27 -0
- pz_core/runtime/registries/capabilities.py +101 -0
- pz_core/runtime/registries/providers.py +396 -0
- pz_core/runtime/resource_assets.py +344 -0
- pz_core/runtime/run_cli.py +211 -0
- pz_core/runtime/settings.py +888 -0
- pz_core/runtime/worker/__init__.py +21 -0
- pz_core/runtime/worker/engine.py +921 -0
- pz_core/runtime/worker/runtime.py +25 -0
- pz_core/testing/__init__.py +15 -0
- pz_core/testing/doc_route_contracts.py +305 -0
- pz_core/utils/__init__.py +44 -0
- pz_core/utils/env.py +65 -0
- pz_core/utils/project_jsonc/__init__.py +29 -0
- pz_core/utils/project_jsonc/document.py +420 -0
- pz_core/utils/project_settings.py +99 -0
- pz_foundation/__init__.py +50 -0
- pz_foundation/_contracts.py +81 -0
- pz_foundation/_errors.py +34 -0
- pz_foundation/api.py +14 -0
- pz_foundation/apps.py +127 -0
- pz_foundation/auth/__init__.py +1 -0
- pz_foundation/cache_control.py +233 -0
- pz_foundation/cli/__init__.py +2 -0
- pz_foundation/cli/workers.py +565 -0
- pz_foundation/configs/__init__.py +0 -0
- pz_foundation/configs/default.env +15 -0
- pz_foundation/configs/default.jsonc +452 -0
- pz_foundation/db/__init__.py +94 -0
- pz_foundation/db/aerich_executor.py +664 -0
- pz_foundation/db/config.py +358 -0
- pz_foundation/db/connection_manager.py +689 -0
- pz_foundation/db/connection_probe.py +204 -0
- pz_foundation/db/database.py +1291 -0
- pz_foundation/db/deps.py +47 -0
- pz_foundation/db/lifecycle_status.py +85 -0
- pz_foundation/db/migrations.py +477 -0
- pz_foundation/db/mysql.py +57 -0
- pz_foundation/db/postgresql.py +409 -0
- pz_foundation/db/production_pool_fallback.py +143 -0
- pz_foundation/db/public.py +45 -0
- pz_foundation/db/session.py +369 -0
- pz_foundation/db/sqlite.py +15 -0
- pz_foundation/db/tortoise_manager.py +724 -0
- pz_foundation/db/tortoise_psycopg.py +148 -0
- pz_foundation/docs/README.md +18 -0
- pz_foundation/docs/distribution-README.md +319 -0
- 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
- 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
- pz_foundation/docs//350/256/276/350/256/241/346/226/207/346/241/243.md +288 -0
- 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
- pz_foundation/health.py +105 -0
- pz_foundation/host/__init__.py +11 -0
- pz_foundation/host/builder.py +34 -0
- pz_foundation/host/cache_runtime.py +44 -0
- pz_foundation/host/db/__init__.py +17 -0
- pz_foundation/host/db/aerich_config.py +36 -0
- pz_foundation/host/db/config.py +106 -0
- pz_foundation/host/db/connection_manager.py +48 -0
- pz_foundation/host/db/deps.py +5 -0
- pz_foundation/host/db/orm_retry_patch.py +566 -0
- pz_foundation/host/db/request_adapter.py +325 -0
- pz_foundation/host/db/router.py +28 -0
- pz_foundation/host/db/session.py +284 -0
- pz_foundation/host/db/tortoise_manager.py +10 -0
- pz_foundation/host/idempotency.py +132 -0
- pz_foundation/host/lifespan.py +247 -0
- pz_foundation/host/redis_runtime.py +100 -0
- pz_foundation/host/web.py +790 -0
- pz_foundation/infra_provider.py +236 -0
- pz_foundation/kv/__init__.py +25 -0
- pz_foundation/kv/cache.py +1166 -0
- pz_foundation/kv/deps.py +84 -0
- pz_foundation/kv/public.py +25 -0
- pz_foundation/kv/redis_manager.py +1531 -0
- pz_foundation/lazy_exports.py +43 -0
- pz_foundation/lazy_imports.py +124 -0
- pz_foundation/lifecycle.py +392 -0
- pz_foundation/managed_workers.py +1117 -0
- pz_foundation/middlewares/__init__.py +26 -0
- pz_foundation/middlewares/_settings.py +250 -0
- pz_foundation/middlewares/analytics.py +124 -0
- pz_foundation/middlewares/cache_control.py +156 -0
- pz_foundation/middlewares/compression.py +202 -0
- pz_foundation/middlewares/cors.py +62 -0
- pz_foundation/middlewares/geo_country.py +44 -0
- pz_foundation/middlewares/inner_router.py +50 -0
- pz_foundation/middlewares/rate_limited/__init__.py +3 -0
- pz_foundation/middlewares/rate_limited/key_limiter.py +115 -0
- pz_foundation/middlewares/request_logging.py +104 -0
- pz_foundation/middlewares/route_owner.py +309 -0
- pz_foundation/middlewares/security_csrf.py +44 -0
- pz_foundation/middlewares/security_headers/__init__.py +4 -0
- pz_foundation/middlewares/security_headers/conflicts.py +44 -0
- pz_foundation/middlewares/security_headers/csp_nonce.py +200 -0
- pz_foundation/middlewares/security_headers/security_headers.py +44 -0
- pz_foundation/migrations/__init__.py +1 -0
- pz_foundation/migrations/pz_foundation/__init__.py +1 -0
- pz_foundation/models.py +22 -0
- pz_foundation/notifications/__init__.py +23 -0
- pz_foundation/notifications/email.py +542 -0
- pz_foundation/notifications/public.py +31 -0
- pz_foundation/observability/__init__.py +71 -0
- pz_foundation/observability/http.py +34 -0
- pz_foundation/observability/logger/__init__.py +49 -0
- pz_foundation/observability/logger/_bot_settings.py +126 -0
- pz_foundation/observability/logger/bot_message.py +592 -0
- pz_foundation/observability/logger/core.py +385 -0
- pz_foundation/observability/logger/delivery_audit.py +84 -0
- pz_foundation/observability/logger/feishu_bot.py +199 -0
- pz_foundation/observability/logger/telegram_bot.py +194 -0
- pz_foundation/observability/metrics.py +365 -0
- pz_foundation/observability/runtime.py +68 -0
- pz_foundation/public.py +405 -0
- pz_foundation/resources/__init__.py +12 -0
- pz_foundation/resources/builder.py +900 -0
- pz_foundation/resources/images.py +363 -0
- pz_foundation/root_cli.py +20 -0
- pz_foundation/routing/__init__.py +203 -0
- pz_foundation/routing/canonical.py +486 -0
- pz_foundation/routing/convertors.py +82 -0
- pz_foundation/routing/declarations.py +843 -0
- pz_foundation/routing/exports.py +148 -0
- pz_foundation/routing/loaders.py +138 -0
- pz_foundation/routing/manifest.py +215 -0
- pz_foundation/routing/manifest_provider.py +47 -0
- pz_foundation/routing/mounts.py +101 -0
- pz_foundation/routing/ordering.py +172 -0
- pz_foundation/routing/registry.py +133 -0
- pz_foundation/routing/utils.py +28 -0
- pz_foundation/runtime.py +234 -0
- pz_foundation/settings.py +253 -0
- pz_foundation/settings_normalization.py +130 -0
- pz_foundation/storage/__init__.py +25 -0
- pz_foundation/storage/local.py +209 -0
- pz_foundation/storage/public.py +106 -0
- pz_foundation/storage/s3.py +116 -0
- pz_foundation/storage/service.py +234 -0
- pz_foundation/urls.py +19 -0
- pz_foundation/utils/__init__.py +6 -0
- pz_foundation/utils/merge.py +160 -0
- pz_foundation/worker_replicas.py +55 -0
- pz_settings_center/__init__.py +5 -0
- pz_settings_center/api/__init__.py +5 -0
- pz_settings_center/api/runtime_overrides.py +360 -0
- pz_settings_center/apps.py +28 -0
- pz_settings_center/configs/__init__.py +0 -0
- pz_settings_center/configs/default.env +2 -0
- pz_settings_center/configs/default.jsonc +1 -0
- pz_settings_center/docs/01-settings_center/350/203/275/345/212/233/350/276/271/347/225/214.md +124 -0
- pz_settings_center/docs/README.md +12 -0
- pz_settings_center/docs/distribution-README.md +150 -0
- pz_settings_center/docs//350/256/276/350/256/241/346/226/207/346/241/243.md +48 -0
- pz_settings_center/integration_payload.py +18 -0
- pz_settings_center/project_helpers.py +405 -0
- pz_settings_center/public.py +139 -0
- pz_settings_center/routing_helpers.py +73 -0
- pz_settings_center/runtime_override_provider.py +61 -0
- pz_settings_center/typed_settings.py +324 -0
- 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,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 @@
|
|
|
1
|
+
|
pz_foundation/models.py
ADDED
|
@@ -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"]
|