evlet 0.4.2__tar.gz → 0.4.3__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.2 → evlet-0.4.3}/CHANGELOG.md +80 -0
- {evlet-0.4.2 → evlet-0.4.3}/MANIFEST.in +1 -0
- {evlet-0.4.2/evlet.egg-info → evlet-0.4.3}/PKG-INFO +4 -4
- {evlet-0.4.2 → evlet-0.4.3}/README.md +3 -3
- {evlet-0.4.2 → evlet-0.4.3}/build_support.py +1 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/app-upgrades.md +63 -3
- {evlet-0.4.2 → evlet-0.4.3}/docs/cli.md +107 -15
- {evlet-0.4.2 → evlet-0.4.3}/docs/controls.md +6 -6
- {evlet-0.4.2 → evlet-0.4.3}/docs/jobs-realtime.md +35 -2
- {evlet-0.4.2 → evlet-0.4.3}/docs/performance.md +104 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/postgresql.md +5 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/production-operations.md +18 -2
- {evlet-0.4.2 → evlet-0.4.3}/docs/routing.md +89 -9
- {evlet-0.4.2 → evlet-0.4.3}/docs/tenancy-deployment.md +1 -1
- {evlet-0.4.2 → evlet-0.4.3}/docs/ui.md +1 -1
- {evlet-0.4.2 → evlet-0.4.3}/evlet/app.py +33 -5
- {evlet-0.4.2 → evlet-0.4.3}/evlet/assistants.py +4 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/auth.py +48 -25
- evlet-0.4.3/evlet/cli/backup.py +116 -0
- evlet-0.4.3/evlet/cli/hosts.py +283 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/install.py +41 -15
- {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/instance.py +1 -1
- {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/main.py +64 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/proxy.py +23 -7
- {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/serve.py +3 -2
- {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/site.py +32 -2
- {evlet-0.4.2 → evlet-0.4.3}/evlet/controls.py +5 -4
- {evlet-0.4.2 → evlet-0.4.3}/evlet/database.py +143 -20
- {evlet-0.4.2 → evlet-0.4.3}/evlet/documents.py +5 -4
- {evlet-0.4.2 → evlet-0.4.3}/evlet/eva.py +21 -10
- {evlet-0.4.2 → evlet-0.4.3}/evlet/framework.py +10 -2
- {evlet-0.4.2 → evlet-0.4.3}/evlet/images.py +2 -1
- {evlet-0.4.2 → evlet-0.4.3}/evlet/instances.py +1 -1
- {evlet-0.4.2 → evlet-0.4.3}/evlet/jobs.py +51 -3
- {evlet-0.4.2 → evlet-0.4.3}/evlet/postgres.py +7 -2
- {evlet-0.4.2 → evlet-0.4.3}/evlet/routing.py +56 -5
- {evlet-0.4.2 → evlet-0.4.3}/evlet/secrets.py +3 -2
- {evlet-0.4.2 → evlet-0.4.3}/evlet/services.py +1 -1
- {evlet-0.4.2 → evlet-0.4.3}/evlet/states.py +2 -2
- {evlet-0.4.2 → evlet-0.4.3}/evlet/tools.py +8 -4
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/routes.py +16 -3
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/serving.py +68 -15
- evlet-0.4.3/evlet/writes.py +501 -0
- {evlet-0.4.2 → evlet-0.4.3/evlet.egg-info}/PKG-INFO +4 -4
- {evlet-0.4.2 → evlet-0.4.3}/evlet.egg-info/SOURCES.txt +9 -0
- {evlet-0.4.2 → evlet-0.4.3}/examples/playground/app.py +10 -3
- evlet-0.4.3/examples/playground/site/404.html +16 -0
- evlet-0.4.3/examples/playground/site/about/index.html +16 -0
- evlet-0.4.3/examples/playground/site/index.html +17 -0
- evlet-0.4.3/examples/playground/site/robots.txt +3 -0
- evlet-0.4.3/examples/playground/site/site.css +4 -0
- evlet-0.4.3/examples/playground/site/sitemap.xml +5 -0
- {evlet-0.4.2 → evlet-0.4.3}/pyproject.toml +1 -1
- {evlet-0.4.2 → evlet-0.4.3}/LICENSE +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/amendment-v2.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/api-stability.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/application-generation.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/architecture.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/business-capabilities.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/connector.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/customizing.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/document-lifecycle.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/effects.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/eva.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/finite-calculations.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/getting-started.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/journal.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/ledger.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/lifecycle-specification.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/meaning.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/measures.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/model-engine.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/printing.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/reports.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/sequences.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/settings.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/slips.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/states-actions.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/tools.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/docs/ui-framework.md +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/__init__.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/__main__.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/audit.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/builds.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/business.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/calc.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/__init__.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/app.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/connector.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/devlink.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/docs.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/effects.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/ids.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/jobs.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/journal.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/ledger.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/playground.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/project.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/setup.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/connector.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/connectors.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/controls_export.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/controls_system.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/corrections.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/currencies.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/customization.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/declarations.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/deployment.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/devlink.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/discovery.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/effects.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/events.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/expressions.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/fields.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/forms.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/identity.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/indexes.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/journal.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ledger.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/lifecycle.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/mailboxes.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/mcp.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/meaning.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/measures.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/mentions.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/migrations.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/models.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/naming.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/object_storage.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/packages.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/periods.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/permissions.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/postgres_schema.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/printing.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/py.typed +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/query.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/reactivity.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/__init__.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/print/fonts/NotoSans-Bold.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/print/fonts/NotoSans-OFL.txt +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/print/fonts/NotoSans-Regular.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/print/fonts/NotoSansArabic-Bold.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/print/fonts/NotoSansArabic-OFL.txt +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/print/fonts/NotoSansArabic-Regular.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app/.gitignore.tpl +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app/README.md.tpl +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app/__app__/__init__.py.tpl +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app/__app__/actions/__init__.py.tpl +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app/__app__/hooks.py.tpl +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app/__app__/migrations/__init__.py.tpl +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app/__app__/models/__init__.py.tpl +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app/__app__/permissions.py.tpl +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app/pyproject.toml.tpl +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app/tests/test_models.py.tpl +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app_flat/.gitignore.tpl +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app_flat/README.md.tpl +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app_flat/__init__.py.tpl +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app_flat/models/__init__.py.tpl +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app_flat/models/item.py.tpl +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app_flat/pyproject.toml.tpl +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app_flat/setup.py.tpl +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/richtext.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/sections.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/sequences.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/serverless.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/settings.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/slips.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/storage.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/tenancy.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/__init__.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/application.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/metadata.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/IBMPlexSans-OFL.txt +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/JetBrainsMono-Medium-3S3k2nMz.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/JetBrainsMono-OFL.txt +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/JetBrainsMono-Regular-BQaDgvhP.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/ai-BoNaQPi6.js +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/app-0SduO6OB.css +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/app-CJDDr7hE.js +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/consent-CJkpbF5L.js +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/email-BAMmEqz2.js +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/evlet-icon-blue.svg +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/evlet-logo-primary.svg +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/evlet-logo-white.svg +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/ibm-plex-sans-latin-400-italic-CZTNEAuW.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/ibm-plex-sans-latin-400-normal-CDDApCn2.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/ibm-plex-sans-latin-500-normal-6ng42L7E.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/ibm-plex-sans-latin-600-normal-CuJfVYMP.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/ibm-plex-sans-latin-700-normal-Bxkt5Cjx.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-400-italic-Du9zzoL2.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-400-normal-C5H60-Va.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-500-normal-DakdToA3.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-600-normal-DOrvGEcy.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-700-normal-aMgXseD4.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/index-D1OKAsr0.js +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/index-UqEST1u4.css +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/keys-D9Qq-LDr.js +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/index.html +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/unsaved.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet/workspaces.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet.egg-info/dependency_links.txt +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet.egg-info/entry_points.txt +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet.egg-info/requires.txt +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/evlet.egg-info/top_level.txt +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/examples/playground/items.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/examples/playground/manage.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/examples/playground/migrate.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/examples/playground/models.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/examples/playground/portal/index.html +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/examples/playground/portal/portal.css +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/examples/playground/portal/portal.js +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/examples/playground/prints.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/examples/playground/reports.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/examples/playground/settings.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/examples/playground/slips.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/examples/playground/team.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/examples/playground/tenants.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/examples/playground/worker.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/examples/playground/workspaces.py +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/.node-version +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/.npmrc +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/IBMPlexSans-OFL.txt +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/JetBrainsMono-Medium.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/JetBrainsMono-OFL.txt +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/JetBrainsMono-Regular.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/ibm-plex-sans-latin-400-italic.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/ibm-plex-sans-latin-400-normal.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/ibm-plex-sans-latin-500-normal.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/ibm-plex-sans-latin-600-normal.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/ibm-plex-sans-latin-700-normal.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/ibm-plex-sans-latin-ext-400-italic.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/ibm-plex-sans-latin-ext-400-normal.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/ibm-plex-sans-latin-ext-500-normal.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/ibm-plex-sans-latin-ext-600-normal.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/ibm-plex-sans-latin-ext-700-normal.woff2 +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/index.html +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/package-lock.json +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/package.json +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/public/assets/evlet-icon-blue.svg +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/public/assets/evlet-logo-primary.svg +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/public/assets/evlet-logo-white.svg +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/scripts/bench-ui.mjs +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/scripts/dev-proxy.mjs +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/scripts/dev-proxy.test.mjs +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/scripts/install-ui.mjs +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/api.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/app.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/client.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/composer.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/config.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/context.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/docs.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/duplicate.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/explorer.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/filters.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/inbox.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/last-page.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/list-page.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/login.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/main.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/meta.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/nav-icons.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/palette.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/prefs.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/recents.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/record-blocks.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/record-compact.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/record-page.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/related-data.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/report-page.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/revisions.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/screens.css +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/settings.css +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/settings.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/shell.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/shortcuts.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/slips.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/unsaved-bar.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/unsaved.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/workspace-editor.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/workspaces.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/access.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/ai.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/app.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/client.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/connections.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/controls.css +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/currencies.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/drafts.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/eva.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/keys.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/log.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/models.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/naming.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/people.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/periods.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/prints.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/system.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/unsaved.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/dev.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/dom.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/eva/chat.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/eva/client.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/eva/eva.css +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/eva/tasks.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ids.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/model/changes.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/model/finite.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/model/format.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/model/links.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/model/record.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/model/schema.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/model/session.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/model/unsaved.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/reactive.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/richtext/editor.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/richtext/history.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/richtext/html.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/richtext/images.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/richtext/model.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/richtext/ops.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/richtext/render.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/richtext/richtext.css +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/router.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/settings/ai.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/settings/consent.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/settings/email.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/settings/keys.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/autofocus.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/base.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/catalog.json +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/chart.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/childtable.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/core.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/dateparse.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/doc.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/draglist.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/explain.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/fields.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/fold.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/icon-data.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/index.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/inline.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/kinds.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/layers.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/library.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/list.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/money.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/pickers.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/shortcuts.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/split.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/styles.css +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/table.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/theme.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/time.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/tooltip.ts +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/tsconfig.json +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/frontend/vite.config.js +0 -0
- {evlet-0.4.2 → evlet-0.4.3}/setup.cfg +0 -0
|
@@ -4,6 +4,86 @@ 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.3 (12-11-2026)
|
|
8
|
+
|
|
9
|
+
### Added
|
|
10
|
+
|
|
11
|
+
- **Public websites from app frontends.** A sub-host whose root frontend has `auth=None` is a
|
|
12
|
+
public host. It serves only the site's own files and the `public=True` service endpoints its
|
|
13
|
+
API scopes list. `/login`, `/api/auth/session` and the rest of `/api`, `/_/...`,
|
|
14
|
+
`/.well-known/...` and `/health` answer 404 there, every refusal looks like the site's own
|
|
15
|
+
missing page, and pages carry no `evlet-config` block, so nothing names the instance, its
|
|
16
|
+
application or its version. The site owns every other path, `/docs` and `/assets` included.
|
|
17
|
+
See [Public websites](docs/routing.md#public-websites).
|
|
18
|
+
- **`Frontend(..., routing="pages")`** for multi-page static sites: `/about/` serves
|
|
19
|
+
`about/index.html`, `/pricing` serves `pricing.html`, the other form redirects (301) to the one
|
|
20
|
+
that exists, and an unknown path gets the frontend's `404.html` with status 404. `"app"` is the
|
|
21
|
+
default and keeps the single-page behaviour. See [Multi-page sites](docs/routing.md#multi-page-sites).
|
|
22
|
+
- **More file types for static frontends:** `txt`, `xml`, `webmanifest`, `pdf`, `gif`, `avif` and
|
|
23
|
+
`woff`, so `robots.txt` and `sitemap.xml` are served. HEAD works for pages and files.
|
|
24
|
+
- **`Frontend(..., suggested_host="www")`.** When `evlet install` adds the app to an instance with a
|
|
25
|
+
domain, it offers `www.<domain>` or your own domain and writes the `Host(...)` line into
|
|
26
|
+
`routes.py`. `--yes` takes the suggestion and `--no-host` skips it.
|
|
27
|
+
- **`evlet host add | remove | list`.** `host add acme www.example.com --root site.www` checks DNS,
|
|
28
|
+
edits `routes.py` safely, rewrites the Caddy site and, with `--apply`, installs it, reloads Caddy
|
|
29
|
+
and restarts the service. `--routes-only` suits Caddy with on-demand TLS. See
|
|
30
|
+
[Serve a website on its own host](docs/cli.md#serve-a-website-on-its-own-host).
|
|
31
|
+
- **`Host(root="app.frontend")`** names a frontend by its id, so `routes.py` needs no import.
|
|
32
|
+
- **Four SQLite files per instance.** `data/database.sqlite3` keeps records, the audit trail, the
|
|
33
|
+
journal, jobs, accounts and settings. Sign-in sessions, two-step tickets and sign-in attempts
|
|
34
|
+
move to `sessions.sqlite3`; the tool-call log, public rate counts and proxy header notes to
|
|
35
|
+
`logs.sqlite3`; Eva's chats, messages, files, usage and tasks to `eva.sqlite3`. All four use
|
|
36
|
+
WAL, and a write locks only the file it changes, so a long job no longer holds up sign-in, the
|
|
37
|
+
tool log or Eva. SQL names tables as before. `database.transaction(store="sessions")` (or
|
|
38
|
+
`"logs"`, `"eva"`) writes one side file only. See
|
|
39
|
+
[Busy writing on SQLite](docs/performance.md#busy-writing-on-sqlite).
|
|
40
|
+
- **Writers take turns.** Within a process each file has a line of writers: requests first, in
|
|
41
|
+
order, and a waiting job step goes next once it has waited 0.25 s, so jobs are never starved.
|
|
42
|
+
A resumable job gives up its turn after every step, and while people are writing it rests as
|
|
43
|
+
long as each step, so it gets about half of the file's time. With a job writing in 0.1 s
|
|
44
|
+
transactions, eight people completed 42 saves in 20 s on 0.4.2 (16 failed with "database is
|
|
45
|
+
locked") and 768 on 0.4.3 with none failed, against 779 with no job at all. The wait limit stays 5 s.
|
|
46
|
+
- **Slow write warning.** A write that holds a file longer than 1 s (`Database.slow_write`) logs
|
|
47
|
+
a warning naming the request or the job.
|
|
48
|
+
- **Batched counters.** API key last use, AI assistant call counts and proxy header notes are
|
|
49
|
+
saved by one background thread about every 250 ms, and on shutdown.
|
|
50
|
+
- **Delayed and follow-up jobs.** `Context.enqueue(..., run_at=...)` delays a job, and
|
|
51
|
+
`JobContext.follow_up(tx, payload=None, *, run_at, key=None)` queues a job's next run in its
|
|
52
|
+
own transaction with the same identity. See [Follow-up runs](docs/jobs-realtime.md#follow-up-runs).
|
|
53
|
+
- **`evlet backup` and `evlet restore`** copy and put back an instance's four files as one set.
|
|
54
|
+
Restore asks for the instance name (or `--yes NAME`), keeps the files it replaces, and also
|
|
55
|
+
takes a single-file backup from 0.4.2. See [Back up and restore](docs/cli.md#back-up-and-restore).
|
|
56
|
+
- `evlet.writes.data_files(path)` lists an instance's database files, and `evlet.writes.connect(path)`
|
|
57
|
+
opens a main file with the others attached, for tools that open SQLite themselves.
|
|
58
|
+
- `scripts/busy_queue_benchmark.py` and `scripts/benchmark_busy_writes.py` measure saves while a job writes.
|
|
59
|
+
|
|
60
|
+
### Changed
|
|
61
|
+
|
|
62
|
+
- **The built-in System Administrator's username is now `admin`**, not `administrator`. Its full
|
|
63
|
+
name stays "System Administrator". `evlet migrate` runs the new step `0009_admin_username`,
|
|
64
|
+
which renames the 0.4.2 account and keeps its password, email and two-step sign-in. An instance
|
|
65
|
+
with an active admin already named `admin` (common before 0.4.2) keeps that account as the
|
|
66
|
+
Administrator, and the 0.4.2 `administrator` becomes an ordinary admin, disabled when it never
|
|
67
|
+
had a password. Any other account named `admin` stops the step until it is renamed. Sign in,
|
|
68
|
+
`evlet users set-password <instance> admin` and `evlet users set-email <instance> admin` use
|
|
69
|
+
the new name ([docs/app-upgrades.md](docs/app-upgrades.md#from-042-to-043)).
|
|
70
|
+
- **Caddy refuses a `Host` that differs from the TLS server name.** `evlet proxy --caddy` starts
|
|
71
|
+
with a global options block that turns on `strict_sni_host`. `evlet setup --host --apply`
|
|
72
|
+
installs it as `/etc/caddy/evlet-global.caddy` and imports it on the first line of the
|
|
73
|
+
Caddyfile; if your Caddyfile has its own global options block, it asks you to add the option
|
|
74
|
+
there. The nginx output answers such a request with 421. Run `evlet setup ... --host ... --apply`
|
|
75
|
+
again to update an existing site.
|
|
76
|
+
- `evlet proxy` no longer refuses `/controls` and `/docs` on a public host; the instance answers
|
|
77
|
+
them with the site's page or its 404.
|
|
78
|
+
- Framework step `0010_split_files` moves the tables on `evlet migrate`, after the backup, on the
|
|
79
|
+
staged copy. It checks row counts before dropping each table from the main file, is safe to run
|
|
80
|
+
again after a crash, and stops early when the disk is short. A no-op on PostgreSQL. See
|
|
81
|
+
[From 0.4.2 to 0.4.3](docs/app-upgrades.md#from-042-to-043).
|
|
82
|
+
- The moved tables no longer declare foreign keys to `evlet_users` (SQLite cannot check them
|
|
83
|
+
across files); Evlet removes sessions and Eva data of accounts that no longer exist at startup.
|
|
84
|
+
After a crash the side files are best effort for the last moment of writes.
|
|
85
|
+
- `evlet migrate` backs up and stages all four files, and checks free disk space first.
|
|
86
|
+
|
|
7
87
|
## 0.4.2 (11-11-2026)
|
|
8
88
|
|
|
9
89
|
### Added
|
|
@@ -2,6 +2,7 @@ include README.md CHANGELOG.md build_support.py
|
|
|
2
2
|
include docs/*.md
|
|
3
3
|
include examples/playground/*.py
|
|
4
4
|
recursive-include examples/playground/portal *.html *.css *.js
|
|
5
|
+
recursive-include examples/playground/site *.html *.css *.txt *.xml
|
|
5
6
|
include frontend/package.json frontend/package-lock.json frontend/index.html frontend/vite.config.js
|
|
6
7
|
include frontend/.node-version frontend/.npmrc frontend/tsconfig.json
|
|
7
8
|
recursive-include frontend/src *.ts *.css *.json
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: evlet
|
|
3
|
-
Version: 0.4.
|
|
3
|
+
Version: 0.4.3
|
|
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
|
|
@@ -59,8 +59,8 @@ evlet install notes --instance acme
|
|
|
59
59
|
evlet serve acme
|
|
60
60
|
```
|
|
61
61
|
|
|
62
|
-
Every instance has a built-in **System Administrator** (username `
|
|
63
|
-
password. `evlet serve` tells you to set one with `evlet users set-password acme
|
|
62
|
+
Every instance has a built-in **System Administrator** (username `admin`) with no
|
|
63
|
+
password. `evlet serve` tells you to set one with `evlet users set-password acme admin`;
|
|
64
64
|
then open **http://127.0.0.1:8000** and sign in. There is no default password. To serve a site on your own domain behind Caddy, see
|
|
65
65
|
[Serve a site on a domain in one go](docs/cli.md#serve-a-site-on-a-domain-in-one-go).
|
|
66
66
|
|
|
@@ -122,7 +122,7 @@ opens at **http://127.0.0.1:8001**.
|
|
|
122
122
|
`evlet playground` and `evlet dev` print a sign-in link for the built-in Administrator when they start:
|
|
123
123
|
|
|
124
124
|
```text
|
|
125
|
-
The
|
|
125
|
+
The admin account has no password yet. Open this link to sign in and choose one (works once, for 10 minutes):
|
|
126
126
|
http://127.0.0.1:8000/_dev/signin?token=...
|
|
127
127
|
```
|
|
128
128
|
|
|
@@ -30,8 +30,8 @@ evlet install notes --instance acme
|
|
|
30
30
|
evlet serve acme
|
|
31
31
|
```
|
|
32
32
|
|
|
33
|
-
Every instance has a built-in **System Administrator** (username `
|
|
34
|
-
password. `evlet serve` tells you to set one with `evlet users set-password acme
|
|
33
|
+
Every instance has a built-in **System Administrator** (username `admin`) with no
|
|
34
|
+
password. `evlet serve` tells you to set one with `evlet users set-password acme admin`;
|
|
35
35
|
then open **http://127.0.0.1:8000** and sign in. There is no default password. To serve a site on your own domain behind Caddy, see
|
|
36
36
|
[Serve a site on a domain in one go](docs/cli.md#serve-a-site-on-a-domain-in-one-go).
|
|
37
37
|
|
|
@@ -93,7 +93,7 @@ opens at **http://127.0.0.1:8001**.
|
|
|
93
93
|
`evlet playground` and `evlet dev` print a sign-in link for the built-in Administrator when they start:
|
|
94
94
|
|
|
95
95
|
```text
|
|
96
|
-
The
|
|
96
|
+
The admin account has no password yet. Open this link to sign in and choose one (works once, for 10 minutes):
|
|
97
97
|
http://127.0.0.1:8000/_dev/signin?token=...
|
|
98
98
|
```
|
|
99
99
|
|
|
@@ -18,6 +18,7 @@ class BuildPy(build_py):
|
|
|
18
18
|
for name in ('app.py', 'items.py', 'models.py', 'migrate.py', 'prints.py', 'reports.py', 'settings.py', 'slips.py', 'workspaces.py'):
|
|
19
19
|
shutil.copy2(root / 'examples/playground' / name, playground / name)
|
|
20
20
|
shutil.copytree(root / 'examples/playground/portal', playground / 'portal', dirs_exist_ok=True)
|
|
21
|
+
shutil.copytree(root / 'examples/playground/site', playground / 'site', dirs_exist_ok=True)
|
|
21
22
|
docs = resources / 'docs'
|
|
22
23
|
docs.mkdir(parents=True, exist_ok=True)
|
|
23
24
|
for path in (root / 'docs').glob('*.md'):
|
|
@@ -79,7 +79,9 @@ modified time and user columns to every model table and fills them from the Jour
|
|
|
79
79
|
unsaved changes people leave on saved records ([ui.md](ui.md#unsaved-changes)). `0006_fixed_ids` adds the
|
|
80
80
|
trigger that refuses an id change to every model table ([model-engine.md](model-engine.md#only-evlet-makes-ids)). `0007_money_scale` records that every
|
|
81
81
|
Currency amount is stored at 6 places; `evlet migrate` moves the amounts before any app migration runs
|
|
82
|
-
([model-engine.md](model-engine.md#decimal-places-per-currency)).
|
|
82
|
+
([model-engine.md](model-engine.md#decimal-places-per-currency)). `0010_split_files` moves sign-in sessions, the
|
|
83
|
+
tool-call log and Eva into their own SQLite files next to the database (see From 0.4.2 to 0.4.3 below).
|
|
84
|
+
Steps never run while an instance is served.
|
|
83
85
|
`evlet migrate acme --plan` lists the pending ones without writing anything. If a step fails, the staged copy is
|
|
84
86
|
discarded and the database and lock stay as they were; restore the earlier Evlet
|
|
85
87
|
before restarting.
|
|
@@ -97,6 +99,61 @@ first applies the steps and the others find them applied. Do not keep data you c
|
|
|
97
99
|
Main uses a development version between releases; a source build is not the same
|
|
98
100
|
artifact as the last PyPI release.
|
|
99
101
|
|
|
102
|
+
### From 0.4.2 to 0.4.3
|
|
103
|
+
|
|
104
|
+
0.4.3 renames the built-in System Administrator's username from `administrator` to `admin`, and splits
|
|
105
|
+
each instance's SQLite database into four files with writers taking turns, so a long job no longer
|
|
106
|
+
makes pages fail with "database is locked". Apps keep their `evlet>=0.4.0,<0.5` dependency.
|
|
107
|
+
|
|
108
|
+
`evlet migrate` applies both steps in order, after one backup.
|
|
109
|
+
|
|
110
|
+
The Administrator's username:
|
|
111
|
+
|
|
112
|
+
- Run `evlet migrate` for each instance. It applies `0009_admin_username`, which renames the
|
|
113
|
+
account and keeps its password, email and two-step sign-in. Sign in as `admin` afterwards.
|
|
114
|
+
- An instance that also has an ordinary active admin named `admin` keeps that account as the
|
|
115
|
+
Administrator, with its own password. The 0.4.2 `administrator` account becomes an ordinary
|
|
116
|
+
admin, disabled when it never had a password. Remove it in Controls if you don't need it.
|
|
117
|
+
- An account named `admin` that is not an active admin stops the step: rename it first.
|
|
118
|
+
- Tests and scripts that sign in as `administrator` use `admin`. A test fixture that adds its own
|
|
119
|
+
account named `admin` now meets the Administrator: give it a password instead of inserting it,
|
|
120
|
+
for example with `INSERT ... ON CONFLICT(username) DO UPDATE SET password=excluded.password`.
|
|
121
|
+
Set any other column the fixture needs, such as `allow_mcp`, in the same update.
|
|
122
|
+
- Setting up `admin` through `/api/auth/setup` gives the Administrator its password, so the
|
|
123
|
+
accounts a test adds after it start at 2 again, as before 0.4.2. Records it writes show
|
|
124
|
+
"Administrator" or "System Administrator", not "admin".
|
|
125
|
+
- The Administrator passes every role check. A test that checks a Rule limiting the admin role
|
|
126
|
+
needs an ordinary admin with another username, such as `owner`.
|
|
127
|
+
|
|
128
|
+
The four SQLite files:
|
|
129
|
+
|
|
130
|
+
- Stop the instance and run `evlet migrate` before you serve it. It backs up
|
|
131
|
+
`data/database.sqlite3` first, then step `0010_split_files` moves these tables out of it:
|
|
132
|
+
`evlet_sessions`, `evlet_two_step_tickets` and `evlet_login_limits` into `sessions.sqlite3`;
|
|
133
|
+
`evlet_tool_calls`, `evlet_public_limits` and `evlet_forwarded_peers` into `logs.sqlite3`; and
|
|
134
|
+
the ten `evlet_eva_*` tables into `eva.sqlite3`. Everything else stays in `database.sqlite3`.
|
|
135
|
+
People stay signed in and nothing else changes for them.
|
|
136
|
+
- The move copies each table with its rows, indexes and id counter, checks that the row counts
|
|
137
|
+
match, and only then drops it from the main file. It works on the staged copy `evlet migrate`
|
|
138
|
+
already uses, so a failure leaves the instance as it was, and it is safe to run again after a
|
|
139
|
+
crash at any point. It first checks the disk has room for the backup, the staged copy and the
|
|
140
|
+
moved tables, and stops with a clear message, changing nothing, when it does not.
|
|
141
|
+
- Back up and restore the four files together: `evlet backup --instance NAME` and
|
|
142
|
+
`evlet restore BACKUP --instance NAME` are new ([cli.md](cli.md#back-up-and-restore)). A
|
|
143
|
+
single-file backup from 0.4.2 still restores; run `evlet migrate` after it.
|
|
144
|
+
- App code keeps naming tables as before: SQL finds a table in whichever file holds it. A
|
|
145
|
+
write transaction that touches a sessions, logs or Eva table takes that file's turn too.
|
|
146
|
+
Code that opens the SQLite file itself with `sqlite3.connect` sees only the main file; use
|
|
147
|
+
`evlet.writes.connect(path)` to get the others attached.
|
|
148
|
+
- SQLite cannot check a foreign key from one file to another, so the moved tables no longer
|
|
149
|
+
declare one to `evlet_users`; Evlet checks those links itself. A table in your app should not
|
|
150
|
+
reference a moved table.
|
|
151
|
+
- New for jobs: `Context.enqueue(..., run_at=...)` delays a job, and a running job queues its
|
|
152
|
+
own next run with `context.follow_up(tx, payload, run_at=...)`, in the same transaction and
|
|
153
|
+
with the same identity ([jobs-realtime.md](jobs-realtime.md#follow-up-runs)). An app that
|
|
154
|
+
polls with an every-minute schedule can use a follow-up run instead.
|
|
155
|
+
- PostgreSQL instances keep one database; the step only records itself there.
|
|
156
|
+
|
|
100
157
|
### From 0.4.1 to 0.4.2
|
|
101
158
|
|
|
102
159
|
0.4.2 adds the built-in System Administrator and new sign-in rules in config.py. Apps keep
|
|
@@ -193,7 +250,10 @@ requires trust. Keep `apps.lock` and its matching database together.
|
|
|
193
250
|
## Keep backups manageable
|
|
194
251
|
|
|
195
252
|
Changed installs and Evlet upgrades save a timestamped SQLite backup under the
|
|
196
|
-
instance's `data/backups
|
|
253
|
+
instance's `data/backups/`: the main file `<time>.sqlite3` and, from 0.4.3, its
|
|
254
|
+
`<time>-sessions.sqlite3`, `<time>-logs.sqlite3` and `<time>-eva.sqlite3`. `evlet backup` writes
|
|
255
|
+
the same kind of set. Keep or remove the files of a set together. Unchanged migrations do not add one. There is no retention command.
|
|
197
256
|
After verifying recovery, remove obsolete backup files according to your own
|
|
198
257
|
retention policy while keeping the source, lock and private files needed to restore
|
|
199
|
-
each retained snapshot. Never delete the active `data/database.sqlite3` file
|
|
258
|
+
each retained snapshot. Never delete the active `data/database.sqlite3` file or its `sessions`, `logs` and `eva`
|
|
259
|
+
files.
|
|
@@ -82,6 +82,7 @@ evlet build --trust
|
|
|
82
82
|
evlet instance acme
|
|
83
83
|
evlet instance --list
|
|
84
84
|
evlet install notes --instance acme --trust
|
|
85
|
+
evlet install site --instance acme --trust --yes
|
|
85
86
|
evlet serve acme --port 8000
|
|
86
87
|
evlet dev --instance acme
|
|
87
88
|
evlet dev-link
|
|
@@ -94,13 +95,18 @@ evlet ids check acme
|
|
|
94
95
|
evlet journal verify acme
|
|
95
96
|
evlet ledger list --instance acme
|
|
96
97
|
evlet jobs list --instance acme
|
|
98
|
+
evlet backup --instance acme
|
|
99
|
+
evlet restore instances/acme/data/backups/20261112T061500000000Z.sqlite3 --instance acme
|
|
97
100
|
evlet routes acme
|
|
98
101
|
evlet proxy acme --caddy --check
|
|
102
|
+
evlet host add acme www.example.com --root site.www --apply
|
|
103
|
+
evlet host remove acme www.example.com --apply
|
|
104
|
+
evlet host list acme
|
|
99
105
|
evlet link-user acme buyer customer 42
|
|
100
106
|
evlet controls grant acme mariam
|
|
101
107
|
evlet users reset-two-step acme mariam
|
|
102
108
|
evlet users set-password acme mariam
|
|
103
|
-
evlet users set-email acme
|
|
109
|
+
evlet users set-email acme admin ops@example.com
|
|
104
110
|
evlet secrets rotate acme
|
|
105
111
|
evlet playground --port 8000
|
|
106
112
|
evlet docs --port 8001
|
|
@@ -149,16 +155,16 @@ that process. No worker is mandatory.
|
|
|
149
155
|
`bench browse --user` in Frappe:
|
|
150
156
|
|
|
151
157
|
```text
|
|
152
|
-
The
|
|
158
|
+
The admin account has no password yet. Open this link to sign in and choose one (works once, for 10 minutes):
|
|
153
159
|
http://127.0.0.1:8000/_dev/signin?token=...
|
|
154
160
|
```
|
|
155
161
|
|
|
156
|
-
Every instance has the built-in System Administrator (`
|
|
162
|
+
Every instance has the built-in System Administrator (`admin`), with no password at
|
|
157
163
|
first ([controls.md](controls.md#the-administrator)). The first link signs it in and opens a
|
|
158
164
|
"Set your password" screen that follows config.py's admin minimum. When admins need two-step
|
|
159
165
|
sign-in (`Security(admin_two_step=True)`, the default), that session then ends and the
|
|
160
166
|
authenticator set-up follows, as at a normal sign-in; finishing it opens the app. Later starts
|
|
161
|
-
print `Sign in as
|
|
167
|
+
print `Sign in as admin (works once, for 10 minutes): ...` and the link signs straight
|
|
162
168
|
in, sent to `/`. The sign-in page never offers a "Sign in as administrator" button: the link is
|
|
163
169
|
only printed in the terminal of the person who started the server.
|
|
164
170
|
|
|
@@ -174,7 +180,7 @@ project it serves the project's instance (`--instance` picks one, `--port` match
|
|
|
174
180
|
Instances that already have other admins (such as `admin` or `demo-admin` from 0.4.1 and
|
|
175
181
|
earlier) keep them unchanged.
|
|
176
182
|
- `--no-link` on `evlet dev` or `evlet playground` skips the startup link. The browser setup
|
|
177
|
-
page then asks for the first admin; choosing the username `
|
|
183
|
+
page then asks for the first admin; choosing the username `admin` there gives the
|
|
178
184
|
Administrator its password.
|
|
179
185
|
- The app itself serves `/_dev/signin` on the same host and port. The route exists
|
|
180
186
|
only under `evlet dev` and `evlet playground`. `evlet serve`, tenant applications
|
|
@@ -224,13 +230,22 @@ it exits with status 1 when there is any difference. See [effects.md](effects.md
|
|
|
224
230
|
does, then prints the resolved hosts and paths, marking locked rows and where each
|
|
225
231
|
row came from. See [routing.md](routing.md).
|
|
226
232
|
`proxy` prints a Caddy (`--caddy`) or nginx (`--nginx`) configuration for the
|
|
227
|
-
instance hosts, refusing `/controls` and `/docs` on sub-hosts and framework `/_/`
|
|
228
|
-
paths other than the MCP, OAuth and mailbox sign-in routes.
|
|
229
|
-
|
|
233
|
+
instance hosts, refusing `/controls` and `/docs` on portal sub-hosts and framework `/_/`
|
|
234
|
+
paths other than the MCP, OAuth and mailbox sign-in routes. It refuses a request whose
|
|
235
|
+
`Host` differs from the TLS server name: the Caddy file starts with a global options block
|
|
236
|
+
that turns on `strict_sni_host`, and each nginx server answers such a request with 421.
|
|
237
|
+
`--write PATH` writes it to that file instead; nothing else is written and no service is reloaded.
|
|
230
238
|
`--check` reports where each host's A and AAAA records point. It warns when a host
|
|
231
239
|
points at a public address this server cannot see as its own (behind NAT), and exits
|
|
232
240
|
with status 1 only when a host has no record, or points only at private addresses while
|
|
233
241
|
this server has a public one. `--ip` names this server's public address.
|
|
242
|
+
`install` offers a host for each frontend of a newly installed app that sets
|
|
243
|
+
`suggested_host` ([routing.md](routing.md#public-websites)), when the instance has a domain:
|
|
244
|
+
`<label>.<instance domain>`, such as `www.erp.example.com`, or a domain you type. `--yes`
|
|
245
|
+
takes the suggestion without asking, and `--no-host` offers nothing. Without a terminal and
|
|
246
|
+
without `--yes`, it only prints the `evlet host add` command. It writes the `Host(...)` line
|
|
247
|
+
into `instances/<name>/routes.py` and nothing else; run the printed `evlet host add ... --apply`
|
|
248
|
+
to check DNS, update Caddy and restart the service.
|
|
234
249
|
`link-user` links an account to a record, such as a portal user to their customer,
|
|
235
250
|
for row scopes like `own_customer`, or a staff user to their employee record for a
|
|
236
251
|
team scope (`Hierarchy.team`). `--remove` removes the link. Both are written to the Controls
|
|
@@ -394,7 +409,7 @@ security = Security(password_min=15, admin_two_step=True, two_step=False, admin_
|
|
|
394
409
|
- `password_min`: 1 to 64 characters (15). 1 means no rule: even "1" is a password.
|
|
395
410
|
- `admin_two_step`: admins, the built-in Administrator too, must use two-step sign-in (on).
|
|
396
411
|
- `two_step`: everyone else must use it too (off). Controls can turn it on or off.
|
|
397
|
-
- `admin_sign_in`: the sign-in page opens with the username `
|
|
412
|
+
- `admin_sign_in`: the sign-in page opens with the username `admin` filled in (off).
|
|
398
413
|
- `session_hours` 1 to 168 (12) and `lockout` 3 to 50 failed sign-ins (5).
|
|
399
414
|
|
|
400
415
|
Admins always follow config.py. Controls can change the password minimum and two-step sign-in
|
|
@@ -414,7 +429,7 @@ It will reject it rather than adopt it. Existing Playground data stays in place.
|
|
|
414
429
|
|
|
415
430
|
`evlet serve` never prints sign-in links. While the built-in Administrator has no password
|
|
416
431
|
it prints `The built-in Administrator has no password yet. Set one with: evlet users set-password
|
|
417
|
-
acme
|
|
432
|
+
acme admin` at start.
|
|
418
433
|
|
|
419
434
|
For a conventional deployment, provision the administrator locally first, then
|
|
420
435
|
set `domain="app.example.com"`. This selects that exact HTTPS origin, secure
|
|
@@ -453,10 +468,23 @@ After installing the apps it:
|
|
|
453
468
|
check passes with it, the address is kept in `deploy/server.json` and used by later
|
|
454
469
|
runs; a new `--ip` replaces it.
|
|
455
470
|
5. Prints the privileged steps: copy the two files into `/etc/systemd/system/`
|
|
456
|
-
and `/etc/caddy/`,
|
|
457
|
-
|
|
471
|
+
and `/etc/caddy/`, copy `deploy/evlet-global.caddy` to `/etc/caddy/`, add an `import`
|
|
472
|
+
line for the site to the end of `/etc/caddy/Caddyfile` and one for the global options
|
|
473
|
+
to its first line, then `systemctl daemon-reload`, `systemctl enable --now evlet-acme` and
|
|
458
474
|
`systemctl reload caddy`, each with `sudo`.
|
|
459
475
|
|
|
476
|
+
`deploy/evlet-global.caddy` holds Caddy's global options, which turn on `strict_sni_host`
|
|
477
|
+
so that Caddy refuses a request whose `Host` differs from the TLS server name. Caddy reads
|
|
478
|
+
global options only from the first block of the Caddyfile, so this file is imported on line 1
|
|
479
|
+
and the site file has none. If your Caddyfile already starts with a global options block of its
|
|
480
|
+
own, `--apply` stops and asks you to add these lines inside it:
|
|
481
|
+
|
|
482
|
+
```text
|
|
483
|
+
servers :443 {
|
|
484
|
+
strict_sni_host on
|
|
485
|
+
}
|
|
486
|
+
```
|
|
487
|
+
|
|
460
488
|
Review the two files, then run those steps yourself, or run the same command again
|
|
461
489
|
with `--apply`. Every run writes both files again from the current Evlet. When the copy
|
|
462
490
|
in `/etc/caddy/` or `/etc/systemd/system/` differs, it says the copy is out of date, and
|
|
@@ -491,6 +519,42 @@ service again.
|
|
|
491
519
|
nothing outside `--apply` changes `/etc` or calls `sudo`. Controls, AI, MCP has a
|
|
492
520
|
**Check** button that tests the public address from the server.
|
|
493
521
|
|
|
522
|
+
### Serve a website on its own host
|
|
523
|
+
|
|
524
|
+
A static or server frontend can have its own host, such as a public website on
|
|
525
|
+
`www.example.com` next to the ERP on `erp.example.com`:
|
|
526
|
+
|
|
527
|
+
```sh
|
|
528
|
+
evlet host add acme www.example.com --root site.www
|
|
529
|
+
evlet host add acme www.example.com --root site.www --apply
|
|
530
|
+
```
|
|
531
|
+
|
|
532
|
+
`host add` refuses a host that is not a public lowercase name, the primary host, or a root
|
|
533
|
+
that is not a static or server frontend of an installed app. The instance needs a domain. Then:
|
|
534
|
+
|
|
535
|
+
1. It checks the host's DNS like `evlet proxy --check` (with `--ip` or the address saved in
|
|
536
|
+
`deploy/server.json`). When the check fails, nothing is changed.
|
|
537
|
+
2. It adds `Host("www.example.com", root="site.www")` to `hosts` in `instances/acme/routes.py`,
|
|
538
|
+
creating the file if needed, and checks that the instance still starts with it. It edits only a
|
|
539
|
+
`hosts = (...)` tuple of `Host(...)` entries without comments; when `routes.py` sets `hosts` any
|
|
540
|
+
other way, it changes nothing and prints the line to add yourself.
|
|
541
|
+
3. It writes `deploy/evlet-acme.caddy`, the service unit and `deploy/evlet-global.caddy` again,
|
|
542
|
+
keeping the port of the unit in `deploy/` (or `--port`).
|
|
543
|
+
4. It prints the same `sudo` steps as `evlet setup --host`, plus a restart of the service, since the
|
|
544
|
+
instance reads `routes.py` when it starts. `--apply` runs them, each shown first.
|
|
545
|
+
|
|
546
|
+
`host remove` takes a host out of `routes.py` and rewrites the Caddy file the same way. `host list`
|
|
547
|
+
prints the primary host and each sub-host with its root frontend and sign-in realm.
|
|
548
|
+
|
|
549
|
+
With Caddy's on-demand TLS ([routing.md](routing.md#many-instances-on-one-server)) no Caddy file
|
|
550
|
+
changes: Caddy asks the instance before it gets a certificate. Then only `routes.py` and a restart
|
|
551
|
+
are needed:
|
|
552
|
+
|
|
553
|
+
```sh
|
|
554
|
+
evlet host add acme www.example.com --root site.www --routes-only
|
|
555
|
+
sudo systemctl restart evlet-acme
|
|
556
|
+
```
|
|
557
|
+
|
|
494
558
|
### Serve an instance behind Caddy
|
|
495
559
|
|
|
496
560
|
This is a minimal manual setup for one instance on one Linux server. It assumes
|
|
@@ -533,7 +597,9 @@ app.example.com {
|
|
|
533
597
|
}
|
|
534
598
|
```
|
|
535
599
|
|
|
536
|
-
`evlet proxy acme --caddy` prints this block for your hosts
|
|
600
|
+
`evlet proxy acme --caddy` prints this block for your hosts, after a global options block
|
|
601
|
+
that turns on `strict_sni_host`. Put that block first in `/etc/caddy/Caddyfile`, or add its
|
|
602
|
+
`servers :443 { strict_sni_host on }` lines to the global options block you have.
|
|
537
603
|
|
|
538
604
|
Caddy obtains the certificate and passes the original Host header, which must
|
|
539
605
|
match `domain`. Then run:
|
|
@@ -610,8 +676,34 @@ sources. Recovery reconciles the lock only when the database matches one of the
|
|
|
610
676
|
recorded states, then retries normal validation. Unknown mismatches fail closed
|
|
611
677
|
and require restoring the matching database, files, lock and app source together.
|
|
612
678
|
|
|
613
|
-
There are no automatic app update/removal, source checkout
|
|
614
|
-
|
|
679
|
+
There are no automatic app update/removal, source checkout or rollback commands. Use
|
|
680
|
+
[App upgrades](app-upgrades.md) for the supported workflow.
|
|
681
|
+
|
|
682
|
+
### Back up and restore
|
|
683
|
+
|
|
684
|
+
An instance keeps four SQLite files in `data/`: `database.sqlite3`, `sessions.sqlite3`,
|
|
685
|
+
`logs.sqlite3` and `eva.sqlite3` ([performance.md](performance.md#busy-writing-on-sqlite)).
|
|
686
|
+
They are one set.
|
|
687
|
+
|
|
688
|
+
`evlet backup --instance acme` copies all four into `data/backups/` as
|
|
689
|
+
`<time>.sqlite3`, `<time>-sessions.sqlite3`, `<time>-logs.sqlite3` and `<time>-eva.sqlite3`.
|
|
690
|
+
`--to DIR` writes them somewhere else. It uses SQLite's online backup API from one read
|
|
691
|
+
snapshot of the four files, so the server may keep running. It checks there is room first.
|
|
692
|
+
|
|
693
|
+
`evlet restore <backup> --instance acme` replaces the four files with a set. Give it the main
|
|
694
|
+
file of the set; it finds the others next to it. Stop the server first: restore holds the
|
|
695
|
+
instance lock and refuses while the instance is in use. It asks you to type the instance name;
|
|
696
|
+
`--yes acme` answers for automation and must name the same instance. The files it replaces are
|
|
697
|
+
copied into `data/backups/` first, named `<time>-before-restore`. `apps.lock` is set to what the
|
|
698
|
+
restored database says was installed, so run `evlet migrate acme` after restoring an older
|
|
699
|
+
backup.
|
|
700
|
+
|
|
701
|
+
A single-file backup from before 0.4.3, such as one `evlet migrate` wrote, restores too. Its
|
|
702
|
+
sessions, logs and Eva are still inside it, so restore clears the other three files and says to
|
|
703
|
+
run `evlet migrate acme`, which moves them out again before you serve.
|
|
704
|
+
|
|
705
|
+
Backups hold only the database. Keep `secret.key`, `files/` and the app sources with them.
|
|
706
|
+
Tools that remove or reset an instance can list the set with `evlet.writes.data_files(path)`.
|
|
615
707
|
Do not remove app source used by an instance. Calendar `@cron` schedules reconcile
|
|
616
708
|
changes while preserving operator-disabled state and history. Changing a legacy
|
|
617
709
|
interval schedule's task, payload or interval needs a later explicit
|
|
@@ -19,7 +19,7 @@ has no two-step sign-in, and nothing is listed for it.
|
|
|
19
19
|
the instance accepts counts as primary, except sub-hosts. So each tenant of a
|
|
20
20
|
`TenantApplication` manages its own users on its own host, in its own database.
|
|
21
21
|
- Only desk roles open Controls. Portal roles never do, whatever their settings.
|
|
22
|
-
- Every instance has the built-in **System Administrator** (username `
|
|
22
|
+
- Every instance has the built-in **System Administrator** (username `admin`, role
|
|
23
23
|
admin), like the Administrator in ERPNext. See [The Administrator](#the-administrator).
|
|
24
24
|
- Open to roles with "Opens Controls" on. `admin` always has it; it can't be turned off.
|
|
25
25
|
- Opening Controls is not the same as being admin. Only admins can give or remove the admin
|
|
@@ -65,16 +65,16 @@ has no two-step sign-in, and nothing is listed for it.
|
|
|
65
65
|
|
|
66
66
|
### The Administrator
|
|
67
67
|
|
|
68
|
-
Every instance has one account it creates itself: username `
|
|
68
|
+
Every instance has one account it creates itself: username `admin`, full name
|
|
69
69
|
"System Administrator", role admin, marked `builtin` in `evlet_users`. New databases get it at
|
|
70
70
|
startup. Older ones get it from the framework step `0008_administrator`, which `evlet migrate`
|
|
71
|
-
runs; if another account already uses the username `
|
|
71
|
+
runs; if another account already uses the username `admin`, the step stops with a
|
|
72
72
|
message and changes nothing, so rename that account first.
|
|
73
73
|
|
|
74
74
|
- It starts with **no password**, so nobody can sign in as it until one is set: through the
|
|
75
75
|
development sign-in link and the "Set your password" screen ([cli.md](cli.md#development-sign-in-links)),
|
|
76
|
-
with `evlet users set-password <instance>
|
|
77
|
-
setup in the browser by choosing `
|
|
76
|
+
with `evlet users set-password <instance> admin`, by an admin in Controls, or on first-run
|
|
77
|
+
setup in the browser by choosing `admin` as the username.
|
|
78
78
|
- Its username, full name and role never change, and it can't be deactivated or deleted. Every
|
|
79
79
|
route refuses with 409 "The Administrator account is built in...": Controls Users, the older
|
|
80
80
|
`/api/auth/users` routes and the profile (`/api/_settings/me/profile` and the photo answer 409
|
|
@@ -214,7 +214,7 @@ security = Security(password_min=8, admin_two_step=True, two_step=False, admin_s
|
|
|
214
214
|
| `password_min` | 15 | 1 to 64 characters. 1 means no rule: "1" is a valid password. |
|
|
215
215
|
| `admin_two_step` | `True` | Admin accounts, the Administrator too, must use two-step sign-in. Only config.py decides this. |
|
|
216
216
|
| `two_step` | `False` | Everyone else must use two-step sign-in. Controls can turn it on or off. |
|
|
217
|
-
| `admin_sign_in` | `False` | The sign-in page opens with the username `
|
|
217
|
+
| `admin_sign_in` | `False` | The sign-in page opens with the username `admin` filled in, so you type only the password (and a code when needed). |
|
|
218
218
|
| `session_hours` | 12 | 1 to 168. |
|
|
219
219
|
| `lockout` | 5 | 3 to 50. |
|
|
220
220
|
|
|
@@ -115,7 +115,7 @@ checks, use the job's [business context](#a-jobs-business-context).
|
|
|
115
115
|
## Queue a job from an action
|
|
116
116
|
|
|
117
117
|
An `@action` (or a Move `run` method, or any trusted code with a document context) queues a
|
|
118
|
-
registered task with `context.enqueue(task, payload, *, key=None, target=None)`:
|
|
118
|
+
registered task with `context.enqueue(task, payload, *, key=None, target=None, run_at=None)`:
|
|
119
119
|
|
|
120
120
|
```python
|
|
121
121
|
class PriceList(Model):
|
|
@@ -136,6 +136,7 @@ class PriceList(Model):
|
|
|
136
136
|
* An action that returns the receipt adds `_job` (`{"id", "state"}`) to its detail. It is not
|
|
137
137
|
part of the ETag. `GET /api/_jobs/<id>` follows it.
|
|
138
138
|
* `key=` deduplicates as with `JobQueue.enqueue`. The context must not be read only.
|
|
139
|
+
* `run_at=` (UTC seconds) delays the job: it stays queued until then.
|
|
139
140
|
|
|
140
141
|
`JobQueue.wake()` and `JobQueue.wait(timeout)` are the signal underneath, for app workers that
|
|
141
142
|
run their own loop: `wait` returns True when a committed transaction queued a job since the last
|
|
@@ -225,7 +226,13 @@ jobs = JobQueue(database, [Task('rebuild_balances', rebuild_balances, resumable=
|
|
|
225
226
|
The handler is called again and again until it returns `None`. Any other return value is the
|
|
226
227
|
checkpoint: JSON of at most 16 KiB, committed with that step's writes and progress, and given
|
|
227
228
|
to the next step as `context.checkpoint`. Each step is short, so it holds the database write
|
|
228
|
-
lock only briefly and other requests run between steps.
|
|
229
|
+
lock only briefly and other requests run between steps. On SQLite, writers in one process take
|
|
230
|
+
turns: a job step waits behind requests that came first, but never more than about a quarter of a
|
|
231
|
+
second, and after each step the job gives up its turn and joins the back of the line. While people
|
|
232
|
+
are writing, the job rests after each step for as long as the step took, so it gets about half of the
|
|
233
|
+
database's time and runs at full speed again when they stop. So a request
|
|
234
|
+
waits at most about one step, and a step that holds the database longer than a second logs a
|
|
235
|
+
warning naming the job ([performance.md](performance.md#busy-writing-on-sqlite)). Every step reloads the job, checks the
|
|
229
236
|
lease and rechecks the account and the target record, like the first one. Each committed step
|
|
230
237
|
also extends the claim's lease to at least 300 seconds from that step.
|
|
231
238
|
|
|
@@ -254,6 +261,32 @@ The Playground's **Rebuild all points balances** action on a customer queues `re
|
|
|
254
261
|
which recomputes every customer's balance from the points ledger 20 customers per step
|
|
255
262
|
([ledger.md](ledger.md)).
|
|
256
263
|
|
|
264
|
+
## Follow-up runs
|
|
265
|
+
|
|
266
|
+
A job can queue its own next run with `context.follow_up(tx, payload=None, *, run_at, key=None)`.
|
|
267
|
+
Use it for work that comes back later, such as checking a payment provider again in ten minutes,
|
|
268
|
+
instead of a schedule that runs every minute whether or not there is work:
|
|
269
|
+
|
|
270
|
+
```python
|
|
271
|
+
import time
|
|
272
|
+
|
|
273
|
+
def check_payment(tx, context, payload):
|
|
274
|
+
# Payment belongs to this application.
|
|
275
|
+
payment = tx.get(Payment, payload['payment'])
|
|
276
|
+
if payment.status == 'pending':
|
|
277
|
+
context.follow_up(tx, run_at=int(time.time()) + 600)
|
|
278
|
+
```
|
|
279
|
+
|
|
280
|
+
* The next run is written in the job's own transaction (the step's, for a resumable task). It is
|
|
281
|
+
queued only if this run commits; a run that fails and is retried does not leave one behind.
|
|
282
|
+
* `payload` defaults to this run's payload. `run_at` is UTC seconds; the worker claims it then.
|
|
283
|
+
* It runs with this job's identity: the same account (read again when it starts), the same API
|
|
284
|
+
key or AI assistant narrowing, or the same system role. It never runs as anyone else, such as
|
|
285
|
+
the Administrator.
|
|
286
|
+
* `key` defaults to one per job and `run_at`, so the same run queues the same follow-up only once.
|
|
287
|
+
Pass your own key to merge follow-ups from several runs.
|
|
288
|
+
* The next run is a new job with its own attempts and its own entry in Controls > Jobs.
|
|
289
|
+
|
|
257
290
|
## Schedules and operator commands
|
|
258
291
|
|
|
259
292
|
`jobs.schedule(name, task, payload, every=seconds, start_at=timestamp, user=user,
|