evlet 0.4.4__tar.gz → 0.4.6__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.
- {evlet-0.4.4 → evlet-0.4.6}/CHANGELOG.md +165 -0
- {evlet-0.4.4/evlet.egg-info → evlet-0.4.6}/PKG-INFO +7 -9
- {evlet-0.4.4 → evlet-0.4.6}/README.md +6 -5
- {evlet-0.4.4 → evlet-0.4.6}/docs/amendment-v2.md +8 -15
- {evlet-0.4.4 → evlet-0.4.6}/docs/api-stability.md +36 -30
- {evlet-0.4.4 → evlet-0.4.6}/docs/app-upgrades.md +6 -1
- {evlet-0.4.4 → evlet-0.4.6}/docs/architecture.md +26 -29
- {evlet-0.4.4 → evlet-0.4.6}/docs/business-capabilities.md +9 -9
- {evlet-0.4.4 → evlet-0.4.6}/docs/cli.md +2 -4
- {evlet-0.4.4 → evlet-0.4.6}/docs/connector.md +3 -3
- {evlet-0.4.4 → evlet-0.4.6}/docs/controls.md +8 -10
- evlet-0.4.6/docs/database-adapters.md +211 -0
- evlet-0.4.6/docs/document-lifecycle.md +100 -0
- {evlet-0.4.4 → evlet-0.4.6}/docs/effects.md +61 -84
- {evlet-0.4.4 → evlet-0.4.6}/docs/finite-calculations.md +16 -18
- {evlet-0.4.4 → evlet-0.4.6}/docs/jobs-realtime.md +5 -7
- {evlet-0.4.4 → evlet-0.4.6}/docs/journal.md +33 -29
- {evlet-0.4.4 → evlet-0.4.6}/docs/ledger.md +14 -24
- {evlet-0.4.4 → evlet-0.4.6}/docs/meaning.md +2 -5
- {evlet-0.4.4 → evlet-0.4.6}/docs/measures.md +4 -6
- {evlet-0.4.4 → evlet-0.4.6}/docs/model-engine.md +46 -52
- {evlet-0.4.4 → evlet-0.4.6}/docs/performance.md +56 -111
- {evlet-0.4.4 → evlet-0.4.6}/docs/production-operations.md +5 -19
- {evlet-0.4.4 → evlet-0.4.6}/docs/routing.md +1 -2
- {evlet-0.4.4 → evlet-0.4.6}/docs/sequences.md +19 -31
- {evlet-0.4.4 → evlet-0.4.6}/docs/settings.md +1 -1
- {evlet-0.4.4 → evlet-0.4.6}/docs/slips.md +3 -2
- evlet-0.4.6/docs/states-actions.md +657 -0
- {evlet-0.4.4 → evlet-0.4.6}/docs/tools.md +15 -14
- {evlet-0.4.4 → evlet-0.4.6}/docs/ui-framework.md +8 -10
- {evlet-0.4.4 → evlet-0.4.6}/docs/ui.md +11 -15
- {evlet-0.4.4 → evlet-0.4.6}/evlet/__init__.py +8 -9
- evlet-0.4.6/evlet/adapter.py +254 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/app.py +6 -4
- {evlet-0.4.4 → evlet-0.4.6}/evlet/assistants.py +82 -59
- {evlet-0.4.4 → evlet-0.4.6}/evlet/audit.py +27 -43
- {evlet-0.4.4 → evlet-0.4.6}/evlet/auth.py +171 -132
- {evlet-0.4.4 → evlet-0.4.6}/evlet/business.py +84 -88
- {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/backup.py +7 -36
- {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/ids.py +1 -1
- {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/install.py +6 -29
- evlet-0.4.6/evlet/cli/journal.py +27 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/main.py +2 -1
- {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/restart.py +5 -5
- {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/serve.py +10 -9
- {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/site.py +6 -7
- {evlet-0.4.4 → evlet-0.4.6}/evlet/connectors.py +25 -14
- {evlet-0.4.4 → evlet-0.4.6}/evlet/controls.py +159 -179
- {evlet-0.4.4 → evlet-0.4.6}/evlet/controls_system.py +14 -18
- {evlet-0.4.4 → evlet-0.4.6}/evlet/currencies.py +26 -25
- {evlet-0.4.4 → evlet-0.4.6}/evlet/customization.py +50 -73
- {evlet-0.4.4 → evlet-0.4.6}/evlet/database.py +109 -116
- {evlet-0.4.4 → evlet-0.4.6}/evlet/declarations.py +0 -41
- {evlet-0.4.4 → evlet-0.4.6}/evlet/devlink.py +20 -12
- {evlet-0.4.4 → evlet-0.4.6}/evlet/documents.py +159 -264
- {evlet-0.4.4 → evlet-0.4.6}/evlet/effects.py +53 -86
- {evlet-0.4.4 → evlet-0.4.6}/evlet/eva.py +249 -199
- {evlet-0.4.4 → evlet-0.4.6}/evlet/events.py +21 -13
- {evlet-0.4.4 → evlet-0.4.6}/evlet/fields.py +8 -82
- {evlet-0.4.4 → evlet-0.4.6}/evlet/forms.py +14 -3
- evlet-0.4.6/evlet/framework.py +254 -0
- evlet-0.4.4/evlet/states.py → evlet-0.4.6/evlet/guards.py +20 -306
- {evlet-0.4.4 → evlet-0.4.6}/evlet/identity.py +10 -31
- {evlet-0.4.4 → evlet-0.4.6}/evlet/images.py +24 -31
- {evlet-0.4.4 → evlet-0.4.6}/evlet/indexes.py +4 -17
- {evlet-0.4.4 → evlet-0.4.6}/evlet/instances.py +33 -22
- {evlet-0.4.4 → evlet-0.4.6}/evlet/jobs.py +142 -99
- {evlet-0.4.4 → evlet-0.4.6}/evlet/journal.py +121 -161
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ledger.py +19 -67
- {evlet-0.4.4 → evlet-0.4.6}/evlet/mailboxes.py +71 -61
- {evlet-0.4.4 → evlet-0.4.6}/evlet/meaning.py +0 -2
- {evlet-0.4.4 → evlet-0.4.6}/evlet/measures.py +128 -128
- {evlet-0.4.4 → evlet-0.4.6}/evlet/mentions.py +38 -27
- {evlet-0.4.4 → evlet-0.4.6}/evlet/migrations.py +198 -294
- {evlet-0.4.4 → evlet-0.4.6}/evlet/models.py +33 -68
- {evlet-0.4.4 → evlet-0.4.6}/evlet/naming.py +11 -20
- {evlet-0.4.4 → evlet-0.4.6}/evlet/object_storage.py +18 -6
- {evlet-0.4.4 → evlet-0.4.6}/evlet/packages.py +1 -1
- {evlet-0.4.4 → evlet-0.4.6}/evlet/periods.py +11 -12
- {evlet-0.4.4 → evlet-0.4.6}/evlet/permissions.py +31 -55
- {evlet-0.4.4 → evlet-0.4.6}/evlet/printing.py +23 -11
- evlet-0.4.6/evlet/qb.py +643 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/query.py +48 -52
- {evlet-0.4.4 → evlet-0.4.6}/evlet/routing.py +2 -2
- {evlet-0.4.4 → evlet-0.4.6}/evlet/secrets.py +27 -26
- {evlet-0.4.4 → evlet-0.4.6}/evlet/sections.py +16 -18
- {evlet-0.4.4 → evlet-0.4.6}/evlet/sequences.py +43 -61
- {evlet-0.4.4 → evlet-0.4.6}/evlet/services.py +5 -4
- {evlet-0.4.4 → evlet-0.4.6}/evlet/settings.py +137 -97
- {evlet-0.4.4 → evlet-0.4.6}/evlet/slips.py +5 -5
- evlet-0.4.6/evlet/sqlite.py +538 -0
- evlet-0.4.6/evlet/statemanager.py +1449 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/storage.py +31 -13
- {evlet-0.4.4 → evlet-0.4.6}/evlet/tenancy.py +42 -30
- {evlet-0.4.4 → evlet-0.4.6}/evlet/tools.py +91 -94
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/metadata.py +4 -4
- evlet-0.4.4/evlet/ui/static/assets/ai-Dxes-Y5x.js → evlet-0.4.6/evlet/ui/static/assets/ai-D6v6uzJl.js +1 -1
- evlet-0.4.4/evlet/ui/static/assets/app-DV2K7-Sc.js → evlet-0.4.6/evlet/ui/static/assets/app-C37OLm9O.js +1 -1
- evlet-0.4.4/evlet/ui/static/assets/consent-CQhXzR61.js → evlet-0.4.6/evlet/ui/static/assets/consent-CodBrk72.js +1 -1
- evlet-0.4.4/evlet/ui/static/assets/email-BQhe29I0.js → evlet-0.4.6/evlet/ui/static/assets/email-DxkXuU5k.js +1 -1
- evlet-0.4.4/evlet/ui/static/assets/index-UqEST1u4.css → evlet-0.4.6/evlet/ui/static/assets/index-BUi88rTP.css +1 -1
- evlet-0.4.6/evlet/ui/static/assets/index-Cnv8Z1nq.js +948 -0
- evlet-0.4.4/evlet/ui/static/assets/keys-Czr55W8K.js → evlet-0.4.6/evlet/ui/static/assets/keys-BjRw2MrO.js +1 -1
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/index.html +2 -2
- {evlet-0.4.4 → evlet-0.4.6}/evlet/unsaved.py +46 -37
- {evlet-0.4.4 → evlet-0.4.6}/evlet/writes.py +127 -13
- {evlet-0.4.4 → evlet-0.4.6/evlet.egg-info}/PKG-INFO +7 -9
- {evlet-0.4.4 → evlet-0.4.6}/evlet.egg-info/SOURCES.txt +13 -15
- {evlet-0.4.4 → evlet-0.4.6}/evlet.egg-info/requires.txt +0 -4
- {evlet-0.4.4 → evlet-0.4.6}/examples/playground/app.py +1 -18
- {evlet-0.4.4 → evlet-0.4.6}/examples/playground/migrate.py +8 -10
- {evlet-0.4.4 → evlet-0.4.6}/examples/playground/models.py +20 -13
- {evlet-0.4.4 → evlet-0.4.6}/examples/playground/slips.py +3 -1
- {evlet-0.4.4 → evlet-0.4.6}/examples/playground/team.py +1 -1
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/api.ts +5 -5
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/client.ts +3 -44
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/list-page.ts +27 -20
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/meta.ts +24 -48
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/record-page.ts +50 -144
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/screens.css +0 -5
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/model/record.ts +3 -3
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/model/schema.ts +4 -5
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/doc.ts +11 -14
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/library.ts +1 -1
- {evlet-0.4.4 → evlet-0.4.6}/pyproject.toml +1 -2
- evlet-0.4.4/docs/document-lifecycle.md +0 -216
- evlet-0.4.4/docs/lifecycle-specification.md +0 -549
- evlet-0.4.4/docs/postgresql.md +0 -166
- evlet-0.4.4/docs/states-actions.md +0 -772
- evlet-0.4.4/evlet/cli/journal.py +0 -42
- evlet-0.4.4/evlet/corrections.py +0 -690
- evlet-0.4.4/evlet/framework.py +0 -178
- evlet-0.4.4/evlet/lifecycle.py +0 -460
- evlet-0.4.4/evlet/postgres.py +0 -283
- evlet-0.4.4/evlet/postgres_schema.py +0 -343
- evlet-0.4.4/evlet/ui/static/assets/index-BZFjJUtE.js +0 -960
- evlet-0.4.4/frontend/src/evlet/app/revisions.ts +0 -77
- {evlet-0.4.4 → evlet-0.4.6}/LICENSE +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/MANIFEST.in +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/build_support.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/docs/application-generation.md +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/docs/customizing.md +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/docs/eva.md +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/docs/getting-started.md +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/docs/printing.md +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/docs/reports.md +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/docs/tenancy-deployment.md +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/__main__.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/builds.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/calc.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/__init__.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/app.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/connector.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/devlink.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/docs.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/effects.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/hosts.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/instance.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/jobs.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/ledger.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/playground.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/project.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/proxy.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/setup.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/upgrade.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/connector.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/controls_export.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/deployment.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/discovery.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/expressions.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/mcp.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/py.typed +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/reactivity.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/__init__.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/print/fonts/NotoSans-Bold.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/print/fonts/NotoSans-OFL.txt +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/print/fonts/NotoSans-Regular.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/print/fonts/NotoSansArabic-Bold.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/print/fonts/NotoSansArabic-OFL.txt +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/print/fonts/NotoSansArabic-Regular.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app/.gitignore.tpl +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app/README.md.tpl +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app/__app__/__init__.py.tpl +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app/__app__/actions/__init__.py.tpl +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app/__app__/hooks.py.tpl +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app/__app__/migrations/__init__.py.tpl +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app/__app__/models/__init__.py.tpl +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app/__app__/permissions.py.tpl +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app/pyproject.toml.tpl +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app/tests/test_models.py.tpl +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app_flat/.gitignore.tpl +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app_flat/README.md.tpl +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app_flat/__init__.py.tpl +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app_flat/models/__init__.py.tpl +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app_flat/models/item.py.tpl +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app_flat/pyproject.toml.tpl +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app_flat/setup.py.tpl +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/richtext.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/serverless.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/__init__.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/application.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/routes.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/serving.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/IBMPlexSans-OFL.txt +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/JetBrainsMono-Medium-3S3k2nMz.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/JetBrainsMono-OFL.txt +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/JetBrainsMono-Regular-BQaDgvhP.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/app-0SduO6OB.css +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/evlet-icon-blue.svg +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/evlet-logo-primary.svg +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/evlet-logo-white.svg +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/ibm-plex-sans-latin-400-italic-CZTNEAuW.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/ibm-plex-sans-latin-400-normal-CDDApCn2.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/ibm-plex-sans-latin-500-normal-6ng42L7E.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/ibm-plex-sans-latin-600-normal-CuJfVYMP.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/ibm-plex-sans-latin-700-normal-Bxkt5Cjx.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-400-italic-Du9zzoL2.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-400-normal-C5H60-Va.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-500-normal-DakdToA3.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-600-normal-DOrvGEcy.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-700-normal-aMgXseD4.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet/workspaces.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet.egg-info/dependency_links.txt +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet.egg-info/entry_points.txt +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/evlet.egg-info/top_level.txt +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/examples/playground/items.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/examples/playground/manage.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/examples/playground/portal/index.html +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/examples/playground/portal/portal.css +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/examples/playground/portal/portal.js +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/examples/playground/prints.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/examples/playground/reports.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/examples/playground/settings.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/examples/playground/site/404.html +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/examples/playground/site/about/index.html +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/examples/playground/site/index.html +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/examples/playground/site/robots.txt +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/examples/playground/site/site.css +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/examples/playground/site/sitemap.xml +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/examples/playground/tenants.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/examples/playground/worker.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/examples/playground/workspaces.py +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/.node-version +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/.npmrc +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/IBMPlexSans-OFL.txt +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/JetBrainsMono-Medium.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/JetBrainsMono-OFL.txt +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/JetBrainsMono-Regular.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/ibm-plex-sans-latin-400-italic.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/ibm-plex-sans-latin-400-normal.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/ibm-plex-sans-latin-500-normal.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/ibm-plex-sans-latin-600-normal.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/ibm-plex-sans-latin-700-normal.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/ibm-plex-sans-latin-ext-400-italic.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/ibm-plex-sans-latin-ext-400-normal.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/ibm-plex-sans-latin-ext-500-normal.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/ibm-plex-sans-latin-ext-600-normal.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/ibm-plex-sans-latin-ext-700-normal.woff2 +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/index.html +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/package-lock.json +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/package.json +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/public/assets/evlet-icon-blue.svg +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/public/assets/evlet-logo-primary.svg +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/public/assets/evlet-logo-white.svg +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/scripts/bench-ui.mjs +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/scripts/dev-proxy.mjs +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/scripts/dev-proxy.test.mjs +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/scripts/install-ui.mjs +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/app.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/composer.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/config.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/context.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/docs.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/duplicate.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/explorer.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/filters.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/inbox.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/last-page.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/login.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/main.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/nav-icons.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/palette.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/prefs.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/recents.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/record-blocks.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/record-compact.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/related-data.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/report-page.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/settings.css +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/settings.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/shell.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/shortcuts.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/slips.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/unsaved-bar.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/unsaved.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/workspace-editor.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/workspaces.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/access.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/ai.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/app.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/client.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/connections.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/controls.css +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/currencies.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/drafts.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/eva.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/keys.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/log.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/models.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/naming.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/people.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/periods.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/prints.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/system.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/unsaved.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/dev.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/dom.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/eva/chat.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/eva/client.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/eva/eva.css +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/eva/tasks.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ids.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/model/changes.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/model/finite.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/model/format.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/model/links.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/model/session.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/model/unsaved.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/reactive.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/richtext/editor.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/richtext/history.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/richtext/html.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/richtext/images.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/richtext/model.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/richtext/ops.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/richtext/render.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/richtext/richtext.css +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/router.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/settings/ai.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/settings/consent.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/settings/email.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/settings/keys.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/autofocus.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/base.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/catalog.json +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/chart.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/childtable.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/core.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/dateparse.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/draglist.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/explain.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/fields.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/fold.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/icon-data.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/index.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/inline.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/kinds.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/layers.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/list.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/money.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/pickers.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/shortcuts.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/split.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/styles.css +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/table.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/theme.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/time.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/tooltip.ts +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/tsconfig.json +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/frontend/vite.config.js +0 -0
- {evlet-0.4.4 → evlet-0.4.6}/setup.cfg +0 -0
|
@@ -4,6 +4,171 @@ Evlet is pre-1.0 and not production ready. From 0.3, a public name or argument t
|
|
|
4
4
|
removed or changed keeps working with a `DeprecationWarning` for at least one minor release
|
|
5
5
|
first ([docs/api-stability.md](docs/api-stability.md)). The notes below say what to change.
|
|
6
6
|
|
|
7
|
+
## 0.4.6 (13-11-2026)
|
|
8
|
+
|
|
9
|
+
### Upgrading to 0.4.6
|
|
10
|
+
|
|
11
|
+
- **One state manager replaces the old lifecycle.** `evlet/statemanager.py` holds a document's
|
|
12
|
+
State: its steps, the rules between them and its hooks. The old forms are removed outright, with
|
|
13
|
+
no aliases and no deprecation release, by owner decision. A model that still declares
|
|
14
|
+
`before_close`, `changed`, `check_lifecycle` or an undecorated `validate()`, or sets
|
|
15
|
+
`confirmable` or `track_changes`, fails when the class is created with a message naming the
|
|
16
|
+
replacement. See [docs/states-actions.md](docs/states-actions.md) and
|
|
17
|
+
[docs/document-lifecycle.md](docs/document-lifecycle.md).
|
|
18
|
+
- **Apps that use `confirmable` must move to a State.** Declare draft, a locked release step and a
|
|
19
|
+
final cancelled step with rules, as the Lifecycle Playground does. Framework step
|
|
20
|
+
`0011_state_manager` then converts the rows of `evlet_document_lifecycle` and
|
|
21
|
+
`evlet_document_revisions` and backfills v0 for records already in a release step.
|
|
22
|
+
- **Rewriting a State.** `State(("draft", "issued"), moves=(Move("draft", "issued", "Issue"),),
|
|
23
|
+
locked=("issued",), final=(...), voidable=(...))` becomes `State(State.Step("draft"),
|
|
24
|
+
State.Step("issued", lock=True), rules=(State.Rule("draft", "issued", "Issue"),))`. Routes,
|
|
25
|
+
`context.move()` and `_moves` now name a rule by its key, which defaults to `<from>_to_<to>`;
|
|
26
|
+
give each rule `key=` to keep the old move URLs (`key="issued"`). `roles=` becomes `by=`;
|
|
27
|
+
`system=True` becomes `by=()`. A `colors=` map moves onto each step's `color=`.
|
|
28
|
+
- **Hooks.** `Move(..., run="m")` becomes `@state("to")` on `m`; `before_close` becomes
|
|
29
|
+
`@state.exit(...)` or `@validate`; `changed()` becomes `@state(...)` or a job queued from a hook;
|
|
30
|
+
`Model.validate()` (also on Dialogs, Slips and Reports) and `@validate.confirm/.cancel` become
|
|
31
|
+
`@validate`; `@action.confirm/.cancel` become `@state(...)` and `@state.exit(...)`.
|
|
32
|
+
- **Corrections.** Void is a final step reached by a rule, usually with `remark="required"`.
|
|
33
|
+
Revise and unpost become a rule back (Reopen); repost becomes moving into the posting state
|
|
34
|
+
again. `Rule` operations `void`, `revise`, `unpost`, `repost`, `confirm`, `cancel` and `reopen`
|
|
35
|
+
are gone: a rule's `by` and update permission decide a move. Remove them from `permissions`,
|
|
36
|
+
Controls overrides and `ApiScope.actions`.
|
|
37
|
+
- **Renamed.** `editable_when_locked=True` is now `versioned=False`.
|
|
38
|
+
- **Database.** A Select may become a State, and step colours may change, with `AlterField`
|
|
39
|
+
alone; no data moves. The Playground's `0020_project_state` does this for Project.
|
|
40
|
+
|
|
41
|
+
### Removed
|
|
42
|
+
|
|
43
|
+
- `Move`, and `State(choices, moves=, locked=, final=, voidable=, cancelled=)`.
|
|
44
|
+
- `confirmable`, `track_changes`, `lifecycle_labels`, `Meta.revisable` with `revises` and
|
|
45
|
+
`revised_by`, `Naming(assign_on="confirm")` (use the state's name).
|
|
46
|
+
- The routes `/confirm`, `/cancel`, `/reopen`, `/void`, `/revise`, `/unpost`, `/repost`,
|
|
47
|
+
`/revisions`, `/snapshot` and the lifecycle `/diff`, with their `Context` methods, detail keys
|
|
48
|
+
(`_lifecycle`, `_lifecycle_actions`, `_void`, `_revise`, `_unpost`, `_repost`) and schema keys
|
|
49
|
+
(`lifecycle`, `voidable`, `revisable`, `unpostable`, `state.states`, `state.moves`,
|
|
50
|
+
`state.locked`, `state.final`, `state.voidable`, `state.cancelled`).
|
|
51
|
+
- `context.document()` and `BoundDocument`, `context.record_approval()`,
|
|
52
|
+
`context.lifecycle_execution`, `context.reference_effect()`, `check_lifecycle`, `before_close`,
|
|
53
|
+
`changed()` and `Change`, `@validate.confirm/.cancel`, `@action.confirm/.cancel`,
|
|
54
|
+
`Model.validate()`, and the record page's Revisions part (`revisions` in `Meta.panel`).
|
|
55
|
+
- `evlet/lifecycle.py` and `evlet/corrections.py`. `evlet/states.py` is now `evlet/guards.py`
|
|
56
|
+
(internal). `docs/lifecycle-specification.md`.
|
|
57
|
+
- Unpost and repost audit rows, and the unpost dependents check (it returns with restore).
|
|
58
|
+
|
|
59
|
+
### Added
|
|
60
|
+
|
|
61
|
+
- `State(*steps, rules=(), default=, show=)` with `State.Step(key, label, color=, lock=,
|
|
62
|
+
release=, final=)` and `State.Rule(from_, to, label, key=, by=, when=, remark=, ask=, primary=,
|
|
63
|
+
reject=)`. `by` takes role names and `F("field")` user fields. `State.Remark(mode, label=,
|
|
64
|
+
required_when=)` asks for a remark.
|
|
65
|
+
- Releases: entering a `release=True` step, or `POST /api/{model}/{id}/release` (`release`
|
|
66
|
+
permission), makes a numbered version when the content changed; `@release` runs then. Snapshots
|
|
67
|
+
are lazy and drift is detected. `_version` in details; `GET .../versions`, `.../versions/{n}`
|
|
68
|
+
and `.../versions/{a}/diff/{b|current}`. Framework step `0011_state_manager` converts
|
|
69
|
+
confirmable lifecycle and revision rows and backfills v0 for records already in a release step.
|
|
70
|
+
- Restore: `POST /api/{model}/{id}/restore` with `{version, remark}` (`restore` permission, unlocked
|
|
71
|
+
steps only) writes a release's content back as a new change, re-creating deleted rows under their
|
|
72
|
+
ids; it is refused while other records link to the document.
|
|
73
|
+
- Rules on an instance: Controls overrides of kind `state` (a step's label and colour) and `rule`
|
|
74
|
+
(change or turn off a code rule by key, or add one, with conditions as expression text), checked
|
|
75
|
+
on save as a whole rule set, compiled once per config version; orphans are ignored and reported.
|
|
76
|
+
- Approval levels: `State.Rule(..., levels=(State.Level(by=, when=, pending=), ...),
|
|
77
|
+
self_approve=)` moves once the last level that applies is approved; each approval is an
|
|
78
|
+
`approved` journal entry. `reject=True` rules are for the waiting level's approvers.
|
|
79
|
+
`_moves` carries `level`, `pending` and `can_approve`; `GET /api/{model}?awaiting=me` lists what
|
|
80
|
+
the user may approve now.
|
|
81
|
+
- The hooks `@validate`, `@state(...)`, `@state.exit(...)` and `@release`, with `self.is_new` and `self.before` inside them.
|
|
82
|
+
- `POST /api/{model}/{id}/moves/{key}` with `{"remark": ..., ...values}`, and
|
|
83
|
+
`context.move(model, id, key, *, remark=None, **values)`. A missing required remark is 422
|
|
84
|
+
`{"remark": "<Label> needs a remark"}`; an unknown key is 404 `Move not found`.
|
|
85
|
+
- `_moves` items carry `key`, `primary` and `remark`; the schema's `state` entry has `steps` and
|
|
86
|
+
`rules`.
|
|
87
|
+
- `evlet_journal` gains nullable `rule`, `remark`, `level`, `base` and `rules_version` columns. A
|
|
88
|
+
`moved` entry records the rule key and the remark, shown to readers of the State. The hash covers
|
|
89
|
+
these only when set, so existing chains verify unchanged.
|
|
90
|
+
- The Playground's Project has Start and Complete rules; Complete checks in `@state("done")` that
|
|
91
|
+
every task is done.
|
|
92
|
+
|
|
93
|
+
### Changed
|
|
94
|
+
|
|
95
|
+
- `Effect(on=...)` must name a `lock=True, release=True` step that is not the default. Rows post
|
|
96
|
+
when the record enters `on` and are reversed when any rule leaves it, before `@state.exit`
|
|
97
|
+
hooks; `reverse` is required whenever a rule leaves `on`. `Recompute` keeps the saved results of
|
|
98
|
+
records with live postings and of records that posted and are in a final state.
|
|
99
|
+
- The `change_state` tool takes `{model, id, rule, remark, values}`. A move into a final step is in
|
|
100
|
+
the destructive confirmation group for MCP clients and Eva write confirmations.
|
|
101
|
+
- The record page asks for a rule's remark in the move dialog and reads a cancelled look from a
|
|
102
|
+
final step coloured `rose`, never from state names.
|
|
103
|
+
|
|
104
|
+
## 0.4.5 (13-11-2026)
|
|
105
|
+
|
|
106
|
+
### Upgrading to 0.4.5
|
|
107
|
+
|
|
108
|
+
- **Sites on PostgreSQL: stay on 0.4.4.** 0.4.5 runs on SQLite only, and `evlet upgrade` and app
|
|
109
|
+
pins such as `evlet>=0.4.3,<0.5` pick it up on their own. Before upgrading a site whose app builds
|
|
110
|
+
a `PostgreSQLDatabase`, pin `evlet==0.4.4` in that app (or in the environment that runs it) and
|
|
111
|
+
keep it there until its data has moved to SQLite. On 0.4.5, `from evlet import PostgreSQLDatabase`,
|
|
112
|
+
a PostgreSQL DSN given to `Database(...)` and `Instance(database="postgresql")` each stop at
|
|
113
|
+
startup with a message that names 0.4.4 as the last version supporting PostgreSQL. SQLite sites
|
|
114
|
+
upgrade as usual.
|
|
115
|
+
- **PostgreSQL is removed.** SQLite, with the four-file layout and fair write line-up from 0.4.3,
|
|
116
|
+
is the only built-in database. `evlet.PostgreSQLDatabase`, the `evlet.postgres` and
|
|
117
|
+
`evlet.postgres_schema` modules, the `evlet[postgres]` extra, `requirements-postgres.lock`,
|
|
118
|
+
`docs/postgresql.md`, and the `--postgres` option of `scripts/benchmark.py` and
|
|
119
|
+
`scripts/benchmark_hierarchy.py` are gone. This removal skips the usual deprecation release:
|
|
120
|
+
it is an owner decision for 0.4.5.
|
|
121
|
+
- **Apps and tools that import `evlet.postgres` or `PostgreSQLDatabase` must stop.** Remove the
|
|
122
|
+
import and the code path that builds a PostgreSQL database. For example, an app CLI option such
|
|
123
|
+
as Finance's `EVLET_FINANCE_POSTGRES_DSN` must be dropped, along with any `psycopg` dependency
|
|
124
|
+
the app added for it. The Playground no longer reads `EVLET_POSTGRES_DSN`.
|
|
125
|
+
- **SQLite instances need no migration.** Stored data, schema and migration checksums are
|
|
126
|
+
unchanged. A test opens a database written by 0.4.3 and checks that nothing in it changes.
|
|
127
|
+
- **Moving data off PostgreSQL.** An app that ran on PostgreSQL in 0.4 should export its records
|
|
128
|
+
(for example through the HTTP API) into a new SQLite instance before
|
|
129
|
+
upgrading, or stay on 0.4.4 until a PostgreSQL adapter exists again.
|
|
130
|
+
|
|
131
|
+
### Changed
|
|
132
|
+
|
|
133
|
+
- **A query builder in front of the database.** Framework code describes what it reads and writes
|
|
134
|
+
with `evlet/qb.py` (select, insert, update, delete, upserts, conditions, joins, aggregates,
|
|
135
|
+
windows) and runs it with `connection.run(statement)`. A dialect compiles the statements to SQL;
|
|
136
|
+
SQLite (`evlet/sqlite.py`) is the one dialect. Schema changes go through named connection methods
|
|
137
|
+
(`inspect`, `create_table`, `set_required`, `ensure_table`, `make_append_only`, `guard_id` and a
|
|
138
|
+
few more), and migrations compare models against one neutral table shape. PostgreSQL, MariaDB or
|
|
139
|
+
another database can be added later as a dialect: a compiler, a connection class and a `Database`
|
|
140
|
+
subclass, passed explicitly where the app builds its database. See
|
|
141
|
+
[docs/database-adapters.md](docs/database-adapters.md). The query builder and the adapter
|
|
142
|
+
interface are provisional.
|
|
143
|
+
- **Every framework module is on the query builder:** the record API, queries, migrations, row
|
|
144
|
+
scopes and record helpers, accounts and sign-in, Controls and customization, jobs, events, mail,
|
|
145
|
+
connectors and tools, Eva and assistants, reports (measures), printing, storage and the rest.
|
|
146
|
+
Framework tables are `TableDefinition`s created with `connection.ensure_table`. The instance
|
|
147
|
+
tools (backup, restore, install, `evlet journal verify`, the tenant catalog, the Administrator
|
|
148
|
+
checks of `evlet serve` and `evlet site`) open SQLite files with small file tools in
|
|
149
|
+
`evlet/writes.py` and run query builder statements on the connection they get.
|
|
150
|
+
`tests/test_query_builder_boundary.py` fails on SQL text anywhere outside the dialect.
|
|
151
|
+
Query plans and the number of statements per operation are unchanged.
|
|
152
|
+
- `Column(referenced_column=...)`: a framework table's reference may point at a key other than
|
|
153
|
+
`id` (the tenant catalog's domains point at tenants by slug).
|
|
154
|
+
- `database.logs.add(store, statement)` (the batched log writes) takes a query builder statement
|
|
155
|
+
instead of SQL text and values.
|
|
156
|
+
- **Conformance tests.** `tests/test_database_adapter.py` is the checklist a new dialect must pass:
|
|
157
|
+
every query builder statement and condition, value round trips, exact amounts, foreign keys, ids,
|
|
158
|
+
the table shape, every schema change, framework table rules, append-only tables, the id guard,
|
|
159
|
+
error mapping, busy writers, savepoints and rollback, and a database written by 0.4.3.
|
|
160
|
+
- Internal helpers changed shape. They lost their `postgres` argument (for example
|
|
161
|
+
`ledger.add_triggers`, `identity.add_id_guard`, `identity.check_ids`, `naming.add_columns`,
|
|
162
|
+
`audit.add_columns`, `journal.ensure_table`, framework step functions).
|
|
163
|
+
`Database.columns(connection, table)` is now `connection.columns(table)`.
|
|
164
|
+
`SqlQuery.where()` and `ordering()` return query builder objects, and `Policy.scope()` returns a row
|
|
165
|
+
scope as a condition. The text forms (`SqlQuery.where_sql`, `ordering_sql`, `reference_sql`,
|
|
166
|
+
`Policy.scope_sql`) and `evlet.sqlite.compile_condition` are removed. These are internal names; apps
|
|
167
|
+
that used them build a statement with `evlet.qb` and pass the condition to `.where(...)`.
|
|
168
|
+
- New SQLite databases write the CREATE statements of framework tables and the append-only guards
|
|
169
|
+
of `evlet_journal`, `evlet_audit` and `evlet_document_revisions` in a slightly different text with
|
|
170
|
+
the same rules. Existing databases keep theirs.
|
|
171
|
+
|
|
7
172
|
## 0.4.4 (13-11-2026)
|
|
8
173
|
|
|
9
174
|
### Added
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: evlet
|
|
3
|
-
Version: 0.4.
|
|
3
|
+
Version: 0.4.6
|
|
4
4
|
Summary: A small Python application framework with SQLite and a neutral UI schema
|
|
5
5
|
License-Expression: MIT
|
|
6
6
|
Project-URL: Homepage, https://github.com/evlet-io/evlet
|
|
@@ -12,9 +12,6 @@ License-File: LICENSE
|
|
|
12
12
|
Requires-Dist: cryptography<52,>=44.0.1
|
|
13
13
|
Requires-Dist: packaging<27,>=24
|
|
14
14
|
Requires-Dist: uvicorn<1,>=0.34
|
|
15
|
-
Provides-Extra: postgres
|
|
16
|
-
Requires-Dist: psycopg[binary]<4,>=3.3.6; extra == "postgres"
|
|
17
|
-
Requires-Dist: psycopg-pool<4,>=3.3.3; extra == "postgres"
|
|
18
15
|
Provides-Extra: s3
|
|
19
16
|
Requires-Dist: boto3<2,>=1.43.119; extra == "s3"
|
|
20
17
|
Provides-Extra: print
|
|
@@ -30,8 +27,9 @@ Dynamic: license-file
|
|
|
30
27
|
# Evlet
|
|
31
28
|
|
|
32
29
|
Evlet is a Python application framework. Define your models in Python and get
|
|
33
|
-
forms, lists, permissions and APIs in the browser. SQLite
|
|
34
|
-
|
|
30
|
+
forms, lists, permissions and APIs in the browser. It runs on SQLite, with no
|
|
31
|
+
database server to set up. Another database can be added later through one adapter
|
|
32
|
+
boundary ([database adapters](docs/database-adapters.md)).
|
|
35
33
|
|
|
36
34
|
## Install, create a site, open it
|
|
37
35
|
|
|
@@ -140,10 +138,10 @@ else ([controls.md](docs/controls.md#security-rules)).
|
|
|
140
138
|
|
|
141
139
|
## Optional capabilities
|
|
142
140
|
|
|
143
|
-
|
|
144
|
-
|
|
141
|
+
S3 and PDF printing are available as `evlet[s3]` and `evlet[print]`
|
|
142
|
+
([print designs](docs/printing.md)). The existing
|
|
145
143
|
[tenant deployment](docs/tenancy-deployment.md), [jobs and live updates](docs/jobs-realtime.md),
|
|
146
|
-
[connector](docs/connector.md), [Tool Engine](docs/tools.md), [Eva](docs/eva.md), [
|
|
144
|
+
[connector](docs/connector.md), [Tool Engine](docs/tools.md), [Eva](docs/eva.md), [database adapters](docs/database-adapters.md) and
|
|
147
145
|
[operations](docs/production-operations.md) guides describe their limits.
|
|
148
146
|
No database server, Redis, Docker or worker is required for a local SQLite app.
|
|
149
147
|
|
|
@@ -1,8 +1,9 @@
|
|
|
1
1
|
# Evlet
|
|
2
2
|
|
|
3
3
|
Evlet is a Python application framework. Define your models in Python and get
|
|
4
|
-
forms, lists, permissions and APIs in the browser. SQLite
|
|
5
|
-
|
|
4
|
+
forms, lists, permissions and APIs in the browser. It runs on SQLite, with no
|
|
5
|
+
database server to set up. Another database can be added later through one adapter
|
|
6
|
+
boundary ([database adapters](docs/database-adapters.md)).
|
|
6
7
|
|
|
7
8
|
## Install, create a site, open it
|
|
8
9
|
|
|
@@ -111,10 +112,10 @@ else ([controls.md](docs/controls.md#security-rules)).
|
|
|
111
112
|
|
|
112
113
|
## Optional capabilities
|
|
113
114
|
|
|
114
|
-
|
|
115
|
-
|
|
115
|
+
S3 and PDF printing are available as `evlet[s3]` and `evlet[print]`
|
|
116
|
+
([print designs](docs/printing.md)). The existing
|
|
116
117
|
[tenant deployment](docs/tenancy-deployment.md), [jobs and live updates](docs/jobs-realtime.md),
|
|
117
|
-
[connector](docs/connector.md), [Tool Engine](docs/tools.md), [Eva](docs/eva.md), [
|
|
118
|
+
[connector](docs/connector.md), [Tool Engine](docs/tools.md), [Eva](docs/eva.md), [database adapters](docs/database-adapters.md) and
|
|
118
119
|
[operations](docs/production-operations.md) guides describe their limits.
|
|
119
120
|
No database server, Redis, Docker or worker is required for a local SQLite app.
|
|
120
121
|
|
|
@@ -211,37 +211,30 @@ from masquerading as authoritative totals. Legacy permissions remain unchanged.
|
|
|
211
211
|
|
|
212
212
|
After merging inputs, the operation runs an explicit action if requested,
|
|
213
213
|
settles authoritative values, validates children/parent, persists deltas and
|
|
214
|
-
|
|
215
|
-
|
|
214
|
+
commits. `@validate` methods are the model validation convention, and `@state`
|
|
215
|
+
hooks react to moves ([states-actions.md](states-actions.md#hooks)). Actions use `@action`, explicit allowed roles and typed
|
|
216
216
|
scalar arguments (`str/int/bool/float`); the native UI presents those inputs.
|
|
217
217
|
Protect status fields with `read_only=True` when an ordinary PATCH must not
|
|
218
218
|
bypass an action. Declaring `@action` makes a model a document: its PATCH,
|
|
219
219
|
actions and deletion then require `If-Match`, and it gains draft evaluation.
|
|
220
220
|
Legacy `Action` registrations on a document model keep their legacy route and
|
|
221
|
-
also require `If-Match`; their trusted handlers bypass document settlement
|
|
222
|
-
`validate()`.
|
|
221
|
+
also require `If-Match`; their trusted handlers bypass document settlement.
|
|
223
222
|
A legacy `ChildTable` under a document parent is saved through the document
|
|
224
223
|
route, which sets the parent link itself and ignores a client-supplied one.
|
|
225
224
|
|
|
226
|
-
`
|
|
227
|
-
|
|
228
|
-
uses `operation="delete"`, a before snapshot and `after=None`. A true no-op,
|
|
229
|
-
virtual query refresh or related-only action does not fire a source reaction.
|
|
230
|
-
The source draft is frozen during its reaction; resaving it and cascades deeper
|
|
231
|
-
than 16 operations fail. A reaction error rolls back the source, related writes
|
|
232
|
-
and queued intents. External I/O does not belong inside a reaction.
|
|
225
|
+
0.4.6 removed `changed(change)` and the `Change` object; a model that declares
|
|
226
|
+
`changed` fails when the class is created.
|
|
233
227
|
|
|
234
228
|
## Dialogs and reports
|
|
235
229
|
|
|
236
230
|
A nested `Dialog` exposes one source action without a second empty method.
|
|
237
|
-
Implement `load(source)`, optional
|
|
231
|
+
Implement `load(source)`, optional `@validate` checks and `submit(source)`. Fields and
|
|
238
232
|
tables are transient, with no business SQL tables. `parent` in a dialog row is
|
|
239
233
|
the dialog; `source` is the authorized persisted source snapshot. Load/evaluate
|
|
240
234
|
never save it. Submit requires its current revision and a scoped idempotency
|
|
241
235
|
key. A retry returns the stored outcome only for identical input and an actor
|
|
242
236
|
who still has source access. Conflicting input under the same key fails.
|
|
243
|
-
The operation uses the existing serialized write transaction
|
|
244
|
-
PostgreSQL advisory transaction lock.
|
|
237
|
+
The operation uses the existing serialized write transaction.
|
|
245
238
|
|
|
246
239
|
A `Report` defines title, roles, fields, typed `Column`s, `autorun` and `run()`.
|
|
247
240
|
Set `roles = ('admin', 'editor')` to name the roles that may see and run it.
|
|
@@ -324,7 +317,7 @@ existing regressions:
|
|
|
324
317
|
| Definitions, expressions, children, permissions | `test_documents.py`, `test_document_boundaries.py`, shared document fixtures/vectors, existing business/security suites |
|
|
325
318
|
| Dialogs, reports, APIs, cron | `test_forms_services.py`, reference app end-to-end test, native document/report tests, existing queue tests |
|
|
326
319
|
| Build failure, generation pinning, recovery | `test_builds.py`, existing install/backup/recovery and reload tests |
|
|
327
|
-
| Adapter compatibility | Full Python suite,
|
|
320
|
+
| Adapter compatibility | Full Python suite, adapter conformance tests plus declarative document rollback/revision test |
|
|
328
321
|
| UI and distribution | Native frontend suite/typecheck/build, installed-wheel HTTP smoke, clean flat-app wheel/sdist/editable imports |
|
|
329
322
|
|
|
330
323
|
Run `python -m scripts.generate_document_fixtures` only after an intentional
|
|
@@ -7,16 +7,27 @@ production ready, but the rules below hold from 0.3 on.
|
|
|
7
7
|
## The app-facing surface
|
|
8
8
|
|
|
9
9
|
- **Root exports.** Every name in `evlet.__all__`: fields, `Model`, `Child`, `Registry`,
|
|
10
|
-
migrations, permissions (`Policy`, `Rule`, `own_customer`, `SCOPES`),
|
|
11
|
-
(`State
|
|
10
|
+
migrations, permissions (`Policy`, `Rule`, `own_customer`, `SCOPES`), the state manager
|
|
11
|
+
(`State` with `State.Step`, `State.Rule` and `State.Remark`, the hooks `validate`, `state`,
|
|
12
|
+
`state.exit` and `release`, and `action`), form sections and record layouts (`Section`,
|
|
12
13
|
`Main`, `Html`, and `Related` and `Chart` as layout blocks), slips, measures, settings, connectors,
|
|
13
14
|
storage, jobs, routing and the application classes. Import them from `evlet`, not from the
|
|
14
15
|
module that defines them. `AppDefinition(views=())` stays accepted for apps scaffolded
|
|
15
16
|
before 0.4; a non-empty `views` or a `ui` registry is refused.
|
|
16
17
|
- **Field keywords.** The keywords every field takes (`required`, `default`, `label`,
|
|
17
18
|
`help_text`, `visible_if` and the rest), which are defined once on the field base class.
|
|
18
|
-
- **
|
|
19
|
-
|
|
19
|
+
- **States and moves.** `State(*steps, rules=(), default=, show=)`, `State.Step(key, label,
|
|
20
|
+
color=, lock=, release=, final=)` and `State.Rule(from_, to, label, key=, by=, when=, remark=,
|
|
21
|
+
ask=, primary=, reject=)` with rule keys, `POST /api/{model}/{id}/moves/{key}` with its body,
|
|
22
|
+
checks and answers, `context.move(model, id, key, *, remark=None, **values)`, `_moves`,
|
|
23
|
+
`_locked`, the schema's `state` entry, the Journal's `rule` and `remark`, `versioned=False`,
|
|
24
|
+
and `by=()` for rules only the application makes, with its 403 `<label> is made by the
|
|
25
|
+
application only` ([states-actions.md](states-actions.md)). `State.Level` and `self_approve=`
|
|
26
|
+
are declared but not public until approval levels land (0.4.6, PR 2). 0.4.6 removed `Move`,
|
|
27
|
+
`confirmable`, `track_changes`, `Meta.revisable`, void, revise, unpost and repost,
|
|
28
|
+
`before_close`, `changed`, `Model.validate()` and the lifecycle decorators without a
|
|
29
|
+
deprecation release, by owner decision ([CHANGELOG.md](../CHANGELOG.md)).
|
|
30
|
+
- **Records.** `Model.to_dict`.
|
|
20
31
|
- **No `evlet.ui` page names.** The Python page API was removed in 0.4 without a
|
|
21
32
|
deprecation release, by owner decision, since the browser never rendered it
|
|
22
33
|
([CHANGELOG.md](../CHANGELOG.md)). `evlet.ui.metadata` stays internal.
|
|
@@ -64,7 +75,7 @@ production ready, but the rules below hold from 0.3 on.
|
|
|
64
75
|
entry (left out when there are none). A broken unique entry raises `ValidationError` with the
|
|
65
76
|
entry's fields as keys (HTTP 422). Ledger entries may name `id`. `Session.reserve_ids(model,
|
|
66
77
|
count)` and an `id` in `insert_many` rows for reserved ids. A raw update or delete that an
|
|
67
|
-
append-only table refuses raises `ConflictError`
|
|
78
|
+
append-only table refuses raises `ConflictError`
|
|
68
79
|
([model-engine.md](model-engine.md#composite-and-unique-indexes), [ledger.md](ledger.md)).
|
|
69
80
|
|
|
70
81
|
- **Aggregates in a transaction.** `Session.aggregate(model, *, measures, group_by=(), filters=None,
|
|
@@ -80,22 +91,20 @@ production ready, but the rules below hold from 0.3 on.
|
|
|
80
91
|
([model-engine.md](model-engine.md#long-in-lists-in-trusted-code)). HTTP, `Context`, Eva,
|
|
81
92
|
tools, MCP and Connector keep 100 values per `in` and 500 groups per aggregate.
|
|
82
93
|
|
|
83
|
-
- **The transaction session in handlers.** `self.context.session` in a
|
|
84
|
-
`@action` handler: the move or action's own `evlet.Session`, open only while the
|
|
85
|
-
refused (`AccessError`, 403) on every other context
|
|
86
|
-
([states-actions.md](states-actions.md#the-transaction-session-in-
|
|
94
|
+
- **The transaction session in handlers.** `self.context.session` in a `@state` or `@state.exit`
|
|
95
|
+
hook or an `@action` handler: the move or action's own `evlet.Session`, open only while the
|
|
96
|
+
method runs and refused (`AccessError`, 403) on every other context
|
|
97
|
+
([states-actions.md](states-actions.md#the-transaction-session-in-hooks-and-actions)).
|
|
87
98
|
|
|
88
|
-
- **Derived values
|
|
89
|
-
`"table.field"` row field names),
|
|
90
|
-
`
|
|
91
|
-
`self.context.session` they get (`get`, `list`, `count`, `related`, `aggregate`), the
|
|
99
|
+
- **Derived values.** `Meta.derives` with `derive(self)` (field, Table and
|
|
100
|
+
`"table.field"` row field names): when it runs, the read-only
|
|
101
|
+
`self.context.session` it gets (`get`, `list`, `count`, `related`, `aggregate`), the
|
|
92
102
|
`DERIVED_FIELD_WRITE` refusal (keyed `table.field` for a row field), the `read_only` flag on
|
|
93
103
|
a derived field, a derived row field and a derived `children` entry in `/api/schema`, `self.model`
|
|
94
|
-
(the model class) on the drafts
|
|
104
|
+
(the model class) on the drafts it gets, and trusted `session.create`, `update` and
|
|
95
105
|
`delete` of a model with `derive()` or of its rows settling the saved document, with
|
|
96
106
|
`children=` on its create and update (a bare
|
|
97
|
-
`Database` refuses them; `maintenance()` skips it) ([model-engine.md](model-engine.md#derived-values)
|
|
98
|
-
[states-actions.md](states-actions.md#before-a-record-closes)).
|
|
107
|
+
`Database` refuses them; `maintenance()` skips it) ([model-engine.md](model-engine.md#derived-values)).
|
|
99
108
|
|
|
100
109
|
- **Measure trends and colours.** `trend=` and `color=` on `Count`, `CountDistinct`, `Sum`, `Min` and
|
|
101
110
|
`Max` in `Meta.measures`: a trend is a Date field name or `(field, grain, points)` with grain `day`,
|
|
@@ -140,11 +149,7 @@ production ready, but the rules below hold from 0.3 on.
|
|
|
140
149
|
done), `progress` in `GET /api/_jobs/<id>`, and `evlet jobs list`
|
|
141
150
|
([jobs-realtime.md](jobs-realtime.md#progress-and-long-jobs)).
|
|
142
151
|
|
|
143
|
-
- **
|
|
144
|
-
`roles=`), its 403 `<label> is made by the application only` to every HTTP caller and its absence
|
|
145
|
-
from `_moves` and the schema's `state.moves`
|
|
146
|
-
([states-actions.md](states-actions.md#system-moves)).
|
|
147
|
-
`JobContext.business(tx, *, user=None, system=None, role=None)` with the identities and checks
|
|
152
|
+
- **Jobs that act.** `JobContext.business(tx, *, user=None, system=None, role=None)` with the identities and checks
|
|
148
153
|
in [jobs-realtime.md](jobs-realtime.md#a-jobs-business-context), `User.system`, the Journal's
|
|
149
154
|
`via` for a system name, `Context.enqueue(task, payload, *, key=None, target=None)` queuing after
|
|
150
155
|
commit, `_job` on an action's detail, and `JobQueue.wake()` and `JobQueue.wait(timeout)`
|
|
@@ -160,12 +165,9 @@ production ready, but the rules below hold from 0.3 on.
|
|
|
160
165
|
someone who opens Controls without the flag ([controls.md](controls.md#workspaces)).
|
|
161
166
|
|
|
162
167
|
- **How a state shows.** `State(..., show=...)` takes `"badge"` (the default), `"bar"` or `"none"`,
|
|
163
|
-
and `Select(..., colors=...)`
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
- **Cancelled states.** `State(..., cancelled=...)`, a list of final state names (empty by
|
|
167
|
-
default), the rule that `"void"` on a voidable State counts as cancelled, and `cancelled` in the
|
|
168
|
-
schema's `state` entry ([states-actions.md](states-actions.md#cancelled-states)).
|
|
168
|
+
and `State.Step(color=...)` and `Select(..., colors=...)` take the badge colours `blue`, `green`,
|
|
169
|
+
`amber`, `rose`, `violet`, `teal` and `slate`. The values and the default are public
|
|
170
|
+
([states-actions.md](states-actions.md#how-a-state-and-a-status-show)).
|
|
169
171
|
|
|
170
172
|
- **Currency display.** `set_currency_display(application, value, *, actor='cli')`, the setting
|
|
171
173
|
`display.currencies` with its entry form (`symbol`, `image`, `position`, `space`, `tint`,
|
|
@@ -216,10 +218,14 @@ with `-W error::DeprecationWarning` before they move to the next series.
|
|
|
216
218
|
Apps must not depend on these. They can change in any release without a deprecation:
|
|
217
219
|
|
|
218
220
|
- Modules and names that are not listed above, even when they can be imported, such as
|
|
219
|
-
`evlet.
|
|
220
|
-
|
|
221
|
+
`evlet.statemanager` and `evlet.guards` (import from `evlet`), `evlet.database` helpers, `evlet.cli`, `evlet.controls_*`, `evlet.sqlite`
|
|
222
|
+
and `evlet.ui.metadata`.
|
|
223
|
+
- The query builder (`evlet.qb`) and the database adapter interface (`evlet.adapter`, the
|
|
224
|
+
connection methods and the `Database` methods listed in [database-adapters.md](database-adapters.md)).
|
|
225
|
+
They are documented for framework work and for people who write a dialect, and are provisional:
|
|
226
|
+
they may change in a minor release, with a `CHANGELOG.md` note.
|
|
221
227
|
- Names that start with an underscore, and dunder attributes such as `__fields__`.
|
|
222
|
-
- Methods of exported classes that the app guides do not document, such as `Policy.
|
|
228
|
+
- Methods of exported classes that the app guides do not document, such as `Policy.scope`
|
|
223
229
|
or `Registry.plan_for`.
|
|
224
230
|
- The stored layout of tables Evlet manages (`evlet_*`), and the browser framework in
|
|
225
231
|
`frontend/`.
|
|
@@ -102,6 +102,12 @@ trigger that refuses an id change to every model table ([model-engine.md](model-
|
|
|
102
102
|
Currency amount is stored at 6 places; `evlet migrate` moves the amounts before any app migration runs
|
|
103
103
|
([model-engine.md](model-engine.md#decimal-places-per-currency)). `0010_split_files` moves sign-in sessions, the
|
|
104
104
|
tool-call log and Eva into their own SQLite files next to the database (see From 0.4.2 to 0.4.3 below).
|
|
105
|
+
`0011_state_manager` adds the journal's `rule`, `remark`, `level`, `base` and `rules_version` columns
|
|
106
|
+
(old entries keep their values and their hashes), creates `evlet_releases`, lets `evlet_overrides` take the
|
|
107
|
+
kinds `state` and `rule`, turns confirmable
|
|
108
|
+
revisions into releases and lifecycle states into State values (it refuses, naming the models, when
|
|
109
|
+
a model has no State with those steps), and gives every record already in a release step a v0
|
|
110
|
+
release ([states-actions.md](states-actions.md#releases-and-versions)).
|
|
105
111
|
Steps never run while an instance is served.
|
|
106
112
|
`evlet migrate acme --plan` lists the pending ones without writing anything. If a step fails, the staged copy is
|
|
107
113
|
discarded and the database and lock stay as they were; restore the earlier Evlet
|
|
@@ -173,7 +179,6 @@ The four SQLite files:
|
|
|
173
179
|
own next run with `context.follow_up(tx, payload, run_at=...)`, in the same transaction and
|
|
174
180
|
with the same identity ([jobs-realtime.md](jobs-realtime.md#follow-up-runs)). An app that
|
|
175
181
|
polls with an every-minute schedule can use a follow-up run instead.
|
|
176
|
-
- PostgreSQL instances keep one database; the step only records itself there.
|
|
177
182
|
|
|
178
183
|
### From 0.4.1 to 0.4.2
|
|
179
184
|
|
|
@@ -34,8 +34,9 @@ SolidJS by Evlet's own UI framework.
|
|
|
34
34
|
referenced record's 63-bit id and uses a real database foreign key; JSON and URLs
|
|
35
35
|
carry the 13-character text form of the id. Schema creation is
|
|
36
36
|
supported; migrations are not. Changing a model requires a new disposable
|
|
37
|
-
development database until migrations exist.
|
|
38
|
-
|
|
37
|
+
development database until migrations exist. Another database can implement
|
|
38
|
+
the same small operations without introducing a generic ORM
|
|
39
|
+
([database adapters](database-adapters.md)).
|
|
39
40
|
3. **Portable ASGI, with Uvicorn only as a development server.** The core
|
|
40
41
|
implements HTTP and lifespan directly. It exposes health, versioned metadata,
|
|
41
42
|
and explicitly registered models' create/list/detail operations. Database work
|
|
@@ -253,35 +254,32 @@ approval responsibilities, limits, and the application development workflow.
|
|
|
253
254
|
|
|
254
255
|
## Deferred work
|
|
255
256
|
|
|
256
|
-
WebSockets, arbitrary schema conversions,
|
|
257
|
-
|
|
257
|
+
WebSockets, arbitrary schema conversions, parallel write scheduling, and
|
|
258
|
+
production-target validation remain later work.
|
|
258
259
|
|
|
259
260
|
|
|
260
261
|
## Milestone 8 decisions
|
|
261
262
|
|
|
262
|
-
PostgreSQL is an optional driver-backed Database implementation. Models, validation,
|
|
263
|
-
query compilation, authentication, permissions, and business handlers stay shared.
|
|
264
|
-
A small private connection adapter binds parameters and adapts framework-generated
|
|
265
|
-
SQL; native schema introspection and migrations live separately. A bounded optional
|
|
266
|
-
Psycopg pool reuses connections and resets session state after each operation. It is not a general
|
|
267
|
-
SQL translation layer. The base wheel imports without Psycopg installed.
|
|
268
|
-
|
|
269
|
-
An explicit transaction advisory lock preserves the existing serialized-write
|
|
270
|
-
contract across PostgreSQL processes, including business actions and queue claims.
|
|
271
|
-
Read pages use repeatable-read snapshots. This initial adapter does not provide
|
|
272
|
-
parallel writes within one database, and the operator-managed SQLite tenant catalog
|
|
273
|
-
is not extended to remote credentials or PostgreSQL provisioning.
|
|
274
|
-
|
|
275
263
|
Private storage, events, and jobs check their owning database through a shared
|
|
276
264
|
boundary instead of assuming a SQLite file. Session revocation/expiry and login
|
|
277
265
|
counter cleanup now have explicit indexes. Repeated security headers are rejected
|
|
278
|
-
before authentication. Nullable ordering is explicit
|
|
266
|
+
before authentication. Nullable ordering is explicit.
|
|
279
267
|
|
|
280
268
|
Reproducible benchmarks use synthetic large ledgers and real databases, with
|
|
281
269
|
continuous authenticated ASGI readers, paced invoice transactions, SQL reports,
|
|
282
270
|
index comparisons, and measured resource/bundle sizes. They do not model a complete
|
|
283
|
-
accounting system or prove deployment capacity. See [performance](performance.md)
|
|
284
|
-
|
|
271
|
+
accounting system or prove deployment capacity. See [performance](performance.md)
|
|
272
|
+
and [operations](production-operations.md).
|
|
273
|
+
|
|
274
|
+
## Database adapters
|
|
275
|
+
|
|
276
|
+
SQLite is the one database Evlet ships with. Framework code reads and writes through the
|
|
277
|
+
query builder (`evlet/qb.py`): plain statement objects run with `connection.run(...)`. The SQLite
|
|
278
|
+
dialect (`evlet/sqlite.py`) compiles them to SQL and implements the connection interface in
|
|
279
|
+
`evlet/adapter.py`. `evlet/database.py` opens connections and runs transactions, and
|
|
280
|
+
`evlet/writes.py` holds the SQLite files and their write line-up. Other modules never write SQL
|
|
281
|
+
text or ask which database they run on; the modules still being moved are listed in
|
|
282
|
+
[database adapters](database-adapters.md), with the plan and how another database would be added.
|
|
285
283
|
|
|
286
284
|
## Projects, app packages and instances
|
|
287
285
|
|
|
@@ -292,12 +290,12 @@ trusted installation stages database changes and publishes a separate app lock
|
|
|
292
290
|
with a recoverable journal. Existing framework modules retain their public names.
|
|
293
291
|
See [the CLI guide](cli.md) for commands, resource packaging and boundaries.
|
|
294
292
|
|
|
295
|
-
##
|
|
293
|
+
## State manager
|
|
296
294
|
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
295
|
+
`evlet/statemanager.py` holds a document's State: its steps, the rules that move it between
|
|
296
|
+
them, and the hooks `@validate`, `@state`, `@state.exit` and `@release`. Confirm, cancel,
|
|
297
|
+
reopen and void are steps and rules, not separate operations. See
|
|
298
|
+
[states-actions.md](states-actions.md) and [document lifecycle](document-lifecycle.md).
|
|
301
299
|
|
|
302
300
|
## Ledger models
|
|
303
301
|
|
|
@@ -305,10 +303,9 @@ from existing State/Move applications.
|
|
|
305
303
|
declared, registered and migrated like any model and read through the same session, measures and
|
|
306
304
|
reports, but its table holds an integer id the database assigns and the declared columns only, and
|
|
307
305
|
`Meta.api` is forced to `None`, so every caller surface already leaves it out. Append-only tables use
|
|
308
|
-
database triggers, as `evlet_audit` and `evlet_journal` do. Named locks (`tx.lock`)
|
|
309
|
-
transaction
|
|
310
|
-
|
|
311
|
-
are app code. See [ledger models](ledger.md).
|
|
306
|
+
database triggers, as `evlet_audit` and `evlet_journal` do. Named locks (`tx.lock`) only check that a
|
|
307
|
+
write transaction is open on SQLite, whose writers are already serialised. The framework adds no
|
|
308
|
+
finance or stock concepts; balancing, reversals and cache rebuilds are app code. See [ledger models](ledger.md).
|
|
312
309
|
|
|
313
310
|
## The Tool Engine
|
|
314
311
|
|
|
@@ -152,8 +152,8 @@ class Leave(Model):
|
|
|
152
152
|
- `any_of(*scopes)` allows a row when any of its scopes or filter objects allows it. An empty
|
|
153
153
|
filter object among them allows every row.
|
|
154
154
|
|
|
155
|
-
The team is resolved inside one SQL statement with a recursive query (`WITH RECURSIVE`)
|
|
156
|
-
|
|
155
|
+
The team is resolved inside one SQL statement with a recursive query (`WITH RECURSIVE`),
|
|
156
|
+
so it has no size limit and needs no Python lookups. The values bound
|
|
157
157
|
are the user's linked record IDs only. `UNION` stops at a cycle in the data. Policies check
|
|
158
158
|
each declared team when they are built: the parent must be a Link to the same model, and the
|
|
159
159
|
field must lead to it. Declare the parent Link with `index=True` so each level is an index
|
|
@@ -170,12 +170,12 @@ for. The Playground's Employees show a manager, a team member and an outsider
|
|
|
170
170
|
A link decides what a team scope shows, so `LocalAuth.link_user` and `unlink_user` write each
|
|
171
171
|
change to the Controls audit log (area Users, with an `actor` argument; `evlet link-user` records
|
|
172
172
|
`cli`). A move in the tree is an ordinary edit of the parent Link: declare the hierarchy model with
|
|
173
|
-
`
|
|
173
|
+
`Meta.journal = Journal(tamper_evident=True)` to keep who moved whom and when, as the
|
|
174
|
+
Playground's Employee does.
|
|
174
175
|
|
|
175
176
|
Operations may also name `print` (printing with a print design; admin has it by default, see
|
|
176
|
-
[printing.md](printing.md#permission))
|
|
177
|
-
|
|
178
|
-
"Unpost and repost" sections of [states-actions.md](states-actions.md).
|
|
177
|
+
[printing.md](printing.md#permission)). Moves need no operation of their own: a State rule's
|
|
178
|
+
`by` and update permission decide them ([states-actions.md](states-actions.md)).
|
|
179
179
|
|
|
180
180
|
Restricted fields are removed from responses, search, and schema metadata. Querying
|
|
181
181
|
or sorting on unavailable fields is rejected. Link IDs are returned as null when
|
|
@@ -311,8 +311,8 @@ records they touch. They must not call external services inside the transaction.
|
|
|
311
311
|
Do not expose an arbitrary method dispatcher.
|
|
312
312
|
|
|
313
313
|
Model actions declared with `@action` on a document may also take validated `inputs`
|
|
314
|
-
and declare `available_when`. A `State` field with
|
|
315
|
-
document's state through `POST /api/{model}/{id}/moves/{
|
|
314
|
+
and declare `available_when`. A `State` field with steps and rules changes a
|
|
315
|
+
document's state through `POST /api/{model}/{id}/moves/{key}` and can lock it against
|
|
316
316
|
ordinary writes. See [states-actions.md](states-actions.md). The record page shows the
|
|
317
317
|
State as a header badge by default; declare `show="bar"` on a pipeline (draft, submitted,
|
|
318
318
|
approved) for the stage bar, or `show="none"`. `Meta.status = "<field>"` shows a Select the
|
|
@@ -320,7 +320,7 @@ system sets, such as a calculated payment status, as a badge that is never edite
|
|
|
320
320
|
header ([states-actions.md](states-actions.md#how-a-state-and-a-status-show)). The list offers a
|
|
321
321
|
board, one column per state, only when `Meta.board` names the State field, such as
|
|
322
322
|
`board = "stage"`; any other field fails registration. A move only the application makes,
|
|
323
|
-
such as one a background job takes, is declared `
|
|
323
|
+
such as one a background job takes, is declared `State.Rule(..., by=())`: it has no roles, no
|
|
324
324
|
caller can make it, and trusted Python makes it with `context.move()`
|
|
325
325
|
([states-actions.md](states-actions.md#system-moves)). A job gets that context with
|
|
326
326
|
`job.business(tx, ...)`, and an action queues a job with `self.context.enqueue(...)`
|
|
@@ -427,10 +427,8 @@ for everyone else in either direction, and can only shorten sessions and the loc
|
|
|
427
427
|
`"local"`, the only values accepted today. New `config.py` files leave them out.
|
|
428
428
|
Older files that set them to those values keep working.
|
|
429
429
|
|
|
430
|
-
The CLI supports SQLite/local storage.
|
|
431
|
-
|
|
432
|
-
PostgreSQL instance creation is intentionally rejected until its isolation strategy
|
|
433
|
-
is specified. Do not point the new installer at an existing unmanaged database.
|
|
430
|
+
The CLI supports SQLite/local storage. Tenant routing, S3 and other framework APIs
|
|
431
|
+
remain available through explicit Python configuration. Do not point the new installer at an existing unmanaged database.
|
|
434
432
|
It will reject it rather than adopt it. Existing Playground data stays in place.
|
|
435
433
|
|
|
436
434
|
`evlet serve` never prints sign-in links. While the built-in Administrator has no password
|
|
@@ -8,8 +8,8 @@ secrets and connector secrets (see [Controls](controls.md#connectors-and-secrets
|
|
|
8
8
|
writing our own cipher is not an option. The connector calls the same authenticated HTTP routes used by
|
|
9
9
|
the browser, so tenant, account, model, row, field, and action checks stay on the
|
|
10
10
|
server. It has no database handle, arbitrary SQL, Python execution, or file tool.
|
|
11
|
-
No context it reaches opens the transaction session of a
|
|
12
|
-
([states-actions.md](states-actions.md#the-transaction-session-in-
|
|
11
|
+
No context it reaches opens the transaction session of a state hook or action handler
|
|
12
|
+
([states-actions.md](states-actions.md#the-transaction-session-in-hooks-and-actions)).
|
|
13
13
|
The same tools are also served over HTTP at `/_/mcp` with OAuth sign-in; see
|
|
14
14
|
[Remote MCP with OAuth](#remote-mcp-with-oauth).
|
|
15
15
|
|
|
@@ -145,7 +145,7 @@ so the application decides what this person may call and logs every call.
|
|
|
145
145
|
| `job_status` | Read a permitted queued action's status when jobs are configured |
|
|
146
146
|
| `create_record` | Create with backend validation |
|
|
147
147
|
| `update_record` | Apply partial values and any supplied child replacements |
|
|
148
|
-
| `change_state` | Move a document
|
|
148
|
+
| `change_state` | Move a document with one of its State rules (`rule`, `remark`, `values`) |
|
|
149
149
|
| `run_action` | Invoke a registered action, including queued actions |
|
|
150
150
|
| `delete_record` | Delete a permitted record and owned children |
|
|
151
151
|
|