crudkit 0.6.4__tar.gz → 0.7.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {crudkit-0.6.4 → crudkit-0.7.0}/.gitignore +3 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/CHANGELOG.md +52 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/PKG-INFO +1 -1
- {crudkit-0.6.4 → crudkit-0.7.0}/pyproject.toml +12 -1
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/fields.py +3 -3
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/management/commands/set_exchange_rate.py +12 -3
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/models.py +74 -24
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tasks.py +1 -1
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_audit.py +2 -10
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_hardening.py +2 -1
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/metadata.py +1 -1
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/records.py +198 -34
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/serializers.py +26 -22
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/services.py +8 -4
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/tests/test_authorization.py +2 -9
- crudkit-0.7.0/src/crudkit_api/tests/test_merge.py +99 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/tests/test_realtime.py +1 -1
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/tests/test_reorder.py +1 -1
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/tests/test_search.py +1 -1
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/views.py +11 -3
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/agent.py +7 -1
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/tests/test_agents.py +1 -8
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/tests/test_approvals.py +1 -9
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/tests/test_hardening.py +2 -1
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/tests/test_sidebar.py +6 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/tools.py +45 -4
- crudkit-0.6.4/src/crudkit_frontend/static/crudkit_frontend/assets/index-CZuMFRhk.js → crudkit-0.7.0/src/crudkit_frontend/static/crudkit_frontend/assets/index-BENymBEv.js +1 -1
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/templates/crudkit_frontend/index.html +1 -1
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/tests/test_hardening.py +2 -1
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/tests/test_mcp.py +138 -11
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/tools.py +88 -18
- crudkit-0.7.0/tests/bdd/README.md +200 -0
- crudkit-0.7.0/tests/bdd/conftest.py +38 -0
- crudkit-0.7.0/tests/bdd/features/account/dashboard.feature +58 -0
- crudkit-0.7.0/tests/bdd/features/account/profile.feature +62 -0
- crudkit-0.7.0/tests/bdd/features/account/sign_in.feature +42 -0
- crudkit-0.7.0/tests/bdd/features/actions/run_an_action.feature +79 -0
- crudkit-0.7.0/tests/bdd/features/agents/agents_need_a_person.feature +42 -0
- crudkit-0.7.0/tests/bdd/features/agents/agents_that_keep_failing.feature +44 -0
- crudkit-0.7.0/tests/bdd/features/agents/dry_runs.feature +42 -0
- crudkit-0.7.0/tests/bdd/features/agents/reverting_an_agent_run.feature +48 -0
- crudkit-0.7.0/tests/bdd/features/agents/scheduled_agents.feature +69 -0
- crudkit-0.7.0/tests/bdd/features/agents/setting_up_an_agent.feature +101 -0
- crudkit-0.7.0/tests/bdd/features/agents/what_a_run_does.feature +85 -0
- crudkit-0.7.0/tests/bdd/features/agents/what_starts_an_agent.feature +92 -0
- crudkit-0.7.0/tests/bdd/features/ai-fields/ai_category_fields.feature +19 -0
- crudkit-0.7.0/tests/bdd/features/ai-fields/ai_context.feature +82 -0
- crudkit-0.7.0/tests/bdd/features/ai-fields/backfill_ai_fields.feature +43 -0
- crudkit-0.7.0/tests/bdd/features/ai-fields/fill_in_ai_fields.feature +88 -0
- crudkit-0.7.0/tests/bdd/features/ai-fields/when_ai_fields_refresh.feature +49 -0
- crudkit-0.7.0/tests/bdd/features/approvals/confirm_a_proposal.feature +115 -0
- crudkit-0.7.0/tests/bdd/features/approvals/skip_a_proposal.feature +28 -0
- crudkit-0.7.0/tests/bdd/features/approvals/what_needs_approval.feature +50 -0
- crudkit-0.7.0/tests/bdd/features/approvals/who_sees_proposals.feature +34 -0
- crudkit-0.7.0/tests/bdd/features/assistant/cards_in_the_sidebar.feature +71 -0
- crudkit-0.7.0/tests/bdd/features/assistant/conversations.feature +58 -0
- crudkit-0.7.0/tests/bdd/features/assistant/filling_in_forms.feature +105 -0
- crudkit-0.7.0/tests/bdd/features/assistant/finding_records.feature +115 -0
- crudkit-0.7.0/tests/bdd/features/assistant/instructions.feature +91 -0
- crudkit-0.7.0/tests/bdd/features/assistant/opening_the_sidebar.feature +53 -0
- crudkit-0.7.0/tests/bdd/features/assistant/proposing_changes.feature +159 -0
- crudkit-0.7.0/tests/bdd/features/assistant/proposing_new_records_and_undos.feature +83 -0
- crudkit-0.7.0/tests/bdd/features/assistant/reading_records.feature +122 -0
- crudkit-0.7.0/tests/bdd/features/assistant/turns.feature +95 -0
- crudkit-0.7.0/tests/bdd/features/assistant/what_the_assistant_sees.feature +109 -0
- crudkit-0.7.0/tests/bdd/features/history/changes_from_other_systems.feature +42 -0
- crudkit-0.7.0/tests/bdd/features/history/reading_history.feature +94 -0
- crudkit-0.7.0/tests/bdd/features/history/what_the_change_log_keeps.feature +77 -0
- crudkit-0.7.0/tests/bdd/features/history/who_made_a_change.feature +84 -0
- crudkit-0.7.0/tests/bdd/features/identity/links_to_any_record.feature +52 -0
- crudkit-0.7.0/tests/bdd/features/identity/record_ids.feature +68 -0
- crudkit-0.7.0/tests/bdd/features/identity/record_type_letters.feature +37 -0
- crudkit-0.7.0/tests/bdd/features/mcp/aggregate_records.feature +169 -0
- crudkit-0.7.0/tests/bdd/features/mcp/approval_rules.feature +45 -0
- crudkit-0.7.0/tests/bdd/features/mcp/describe_types.feature +70 -0
- crudkit-0.7.0/tests/bdd/features/mcp/exposed_types.feature +38 -0
- crudkit-0.7.0/tests/bdd/features/mcp/extra_tools.feature +33 -0
- crudkit-0.7.0/tests/bdd/features/mcp/get_record.feature +78 -0
- crudkit-0.7.0/tests/bdd/features/mcp/list_records.feature +116 -0
- crudkit-0.7.0/tests/bdd/features/mcp/propose_changes.feature +63 -0
- crudkit-0.7.0/tests/bdd/features/mcp/protocol.feature +69 -0
- crudkit-0.7.0/tests/bdd/features/mcp/saved_views.feature +92 -0
- crudkit-0.7.0/tests/bdd/features/mcp/search.feature +35 -0
- crudkit-0.7.0/tests/bdd/features/mcp/signing_in.feature +46 -0
- crudkit-0.7.0/tests/bdd/features/mcp/tools_by_access.feature +42 -0
- crudkit-0.7.0/tests/bdd/features/mcp/undo.feature +62 -0
- crudkit-0.7.0/tests/bdd/features/mcp/write_directly.feature +100 -0
- crudkit-0.7.0/tests/bdd/features/mcp/write_limit.feature +49 -0
- crudkit-0.7.0/tests/bdd/features/mcp/write_limit_checks.feature +31 -0
- crudkit-0.7.0/tests/bdd/features/merge-restore-reorder/deleted_records_and_restore.feature +46 -0
- crudkit-0.7.0/tests/bdd/features/merge-restore-reorder/merge_duplicates.feature +109 -0
- crudkit-0.7.0/tests/bdd/features/merge-restore-reorder/reorder_records.feature +54 -0
- crudkit-0.7.0/tests/bdd/features/metadata/describe_a_record_type.feature +81 -0
- crudkit-0.7.0/tests/bdd/features/metadata/describe_one_record.feature +48 -0
- crudkit-0.7.0/tests/bdd/features/metadata/field_kinds.feature +31 -0
- crudkit-0.7.0/tests/bdd/features/money/amounts_and_currencies.feature +63 -0
- crudkit-0.7.0/tests/bdd/features/money/amounts_in_the_app.feature +67 -0
- crudkit-0.7.0/tests/bdd/features/money/exchange_rate_commands.feature +98 -0
- crudkit-0.7.0/tests/bdd/features/money/exchange_rates.feature +79 -0
- crudkit-0.7.0/tests/bdd/features/notes-feed-worklog/external_systems.feature +51 -0
- crudkit-0.7.0/tests/bdd/features/notes-feed-worklog/notes_and_activity.feature +46 -0
- crudkit-0.7.0/tests/bdd/features/notes-feed-worklog/snippets.feature +24 -0
- crudkit-0.7.0/tests/bdd/features/notes-feed-worklog/work_logs.feature +50 -0
- crudkit-0.7.0/tests/bdd/features/oauth/discovery.feature +49 -0
- crudkit-0.7.0/tests/bdd/features/oauth/exchange_a_code.feature +58 -0
- crudkit-0.7.0/tests/bdd/features/oauth/grant_access.feature +117 -0
- crudkit-0.7.0/tests/bdd/features/oauth/refresh_tokens.feature +61 -0
- crudkit-0.7.0/tests/bdd/features/oauth/register_a_client.feature +53 -0
- crudkit-0.7.0/tests/bdd/features/permissions/owner_access.feature +42 -0
- crudkit-0.7.0/tests/bdd/features/permissions/record_permissions.feature +86 -0
- crudkit-0.7.0/tests/bdd/features/permissions/row_rules.feature +52 -0
- crudkit-0.7.0/tests/bdd/features/realtime/change_stream.feature +73 -0
- crudkit-0.7.0/tests/bdd/features/realtime/sign_in_on_the_change_stream.feature +36 -0
- crudkit-0.7.0/tests/bdd/features/records/create_records.feature +72 -0
- crudkit-0.7.0/tests/bdd/features/records/delete_records.feature +45 -0
- crudkit-0.7.0/tests/bdd/features/records/edit_records.feature +99 -0
- crudkit-0.7.0/tests/bdd/features/records/list_records.feature +131 -0
- crudkit-0.7.0/tests/bdd/features/records/start_a_new_record.feature +61 -0
- crudkit-0.7.0/tests/bdd/features/records/view_a_record.feature +51 -0
- crudkit-0.7.0/tests/bdd/features/search/search_a_list.feature +46 -0
- crudkit-0.7.0/tests/bdd/features/search/search_everything.feature +75 -0
- crudkit-0.7.0/tests/bdd/features/spa-shell/web_app_page.feature +47 -0
- crudkit-0.7.0/tests/bdd/features/undo/undo_a_change_set.feature +62 -0
- crudkit-0.7.0/tests/bdd/features/undo/what_can_be_undone.feature +146 -0
- crudkit-0.7.0/tests/bdd/features/views-and-workspaces/menu_badges.feature +43 -0
- crudkit-0.7.0/tests/bdd/features/views-and-workspaces/opening_a_view.feature +131 -0
- crudkit-0.7.0/tests/bdd/features/views-and-workspaces/saving_a_view.feature +72 -0
- crudkit-0.7.0/tests/bdd/features/views-and-workspaces/who_sees_a_view.feature +36 -0
- crudkit-0.7.0/tests/bdd/features/views-and-workspaces/workspaces.feature +59 -0
- crudkit-0.7.0/tests/bdd/steps/account.py +385 -0
- crudkit-0.7.0/tests/bdd/steps/actions.py +117 -0
- crudkit-0.7.0/tests/bdd/steps/agents.py +616 -0
- crudkit-0.7.0/tests/bdd/steps/ai_fields.py +380 -0
- crudkit-0.7.0/tests/bdd/steps/approvals.py +238 -0
- crudkit-0.7.0/tests/bdd/steps/assistant.py +1014 -0
- crudkit-0.7.0/tests/bdd/steps/assistant_tools.py +500 -0
- crudkit-0.7.0/tests/bdd/steps/common.py +146 -0
- crudkit-0.7.0/tests/bdd/steps/feed.py +278 -0
- crudkit-0.7.0/tests/bdd/steps/history.py +488 -0
- crudkit-0.7.0/tests/bdd/steps/identity.py +137 -0
- crudkit-0.7.0/tests/bdd/steps/mcp.py +1003 -0
- crudkit-0.7.0/tests/bdd/steps/merge.py +121 -0
- crudkit-0.7.0/tests/bdd/steps/metadata.py +274 -0
- crudkit-0.7.0/tests/bdd/steps/money.py +332 -0
- crudkit-0.7.0/tests/bdd/steps/oauth.py +544 -0
- crudkit-0.7.0/tests/bdd/steps/permissions.py +117 -0
- crudkit-0.7.0/tests/bdd/steps/realtime.py +243 -0
- crudkit-0.7.0/tests/bdd/steps/records.py +409 -0
- crudkit-0.7.0/tests/bdd/steps/search.py +94 -0
- crudkit-0.7.0/tests/bdd/steps/spa_shell.py +114 -0
- crudkit-0.7.0/tests/bdd/steps/undo.py +160 -0
- crudkit-0.7.0/tests/bdd/steps/views.py +288 -0
- crudkit-0.7.0/tests/bdd/test_coverage.py +129 -0
- crudkit-0.7.0/tests/bdd/test_features.py +8 -0
- crudkit-0.7.0/tests/bdd/world.py +245 -0
- crudkit-0.7.0/tests/support.py +13 -0
- crudkit-0.7.0/tests/testapp/migrations/__init__.py +0 -0
- crudkit-0.6.4/src/crudkit_api/tests/test_merge.py +0 -33
- {crudkit-0.6.4 → crudkit-0.7.0}/README.md +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/manage.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/__init__.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/admin.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/ai_backend.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/apps.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/audit.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/authorization.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/checks.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/decorators.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/llm.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/management/__init__.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/management/commands/__init__.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/management/commands/add_default_exchange_rates.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/management/commands/backfill_ai_fields.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/migrations/0001_squashed.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/migrations/0002_workspace.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/migrations/0003_enforce_data_invariants.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/migrations/0004_changelog_audit.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/migrations/0005_aicontext.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/migrations/0006_changelog_audit_indexes.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/migrations/0007_view_badge_filters.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/migrations/__init__.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/profile.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/realtime.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/signals.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/templatetags/__init__.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/templatetags/crm_forms.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/templatetags/crm_time.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/templatetags/gravatar.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/templatetags/model_magic.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/__init__.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_ai_backend.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_ai_context.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_ai_fields.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_ai_tasks.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_authorization.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_backfill_command.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_fields.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_integrity.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_llm.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_money.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_tasks.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_view_filters.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_workspace.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/utils.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/widgets.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/__init__.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/authentication.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/consumers.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/filters.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/pagination.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/permissions.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/routing.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/tests/__init__.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/tests/test_email_id_serialization.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/tests/test_filters.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/tests/test_list_serialization.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/tests/test_metadata.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/tests/test_user_profile.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/urls.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/ws_auth.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/__init__.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/admin.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/apps.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/background.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/consumers.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/deps.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/execution.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/migrations/0001_initial.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/migrations/0002_assistantconversation.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/migrations/0003_proposal_revert.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/migrations/0004_proposal_sources.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/migrations/0005_agent_agentrun.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/migrations/__init__.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/models.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/proposals.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/routing.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/runner.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/screen.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/signals.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/tasks.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/tests/__init__.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/tests/test_proposals.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/utils.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/__init__.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/apps.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/context_processors.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/static/crudkit_frontend/assets/favicon-Cit_9t8D.svg +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/static/crudkit_frontend/assets/index-Cxy1TyRo.css +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/tests/__init__.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/tests/templates/crudkit_frontend/index.html +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/tests/test_frontend.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/tests/urls.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/urls.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/views.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/__init__.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/admin.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/apps.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/authentication.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/checks.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/conf.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/migrations/0001_initial.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/migrations/__init__.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/models.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/oauth.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/server.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/templates/crudkit_mcp/authorize.html +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/tests/__init__.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/tests/test_oauth.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/urls.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/views.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/well_known_urls.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/tests/__init__.py +0 -0
- {crudkit-0.6.4/tests/testapp → crudkit-0.7.0/tests/bdd/steps}/__init__.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/tests/celery.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/tests/settings.py +0 -0
- {crudkit-0.6.4/tests/testapp/migrations → crudkit-0.7.0/tests/testapp}/__init__.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/tests/testapp/adapters.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/tests/testapp/ai.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/tests/testapp/apps.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/tests/testapp/migrations/0001_initial.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/tests/testapp/migrations/0002_customer_currency.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/tests/testapp/migrations/0003_ticket_watchers.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/tests/testapp/migrations/0004_topic_sort_order.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/tests/testapp/models.py +0 -0
- {crudkit-0.6.4 → crudkit-0.7.0}/tests/urls.py +0 -0
|
@@ -14,3 +14,6 @@ uv.lock
|
|
|
14
14
|
# Vite build output shipped inside the wheel (built in CI, not committed)
|
|
15
15
|
backend/src/crudkit_frontend/static/
|
|
16
16
|
backend/src/crudkit_frontend/templates/
|
|
17
|
+
|
|
18
|
+
# pytest-playwright failure artifacts of the BDD journey suite
|
|
19
|
+
examples/demo/test-results/
|
|
@@ -1,5 +1,57 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.7.0 (2026-10-27)
|
|
4
|
+
|
|
5
|
+
- Merge moves everything that points at a merged record to the one kept: every reverse
|
|
6
|
+
foreign key, whatever its `on_delete`, and every generic foreign key (feed items, external
|
|
7
|
+
ids, work logs, a project's own GFKs). The change log stays with the merged record. Before,
|
|
8
|
+
only feed items and external ids moved; SET_NULL and PROTECT rows stayed on the deleted
|
|
9
|
+
record without an error, because the guard (a delete collector dry run) only saw CASCADE
|
|
10
|
+
children. Those children used to block the merge and now move too. Anything still pointing
|
|
11
|
+
at the merged record afterwards (a one-to-one, many-to-many rows) fails the merge with a
|
|
12
|
+
ValidationError naming the relation, and the merge rolls back. A project's
|
|
13
|
+
`delete_and_merge_with` overrides that only repoint foreign keys can be deleted. (#75)
|
|
14
|
+
|
|
15
|
+
Fixes for the open bugs the behaviour spec recorded (#77). Bad input is now refused with a
|
|
16
|
+
400 instead of a 500:
|
|
17
|
+
|
|
18
|
+
- Foreign key fields check what they link to. A missing id is refused as "not found" and
|
|
19
|
+
keeps the old link (it used to clear the link silently). An id of the wrong type is
|
|
20
|
+
refused (it used to crash). A record the person may not view is refused as "not found",
|
|
21
|
+
as generic links already were. Links to non-CrudKit models such as users only check that
|
|
22
|
+
the row exists, so setting an owner still doesn't need permission to view users.
|
|
23
|
+
- `?_fields=` naming a field the type doesn't have is refused, naming the field.
|
|
24
|
+
- Merging with no duplicates, or across record types, is refused.
|
|
25
|
+
- An action that returns nothing answers `{}` instead of crashing. The run is still logged.
|
|
26
|
+
- Starting a second running timer through the API is refused ("already tracking time")
|
|
27
|
+
instead of hitting the database constraint.
|
|
28
|
+
- Model metadata no longer lists hidden reverse relations (`related_name="+"`).
|
|
29
|
+
- Searching everything for a child type's id (e.g. an URG id) finds the record once, as its
|
|
30
|
+
own type, instead of again as its parent type.
|
|
31
|
+
- Money fields report `amount_default_currency: null` when there is no exchange rate,
|
|
32
|
+
instead of the unconverted foreign amount. The read-only field then shows just the amount.
|
|
33
|
+
`format_amount` returns "N/A" when the record's own `amount` is empty instead of crashing.
|
|
34
|
+
- `set_exchange_rate` refuses a rate that overlaps an existing one and a rate that isn't a
|
|
35
|
+
number.
|
|
36
|
+
- Deleting a record through the app sets "updated by", so history and live updates name the
|
|
37
|
+
person who deleted it.
|
|
38
|
+
- An AI foreign-key answer that isn't a record id leaves the field empty instead of failing
|
|
39
|
+
the whole AI job.
|
|
40
|
+
|
|
41
|
+
- The behaviour spec: plain-language Gherkin scenarios for every public behaviour, run with
|
|
42
|
+
pytest-bdd, with a coverage guard in CI that fails on untagged surface. (#76)
|
|
43
|
+
|
|
44
|
+
## 0.6.5 (2026-10-21)
|
|
45
|
+
|
|
46
|
+
- MCP clients and the assistant can ask questions without fetching every row. New read tool
|
|
47
|
+
`aggregate_records` counts, sums, averages or takes the min/max of a type's or saved view's
|
|
48
|
+
records, grouped by up to two fields or date periods (`group_by: ["created_at:month"]`),
|
|
49
|
+
with foreign key groups labelled. `list_records` and `get_record` take `fields` to return
|
|
50
|
+
only the named columns (`get_record` then only includes `feed`/`changelog` if named), and
|
|
51
|
+
the tool descriptions steer the AI to use both. Filters gain `<field>_from`/`<field>_to`
|
|
52
|
+
for numbers, `<field>_isnull`, and list values matching any of them. `describe_types(type)`
|
|
53
|
+
reports `columns` and `aggregatable` fields. (#73)
|
|
54
|
+
|
|
3
55
|
## 0.6.4 (2026-10-13)
|
|
4
56
|
|
|
5
57
|
- The browser tab title on a saved view shows the view's name instead of its id, prefixed
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: crudkit
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.7.0
|
|
4
4
|
Summary: A metadata-driven CRUD framework for Django: typed object IDs, soft delete, merge, change log, activity feed, saved views, AI fields and a generic REST API.
|
|
5
5
|
Project-URL: Homepage, https://github.com/fenerum/crudkit
|
|
6
6
|
Project-URL: Changelog, https://github.com/fenerum/crudkit/blob/main/backend/CHANGELOG.md
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
[project]
|
|
2
2
|
name = "crudkit"
|
|
3
|
-
version = "0.
|
|
3
|
+
version = "0.7.0"
|
|
4
4
|
description = "A metadata-driven CRUD framework for Django: typed object IDs, soft delete, merge, change log, activity feed, saved views, AI fields and a generic REST API."
|
|
5
5
|
readme = "README.md"
|
|
6
6
|
license = "MIT"
|
|
@@ -62,6 +62,9 @@ artifacts = ["src/crudkit_frontend/static", "src/crudkit_frontend/templates"]
|
|
|
62
62
|
dev = [
|
|
63
63
|
"daphne>=4.1",
|
|
64
64
|
"psycopg2-binary>=2.9",
|
|
65
|
+
"pytest>=9.1.1",
|
|
66
|
+
"pytest-bdd>=9.0.0",
|
|
67
|
+
"pytest-django>=4.14.0",
|
|
65
68
|
"ruff>=0.7.0",
|
|
66
69
|
]
|
|
67
70
|
|
|
@@ -71,3 +74,11 @@ extend-exclude = ["migrations"]
|
|
|
71
74
|
|
|
72
75
|
[tool.ruff.lint]
|
|
73
76
|
select = ["E4", "E7", "E9", "F", "I", "B"]
|
|
77
|
+
|
|
78
|
+
[tool.pytest.ini_options]
|
|
79
|
+
# `uv run pytest` runs the BDD behaviour suite; the unittest suite still runs
|
|
80
|
+
# through `manage.py test`. tests/bdd has no __init__.py so that runner's
|
|
81
|
+
# discovery skips it.
|
|
82
|
+
DJANGO_SETTINGS_MODULE = "tests.settings"
|
|
83
|
+
pythonpath = ["."]
|
|
84
|
+
testpaths = ["tests/bdd"]
|
|
@@ -97,9 +97,9 @@ class CurrencyField(models.CharField):
|
|
|
97
97
|
|
|
98
98
|
# Get amount either from parameter or model's amount field
|
|
99
99
|
if amount is None:
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
100
|
+
amount = getattr(model_instance, "amount", None)
|
|
101
|
+
if amount is None:
|
|
102
|
+
return "N/A"
|
|
103
103
|
|
|
104
104
|
symbol = CURRENCY_SYMBOLS.get(currency_code, "")
|
|
105
105
|
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import datetime
|
|
2
|
-
from decimal import Decimal
|
|
2
|
+
from decimal import Decimal, InvalidOperation
|
|
3
3
|
|
|
4
|
+
from django.core.exceptions import ValidationError
|
|
4
5
|
from django.core.management.base import BaseCommand, CommandError
|
|
5
6
|
from django.utils import timezone
|
|
6
7
|
|
|
@@ -31,7 +32,10 @@ class Command(BaseCommand):
|
|
|
31
32
|
|
|
32
33
|
def handle(self, *args, **options):
|
|
33
34
|
currency = options["currency"].upper()
|
|
34
|
-
|
|
35
|
+
try:
|
|
36
|
+
rate = Decimal(options["rate"])
|
|
37
|
+
except InvalidOperation as e:
|
|
38
|
+
raise CommandError(f"Invalid rate: {options['rate']}") from e
|
|
35
39
|
|
|
36
40
|
# Parse dates
|
|
37
41
|
from_date = None
|
|
@@ -85,7 +89,7 @@ class Command(BaseCommand):
|
|
|
85
89
|
)
|
|
86
90
|
else:
|
|
87
91
|
# Create a new exchange rate
|
|
88
|
-
exchange_rate = ExchangeRate
|
|
92
|
+
exchange_rate = ExchangeRate(
|
|
89
93
|
currency=currency,
|
|
90
94
|
rate=rate,
|
|
91
95
|
from_date=from_date,
|
|
@@ -93,6 +97,11 @@ class Command(BaseCommand):
|
|
|
93
97
|
created_by=system_user,
|
|
94
98
|
updated_by=system_user,
|
|
95
99
|
)
|
|
100
|
+
try:
|
|
101
|
+
exchange_rate.full_clean()
|
|
102
|
+
except ValidationError as e:
|
|
103
|
+
raise CommandError(" ".join(e.messages)) from e
|
|
104
|
+
exchange_rate.save()
|
|
96
105
|
self.stdout.write(
|
|
97
106
|
self.style.SUCCESS(
|
|
98
107
|
f'Created exchange rate: 1 {DEFAULT_CURRENCY} = {rate} {currency} '
|
|
@@ -3,6 +3,7 @@ import functools
|
|
|
3
3
|
import json
|
|
4
4
|
import re
|
|
5
5
|
|
|
6
|
+
from django.apps import apps
|
|
6
7
|
from django.conf import settings
|
|
7
8
|
from django.contrib.contenttypes.fields import GenericForeignKey, GenericRelation
|
|
8
9
|
from django.contrib.contenttypes.models import ContentType
|
|
@@ -31,6 +32,17 @@ def get_accepted_type_ids(model):
|
|
|
31
32
|
return frozenset(type_id for type_id, mdl in get_model_types().items() if issubclass(mdl, model))
|
|
32
33
|
|
|
33
34
|
|
|
35
|
+
def get_generic_foreign_keys():
|
|
36
|
+
"""(model, field) for every GenericForeignKey of an installed model."""
|
|
37
|
+
return [
|
|
38
|
+
(model, field)
|
|
39
|
+
for model in apps.get_models()
|
|
40
|
+
if not model._meta.proxy
|
|
41
|
+
for field in model._meta.private_fields
|
|
42
|
+
if isinstance(field, GenericForeignKey)
|
|
43
|
+
]
|
|
44
|
+
|
|
45
|
+
|
|
34
46
|
def parse_ck_id(ck_id: str) -> tuple[str, int]:
|
|
35
47
|
if not isinstance(ck_id, str) or not ck_id_regex.fullmatch(ck_id):
|
|
36
48
|
raise ValueError(f"Invalid CrudKit ID: {ck_id!r}")
|
|
@@ -287,7 +299,9 @@ class BaseCrudKitModel(models.Model):
|
|
|
287
299
|
self.merged_into = merged_into
|
|
288
300
|
self.deleted = True
|
|
289
301
|
self.save(
|
|
290
|
-
update_fields=["deleted", "
|
|
302
|
+
update_fields=["deleted", "updated_by", "updated_at"]
|
|
303
|
+
if not merged_into
|
|
304
|
+
else ["deleted", "merged_into", "updated_by", "updated_at"]
|
|
291
305
|
)
|
|
292
306
|
|
|
293
307
|
@property
|
|
@@ -347,36 +361,60 @@ class BaseCrudKitModel(models.Model):
|
|
|
347
361
|
setattr(instance, field.name, params[field.name])
|
|
348
362
|
return instance
|
|
349
363
|
|
|
364
|
+
def get_merge_relations(self):
|
|
365
|
+
"""The reverse foreign keys and one-to-ones that point at this object, bar merge
|
|
366
|
+
bookkeeping and multi-table-inheritance parent links."""
|
|
367
|
+
return [
|
|
368
|
+
relation
|
|
369
|
+
for relation in self._meta.get_fields(include_hidden=True)
|
|
370
|
+
if (relation.one_to_many or relation.one_to_one)
|
|
371
|
+
and relation.auto_created
|
|
372
|
+
and not relation.concrete
|
|
373
|
+
and not relation.parent_link
|
|
374
|
+
and relation.field.name != "merged_into"
|
|
375
|
+
]
|
|
376
|
+
|
|
350
377
|
def delete_and_merge_with(self, other_object):
|
|
351
378
|
"""
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
379
|
+
Moves every row pointing at this object, by foreign key or generic foreign key, to
|
|
380
|
+
`other_object` and soft-deletes this one. It does not move field content: the merge
|
|
381
|
+
view lets the user pick that. The change log stays, as the history of this object.
|
|
382
|
+
|
|
383
|
+
Override it for side effects (e.g. a rollup on `other_object`) or to deal with a
|
|
384
|
+
relation that can't simply be repointed before calling super(). Rows that are left
|
|
385
|
+
pointing here (a one-to-one, many-to-many rows) fail the merge with a ValidationError.
|
|
355
386
|
"""
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
387
|
+
now = timezone.now()
|
|
388
|
+
|
|
389
|
+
def repoint(model, lookup, changes):
|
|
390
|
+
if issubclass(model, BaseCrudKitModel):
|
|
391
|
+
changes["updated_at"] = now
|
|
392
|
+
model._base_manager.filter(**lookup).update(**changes)
|
|
393
|
+
|
|
394
|
+
for relation in self.get_merge_relations():
|
|
395
|
+
# Many-to-many through rows may collide with the kept object's own; the guard reports them.
|
|
396
|
+
if relation.one_to_many and not relation.related_model._meta.auto_created:
|
|
397
|
+
name = relation.field.name
|
|
398
|
+
repoint(relation.related_model, {name: self}, {name: other_object})
|
|
399
|
+
content_type = ContentType.objects.get_for_model(self.__class__)
|
|
400
|
+
for model, field in get_generic_foreign_keys():
|
|
401
|
+
if model is not ChangeLog:
|
|
402
|
+
repoint(
|
|
403
|
+
model,
|
|
404
|
+
{field.ct_field: content_type, field.fk_field: self.pk},
|
|
405
|
+
{field.fk_field: other_object.pk},
|
|
406
|
+
)
|
|
365
407
|
|
|
366
408
|
# Update objects merged into the current object to point to the new object, to empty any relations
|
|
367
409
|
self.__class__.objects.filter(merged_into=self).update(merged_into=other_object)
|
|
368
410
|
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
raise ValidationError(
|
|
377
|
-
"Cascading object deletes not handled by delete_and_merge_with: %s" % related_objects,
|
|
378
|
-
params=related_objects,
|
|
379
|
-
)
|
|
411
|
+
left_behind = [
|
|
412
|
+
f"{relation.related_model._meta.label}.{relation.field.name}"
|
|
413
|
+
for relation in self.get_merge_relations()
|
|
414
|
+
if relation.related_model._base_manager.filter(**{relation.field.name: self}).exists()
|
|
415
|
+
]
|
|
416
|
+
if left_behind:
|
|
417
|
+
raise ValidationError(f"Cannot merge {self}: still referenced by {', '.join(left_behind)}")
|
|
380
418
|
before = copy.copy(self)
|
|
381
419
|
self.soft_delete(merged_into=other_object)
|
|
382
420
|
ChangeLog.objects.create_from_objects(
|
|
@@ -993,6 +1031,18 @@ class WorkLog(BaseCrudKitModel):
|
|
|
993
1031
|
def __str__(self):
|
|
994
1032
|
return f"Work log on {self.related_object} from {self.created_at}"
|
|
995
1033
|
|
|
1034
|
+
def clean(self):
|
|
1035
|
+
if self.end_at is not None or not self.created_by_id:
|
|
1036
|
+
return
|
|
1037
|
+
running = (
|
|
1038
|
+
WorkLog.objects.filter(created_by_id=self.created_by_id, end_at__isnull=True).exclude(pk=self.pk).first()
|
|
1039
|
+
)
|
|
1040
|
+
if running:
|
|
1041
|
+
raise ValidationError(
|
|
1042
|
+
_("You are already tracking time on %(object)s. Stop that timer first."),
|
|
1043
|
+
params={"object": running.related_object},
|
|
1044
|
+
)
|
|
1045
|
+
|
|
996
1046
|
class CrudKitSettings(BaseCrudKitModel.CrudKitSettings):
|
|
997
1047
|
allowed_prefills = ["related_content_type", "related_object_id"]
|
|
998
1048
|
search_fields = []
|
|
@@ -101,7 +101,7 @@ def process_ai_fields(app_label: str, model_name: str, pk: int) -> None:
|
|
|
101
101
|
if isinstance(field, AIForeignKeyField):
|
|
102
102
|
try:
|
|
103
103
|
related_obj = field.related_model.objects.get(pk=value)
|
|
104
|
-
except field.related_model.DoesNotExist:
|
|
104
|
+
except (field.related_model.DoesNotExist, ValueError):
|
|
105
105
|
logger.warning(f"Related object pk={value} not found for {name}, skipping")
|
|
106
106
|
continue
|
|
107
107
|
setattr(instance, name, related_obj)
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
from decimal import Decimal
|
|
2
2
|
from unittest.mock import patch
|
|
3
3
|
|
|
4
|
-
from django.contrib.auth.models import
|
|
4
|
+
from django.contrib.auth.models import User
|
|
5
5
|
from django.test import TestCase
|
|
6
6
|
from rest_framework.test import APIClient
|
|
7
7
|
from rest_framework_simplejwt.tokens import RefreshToken
|
|
@@ -11,18 +11,10 @@ from crudkit.models import ChangeLog
|
|
|
11
11
|
from crudkit.utils import get_system_user
|
|
12
12
|
from crudkit_api import services
|
|
13
13
|
from crudkit_assistant.models import AssistantProposal
|
|
14
|
+
from tests.support import grant
|
|
14
15
|
from tests.testapp.models import Customer, Topic
|
|
15
16
|
|
|
16
17
|
|
|
17
|
-
def grant(user, model, *actions):
|
|
18
|
-
user.user_permissions.add(
|
|
19
|
-
*Permission.objects.filter(
|
|
20
|
-
content_type__app_label=model._meta.app_label,
|
|
21
|
-
codename__in=[f"{action}_{model._meta.model_name}" for action in actions],
|
|
22
|
-
)
|
|
23
|
-
)
|
|
24
|
-
|
|
25
|
-
|
|
26
18
|
def entries(instance):
|
|
27
19
|
return ChangeLog.objects.filter(related_object_id=instance.pk).order_by("created_at", "id")
|
|
28
20
|
|
|
@@ -16,8 +16,9 @@ from crudkit import llm
|
|
|
16
16
|
from crudkit.audit import audit
|
|
17
17
|
from crudkit.decorators import crm_action
|
|
18
18
|
from crudkit.models import AIContext, ChangeLog
|
|
19
|
-
from crudkit.tests.test_audit import entries
|
|
19
|
+
from crudkit.tests.test_audit import entries
|
|
20
20
|
from crudkit_api import services
|
|
21
|
+
from tests.support import grant
|
|
21
22
|
from tests.testapp.models import Customer, Ticket
|
|
22
23
|
|
|
23
24
|
|
|
@@ -113,7 +113,7 @@ def build_model_metadata(model, user=None) -> dict[str, Any]:
|
|
|
113
113
|
"""Return the model-level metadata payload served at /api/v1/<type>/metadata/."""
|
|
114
114
|
mfc = _model_field_choices()
|
|
115
115
|
fields = OrderedDict((field.name, _field_metadata(field, mfc)) for field in model._meta.fields)
|
|
116
|
-
relations = [_relation_metadata(rel) for rel in model._meta.related_objects]
|
|
116
|
+
relations = [_relation_metadata(rel) for rel in model._meta.related_objects if not rel.hidden]
|
|
117
117
|
for gen in _generic_relations():
|
|
118
118
|
rm = gen["related_model_cls"]
|
|
119
119
|
relations.append(
|
|
@@ -12,6 +12,8 @@ from django.conf import settings
|
|
|
12
12
|
from django.contrib.contenttypes.fields import GenericForeignKey
|
|
13
13
|
from django.core.exceptions import PermissionDenied
|
|
14
14
|
from django.db import models
|
|
15
|
+
from django.db.models import Avg, Count, Max, Min, Sum
|
|
16
|
+
from django.db.models.functions import Trunc
|
|
15
17
|
from django.utils import translation
|
|
16
18
|
|
|
17
19
|
from crudkit.authorization import (
|
|
@@ -35,6 +37,15 @@ CHANGELOG_LIMIT = 10
|
|
|
35
37
|
SKIPPED_APP_LABELS = {"admin", "auth", "contenttypes", "sessions"}
|
|
36
38
|
SKIPPED_FIELDS = {"deleted", "merged_into"}
|
|
37
39
|
AUDIT_FIELDS = {"created_by", "updated_by", "created_at", "updated_at"}
|
|
40
|
+
NUMERIC_FIELDS = (models.IntegerField, models.DecimalField, models.FloatField)
|
|
41
|
+
RANGE_FIELDS = (models.DateField, *NUMERIC_FIELDS)
|
|
42
|
+
# get_record's `fields` may also name these, which are not columns.
|
|
43
|
+
RECORD_EXTRAS = ("feed", "changelog")
|
|
44
|
+
PERIODS = ("day", "week", "month", "quarter", "year")
|
|
45
|
+
AGGREGATES = {"sum": Sum, "avg": Avg, "min": Min, "max": Max}
|
|
46
|
+
MAX_GROUP_BY = 2
|
|
47
|
+
DEFAULT_GROUPS = 100
|
|
48
|
+
MAX_GROUPS = 500
|
|
38
49
|
|
|
39
50
|
|
|
40
51
|
def get_exposed_models(mcp_allowlist: bool = True) -> list[type[models.Model]]:
|
|
@@ -127,22 +138,49 @@ def writable_fields(model) -> list[tuple[models.Field, dict]]:
|
|
|
127
138
|
]
|
|
128
139
|
|
|
129
140
|
|
|
141
|
+
def readable_fields(model) -> dict[str, models.Field]:
|
|
142
|
+
"""{name: field} of the columns a caller may ask for by name. Password
|
|
143
|
+
fields stay out, as they do in the serializer."""
|
|
144
|
+
return {f.name: f for f, _ in _schema_fields(model) if not f.name.lower().endswith("password")}
|
|
145
|
+
|
|
146
|
+
|
|
147
|
+
def _numeric(f) -> bool:
|
|
148
|
+
return isinstance(f, NUMERIC_FIELDS) and not f.choices
|
|
149
|
+
|
|
150
|
+
|
|
130
151
|
def _filters(model) -> tuple[dict, dict[str, str]]:
|
|
131
152
|
"""The accepted `filters` keys and the ORM lookup each maps to."""
|
|
132
153
|
described, lookups = {}, {}
|
|
154
|
+
|
|
155
|
+
def add(key, lookup, schema):
|
|
156
|
+
described[key], lookups[key] = schema, lookup
|
|
157
|
+
|
|
133
158
|
for f, schema in _schema_fields(model):
|
|
134
159
|
if isinstance(f, models.JSONField):
|
|
135
160
|
continue
|
|
136
161
|
if isinstance(f, models.DateField):
|
|
137
|
-
|
|
138
|
-
described[f"{f.name}_{suffix}"] = {**schema, "description": f"{schema['description']} ({label})"}
|
|
139
|
-
lookups[f"{f.name}_{suffix}"] = f"{f.name}__{lookup}"
|
|
162
|
+
pass # Dates only filter by range.
|
|
140
163
|
elif schema.get("type") == "string" and "enum" not in schema and not f.is_relation:
|
|
141
|
-
|
|
142
|
-
|
|
164
|
+
add(
|
|
165
|
+
f.name,
|
|
166
|
+
f"{f.name}__icontains",
|
|
167
|
+
{**schema, "description": f"{schema['description']} (contains, case-insensitive)"},
|
|
168
|
+
)
|
|
143
169
|
else:
|
|
144
|
-
|
|
145
|
-
|
|
170
|
+
add(f.name, f.name, schema)
|
|
171
|
+
if isinstance(f, RANGE_FIELDS) and not f.choices:
|
|
172
|
+
for suffix, lookup, label in (("from", "gte", "on or after"), ("to", "lte", "on or before")):
|
|
173
|
+
add(
|
|
174
|
+
f"{f.name}_{suffix}",
|
|
175
|
+
f"{f.name}__{lookup}",
|
|
176
|
+
{**schema, "description": f"{schema['description']} ({label})"},
|
|
177
|
+
)
|
|
178
|
+
if f.null:
|
|
179
|
+
add(
|
|
180
|
+
f"{f.name}_isnull",
|
|
181
|
+
f"{f.name}__isnull",
|
|
182
|
+
{"type": "boolean", "description": f"{schema['description']} is empty"},
|
|
183
|
+
)
|
|
146
184
|
return described, lookups
|
|
147
185
|
|
|
148
186
|
|
|
@@ -179,6 +217,8 @@ def _type_detail(user, model) -> dict:
|
|
|
179
217
|
"searchable": bool(services.get_search_fields(model)),
|
|
180
218
|
"fields": {f.name: schema for f, schema in writable_fields(model)},
|
|
181
219
|
"required_on_create": [f.name for f, _ in writable_fields(model) if not f.blank and not f.has_default()],
|
|
220
|
+
"columns": list(readable_fields(model)),
|
|
221
|
+
"aggregatable": [name for name, f in readable_fields(model).items() if _numeric(f)],
|
|
182
222
|
"actions": {
|
|
183
223
|
name: {"label": label, "requires_approval": requires_approval(model, action=name)}
|
|
184
224
|
for name, label in action_names(model).items()
|
|
@@ -205,8 +245,113 @@ def list_records(
|
|
|
205
245
|
order_by: str | None = None,
|
|
206
246
|
limit: int | None = None,
|
|
207
247
|
offset: int | None = None,
|
|
248
|
+
fields: list[str] | None = None,
|
|
249
|
+
) -> dict:
|
|
250
|
+
"""Records of one type, or of a saved view (its filters, ordering and columns).
|
|
251
|
+
`fields` picks the columns, overriding the view's."""
|
|
252
|
+
model, view_obj, qs = _queryset(user, type_id, view, filters, query)
|
|
253
|
+
if order_by and order_by.lstrip("-") not in {f.name for f in model._meta.concrete_fields}:
|
|
254
|
+
raise ValueError(f"Cannot order by {order_by!r}")
|
|
255
|
+
qs = order_queryset(qs, get_order_fields(view_obj, order_by))
|
|
256
|
+
limit = min(max(int(limit or DEFAULT_LIMIT), 1), MAX_LIMIT)
|
|
257
|
+
offset = max(int(offset or 0), 0)
|
|
258
|
+
if fields:
|
|
259
|
+
columns = _with_id_label(_checked_columns(model, fields))
|
|
260
|
+
else:
|
|
261
|
+
columns = _with_id_label(view_obj.fields) if view_obj else "__all__"
|
|
262
|
+
return {"total": qs.count(), "results": serialize(model, qs[offset : offset + limit], depth=0, fields=columns)}
|
|
263
|
+
|
|
264
|
+
|
|
265
|
+
def aggregate_records(
|
|
266
|
+
user,
|
|
267
|
+
type_id: str | None = None,
|
|
268
|
+
view: str | None = None,
|
|
269
|
+
filters: dict | None = None,
|
|
270
|
+
query: str | None = None,
|
|
271
|
+
group_by: list[str] | None = None,
|
|
272
|
+
metrics: list[str] | None = None,
|
|
273
|
+
order_by: str | None = None,
|
|
274
|
+
limit: int | None = None,
|
|
208
275
|
) -> dict:
|
|
209
|
-
"""
|
|
276
|
+
"""Count, sum, average, min or max over the records list_records would
|
|
277
|
+
return, grouped by up to MAX_GROUP_BY fields or date periods
|
|
278
|
+
(`created_at:month`)."""
|
|
279
|
+
model, _, qs = _queryset(user, type_id, view, filters, query)
|
|
280
|
+
columns = readable_fields(model)
|
|
281
|
+
plain, truncated = [], {}
|
|
282
|
+
for entry in _names(group_by, "group_by"):
|
|
283
|
+
name, _, period = entry.partition(":")
|
|
284
|
+
f = columns.get(name)
|
|
285
|
+
if f is None or isinstance(f, models.JSONField):
|
|
286
|
+
raise ValueError(f"Cannot group by {name!r}. Valid: {list(columns)}")
|
|
287
|
+
if not period:
|
|
288
|
+
plain.append(name)
|
|
289
|
+
elif isinstance(f, models.DateField) and period in PERIODS:
|
|
290
|
+
truncated[f"{name}_{period}"] = Trunc(name, period, output_field=models.DateField())
|
|
291
|
+
else:
|
|
292
|
+
raise ValueError(f"Cannot group by {entry!r}: date fields take :{'|:'.join(PERIODS)}")
|
|
293
|
+
keys = [*plain, *truncated]
|
|
294
|
+
if len(keys) > MAX_GROUP_BY:
|
|
295
|
+
raise ValueError(f"Group by at most {MAX_GROUP_BY} fields")
|
|
296
|
+
|
|
297
|
+
annotations = {}
|
|
298
|
+
for entry in _names(metrics, "metrics") or ["count"]:
|
|
299
|
+
func, _, name = entry.partition(":")
|
|
300
|
+
f = columns.get(name)
|
|
301
|
+
if entry == "count":
|
|
302
|
+
annotations["count"] = Count("pk")
|
|
303
|
+
elif func not in AGGREGATES or f is None:
|
|
304
|
+
raise ValueError(f"Unknown metric {entry!r}: use count, or sum|avg|min|max:<field>")
|
|
305
|
+
elif not (_numeric(f) if func in ("sum", "avg") else isinstance(f, RANGE_FIELDS)):
|
|
306
|
+
raise ValueError(
|
|
307
|
+
f"Cannot {func} {name!r}: needs a {'numeric' if func in ('sum', 'avg') else 'numeric or date'} field"
|
|
308
|
+
)
|
|
309
|
+
else:
|
|
310
|
+
annotations[f"{func}_{name}"] = AGGREGATES[func](name)
|
|
311
|
+
|
|
312
|
+
qs = qs.order_by()
|
|
313
|
+
total = qs.count()
|
|
314
|
+
if not keys:
|
|
315
|
+
return {"total": total, "groups": [_jsonable(qs.aggregate(**annotations))], "truncated": False}
|
|
316
|
+
if order_by and order_by.lstrip("-") not in [*keys, *annotations]:
|
|
317
|
+
raise ValueError(f"Cannot order by {order_by!r}. Valid: {[*keys, *annotations]}")
|
|
318
|
+
rows = qs.values(*plain, **truncated).annotate(**annotations).order_by(*([order_by] if order_by else []), *keys)
|
|
319
|
+
limit = min(max(int(limit or DEFAULT_GROUPS), 1), MAX_GROUPS)
|
|
320
|
+
rows = list(rows[: limit + 1])
|
|
321
|
+
groups = [_jsonable(row) for row in rows[:limit]]
|
|
322
|
+
for name in plain:
|
|
323
|
+
if columns[name].is_relation:
|
|
324
|
+
labels = _labels(user, columns[name].related_model, {group[name] for group in groups})
|
|
325
|
+
for group in groups:
|
|
326
|
+
group[f"{name}_label"] = labels.get(group[name])
|
|
327
|
+
return {"total": total, "groups": groups, "truncated": len(rows) > limit}
|
|
328
|
+
|
|
329
|
+
|
|
330
|
+
def get_record(user, object_id: str, fields: list[str] | None = None) -> dict:
|
|
331
|
+
"""One record with its recent feed, change log and the actions `user` may
|
|
332
|
+
run. `fields` picks the columns, and `feed`/`changelog` only if named."""
|
|
333
|
+
model, instance = get_instance(user, object_id, "view")
|
|
334
|
+
if fields:
|
|
335
|
+
wanted = _checked_columns(model, fields, RECORD_EXTRAS)
|
|
336
|
+
columns = _with_id_label([name for name in wanted if name not in RECORD_EXTRAS])
|
|
337
|
+
else:
|
|
338
|
+
wanted, columns = RECORD_EXTRAS, "__all__"
|
|
339
|
+
data = serialize(model, [instance], depth=1, fields=columns)[0]
|
|
340
|
+
if "feed" in wanted:
|
|
341
|
+
data["feed"] = services.get_feed(instance, FEED_LIMIT)
|
|
342
|
+
if "changelog" in wanted and has_model_permission(user, ChangeLog, "view"):
|
|
343
|
+
data["changelog"] = services.get_changelog(instance, CHANGELOG_LIMIT)
|
|
344
|
+
data["actions"] = [name for name in action_names(model) if has_action_permission(user, instance, name)]
|
|
345
|
+
return data
|
|
346
|
+
|
|
347
|
+
|
|
348
|
+
# ---------------------------------------------------------------------------
|
|
349
|
+
# Helpers
|
|
350
|
+
|
|
351
|
+
|
|
352
|
+
def _queryset(user, type_id, view, filters, query):
|
|
353
|
+
"""`(model, view, queryset)`: the visible records of `type_id` or of the
|
|
354
|
+
saved `view`, narrowed by `filters` and the free-text `query`."""
|
|
210
355
|
view_obj = get_view(user, view) if view else None
|
|
211
356
|
model = resolve_type(user, view_obj.model if view_obj else type_id)
|
|
212
357
|
if view_obj and type_id not in (None, view_obj.model):
|
|
@@ -221,34 +366,58 @@ def list_records(
|
|
|
221
366
|
|
|
222
367
|
qs = visible(model, user, "view")
|
|
223
368
|
for name, value in filters.items():
|
|
224
|
-
if value
|
|
225
|
-
|
|
369
|
+
if value in (None, ""):
|
|
370
|
+
continue
|
|
371
|
+
lookup = lookups[name]
|
|
372
|
+
if isinstance(value, list):
|
|
373
|
+
if "__" in lookup:
|
|
374
|
+
raise ValueError(f"Filter {name!r} takes one value, not a list")
|
|
375
|
+
lookup += "__in"
|
|
376
|
+
qs = qs.filter(**{lookup: value})
|
|
226
377
|
if query:
|
|
227
378
|
qs = qs.filter(services.search_filter(model, query))
|
|
228
379
|
if view_obj:
|
|
229
380
|
qs = view_obj.filter(qs, request=services.RequestShim(user))
|
|
230
|
-
|
|
231
|
-
raise ValueError(f"Cannot order by {order_by!r}")
|
|
232
|
-
qs = order_queryset(qs, get_order_fields(view_obj, order_by))
|
|
233
|
-
limit = min(max(int(limit or DEFAULT_LIMIT), 1), MAX_LIMIT)
|
|
234
|
-
offset = max(int(offset or 0), 0)
|
|
235
|
-
fields = ["id", "label", *view_obj.fields] if view_obj else "__all__"
|
|
236
|
-
return {"total": qs.count(), "results": serialize(model, qs[offset : offset + limit], depth=0, fields=fields)}
|
|
381
|
+
return model, view_obj, qs
|
|
237
382
|
|
|
238
383
|
|
|
239
|
-
def
|
|
240
|
-
"""
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
return
|
|
384
|
+
def _names(value, argument: str) -> list[str]:
|
|
385
|
+
"""A list of names; a lone string counts as a list of one."""
|
|
386
|
+
if value in (None, ""):
|
|
387
|
+
return []
|
|
388
|
+
if isinstance(value, str):
|
|
389
|
+
return [value]
|
|
390
|
+
if not isinstance(value, list) or not all(isinstance(name, str) for name in value):
|
|
391
|
+
raise ValueError(f"`{argument}` must be a list of names")
|
|
392
|
+
return value
|
|
248
393
|
|
|
249
394
|
|
|
250
|
-
|
|
251
|
-
|
|
395
|
+
def _checked_columns(model, fields, extras=()) -> list[str]:
|
|
396
|
+
names = _names(fields, "fields")
|
|
397
|
+
valid = ["id", "label", *readable_fields(model), *extras]
|
|
398
|
+
unknown = sorted(set(names) - set(valid))
|
|
399
|
+
if unknown:
|
|
400
|
+
raise ValueError(f"Unknown field(s): {unknown}. Valid: {valid}")
|
|
401
|
+
return names
|
|
402
|
+
|
|
403
|
+
|
|
404
|
+
def _with_id_label(columns) -> list[str]:
|
|
405
|
+
return list(dict.fromkeys(["id", "label", *columns]))
|
|
406
|
+
|
|
407
|
+
|
|
408
|
+
def _jsonable(row: dict) -> dict:
|
|
409
|
+
return {key: value.isoformat() if hasattr(value, "isoformat") else value for key, value in row.items()}
|
|
410
|
+
|
|
411
|
+
|
|
412
|
+
def _related_queryset(user, related):
|
|
413
|
+
if getattr(related, "TYPE_ID", None):
|
|
414
|
+
return get_authorized_queryset(user, related.objects.all(), "view")
|
|
415
|
+
return related._default_manager.all()
|
|
416
|
+
|
|
417
|
+
|
|
418
|
+
def _labels(user, related, pks) -> dict:
|
|
419
|
+
"""{pk: label} of the `related` rows among `pks` that `user` may see."""
|
|
420
|
+
return {obj.pk: str(obj) for obj in _related_queryset(user, related).filter(pk__in=pks - {None})}
|
|
252
421
|
|
|
253
422
|
|
|
254
423
|
def resolve_type(user, type_id):
|
|
@@ -312,12 +481,7 @@ def check_values(user, writable: dict, fields: dict) -> dict:
|
|
|
312
481
|
value = value.get("id")
|
|
313
482
|
if f.is_relation and value not in (None, ""):
|
|
314
483
|
related = f.related_model
|
|
315
|
-
|
|
316
|
-
get_authorized_queryset(user, related.objects.all(), "view")
|
|
317
|
-
if getattr(related, "TYPE_ID", None)
|
|
318
|
-
else related._default_manager.all()
|
|
319
|
-
)
|
|
320
|
-
if not qs.filter(pk=value).exists():
|
|
484
|
+
if not _related_queryset(user, related).filter(pk=value).exists():
|
|
321
485
|
raise ValueError(f"{name}: {related._meta.verbose_name} {value!r} not found")
|
|
322
486
|
return fields
|
|
323
487
|
|