trueppm-api 0.4.0b2__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.
- trueppm_api/__init__.py +14 -0
- trueppm_api/apps/access/__init__.py +0 -0
- trueppm_api/apps/access/apps.py +19 -0
- trueppm_api/apps/access/groups.py +518 -0
- trueppm_api/apps/access/management/__init__.py +0 -0
- trueppm_api/apps/access/management/commands/__init__.py +0 -0
- trueppm_api/apps/access/management/commands/create_admin.py +164 -0
- trueppm_api/apps/access/management/commands/migrate_locked.py +96 -0
- trueppm_api/apps/access/management/commands/revoke_api_tokens.py +209 -0
- trueppm_api/apps/access/migrations/0001_initial.py +61 -0
- trueppm_api/apps/access/migrations/0001_squashed_0012_programmembership_role_title.py +167 -0
- trueppm_api/apps/access/migrations/0002_alter_projectmembership_id.py +29 -0
- trueppm_api/apps/access/migrations/0003_projectmembership_soft_delete.py +24 -0
- trueppm_api/apps/access/migrations/0004_alter_projectmembership_role.py +34 -0
- trueppm_api/apps/access/migrations/0005_program_entity_and_membership.py +76 -0
- trueppm_api/apps/access/migrations/0006_role_ordinal_spacing.py +113 -0
- trueppm_api/apps/access/migrations/0007_projectmembership_joined_at_and_more.py +35 -0
- trueppm_api/apps/access/migrations/0008_projectmembership_source_group.py +25 -0
- trueppm_api/apps/access/migrations/0009_projectmembership_pm_proj_serverver_idx.py +20 -0
- trueppm_api/apps/access/migrations/0010_programmembership_joined_at_and_more.py +38 -0
- trueppm_api/apps/access/migrations/0011_alter_programmembership_unique_together_and_more.py +36 -0
- trueppm_api/apps/access/migrations/0012_programmembership_role_title.py +17 -0
- trueppm_api/apps/access/migrations/0013_userdefinedmentiongroup.py +82 -0
- trueppm_api/apps/access/migrations/0014_programmembership_progm_serverver_idx.py +19 -0
- trueppm_api/apps/access/migrations/0015_programuserdefinedmentiongroup.py +86 -0
- trueppm_api/apps/access/migrations/0016_externalstakeholder.py +67 -0
- trueppm_api/apps/access/migrations/0017_viewer_ordinal_one.py +132 -0
- trueppm_api/apps/access/migrations/0018_programmembership_sync_seq_and_more.py +52 -0
- trueppm_api/apps/access/migrations/0019_programmembership_reinstated_at_and_more.py +22 -0
- trueppm_api/apps/access/migrations/__init__.py +0 -0
- trueppm_api/apps/access/models.py +588 -0
- trueppm_api/apps/access/permissions.py +2837 -0
- trueppm_api/apps/access/serializers.py +946 -0
- trueppm_api/apps/access/services.py +667 -0
- trueppm_api/apps/access/signals.py +103 -0
- trueppm_api/apps/access/tasks.py +50 -0
- trueppm_api/apps/access/throttles.py +95 -0
- trueppm_api/apps/access/urls.py +191 -0
- trueppm_api/apps/access/views.py +1931 -0
- trueppm_api/apps/agents/__init__.py +6 -0
- trueppm_api/apps/agents/apps.py +11 -0
- trueppm_api/apps/agents/canonical.py +73 -0
- trueppm_api/apps/agents/deferred.py +108 -0
- trueppm_api/apps/agents/management/__init__.py +0 -0
- trueppm_api/apps/agents/management/commands/__init__.py +0 -0
- trueppm_api/apps/agents/management/commands/audit_prune.py +137 -0
- trueppm_api/apps/agents/management/commands/audit_verify.py +101 -0
- trueppm_api/apps/agents/middleware.py +44 -0
- trueppm_api/apps/agents/migrations/0001_initial.py +231 -0
- trueppm_api/apps/agents/migrations/0002_agentactioncheckpoint.py +71 -0
- trueppm_api/apps/agents/migrations/0003_agentactionrefusaldetail.py +58 -0
- trueppm_api/apps/agents/migrations/__init__.py +0 -0
- trueppm_api/apps/agents/models.py +371 -0
- trueppm_api/apps/agents/refusal.py +103 -0
- trueppm_api/apps/agents/serializers.py +85 -0
- trueppm_api/apps/agents/services.py +397 -0
- trueppm_api/apps/agents/signals.py +30 -0
- trueppm_api/apps/agents/urls.py +15 -0
- trueppm_api/apps/agents/views.py +108 -0
- trueppm_api/apps/csvimport/__init__.py +12 -0
- trueppm_api/apps/csvimport/apps.py +11 -0
- trueppm_api/apps/csvimport/mapping.py +363 -0
- trueppm_api/apps/csvimport/migrations/0001_initial.py +74 -0
- trueppm_api/apps/csvimport/migrations/0002_schedule_outline_batch_operations.py +37 -0
- trueppm_api/apps/csvimport/migrations/0003_csvimportrequest_date_order_and_more.py +26 -0
- trueppm_api/apps/csvimport/migrations/__init__.py +0 -0
- trueppm_api/apps/csvimport/models.py +111 -0
- trueppm_api/apps/csvimport/parser.py +1825 -0
- trueppm_api/apps/csvimport/services.py +48 -0
- trueppm_api/apps/csvimport/tasks.py +418 -0
- trueppm_api/apps/csvimport/template.py +37 -0
- trueppm_api/apps/csvimport/urls.py +50 -0
- trueppm_api/apps/csvimport/views.py +793 -0
- trueppm_api/apps/history/__init__.py +0 -0
- trueppm_api/apps/history/apps.py +12 -0
- trueppm_api/apps/history/changelog.py +359 -0
- trueppm_api/apps/history/diff_policy.py +177 -0
- trueppm_api/apps/history/serializers.py +104 -0
- trueppm_api/apps/history/signals.py +82 -0
- trueppm_api/apps/history/tasks.py +105 -0
- trueppm_api/apps/history/urls.py +38 -0
- trueppm_api/apps/history/views.py +443 -0
- trueppm_api/apps/idempotency/__init__.py +0 -0
- trueppm_api/apps/idempotency/apps.py +11 -0
- trueppm_api/apps/idempotency/migrations/0001_initial.py +71 -0
- trueppm_api/apps/idempotency/migrations/__init__.py +0 -0
- trueppm_api/apps/idempotency/mixins.py +226 -0
- trueppm_api/apps/idempotency/models.py +75 -0
- trueppm_api/apps/idempotency/tasks.py +61 -0
- trueppm_api/apps/integrations/__init__.py +13 -0
- trueppm_api/apps/integrations/apps.py +59 -0
- trueppm_api/apps/integrations/connections.py +806 -0
- trueppm_api/apps/integrations/encryption.py +92 -0
- trueppm_api/apps/integrations/external_sources.py +837 -0
- trueppm_api/apps/integrations/git_automation_services.py +231 -0
- trueppm_api/apps/integrations/git_webhook_auth.py +243 -0
- trueppm_api/apps/integrations/http.py +403 -0
- trueppm_api/apps/integrations/me_work.py +218 -0
- trueppm_api/apps/integrations/migrations/0001_initial.py +64 -0
- trueppm_api/apps/integrations/migrations/0001_squashed_0006_tasklink_description_tasklink_preview_type_and_more.py +187 -0
- trueppm_api/apps/integrations/migrations/0002_tasklink.py +67 -0
- trueppm_api/apps/integrations/migrations/0003_tasklink_tasklink_serverver_idx.py +17 -0
- trueppm_api/apps/integrations/migrations/0004_tasklink_custom_title_tasklink_labels.py +25 -0
- trueppm_api/apps/integrations/migrations/0005_boardautomation.py +56 -0
- trueppm_api/apps/integrations/migrations/0006_tasklink_description_tasklink_preview_type_and_more.py +40 -0
- trueppm_api/apps/integrations/migrations/0007_tasklink_created_at.py +23 -0
- trueppm_api/apps/integrations/migrations/0008_integrationcredential_config_externalworkitem.py +66 -0
- trueppm_api/apps/integrations/migrations/0009_externalsyncrequest_and_more.py +96 -0
- trueppm_api/apps/integrations/migrations/0010_externalworkitem_due_date.py +17 -0
- trueppm_api/apps/integrations/migrations/0011_tasklink_sync_seq_tasklink_tasklink_syncseq_idx.py +22 -0
- trueppm_api/apps/integrations/migrations/0012_boardautomation_last_delivery_at_and_more.py +42 -0
- trueppm_api/apps/integrations/migrations/0013_externalsyncrequest_attempt_count_and_more.py +26 -0
- trueppm_api/apps/integrations/migrations/__init__.py +0 -0
- trueppm_api/apps/integrations/models.py +622 -0
- trueppm_api/apps/integrations/notification_channels.py +57 -0
- trueppm_api/apps/integrations/opengraph.py +229 -0
- trueppm_api/apps/integrations/outgoing.py +201 -0
- trueppm_api/apps/integrations/providers.py +519 -0
- trueppm_api/apps/integrations/registry.py +345 -0
- trueppm_api/apps/integrations/serializers.py +453 -0
- trueppm_api/apps/integrations/services.py +171 -0
- trueppm_api/apps/integrations/tasks.py +731 -0
- trueppm_api/apps/integrations/throttles.py +165 -0
- trueppm_api/apps/integrations/urls.py +77 -0
- trueppm_api/apps/integrations/views.py +1106 -0
- trueppm_api/apps/jiraimport/__init__.py +8 -0
- trueppm_api/apps/jiraimport/apps.py +11 -0
- trueppm_api/apps/jiraimport/migrations/0001_initial.py +72 -0
- trueppm_api/apps/jiraimport/migrations/__init__.py +0 -0
- trueppm_api/apps/jiraimport/models.py +70 -0
- trueppm_api/apps/jiraimport/parser.py +350 -0
- trueppm_api/apps/jiraimport/services.py +46 -0
- trueppm_api/apps/jiraimport/tasks.py +277 -0
- trueppm_api/apps/jiraimport/urls.py +15 -0
- trueppm_api/apps/jiraimport/views.py +153 -0
- trueppm_api/apps/msproject/__init__.py +0 -0
- trueppm_api/apps/msproject/apps.py +11 -0
- trueppm_api/apps/msproject/dataclasses.py +153 -0
- trueppm_api/apps/msproject/exporter.py +500 -0
- trueppm_api/apps/msproject/extended_attributes.py +77 -0
- trueppm_api/apps/msproject/importer.py +1095 -0
- trueppm_api/apps/msproject/migrations/0001_import_request.py +77 -0
- trueppm_api/apps/msproject/migrations/0001_squashed_0002_importrequest_creates_project.py +80 -0
- trueppm_api/apps/msproject/migrations/0002_importrequest_creates_project.py +15 -0
- trueppm_api/apps/msproject/migrations/__init__.py +0 -0
- trueppm_api/apps/msproject/models.py +81 -0
- trueppm_api/apps/msproject/parser.py +1231 -0
- trueppm_api/apps/msproject/serializers.py +136 -0
- trueppm_api/apps/msproject/services.py +58 -0
- trueppm_api/apps/msproject/tasks.py +436 -0
- trueppm_api/apps/msproject/urls.py +39 -0
- trueppm_api/apps/msproject/views.py +531 -0
- trueppm_api/apps/notifications/__init__.py +7 -0
- trueppm_api/apps/notifications/apps.py +15 -0
- trueppm_api/apps/notifications/backfill.py +79 -0
- trueppm_api/apps/notifications/categories.py +112 -0
- trueppm_api/apps/notifications/delivery_limits.py +258 -0
- trueppm_api/apps/notifications/digests.py +447 -0
- trueppm_api/apps/notifications/email_backend.py +330 -0
- trueppm_api/apps/notifications/email_health.py +128 -0
- trueppm_api/apps/notifications/migrations/0001_initial.py +207 -0
- trueppm_api/apps/notifications/migrations/0001_squashed_0006_notification_task.py +294 -0
- trueppm_api/apps/notifications/migrations/0002_project_notification_preference.py +67 -0
- trueppm_api/apps/notifications/migrations/0003_projectnotificationpreference_paused.py +17 -0
- trueppm_api/apps/notifications/migrations/0004_clean_unknown_matrix_keys.py +30 -0
- trueppm_api/apps/notifications/migrations/0005_notification_body_notification_event_type_and_more.py +27 -0
- trueppm_api/apps/notifications/migrations/0006_notification_task.py +25 -0
- trueppm_api/apps/notifications/migrations/0007_workspaceemailsettings.py +80 -0
- trueppm_api/apps/notifications/migrations/0008_notification_snoozed_until.py +17 -0
- trueppm_api/apps/notifications/migrations/0009_usernotificationsettings.py +43 -0
- trueppm_api/apps/notifications/migrations/0010_projectnotificationpreference_schema_version.py +20 -0
- trueppm_api/apps/notifications/migrations/0011_usernotificationsettings_digest_hour_and_more.py +96 -0
- trueppm_api/apps/notifications/migrations/__init__.py +0 -0
- trueppm_api/apps/notifications/models.py +1197 -0
- trueppm_api/apps/notifications/receivers.py +155 -0
- trueppm_api/apps/notifications/schema_migrations.py +56 -0
- trueppm_api/apps/notifications/serializers.py +961 -0
- trueppm_api/apps/notifications/services.py +1451 -0
- trueppm_api/apps/notifications/tasks.py +711 -0
- trueppm_api/apps/notifications/throttles.py +98 -0
- trueppm_api/apps/notifications/urls.py +97 -0
- trueppm_api/apps/notifications/views.py +904 -0
- trueppm_api/apps/observability/__init__.py +0 -0
- trueppm_api/apps/observability/apps.py +31 -0
- trueppm_api/apps/observability/logging.py +213 -0
- trueppm_api/apps/observability/migrations/0001_initial.py +35 -0
- trueppm_api/apps/observability/migrations/0001_squashed_0003_alter_purgerun_trigger.py +154 -0
- trueppm_api/apps/observability/migrations/0002_purgerun_retentionpolicy_retentionschedule.py +131 -0
- trueppm_api/apps/observability/migrations/0003_alter_purgerun_trigger.py +21 -0
- trueppm_api/apps/observability/migrations/0004_alter_retentionpolicy_key.py +28 -0
- trueppm_api/apps/observability/migrations/__init__.py +0 -0
- trueppm_api/apps/observability/models.py +141 -0
- trueppm_api/apps/observability/otel/__init__.py +45 -0
- trueppm_api/apps/observability/otel/attributes.py +247 -0
- trueppm_api/apps/observability/otel/export_health.py +533 -0
- trueppm_api/apps/observability/otel/instrumentation.py +351 -0
- trueppm_api/apps/observability/otel/metrics.py +551 -0
- trueppm_api/apps/observability/otel/provider.py +511 -0
- trueppm_api/apps/observability/otel/request_attributes.py +204 -0
- trueppm_api/apps/observability/purge_registry.py +124 -0
- trueppm_api/apps/observability/retention.py +139 -0
- trueppm_api/apps/observability/selectors.py +969 -0
- trueppm_api/apps/observability/serializers.py +142 -0
- trueppm_api/apps/observability/services.py +407 -0
- trueppm_api/apps/observability/tasks.py +266 -0
- trueppm_api/apps/observability/urls.py +27 -0
- trueppm_api/apps/observability/views.py +523 -0
- trueppm_api/apps/profiles/__init__.py +0 -0
- trueppm_api/apps/profiles/apps.py +15 -0
- trueppm_api/apps/profiles/constants.py +54 -0
- trueppm_api/apps/profiles/migrations/0001_initial.py +55 -0
- trueppm_api/apps/profiles/migrations/0001_squashed_0004_userprofile_role_context.py +125 -0
- trueppm_api/apps/profiles/migrations/0002_userprofile_hidden_views.py +17 -0
- trueppm_api/apps/profiles/migrations/0003_projectvisit.py +63 -0
- trueppm_api/apps/profiles/migrations/0004_userprofile_role_context.py +26 -0
- trueppm_api/apps/profiles/migrations/0005_userprofile_schedule_in_deliver.py +20 -0
- trueppm_api/apps/profiles/migrations/0006_userprofile_date_format_userprofile_timezone.py +36 -0
- trueppm_api/apps/profiles/migrations/0007_userpin.py +91 -0
- trueppm_api/apps/profiles/migrations/0008_remove_userprofile_schedule_in_deliver.py +71 -0
- trueppm_api/apps/profiles/migrations/0009_auth_user_email_upper_idx.py +81 -0
- trueppm_api/apps/profiles/migrations/__init__.py +0 -0
- trueppm_api/apps/profiles/models.py +276 -0
- trueppm_api/apps/profiles/serializers.py +199 -0
- trueppm_api/apps/profiles/services.py +466 -0
- trueppm_api/apps/profiles/views.py +124 -0
- trueppm_api/apps/projects/__init__.py +0 -0
- trueppm_api/apps/projects/actual_date_rules.py +163 -0
- trueppm_api/apps/projects/amend.py +133 -0
- trueppm_api/apps/projects/apps.py +38 -0
- trueppm_api/apps/projects/asset_feed.py +459 -0
- trueppm_api/apps/projects/asset_views.py +317 -0
- trueppm_api/apps/projects/attachment_policy.py +278 -0
- trueppm_api/apps/projects/authentication.py +449 -0
- trueppm_api/apps/projects/backfill.py +287 -0
- trueppm_api/apps/projects/backlog_services.py +324 -0
- trueppm_api/apps/projects/backlog_views.py +302 -0
- trueppm_api/apps/projects/batch_operation_views.py +264 -0
- trueppm_api/apps/projects/blocker_services.py +510 -0
- trueppm_api/apps/projects/board_activity.py +462 -0
- trueppm_api/apps/projects/board_activity_views.py +186 -0
- trueppm_api/apps/projects/board_lanes.py +134 -0
- trueppm_api/apps/projects/bulk_settings.py +194 -0
- trueppm_api/apps/projects/bundled_templates.py +215 -0
- trueppm_api/apps/projects/calendar_settings.py +180 -0
- trueppm_api/apps/projects/ceremony_views.py +244 -0
- trueppm_api/apps/projects/commit_moment.py +204 -0
- trueppm_api/apps/projects/config_notice.py +1325 -0
- trueppm_api/apps/projects/custom_field_values.py +266 -0
- trueppm_api/apps/projects/decisions_services.py +93 -0
- trueppm_api/apps/projects/decisions_views.py +94 -0
- trueppm_api/apps/projects/estimation_scale.py +126 -0
- trueppm_api/apps/projects/export_bundle.py +353 -0
- trueppm_api/apps/projects/fixtures/seeds/atlas-platform-launch.json +4256 -0
- trueppm_api/apps/projects/fixtures/seeds/aurora-mobile-app.json +2000 -0
- trueppm_api/apps/projects/fixtures/seeds/bayside-civic-center.json +1825 -0
- trueppm_api/apps/projects/fixtures/seeds/ga-launch.json +1905 -0
- trueppm_api/apps/projects/fixtures/seeds/helios-crm-replacement.json +1409 -0
- trueppm_api/apps/projects/guardrail_policy_source.py +269 -0
- trueppm_api/apps/projects/inbound_sync.py +555 -0
- trueppm_api/apps/projects/iteration_label.py +85 -0
- trueppm_api/apps/projects/lifecycle.py +191 -0
- trueppm_api/apps/projects/management/__init__.py +0 -0
- trueppm_api/apps/projects/management/commands/__init__.py +0 -0
- trueppm_api/apps/projects/management/commands/backfill_in_progress_status.py +92 -0
- trueppm_api/apps/projects/management/commands/create_demo_share_link.py +368 -0
- trueppm_api/apps/projects/management/commands/export_program.py +50 -0
- trueppm_api/apps/projects/management/commands/import_seed.py +165 -0
- trueppm_api/apps/projects/management/commands/load_sample_project.py +247 -0
- trueppm_api/apps/projects/management/commands/seed_capacity.py +405 -0
- trueppm_api/apps/projects/management/commands/seed_integration_fixtures.py +178 -0
- trueppm_api/apps/projects/management/commands/shift_sample_dates.py +120 -0
- trueppm_api/apps/projects/mcp_settings.py +305 -0
- trueppm_api/apps/projects/methodology.py +178 -0
- trueppm_api/apps/projects/migrations/0001_initial.py +208 -0
- trueppm_api/apps/projects/migrations/0001_squashed_0094_project_decisions_policy.py +5595 -0
- trueppm_api/apps/projects/migrations/0002_alter_uuid_pk_serialize_false.py +57 -0
- trueppm_api/apps/projects/migrations/0003_rename_task_project_index.py +25 -0
- trueppm_api/apps/projects/migrations/0004_soft_delete_and_dependency_versioned.py +70 -0
- trueppm_api/apps/projects/migrations/0005_task_assignee.py +33 -0
- trueppm_api/apps/projects/migrations/0006_task_utilization_index.py +31 -0
- trueppm_api/apps/projects/migrations/0007_task_is_milestone.py +28 -0
- trueppm_api/apps/projects/migrations/0008_baseline.py +119 -0
- trueppm_api/apps/projects/migrations/0009_historicaldependency_historicalproject_and_more.py +210 -0
- trueppm_api/apps/projects/migrations/0010_risk.py +229 -0
- trueppm_api/apps/projects/migrations/0011_task_status.py +27 -0
- trueppm_api/apps/projects/migrations/0012_task_status.py +27 -0
- trueppm_api/apps/projects/migrations/0013_task_planned_start.py +24 -0
- trueppm_api/apps/projects/migrations/0014_short_hex_ids.py +74 -0
- trueppm_api/apps/projects/migrations/0015_backfill_short_ids.py +48 -0
- trueppm_api/apps/projects/migrations/0016_task_actual_dates.py +42 -0
- trueppm_api/apps/projects/migrations/0017_boardcolumnconfig.py +43 -0
- trueppm_api/apps/projects/migrations/0018_estimation_governance.py +62 -0
- trueppm_api/apps/projects/migrations/0019_backfill_wbs_paths.py +28 -0
- trueppm_api/apps/projects/migrations/0020_task_status_5col.py +65 -0
- trueppm_api/apps/projects/migrations/0021_boardsavedview.py +64 -0
- trueppm_api/apps/projects/migrations/0022_task_status_changed_at_priority_rank.py +35 -0
- trueppm_api/apps/projects/migrations/0023_risk_framework_fields.py +96 -0
- trueppm_api/apps/projects/migrations/0024_riskcomment.py +52 -0
- trueppm_api/apps/projects/migrations/0025_sprint.py +352 -0
- trueppm_api/apps/projects/migrations/0026_project_methodology.py +30 -0
- trueppm_api/apps/projects/migrations/0027_sprint_retro.py +89 -0
- trueppm_api/apps/projects/migrations/0028_normalize_notes_field.py +42 -0
- trueppm_api/apps/projects/migrations/0029_complete_implies_full_progress.py +38 -0
- trueppm_api/apps/projects/migrations/0030_review_implies_full_progress.py +37 -0
- trueppm_api/apps/projects/migrations/0031_task_remaining_points.py +22 -0
- trueppm_api/apps/projects/migrations/0032_task_is_subtask_and_sprint_scope_change.py +90 -0
- trueppm_api/apps/projects/migrations/0033_task_my_work_index.py +38 -0
- trueppm_api/apps/projects/migrations/0034_inbound_task_sync.py +313 -0
- trueppm_api/apps/projects/migrations/0035_retro_versioned_and_suggested_assignee.py +173 -0
- trueppm_api/apps/projects/migrations/0036_program_entity_and_membership.py +157 -0
- trueppm_api/apps/projects/migrations/0037_sprint_capacity_points.py +20 -0
- trueppm_api/apps/projects/migrations/0038_taskcomment_commentreaction_commentacknowledgement_and_more.py +233 -0
- trueppm_api/apps/projects/migrations/0039_apitoken_and_more.py +88 -0
- trueppm_api/apps/projects/migrations/0040_program_general_fields.py +119 -0
- trueppm_api/apps/projects/migrations/0041_ceremony_template_and_phase_gate_config.py +210 -0
- trueppm_api/apps/projects/migrations/0041_project_general_fields.py +106 -0
- trueppm_api/apps/projects/migrations/0042_merge_20260522_0410.py +12 -0
- trueppm_api/apps/projects/migrations/0042_program_rollup_config.py +95 -0
- trueppm_api/apps/projects/migrations/0042_workflow_color_and_custom_fields.py +94 -0
- trueppm_api/apps/projects/migrations/0043_merge_20260522_1118.py +10 -0
- trueppm_api/apps/projects/migrations/0044_merge_20260522_rollup.py +10 -0
- trueppm_api/apps/projects/migrations/0044_project_archive_program_close.py +119 -0
- trueppm_api/apps/projects/migrations/0045_program_risk_policy.py +78 -0
- trueppm_api/apps/projects/migrations/0046_merge_20260523_2248.py +12 -0
- trueppm_api/apps/projects/migrations/0047_apitokenauditentry_program_and_more.py +55 -0
- trueppm_api/apps/projects/migrations/0048_historicalprogram_color_program_color.py +32 -0
- trueppm_api/apps/projects/migrations/0049_backlog_item.py +112 -0
- trueppm_api/apps/projects/migrations/0050_backlog_item_trgm_search.py +26 -0
- trueppm_api/apps/projects/migrations/0051_alter_calendar_working_days_alter_dependency_lag_and_more.py +144 -0
- trueppm_api/apps/projects/migrations/0052_recurring_tasks.py +278 -0
- trueppm_api/apps/projects/migrations/0053_dependency_dep_pred_serverver_idx_and_more.py +56 -0
- trueppm_api/apps/projects/migrations/0054_sprintscopechange_goal_impact_and_more.py +117 -0
- trueppm_api/apps/projects/migrations/0055_historicaltask_sprint_pending_and_more.py +51 -0
- trueppm_api/apps/projects/migrations/0056_historicalproject_prioritization_model_and_more.py +276 -0
- trueppm_api/apps/projects/migrations/0057_historicalsprint_binding_committed_snapshot_and_more.py +58 -0
- trueppm_api/apps/projects/migrations/0058_historicaltask_delivery_mode_and_more.py +72 -0
- trueppm_api/apps/projects/migrations/0059_forecastsnapshot.py +80 -0
- trueppm_api/apps/projects/migrations/0060_historicalprojectsignalprivacypolicy_and_more.py +90 -0
- trueppm_api/apps/projects/migrations/0061_baselinetask_story_points.py +17 -0
- trueppm_api/apps/projects/migrations/0062_project_is_sample.py +22 -0
- trueppm_api/apps/projects/migrations/0063_historicalsprint_wip_limit_sprint_wip_limit.py +22 -0
- trueppm_api/apps/projects/migrations/0064_sprinttaskoutcome.py +97 -0
- trueppm_api/apps/projects/migrations/0065_historicalsprint_goal_outcome_sprint_goal_outcome.py +32 -0
- trueppm_api/apps/projects/migrations/0066_historicalproject_lead_project_lead.py +38 -0
- trueppm_api/apps/projects/migrations/0067_sprint_exclude_from_velocity.py +22 -0
- trueppm_api/apps/projects/migrations/0068_project_recalculated_at.py +23 -0
- trueppm_api/apps/projects/migrations/0069_iteration_label.py +22 -0
- trueppm_api/apps/projects/migrations/0070_historicalprogram_iteration_label_and_more.py +32 -0
- trueppm_api/apps/projects/migrations/0071_backfill_iteration_label_inherit.py +35 -0
- trueppm_api/apps/projects/migrations/0072_pulseresponse_retroboarditem.py +129 -0
- trueppm_api/apps/projects/migrations/0073_sprinttaskoutcome_demo_ready.py +17 -0
- trueppm_api/apps/projects/migrations/0074_historicaltask_blocked_reason_task_blocked_reason.py +30 -0
- trueppm_api/apps/projects/migrations/0075_risk_decimal_short_id.py +42 -0
- trueppm_api/apps/projects/migrations/0076_sprinttaskoutcome_review_polish.py +45 -0
- trueppm_api/apps/projects/migrations/0077_task_blocker_fields.py +111 -0
- trueppm_api/apps/projects/migrations/0078_alter_risktask_unique_together_and_more.py +22 -0
- trueppm_api/apps/projects/migrations/0079_historicalproject_status_date_project_status_date.py +22 -0
- trueppm_api/apps/projects/migrations/0080_alter_historicaltask_type_alter_task_type.py +46 -0
- trueppm_api/apps/projects/migrations/0081_historicalprogram_allow_guests_and_more.py +52 -0
- trueppm_api/apps/projects/migrations/0082_project_last_sync_version.py +90 -0
- trueppm_api/apps/projects/migrations/0083_historicalprogram_mc_history_attribution_audience_and_more.py +108 -0
- trueppm_api/apps/projects/migrations/0084_tasknote.py +71 -0
- trueppm_api/apps/projects/migrations/0085_sprint_ix_sprint_velocity.py +33 -0
- trueppm_api/apps/projects/migrations/0086_board_card_search_trgm.py +33 -0
- trueppm_api/apps/projects/migrations/0087_historicalprogram_task_duration_change_percent_policy_and_more.py +155 -0
- trueppm_api/apps/projects/migrations/0088_historicalprogram_allowed_attachment_types_and_more.py +61 -0
- trueppm_api/apps/projects/migrations/0089_signalceilingraiseproposal_signalceilingraisevote_and_more.py +157 -0
- trueppm_api/apps/projects/migrations/0090_historicaltask_proj_histdate_index.py +44 -0
- trueppm_api/apps/projects/migrations/0091_project_board_cadence.py +39 -0
- trueppm_api/apps/projects/migrations/0092_program_target_date.py +22 -0
- trueppm_api/apps/projects/migrations/0093_cross_project_dependency_consent.py +58 -0
- trueppm_api/apps/projects/migrations/0094_project_decisions_policy.py +90 -0
- trueppm_api/apps/projects/migrations/0095_poker_session_vote.py +127 -0
- trueppm_api/apps/projects/migrations/0095_squashed_0097_release_0_3.py +225 -0
- trueppm_api/apps/projects/migrations/0096_crossprojectslipconflict.py +91 -0
- trueppm_api/apps/projects/migrations/0097_backlogitem_backlogitem_tags_gin_and_more.py +32 -0
- trueppm_api/apps/projects/migrations/0098_historicalproject_show_baselines_and_more.py +52 -0
- trueppm_api/apps/projects/migrations/0099_apitoken_scopes.py +48 -0
- trueppm_api/apps/projects/migrations/0100_task_dep_serverver_idx_concurrent.py +61 -0
- trueppm_api/apps/projects/migrations/0101_dependency_deleted_at_task_deleted_at.py +22 -0
- trueppm_api/apps/projects/migrations/0102_project_deleted_at_project_proj_isdel_deletedat_idx.py +25 -0
- trueppm_api/apps/projects/migrations/0103_taskdurationchangeevent_task_dur_evt_sprint_idx.py +18 -0
- trueppm_api/apps/projects/migrations/0104_historicalproject_stale_task_threshold_days_and_more.py +32 -0
- trueppm_api/apps/projects/migrations/0104_trash_restore_1113.py +38 -0
- trueppm_api/apps/projects/migrations/0105_historical_changelog_indexes.py +62 -0
- trueppm_api/apps/projects/migrations/0106_boardsavedview_schema_version.py +20 -0
- trueppm_api/apps/projects/migrations/0107_task_activity_event.py +70 -0
- trueppm_api/apps/projects/migrations/0108_remove_apitoken_api_token_scope_xor_and_more.py +117 -0
- trueppm_api/apps/projects/migrations/0109_projectexportjob.py +82 -0
- trueppm_api/apps/projects/migrations/0110_sharelink.py +123 -0
- trueppm_api/apps/projects/migrations/0111_projectcalendarlayer.py +67 -0
- trueppm_api/apps/projects/migrations/0112_sharelink_expires_at_alter_sharelink_content_kind.py +31 -0
- trueppm_api/apps/projects/migrations/0113_alter_historicaltask_percent_complete_and_more.py +35 -0
- trueppm_api/apps/projects/migrations/0114_historicalproject_default_member_role_and_more.py +28 -0
- trueppm_api/apps/projects/migrations/0115_historicalproject_end_date_shift_threshold_days_and_more.py +22 -0
- trueppm_api/apps/projects/migrations/0116_alter_taskactivityevent_event_type.py +28 -0
- trueppm_api/apps/projects/migrations/0117_label_tasklabel_label_tasks_and_more.py +126 -0
- trueppm_api/apps/projects/migrations/0118_programexportjob.py +82 -0
- trueppm_api/apps/projects/migrations/0119_historicalprogram_calendar_program_calendar.py +36 -0
- trueppm_api/apps/projects/migrations/0120_alter_backlogitem_item_type.py +29 -0
- trueppm_api/apps/projects/migrations/0121_task_three_point_estimate_ordered.py +64 -0
- trueppm_api/apps/projects/migrations/0122_task_relation.py +173 -0
- trueppm_api/apps/projects/migrations/0123_remove_historicalproject_agile_features_and_more.py +20 -0
- trueppm_api/apps/projects/migrations/0124_dependency_is_driving.py +17 -0
- trueppm_api/apps/projects/migrations/0125_historicalprogram_estimation_scale_and_more.py +68 -0
- trueppm_api/apps/projects/migrations/0126_projectcustomfield_show_on_card_taskcustomfieldvalue.py +80 -0
- trueppm_api/apps/projects/migrations/0127_historicalprogram_mcp_enabled_and_more.py +32 -0
- trueppm_api/apps/projects/migrations/0128_acceptancecriterion_sync_seq_apitoken_sync_seq_and_more.py +192 -0
- trueppm_api/apps/projects/migrations/0129_sharelink_show_milestone_dates.py +20 -0
- trueppm_api/apps/projects/migrations/0130_programimportjob.py +85 -0
- trueppm_api/apps/projects/migrations/0131_historicalprogram_sprint_picker_ready_only_default_and_more.py +32 -0
- trueppm_api/apps/projects/migrations/0132_task_scheduled_start.py +17 -0
- trueppm_api/apps/projects/migrations/0133_project_status_date_floor_armed_at.py +17 -0
- trueppm_api/apps/projects/migrations/0134_task_edited_at_task_seeded_at_task_source_id_and_more.py +65 -0
- trueppm_api/apps/projects/migrations/0135_projecttemplate_templateapplication_and_more.py +175 -0
- trueppm_api/apps/projects/migrations/0136_schedule_outline_batch_operations.py +118 -0
- trueppm_api/apps/projects/migrations/0137_collapse_dual_scope_api_tokens.py +54 -0
- trueppm_api/apps/projects/migrations/0138_apitokenauditentry_api_token_audit_owner_idx.py +18 -0
- trueppm_api/apps/projects/migrations/0139_historicaltask_duration_unit_task_duration_unit.py +32 -0
- trueppm_api/apps/projects/migrations/0140_historicaltask_auto_container_and_more.py +113 -0
- trueppm_api/apps/projects/migrations/0141_historicalproject_draft_started_at_and_more.py +44 -0
- trueppm_api/apps/projects/migrations/0142_baseline_calendar_hours_per_day_and_more.py +31 -0
- trueppm_api/apps/projects/migrations/0143_sprintcloserequest_failure_reason_and_more.py +42 -0
- trueppm_api/apps/projects/migrations/0144_projecttemplate_source_project_and_more.py +35 -0
- trueppm_api/apps/projects/migrations/0145_seed_bundled_templates.py +65 -0
- trueppm_api/apps/projects/migrations/0146_historicaltask_board_lane_task_board_lane.py +32 -0
- trueppm_api/apps/projects/migrations/0147_structuraloperation.py +128 -0
- trueppm_api/apps/projects/migrations/0148_task_unique_task_wbs_path_per_project_live.py +76 -0
- trueppm_api/apps/projects/migrations/0149_drop_workshops_tables.py +42 -0
- trueppm_api/apps/projects/migrations/0150_clear_uncommitted_cpm_output.py +130 -0
- trueppm_api/apps/projects/migrations/0151_config_notice_request.py +70 -0
- trueppm_api/apps/projects/migrations/0152_aggregate_task_wbs_name_idx.py +20 -0
- trueppm_api/apps/projects/migrations/0153_program_sample_anchor_date.py +22 -0
- trueppm_api/apps/projects/migrations/__init__.py +0 -0
- trueppm_api/apps/projects/models.py +8946 -0
- trueppm_api/apps/projects/poker_services.py +154 -0
- trueppm_api/apps/projects/poker_views.py +398 -0
- trueppm_api/apps/projects/product_backlog_services.py +450 -0
- trueppm_api/apps/projects/program_label_services.py +94 -0
- trueppm_api/apps/projects/program_label_views.py +189 -0
- trueppm_api/apps/projects/program_rollup.py +575 -0
- trueppm_api/apps/projects/program_schedule.py +745 -0
- trueppm_api/apps/projects/program_views.py +3220 -0
- trueppm_api/apps/projects/project_templates.py +422 -0
- trueppm_api/apps/projects/receivers.py +234 -0
- trueppm_api/apps/projects/refusal_codes.py +140 -0
- trueppm_api/apps/projects/reorder_services.py +145 -0
- trueppm_api/apps/projects/restructure_hooks.py +54 -0
- trueppm_api/apps/projects/retro_board_services.py +368 -0
- trueppm_api/apps/projects/retro_services.py +285 -0
- trueppm_api/apps/projects/risk_import.py +396 -0
- trueppm_api/apps/projects/row_identity.py +113 -0
- trueppm_api/apps/projects/schema_migrations.py +228 -0
- trueppm_api/apps/projects/schemas/seed_v1.json +493 -0
- trueppm_api/apps/projects/schemas/seed_v2.json +892 -0
- trueppm_api/apps/projects/seed/__init__.py +61 -0
- trueppm_api/apps/projects/seed/exporter.py +1644 -0
- trueppm_api/apps/projects/seed/forecast_backfill.py +247 -0
- trueppm_api/apps/projects/seed/importer.py +2390 -0
- trueppm_api/apps/projects/seed/reanchor.py +551 -0
- trueppm_api/apps/projects/seed/reldates.py +126 -0
- trueppm_api/apps/projects/seed/replace.py +126 -0
- trueppm_api/apps/projects/seed/replay.py +1691 -0
- trueppm_api/apps/projects/seed/replay_ctx.py +41 -0
- trueppm_api/apps/projects/seed/samples.py +427 -0
- trueppm_api/apps/projects/seed/validation.py +1149 -0
- trueppm_api/apps/projects/serializers.py +12310 -0
- trueppm_api/apps/projects/services.py +6966 -0
- trueppm_api/apps/projects/share_serializers.py +132 -0
- trueppm_api/apps/projects/share_services.py +325 -0
- trueppm_api/apps/projects/share_views.py +374 -0
- trueppm_api/apps/projects/sharing_settings.py +187 -0
- trueppm_api/apps/projects/signal_privacy_services.py +909 -0
- trueppm_api/apps/projects/signal_privacy_views.py +476 -0
- trueppm_api/apps/projects/signals.py +132 -0
- trueppm_api/apps/projects/slip_conflict.py +266 -0
- trueppm_api/apps/projects/sprint_cadence.py +453 -0
- trueppm_api/apps/projects/sprint_picker_settings.py +132 -0
- trueppm_api/apps/projects/standup.py +304 -0
- trueppm_api/apps/projects/standup_views.py +99 -0
- trueppm_api/apps/projects/structural_operation_services.py +727 -0
- trueppm_api/apps/projects/structural_operation_views.py +311 -0
- trueppm_api/apps/projects/surface_visibility.py +126 -0
- trueppm_api/apps/projects/task_batch_services.py +379 -0
- trueppm_api/apps/projects/task_bulk.py +1152 -0
- trueppm_api/apps/projects/task_classification.py +561 -0
- trueppm_api/apps/projects/task_classification_defaults.py +95 -0
- trueppm_api/apps/projects/task_duration_settings.py +142 -0
- trueppm_api/apps/projects/task_grouping.py +754 -0
- trueppm_api/apps/projects/tasks.py +1917 -0
- trueppm_api/apps/projects/template_divergence.py +168 -0
- trueppm_api/apps/projects/template_services.py +160 -0
- trueppm_api/apps/projects/template_tasks.py +258 -0
- trueppm_api/apps/projects/template_views.py +799 -0
- trueppm_api/apps/projects/throttles.py +311 -0
- trueppm_api/apps/projects/urls.py +1011 -0
- trueppm_api/apps/projects/utilization.py +885 -0
- trueppm_api/apps/projects/views.py +20572 -0
- trueppm_api/apps/projects/wbs_paths.py +119 -0
- trueppm_api/apps/resources/__init__.py +0 -0
- trueppm_api/apps/resources/apps.py +8 -0
- trueppm_api/apps/resources/capacity.py +121 -0
- trueppm_api/apps/resources/migrations/0001_initial.py +68 -0
- trueppm_api/apps/resources/migrations/0001_squashed_0013_alter_projectresource_unique_together_and_more.py +281 -0
- trueppm_api/apps/resources/migrations/0002_alter_uuid_pk_serialize_false.py +36 -0
- trueppm_api/apps/resources/migrations/0003_resource_soft_delete.py +30 -0
- trueppm_api/apps/resources/migrations/0004_add_taskresource_resource_index.py +25 -0
- trueppm_api/apps/resources/migrations/0005_resource_job_role.py +20 -0
- trueppm_api/apps/resources/migrations/0006_skill.py +34 -0
- trueppm_api/apps/resources/migrations/0007_resource_skill.py +63 -0
- trueppm_api/apps/resources/migrations/0008_project_resource.py +63 -0
- trueppm_api/apps/resources/migrations/0009_task_skill_requirement.py +60 -0
- trueppm_api/apps/resources/migrations/0010_alter_resourceskill_options_and_more.py +20 -0
- trueppm_api/apps/resources/migrations/0011_alter_projectresource_notes.py +17 -0
- trueppm_api/apps/resources/migrations/0012_add_resource_user_fk.py +26 -0
- trueppm_api/apps/resources/migrations/0013_alter_projectresource_unique_together_and_more.py +53 -0
- trueppm_api/apps/resources/migrations/0014_projectresource_sync_seq_resource_sync_seq_and_more.py +37 -0
- trueppm_api/apps/resources/migrations/0015_projectresource_deactivated_with_resource.py +17 -0
- trueppm_api/apps/resources/migrations/__init__.py +0 -0
- trueppm_api/apps/resources/models.py +298 -0
- trueppm_api/apps/resources/serializers.py +426 -0
- trueppm_api/apps/resources/services.py +465 -0
- trueppm_api/apps/resources/urls.py +28 -0
- trueppm_api/apps/resources/views.py +1749 -0
- trueppm_api/apps/scheduling/__init__.py +0 -0
- trueppm_api/apps/scheduling/apps.py +153 -0
- trueppm_api/apps/scheduling/calendars.py +119 -0
- trueppm_api/apps/scheduling/deadletter.py +91 -0
- trueppm_api/apps/scheduling/forecast_history_settings.py +215 -0
- trueppm_api/apps/scheduling/forecast_staleness.py +313 -0
- trueppm_api/apps/scheduling/graph_guard.py +263 -0
- trueppm_api/apps/scheduling/management/__init__.py +0 -0
- trueppm_api/apps/scheduling/management/commands/__init__.py +0 -0
- trueppm_api/apps/scheduling/management/commands/prune_forecast_snapshots.py +53 -0
- trueppm_api/apps/scheduling/migrations/0001_failed_task.py +62 -0
- trueppm_api/apps/scheduling/migrations/0001_squashed_0007_projectforecastsnapshot.py +309 -0
- trueppm_api/apps/scheduling/migrations/0002_schedulerequest.py +78 -0
- trueppm_api/apps/scheduling/migrations/0003_add_schedule_request_reason.py +27 -0
- trueppm_api/apps/scheduling/migrations/0004_velocity_suggestion.py +94 -0
- trueppm_api/apps/scheduling/migrations/0005_montecarlorun.py +61 -0
- trueppm_api/apps/scheduling/migrations/0006_montecarlorun_distribution.py +17 -0
- trueppm_api/apps/scheduling/migrations/0007_projectforecastsnapshot.py +65 -0
- trueppm_api/apps/scheduling/migrations/0008_alter_schedulerequest_reason.py +28 -0
- trueppm_api/apps/scheduling/migrations/0008_folded_schedulerequest_reason.py +34 -0
- trueppm_api/apps/scheduling/migrations/0009_alter_schedulerequest_reason.py +29 -0
- trueppm_api/apps/scheduling/migrations/0010_failedtask_resolution_note_failedtask_resolved_at_and_more.py +43 -0
- trueppm_api/apps/scheduling/migrations/0011_failedtask_project.py +26 -0
- trueppm_api/apps/scheduling/migrations/0012_montecarlorun_diagnostic.py +17 -0
- trueppm_api/apps/scheduling/migrations/0013_montecarlorun_status_date.py +17 -0
- trueppm_api/apps/scheduling/migrations/0014_montecarlorun_plan_version.py +17 -0
- trueppm_api/apps/scheduling/migrations/__init__.py +0 -0
- trueppm_api/apps/scheduling/models.py +516 -0
- trueppm_api/apps/scheduling/receivers.py +160 -0
- trueppm_api/apps/scheduling/risk_premium.py +283 -0
- trueppm_api/apps/scheduling/serializers.py +564 -0
- trueppm_api/apps/scheduling/services.py +1182 -0
- trueppm_api/apps/scheduling/signals.py +56 -0
- trueppm_api/apps/scheduling/tasks.py +1984 -0
- trueppm_api/apps/scheduling/telemetry.py +80 -0
- trueppm_api/apps/scheduling/units.py +35 -0
- trueppm_api/apps/scheduling/urls.py +57 -0
- trueppm_api/apps/scheduling/views.py +2564 -0
- trueppm_api/apps/sso/__init__.py +0 -0
- trueppm_api/apps/sso/apps.py +19 -0
- trueppm_api/apps/sso/extensions.py +130 -0
- trueppm_api/apps/sso/management/__init__.py +0 -0
- trueppm_api/apps/sso/management/commands/__init__.py +0 -0
- trueppm_api/apps/sso/management/commands/seed_sso_keycloak.py +172 -0
- trueppm_api/apps/sso/migrations/0001_initial.py +119 -0
- trueppm_api/apps/sso/migrations/0002_remove_oidcprovider_workspace_ssoproviderpolicy_and_more.py +169 -0
- trueppm_api/apps/sso/migrations/__init__.py +0 -0
- trueppm_api/apps/sso/models.py +148 -0
- trueppm_api/apps/sso/serializers.py +437 -0
- trueppm_api/apps/sso/services.py +1385 -0
- trueppm_api/apps/sso/urls.py +47 -0
- trueppm_api/apps/sso/views.py +935 -0
- trueppm_api/apps/sync/__init__.py +0 -0
- trueppm_api/apps/sync/apps.py +15 -0
- trueppm_api/apps/sync/backfill.py +208 -0
- trueppm_api/apps/sync/broadcast.py +320 -0
- trueppm_api/apps/sync/conflict.py +262 -0
- trueppm_api/apps/sync/consumers.py +471 -0
- trueppm_api/apps/sync/migrations/0001_initial.py +59 -0
- trueppm_api/apps/sync/migrations/0001_squashed_0002_remove_syncbatch_syncbatch_project_client_batch_uniq_and_more.py +77 -0
- trueppm_api/apps/sync/migrations/0002_remove_syncbatch_syncbatch_project_client_batch_uniq_and_more.py +41 -0
- trueppm_api/apps/sync/migrations/0003_boardevent.py +46 -0
- trueppm_api/apps/sync/migrations/0004_seed_sync_seq.py +24 -0
- trueppm_api/apps/sync/migrations/0005_program_sync_sequence.py +35 -0
- trueppm_api/apps/sync/migrations/__init__.py +0 -0
- trueppm_api/apps/sync/models.py +225 -0
- trueppm_api/apps/sync/pagination.py +231 -0
- trueppm_api/apps/sync/sequence.py +371 -0
- trueppm_api/apps/sync/serializers.py +687 -0
- trueppm_api/apps/sync/tasks.py +260 -0
- trueppm_api/apps/sync/throttles.py +175 -0
- trueppm_api/apps/sync/upload.py +501 -0
- trueppm_api/apps/sync/urls.py +17 -0
- trueppm_api/apps/sync/views.py +930 -0
- trueppm_api/apps/sync/ws_auth.py +193 -0
- trueppm_api/apps/taskruns/__init__.py +0 -0
- trueppm_api/apps/taskruns/apps.py +11 -0
- trueppm_api/apps/taskruns/migrations/0001_initial.py +92 -0
- trueppm_api/apps/taskruns/migrations/__init__.py +0 -0
- trueppm_api/apps/taskruns/models.py +68 -0
- trueppm_api/apps/taskruns/serializers.py +92 -0
- trueppm_api/apps/taskruns/tasks.py +60 -0
- trueppm_api/apps/taskruns/tracker.py +286 -0
- trueppm_api/apps/taskruns/urls.py +46 -0
- trueppm_api/apps/taskruns/views.py +195 -0
- trueppm_api/apps/teams/__init__.py +8 -0
- trueppm_api/apps/teams/apps.py +16 -0
- trueppm_api/apps/teams/migrations/0001_initial.py +139 -0
- trueppm_api/apps/teams/migrations/0001_squashed_0002_default_teams.py +142 -0
- trueppm_api/apps/teams/migrations/0002_default_teams.py +62 -0
- trueppm_api/apps/teams/migrations/0003_team_sync_seq_teammembership_sync_seq.py +22 -0
- trueppm_api/apps/teams/migrations/__init__.py +0 -0
- trueppm_api/apps/teams/models.py +145 -0
- trueppm_api/apps/teams/permissions.py +149 -0
- trueppm_api/apps/teams/serializers.py +95 -0
- trueppm_api/apps/teams/services.py +434 -0
- trueppm_api/apps/teams/signals.py +61 -0
- trueppm_api/apps/teams/urls.py +34 -0
- trueppm_api/apps/teams/views.py +201 -0
- trueppm_api/apps/timetracking/__init__.py +0 -0
- trueppm_api/apps/timetracking/apps.py +9 -0
- trueppm_api/apps/timetracking/migrations/0001_initial.py +117 -0
- trueppm_api/apps/timetracking/migrations/0002_timesheetsubmission.py +46 -0
- trueppm_api/apps/timetracking/migrations/0003_timeentry_deleted_at_timeentry_deleted_by.py +31 -0
- trueppm_api/apps/timetracking/migrations/0004_timeentry_sync_seq_and_more.py +24 -0
- trueppm_api/apps/timetracking/migrations/__init__.py +0 -0
- trueppm_api/apps/timetracking/models.py +178 -0
- trueppm_api/apps/timetracking/serializers.py +175 -0
- trueppm_api/apps/timetracking/services.py +117 -0
- trueppm_api/apps/timetracking/urls.py +47 -0
- trueppm_api/apps/timetracking/views.py +526 -0
- trueppm_api/apps/webhooks/__init__.py +0 -0
- trueppm_api/apps/webhooks/apps.py +8 -0
- trueppm_api/apps/webhooks/backfill.py +90 -0
- trueppm_api/apps/webhooks/dispatch.py +144 -0
- trueppm_api/apps/webhooks/migrations/0001_initial.py +146 -0
- trueppm_api/apps/webhooks/migrations/0001_squashed_0007_sprint_lifecycle_events.py +243 -0
- trueppm_api/apps/webhooks/migrations/0002_alter_webhook_events.py +32 -0
- trueppm_api/apps/webhooks/migrations/0003_delivery_status_created_idx.py +17 -0
- trueppm_api/apps/webhooks/migrations/0004_webhook_program_alter_webhook_project_and_more.py +64 -0
- trueppm_api/apps/webhooks/migrations/0005_webhook_delivery_sequence_numbers.py +30 -0
- trueppm_api/apps/webhooks/migrations/0006_webhook_format_alter_webhook_events_and_more.py +61 -0
- trueppm_api/apps/webhooks/migrations/0007_sprint_lifecycle_events.py +63 -0
- trueppm_api/apps/webhooks/migrations/0008_risk_baseline_comment_events.py +73 -0
- trueppm_api/apps/webhooks/migrations/0009_encrypt_webhook_secret_and_failure_counters.py +90 -0
- trueppm_api/apps/webhooks/migrations/__init__.py +0 -0
- trueppm_api/apps/webhooks/models.py +372 -0
- trueppm_api/apps/webhooks/serializers.py +318 -0
- trueppm_api/apps/webhooks/tasks.py +663 -0
- trueppm_api/apps/webhooks/urls.py +22 -0
- trueppm_api/apps/webhooks/views.py +383 -0
- trueppm_api/apps/workflow_engine/__init__.py +0 -0
- trueppm_api/apps/workflow_engine/apps.py +23 -0
- trueppm_api/apps/workflow_engine/migrations/0001_initial.py +230 -0
- trueppm_api/apps/workflow_engine/migrations/0001_squashed_0002_remove_workflowhistoryevent_workflow_history_lookup_idx.py +234 -0
- trueppm_api/apps/workflow_engine/migrations/0002_remove_workflowhistoryevent_workflow_history_lookup_idx.py +16 -0
- trueppm_api/apps/workflow_engine/migrations/0003_workflowoutboxrow_workflow_outbox_recovery_idx.py +21 -0
- trueppm_api/apps/workflow_engine/migrations/__init__.py +0 -0
- trueppm_api/apps/workflow_engine/models.py +265 -0
- trueppm_api/apps/workflow_engine/tasks.py +368 -0
- trueppm_api/apps/workspace/__init__.py +0 -0
- trueppm_api/apps/workspace/apps.py +10 -0
- trueppm_api/apps/workspace/backfill.py +111 -0
- trueppm_api/apps/workspace/export.py +242 -0
- trueppm_api/apps/workspace/migrations/0001_initial.py +326 -0
- trueppm_api/apps/workspace/migrations/0001_squashed_0014_workspacemembership_availability_effective_from_and_more.py +829 -0
- trueppm_api/apps/workspace/migrations/0002_remove_workspace_fiscal_year_start_and_more.py +85 -0
- trueppm_api/apps/workspace/migrations/0003_workspaceexportjob.py +73 -0
- trueppm_api/apps/workspace/migrations/0004_alter_workspaceinvite_status.py +27 -0
- trueppm_api/apps/workspace/migrations/0005_workspace_iteration_label_and_more.py +26 -0
- trueppm_api/apps/workspace/migrations/0006_alter_groupmembership_unique_together_and_more.py +45 -0
- trueppm_api/apps/workspace/migrations/0007_workspace_public_sharing_override_policy.py +21 -0
- trueppm_api/apps/workspace/migrations/0008_workspace_mc_history_attribution_audience_and_more.py +44 -0
- trueppm_api/apps/workspace/migrations/0009_workspace_methodology_and_more.py +186 -0
- trueppm_api/apps/workspace/migrations/0010_workspace_logo.py +38 -0
- trueppm_api/apps/workspace/migrations/0011_historicalworkspace_task_duration_change_percent_override_policy_and_more.py +56 -0
- trueppm_api/apps/workspace/migrations/0012_historicalworkspace_allowed_attachment_types_and_more.py +64 -0
- trueppm_api/apps/workspace/migrations/0013_auditevent.py +70 -0
- trueppm_api/apps/workspace/migrations/0014_workspacemembership_availability_effective_from_and_more.py +39 -0
- trueppm_api/apps/workspace/migrations/0015_trash_restore_1113.py +34 -0
- trueppm_api/apps/workspace/migrations/0016_historicalworkspace_calendar_and_more.py +55 -0
- trueppm_api/apps/workspace/migrations/0017_historicalworkspace_estimation_scale_and_more.py +38 -0
- trueppm_api/apps/workspace/migrations/0018_historicalworkspace_feedback_enabled_and_more.py +32 -0
- trueppm_api/apps/workspace/migrations/0019_historicalworkspace_mcp_enabled_and_more.py +22 -0
- trueppm_api/apps/workspace/migrations/0020_viewer_ordinal_one.py +34 -0
- trueppm_api/apps/workspace/migrations/0021_group_sync_seq_groupmembership_sync_seq_and_more.py +27 -0
- trueppm_api/apps/workspace/migrations/0022_historicalworkspace_sprint_picker_ready_only_default_and_more.py +22 -0
- trueppm_api/apps/workspace/migrations/0023_alter_auditevent_event_type.py +32 -0
- trueppm_api/apps/workspace/migrations/0024_alter_auditevent_event_type.py +33 -0
- trueppm_api/apps/workspace/migrations/0025_alter_auditevent_event_type.py +36 -0
- trueppm_api/apps/workspace/migrations/0026_alter_auditevent_event_type.py +37 -0
- trueppm_api/apps/workspace/migrations/0027_alter_auditevent_event_type.py +42 -0
- trueppm_api/apps/workspace/migrations/__init__.py +0 -0
- trueppm_api/apps/workspace/models.py +857 -0
- trueppm_api/apps/workspace/permissions.py +187 -0
- trueppm_api/apps/workspace/serializers.py +590 -0
- trueppm_api/apps/workspace/services.py +919 -0
- trueppm_api/apps/workspace/signals.py +37 -0
- trueppm_api/apps/workspace/tasks.py +555 -0
- trueppm_api/apps/workspace/urls.py +113 -0
- trueppm_api/apps/workspace/views.py +1502 -0
- trueppm_api/asgi.py +42 -0
- trueppm_api/celery.py +31 -0
- trueppm_api/core/__init__.py +0 -0
- trueppm_api/core/admin_site.py +206 -0
- trueppm_api/core/auth_views.py +916 -0
- trueppm_api/core/constant_time.py +51 -0
- trueppm_api/core/csp.py +54 -0
- trueppm_api/core/db.py +87 -0
- trueppm_api/core/db_session.py +37 -0
- trueppm_api/core/exception_handlers.py +157 -0
- trueppm_api/core/export_downloads.py +56 -0
- trueppm_api/core/extension_providers.py +56 -0
- trueppm_api/core/extension_signals.py +147 -0
- trueppm_api/core/idempotent.py +260 -0
- trueppm_api/core/metadata.py +42 -0
- trueppm_api/core/middleware.py +51 -0
- trueppm_api/core/openapi.py +949 -0
- trueppm_api/core/password_reset.py +500 -0
- trueppm_api/core/protect_conflict.py +100 -0
- trueppm_api/core/ratelimit.py +148 -0
- trueppm_api/core/redis_throttle.py +82 -0
- trueppm_api/core/refresh_cookie_policy.py +156 -0
- trueppm_api/core/request_body.py +86 -0
- trueppm_api/core/security_checks.py +884 -0
- trueppm_api/core/storage_config.py +105 -0
- trueppm_api/core/text_decode.py +168 -0
- trueppm_api/core/throttling.py +344 -0
- trueppm_api/core/valkey.py +214 -0
- trueppm_api/core/valkey_cache.py +66 -0
- trueppm_api/core/valkey_checks.py +104 -0
- trueppm_api/core/valkey_config.py +39 -0
- trueppm_api/core/worker_broker_wait.py +149 -0
- trueppm_api/core/worker_heartbeat.py +134 -0
- trueppm_api/fields.py +36 -0
- trueppm_api/permissions.py +30 -0
- trueppm_api/py.typed +0 -0
- trueppm_api/routing.py +11 -0
- trueppm_api/settings/__init__.py +0 -0
- trueppm_api/settings/base.py +2455 -0
- trueppm_api/settings/dev.py +273 -0
- trueppm_api/settings/prod.py +228 -0
- trueppm_api/urls.py +153 -0
- trueppm_api/workflows/__init__.py +38 -0
- trueppm_api/workflows/backends/__init__.py +6 -0
- trueppm_api/workflows/backends/default.py +297 -0
- trueppm_api/workflows/consumers/__init__.py +11 -0
- trueppm_api/workflows/consumers/requeue_failed_task.py +65 -0
- trueppm_api/workflows/interface.py +148 -0
- trueppm_api/workflows/registry.py +106 -0
- trueppm_api/workflows/services.py +90 -0
- trueppm_api/wsgi.py +11 -0
- trueppm_api-0.4.0b2.dist-info/METADATA +70 -0
- trueppm_api-0.4.0b2.dist-info/RECORD +759 -0
- trueppm_api-0.4.0b2.dist-info/WHEEL +4 -0
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
"""Pure builder for the S3 / MinIO attachment-storage options (#2559).
|
|
2
|
+
|
|
3
|
+
Deliberately free of any Django import, for the same reason as
|
|
4
|
+
``core.valkey_config``: ``settings/base.py`` needs :func:`build_s3_storage_options`
|
|
5
|
+
at module import time, and it must not drag the check registry in while settings
|
|
6
|
+
are still being read.
|
|
7
|
+
|
|
8
|
+
Why this exists at all: django-storages' ``S3Storage`` reads its bucket from
|
|
9
|
+
*Django settings*, not the environment, so setting
|
|
10
|
+
``TRUEPPM_DEFAULT_FILE_STORAGE=storages.backends.s3.S3Storage`` — the value all
|
|
11
|
+
four operator-facing surfaces recommend — was necessary but never sufficient. The
|
|
12
|
+
backend instantiated fine and then failed on the first upload with a bare
|
|
13
|
+
``ValueError: Required parameter name not set``. This module maps
|
|
14
|
+
``TRUEPPM_S3_*`` env vars onto the ``STORAGES['default']['OPTIONS']`` dict that
|
|
15
|
+
django-storages 1.14+ accepts.
|
|
16
|
+
"""
|
|
17
|
+
|
|
18
|
+
from __future__ import annotations
|
|
19
|
+
|
|
20
|
+
from collections.abc import Mapping
|
|
21
|
+
from typing import Any
|
|
22
|
+
|
|
23
|
+
#: Backends that take the S3 option set below. The legacy ``S3Boto3Storage`` alias
|
|
24
|
+
#: is included because django-storages still ships it and older operator runbooks
|
|
25
|
+
#: name it. Mirrored by ``core.security_checks._S3_FAMILY_BACKENDS``.
|
|
26
|
+
S3_STORAGE_BACKENDS = frozenset(
|
|
27
|
+
{
|
|
28
|
+
"storages.backends.s3.S3Storage",
|
|
29
|
+
"storages.backends.s3boto3.S3Boto3Storage",
|
|
30
|
+
}
|
|
31
|
+
)
|
|
32
|
+
|
|
33
|
+
#: SigV4 is not botocore's default once an ``endpoint_url`` is supplied — it falls
|
|
34
|
+
#: back to the deprecated SigV2 (``?AWSAccessKeyId=…&Signature=…``), which AWS
|
|
35
|
+
#: rejects in every region created after 2014. Defaulting it forward is what makes
|
|
36
|
+
#: the ``signed-url`` action hand out a real ``X-Amz-Expires`` URL rather than a
|
|
37
|
+
#: SigV2 one, so the promise in ``storage_backend_supports_signed_urls`` holds.
|
|
38
|
+
DEFAULT_SIGNATURE_VERSION = "s3v4"
|
|
39
|
+
|
|
40
|
+
#: Region must be concrete for SigV4: the signature embeds it in the credential
|
|
41
|
+
#: scope, so an empty region yields an unusable signature even against MinIO.
|
|
42
|
+
DEFAULT_REGION_NAME = "us-east-1"
|
|
43
|
+
|
|
44
|
+
#: Presigned-URL lifetime, in seconds, for TaskAttachmentViewSet.signed_url.
|
|
45
|
+
DEFAULT_QUERYSTRING_EXPIRE = 900
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
def _int_or_default(raw: str, default: int) -> int:
|
|
49
|
+
"""Coerce an env value to int, falling back rather than crashing the boot.
|
|
50
|
+
|
|
51
|
+
A malformed expiry is not worth refusing to start over — the default is safe,
|
|
52
|
+
and the alternative is an operator locked out of their own deploy by a typo in
|
|
53
|
+
a tuning knob.
|
|
54
|
+
"""
|
|
55
|
+
try:
|
|
56
|
+
return int(raw)
|
|
57
|
+
except ValueError:
|
|
58
|
+
return default
|
|
59
|
+
|
|
60
|
+
|
|
61
|
+
def build_s3_storage_options(environ: Mapping[str, str]) -> dict[str, Any]:
|
|
62
|
+
"""Build ``STORAGES['default']['OPTIONS']`` for an S3-family backend.
|
|
63
|
+
|
|
64
|
+
Only the keys the operator actually set are emitted for the optional knobs:
|
|
65
|
+
passing ``endpoint_url=""`` would stop boto3 resolving the real AWS endpoint,
|
|
66
|
+
and passing empty credentials would defeat its resolution chain (IRSA, IAM
|
|
67
|
+
instance profile, ``~/.aws``) — which is how a well-run EKS deploy should
|
|
68
|
+
authenticate. ``bucket_name`` is always emitted, even empty, so the deploy
|
|
69
|
+
check in ``core.security_checks`` can report it as missing with a message that
|
|
70
|
+
names the env var.
|
|
71
|
+
"""
|
|
72
|
+
options: dict[str, Any] = {
|
|
73
|
+
"bucket_name": environ.get("TRUEPPM_S3_BUCKET_NAME", ""),
|
|
74
|
+
"region_name": environ.get("TRUEPPM_S3_REGION_NAME") or DEFAULT_REGION_NAME,
|
|
75
|
+
"signature_version": (
|
|
76
|
+
environ.get("TRUEPPM_S3_SIGNATURE_VERSION") or DEFAULT_SIGNATURE_VERSION
|
|
77
|
+
),
|
|
78
|
+
"querystring_expire": _int_or_default(
|
|
79
|
+
environ.get("TRUEPPM_S3_QUERYSTRING_EXPIRE", ""),
|
|
80
|
+
DEFAULT_QUERYSTRING_EXPIRE,
|
|
81
|
+
),
|
|
82
|
+
# django-storages defaults file_overwrite=True, which silently REPLACES the
|
|
83
|
+
# object already at that key. TaskAttachment keys derive from user-supplied
|
|
84
|
+
# filenames, so two people uploading `report.pdf` to one task would destroy
|
|
85
|
+
# the first attachment. FileSystemStorage suffixes instead of overwriting;
|
|
86
|
+
# match it, so choosing a storage backend is not also choosing data loss.
|
|
87
|
+
"file_overwrite": False,
|
|
88
|
+
# Never attach a canned public ACL. Attachments are project-scoped and
|
|
89
|
+
# reached only through a presigned URL.
|
|
90
|
+
"default_acl": None,
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
# Non-AWS S3-compatible endpoint (MinIO, Ceph RGW, Cloudflare R2, Wasabi).
|
|
94
|
+
if endpoint := environ.get("TRUEPPM_S3_ENDPOINT_URL", ""):
|
|
95
|
+
options["endpoint_url"] = endpoint
|
|
96
|
+
# MinIO and Ceph need path-style addressing; AWS prefers virtual-hosted, and
|
|
97
|
+
# boto3's own "auto" default already gets AWS right — so only override on ask.
|
|
98
|
+
if addressing := environ.get("TRUEPPM_S3_ADDRESSING_STYLE", ""):
|
|
99
|
+
options["addressing_style"] = addressing
|
|
100
|
+
if access_key := environ.get("TRUEPPM_S3_ACCESS_KEY_ID", ""):
|
|
101
|
+
options["access_key"] = access_key
|
|
102
|
+
if secret_key := environ.get("TRUEPPM_S3_SECRET_ACCESS_KEY", ""):
|
|
103
|
+
options["secret_key"] = secret_key
|
|
104
|
+
|
|
105
|
+
return options
|
|
@@ -0,0 +1,168 @@
|
|
|
1
|
+
"""The one decoder for uploaded delimited-text files (#2892, #2937).
|
|
2
|
+
|
|
3
|
+
Decoding an upload is not "call ``.decode()``". The hazard is that the useful
|
|
4
|
+
fallback codecs — cp1252 and latin-1 — map almost every byte, so a *wrong* guess
|
|
5
|
+
**succeeds** and yields mojibake instead of an error. UTF-16 read as cp1252
|
|
6
|
+
becomes NUL-interleaved text; because header matching strips non-alphanumerics
|
|
7
|
+
before comparing, that mojibake still matched its aliases at
|
|
8
|
+
``confidence="exact"`` and the import wizard rendered a fully-green mapping over
|
|
9
|
+
a file it had comprehensively misread (#2892).
|
|
10
|
+
|
|
11
|
+
Strict UTF-8 is not the fix either, and looks like one. ``raw.decode("utf-8-sig")``
|
|
12
|
+
reads as fail-closed and is, for a *BOM'd* UTF-16 file — ``\\xff\\xfe`` is invalid
|
|
13
|
+
UTF-8, so it raises. But **NUL is a valid UTF-8 code point**, so a BOM-*less*
|
|
14
|
+
UTF-16 stream decodes without raising, straight into mojibake. That was
|
|
15
|
+
``risk_import._decode`` for its whole life (#2937): the same class as #2892, at a
|
|
16
|
+
fourth site, in a second app, three months after the first fix.
|
|
17
|
+
|
|
18
|
+
Which is the reason this module exists rather than a second copy of the guard.
|
|
19
|
+
#2892 fixed one importer and left the logic private to it; #2937 is what that
|
|
20
|
+
costs. ``tests/test_uploaded_text_decode_sites.py`` now enforces the boundary:
|
|
21
|
+
no module in ``apps/`` that imports ``csv`` may call ``.decode(`` itself.
|
|
22
|
+
|
|
23
|
+
The strategy, in order:
|
|
24
|
+
|
|
25
|
+
1. **A byte-order mark wins outright.** It is the one piece of encoding evidence
|
|
26
|
+
that is not a guess.
|
|
27
|
+
2. **Otherwise walk the ladder**, strict codecs first.
|
|
28
|
+
3. **Then check the output**, because steps 1–2 can succeed and still be wrong.
|
|
29
|
+
A refusal names the fix; mojibake names nothing.
|
|
30
|
+
|
|
31
|
+
Callers translate :class:`TextDecodeError` into their own domain exception so
|
|
32
|
+
their existing messages and 400 responses are unchanged.
|
|
33
|
+
"""
|
|
34
|
+
|
|
35
|
+
from __future__ import annotations
|
|
36
|
+
|
|
37
|
+
import codecs
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
class TextDecodeError(Exception):
|
|
41
|
+
"""An upload could not be read as delimited text, or decoded wrong."""
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
#: Advice appended to every decode refusal. Named once so both importers, the
|
|
45
|
+
#: wizard, the tests, and the docs quote the same sentence.
|
|
46
|
+
ENCODING_ADVICE = "Re-save the file as UTF-8 CSV (in Excel: File → Save As → CSV UTF-8)."
|
|
47
|
+
|
|
48
|
+
#: Text encodings tried in order when the upload carries no byte-order mark.
|
|
49
|
+
#: utf-8-sig first so a BOM written by Excel is consumed rather than becoming part
|
|
50
|
+
#: of the first header ("Name"). cp1252 and latin-1 are lossy fallbacks: they
|
|
51
|
+
#: map almost every byte and therefore never raise, so a wrong guess reaching them
|
|
52
|
+
#: produces mojibake rather than an error. ``_reject_undecodable`` is what stops
|
|
53
|
+
#: that (#2892).
|
|
54
|
+
_ENCODINGS = ("utf-8-sig", "utf-8", "cp1252", "latin-1")
|
|
55
|
+
|
|
56
|
+
#: Byte-order marks mapped to the codec that consumes them, longest mark first.
|
|
57
|
+
#:
|
|
58
|
+
#: Order is load-bearing, not cosmetic: ``BOM_UTF32_LE`` is ``BOM_UTF16_LE``
|
|
59
|
+
#: followed by two NUL bytes, so testing the 2-byte UTF-16 mark first would
|
|
60
|
+
#: classify every UTF-32 file as UTF-16. The named codecs ("utf-16", "utf-32")
|
|
61
|
+
#: rather than the endian-specific ones are deliberate — they consume the mark,
|
|
62
|
+
#: which the ``-le``/``-be`` variants leave in the text as U+FEFF.
|
|
63
|
+
_BOM_ENCODINGS: tuple[tuple[bytes, str], ...] = (
|
|
64
|
+
(codecs.BOM_UTF32_LE, "utf-32"),
|
|
65
|
+
(codecs.BOM_UTF32_BE, "utf-32"),
|
|
66
|
+
(codecs.BOM_UTF8, "utf-8-sig"),
|
|
67
|
+
(codecs.BOM_UTF16_LE, "utf-16"),
|
|
68
|
+
(codecs.BOM_UTF16_BE, "utf-16"),
|
|
69
|
+
)
|
|
70
|
+
|
|
71
|
+
#: How much of a decoded upload the undecodable-text guard inspects. The check is
|
|
72
|
+
#: a ratio over a prefix rather than the whole string so its cost is constant for
|
|
73
|
+
#: a 100 MB workbook; a decode wrong enough to matter is wrong from byte one.
|
|
74
|
+
_DECODE_SAMPLE_CHARS = 65_536
|
|
75
|
+
|
|
76
|
+
#: Share of control characters (excluding tab / CR / LF) above which a decode is
|
|
77
|
+
#: treated as failed rather than merely odd. A real spreadsheet export carries
|
|
78
|
+
#: essentially none; anything at this level means the bytes were run through the
|
|
79
|
+
#: wrong codec.
|
|
80
|
+
_MAX_NON_PRINTABLE_RATIO = 0.2
|
|
81
|
+
|
|
82
|
+
|
|
83
|
+
def _encoding_from_bom(content: bytes) -> str | None:
|
|
84
|
+
"""Name the codec a leading byte-order mark declares, or ``None``.
|
|
85
|
+
|
|
86
|
+
A BOM is the one piece of encoding evidence that is not a guess, so it wins
|
|
87
|
+
outright over the ``_ENCODINGS`` ladder — which cannot be trusted to reach the
|
|
88
|
+
right answer, because its lossy tail decodes anything.
|
|
89
|
+
"""
|
|
90
|
+
for bom, encoding in _BOM_ENCODINGS:
|
|
91
|
+
if content.startswith(bom):
|
|
92
|
+
return encoding
|
|
93
|
+
return None
|
|
94
|
+
|
|
95
|
+
|
|
96
|
+
def _reject_undecodable(text: str) -> None:
|
|
97
|
+
"""Refuse text that decoded without raising but plainly decoded wrong.
|
|
98
|
+
|
|
99
|
+
The hazard the ``_ENCODINGS`` ladder creates is not a missing codec — it is
|
|
100
|
+
that cp1252 and latin-1 map nearly every byte, so a wrong guess *succeeds*.
|
|
101
|
+
|
|
102
|
+
So the guard is on the *output*: a spreadsheet export contains no NUL and
|
|
103
|
+
essentially no other control characters, and either signal means the bytes
|
|
104
|
+
went through the wrong codec. Raising here is strictly better than importing
|
|
105
|
+
the mojibake, because a refusal names the fix and mojibake names nothing.
|
|
106
|
+
|
|
107
|
+
Raises:
|
|
108
|
+
TextDecodeError: The decoded text cannot be spreadsheet text.
|
|
109
|
+
"""
|
|
110
|
+
sample = text[:_DECODE_SAMPLE_CHARS]
|
|
111
|
+
if "\x00" in sample:
|
|
112
|
+
raise TextDecodeError(
|
|
113
|
+
"The file could not be read as text — the decoded content contains NUL "
|
|
114
|
+
"bytes, which means it is not in the encoding it appears to be (a "
|
|
115
|
+
f"UTF-16 file saved without a byte-order mark does this). {ENCODING_ADVICE}"
|
|
116
|
+
)
|
|
117
|
+
if not sample:
|
|
118
|
+
return
|
|
119
|
+
# Tab, CR and LF are structural in delimited text; every other control
|
|
120
|
+
# character is evidence of a bad decode.
|
|
121
|
+
non_printable = sum(1 for ch in sample if ch < " " and ch not in "\t\r\n")
|
|
122
|
+
if non_printable / len(sample) > _MAX_NON_PRINTABLE_RATIO:
|
|
123
|
+
raise TextDecodeError(
|
|
124
|
+
"The file could not be read as text — most of it is not readable "
|
|
125
|
+
"characters, so it is either binary or in an unexpected encoding. "
|
|
126
|
+
f"{ENCODING_ADVICE}"
|
|
127
|
+
)
|
|
128
|
+
|
|
129
|
+
|
|
130
|
+
def decode_uploaded_text(content: bytes) -> str:
|
|
131
|
+
"""Decode an uploaded delimited-text file, refusing a decode that went wrong.
|
|
132
|
+
|
|
133
|
+
Args:
|
|
134
|
+
content: The raw uploaded bytes, exactly as received.
|
|
135
|
+
|
|
136
|
+
Returns:
|
|
137
|
+
The decoded text.
|
|
138
|
+
|
|
139
|
+
Raises:
|
|
140
|
+
TextDecodeError: No codec produced usable spreadsheet text. Callers
|
|
141
|
+
translate this into their own domain exception; the message is
|
|
142
|
+
written to be shown to the uploader as-is and always names the fix.
|
|
143
|
+
"""
|
|
144
|
+
bom_encoding = _encoding_from_bom(content)
|
|
145
|
+
if bom_encoding is not None:
|
|
146
|
+
try:
|
|
147
|
+
text = content.decode(bom_encoding)
|
|
148
|
+
except UnicodeDecodeError as exc:
|
|
149
|
+
raise TextDecodeError(
|
|
150
|
+
f"The file declares a {bom_encoding} byte-order mark but does not "
|
|
151
|
+
f"decode as {bom_encoding}. {ENCODING_ADVICE}"
|
|
152
|
+
) from exc
|
|
153
|
+
_reject_undecodable(text)
|
|
154
|
+
return text
|
|
155
|
+
|
|
156
|
+
for encoding in _ENCODINGS:
|
|
157
|
+
try:
|
|
158
|
+
text = content.decode(encoding)
|
|
159
|
+
except UnicodeDecodeError:
|
|
160
|
+
continue
|
|
161
|
+
# Deliberately not "try the next codec": the remaining codecs are the
|
|
162
|
+
# lossy ones, and they produce the same mojibake from the same bytes.
|
|
163
|
+
# A failed decode has to become an error, not a quieter guess.
|
|
164
|
+
_reject_undecodable(text)
|
|
165
|
+
return text
|
|
166
|
+
# latin-1 maps every byte, so this is unreachable in practice; keep the
|
|
167
|
+
# explicit raise so a future edit to _ENCODINGS cannot silently return None.
|
|
168
|
+
raise TextDecodeError(f"Could not decode the file as text. {ENCODING_ADVICE}")
|
|
@@ -0,0 +1,344 @@
|
|
|
1
|
+
"""Probe-exempt default throttles for the general API rate limit (#1080).
|
|
2
|
+
|
|
3
|
+
TruePPM installs a global ``DEFAULT_THROTTLE_CLASSES`` so every endpoint that
|
|
4
|
+
does not declare its own scoped throttle still gets a baseline anon/user rate
|
|
5
|
+
limit (bounded DoS / resource-starvation protection for self-hosters). The one
|
|
6
|
+
hazard a *global* throttle introduces is that it would also count the
|
|
7
|
+
unauthenticated Kubernetes probe endpoints — ``/api/v1/health/`` (liveness) and
|
|
8
|
+
``/api/v1/edition/`` (the shell's startup edition read) — which orchestrators
|
|
9
|
+
hit on a tight loop. If those requests consumed the shared anon bucket, a busy
|
|
10
|
+
readiness loop could 429 the liveness probe and cause Kubernetes to restart a
|
|
11
|
+
perfectly healthy pod.
|
|
12
|
+
|
|
13
|
+
This is exactly why ``settings/base.py`` historically shipped *scoped throttles
|
|
14
|
+
only* and deliberately avoided a bare ``AnonRateThrottle``. The classes below
|
|
15
|
+
resolve that tension: they are the standard DRF anon/user throttles with a
|
|
16
|
+
single override — ``get_cache_key`` returns ``None`` (which DRF treats as "do
|
|
17
|
+
not throttle this request") for the probe paths — so the global default can be
|
|
18
|
+
turned on without ever rate-limiting a k8s probe.
|
|
19
|
+
|
|
20
|
+
``/api/v1/readyz`` is deliberately **not** in that exempt set (#2820, #3346).
|
|
21
|
+
Unlike ``/health/`` and ``/edition/`` it is not free — every call does a real
|
|
22
|
+
database and cache round-trip — so a full exemption meant an unauthenticated
|
|
23
|
+
caller who reached the pod IP directly (the probe path bypasses the Ingress)
|
|
24
|
+
could drive unbounded database load with no rate limit at all. It gets its own
|
|
25
|
+
scoped throttle instead (``ReadyzRateThrottle`` below), generous enough that no
|
|
26
|
+
documented probe configuration comes close to tripping it.
|
|
27
|
+
"""
|
|
28
|
+
|
|
29
|
+
from __future__ import annotations
|
|
30
|
+
|
|
31
|
+
import hashlib
|
|
32
|
+
from typing import TYPE_CHECKING, cast
|
|
33
|
+
|
|
34
|
+
from django.http import HttpRequest
|
|
35
|
+
from rest_framework.request import Request
|
|
36
|
+
from rest_framework.throttling import (
|
|
37
|
+
AnonRateThrottle,
|
|
38
|
+
SimpleRateThrottle,
|
|
39
|
+
UserRateThrottle,
|
|
40
|
+
)
|
|
41
|
+
|
|
42
|
+
if TYPE_CHECKING:
|
|
43
|
+
# Imported for type hints only. A runtime ``from rest_framework.views import
|
|
44
|
+
# APIView`` would be circular: DRF's ``APIView`` class body eagerly resolves
|
|
45
|
+
# ``DEFAULT_THROTTLE_CLASSES`` (→ this module) while ``rest_framework.views``
|
|
46
|
+
# is still initializing, before ``APIView`` itself is bound. ``from __future__
|
|
47
|
+
# import annotations`` keeps the annotations below as strings, so this import
|
|
48
|
+
# is never needed at runtime.
|
|
49
|
+
from rest_framework.views import APIView
|
|
50
|
+
|
|
51
|
+
# Kubernetes liveness and edition-discovery probes. Free to answer (no DB/cache
|
|
52
|
+
# round-trip) and hit on a tight orchestrator loop, so the general default
|
|
53
|
+
# throttle must never count them (returning None from get_cache_key skips
|
|
54
|
+
# throttling for the request). Stored trailing-slash-normalized so the check is
|
|
55
|
+
# robust whether or not the request path carries the trailing slash.
|
|
56
|
+
#
|
|
57
|
+
# ``/api/v1/readyz`` is NOT here — see ``ReadyzRateThrottle`` below (#2820,
|
|
58
|
+
# #3346): unlike these two it does real dependency round-trips, so it gets its
|
|
59
|
+
# own bounded scope instead of a blanket exemption.
|
|
60
|
+
_PROBE_EXEMPT_PATHS = frozenset(
|
|
61
|
+
path.rstrip("/") for path in ("/api/v1/health/", "/api/v1/edition/")
|
|
62
|
+
)
|
|
63
|
+
|
|
64
|
+
|
|
65
|
+
def _is_probe_path(request: Request) -> bool:
|
|
66
|
+
"""Return True when the request targets an exempt k8s probe endpoint.
|
|
67
|
+
|
|
68
|
+
Matches on ``path_info`` (the path *without* any ``SCRIPT_NAME`` mount prefix)
|
|
69
|
+
so the exemption still fires when TruePPM is served under a sub-path — otherwise
|
|
70
|
+
a probe at ``/trueppm/api/v1/health/`` would carry the prefix in ``request.path``,
|
|
71
|
+
miss the exempt set, and get throttled: the exact failure this guards against.
|
|
72
|
+
"""
|
|
73
|
+
return request.path_info.rstrip("/") in _PROBE_EXEMPT_PATHS
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
class ProbeExemptAnonRateThrottle(AnonRateThrottle):
|
|
77
|
+
"""Anonymous default throttle that never counts the k8s probe endpoints.
|
|
78
|
+
|
|
79
|
+
Inherits the ``"anon"`` scope, so its rate comes from
|
|
80
|
+
``DEFAULT_THROTTLE_RATES["anon"]``. Only the probe exemption is added; all
|
|
81
|
+
other requests are throttled exactly like the stock ``AnonRateThrottle``.
|
|
82
|
+
"""
|
|
83
|
+
|
|
84
|
+
def get_cache_key(self, request: Request, view: APIView) -> str | None:
|
|
85
|
+
"""Skip throttling for probe paths; otherwise defer to DRF's default.
|
|
86
|
+
|
|
87
|
+
Returning ``None`` tells DRF not to record or limit this request, which
|
|
88
|
+
keeps the tight-loop liveness/readiness probes off the shared anon
|
|
89
|
+
bucket (see module docstring).
|
|
90
|
+
"""
|
|
91
|
+
if _is_probe_path(request):
|
|
92
|
+
return None
|
|
93
|
+
return super().get_cache_key(request, view)
|
|
94
|
+
|
|
95
|
+
|
|
96
|
+
class ConsumableRateThrottle(SimpleRateThrottle):
|
|
97
|
+
"""A ``SimpleRateThrottle`` that can also be charged outside DRF's pipeline.
|
|
98
|
+
|
|
99
|
+
DRF throttles only run from ``APIView.check_throttles``, so a door that is not
|
|
100
|
+
a DRF view — the Django admin login (#3557) — cannot use one at all, and a
|
|
101
|
+
door that must charge a bucket it could not know about until *inside* the view
|
|
102
|
+
body — the email-identifier login retry (#3468) — cannot use one either.
|
|
103
|
+
|
|
104
|
+
:meth:`consume_key` is the shared primitive both need: record one attempt
|
|
105
|
+
against an explicit cache key and report the verdict, using the same window
|
|
106
|
+
arithmetic ``SimpleRateThrottle.allow_request`` uses, so a bucket charged this
|
|
107
|
+
way and a bucket charged by DRF are the same bucket with the same semantics.
|
|
108
|
+
"""
|
|
109
|
+
|
|
110
|
+
@classmethod
|
|
111
|
+
def consume_key(cls, key: str) -> float | None:
|
|
112
|
+
"""Record one attempt against ``key``'s bucket and report the verdict.
|
|
113
|
+
|
|
114
|
+
Returns ``None`` when the attempt was within the rate, or the number of
|
|
115
|
+
seconds to wait when the bucket was already at its limit.
|
|
116
|
+
|
|
117
|
+
Charging after the fact (rather than pre-emptively) matches how DRF
|
|
118
|
+
throttles work anyway — the Nth attempt is served and the N+1th refused.
|
|
119
|
+
"""
|
|
120
|
+
throttle = cls()
|
|
121
|
+
if not throttle.rate:
|
|
122
|
+
# No rate configured for this scope — nothing to charge, nothing to refuse.
|
|
123
|
+
return None
|
|
124
|
+
throttle.key = key
|
|
125
|
+
throttle.now = throttle.timer()
|
|
126
|
+
|
|
127
|
+
# Evict entries that have aged out of the window before recording, exactly as
|
|
128
|
+
# ``SimpleRateThrottle.allow_request`` does. ``throttle_success`` refreshes the
|
|
129
|
+
# cache TTL on every write, so without this an entry could outlive the window
|
|
130
|
+
# it belongs to and over-throttle the account. ``duration`` is set in
|
|
131
|
+
# ``SimpleRateThrottle.__init__`` from ``parse_rate`` but is not declared on the
|
|
132
|
+
# class, so it carries no type for mypy --strict.
|
|
133
|
+
duration = cast("int", getattr(throttle, "duration", 0))
|
|
134
|
+
history: list[float] = list(throttle.cache.get(throttle.key, []))
|
|
135
|
+
while history and history[-1] <= throttle.now - duration:
|
|
136
|
+
history.pop()
|
|
137
|
+
throttle.history = history
|
|
138
|
+
# ``num_requests`` and ``duration`` are set in ``SimpleRateThrottle.__init__``
|
|
139
|
+
# from ``parse_rate`` but are not declared on the class, so they carry no type.
|
|
140
|
+
if len(history) >= cast("int", getattr(throttle, "num_requests", 0)):
|
|
141
|
+
# Already at the limit before this attempt. Report the wait and record
|
|
142
|
+
# nothing — DRF's own throttle_failure does not extend the window either,
|
|
143
|
+
# so a refused attempt must not push the bucket's expiry out.
|
|
144
|
+
return throttle.wait()
|
|
145
|
+
throttle.throttle_success()
|
|
146
|
+
return None
|
|
147
|
+
|
|
148
|
+
|
|
149
|
+
class LoginIpRateThrottle(ConsumableRateThrottle):
|
|
150
|
+
"""The IP-keyed ``login`` bucket, chargeable from a non-DRF login door (#3557).
|
|
151
|
+
|
|
152
|
+
Deliberately the **same scope and the same cache key** as the
|
|
153
|
+
``ScopedRateThrottle`` the API login runs under, not a parallel bucket of its
|
|
154
|
+
own. ``/api/v1/auth/token/`` and ``/admin/login/`` are two doors onto one
|
|
155
|
+
credential set, so an attacker who exhausts one must not find the other's
|
|
156
|
+
allowance untouched — a per-door bucket would hand them ``2 x`` the guesses
|
|
157
|
+
the ``login`` rate is written to permit. Sharing it also means an operator who
|
|
158
|
+
tunes the rate tunes both doors, with nothing to keep in sync.
|
|
159
|
+
|
|
160
|
+
The key derivation mirrors ``ScopedRateThrottle.get_cache_key`` exactly
|
|
161
|
+
(account pk when the request is already authenticated, client IP otherwise);
|
|
162
|
+
if the two ever drift the buckets silently stop being the same bucket, which
|
|
163
|
+
is why :meth:`cache_key_for_request` is the single place either spells it out.
|
|
164
|
+
"""
|
|
165
|
+
|
|
166
|
+
scope = "login"
|
|
167
|
+
|
|
168
|
+
def get_cache_key(self, request: Request, view: APIView) -> str | None:
|
|
169
|
+
"""Key on the account pk when authenticated, the client IP otherwise."""
|
|
170
|
+
return self.cache_key_for_request(request)
|
|
171
|
+
|
|
172
|
+
@classmethod
|
|
173
|
+
def cache_key_for_request(cls, request: HttpRequest | Request) -> str:
|
|
174
|
+
"""Return the ``login``-scope bucket key for ``request``'s source.
|
|
175
|
+
|
|
176
|
+
Accepts a plain Django ``HttpRequest`` as well as a DRF ``Request``: it
|
|
177
|
+
reads only ``request.user`` and ``request.META``, both of which the
|
|
178
|
+
``AuthenticationMiddleware`` has already populated on the admin login path.
|
|
179
|
+
"""
|
|
180
|
+
throttle = cls()
|
|
181
|
+
user = getattr(request, "user", None)
|
|
182
|
+
# ``get_ident`` is annotated for a DRF ``Request`` but reads only ``META``
|
|
183
|
+
# (``HTTP_X_FORWARDED_FOR`` / ``REMOTE_ADDR``) plus the ``NUM_PROXIES``
|
|
184
|
+
# setting, so a plain ``HttpRequest`` satisfies it at runtime. Narrowing
|
|
185
|
+
# here rather than duplicating DRF's proxy-depth logic is what keeps the
|
|
186
|
+
# admin door's key byte-identical to the API login's.
|
|
187
|
+
ident = (
|
|
188
|
+
user.pk
|
|
189
|
+
if user is not None and user.is_authenticated
|
|
190
|
+
else throttle.get_ident(cast("Request", request))
|
|
191
|
+
)
|
|
192
|
+
return cls.cache_format % {"scope": cls.scope, "ident": ident}
|
|
193
|
+
|
|
194
|
+
@classmethod
|
|
195
|
+
def consume(cls, request: HttpRequest | Request) -> float | None:
|
|
196
|
+
"""Charge one login attempt from ``request``'s source against the IP bucket."""
|
|
197
|
+
return cls.consume_key(cls.cache_key_for_request(request))
|
|
198
|
+
|
|
199
|
+
|
|
200
|
+
class LoginAccountRateThrottle(ConsumableRateThrottle):
|
|
201
|
+
"""Per-*account* login throttle, keyed on the submitted username (#1717).
|
|
202
|
+
|
|
203
|
+
Why this exists alongside the IP-keyed ``login`` throttle:
|
|
204
|
+
The stock login throttle keys only on the client IP, so it caps guesses
|
|
205
|
+
*per source address*. A distributed credential-stuffing attack against a
|
|
206
|
+
single account rotates through a botnet / proxy pool, giving the attacker
|
|
207
|
+
the full per-IP allowance from every fresh IP — the aggregate guess rate
|
|
208
|
+
against that one account is unbounded even though no single IP trips the
|
|
209
|
+
limit. This throttle closes that gap by counting failed *and* successful
|
|
210
|
+
attempts against the same normalized username regardless of source IP, so
|
|
211
|
+
an account under distributed attack is locked out after the per-account
|
|
212
|
+
rate no matter how many IPs participate. It is *stacked* with (not a
|
|
213
|
+
replacement for) the IP throttle: both must pass, so IP-local flooding and
|
|
214
|
+
cross-IP account targeting are each bounded.
|
|
215
|
+
|
|
216
|
+
Privacy: the username is lowercased/trimmed and SHA-256 hashed before it goes
|
|
217
|
+
into the cache key, so the raw email/username is never persisted in the cache
|
|
218
|
+
backend (or leaked through a cache-key dump). Hashing is sufficient here — the
|
|
219
|
+
key only needs to be stable and collision-resistant, not reversible.
|
|
220
|
+
|
|
221
|
+
This is basic brute-force hardening (table-stakes self-hosting security), not
|
|
222
|
+
an org-wide enforced lockout *policy* with admin-configurable escalation /
|
|
223
|
+
unlock workflows — that governance layer is Enterprise.
|
|
224
|
+
"""
|
|
225
|
+
|
|
226
|
+
scope = "login_account"
|
|
227
|
+
|
|
228
|
+
def get_cache_key(self, request: Request, view: APIView) -> str | None:
|
|
229
|
+
"""Key the throttle on the hashed, normalized submitted username.
|
|
230
|
+
|
|
231
|
+
Returns ``None`` (skip this throttle) when no username is present so a
|
|
232
|
+
malformed request is not charged against an empty-string bucket — the IP
|
|
233
|
+
throttle still applies to those. Reading ``request.data`` here parses the
|
|
234
|
+
request body once (DRF caches it), which is safe inside ``check_throttles``.
|
|
235
|
+
"""
|
|
236
|
+
# ``hasattr(request, "data")`` alone is insufficient: a non-object JSON body
|
|
237
|
+
# (list/str/scalar) makes ``request.data`` a non-dict with no ``.get``, which
|
|
238
|
+
# would raise AttributeError inside check_throttles → 500 before the login
|
|
239
|
+
# serializer ever runs (#2126). A non-object body carries no username, so
|
|
240
|
+
# treat it as "no username" → skip this throttle (the IP throttle still bites).
|
|
241
|
+
username = request.data.get("username") if isinstance(request.data, dict) else None
|
|
242
|
+
if not username:
|
|
243
|
+
return None
|
|
244
|
+
return self.cache_key_for(str(username))
|
|
245
|
+
|
|
246
|
+
@classmethod
|
|
247
|
+
def cache_key_for(cls, identifier: str) -> str:
|
|
248
|
+
"""Return the bucket key for ``identifier``.
|
|
249
|
+
|
|
250
|
+
The single owner of this throttle's key derivation. ``get_cache_key`` and
|
|
251
|
+
``charge`` must not each spell the hash out, or the two drift and the
|
|
252
|
+
canonical charge silently stops landing in the bucket ``get_cache_key``
|
|
253
|
+
reads.
|
|
254
|
+
"""
|
|
255
|
+
ident = hashlib.sha256(identifier.strip().lower().encode("utf-8")).hexdigest()
|
|
256
|
+
return cls.cache_format % {"scope": cls.scope, "ident": ident}
|
|
257
|
+
|
|
258
|
+
@classmethod
|
|
259
|
+
def consume(cls, identifier: str) -> float | None:
|
|
260
|
+
"""Record one attempt against ``identifier``'s bucket and report the verdict.
|
|
261
|
+
|
|
262
|
+
Returns ``None`` when the attempt was within the rate, or the number of
|
|
263
|
+
seconds to wait when the bucket was already at its limit.
|
|
264
|
+
|
|
265
|
+
Why this exists (#3468): the throttle runs in ``check_throttles``, *before*
|
|
266
|
+
the view body, so it can only ever key on the identifier as submitted. Once
|
|
267
|
+
one account answers to two identifiers (its username and its email), an
|
|
268
|
+
attacker gets two independent per-account buckets and the effective guess
|
|
269
|
+
allowance against that account doubles — which defeats exactly the cross-IP
|
|
270
|
+
protection #1717 added. Resolving the email inside ``get_cache_key`` would
|
|
271
|
+
put an unauthenticated, unindexed ``email__iexact`` query in front of *every*
|
|
272
|
+
login, so instead the login view calls this once it has resolved an email to
|
|
273
|
+
its canonical username.
|
|
274
|
+
|
|
275
|
+
**Recording is not enough, and the half-measure is the trap.** The username
|
|
276
|
+
bucket already accumulates every username-form attempt (DRF charges it in
|
|
277
|
+
``allow_request``) and now every email-form attempt too, so it holds the true
|
|
278
|
+
total — but nothing *checks* it on the email path, and an attacker who spends
|
|
279
|
+
the username budget first then finds the email's own bucket empty and gets a
|
|
280
|
+
second full allowance. Only the email-first order would be capped, which is
|
|
281
|
+
worse than not fixing it at all: the protection looks complete and is
|
|
282
|
+
order-dependent. So this both records **and** reports, and the view refuses
|
|
283
|
+
on a ``None``-less return.
|
|
284
|
+
|
|
285
|
+
The residual is a narrow oracle and it is the right trade: an attacker who
|
|
286
|
+
already knows a username, and who spends that account's entire per-window
|
|
287
|
+
budget on it, can then learn whether a given address belongs to that same
|
|
288
|
+
account by whether they get a 429 rather than a 401. That leaks a mapping
|
|
289
|
+
between two identifiers of one already-known account, at one bit per window,
|
|
290
|
+
at the cost of the guesses they came for — against doubling the brute-force
|
|
291
|
+
budget on every targeted account, permanently.
|
|
292
|
+
|
|
293
|
+
Charging after the fact (rather than pre-emptively) matches how DRF throttles
|
|
294
|
+
work anyway — the Nth attempt is served and the N+1th is refused.
|
|
295
|
+
"""
|
|
296
|
+
return cls.consume_key(cls.cache_key_for(identifier))
|
|
297
|
+
|
|
298
|
+
|
|
299
|
+
class ProbeExemptUserRateThrottle(UserRateThrottle):
|
|
300
|
+
"""Authenticated default throttle that never counts the k8s probe endpoints.
|
|
301
|
+
|
|
302
|
+
Inherits the ``"user"`` scope, so its rate comes from
|
|
303
|
+
``DEFAULT_THROTTLE_RATES["user"]``. Only the probe exemption is added; all
|
|
304
|
+
other requests are throttled exactly like the stock ``UserRateThrottle``.
|
|
305
|
+
"""
|
|
306
|
+
|
|
307
|
+
def get_cache_key(self, request: Request, view: APIView) -> str | None:
|
|
308
|
+
"""Skip throttling for probe paths; otherwise defer to DRF's default.
|
|
309
|
+
|
|
310
|
+
Returning ``None`` tells DRF not to record or limit this request, which
|
|
311
|
+
keeps the tight-loop liveness/readiness probes off the shared user
|
|
312
|
+
bucket (see module docstring).
|
|
313
|
+
"""
|
|
314
|
+
if _is_probe_path(request):
|
|
315
|
+
return None
|
|
316
|
+
return super().get_cache_key(request, view)
|
|
317
|
+
|
|
318
|
+
|
|
319
|
+
class ReadyzRateThrottle(AnonRateThrottle):
|
|
320
|
+
"""Dedicated, generous rate limit for the unauthenticated ``/readyz`` probe.
|
|
321
|
+
|
|
322
|
+
(#2820, #3346) ``/readyz`` must stay unauthenticated — kubelet carries no
|
|
323
|
+
credential — but it is not free the way ``/health/`` and ``/edition/`` are:
|
|
324
|
+
every call does a bounded database round-trip, a cache round-trip, and a
|
|
325
|
+
migration-state check. Before this it was fully exempt from the shared
|
|
326
|
+
throttle (see ``_PROBE_EXEMPT_PATHS``), which meant an unauthenticated
|
|
327
|
+
caller who reached the pod IP directly — the probe path bypasses the
|
|
328
|
+
Ingress entirely — could drive unbounded database load with no rate limit
|
|
329
|
+
of any kind.
|
|
330
|
+
|
|
331
|
+
A dedicated ``"readyz"`` scope rather than the shared ``"anon"`` bucket, on
|
|
332
|
+
purpose: kubelet's readiness/startup probes hit the pod IP directly from
|
|
333
|
+
the node, not through the Ingress, so their source IP is the node's, not an
|
|
334
|
+
end user's. Sharing "anon" would let a legitimate probe loop compete with
|
|
335
|
+
real anonymous traffic in both directions — draining the budget a genuine
|
|
336
|
+
anonymous client needs, or (with a generous enough rate to avoid that)
|
|
337
|
+
giving an attacker room under the anon scope they would not otherwise have.
|
|
338
|
+
The rate itself (``DEFAULT_THROTTLE_RATES["readyz"]``) is picked to clear
|
|
339
|
+
every documented probe configuration with room to spare — see
|
|
340
|
+
administration/probes.md for the numbers it assumes — while still bounding
|
|
341
|
+
an outright flood.
|
|
342
|
+
"""
|
|
343
|
+
|
|
344
|
+
scope = "readyz"
|