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.
Files changed (285) hide show
  1. {crudkit-0.6.4 → crudkit-0.7.0}/.gitignore +3 -0
  2. {crudkit-0.6.4 → crudkit-0.7.0}/CHANGELOG.md +52 -0
  3. {crudkit-0.6.4 → crudkit-0.7.0}/PKG-INFO +1 -1
  4. {crudkit-0.6.4 → crudkit-0.7.0}/pyproject.toml +12 -1
  5. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/fields.py +3 -3
  6. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/management/commands/set_exchange_rate.py +12 -3
  7. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/models.py +74 -24
  8. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tasks.py +1 -1
  9. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_audit.py +2 -10
  10. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_hardening.py +2 -1
  11. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/metadata.py +1 -1
  12. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/records.py +198 -34
  13. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/serializers.py +26 -22
  14. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/services.py +8 -4
  15. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/tests/test_authorization.py +2 -9
  16. crudkit-0.7.0/src/crudkit_api/tests/test_merge.py +99 -0
  17. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/tests/test_realtime.py +1 -1
  18. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/tests/test_reorder.py +1 -1
  19. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/tests/test_search.py +1 -1
  20. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/views.py +11 -3
  21. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/agent.py +7 -1
  22. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/tests/test_agents.py +1 -8
  23. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/tests/test_approvals.py +1 -9
  24. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/tests/test_hardening.py +2 -1
  25. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/tests/test_sidebar.py +6 -0
  26. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/tools.py +45 -4
  27. 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
  28. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/templates/crudkit_frontend/index.html +1 -1
  29. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/tests/test_hardening.py +2 -1
  30. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/tests/test_mcp.py +138 -11
  31. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/tools.py +88 -18
  32. crudkit-0.7.0/tests/bdd/README.md +200 -0
  33. crudkit-0.7.0/tests/bdd/conftest.py +38 -0
  34. crudkit-0.7.0/tests/bdd/features/account/dashboard.feature +58 -0
  35. crudkit-0.7.0/tests/bdd/features/account/profile.feature +62 -0
  36. crudkit-0.7.0/tests/bdd/features/account/sign_in.feature +42 -0
  37. crudkit-0.7.0/tests/bdd/features/actions/run_an_action.feature +79 -0
  38. crudkit-0.7.0/tests/bdd/features/agents/agents_need_a_person.feature +42 -0
  39. crudkit-0.7.0/tests/bdd/features/agents/agents_that_keep_failing.feature +44 -0
  40. crudkit-0.7.0/tests/bdd/features/agents/dry_runs.feature +42 -0
  41. crudkit-0.7.0/tests/bdd/features/agents/reverting_an_agent_run.feature +48 -0
  42. crudkit-0.7.0/tests/bdd/features/agents/scheduled_agents.feature +69 -0
  43. crudkit-0.7.0/tests/bdd/features/agents/setting_up_an_agent.feature +101 -0
  44. crudkit-0.7.0/tests/bdd/features/agents/what_a_run_does.feature +85 -0
  45. crudkit-0.7.0/tests/bdd/features/agents/what_starts_an_agent.feature +92 -0
  46. crudkit-0.7.0/tests/bdd/features/ai-fields/ai_category_fields.feature +19 -0
  47. crudkit-0.7.0/tests/bdd/features/ai-fields/ai_context.feature +82 -0
  48. crudkit-0.7.0/tests/bdd/features/ai-fields/backfill_ai_fields.feature +43 -0
  49. crudkit-0.7.0/tests/bdd/features/ai-fields/fill_in_ai_fields.feature +88 -0
  50. crudkit-0.7.0/tests/bdd/features/ai-fields/when_ai_fields_refresh.feature +49 -0
  51. crudkit-0.7.0/tests/bdd/features/approvals/confirm_a_proposal.feature +115 -0
  52. crudkit-0.7.0/tests/bdd/features/approvals/skip_a_proposal.feature +28 -0
  53. crudkit-0.7.0/tests/bdd/features/approvals/what_needs_approval.feature +50 -0
  54. crudkit-0.7.0/tests/bdd/features/approvals/who_sees_proposals.feature +34 -0
  55. crudkit-0.7.0/tests/bdd/features/assistant/cards_in_the_sidebar.feature +71 -0
  56. crudkit-0.7.0/tests/bdd/features/assistant/conversations.feature +58 -0
  57. crudkit-0.7.0/tests/bdd/features/assistant/filling_in_forms.feature +105 -0
  58. crudkit-0.7.0/tests/bdd/features/assistant/finding_records.feature +115 -0
  59. crudkit-0.7.0/tests/bdd/features/assistant/instructions.feature +91 -0
  60. crudkit-0.7.0/tests/bdd/features/assistant/opening_the_sidebar.feature +53 -0
  61. crudkit-0.7.0/tests/bdd/features/assistant/proposing_changes.feature +159 -0
  62. crudkit-0.7.0/tests/bdd/features/assistant/proposing_new_records_and_undos.feature +83 -0
  63. crudkit-0.7.0/tests/bdd/features/assistant/reading_records.feature +122 -0
  64. crudkit-0.7.0/tests/bdd/features/assistant/turns.feature +95 -0
  65. crudkit-0.7.0/tests/bdd/features/assistant/what_the_assistant_sees.feature +109 -0
  66. crudkit-0.7.0/tests/bdd/features/history/changes_from_other_systems.feature +42 -0
  67. crudkit-0.7.0/tests/bdd/features/history/reading_history.feature +94 -0
  68. crudkit-0.7.0/tests/bdd/features/history/what_the_change_log_keeps.feature +77 -0
  69. crudkit-0.7.0/tests/bdd/features/history/who_made_a_change.feature +84 -0
  70. crudkit-0.7.0/tests/bdd/features/identity/links_to_any_record.feature +52 -0
  71. crudkit-0.7.0/tests/bdd/features/identity/record_ids.feature +68 -0
  72. crudkit-0.7.0/tests/bdd/features/identity/record_type_letters.feature +37 -0
  73. crudkit-0.7.0/tests/bdd/features/mcp/aggregate_records.feature +169 -0
  74. crudkit-0.7.0/tests/bdd/features/mcp/approval_rules.feature +45 -0
  75. crudkit-0.7.0/tests/bdd/features/mcp/describe_types.feature +70 -0
  76. crudkit-0.7.0/tests/bdd/features/mcp/exposed_types.feature +38 -0
  77. crudkit-0.7.0/tests/bdd/features/mcp/extra_tools.feature +33 -0
  78. crudkit-0.7.0/tests/bdd/features/mcp/get_record.feature +78 -0
  79. crudkit-0.7.0/tests/bdd/features/mcp/list_records.feature +116 -0
  80. crudkit-0.7.0/tests/bdd/features/mcp/propose_changes.feature +63 -0
  81. crudkit-0.7.0/tests/bdd/features/mcp/protocol.feature +69 -0
  82. crudkit-0.7.0/tests/bdd/features/mcp/saved_views.feature +92 -0
  83. crudkit-0.7.0/tests/bdd/features/mcp/search.feature +35 -0
  84. crudkit-0.7.0/tests/bdd/features/mcp/signing_in.feature +46 -0
  85. crudkit-0.7.0/tests/bdd/features/mcp/tools_by_access.feature +42 -0
  86. crudkit-0.7.0/tests/bdd/features/mcp/undo.feature +62 -0
  87. crudkit-0.7.0/tests/bdd/features/mcp/write_directly.feature +100 -0
  88. crudkit-0.7.0/tests/bdd/features/mcp/write_limit.feature +49 -0
  89. crudkit-0.7.0/tests/bdd/features/mcp/write_limit_checks.feature +31 -0
  90. crudkit-0.7.0/tests/bdd/features/merge-restore-reorder/deleted_records_and_restore.feature +46 -0
  91. crudkit-0.7.0/tests/bdd/features/merge-restore-reorder/merge_duplicates.feature +109 -0
  92. crudkit-0.7.0/tests/bdd/features/merge-restore-reorder/reorder_records.feature +54 -0
  93. crudkit-0.7.0/tests/bdd/features/metadata/describe_a_record_type.feature +81 -0
  94. crudkit-0.7.0/tests/bdd/features/metadata/describe_one_record.feature +48 -0
  95. crudkit-0.7.0/tests/bdd/features/metadata/field_kinds.feature +31 -0
  96. crudkit-0.7.0/tests/bdd/features/money/amounts_and_currencies.feature +63 -0
  97. crudkit-0.7.0/tests/bdd/features/money/amounts_in_the_app.feature +67 -0
  98. crudkit-0.7.0/tests/bdd/features/money/exchange_rate_commands.feature +98 -0
  99. crudkit-0.7.0/tests/bdd/features/money/exchange_rates.feature +79 -0
  100. crudkit-0.7.0/tests/bdd/features/notes-feed-worklog/external_systems.feature +51 -0
  101. crudkit-0.7.0/tests/bdd/features/notes-feed-worklog/notes_and_activity.feature +46 -0
  102. crudkit-0.7.0/tests/bdd/features/notes-feed-worklog/snippets.feature +24 -0
  103. crudkit-0.7.0/tests/bdd/features/notes-feed-worklog/work_logs.feature +50 -0
  104. crudkit-0.7.0/tests/bdd/features/oauth/discovery.feature +49 -0
  105. crudkit-0.7.0/tests/bdd/features/oauth/exchange_a_code.feature +58 -0
  106. crudkit-0.7.0/tests/bdd/features/oauth/grant_access.feature +117 -0
  107. crudkit-0.7.0/tests/bdd/features/oauth/refresh_tokens.feature +61 -0
  108. crudkit-0.7.0/tests/bdd/features/oauth/register_a_client.feature +53 -0
  109. crudkit-0.7.0/tests/bdd/features/permissions/owner_access.feature +42 -0
  110. crudkit-0.7.0/tests/bdd/features/permissions/record_permissions.feature +86 -0
  111. crudkit-0.7.0/tests/bdd/features/permissions/row_rules.feature +52 -0
  112. crudkit-0.7.0/tests/bdd/features/realtime/change_stream.feature +73 -0
  113. crudkit-0.7.0/tests/bdd/features/realtime/sign_in_on_the_change_stream.feature +36 -0
  114. crudkit-0.7.0/tests/bdd/features/records/create_records.feature +72 -0
  115. crudkit-0.7.0/tests/bdd/features/records/delete_records.feature +45 -0
  116. crudkit-0.7.0/tests/bdd/features/records/edit_records.feature +99 -0
  117. crudkit-0.7.0/tests/bdd/features/records/list_records.feature +131 -0
  118. crudkit-0.7.0/tests/bdd/features/records/start_a_new_record.feature +61 -0
  119. crudkit-0.7.0/tests/bdd/features/records/view_a_record.feature +51 -0
  120. crudkit-0.7.0/tests/bdd/features/search/search_a_list.feature +46 -0
  121. crudkit-0.7.0/tests/bdd/features/search/search_everything.feature +75 -0
  122. crudkit-0.7.0/tests/bdd/features/spa-shell/web_app_page.feature +47 -0
  123. crudkit-0.7.0/tests/bdd/features/undo/undo_a_change_set.feature +62 -0
  124. crudkit-0.7.0/tests/bdd/features/undo/what_can_be_undone.feature +146 -0
  125. crudkit-0.7.0/tests/bdd/features/views-and-workspaces/menu_badges.feature +43 -0
  126. crudkit-0.7.0/tests/bdd/features/views-and-workspaces/opening_a_view.feature +131 -0
  127. crudkit-0.7.0/tests/bdd/features/views-and-workspaces/saving_a_view.feature +72 -0
  128. crudkit-0.7.0/tests/bdd/features/views-and-workspaces/who_sees_a_view.feature +36 -0
  129. crudkit-0.7.0/tests/bdd/features/views-and-workspaces/workspaces.feature +59 -0
  130. crudkit-0.7.0/tests/bdd/steps/account.py +385 -0
  131. crudkit-0.7.0/tests/bdd/steps/actions.py +117 -0
  132. crudkit-0.7.0/tests/bdd/steps/agents.py +616 -0
  133. crudkit-0.7.0/tests/bdd/steps/ai_fields.py +380 -0
  134. crudkit-0.7.0/tests/bdd/steps/approvals.py +238 -0
  135. crudkit-0.7.0/tests/bdd/steps/assistant.py +1014 -0
  136. crudkit-0.7.0/tests/bdd/steps/assistant_tools.py +500 -0
  137. crudkit-0.7.0/tests/bdd/steps/common.py +146 -0
  138. crudkit-0.7.0/tests/bdd/steps/feed.py +278 -0
  139. crudkit-0.7.0/tests/bdd/steps/history.py +488 -0
  140. crudkit-0.7.0/tests/bdd/steps/identity.py +137 -0
  141. crudkit-0.7.0/tests/bdd/steps/mcp.py +1003 -0
  142. crudkit-0.7.0/tests/bdd/steps/merge.py +121 -0
  143. crudkit-0.7.0/tests/bdd/steps/metadata.py +274 -0
  144. crudkit-0.7.0/tests/bdd/steps/money.py +332 -0
  145. crudkit-0.7.0/tests/bdd/steps/oauth.py +544 -0
  146. crudkit-0.7.0/tests/bdd/steps/permissions.py +117 -0
  147. crudkit-0.7.0/tests/bdd/steps/realtime.py +243 -0
  148. crudkit-0.7.0/tests/bdd/steps/records.py +409 -0
  149. crudkit-0.7.0/tests/bdd/steps/search.py +94 -0
  150. crudkit-0.7.0/tests/bdd/steps/spa_shell.py +114 -0
  151. crudkit-0.7.0/tests/bdd/steps/undo.py +160 -0
  152. crudkit-0.7.0/tests/bdd/steps/views.py +288 -0
  153. crudkit-0.7.0/tests/bdd/test_coverage.py +129 -0
  154. crudkit-0.7.0/tests/bdd/test_features.py +8 -0
  155. crudkit-0.7.0/tests/bdd/world.py +245 -0
  156. crudkit-0.7.0/tests/support.py +13 -0
  157. crudkit-0.7.0/tests/testapp/migrations/__init__.py +0 -0
  158. crudkit-0.6.4/src/crudkit_api/tests/test_merge.py +0 -33
  159. {crudkit-0.6.4 → crudkit-0.7.0}/README.md +0 -0
  160. {crudkit-0.6.4 → crudkit-0.7.0}/manage.py +0 -0
  161. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/__init__.py +0 -0
  162. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/admin.py +0 -0
  163. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/ai_backend.py +0 -0
  164. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/apps.py +0 -0
  165. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/audit.py +0 -0
  166. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/authorization.py +0 -0
  167. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/checks.py +0 -0
  168. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/decorators.py +0 -0
  169. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/llm.py +0 -0
  170. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/management/__init__.py +0 -0
  171. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/management/commands/__init__.py +0 -0
  172. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/management/commands/add_default_exchange_rates.py +0 -0
  173. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/management/commands/backfill_ai_fields.py +0 -0
  174. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/migrations/0001_squashed.py +0 -0
  175. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/migrations/0002_workspace.py +0 -0
  176. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/migrations/0003_enforce_data_invariants.py +0 -0
  177. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/migrations/0004_changelog_audit.py +0 -0
  178. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/migrations/0005_aicontext.py +0 -0
  179. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/migrations/0006_changelog_audit_indexes.py +0 -0
  180. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/migrations/0007_view_badge_filters.py +0 -0
  181. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/migrations/__init__.py +0 -0
  182. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/profile.py +0 -0
  183. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/realtime.py +0 -0
  184. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/signals.py +0 -0
  185. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/templatetags/__init__.py +0 -0
  186. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/templatetags/crm_forms.py +0 -0
  187. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/templatetags/crm_time.py +0 -0
  188. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/templatetags/gravatar.py +0 -0
  189. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/templatetags/model_magic.py +0 -0
  190. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/__init__.py +0 -0
  191. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_ai_backend.py +0 -0
  192. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_ai_context.py +0 -0
  193. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_ai_fields.py +0 -0
  194. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_ai_tasks.py +0 -0
  195. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_authorization.py +0 -0
  196. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_backfill_command.py +0 -0
  197. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_fields.py +0 -0
  198. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_integrity.py +0 -0
  199. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_llm.py +0 -0
  200. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_money.py +0 -0
  201. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_tasks.py +0 -0
  202. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_view_filters.py +0 -0
  203. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/tests/test_workspace.py +0 -0
  204. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/utils.py +0 -0
  205. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit/widgets.py +0 -0
  206. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/__init__.py +0 -0
  207. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/authentication.py +0 -0
  208. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/consumers.py +0 -0
  209. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/filters.py +0 -0
  210. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/pagination.py +0 -0
  211. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/permissions.py +0 -0
  212. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/routing.py +0 -0
  213. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/tests/__init__.py +0 -0
  214. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/tests/test_email_id_serialization.py +0 -0
  215. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/tests/test_filters.py +0 -0
  216. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/tests/test_list_serialization.py +0 -0
  217. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/tests/test_metadata.py +0 -0
  218. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/tests/test_user_profile.py +0 -0
  219. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/urls.py +0 -0
  220. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_api/ws_auth.py +0 -0
  221. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/__init__.py +0 -0
  222. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/admin.py +0 -0
  223. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/apps.py +0 -0
  224. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/background.py +0 -0
  225. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/consumers.py +0 -0
  226. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/deps.py +0 -0
  227. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/execution.py +0 -0
  228. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/migrations/0001_initial.py +0 -0
  229. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/migrations/0002_assistantconversation.py +0 -0
  230. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/migrations/0003_proposal_revert.py +0 -0
  231. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/migrations/0004_proposal_sources.py +0 -0
  232. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/migrations/0005_agent_agentrun.py +0 -0
  233. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/migrations/__init__.py +0 -0
  234. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/models.py +0 -0
  235. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/proposals.py +0 -0
  236. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/routing.py +0 -0
  237. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/runner.py +0 -0
  238. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/screen.py +0 -0
  239. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/signals.py +0 -0
  240. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/tasks.py +0 -0
  241. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/tests/__init__.py +0 -0
  242. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/tests/test_proposals.py +0 -0
  243. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_assistant/utils.py +0 -0
  244. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/__init__.py +0 -0
  245. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/apps.py +0 -0
  246. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/context_processors.py +0 -0
  247. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/static/crudkit_frontend/assets/favicon-Cit_9t8D.svg +0 -0
  248. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/static/crudkit_frontend/assets/index-Cxy1TyRo.css +0 -0
  249. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/tests/__init__.py +0 -0
  250. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/tests/templates/crudkit_frontend/index.html +0 -0
  251. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/tests/test_frontend.py +0 -0
  252. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/tests/urls.py +0 -0
  253. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/urls.py +0 -0
  254. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_frontend/views.py +0 -0
  255. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/__init__.py +0 -0
  256. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/admin.py +0 -0
  257. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/apps.py +0 -0
  258. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/authentication.py +0 -0
  259. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/checks.py +0 -0
  260. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/conf.py +0 -0
  261. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/migrations/0001_initial.py +0 -0
  262. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/migrations/__init__.py +0 -0
  263. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/models.py +0 -0
  264. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/oauth.py +0 -0
  265. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/server.py +0 -0
  266. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/templates/crudkit_mcp/authorize.html +0 -0
  267. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/tests/__init__.py +0 -0
  268. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/tests/test_oauth.py +0 -0
  269. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/urls.py +0 -0
  270. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/views.py +0 -0
  271. {crudkit-0.6.4 → crudkit-0.7.0}/src/crudkit_mcp/well_known_urls.py +0 -0
  272. {crudkit-0.6.4 → crudkit-0.7.0}/tests/__init__.py +0 -0
  273. {crudkit-0.6.4/tests/testapp → crudkit-0.7.0/tests/bdd/steps}/__init__.py +0 -0
  274. {crudkit-0.6.4 → crudkit-0.7.0}/tests/celery.py +0 -0
  275. {crudkit-0.6.4 → crudkit-0.7.0}/tests/settings.py +0 -0
  276. {crudkit-0.6.4/tests/testapp/migrations → crudkit-0.7.0/tests/testapp}/__init__.py +0 -0
  277. {crudkit-0.6.4 → crudkit-0.7.0}/tests/testapp/adapters.py +0 -0
  278. {crudkit-0.6.4 → crudkit-0.7.0}/tests/testapp/ai.py +0 -0
  279. {crudkit-0.6.4 → crudkit-0.7.0}/tests/testapp/apps.py +0 -0
  280. {crudkit-0.6.4 → crudkit-0.7.0}/tests/testapp/migrations/0001_initial.py +0 -0
  281. {crudkit-0.6.4 → crudkit-0.7.0}/tests/testapp/migrations/0002_customer_currency.py +0 -0
  282. {crudkit-0.6.4 → crudkit-0.7.0}/tests/testapp/migrations/0003_ticket_watchers.py +0 -0
  283. {crudkit-0.6.4 → crudkit-0.7.0}/tests/testapp/migrations/0004_topic_sort_order.py +0 -0
  284. {crudkit-0.6.4 → crudkit-0.7.0}/tests/testapp/models.py +0 -0
  285. {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.6.4
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.6.4"
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
- if not hasattr(model_instance, "amount"):
101
- return "N/A"
102
- amount = model_instance.amount
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
- rate = Decimal(options["rate"])
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.objects.create(
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", "updated_at"] if not merged_into else ["deleted", "merged_into", "updated_at"]
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
- This functions moves any related object to the `other_object`. It should not
353
- move field content, as this is handled by the merge view where the user
354
- may pick how the fields are merged
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
- self.externalobject_set.all().update(related_object_id=other_object.pk)
357
- FeedItem.objects.filter(
358
- related_content_type=ContentType.objects.get_for_model(self.__class__),
359
- related_object_id=self.pk,
360
- ).update(related_object_id=other_object.pk)
361
- FeedItem.objects.filter(
362
- parent_content_type=ContentType.objects.get_for_model(self.__class__),
363
- parent_object_id=self.pk,
364
- ).update(parent_object_id=other_object.pk)
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
- from django.contrib.admin.utils import NestedObjects
370
- from django.db import DEFAULT_DB_ALIAS
371
-
372
- collector = NestedObjects(using=DEFAULT_DB_ALIAS)
373
- collector.collect([self])
374
- related_objects = collector.nested()
375
- if len(related_objects) != 1:
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 Permission, User
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, grant
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
- for suffix, lookup, label in (("from", "gte", "on or after"), ("to", "lte", "on or before")):
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
- described[f.name] = {**schema, "description": f"{schema['description']} (contains, case-insensitive)"}
142
- lookups[f.name] = f"{f.name}__icontains"
164
+ add(
165
+ f.name,
166
+ f"{f.name}__icontains",
167
+ {**schema, "description": f"{schema['description']} (contains, case-insensitive)"},
168
+ )
143
169
  else:
144
- described[f.name] = schema
145
- lookups[f.name] = f.name
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
- """Records of one type, or of a saved view (its filters, ordering and columns)."""
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 not in (None, ""):
225
- qs = qs.filter(**{lookups[name]: value})
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
- if order_by and order_by.lstrip("-") not in {f.name for f in model._meta.concrete_fields}:
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 get_record(user, object_id: str) -> dict:
240
- """One record with its recent feed, change log and the actions `user` may run."""
241
- model, instance = get_instance(user, object_id, "view")
242
- data = serialize(model, [instance], depth=1)[0]
243
- data["feed"] = services.get_feed(instance, FEED_LIMIT)
244
- if has_model_permission(user, ChangeLog, "view"):
245
- data["changelog"] = services.get_changelog(instance, CHANGELOG_LIMIT)
246
- data["actions"] = [name for name in action_names(model) if has_action_permission(user, instance, name)]
247
- return data
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
- # Helpers
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
- qs = (
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