RubyGems - brut - Versions diffs - 0.17.0 → 0.18.1 - Mend

brut 0.17.0 → 0.18.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1103) hide show

checksums.yaml +4 -4
data/exe/brut +34 -0
data/lib/brut/cli/apps/build_assets.rb +78 -48
data/lib/brut/cli/apps/db.rb +168 -202
data/lib/brut/cli/apps/deploy.rb +291 -0
data/lib/brut/cli/apps/heroku_container_based_deploy.rb +6 -0
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/add_segment.rb +5 -5
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/add_segment_options.rb +1 -1
data/lib/brut/cli/apps/new/app.rb +240 -0
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/app_id.rb +1 -1
data/lib/brut/cli/apps/new/app_name.rb +29 -0
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/base.rb +9 -6
data/lib/brut/cli/apps/new/erb_binding_delegate.rb +23 -0
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/internet_identifier.rb +5 -5
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/invalid_identifier.rb +1 -1
data/{mkbrut/lib/mkbrut/app.rb → lib/brut/cli/apps/new/old_app.rb} +8 -11
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/ops/add_css_import.rb +1 -1
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/ops/add_i18n_message.rb +1 -1
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/ops/add_method.rb +1 -1
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/ops/append_to_file.rb +1 -1
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/ops/base_op.rb +3 -3
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/ops/copy_file.rb +1 -1
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/ops/insert_code_in_method.rb +1 -1
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/ops/insert_into_file.rb +1 -1
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/ops/insert_route.rb +1 -1
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/ops/mkdir.rb +1 -1
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/ops/prism_parsing_op.rb +1 -1
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/ops/render_template.rb +1 -1
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/ops/skip_file.rb +1 -1
data/lib/brut/cli/apps/new/ops.rb +17 -0
data/lib/brut/cli/apps/new/organization.rb +5 -0
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/prefix.rb +1 -1
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/segments/bare_bones.rb +12 -11
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/segments/demo.rb +16 -15
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/segments/heroku.rb +9 -5
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/segments/sidekiq.rb +44 -21
data/lib/brut/cli/apps/new/segments.rb +8 -0
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/versions.rb +3 -3
data/lib/brut/cli/apps/new.rb +26 -0
data/lib/brut/cli/apps/scaffold.rb +150 -141
data/lib/brut/cli/apps/test.rb +92 -68
data/lib/brut/cli/commands/base_command.rb +174 -0
data/lib/brut/cli/commands/compound_command.rb +29 -0
data/lib/brut/cli/commands/execution_context.rb +32 -0
data/lib/brut/cli/commands/help.rb +26 -0
data/lib/brut/cli/commands/output_error.rb +13 -0
data/lib/brut/cli/commands/raise_error.rb +11 -0
data/lib/brut/cli/commands.rb +8 -0
data/lib/brut/cli/execute_result.rb +39 -0
data/lib/brut/cli/executor.rb +9 -4
data/lib/brut/cli/output.rb +13 -0
data/lib/brut/cli/parsed_command_line.rb +143 -0
data/lib/brut/cli/runner.rb +124 -0
data/lib/brut/cli.rb +7 -29
data/lib/brut/framework/container.rb +1 -1
data/lib/brut/framework/mcp.rb +59 -13
data/lib/brut/framework/project_environment.rb +3 -1
data/lib/brut/junk_drawer.rb +3 -1
data/lib/brut/spec_support/cli_command_support.rb +45 -0
data/lib/brut/spec_support/e2e_test_server.rb +3 -0
data/lib/brut/spec_support/general_support.rb +1 -1
data/lib/brut/spec_support/matchers/have_executed.rb +35 -0
data/lib/brut/spec_support/rspec_setup.rb +4 -8
data/lib/brut/spec_support.rb +1 -0
data/lib/brut/tui/markup_string.rb +2 -0
data/lib/brut/tui/script/events/command_std_out.rb +3 -2
data/lib/brut/tui/script/exec_step.rb +11 -4
data/lib/brut/tui/script/puts_subscriber.rb +4 -4
data/lib/brut/tui/script.rb +7 -3
data/lib/brut/tui/terminal_theme.rb +15 -11
data/lib/brut/version.rb +1 -1
data/templates/Base/.env.development.local +2 -0
data/templates/Base/bin/ci +42 -0
data/{mkbrut/templates → templates}/Base/bin/release +2 -2
data/templates/Base/bin/setup +174 -0
data/{mkbrut/templates → templates}/Base/bin/watch-and-build-assets +1 -1
data/{mkbrut/templates → templates}/Base/dx/docker-compose.env.erb +1 -1
data/{mkbrut/templates → templates}/segments/Demo/app/src/front_end/css/fonts.css +1 -1
data/{mkbrut/templates → templates}/segments/Heroku/deploy/Dockerfile +2 -2
data/templates/segments/Heroku/deploy/docker_config.rb +30 -0
metadata +190 -1055
data/.gitignore +0 -61
data/.projections.json +0 -10
data/CHANGELOG.md +0 -172
data/CODE_OF_CONDUCT.txt +0 -99
data/Dockerfile.dx +0 -82
data/Gemfile +0 -6
data/Gemfile.lock +0 -246
data/LICENSE.txt +0 -370
data/README.md +0 -90
data/Rakefile +0 -25
data/assets/Logo-Square.pxd +0 -0
data/assets/LogoPylon.pxd +0 -0
data/assets/LogoStop.pxd +0 -0
data/assets/LogoTall.pxd +0 -0
data/assets/MetroIcon.graffle +0 -0
data/assets/MetroLogo.graffle +0 -0
data/assets/SocialImage.png +0 -0
data/assets/SocialImage.pxd +0 -0
data/assets/YouTubeThumb.pxd +0 -0
data/bin/bin_kit.rb +0 -51
data/bin/build +0 -86
data/bin/ci +0 -40
data/bin/dev +0 -20
data/bin/docs +0 -86
data/bin/generate-and-run-rubocop +0 -52
data/bin/new-version +0 -8
data/bin/publish +0 -61
data/bin/rake +0 -27
data/bin/rspec +0 -27
data/bin/rubocop +0 -27
data/bin/setup +0 -252
data/bin/test +0 -18
data/brut-css/.nvim.lua +0 -1
data/brut-css/README.md +0 -28
data/brut-css/bin/build +0 -50
data/brut-css/bin/ci +0 -19
data/brut-css/bin/dev +0 -1
data/brut-css/bin/docs +0 -34
data/brut-css/bin/publish +0 -21
data/brut-css/bin/setup +0 -6
data/brut-css/config/media-queries-all.css +0 -15
data/brut-css/config/media-queries-minimal.css +0 -5
data/brut-css/config/postcss.config.cjs +0 -7
data/brut-css/config/pseudo-classes-all.css +0 -9
data/brut-css/dx +0 -1
data/brut-css/package-lock.json +0 -3165
data/brut-css/package.json +0 -36
data/brut-css/src/css/appearance.css +0 -145
data/brut-css/src/css/border.css +0 -522
data/brut-css/src/css/colors.css +0 -3502
data/brut-css/src/css/dimensions.css +0 -548
data/brut-css/src/css/flex.css +0 -179
data/brut-css/src/css/index.css +0 -13
data/brut-css/src/css/layout.css +0 -120
data/brut-css/src/css/list.css +0 -41
data/brut-css/src/css/positioning.css +0 -354
data/brut-css/src/css/properties/colors.css +0 -455
data/brut-css/src/css/properties/index.css +0 -3
data/brut-css/src/css/properties/spacing.css +0 -140
data/brut-css/src/css/properties/typography.css +0 -224
data/brut-css/src/css/reset.css +0 -107
data/brut-css/src/css/spacing.css +0 -585
data/brut-css/src/css/typography.css +0 -519
data/brut-css/src/css/utils.css +0 -104
data/brut-css/src/docs/1_getting-started/1_overview.md +0 -46
data/brut-css/src/docs/1_getting-started/2_installation.md +0 -25
data/brut-css/src/docs/1_getting-started/3_core-concepts.md +0 -75
data/brut-css/src/docs/1_getting-started/4_simple-example.md +0 -132
data/brut-css/src/docs/1_getting-started/page.html.ejs +0 -10
data/brut-css/src/docs/2_properties/page.html.ejs +0 -71
data/brut-css/src/docs/3_classes/color-demo.html.ejs +0 -31
data/brut-css/src/docs/3_classes/page.html.ejs +0 -87
data/brut-css/src/docs/4_customization/1_design-system.md +0 -36
data/brut-css/src/docs/4_customization/2_breakpoints.md +0 -75
data/brut-css/src/docs/4_customization/3_pseudo-classes.md +0 -74
data/brut-css/src/docs/4_customization/4_advanced-configuration.md +0 -40
data/brut-css/src/docs/4_customization/page.html.ejs +0 -10
data/brut-css/src/docs/docs.css +0 -98
data/brut-css/src/docs/includes/body-and-header.html.ejs +0 -30
data/brut-css/src/docs/includes/footer-and-rest.html.ejs +0 -9
data/brut-css/src/docs/includes/head.html.ejs +0 -5
data/brut-css/src/docs/includes/nav.html.ejs +0 -10
data/brut-css/src/docs/index.html.ejs +0 -32
data/brut-css/src/docs/prism-twilight.min.css +0 -1
data/brut-css/src/js/Logger.js +0 -71
data/brut-css/src/js/build.js +0 -111
data/brut-css/src/js/cli/CLIArgError.js +0 -7
data/brut-css/src/js/cli/Debug.js +0 -27
data/brut-css/src/js/cli/DocsDir.js +0 -16
data/brut-css/src/js/cli/DocsTemplateSourceDir.js +0 -16
data/brut-css/src/js/cli/InputFile.js +0 -31
data/brut-css/src/js/cli/MediaQueryConfigFile.js +0 -10
data/brut-css/src/js/cli/OutputFile.js +0 -22
data/brut-css/src/js/cli/ParsedArg.js +0 -17
data/brut-css/src/js/cli/PathToBrutCSSRoot.js +0 -19
data/brut-css/src/js/cli/PseudoClassConfigFile.js +0 -11
data/brut-css/src/js/cli.js +0 -108
data/brut-css/src/js/docGenerator.js +0 -467
data/brut-css/src/js/mediaQueryConfigParser.js +0 -98
data/brut-css/src/js/post-css-plugins/addMediaQueriesPlugin.js +0 -49
data/brut-css/src/js/post-css-plugins/addPseudoClassesPlugin.js +0 -42
data/brut-css/src/js/post-css-plugins/generateDocumentationPlugin/Category.js +0 -9
data/brut-css/src/js/post-css-plugins/generateDocumentationPlugin/DocState.js +0 -185
data/brut-css/src/js/post-css-plugins/generateDocumentationPlugin/Documentable.js +0 -8
data/brut-css/src/js/post-css-plugins/generateDocumentationPlugin/Group.js +0 -7
data/brut-css/src/js/post-css-plugins/generateDocumentationPlugin/ParsedComment.js +0 -73
data/brut-css/src/js/post-css-plugins/generateDocumentationPlugin/Property.js +0 -9
data/brut-css/src/js/post-css-plugins/generateDocumentationPlugin/PropertyCategory.js +0 -4
data/brut-css/src/js/post-css-plugins/generateDocumentationPlugin/PropertyGroup.js +0 -8
data/brut-css/src/js/post-css-plugins/generateDocumentationPlugin/Rule.js +0 -12
data/brut-css/src/js/post-css-plugins/generateDocumentationPlugin/RuleCategory.js +0 -4
data/brut-css/src/js/post-css-plugins/generateDocumentationPlugin/RuleGroup.js +0 -8
data/brut-css/src/js/post-css-plugins/generateDocumentationPlugin/SeeRef.js +0 -5
data/brut-css/src/js/post-css-plugins/generateDocumentationPlugin/SeeURL.js +0 -9
data/brut-css/src/js/post-css-plugins/generateDocumentationPlugin.js +0 -49
data/brut-css/src/js/post-css-plugins/generateRootCustomPropertiesPlugin.js +0 -45
data/brut-css/src/js/pseudoClassConfigParser.js +0 -145
data/brut-js/.projections.json +0 -10
data/brut-js/README.md +0 -118
data/brut-js/bin/build +0 -19
data/brut-js/bin/ci +0 -5
data/brut-js/bin/docs +0 -25
data/brut-js/bin/publish +0 -21
data/brut-js/bin/setup +0 -6
data/brut-js/docs/README.md +0 -8
data/brut-js/docs/jsdoc-plugins/customElementTag.js +0 -8
data/brut-js/docs/jsdoc-theme/publish.js +0 -692
data/brut-js/docs/jsdoc-theme/static/scripts/linenumber.js +0 -25
data/brut-js/docs/jsdoc-theme/static/scripts/prettify/Apache-License-2.0.txt +0 -202
data/brut-js/docs/jsdoc-theme/static/scripts/prettify/lang-css.js +0 -2
data/brut-js/docs/jsdoc-theme/static/scripts/prettify/prettify.js +0 -28
data/brut-js/docs/jsdoc-theme/static/styles/jsdoc-default.css +0 -327
data/brut-js/docs/jsdoc-theme/static/styles/prettify-jsdoc.css +0 -111
data/brut-js/docs/jsdoc-theme/static/styles/prettify-tomorrow.css +0 -132
data/brut-js/docs/jsdoc-theme/tmpl/augments.tmpl +0 -10
data/brut-js/docs/jsdoc-theme/tmpl/container.tmpl +0 -199
data/brut-js/docs/jsdoc-theme/tmpl/details.tmpl +0 -143
data/brut-js/docs/jsdoc-theme/tmpl/example.tmpl +0 -2
data/brut-js/docs/jsdoc-theme/tmpl/examples.tmpl +0 -13
data/brut-js/docs/jsdoc-theme/tmpl/exceptions.tmpl +0 -32
data/brut-js/docs/jsdoc-theme/tmpl/layout.tmpl +0 -38
data/brut-js/docs/jsdoc-theme/tmpl/mainpage.tmpl +0 -14
data/brut-js/docs/jsdoc-theme/tmpl/members.tmpl +0 -38
data/brut-js/docs/jsdoc-theme/tmpl/method.tmpl +0 -131
data/brut-js/docs/jsdoc-theme/tmpl/modifies.tmpl +0 -14
data/brut-js/docs/jsdoc-theme/tmpl/params.tmpl +0 -131
data/brut-js/docs/jsdoc-theme/tmpl/properties.tmpl +0 -108
data/brut-js/docs/jsdoc-theme/tmpl/returns.tmpl +0 -19
data/brut-js/docs/jsdoc-theme/tmpl/source.tmpl +0 -8
data/brut-js/docs/jsdoc-theme/tmpl/tutorial.tmpl +0 -19
data/brut-js/docs/jsdoc-theme/tmpl/type.tmpl +0 -7
data/brut-js/docs/jsdoc.config.json +0 -23
data/brut-js/docs/package-lock.json +0 -343
data/brut-js/docs/package.json +0 -7
data/brut-js/dx +0 -1
data/brut-js/package-lock.json +0 -2210
data/brut-js/package.json +0 -36
data/brut-js/specs/AjaxSubmit.spec.js +0 -453
data/brut-js/specs/Autosubmit.spec.js +0 -127
data/brut-js/specs/ConfirmSubmit.spec.js +0 -224
data/brut-js/specs/ConstraintViolationMessage.spec.js +0 -33
data/brut-js/specs/ConstraintViolationMessages.spec.js +0 -32
data/brut-js/specs/CopyToClipboard.spec.js +0 -35
data/brut-js/specs/Form.spec.js +0 -137
data/brut-js/specs/I18nTranslation.spec.js +0 -19
data/brut-js/specs/LocaleDetection.spec.js +0 -22
data/brut-js/specs/Message.spec.js +0 -15
data/brut-js/specs/SpecHelper.js +0 -23
data/brut-js/specs/Tabs.spec.js +0 -41
data/brut-js/specs/Toast.spec.js +0 -34
data/brut-js/specs/config/asset_metadata.json +0 -7
data/brut-js/src/AjaxSubmit.js +0 -499
data/brut-js/src/Autosubmit.js +0 -63
data/brut-js/src/BaseCustomElement.js +0 -261
data/brut-js/src/ConfirmSubmit.js +0 -137
data/brut-js/src/ConfirmationDialog.js +0 -143
data/brut-js/src/ConstraintViolationMessage.js +0 -140
data/brut-js/src/ConstraintViolationMessages.js +0 -98
data/brut-js/src/CopyToClipboard.js +0 -96
data/brut-js/src/Form.js +0 -147
data/brut-js/src/I18nTranslation.js +0 -64
data/brut-js/src/LocaleDetection.js +0 -117
data/brut-js/src/Logger.js +0 -90
data/brut-js/src/Message.js +0 -62
data/brut-js/src/RichString.js +0 -116
data/brut-js/src/Tabs.js +0 -168
data/brut-js/src/Toast.js +0 -102
data/brut-js/src/Tracing.js +0 -247
data/brut-js/src/appForTestingOnly.js +0 -15
data/brut-js/src/index.js +0 -133
data/brut-js/src/testing/AssetMetadata.js +0 -35
data/brut-js/src/testing/AssetMetadataLoader.js +0 -25
data/brut-js/src/testing/CustomElementTest.js +0 -235
data/brut-js/src/testing/DOMCreator.js +0 -45
data/brut-js/src/testing/index.js +0 -48
data/brut.gemspec +0 -73
data/brutrb.com/.vitepress/config.mjs +0 -164
data/brutrb.com/.vitepress/plugins/jsdocLinker.js +0 -34
data/brutrb.com/.vitepress/plugins/rdocLinker.js +0 -18
data/brutrb.com/.vitepress/theme/custom.css +0 -14
data/brutrb.com/.vitepress/theme/index.js +0 -18
data/brutrb.com/.vitepress/theme/style.css +0 -139
data/brutrb.com/adrs.md +0 -16
data/brutrb.com/ai.md +0 -68
data/brutrb.com/assets.md +0 -131
data/brutrb.com/bin/build +0 -5
data/brutrb.com/bin/deploy +0 -7
data/brutrb.com/bin/dev +0 -5
data/brutrb.com/bin/setup +0 -6
data/brutrb.com/brut-js.md +0 -128
data/brutrb.com/business-logic.md +0 -55
data/brutrb.com/cli.md +0 -274
data/brutrb.com/components.md +0 -265
data/brutrb.com/configuration.md +0 -256
data/brutrb.com/css.md +0 -103
data/brutrb.com/custom-element-tests.md +0 -148
data/brutrb.com/database-access.md +0 -201
data/brutrb.com/database-schema.md +0 -320
data/brutrb.com/deployment.md +0 -158
data/brutrb.com/dev-environment.md +0 -186
data/brutrb.com/dir-structure.md +0 -120
data/brutrb.com/doc-conventions.md +0 -41
data/brutrb.com/dx +0 -1
data/brutrb.com/end-to-end-tests.md +0 -176
data/brutrb.com/features.md +0 -373
data/brutrb.com/flash-and-session.md +0 -208
data/brutrb.com/form-constraints.md +0 -266
data/brutrb.com/forms.md +0 -238
data/brutrb.com/getting-started.md +0 -142
data/brutrb.com/handlers.md +0 -177
data/brutrb.com/hooks.md +0 -176
data/brutrb.com/i18n.md +0 -190
data/brutrb.com/images/DevEnvironment.graffle +0 -0
data/brutrb.com/images/DevEnvironment.png +0 -0
data/brutrb.com/images/LogoSquare.png +0 -0
data/brutrb.com/images/LogoStop.png +0 -0
data/brutrb.com/images/LogoTall.png +0 -0
data/brutrb.com/images/Makefile +0 -10
data/brutrb.com/images/OverviewMetro.graffle +0 -0
data/brutrb.com/images/OverviewMetro.png +0 -0
data/brutrb.com/images/dev-env-overview.dot +0 -54
data/brutrb.com/images/dev-env-overview.png +0 -0
data/brutrb.com/images/dev-env-protocol.dot +0 -37
data/brutrb.com/images/dev-env-protocol.png +0 -0
data/brutrb.com/images/overview.graffle +0 -0
data/brutrb.com/images/overview.png +0 -0
data/brutrb.com/images/spa.dot +0 -19
data/brutrb.com/images/spa.png +0 -0
data/brutrb.com/images/tutorial/02-confirmation-dialog-browser-element-styled.png +0 -0
data/brutrb.com/images/tutorial/02-confirmation-dialog-browser-element.png +0 -0
data/brutrb.com/images/tutorial/02-confirmation-dialog-browser.png +0 -0
data/brutrb.com/images/tutorial/02-confirmation-flow.graffle +0 -0
data/brutrb.com/images/tutorial/02-confirmation-flow.png +0 -0
data/brutrb.com/images/tutorial/basic-form-with-violations.png +0 -0
data/brutrb.com/images/tutorial/basic-form.png +0 -0
data/brutrb.com/images/tutorial/initial-home-page.png +0 -0
data/brutrb.com/images/tutorial/new-post-editor.png +0 -0
data/brutrb.com/images/tutorial/new-post-home-page.png +0 -0
data/brutrb.com/images/tutorial/styled-form-with-server-side-violations.png +0 -0
data/brutrb.com/images/tutorial/styled-form-with-violations.png +0 -0
data/brutrb.com/images/tutorial/styled-home-page-with-posts.png +0 -0
data/brutrb.com/images/tutorial/styled-home-page.png +0 -0
data/brutrb.com/images/tutorial/welcome-to-brut.png +0 -0
data/brutrb.com/images/workspace-protocol.dot +0 -44
data/brutrb.com/images/workspace-protocol.png +0 -0
data/brutrb.com/index.md +0 -34
data/brutrb.com/instrumentation.md +0 -331
data/brutrb.com/javascript.md +0 -122
data/brutrb.com/jobs.md +0 -114
data/brutrb.com/keyword-injection.md +0 -195
data/brutrb.com/layouts.md +0 -156
data/brutrb.com/lsp.md +0 -23
data/brutrb.com/markdown-examples.md +0 -85
data/brutrb.com/middleware.md +0 -80
data/brutrb.com/overview.md +0 -68
data/brutrb.com/package-lock.json +0 -2451
data/brutrb.com/package.json +0 -11
data/brutrb.com/pages.md +0 -290
data/brutrb.com/public/SocialImage.png +0 -0
data/brutrb.com/public/favicon.ico +0 -0
data/brutrb.com/recipes/alternate-layouts.md +0 -32
data/brutrb.com/recipes/authentication.md +0 -336
data/brutrb.com/recipes/custom-flash.md +0 -51
data/brutrb.com/recipes/dev-env-secrets.md +0 -87
data/brutrb.com/recipes/form-errors.md +0 -148
data/brutrb.com/recipes/indexed-forms.md +0 -149
data/brutrb.com/recipes/migrations.md +0 -210
data/brutrb.com/recipes/text-field-component.md +0 -182
data/brutrb.com/roadmap.md +0 -52
data/brutrb.com/routes.md +0 -189
data/brutrb.com/security.md +0 -102
data/brutrb.com/seed-data.md +0 -63
data/brutrb.com/space-time-continuum.md +0 -81
data/brutrb.com/tutorial.md +0 -138
data/brutrb.com/tutorials/01-intro.md +0 -1654
data/brutrb.com/tutorials/02-dialog.md +0 -569
data/brutrb.com/unit-tests.md +0 -148
data/brutrb.com/why.md +0 -19
data/docker-compose.dx.yml +0 -25
data/docs/404.html +0 -26
data/docs/CNAME +0 -1
data/docs/SocialImage.png +0 -0
data/docs/adrs.html +0 -29
data/docs/ai.html +0 -29
data/docs/api/Brut/BackEnd/SeedData.html +0 -493
data/docs/api/Brut/BackEnd/Sidekiq/Middlewares/Server/FlushSpans.html +0 -214
data/docs/api/Brut/BackEnd/Sidekiq/Middlewares/Server.html +0 -125
data/docs/api/Brut/BackEnd/Sidekiq/Middlewares.html +0 -125
data/docs/api/Brut/BackEnd/Sidekiq.html +0 -125
data/docs/api/Brut/BackEnd/Validators/FormValidator.html +0 -414
data/docs/api/Brut/BackEnd/Validators.html +0 -128
data/docs/api/Brut/BackEnd.html +0 -132
data/docs/api/Brut/CLI/App.html +0 -1601
data/docs/api/Brut/CLI/AppRunner.html +0 -491
data/docs/api/Brut/CLI/Apps/BuildAssets/All.html +0 -264
data/docs/api/Brut/CLI/Apps/BuildAssets/CSS.html +0 -306
data/docs/api/Brut/CLI/Apps/BuildAssets/Images.html +0 -262
data/docs/api/Brut/CLI/Apps/BuildAssets/JS.html +0 -314
data/docs/api/Brut/CLI/Apps/BuildAssets.html +0 -183
data/docs/api/Brut/CLI/Apps/DB/Create.html +0 -365
data/docs/api/Brut/CLI/Apps/DB/Drop.html +0 -357
data/docs/api/Brut/CLI/Apps/DB/Migrate.html +0 -389
data/docs/api/Brut/CLI/Apps/DB/NewMigration.html +0 -339
data/docs/api/Brut/CLI/Apps/DB/Rebuild.html +0 -329
data/docs/api/Brut/CLI/Apps/DB/Seed.html +0 -347
data/docs/api/Brut/CLI/Apps/DB/Status.html +0 -383
data/docs/api/Brut/CLI/Apps/DB.html +0 -183
data/docs/api/Brut/CLI/Apps/DeployBase/GitChecks.html +0 -270
data/docs/api/Brut/CLI/Apps/DeployBase.html +0 -257
data/docs/api/Brut/CLI/Apps/HerokuContainerBasedDeploy/Deploy.html +0 -587
data/docs/api/Brut/CLI/Apps/HerokuContainerBasedDeploy.html +0 -196
data/docs/api/Brut/CLI/Apps/Scaffold/Action/Route.html +0 -303
data/docs/api/Brut/CLI/Apps/Scaffold/Action.html +0 -508
data/docs/api/Brut/CLI/Apps/Scaffold/Component.html +0 -398
data/docs/api/Brut/CLI/Apps/Scaffold/CustomElementTest.html +0 -374
data/docs/api/Brut/CLI/Apps/Scaffold/DbModel.html +0 -384
data/docs/api/Brut/CLI/Apps/Scaffold/E2ETest.html +0 -410
data/docs/api/Brut/CLI/Apps/Scaffold/Form.html +0 -262
data/docs/api/Brut/CLI/Apps/Scaffold/Page/Route.html +0 -303
data/docs/api/Brut/CLI/Apps/Scaffold/Page.html +0 -480
data/docs/api/Brut/CLI/Apps/Scaffold/RoutesEditor.html +0 -450
data/docs/api/Brut/CLI/Apps/Scaffold/Test.html +0 -380
data/docs/api/Brut/CLI/Apps/Scaffold.html +0 -253
data/docs/api/Brut/CLI/Apps/Test/Audit.html +0 -474
data/docs/api/Brut/CLI/Apps/Test/E2e.html +0 -407
data/docs/api/Brut/CLI/Apps/Test/JS.html +0 -262
data/docs/api/Brut/CLI/Apps/Test/Run.html +0 -578
data/docs/api/Brut/CLI/Apps/Test.html +0 -253
data/docs/api/Brut/CLI/Apps.html +0 -125
data/docs/api/Brut/CLI/Command.html +0 -2425
data/docs/api/Brut/CLI/Error.html +0 -139
data/docs/api/Brut/CLI/ExecutionResults/Result.html +0 -664
data/docs/api/Brut/CLI/ExecutionResults.html +0 -675
data/docs/api/Brut/CLI/Executor.html +0 -561
data/docs/api/Brut/CLI/InvalidOption.html +0 -245
data/docs/api/Brut/CLI/Options.html +0 -880
data/docs/api/Brut/CLI/Output.html +0 -699
data/docs/api/Brut/CLI/SystemExecError.html +0 -451
data/docs/api/Brut/CLI.html +0 -263
data/docs/api/Brut/FactoryBot.html +0 -225
data/docs/api/Brut/Framework/App.html +0 -1097
data/docs/api/Brut/Framework/Config.html +0 -1071
data/docs/api/Brut/Framework/Container.html +0 -1464
data/docs/api/Brut/Framework/Error.html +0 -140
data/docs/api/Brut/Framework/Errors/AbstractMethod.html +0 -232
data/docs/api/Brut/Framework/Errors/Bug.html +0 -234
data/docs/api/Brut/Framework/Errors/MissingConfiguration.html +0 -257
data/docs/api/Brut/Framework/Errors/MissingParameter.html +0 -273
data/docs/api/Brut/Framework/Errors/NoClassForPath.html +0 -471
data/docs/api/Brut/Framework/Errors/NotFound.html +0 -308
data/docs/api/Brut/Framework/Errors/NotImplemented.html +0 -234
data/docs/api/Brut/Framework/Errors.html +0 -351
data/docs/api/Brut/Framework/FussyTypeEnforcement.html +0 -392
data/docs/api/Brut/Framework/MCP.html +0 -871
data/docs/api/Brut/Framework/ProjectEnvironment.html +0 -648
data/docs/api/Brut/Framework.html +0 -129
data/docs/api/Brut/FrontEnd/AssetPathResolver.html +0 -317
data/docs/api/Brut/FrontEnd/Component/Helpers.html +0 -420
data/docs/api/Brut/FrontEnd/Component.html +0 -434
data/docs/api/Brut/FrontEnd/Components/ConstraintViolations.html +0 -491
data/docs/api/Brut/FrontEnd/Components/FormTag.html +0 -526
data/docs/api/Brut/FrontEnd/Components/I18nTranslations.html +0 -313
data/docs/api/Brut/FrontEnd/Components/Input.html +0 -195
data/docs/api/Brut/FrontEnd/Components/Inputs/ButtonTag.html +0 -447
data/docs/api/Brut/FrontEnd/Components/Inputs/CsrfToken.html +0 -339
data/docs/api/Brut/FrontEnd/Components/Inputs/InputTag.html +0 -568
data/docs/api/Brut/FrontEnd/Components/Inputs/RadioButton.html +0 -419
data/docs/api/Brut/FrontEnd/Components/Inputs/SelectTagWithOptions.html +0 -610
data/docs/api/Brut/FrontEnd/Components/Inputs/TextareaTag.html +0 -534
data/docs/api/Brut/FrontEnd/Components/Inputs.html +0 -125
data/docs/api/Brut/FrontEnd/Components/LocaleDetection.html +0 -367
data/docs/api/Brut/FrontEnd/Components/PageIdentifier.html +0 -355
data/docs/api/Brut/FrontEnd/Components/TimeTag.html +0 -655
data/docs/api/Brut/FrontEnd/Components/Traceparent.html +0 -352
data/docs/api/Brut/FrontEnd/Components.html +0 -156
data/docs/api/Brut/FrontEnd/CsrfProtector.html +0 -250
data/docs/api/Brut/FrontEnd/Download.html +0 -467
data/docs/api/Brut/FrontEnd/Flash.html +0 -1150
data/docs/api/Brut/FrontEnd/Form.html +0 -1227
data/docs/api/Brut/FrontEnd/Forms/Button.html +0 -331
data/docs/api/Brut/FrontEnd/Forms/ButtonInputDefinition.html +0 -537
data/docs/api/Brut/FrontEnd/Forms/ConstraintViolation.html +0 -590
data/docs/api/Brut/FrontEnd/Forms/Input/Color.html +0 -201
data/docs/api/Brut/FrontEnd/Forms/Input/TimeOfDay.html +0 -535
data/docs/api/Brut/FrontEnd/Forms/Input.html +0 -1567
data/docs/api/Brut/FrontEnd/Forms/InputDeclarations.html +0 -635
data/docs/api/Brut/FrontEnd/Forms/InputDefinition.html +0 -1336
data/docs/api/Brut/FrontEnd/Forms/RadioButtonGroupInput.html +0 -730
data/docs/api/Brut/FrontEnd/Forms/RadioButtonGroupInputDefinition.html +0 -587
data/docs/api/Brut/FrontEnd/Forms/SelectInput.html +0 -734
data/docs/api/Brut/FrontEnd/Forms/SelectInputDefinition.html +0 -582
data/docs/api/Brut/FrontEnd/Forms/ValidityState.html +0 -659
data/docs/api/Brut/FrontEnd/Forms.html +0 -127
data/docs/api/Brut/FrontEnd/GenericResponse.html +0 -377
data/docs/api/Brut/FrontEnd/Handler.html +0 -442
data/docs/api/Brut/FrontEnd/Handlers/CspReportingHandler.html +0 -318
data/docs/api/Brut/FrontEnd/Handlers/InstrumentationHandler/TraceParent.html +0 -336
data/docs/api/Brut/FrontEnd/Handlers/InstrumentationHandler.html +0 -399
data/docs/api/Brut/FrontEnd/Handlers/LocaleDetectionHandler.html +0 -354
data/docs/api/Brut/FrontEnd/Handlers/MissingHandler/Form.html +0 -151
data/docs/api/Brut/FrontEnd/Handlers/MissingHandler.html +0 -315
data/docs/api/Brut/FrontEnd/Handlers.html +0 -125
data/docs/api/Brut/FrontEnd/HandlingResults.html +0 -339
data/docs/api/Brut/FrontEnd/HttpMethod.html +0 -661
data/docs/api/Brut/FrontEnd/HttpStatus.html +0 -496
data/docs/api/Brut/FrontEnd/InlineSvgLocator.html +0 -284
data/docs/api/Brut/FrontEnd/Layout.html +0 -486
data/docs/api/Brut/FrontEnd/Middleware.html +0 -135
data/docs/api/Brut/FrontEnd/Middlewares/AnnotateBrutOwnedPaths.html +0 -288
data/docs/api/Brut/FrontEnd/Middlewares/Favicon.html +0 -292
data/docs/api/Brut/FrontEnd/Middlewares/OpenTelemetrySpan.html +0 -324
data/docs/api/Brut/FrontEnd/Middlewares/ReloadApp.html +0 -376
data/docs/api/Brut/FrontEnd/Middlewares.html +0 -125
data/docs/api/Brut/FrontEnd/Page.html +0 -781
data/docs/api/Brut/FrontEnd/Pages/MissingPage.html +0 -797
data/docs/api/Brut/FrontEnd/Pages.html +0 -125
data/docs/api/Brut/FrontEnd/RequestContext.html +0 -1312
data/docs/api/Brut/FrontEnd/RouteHook.html +0 -424
data/docs/api/Brut/FrontEnd/RouteHooks/AgeFlash.html +0 -242
data/docs/api/Brut/FrontEnd/RouteHooks/CSPNoInlineScripts.html +0 -249
data/docs/api/Brut/FrontEnd/RouteHooks/CSPNoInlineStylesOrScripts/ReportOnly.html +0 -264
data/docs/api/Brut/FrontEnd/RouteHooks/CSPNoInlineStylesOrScripts.html +0 -261
data/docs/api/Brut/FrontEnd/RouteHooks/LocaleDetection.html +0 -284
data/docs/api/Brut/FrontEnd/RouteHooks/SetupRequestContext.html +0 -252
data/docs/api/Brut/FrontEnd/RouteHooks.html +0 -115
data/docs/api/Brut/FrontEnd/Routing/FormHandlerRoute.html +0 -227
data/docs/api/Brut/FrontEnd/Routing/FormRoute.html +0 -305
data/docs/api/Brut/FrontEnd/Routing/MissingForm.html +0 -324
data/docs/api/Brut/FrontEnd/Routing/MissingHandler.html +0 -319
data/docs/api/Brut/FrontEnd/Routing/MissingPage.html +0 -315
data/docs/api/Brut/FrontEnd/Routing/MissingPath.html +0 -315
data/docs/api/Brut/FrontEnd/Routing/PageRoute.html +0 -327
data/docs/api/Brut/FrontEnd/Routing/Route.html +0 -761
data/docs/api/Brut/FrontEnd/Routing.html +0 -927
data/docs/api/Brut/FrontEnd/Session.html +0 -1195
data/docs/api/Brut/FrontEnd.html +0 -134
data/docs/api/Brut/I18n/BaseMethods.html +0 -931
data/docs/api/Brut/I18n/ForBackEnd.html +0 -302
data/docs/api/Brut/I18n/ForCLI.html +0 -302
data/docs/api/Brut/I18n/ForHTML.html +0 -296
data/docs/api/Brut/I18n/HTTPAcceptLanguage/AlwaysEnglish.html +0 -316
data/docs/api/Brut/I18n/HTTPAcceptLanguage.html +0 -930
data/docs/api/Brut/I18n.html +0 -127
data/docs/api/Brut/Instrumentation/LoggerSpanExporter.html +0 -435
data/docs/api/Brut/Instrumentation/Methods/ClassMethods.html +0 -596
data/docs/api/Brut/Instrumentation/Methods.html +0 -173
data/docs/api/Brut/Instrumentation/OpenTelemetry/NormalizedAttributes.html +0 -286
data/docs/api/Brut/Instrumentation/OpenTelemetry/Span.html +0 -302
data/docs/api/Brut/Instrumentation/OpenTelemetry.html +0 -866
data/docs/api/Brut/Instrumentation.html +0 -128
data/docs/api/Brut/RubocopConfig.html +0 -237
data/docs/api/Brut/SinatraHelpers/ClassMethods.html +0 -534
data/docs/api/Brut/SinatraHelpers.html +0 -281
data/docs/api/Brut/SpecSupport/ClockSupport.html +0 -383
data/docs/api/Brut/SpecSupport/ComponentSupport.html +0 -496
data/docs/api/Brut/SpecSupport/E2ETestServer.html +0 -503
data/docs/api/Brut/SpecSupport/E2eSupport.html +0 -142
data/docs/api/Brut/SpecSupport/EnhancedNode.html +0 -403
data/docs/api/Brut/SpecSupport/FlashSupport.html +0 -278
data/docs/api/Brut/SpecSupport/GeneralSupport/ClassMethods.html +0 -401
data/docs/api/Brut/SpecSupport/GeneralSupport.html +0 -195
data/docs/api/Brut/SpecSupport/HandlerSupport.html +0 -160
data/docs/api/Brut/SpecSupport/Matchers/BeABug.html +0 -142
data/docs/api/Brut/SpecSupport/Matchers/BePageFor.html +0 -142
data/docs/api/Brut/SpecSupport/Matchers/BeRoutingFor.html +0 -155
data/docs/api/Brut/SpecSupport/Matchers/HaveConstraintViolation.html +0 -583
data/docs/api/Brut/SpecSupport/Matchers/HaveGenerated.html +0 -149
data/docs/api/Brut/SpecSupport/Matchers/HaveHTMLAttribute.html +0 -466
data/docs/api/Brut/SpecSupport/Matchers/HaveI18nString.html +0 -149
data/docs/api/Brut/SpecSupport/Matchers/HaveLinkTo.html +0 -149
data/docs/api/Brut/SpecSupport/Matchers/HaveRedirectedTo.html +0 -165
data/docs/api/Brut/SpecSupport/Matchers/HaveReturnedHttpStatus.html +0 -158
data/docs/api/Brut/SpecSupport/Matchers/HaveReturnedRackResponse.html +0 -156
data/docs/api/Brut/SpecSupport/Matchers.html +0 -125
data/docs/api/Brut/SpecSupport/RSpecSetup/OptionalSidekiqSupport.html +0 -335
data/docs/api/Brut/SpecSupport/RSpecSetup.html +0 -637
data/docs/api/Brut/SpecSupport/SessionSupport.html +0 -196
data/docs/api/Brut/SpecSupport.html +0 -129
data/docs/api/Brut/TUI/AnsiEscapeCode/Mod.html +0 -409
data/docs/api/Brut/TUI/AnsiEscapeCode.html +0 -426
data/docs/api/Brut/TUI/EventLoop/Deque.html +0 -531
data/docs/api/Brut/TUI/EventLoop.html +0 -676
data/docs/api/Brut/TUI/Events/BaseEvent.html +0 -449
data/docs/api/Brut/TUI/Events/EventBus.html +0 -485
data/docs/api/Brut/TUI/Events/EventLoopStarted.html +0 -211
data/docs/api/Brut/TUI/Events/Exception.html +0 -523
data/docs/api/Brut/TUI/Events/Tick.html +0 -294
data/docs/api/Brut/TUI/Events.html +0 -131
data/docs/api/Brut/TUI/MarkupString.html +0 -537
data/docs/api/Brut/TUI/Script/BlockStep.html +0 -300
data/docs/api/Brut/TUI/Script/Events/CommandExecutionFailed.html +0 -252
data/docs/api/Brut/TUI/Script/Events/CommandExecutionSucceeded.html +0 -163
data/docs/api/Brut/TUI/Script/Events/CommandStdErr.html +0 -163
data/docs/api/Brut/TUI/Script/Events/CommandStdOut.html +0 -300
data/docs/api/Brut/TUI/Script/Events/ExecutingCommand.html +0 -298
data/docs/api/Brut/TUI/Script/Events/Message.html +0 -345
data/docs/api/Brut/TUI/Script/Events/PhaseCompleted.html +0 -229
data/docs/api/Brut/TUI/Script/Events/PhaseStarted.html +0 -350
data/docs/api/Brut/TUI/Script/Events/ScriptCompleted.html +0 -282
data/docs/api/Brut/TUI/Script/Events/ScriptStarted.html +0 -343
data/docs/api/Brut/TUI/Script/Events/StepCompleted.html +0 -163
data/docs/api/Brut/TUI/Script/Events/StepStarted.html +0 -346
data/docs/api/Brut/TUI/Script/Events.html +0 -115
data/docs/api/Brut/TUI/Script/ExecStep/ProcessStatusFailed.html +0 -210
data/docs/api/Brut/TUI/Script/ExecStep.html +0 -493
data/docs/api/Brut/TUI/Script/LoggingSubscriber.html +0 -914
data/docs/api/Brut/TUI/Script/PutsSubscriber.html +0 -783
data/docs/api/Brut/TUI/Script/Step.html +0 -313
data/docs/api/Brut/TUI/Script.html +0 -1250
data/docs/api/Brut/TUI/Terminal.html +0 -593
data/docs/api/Brut/TUI/TerminalTheme.html +0 -1403
data/docs/api/Brut/TUI/Themes/Dark.html +0 -706
data/docs/api/Brut/TUI/Themes/Light.html +0 -804
data/docs/api/Brut/TUI/Themes/None.html +0 -218
data/docs/api/Brut/TUI/Themes.html +0 -115
data/docs/api/Brut/TUI.html +0 -129
data/docs/api/Brut.html +0 -341
data/docs/api/Clock.html +0 -603
data/docs/api/ModuleName.html +0 -595
data/docs/api/RichString.html +0 -775
data/docs/api/SemanticLogger/Appender/Async.html +0 -219
data/docs/api/Sequel/Extensions/BrutInstrumentation.html +0 -119
data/docs/api/Sequel/Extensions/BrutMigrations.html +0 -541
data/docs/api/Sequel/Extensions.html +0 -117
data/docs/api/Sequel/Plugins/CreatedAt/InstanceMethods.html +0 -105
data/docs/api/Sequel/Plugins/CreatedAt.html +0 -125
data/docs/api/Sequel/Plugins/ExternalId/ClassMethods.html +0 -207
data/docs/api/Sequel/Plugins/ExternalId/InstanceMethods.html +0 -186
data/docs/api/Sequel/Plugins/ExternalId.html +0 -218
data/docs/api/Sequel/Plugins/FindBang/ClassMethods.html +0 -202
data/docs/api/Sequel/Plugins/FindBang.html +0 -125
data/docs/api/Sequel/Plugins.html +0 -117
data/docs/api/Sequel.html +0 -117
data/docs/api/SpecSupport/Matchers/BeABug.html +0 -143
data/docs/api/_index.html +0 -1964
data/docs/api/class_list.html +0 -54
data/docs/api/css/common.css +0 -1
data/docs/api/css/full_list.css +0 -59
data/docs/api/css/style.css +0 -504
data/docs/api/file.README.html +0 -172
data/docs/api/file_list.html +0 -59
data/docs/api/frames.html +0 -22
data/docs/api/index.html +0 -172
data/docs/api/js/app.js +0 -344
data/docs/api/js/full_list.js +0 -242
data/docs/api/js/jquery.js +0 -4
data/docs/api/method_list.html +0 -5542
data/docs/api/top-level-namespace.html +0 -112
data/docs/assets/02-confirmation-dialog-browser-element-styled.3NEGM20-.png +0 -0
data/docs/assets/02-confirmation-dialog-browser-element.DPsf0xUW.png +0 -0
data/docs/assets/02-confirmation-dialog-browser.DH8ALFO4.png +0 -0
data/docs/assets/02-confirmation-flow.D9gZ0S5U.png +0 -0
data/docs/assets/DevEnvironment.DaFcVfwP.png +0 -0
data/docs/assets/LogoStop.Gb3tDhL1.png +0 -0
data/docs/assets/OverviewMetro.DUS-5fUZ.png +0 -0
data/docs/assets/adrs.md.YglbWtQe.js +0 -1
data/docs/assets/adrs.md.YglbWtQe.lean.js +0 -1
data/docs/assets/ai.md.ChLnvDAX.js +0 -1
data/docs/assets/ai.md.ChLnvDAX.lean.js +0 -1
data/docs/assets/app.B8jAEB7R.js +0 -1
data/docs/assets/assets.md.BEF6Oz6K.js +0 -19
data/docs/assets/assets.md.BEF6Oz6K.lean.js +0 -1
data/docs/assets/basic-form-with-violations.Cv6Y9-Q_.png +0 -0
data/docs/assets/basic-form.DbHnu0oW.png +0 -0
data/docs/assets/brut-js.md.BMz0X1Rz.js +0 -12
data/docs/assets/brut-js.md.BMz0X1Rz.lean.js +0 -1
data/docs/assets/business-logic.md.DbuaOYGU.js +0 -1
data/docs/assets/business-logic.md.DbuaOYGU.lean.js +0 -1
data/docs/assets/chunks/@localSearchIndexroot.DJ8mocCj.js +0 -1
data/docs/assets/chunks/VPLocalSearchBox.gF-Po_fz.js +0 -8
data/docs/assets/chunks/framework.C4nOkCZI.js +0 -18
data/docs/assets/chunks/theme.BjPAOJkz.js +0 -2
data/docs/assets/cli.md.DDMar_51.js +0 -122
data/docs/assets/cli.md.DDMar_51.lean.js +0 -1
data/docs/assets/components.md.Ber8UBM0.js +0 -96
data/docs/assets/components.md.Ber8UBM0.lean.js +0 -1
data/docs/assets/configuration.md.DrJ6YVoZ.js +0 -78
data/docs/assets/configuration.md.DrJ6YVoZ.lean.js +0 -1
data/docs/assets/css.md.K5rOCOQY.js +0 -21
data/docs/assets/css.md.K5rOCOQY.lean.js +0 -1
data/docs/assets/custom-element-tests.md.DiLe-eFw.js +0 -69
data/docs/assets/custom-element-tests.md.DiLe-eFw.lean.js +0 -1
data/docs/assets/database-access.md.Dc8l2Plf.js +0 -63
data/docs/assets/database-access.md.Dc8l2Plf.lean.js +0 -1
data/docs/assets/database-schema.md.BJ_JhXmO.js +0 -70
data/docs/assets/database-schema.md.BJ_JhXmO.lean.js +0 -1
data/docs/assets/deployment.md.CHTx2eTR.js +0 -55
data/docs/assets/deployment.md.CHTx2eTR.lean.js +0 -1
data/docs/assets/dev-env-protocol.DysDAtnz.png +0 -0
data/docs/assets/dev-environment.md.B1S9p5ZK.js +0 -16
data/docs/assets/dev-environment.md.B1S9p5ZK.lean.js +0 -1
data/docs/assets/dir-structure.md.D1T2kGwj.js +0 -46
data/docs/assets/dir-structure.md.D1T2kGwj.lean.js +0 -1
data/docs/assets/doc-conventions.md.CDnWaEFg.js +0 -1
data/docs/assets/doc-conventions.md.CDnWaEFg.lean.js +0 -1
data/docs/assets/end-to-end-tests.md.BJJdNDYL.js +0 -28
data/docs/assets/end-to-end-tests.md.BJJdNDYL.lean.js +0 -1
data/docs/assets/features.md.BDWxnyNO.js +0 -154
data/docs/assets/features.md.BDWxnyNO.lean.js +0 -1
data/docs/assets/flash-and-session.md.CUsMxoNl.js +0 -79
data/docs/assets/flash-and-session.md.CUsMxoNl.lean.js +0 -1
data/docs/assets/form-constraints.md.KlfXSKm2.js +0 -90
data/docs/assets/form-constraints.md.KlfXSKm2.lean.js +0 -1
data/docs/assets/forms.md.RK0zkhm0.js +0 -64
data/docs/assets/forms.md.RK0zkhm0.lean.js +0 -1
data/docs/assets/getting-started.md.CGJ44juQ.js +0 -31
data/docs/assets/getting-started.md.CGJ44juQ.lean.js +0 -1
data/docs/assets/handlers.md.C5tUwmmo.js +0 -54
data/docs/assets/handlers.md.C5tUwmmo.lean.js +0 -1
data/docs/assets/hooks.md.CoiYCKRc.js +0 -80
data/docs/assets/hooks.md.CoiYCKRc.lean.js +0 -1
data/docs/assets/i18n.md.DxkCKhUw.js +0 -23
data/docs/assets/i18n.md.DxkCKhUw.lean.js +0 -1
data/docs/assets/index.md.DnphWyQd.js +0 -1
data/docs/assets/index.md.DnphWyQd.lean.js +0 -1
data/docs/assets/initial-home-page.DNIaYmgP.png +0 -0
data/docs/assets/instrumentation.md.BcxjC4jd.js +0 -90
data/docs/assets/instrumentation.md.BcxjC4jd.lean.js +0 -1
data/docs/assets/javascript.md.D6fxhaQb.js +0 -31
data/docs/assets/javascript.md.D6fxhaQb.lean.js +0 -1
data/docs/assets/jobs.md.Bi3qb3v6.js +0 -25
data/docs/assets/jobs.md.Bi3qb3v6.lean.js +0 -1
data/docs/assets/keyword-injection.md.CqLnnzIz.js +0 -21
data/docs/assets/keyword-injection.md.CqLnnzIz.lean.js +0 -1
data/docs/assets/layouts.md.HEbeK7Jr.js +0 -68
data/docs/assets/layouts.md.HEbeK7Jr.lean.js +0 -1
data/docs/assets/lsp.md.bE9dW8n9.js +0 -1
data/docs/assets/lsp.md.bE9dW8n9.lean.js +0 -1
data/docs/assets/markdown-examples.md.BPmtHlc-.js +0 -33
data/docs/assets/markdown-examples.md.BPmtHlc-.lean.js +0 -1
data/docs/assets/middleware.md.BhOIsg59.js +0 -20
data/docs/assets/middleware.md.BhOIsg59.lean.js +0 -1
data/docs/assets/new-post-editor.DrHr-5oh.png +0 -0
data/docs/assets/new-post-home-page.Bm34lyMg.png +0 -0
data/docs/assets/overview.md.BpWAgPFH.js +0 -1
data/docs/assets/overview.md.BpWAgPFH.lean.js +0 -1
data/docs/assets/pages.md.B3sQXpEd.js +0 -45
data/docs/assets/pages.md.B3sQXpEd.lean.js +0 -1
data/docs/assets/recipes_alternate-layouts.md.C1QzVkA7.js +0 -22
data/docs/assets/recipes_alternate-layouts.md.C1QzVkA7.lean.js +0 -1
data/docs/assets/recipes_authentication.md.CyvoIW82.js +0 -157
data/docs/assets/recipes_authentication.md.CyvoIW82.lean.js +0 -1
data/docs/assets/recipes_custom-flash.md.6gFqf2uL.js +0 -26
data/docs/assets/recipes_custom-flash.md.6gFqf2uL.lean.js +0 -1
data/docs/assets/recipes_dev-env-secrets.md.DC_jVY9U.js +0 -12
data/docs/assets/recipes_dev-env-secrets.md.DC_jVY9U.lean.js +0 -1
data/docs/assets/recipes_form-errors.md.B5ptSzMO.js +0 -66
data/docs/assets/recipes_form-errors.md.B5ptSzMO.lean.js +0 -1
data/docs/assets/recipes_indexed-forms.md.BYYQGW2C.js +0 -74
data/docs/assets/recipes_indexed-forms.md.BYYQGW2C.lean.js +0 -1
data/docs/assets/recipes_migrations.md.Cid7-3cu.js +0 -97
data/docs/assets/recipes_migrations.md.Cid7-3cu.lean.js +0 -1
data/docs/assets/recipes_text-field-component.md.VhOsCtKI.js +0 -101
data/docs/assets/recipes_text-field-component.md.VhOsCtKI.lean.js +0 -1
data/docs/assets/roadmap.md.DqC1Y7Zt.js +0 -1
data/docs/assets/roadmap.md.DqC1Y7Zt.lean.js +0 -1
data/docs/assets/routes.md.C1dgIBtD.js +0 -21
data/docs/assets/routes.md.C1dgIBtD.lean.js +0 -1
data/docs/assets/security.md.Jn4SY1uK.js +0 -1
data/docs/assets/security.md.Jn4SY1uK.lean.js +0 -1
data/docs/assets/seed-data.md.UZW0WxYN.js +0 -14
data/docs/assets/seed-data.md.UZW0WxYN.lean.js +0 -1
data/docs/assets/spa.qejUdp-5.png +0 -0
data/docs/assets/space-time-continuum.md.D9rYGDFH.js +0 -1
data/docs/assets/space-time-continuum.md.D9rYGDFH.lean.js +0 -1
data/docs/assets/style.B1z60PPQ.css +0 -1
data/docs/assets/styled-form-with-server-side-violations.Bjxd8Dpv.png +0 -0
data/docs/assets/styled-form-with-violations.Bv_sa9tg.png +0 -0
data/docs/assets/styled-home-page-with-posts.Dd4kG89D.png +0 -0
data/docs/assets/styled-home-page.BzdI7dWz.png +0 -0
data/docs/assets/tutorial.md.BX6f6l00.js +0 -27
data/docs/assets/tutorial.md.BX6f6l00.lean.js +0 -1
data/docs/assets/tutorials_01-intro.md.CzZ3kpF_.js +0 -708
data/docs/assets/tutorials_01-intro.md.CzZ3kpF_.lean.js +0 -1
data/docs/assets/tutorials_02-dialog.md.DE5WfCXI.js +0 -274
data/docs/assets/tutorials_02-dialog.md.DE5WfCXI.lean.js +0 -1
data/docs/assets/unit-tests.md.vDsdBbO_.js +0 -13
data/docs/assets/unit-tests.md.vDsdBbO_.lean.js +0 -1
data/docs/assets/welcome-to-brut.VSWzl17-.png +0 -0
data/docs/assets/why.md.4WpxdrQ2.js +0 -1
data/docs/assets/why.md.4WpxdrQ2.lean.js +0 -1
data/docs/assets/workspace-protocol.C0gXsoDb.png +0 -0
data/docs/assets.html +0 -47
data/docs/brut-css/brut.css +0 -1
data/docs/brut-css/brut.max.css +0 -22372
data/docs/brut-css/classes/appearances.html +0 -783
data/docs/brut-css/classes/background-colors.html +0 -3529
data/docs/brut-css/classes/border-colors.html +0 -3529
data/docs/brut-css/classes/borders.html +0 -2293
data/docs/brut-css/classes/dimensions.html +0 -2581
data/docs/brut-css/classes/flex.html +0 -917
data/docs/brut-css/classes/foreground-colors.html +0 -3261
data/docs/brut-css/classes/junk-drawer.html +0 -431
data/docs/brut-css/classes/layout.html +0 -668
data/docs/brut-css/classes/lists.html +0 -331
data/docs/brut-css/classes/positioning.html +0 -1751
data/docs/brut-css/classes/spacings.html +0 -2633
data/docs/brut-css/classes/typography.html +0 -2206
data/docs/brut-css/customization/advanced-configuration.html +0 -204
data/docs/brut-css/customization/breakpoints.html +0 -227
data/docs/brut-css/customization/design-system.html +0 -197
data/docs/brut-css/customization/pseudo-classes.html +0 -228
data/docs/brut-css/docs.css +0 -98
data/docs/brut-css/getting-started/core-concepts.html +0 -234
data/docs/brut-css/getting-started/installation.html +0 -190
data/docs/brut-css/getting-started/overview.html +0 -210
data/docs/brut-css/getting-started/simple-example.html +0 -285
data/docs/brut-css/index.html +0 -193
data/docs/brut-css/prism-twilight.min.css +0 -1
data/docs/brut-css/properties/colors.html +0 -1548
data/docs/brut-css/properties/spacings.html +0 -614
data/docs/brut-css/properties/typography.html +0 -777
data/docs/brut-js/api/AjaxSubmit.html +0 -452
data/docs/brut-js/api/AjaxSubmit.js.html +0 -550
data/docs/brut-js/api/Autosubmit.html +0 -192
data/docs/brut-js/api/Autosubmit.js.html +0 -114
data/docs/brut-js/api/BaseCustomElement.html +0 -1091
data/docs/brut-js/api/BaseCustomElement.js.html +0 -312
data/docs/brut-js/api/BrutCustomElements.html +0 -172
data/docs/brut-js/api/BufferedLogger.html +0 -173
data/docs/brut-js/api/ConfirmSubmit.html +0 -286
data/docs/brut-js/api/ConfirmSubmit.js.html +0 -188
data/docs/brut-js/api/ConfirmationDialog.html +0 -425
data/docs/brut-js/api/ConfirmationDialog.js.html +0 -194
data/docs/brut-js/api/ConstraintViolationMessage.html +0 -498
data/docs/brut-js/api/ConstraintViolationMessage.js.html +0 -191
data/docs/brut-js/api/ConstraintViolationMessages.html +0 -590
data/docs/brut-js/api/ConstraintViolationMessages.js.html +0 -149
data/docs/brut-js/api/CopyToClipboard.html +0 -345
data/docs/brut-js/api/CopyToClipboard.js.html +0 -147
data/docs/brut-js/api/Form.html +0 -291
data/docs/brut-js/api/Form.js.html +0 -198
data/docs/brut-js/api/I18nTranslation.html +0 -409
data/docs/brut-js/api/I18nTranslation.js.html +0 -115
data/docs/brut-js/api/LocaleDetection.html +0 -312
data/docs/brut-js/api/LocaleDetection.js.html +0 -168
data/docs/brut-js/api/Logger.html +0 -702
data/docs/brut-js/api/Logger.js.html +0 -141
data/docs/brut-js/api/Message.html +0 -238
data/docs/brut-js/api/Message.js.html +0 -113
data/docs/brut-js/api/PrefixedLogger.html +0 -369
data/docs/brut-js/api/RichString.html +0 -1049
data/docs/brut-js/api/RichString.js.html +0 -167
data/docs/brut-js/api/Tabs.html +0 -295
data/docs/brut-js/api/Tabs.js.html +0 -219
data/docs/brut-js/api/Toast.html +0 -270
data/docs/brut-js/api/Toast.js.html +0 -153
data/docs/brut-js/api/Tracing.html +0 -277
data/docs/brut-js/api/Tracing.js.html +0 -298
data/docs/brut-js/api/external-CustomElementRegistry.html +0 -140
data/docs/brut-js/api/external-Performance.html +0 -138
data/docs/brut-js/api/external-Promise.html +0 -138
data/docs/brut-js/api/external-ValidityState.html +0 -138
data/docs/brut-js/api/external-Window.html +0 -233
data/docs/brut-js/api/external-fetch.html +0 -138
data/docs/brut-js/api/global.html +0 -400
data/docs/brut-js/api/index.html +0 -168
data/docs/brut-js/api/index.js.html +0 -184
data/docs/brut-js/api/module-testing.html +0 -383
data/docs/brut-js/api/scripts/linenumber.js +0 -25
data/docs/brut-js/api/scripts/prettify/Apache-License-2.0.txt +0 -202
data/docs/brut-js/api/scripts/prettify/lang-css.js +0 -2
data/docs/brut-js/api/scripts/prettify/prettify.js +0 -28
data/docs/brut-js/api/styles/jsdoc-default.css +0 -327
data/docs/brut-js/api/styles/prettify-jsdoc.css +0 -111
data/docs/brut-js/api/styles/prettify-tomorrow.css +0 -132
data/docs/brut-js/api/testing.AssetMetadata.html +0 -172
data/docs/brut-js/api/testing.AssetMetadataLoader.html +0 -171
data/docs/brut-js/api/testing.CustomElementTest.html +0 -679
data/docs/brut-js/api/testing.DOMCreator.html +0 -171
data/docs/brut-js/api/testing_AssetMetadata.js.html +0 -86
data/docs/brut-js/api/testing_AssetMetadataLoader.js.html +0 -76
data/docs/brut-js/api/testing_CustomElementTest.js.html +0 -286
data/docs/brut-js/api/testing_DOMCreator.js.html +0 -96
data/docs/brut-js/api/testing_index.js.html +0 -99
data/docs/brut-js.html +0 -40
data/docs/business-logic.html +0 -29
data/docs/cli.html +0 -150
data/docs/components.html +0 -124
data/docs/configuration.html +0 -106
data/docs/css.html +0 -49
data/docs/custom-element-tests.html +0 -97
data/docs/database-access.html +0 -91
data/docs/database-schema.html +0 -98
data/docs/deployment.html +0 -83
data/docs/dev-environment.html +0 -44
data/docs/dir-structure.html +0 -74
data/docs/doc-conventions.html +0 -29
data/docs/end-to-end-tests.html +0 -56
data/docs/favicon.ico +0 -0
data/docs/features.html +0 -182
data/docs/flash-and-session.html +0 -107
data/docs/form-constraints.html +0 -118
data/docs/forms.html +0 -92
data/docs/getting-started.html +0 -59
data/docs/handlers.html +0 -82
data/docs/hashmap.json +0 -1
data/docs/hooks.html +0 -108
data/docs/i18n.html +0 -51
data/docs/index.html +0 -29
data/docs/instrumentation.html +0 -118
data/docs/javascript.html +0 -59
data/docs/jobs.html +0 -53
data/docs/keyword-injection.html +0 -49
data/docs/layouts.html +0 -96
data/docs/lsp.html +0 -29
data/docs/markdown-examples.html +0 -61
data/docs/middleware.html +0 -48
data/docs/overview.html +0 -29
data/docs/pages.html +0 -73
data/docs/recipes/alternate-layouts.html +0 -50
data/docs/recipes/authentication.html +0 -185
data/docs/recipes/custom-flash.html +0 -54
data/docs/recipes/dev-env-secrets.html +0 -40
data/docs/recipes/form-errors.html +0 -94
data/docs/recipes/indexed-forms.html +0 -102
data/docs/recipes/migrations.html +0 -125
data/docs/recipes/text-field-component.html +0 -129
data/docs/roadmap.html +0 -29
data/docs/routes.html +0 -49
data/docs/security.html +0 -29
data/docs/seed-data.html +0 -42
data/docs/space-time-continuum.html +0 -29
data/docs/tutorial.html +0 -55
data/docs/tutorials/01-intro.html +0 -736
data/docs/tutorials/02-dialog.html +0 -302
data/docs/unit-tests.html +0 -41
data/docs/vp-icons.css +0 -1
data/docs/why.html +0 -29
data/docs-todo.md +0 -32
data/dx/bash_customizations +0 -6
data/dx/build +0 -73
data/dx/build.pre +0 -15
data/dx/docker-compose.env +0 -22
data/dx/dx.sh.lib +0 -24
data/dx/exec +0 -75
data/dx/setupkit.sh.lib +0 -144
data/dx/show-help-in-app-container-then-wait.sh +0 -38
data/lib/brut/cli/app.rb +0 -238
data/lib/brut/cli/app_runner.rb +0 -252
data/lib/brut/cli/command.rb +0 -258
data/lib/brut/cli/execution_results.rb +0 -119
data/lib/brut/front_end/layouts/_internal.html.erb +0 -68
data/lib/brut/front_end/pages/_missing_page.html.erb +0 -17
data/mkbrut/.gitignore +0 -16
data/mkbrut/CODE_OF_CONDUCT.txt +0 -100
data/mkbrut/Gemfile +0 -3
data/mkbrut/Gemfile.lock +0 -20
data/mkbrut/LICENSE.txt +0 -370
data/mkbrut/README.md +0 -145
data/mkbrut/Rakefile +0 -2
data/mkbrut/bin/build +0 -36
data/mkbrut/bin/ci +0 -19
data/mkbrut/bin/docs +0 -19
data/mkbrut/bin/publish +0 -129
data/mkbrut/bin/rake +0 -16
data/mkbrut/bin/setup +0 -30
data/mkbrut/brut-welcome.png +0 -0
data/mkbrut/deploy/.dockerignore +0 -2
data/mkbrut/deploy/Dockerfile +0 -25
data/mkbrut/dx +0 -1
data/mkbrut/exe/mkbrut +0 -5
data/mkbrut/lib/mkbrut/app_name.rb +0 -29
data/mkbrut/lib/mkbrut/app_options.rb +0 -36
data/mkbrut/lib/mkbrut/cli.rb +0 -189
data/mkbrut/lib/mkbrut/erb_binding_delegate.rb +0 -20
data/mkbrut/lib/mkbrut/ops.rb +0 -17
data/mkbrut/lib/mkbrut/organization.rb +0 -5
data/mkbrut/lib/mkbrut/segments.rb +0 -8
data/mkbrut/lib/mkbrut/version.rb +0 -3
data/mkbrut/lib/mkbrut.rb +0 -20
data/mkbrut/mkbrut.gemspec +0 -34
data/mkbrut/templates/Base/app/src/front_end/images/LogoPylon.png +0 -0
data/mkbrut/templates/Base/bin/build-assets +0 -7
data/mkbrut/templates/Base/bin/ci +0 -39
data/mkbrut/templates/Base/bin/db +0 -9
data/mkbrut/templates/Base/bin/scaffold +0 -9
data/mkbrut/templates/Base/bin/setup +0 -287
data/mkbrut/templates/Base/bin/test +0 -9
data/mkbrut/templates/Base/bin/test-server +0 -29
data/mkbrut/templates/Base/dx/prune +0 -19
data/mkbrut/templates/Base/dx/start +0 -30
data/mkbrut/templates/Base/dx/stop +0 -23
data/mkbrut/templates/segments/Heroku/deploy/heroku_config.rb +0 -27
data/specs/brut/front_end/forms/input.spec.rb +0 -978
data/specs/brut/front_end/forms/radio_button_group_input.spec.rb +0 -54
data/specs/brut/front_end/forms/select_input.spec.rb +0 -54
data/specs/brut/instrumentation/methods.spec.rb +0 -399
data/specs/brut/junk_drawer.spec.rb +0 -79
data/specs/brut/tui/ansi_escape_code.spec.rb +0 -30
data/specs/brut/tui/event_loop.spec.rb +0 -70
data/specs/brut/tui/events/base_event.spec.rb +0 -26
data/specs/brut/tui/events/event_bus.spec.rb +0 -141
data/specs/brut/tui/events/exception.spec.rb +0 -19
data/specs/brut/tui/events/test_event.rb +0 -5
data/specs/spec_helper.rb +0 -31
data/specs/support/matchers/have_constraint_violation.rb +0 -23
data/specs/support/matchers.rb +0 -5
data/specs/support.rb +0 -3
/data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/prefixed_io.rb +0 -0
/data/{mkbrut/templates → templates}/Base/.dockerignore +0 -0
/data/{mkbrut/templates → templates}/Base/.env.development.erb +0 -0
/data/{mkbrut/templates → templates}/Base/.env.test.erb +0 -0
/data/{mkbrut/templates → templates}/Base/.gitignore +0 -0
/data/{mkbrut/templates → templates}/Base/.projections.json +0 -0
/data/{mkbrut/templates → templates}/Base/Dockerfile.dx +0 -0
/data/{mkbrut/templates → templates}/Base/Gemfile.erb +0 -0
/data/{mkbrut/templates → templates}/Base/Procfile.development +0 -0
/data/{mkbrut/templates → templates}/Base/Procfile.test +0 -0
/data/{mkbrut/templates → templates}/Base/README.md +0 -0
/data/{mkbrut/templates → templates}/Base/README.md.erb +0 -0
/data/{mkbrut/templates → templates}/Base/app/bootstrap.rb +0 -0
/data/{mkbrut/templates → templates}/Base/app/config/i18n/en/1_defaults.rb +0 -0
/data/{mkbrut/templates → templates}/Base/app/config/i18n/en/2_app.rb +0 -0
/data/{mkbrut/templates → templates}/Base/app/public/static/manifest.json.erb +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/app.rb.erb +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/back_end/data_models/app_data_model.rb +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/back_end/data_models/db.rb +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/back_end/data_models/migrations/20240101130000_citext.rb +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/back_end/data_models/seed/seed_data.rb +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/front_end/components/app_component.rb +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/front_end/components/custom_element_registration.rb.erb +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/front_end/css/index.css +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/front_end/css/svgs.css +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/front_end/forms/app_form.rb +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/front_end/handlers/app_handler.rb +0 -0
/data/{brutrb.com → templates/Base/app/src/front_end}/images/LogoPylon.png +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/front_end/images/LogoTransit.png +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/front_end/images/apple-touch-icon-120x120.png +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/front_end/images/apple-touch-icon-152x152.png +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/front_end/images/apple-touch-icon-167x167.png +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/front_end/images/apple-touch-icon-180x180.png +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/front_end/images/favicon.ico +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/front_end/images/icon.png +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/front_end/images/mkicons.sh +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/front_end/js/index.js +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/front_end/layouts/blank_layout.rb +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/front_end/layouts/default_layout.rb.erb +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/front_end/pages/app_page.rb +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/front_end/pages/home_page.rb +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/front_end/support/app_session.rb +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/front_end/svgs/README.md +0 -0
/data/{mkbrut/templates → templates}/Base/app/src/front_end/svgs/comment-button.svg +0 -0
/data/{mkbrut/templates → templates}/Base/bin/README.md.erb +0 -0
/data/{mkbrut/templates → templates}/Base/bin/console +0 -0
/data/{mkbrut/templates → templates}/Base/bin/dbconsole +0 -0
/data/{mkbrut/templates → templates}/Base/bin/dev +0 -0
/data/{mkbrut/templates → templates}/Base/bin/run +0 -0
/data/{mkbrut/templates → templates}/Base/bin/run.run +0 -0
/data/{mkbrut/templates → templates}/Base/bin/startup-message +0 -0
/data/{mkbrut/templates → templates}/Base/config.ru +0 -0
/data/{mkbrut/templates → templates}/Base/docker-compose.dx.yml +0 -0
/data/{mkbrut/templates → templates}/Base/dx/README.md +0 -0
/data/{mkbrut/templates → templates}/Base/dx/bash_customizations +0 -0
/data/{mkbrut/templates → templates}/Base/dx/bash_customizations.local +0 -0
/data/{mkbrut/templates → templates}/Base/dx/build +0 -0
/data/{mkbrut/templates → templates}/Base/dx/dx.sh.lib +0 -0
/data/{mkbrut/templates → templates}/Base/dx/exec +0 -0
/data/{dx → templates/Base/dx}/prune +0 -0
/data/{mkbrut/templates → templates}/Base/dx/show-help-in-app-container-then-wait.sh +0 -0
/data/{dx → templates/Base/dx}/start +0 -0
/data/{dx → templates/Base/dx}/stop +0 -0
/data/{mkbrut/templates → templates}/Base/package.json.erb +0 -0
/data/{mkbrut/templates → templates}/Base/puma.config.rb +0 -0
/data/{mkbrut/templates → templates}/Base/specs/e2e/home_page.spec.rb.erb +0 -0
/data/{mkbrut/templates → templates}/Base/specs/front_end/js/SpecHelper.js +0 -0
/data/{mkbrut/templates → templates}/Base/specs/front_end/pages/home_page.spec.rb +0 -0
/data/{mkbrut/templates → templates}/Base/specs/lint_factories.spec.rb +0 -0
/data/{mkbrut/templates → templates}/Base/specs/spec_helper.rb +0 -0
/data/{mkbrut/templates → templates}/Base/specs/support.rb +0 -0
/data/{mkbrut/templates → templates}/segments/BareBones/app/src/front_end/handlers/trigger_exception_handler.rb +0 -0
/data/{mkbrut/templates → templates}/segments/BareBones/app/src/front_end/js/Example.js.erb +0 -0
/data/{mkbrut/templates → templates}/segments/BareBones/specs/front_end/handlers/trigger_exception_handler.spec.rb +0 -0
/data/{mkbrut/templates → templates}/segments/BareBones/specs/front_end/js/Example.spec.js.erb +0 -0
/data/{mkbrut/templates → templates}/segments/Demo/app/src/back_end/data_models/db/guestbook_message.rb +0 -0
/data/{mkbrut/templates → templates}/segments/Demo/app/src/back_end/data_models/migrations/20250628194124_guestbook.rb +0 -0
/data/{mkbrut/templates → templates}/segments/Demo/app/src/front_end/components/flash_component.rb +0 -0
/data/{mkbrut/templates → templates}/segments/Demo/app/src/front_end/css/constraint-violations.css +0 -0
/data/{mkbrut/templates → templates}/segments/Demo/app/src/front_end/fonts/monaspace-xenon.ttf +0 -0
/data/{mkbrut/templates → templates}/segments/Demo/app/src/front_end/forms/guestbook_message_form.rb +0 -0
/data/{mkbrut/templates → templates}/segments/Demo/app/src/front_end/handlers/guestbook_message_handler.rb +0 -0
/data/{mkbrut/templates → templates}/segments/Demo/app/src/front_end/pages/guestbook_page/message_component.rb +0 -0
/data/{mkbrut/templates → templates}/segments/Demo/app/src/front_end/pages/guestbook_page.rb +0 -0
/data/{mkbrut/templates → templates}/segments/Demo/app/src/front_end/pages/new_guestbook_message_page.rb +0 -0
/data/{mkbrut/templates → templates}/segments/Demo/specs/back_end/data_models/db/guestbook_message.spec.rb +0 -0
/data/{mkbrut/templates → templates}/segments/Demo/specs/e2e/guest_message.spec.rb +0 -0
/data/{mkbrut/templates → templates}/segments/Demo/specs/factories/db/guestbook_message.factory.rb +0 -0
/data/{mkbrut/templates → templates}/segments/Demo/specs/front_end/components/flash_component.spec.rb +0 -0
/data/{mkbrut/templates → templates}/segments/Demo/specs/front_end/handlers/guestbook_message_handler.spec.rb +0 -0
/data/{mkbrut/templates → templates}/segments/Demo/specs/front_end/pages/guestbook_page/message_component.spec.rb +0 -0
/data/{mkbrut/templates → templates}/segments/Demo/specs/front_end/pages/guestbook_page.spec.rb +0 -0
/data/{mkbrut/templates → templates}/segments/Demo/specs/front_end/pages/new_guestbook_message_page.spec.rb +0 -0
/data/{mkbrut/templates → templates}/segments/Heroku/bin/deploy +0 -0
/data/{mkbrut/templates → templates}/segments/Heroku/deploy/docker-entrypoint +0 -0
/data/{mkbrut/templates → templates}/segments/Sidekiq/app/boot_sidekiq.rb +0 -0
/data/{mkbrut/templates → templates}/segments/Sidekiq/app/config/sidekiq.yml +0 -0
/data/{mkbrut/templates → templates}/segments/Sidekiq/app/src/back_end/jobs/app_job.rb +0 -0
/data/{mkbrut/templates → templates}/segments/Sidekiq/app/src/back_end/jobs/example_job.rb +0 -0
/data/{mkbrut/templates → templates}/segments/Sidekiq/app/src/back_end/segments/sidekiq_segment.rb +0 -0
/data/{mkbrut/templates → templates}/segments/Sidekiq/bin/run.sidekiq +0 -0
/data/{mkbrut/templates → templates}/segments/Sidekiq/specs/back_end/jobs/example_job.spec.rb +0 -0
/data/{mkbrut/templates → templates}/segments/Sidekiq/specs/integration/sidekiq_works.spec.rb +0 -0

data/docs/custom-element-tests.html DELETED Viewed

@@ -1,97 +0,0 @@
-<!DOCTYPE html>
-<html lang="en-US" dir="ltr">
-  <head>
-    <meta charset="utf-8">
-    <meta name="viewport" content="width=device-width,initial-scale=1">
-    <title>Testing Custom Elements | Brut RB</title>
-    <meta name="description" content="Documentation for the Brut.RB web framework.">
-    <meta name="generator" content="VitePress v1.6.4">
-    <link rel="preload stylesheet" href="/assets/style.B1z60PPQ.css" as="style">
-    <link rel="preload stylesheet" href="/vp-icons.css" as="style">
-    <script type="module" src="/assets/app.B8jAEB7R.js"></script>
-    <link rel="modulepreload" href="/assets/chunks/theme.BjPAOJkz.js">
-    <link rel="modulepreload" href="/assets/chunks/framework.C4nOkCZI.js">
-    <link rel="modulepreload" href="/assets/custom-element-tests.md.DiLe-eFw.lean.js">
-    <link rel="icon" href="/favicon.ico">
-    <meta property="og:title" content="BrutRB Documentation">
-    <meta property="og:type" content="website">
-    <meta property="og:image" content="https://brutrb.com/SocialImage.png">
-    <script defer data-domain="brutrb.com" src="https://plausible.io/js/script.js"></script>
-    <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
-    <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
-  </head>
-  <body>
-    <div id="app"><div class="Layout" data-v-d8b57b2d><!--[--><!--]--><!--[--><span tabindex="-1" data-v-fcbfc0e0></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-fcbfc0e0>Skip to content</a><!--]--><!----><header class="VPNav" data-v-d8b57b2d data-v-7ad780c2><div class="VPNavBar" data-v-7ad780c2 data-v-9fd4d1dd><div class="wrapper" data-v-9fd4d1dd><div class="container" data-v-9fd4d1dd><div class="title" data-v-9fd4d1dd><div class="VPNavBarTitle has-sidebar" data-v-9fd4d1dd data-v-9f43907a><a class="title" href="/" data-v-9f43907a><!--[--><!--]--><!----><span data-v-9f43907a>Brut RB</span><!--[--><!--]--></a></div></div><div class="content" data-v-9fd4d1dd><div class="content-body" data-v-9fd4d1dd><!--[--><!--]--><div class="VPNavBarSearch search" data-v-9fd4d1dd><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-9fd4d1dd data-v-afb2845e><span id="main-nav-aria-label" class="visually-hidden" data-v-afb2845e> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>Home</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/getting-started.html" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>Getting Started</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/overview.html" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>Overview</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/api/index.html" target="_self" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>Brut API</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/brut-js/api/index.html" target="_self" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>BrutJS</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/brut-css/index.html" target="_self" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>BrutCSS</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-9fd4d1dd data-v-3f90c1a5><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-3f90c1a5 data-v-be9742d9 data-v-b4ccac88><span class="check" data-v-b4ccac88><span class="icon" data-v-b4ccac88><!--[--><span class="vpi-sun sun" data-v-be9742d9></span><span class="vpi-moon moon" data-v-be9742d9></span><!--]--></span></span></button></div><div class="VPSocialLinks VPNavBarSocialLinks social-links" data-v-9fd4d1dd data-v-ef6192dc data-v-e71e869c><!--[--><a class="VPSocialLink no-icon" href="https://github.com/thirdtank/brut" aria-label="github" target="_blank" rel="noopener" data-v-e71e869c data-v-60a9a2d3><span class="vpi-social-github"></span></a><!--]--></div><div class="VPFlyout VPNavBarExtra extra" data-v-9fd4d1dd data-v-f953d92f data-v-bfe7971f><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-bfe7971f><span class="vpi-more-horizontal icon" data-v-bfe7971f></span></button><div class="menu" data-v-bfe7971f><div class="VPMenu" data-v-bfe7971f data-v-20ed86d6><!----><!--[--><!--[--><!----><div class="group" data-v-f953d92f><div class="item appearance" data-v-f953d92f><p class="label" data-v-f953d92f>Appearance</p><div class="appearance-action" data-v-f953d92f><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-f953d92f data-v-be9742d9 data-v-b4ccac88><span class="check" data-v-b4ccac88><span class="icon" data-v-b4ccac88><!--[--><span class="vpi-sun sun" data-v-be9742d9></span><span class="vpi-moon moon" data-v-be9742d9></span><!--]--></span></span></button></div></div></div><div class="group" data-v-f953d92f><div class="item social-links" data-v-f953d92f><div class="VPSocialLinks social-links-list" data-v-f953d92f data-v-e71e869c><!--[--><a class="VPSocialLink no-icon" href="https://github.com/thirdtank/brut" aria-label="github" target="_blank" rel="noopener" data-v-e71e869c data-v-60a9a2d3><span class="vpi-social-github"></span></a><!--]--></div></div></div><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-9fd4d1dd data-v-6bee1efd><span class="container" data-v-6bee1efd><span class="top" data-v-6bee1efd></span><span class="middle" data-v-6bee1efd></span><span class="bottom" data-v-6bee1efd></span></span></button></div></div></div></div><div class="divider" data-v-9fd4d1dd><div class="divider-line" data-v-9fd4d1dd></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-d8b57b2d data-v-2488c25a><div class="container" data-v-2488c25a><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-2488c25a><span class="vpi-align-left menu-icon" data-v-2488c25a></span><span class="menu-text" data-v-2488c25a>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-2488c25a data-v-6b867909><button data-v-6b867909>Return to top</button><!----></div></div></div><aside class="VPSidebar" data-v-d8b57b2d data-v-42c4c606><div class="curtain" data-v-42c4c606></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-42c4c606><span class="visually-hidden" id="sidebar-aria-label" data-v-42c4c606> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Overview</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/getting-started.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Getting Started</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/overview.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Concepts</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/features.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Features</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/dir-structure.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Directory Structure</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/dev-environment.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Dev Environment</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/tutorial.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Tutorial</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/doc-conventions.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Documentation Conventions</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Front-End</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/routes.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Routes</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pages.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Pages</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/layouts.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Layouts</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/forms.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Forms</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/form-constraints.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Form Constraints</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/handlers.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Handlers and Actions</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/components.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Components</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/flash-and-session.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Flash and Session</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/space-time-continuum.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Space/Time Continuum</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/javascript.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>JavaScript</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/css.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>CSS</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/assets.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Assets</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/brut-js.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>BrutJS</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Back-End</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/database-schema.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Database Schema</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/database-access.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Database Access</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/seed-data.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Seed Data</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/jobs.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Jobs</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/business-logic.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Business Logic</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Framework</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/configuration.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Configuration</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/keyword-injection.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Keyword Injection</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/i18n.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>I18n</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/cli.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>CLI / Tasks</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/deployment.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Deployment</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible has-active" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Testing</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/unit-tests.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Unit Tests</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/end-to-end-tests.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>End-to-End Tests</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/custom-element-tests.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Testing Custom Elements</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible collapsed" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Advanced Topics</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/hooks.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Route Hooks</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/middleware.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Middleware</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/instrumentation.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Instrumentation</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/security.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Security</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/lsp.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>LSP Support</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible collapsed" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Recipes</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/alternate-layouts.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Alternate Layouts</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/authentication.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Authentication</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/custom-flash.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Custom Flash Class</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/indexed-forms.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Indexed Form Elements</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/dev-env-secrets.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Managing Secrets in the Dev Environment</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/migrations.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Migration Basics</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/form-errors.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Styling Form Errors</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/text-field-component.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Text Field Component</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Meta</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/why.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Why?!</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/adrs.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>ADRs</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/roadmap.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Roadmap to 1.0</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/ai.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>AI Declaration</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-d8b57b2d data-v-9a6c75ad><div class="VPDoc has-sidebar has-aside" data-v-9a6c75ad data-v-e6f2a212><!--[--><!--]--><div class="container" data-v-e6f2a212><div class="aside" data-v-e6f2a212><div class="aside-curtain" data-v-e6f2a212></div><div class="aside-container" data-v-e6f2a212><div class="aside-content" data-v-e6f2a212><div class="VPDocAside" data-v-e6f2a212 data-v-cb998dce><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-cb998dce data-v-f610f197><div class="content" data-v-f610f197><div class="outline-marker" data-v-f610f197></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-f610f197>On this page</div><ul class="VPDocOutlineItem root" data-v-f610f197 data-v-53c99d69><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-cb998dce></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-e6f2a212><div class="content-container" data-v-e6f2a212><!--[--><!--]--><main class="main" data-v-e6f2a212><div style="position:relative;" class="vp-doc _custom-element-tests" data-v-e6f2a212><div><h1 id="testing-custom-elements" tabindex="-1">Testing Custom Elements <a class="header-anchor" href="#testing-custom-elements" aria-label="Permalink to &quot;Testing Custom Elements&quot;"></a></h1><p>While simple custom elements can be tested as part of an <a href="/end-to-end-tests.html">end-to-end test</a>, more complex custom elements can benefit from a unit test. Spoiler: this is not going to be pleasant.</p><h2 id="overview" tabindex="-1">Overview <a class="header-anchor" href="#overview" aria-label="Permalink to &quot;Overview&quot;"></a></h2><p>BrutJS provides a testing module that uses JSDom to allow you to test your custom elements. There are downsides to JSDom, but it&#39;s the simplest way to achieve a reasonably-useful unit test.</p><p>You can use <code>bin/scaffold</code> to create a test, which will create a <code>.spec.js</code> file in <code>specs/front_end/js/</code>. Suppose we the custom element <code>MyElement</code>:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>&gt; bin/scaffold custom_element_test app/src/front_end/js/MyElement.js</span></span></code></pre></div><p>This creates <code>specs/front_end/js/MyElement.spec.js</code>:</p><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { withHTML } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;brut-js/testing/index.js&quot;</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">describe</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;&lt;some-element&gt;&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, () </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
-<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">  withHTML</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">`</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  &lt;my-element&gt;</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  &lt;/my-element&gt;</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  `</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">test</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;description here&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, ({</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">document</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">window</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">assert</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}) </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    assert.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">fail</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;test goes here&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  })</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">})</span></span></code></pre></div><p><code>withHTML</code> creates a JSDom-based document with the given HTML. This HTML is in effect inside the test. Mock versions of <code>document</code> and <code>window</code> are passed to the test, and any other functions you need can be as well, such as <code>assert</code>.</p><p>The idea is that you use the browser APIs to examine the DOM and assert the behavior of the custom element (as opposed to interacting with the custom element&#39;s class).</p><p>Suppose that <code>my-element</code> transform text inside it based on the <code>transform</code> attribute. By default, it&#39;s <code>lower</code> (which will lower-case the text), but can be set to <code>upper</code> to upper case the text inside.</p><p>This means you&#39;ll need three tests, each with a different DOM:</p><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { withHTML } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;brut-js/testing/index.js&quot;</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">describe</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;&lt;some-element&gt;&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, () </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
-<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">  withHTML</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">`</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  &lt;my-element&gt;</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">    Some Text</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  &lt;/my-element&gt;</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  `</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">test</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;lower-cases by default&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, ({</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">document</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">window</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">assert</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}) </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
-<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">    // TBD</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  })</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">  withHTML</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">`</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  &lt;my-element transform=&quot;lower&quot;&gt;</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">    Some Text</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  &lt;/my-element&gt;</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  `</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">test</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;lower-cases explicitly&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, ({</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">document</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">window</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">assert</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}) </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
-<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">    // TBD</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  })</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">  withHTML</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">`</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  &lt;my-element transform=&quot;upper&quot;&gt;</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">    Some Text</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  &lt;/my-element&gt;</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  `</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">test</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;upper-cases explicitly&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, ({</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">document</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">window</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">assert</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}) </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
-<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">    // TBD</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  })</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">})</span></span></code></pre></div><p>When the function you give to <code>test</code> is executed, the DOM will have been setup, so you can rely on your custom elements <code>connectedCallback</code> having been called. Assuming the text transformation for <code>my-element</code> occurs in <code>connectedCallback</code>, here is how you&#39;d test all three cases:</p><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { withHTML } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;brut-js/testing/index.js&quot;</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">describe</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;&lt;some-element&gt;&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, () </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
-<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">  withHTML</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">`</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  &lt;my-element&gt;</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">    Some Text</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  &lt;/my-element&gt;</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  `</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">test</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;lower-cases by default&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, ({</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">document</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">window</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">assert</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}) </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
-<span class="line highlighted"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">    const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> element</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> document.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">querySelector</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;my-element&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    assert.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">equal</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(element.textContent.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">trim</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(),</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;some text&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  })</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">  withHTML</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">`</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  &lt;my-element transform=&quot;lower&quot;&gt;</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">    Some Text</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  &lt;/my-element&gt;</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  `</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">test</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;lower-cases explicitly&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, ({</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">document</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">window</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">assert</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}) </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
-<span class="line highlighted"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">    const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> element</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> document.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">querySelector</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;my-element&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    assert.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">equal</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(element.textContent.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">trim</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(),</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;some text&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  })</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">  withHTML</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">`</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  &lt;my-element transform=&quot;upper&quot;&gt;</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">    Some Text</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  &lt;/my-element&gt;</span></span>
-<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  `</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">test</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;upper-cases explicitly&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, ({</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">document</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">window</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">assert</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}) </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
-<span class="line highlighted"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">    const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> element</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> document.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">querySelector</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;my-element&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    assert.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">equal</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(element.textContent.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">trim</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(),</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;SOME TEXT&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  })</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">})</span></span></code></pre></div><p>You&#39;ll notice almost all of this uses the browser APIs you (should) know and (hopefully) love.</p><p>You can manipulate the DOM inside a test as well, and it should behave as if you are doing it in a browser. Note that many browser APIs are synchronous, so you don&#39;t have to add <code>await</code> before every single line of code.</p><p>Note that all of these test run under NodeJS, which is different from a browser. This means that code like <code>new InputEvent()</code> will succeed in returning an <code>InputEvent</code>, but said object is in no way the <code>InputEvent</code> you&#39;d use in a browser. You must use <code>window.</code>:</p><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// does not work, but doesn&#39;t raise an error either</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">input.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">dispatchEvent</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">new</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> InputEvent</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;input&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, {}))        </span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// works</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">input.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">dispatchEvent</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">new</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> window.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">InputEvent</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;input&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, {}))</span></span></code></pre></div><h2 id="recommended-practices" tabindex="-1">Recommended Practices <a class="header-anchor" href="#recommended-practices" aria-label="Permalink to &quot;Recommended Practices&quot;"></a></h2><p>The custom element test library is <em>very</em> basic. Testing asychronous things like <code>fetch</code> is extremely difficult. Your best bet is to use these tests for edge cases and error conditions.</p><h2 id="technical-notes" tabindex="-1">Technical Notes <a class="header-anchor" href="#technical-notes" aria-label="Permalink to &quot;Technical Notes&quot;"></a></h2><div class="important custom-block github-alert"><p class="custom-block-title">IMPORTANT</p><p>Technical Notes are for deeper understanding and debugging. While we will try to keep them up-to-date with changes to Brut&#39;s internals, the source code is always more correct.</p></div><p><em>Last Updated June 13, 2025</em></p><p>I will be honest with you, this part of Brut needs a lot of work and thinking-through. It&#39;s way to DSL-tasitc for my tastes, but it does work for some needs. JSDom is not ideal and requires a lot of hoops when using events or anything browsers support that it does not.</p><p>This is highly likely to change. My current thinking on addressing the need is to run the tests in a real browser and to make the test setup and code more like what you&#39;d actually write when using these elements.</p></div></div></main><footer class="VPDocFooter" data-v-e6f2a212 data-v-1bcd8184><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-1bcd8184><span class="visually-hidden" id="doc-footer-aria-label" data-v-1bcd8184>Pager</span><div class="pager" data-v-1bcd8184><a class="VPLink link pager-link prev" href="/end-to-end-tests.html" data-v-1bcd8184><!--[--><span class="desc" data-v-1bcd8184>Previous page</span><span class="title" data-v-1bcd8184>End-to-End Tests</span><!--]--></a></div><div class="pager" data-v-1bcd8184><a class="VPLink link pager-link next" href="/hooks.html" data-v-1bcd8184><!--[--><span class="desc" data-v-1bcd8184>Next page</span><span class="title" data-v-1bcd8184>Route Hooks</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
-    <script>window.__VP_HASH_MAP__=JSON.parse("{\"adrs.md\":\"YglbWtQe\",\"ai.md\":\"ChLnvDAX\",\"assets.md\":\"BEF6Oz6K\",\"brut-js.md\":\"BMz0X1Rz\",\"business-logic.md\":\"DbuaOYGU\",\"cli.md\":\"DDMar_51\",\"components.md\":\"Ber8UBM0\",\"configuration.md\":\"DrJ6YVoZ\",\"css.md\":\"K5rOCOQY\",\"custom-element-tests.md\":\"DiLe-eFw\",\"database-access.md\":\"Dc8l2Plf\",\"database-schema.md\":\"BJ_JhXmO\",\"deployment.md\":\"CHTx2eTR\",\"dev-environment.md\":\"B1S9p5ZK\",\"dir-structure.md\":\"D1T2kGwj\",\"doc-conventions.md\":\"CDnWaEFg\",\"end-to-end-tests.md\":\"BJJdNDYL\",\"features.md\":\"BDWxnyNO\",\"flash-and-session.md\":\"CUsMxoNl\",\"form-constraints.md\":\"KlfXSKm2\",\"forms.md\":\"RK0zkhm0\",\"getting-started.md\":\"CGJ44juQ\",\"handlers.md\":\"C5tUwmmo\",\"hooks.md\":\"CoiYCKRc\",\"i18n.md\":\"DxkCKhUw\",\"index.md\":\"DnphWyQd\",\"instrumentation.md\":\"BcxjC4jd\",\"javascript.md\":\"D6fxhaQb\",\"jobs.md\":\"Bi3qb3v6\",\"keyword-injection.md\":\"CqLnnzIz\",\"layouts.md\":\"HEbeK7Jr\",\"lsp.md\":\"bE9dW8n9\",\"markdown-examples.md\":\"BPmtHlc-\",\"middleware.md\":\"BhOIsg59\",\"overview.md\":\"BpWAgPFH\",\"pages.md\":\"B3sQXpEd\",\"recipes_alternate-layouts.md\":\"C1QzVkA7\",\"recipes_authentication.md\":\"CyvoIW82\",\"recipes_custom-flash.md\":\"6gFqf2uL\",\"recipes_dev-env-secrets.md\":\"DC_jVY9U\",\"recipes_form-errors.md\":\"B5ptSzMO\",\"recipes_indexed-forms.md\":\"BYYQGW2C\",\"recipes_migrations.md\":\"Cid7-3cu\",\"recipes_text-field-component.md\":\"VhOsCtKI\",\"roadmap.md\":\"DqC1Y7Zt\",\"routes.md\":\"C1dgIBtD\",\"security.md\":\"Jn4SY1uK\",\"seed-data.md\":\"UZW0WxYN\",\"space-time-continuum.md\":\"D9rYGDFH\",\"tutorial.md\":\"BX6f6l00\",\"tutorials_01-intro.md\":\"CzZ3kpF_\",\"tutorials_02-dialog.md\":\"DE5WfCXI\",\"unit-tests.md\":\"vDsdBbO_\",\"why.md\":\"4WpxdrQ2\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Brut RB\",\"description\":\"Documentation for the Brut.RB web framework.\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"search\":{\"provider\":\"local\"},\"nav\":[{\"text\":\"Home\",\"link\":\"/\"},{\"text\":\"Getting Started\",\"link\":\"/getting-started\"},{\"text\":\"Overview\",\"link\":\"/overview\"},{\"text\":\"Brut API\",\"link\":\"/api/index.html\",\"target\":\"_self\"},{\"text\":\"BrutJS\",\"link\":\"/brut-js/api/index.html\",\"target\":\"_self\"},{\"text\":\"BrutCSS\",\"link\":\"/brut-css/index.html\",\"target\":\"_self\"}],\"outline\":[2,3],\"sidebar\":[{\"text\":\"Overview\",\"collapsed\":false,\"items\":[{\"text\":\"Getting Started\",\"link\":\"/getting-started\"},{\"text\":\"Concepts\",\"link\":\"/overview\"},{\"text\":\"Features\",\"link\":\"/features\"},{\"text\":\"Directory Structure\",\"link\":\"/dir-structure\"},{\"text\":\"Dev Environment\",\"link\":\"/dev-environment\"},{\"text\":\"Tutorial\",\"link\":\"/tutorial\"},{\"text\":\"Documentation Conventions\",\"link\":\"/doc-conventions\"}]},{\"text\":\"Front-End\",\"collapsed\":false,\"items\":[{\"text\":\"Routes\",\"link\":\"/routes\"},{\"text\":\"Pages\",\"link\":\"/pages\"},{\"text\":\"Layouts\",\"link\":\"/layouts\"},{\"text\":\"Forms\",\"link\":\"/forms\"},{\"text\":\"Form Constraints\",\"link\":\"/form-constraints\"},{\"text\":\"Handlers and Actions\",\"link\":\"/handlers\"},{\"text\":\"Components\",\"link\":\"/components\"},{\"text\":\"Flash and Session\",\"link\":\"/flash-and-session\"},{\"text\":\"Space/Time Continuum\",\"link\":\"/space-time-continuum\"},{\"text\":\"JavaScript\",\"link\":\"/javascript\"},{\"text\":\"CSS\",\"link\":\"/css\"},{\"text\":\"Assets\",\"link\":\"/assets\"},{\"text\":\"BrutJS\",\"link\":\"/brut-js\"}]},{\"text\":\"Back-End\",\"collapsed\":false,\"items\":[{\"text\":\"Database Schema\",\"link\":\"/database-schema\"},{\"text\":\"Database Access\",\"link\":\"/database-access\"},{\"text\":\"Seed Data\",\"link\":\"/seed-data\"},{\"text\":\"Jobs\",\"link\":\"/jobs\"},{\"text\":\"Business Logic\",\"link\":\"/business-logic\"}]},{\"text\":\"Framework\",\"collapsed\":false,\"items\":[{\"text\":\"Configuration\",\"link\":\"/configuration\"},{\"text\":\"Keyword Injection\",\"link\":\"/keyword-injection\"},{\"text\":\"I18n\",\"link\":\"/i18n\"},{\"text\":\"CLI / Tasks\",\"link\":\"/cli\"},{\"text\":\"Deployment\",\"link\":\"/deployment\"}]},{\"text\":\"Testing\",\"collapsed\":false,\"items\":[{\"text\":\"Unit Tests\",\"link\":\"/unit-tests\"},{\"text\":\"End-to-End Tests\",\"link\":\"/end-to-end-tests\"},{\"text\":\"Testing Custom Elements\",\"link\":\"/custom-element-tests\"}]},{\"text\":\"Advanced Topics\",\"collapsed\":true,\"items\":[{\"text\":\"Route Hooks\",\"link\":\"/hooks\"},{\"text\":\"Middleware\",\"link\":\"/middleware\"},{\"text\":\"Instrumentation\",\"link\":\"/instrumentation\"},{\"text\":\"Security\",\"link\":\"/security\"},{\"text\":\"LSP Support\",\"link\":\"/lsp\"}]},{\"text\":\"Recipes\",\"collapsed\":true,\"items\":[{\"text\":\"Alternate Layouts\",\"link\":\"/recipes/alternate-layouts\"},{\"text\":\"Authentication\",\"link\":\"/recipes/authentication\"},{\"text\":\"Custom Flash Class\",\"link\":\"/recipes/custom-flash\"},{\"text\":\"Indexed Form Elements\",\"link\":\"/recipes/indexed-forms\"},{\"text\":\"Managing Secrets in the Dev Environment\",\"link\":\"/recipes/dev-env-secrets\"},{\"text\":\"Migration Basics\",\"link\":\"/recipes/migrations\"},{\"text\":\"Styling Form Errors\",\"link\":\"/recipes/form-errors\"},{\"text\":\"Text Field Component\",\"link\":\"/recipes/text-field-component\"}]},{\"text\":\"Meta\",\"collapsed\":false,\"items\":[{\"text\":\"Why?!\",\"link\":\"/why\"},{\"text\":\"ADRs\",\"link\":\"/adrs\"},{\"text\":\"Roadmap to 1.0\",\"link\":\"/roadmap\"},{\"text\":\"AI Declaration\",\"link\":\"/ai\"}]}],\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/thirdtank/brut\"}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
-  </body>
-</html>

data/docs/database-access.html DELETED Viewed

@@ -1,91 +0,0 @@
-<!DOCTYPE html>
-<html lang="en-US" dir="ltr">
-  <head>
-    <meta charset="utf-8">
-    <meta name="viewport" content="width=device-width,initial-scale=1">
-    <title>Database Access / Data Models | Brut RB</title>
-    <meta name="description" content="Documentation for the Brut.RB web framework.">
-    <meta name="generator" content="VitePress v1.6.4">
-    <link rel="preload stylesheet" href="/assets/style.B1z60PPQ.css" as="style">
-    <link rel="preload stylesheet" href="/vp-icons.css" as="style">
-    <script type="module" src="/assets/app.B8jAEB7R.js"></script>
-    <link rel="modulepreload" href="/assets/chunks/theme.BjPAOJkz.js">
-    <link rel="modulepreload" href="/assets/chunks/framework.C4nOkCZI.js">
-    <link rel="modulepreload" href="/assets/database-access.md.Dc8l2Plf.lean.js">
-    <link rel="icon" href="/favicon.ico">
-    <meta property="og:title" content="BrutRB Documentation">
-    <meta property="og:type" content="website">
-    <meta property="og:image" content="https://brutrb.com/SocialImage.png">
-    <script defer data-domain="brutrb.com" src="https://plausible.io/js/script.js"></script>
-    <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
-    <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
-  </head>
-  <body>
-    <div id="app"><div class="Layout" data-v-d8b57b2d><!--[--><!--]--><!--[--><span tabindex="-1" data-v-fcbfc0e0></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-fcbfc0e0>Skip to content</a><!--]--><!----><header class="VPNav" data-v-d8b57b2d data-v-7ad780c2><div class="VPNavBar" data-v-7ad780c2 data-v-9fd4d1dd><div class="wrapper" data-v-9fd4d1dd><div class="container" data-v-9fd4d1dd><div class="title" data-v-9fd4d1dd><div class="VPNavBarTitle has-sidebar" data-v-9fd4d1dd data-v-9f43907a><a class="title" href="/" data-v-9f43907a><!--[--><!--]--><!----><span data-v-9f43907a>Brut RB</span><!--[--><!--]--></a></div></div><div class="content" data-v-9fd4d1dd><div class="content-body" data-v-9fd4d1dd><!--[--><!--]--><div class="VPNavBarSearch search" data-v-9fd4d1dd><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-9fd4d1dd data-v-afb2845e><span id="main-nav-aria-label" class="visually-hidden" data-v-afb2845e> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>Home</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/getting-started.html" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>Getting Started</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/overview.html" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>Overview</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/api/index.html" target="_self" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>Brut API</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/brut-js/api/index.html" target="_self" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>BrutJS</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/brut-css/index.html" target="_self" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>BrutCSS</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-9fd4d1dd data-v-3f90c1a5><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-3f90c1a5 data-v-be9742d9 data-v-b4ccac88><span class="check" data-v-b4ccac88><span class="icon" data-v-b4ccac88><!--[--><span class="vpi-sun sun" data-v-be9742d9></span><span class="vpi-moon moon" data-v-be9742d9></span><!--]--></span></span></button></div><div class="VPSocialLinks VPNavBarSocialLinks social-links" data-v-9fd4d1dd data-v-ef6192dc data-v-e71e869c><!--[--><a class="VPSocialLink no-icon" href="https://github.com/thirdtank/brut" aria-label="github" target="_blank" rel="noopener" data-v-e71e869c data-v-60a9a2d3><span class="vpi-social-github"></span></a><!--]--></div><div class="VPFlyout VPNavBarExtra extra" data-v-9fd4d1dd data-v-f953d92f data-v-bfe7971f><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-bfe7971f><span class="vpi-more-horizontal icon" data-v-bfe7971f></span></button><div class="menu" data-v-bfe7971f><div class="VPMenu" data-v-bfe7971f data-v-20ed86d6><!----><!--[--><!--[--><!----><div class="group" data-v-f953d92f><div class="item appearance" data-v-f953d92f><p class="label" data-v-f953d92f>Appearance</p><div class="appearance-action" data-v-f953d92f><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-f953d92f data-v-be9742d9 data-v-b4ccac88><span class="check" data-v-b4ccac88><span class="icon" data-v-b4ccac88><!--[--><span class="vpi-sun sun" data-v-be9742d9></span><span class="vpi-moon moon" data-v-be9742d9></span><!--]--></span></span></button></div></div></div><div class="group" data-v-f953d92f><div class="item social-links" data-v-f953d92f><div class="VPSocialLinks social-links-list" data-v-f953d92f data-v-e71e869c><!--[--><a class="VPSocialLink no-icon" href="https://github.com/thirdtank/brut" aria-label="github" target="_blank" rel="noopener" data-v-e71e869c data-v-60a9a2d3><span class="vpi-social-github"></span></a><!--]--></div></div></div><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-9fd4d1dd data-v-6bee1efd><span class="container" data-v-6bee1efd><span class="top" data-v-6bee1efd></span><span class="middle" data-v-6bee1efd></span><span class="bottom" data-v-6bee1efd></span></span></button></div></div></div></div><div class="divider" data-v-9fd4d1dd><div class="divider-line" data-v-9fd4d1dd></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-d8b57b2d data-v-2488c25a><div class="container" data-v-2488c25a><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-2488c25a><span class="vpi-align-left menu-icon" data-v-2488c25a></span><span class="menu-text" data-v-2488c25a>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-2488c25a data-v-6b867909><button data-v-6b867909>Return to top</button><!----></div></div></div><aside class="VPSidebar" data-v-d8b57b2d data-v-42c4c606><div class="curtain" data-v-42c4c606></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-42c4c606><span class="visually-hidden" id="sidebar-aria-label" data-v-42c4c606> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Overview</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/getting-started.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Getting Started</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/overview.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Concepts</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/features.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Features</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/dir-structure.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Directory Structure</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/dev-environment.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Dev Environment</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/tutorial.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Tutorial</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/doc-conventions.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Documentation Conventions</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Front-End</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/routes.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Routes</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pages.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Pages</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/layouts.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Layouts</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/forms.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Forms</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/form-constraints.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Form Constraints</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/handlers.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Handlers and Actions</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/components.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Components</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/flash-and-session.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Flash and Session</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/space-time-continuum.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Space/Time Continuum</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/javascript.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>JavaScript</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/css.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>CSS</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/assets.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Assets</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/brut-js.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>BrutJS</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible has-active" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Back-End</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/database-schema.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Database Schema</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/database-access.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Database Access</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/seed-data.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Seed Data</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/jobs.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Jobs</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/business-logic.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Business Logic</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Framework</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/configuration.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Configuration</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/keyword-injection.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Keyword Injection</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/i18n.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>I18n</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/cli.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>CLI / Tasks</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/deployment.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Deployment</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Testing</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/unit-tests.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Unit Tests</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/end-to-end-tests.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>End-to-End Tests</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/custom-element-tests.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Testing Custom Elements</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible collapsed" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Advanced Topics</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/hooks.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Route Hooks</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/middleware.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Middleware</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/instrumentation.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Instrumentation</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/security.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Security</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/lsp.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>LSP Support</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible collapsed" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Recipes</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/alternate-layouts.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Alternate Layouts</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/authentication.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Authentication</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/custom-flash.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Custom Flash Class</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/indexed-forms.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Indexed Form Elements</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/dev-env-secrets.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Managing Secrets in the Dev Environment</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/migrations.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Migration Basics</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/form-errors.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Styling Form Errors</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/text-field-component.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Text Field Component</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Meta</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/why.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Why?!</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/adrs.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>ADRs</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/roadmap.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Roadmap to 1.0</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/ai.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>AI Declaration</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-d8b57b2d data-v-9a6c75ad><div class="VPDoc has-sidebar has-aside" data-v-9a6c75ad data-v-e6f2a212><!--[--><!--]--><div class="container" data-v-e6f2a212><div class="aside" data-v-e6f2a212><div class="aside-curtain" data-v-e6f2a212></div><div class="aside-container" data-v-e6f2a212><div class="aside-content" data-v-e6f2a212><div class="VPDocAside" data-v-e6f2a212 data-v-cb998dce><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-cb998dce data-v-f610f197><div class="content" data-v-f610f197><div class="outline-marker" data-v-f610f197></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-f610f197>On this page</div><ul class="VPDocOutlineItem root" data-v-f610f197 data-v-53c99d69><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-cb998dce></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-e6f2a212><div class="content-container" data-v-e6f2a212><!--[--><!--]--><main class="main" data-v-e6f2a212><div style="position:relative;" class="vp-doc _database-access" data-v-e6f2a212><div><h1 id="database-access-data-models" tabindex="-1">Database Access / Data Models <a class="header-anchor" href="#database-access-data-models" aria-label="Permalink to &quot;Database Access / Data Models&quot;"></a></h1><p>Brut provides access to the database via the <a href="https://sequel.jeremyevans.net/" target="_blank" rel="noreferrer">Sequel library</a>. Sequel is fully featured and provides a lot of ways of interacting with and managing your database. Brut includes several plugins and extensions to provide opinionated default behavior or additional features.</p><p>One thing to keep in mind is that Brut refers to your database layer as <em>database models</em> (notably not the un-qualified &quot;models&quot;). Brut treats this layer as a <em>model</em> of your database, not a model of your <em>domain</em> (though you are free to conflate the two).</p><p>This section details how to access data in your database.</p><div class="note custom-block github-alert"><p class="custom-block-title">NOTE</p><p>Brut currently only supports Postgres. Sequel supports many database systems, however Brut&#39;s extensions are currently geared toward Postgres only.</p></div><h2 id="overview" tabindex="-1">Overview <a class="header-anchor" href="#overview" aria-label="Permalink to &quot;Overview&quot;"></a></h2><p>Accessing your database in Brut uses Sequel&#39;s <code>Sequel::Model</code>. A base class called <code>AppDataModel</code> exists in your app from which all other data models extend:</p><div class="language-ruby vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ruby</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># app/src/back_end/data_models/app_data_model.rb</span></span>
-<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">AppDataModel</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> Class</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">new</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">Sequel</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">::</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">Model</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">class</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> AppDataModel</span></span>
-<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">  # You can insert your own shared methods here</span></span>
-<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">end</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># app/src/back_end/data_models/db/account.rb</span></span>
-<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">class</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> DB</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">::</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">Account</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> AppDataModel</span></span>
-<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">end</span></span></code></pre></div><p>All data models are in the <code>DB</code> namespace. This clearly identifies a model as a model of your database and not your domain.</p><p>Inside a data model, you can use all of Sequel&#39;s API. In particular, you will want to use its API for <a href="https://sequel.jeremyevans.net/rdoc/files/doc/association_basics_rdoc.html" target="_blank" rel="noreferrer">associations</a> so that you can create relationships between models.</p><p>In your business logic or front-end code, you can access your data using these models:</p><div class="language-ruby vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ruby</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">account</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> = </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">DB</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">::</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">Account</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">find</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">email:</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> form.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">email</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span></code></pre></div><div class="important custom-block github-alert"><p class="custom-block-title">IMPORTANT</p><p>Sequel&#39;s <code>Sequel::Model</code> is different from Active Record, especially when it comes to associations. <code>account.organizations</code> would return an <code>Array</code> of <code>DB::Organization</code> records, all fetched from the database. <code>account.organizations_dataset</code> would return a active-relation style object to allow stacking quieries. <strong>Please</strong> familiarize yourself with Sequel&#39;s API.</p></div><h2 id="testing" tabindex="-1">Testing <a class="header-anchor" href="#testing" aria-label="Permalink to &quot;Testing&quot;"></a></h2><p>Testing, as it applies to data models, is made up of two parts: managing test <em>data</em> and testing the models themselves.</p><h3 id="test-data-is-managed-with-factorybot" tabindex="-1">Test Data is Managed with FactoryBot <a class="header-anchor" href="#test-data-is-managed-with-factorybot" aria-label="Permalink to &quot;Test Data is Managed with FactoryBot&quot;"></a></h3><p>Brut apps come with <a href="https://github.com/thoughtbot/factory_bot" target="_blank" rel="noreferrer">FactoryBot</a> installed, and this is how you should create test (and seed) data.</p><p>Factories for data models live in <code>specs/factories/db</code>. Because data models are in the <code>DB</code> namespace, you will need to explicitly state the <code>class:</code> in the factory, but otherwise, you can use FactoryBot in a conventional way. <a href="https://github.com/faker-ruby/faker" target="_blank" rel="noreferrer">Faker</a> is also installed to allow you to create realistic and randomized data.</p><p>Here is a factory for our hypothetical account:</p><div class="language-ruby vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ruby</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># specs/factories/db/account.factory.rb</span></span>
-<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">FactoryBot</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">define</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> do</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  factory </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">:account</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">class:</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;DB::Account&quot;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> do</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    email         { </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">Faker</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">::</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">Internet</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">unique</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">email</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    organization</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    trait </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">:inactive</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> do</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">      deactivated_at { </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">Time</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">now</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
-<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">    end</span></span>
-<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  end</span></span>
-<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">end</span></span></code></pre></div><p>The <code>spec_support.rb</code> file generated when you created your Brut app should ensure that <code>FactoryBot::Syntax::Methods</code> is included in all specs, meaning you can do <code>create(:account)</code> to create an instance of <code>DB::Account</code>.</p><p>See <a href="/unit-tests.html">Unit Tests</a> for more details on testing and Factory Bot setup.</p><h3 id="testing-your-data-models" tabindex="-1">Testing Your Data Models <a class="header-anchor" href="#testing-your-data-models" aria-label="Permalink to &quot;Testing Your Data Models&quot;"></a></h3><p>In general, you don&#39;t want to test the configuration in your data models. For example, testing that <code>account.organization = organization</code> works is largely pointless, since this is provided by Sequel.</p><p>That said, if you have complex or unusual database constraints, having a test for them can be valuable.</p><p>Suppose our <code>DB::Account</code> has the following check constraint that requires an email end with <code>@example.com</code>:</p><div class="language-ruby vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ruby</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">Sequel</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">migration</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> do</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  up </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">do</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    create_table </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">:accounts</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
-<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">      comment:</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;People or systems who can access this system&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
-<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">      external_id:</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> true</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> do</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">      column </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">:email</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">:text</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">unique:</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> true</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">      foreign_key </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">:organization_id</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">:organizations</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">      column </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">:deactivated_at</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">:timestamptz</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">null:</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> true</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">      key [</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">:email</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">:organization_id</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">]</span></span>
-<span class="line"></span>
-<span class="line highlighted"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">      constraint</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">        :email_must_be_domain</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
-<span class="line highlighted"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">        &quot;email ~* &#39;@example.com$&#39;&quot;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">      )</span></span>
-<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">    end</span></span>
-<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  end</span></span>
-<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">end</span></span></code></pre></div><p>To test this, you would try to write invalid data into the database an ensure the expected exception is raised:</p><div class="language-ruby vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ruby</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># specs/back_end/data_models/db/account.spec.rb</span></span>
-<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">require</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;spec_helper&quot;</span></span>
-<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">RSpec</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">describe</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> DB</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">::</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">Account</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> do</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  describe </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;email&quot;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> do</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    it </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;must end in @example.com&quot;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> do</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">      expect {</span></span>
-<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">        DB</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">::</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">Account</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">create</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span></span>
-<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">          email:</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;pat@example.net&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
-<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">          organization:</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> create</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">:organization</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">        )</span></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">      }.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">to</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> raise_error</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">Sequel</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">::</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">CheckConstraintViolation</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">    end</span></span>
-<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  end</span></span>
-<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">end</span></span></code></pre></div><p>If you don&#39;t want to be overly coupled to Sequel&#39;s exceptions, you can also assert on the message Postgres will produce, which would include the name of the violated constraint:</p><div class="language-ruby vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ruby</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># specs/back_end/data_models/db/account.spec.rb</span></span>
-<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">require</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;spec_helper&quot;</span></span>
-<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">RSpec</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">describe</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> DB</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">::</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">Account</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> do</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  describe </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;email&quot;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> do</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    it </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;must end in @example.com&quot;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> do</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">      expect {</span></span>
-<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">        DB</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">::</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">Account</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">create</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span></span>
-<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">          email:</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;pat@example.net&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
-<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">          organization:</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> create</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">:organization</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">        )</span></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">      }.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">to</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> raise_error</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#DBEDFF;">/email_must_be_domain/</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)           </span></span>
-<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">    end</span></span>
-<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  end</span></span>
-<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">end</span></span></code></pre></div><h2 id="recommended-practices" tabindex="-1">Recommended Practices <a class="header-anchor" href="#recommended-practices" aria-label="Permalink to &quot;Recommended Practices&quot;"></a></h2><h3 id="do-not-put-business-logic-on-your-database-models" tabindex="-1">Do Not Put Business Logic On Your Database Models <a class="header-anchor" href="#do-not-put-business-logic-on-your-database-models" aria-label="Permalink to &quot;Do Not Put Business Logic On Your Database Models&quot;"></a></h3><p>There&#39;s no reason to, or benefit to doing so. What you&#39;ll find is that any app of even moderate complexity will not have a strict mapping from page to business concept to database table. Rather, these things will all differ greatly, and each serves a different purpose.</p><p>The job of your data models—and the tables they provide access to—is to store reliable and unambiguous data. Their job is to ensure there is no bad data such that when you ask the database a question, you get a reliable and correct answer.</p><p>Your views and business logic do not have this exact same job.</p><p>As such, your models should only contain:</p><ul><li>configuration to allow navigating the database.</li><li>methods to manage type conversions between your types and the strings or numbers required in the database</li><li>methods to query the data based on data definitions (not business logic).</li></ul><p>Business logic and data models <em>do</em> overlap at times, so there is some judgement in maintaining a clear separation of concerns. One way to manage this is to always put all logic elsewhere until you see a pattern of re-use that leads you to extract that logic to a data model.</p><h3 id="do-not-use-validations-on-models-unless-there-is-no-other-choice" tabindex="-1">Do Not Use Validations on Models Unless There is No Other Choice <a class="header-anchor" href="#do-not-use-validations-on-models-unless-there-is-no-other-choice" aria-label="Permalink to &quot;Do Not Use Validations on Models Unless There is No Other Choice&quot;"></a></h3><p>Sequel provides a validation layer for use on models. You should not generally use this, since a) data integrity is baked into your database design, and b) user interactions and constraints are part of the front-end.</p><p>That said, there are times when you have data constraints that cannot be modeled in the database. In that case, a validation on the data model is better than nothing. Since all data access for your app should go through your data models, a validation on a data model has a high chance of being checked.</p><div class="note custom-block github-alert"><p class="custom-block-title">NOTE</p><p>Since any process, app, or tool can manipulate your database, model-based validations won&#39;t be in effect, and therefore won&#39;t be applied. This is why you design your schema to avoid invalid data wherever possible.</p></div><h2 id="technical-notes" tabindex="-1">Technical Notes <a class="header-anchor" href="#technical-notes" aria-label="Permalink to &quot;Technical Notes&quot;"></a></h2><div class="important custom-block github-alert"><p class="custom-block-title">IMPORTANT</p><p>Technical Notes are for deeper understanding and debugging. While we will try to keep them up-to-date with changes to Brut&#39;s internals, the source code is always more correct.</p></div><p><em>Last Updated May 8, 2025</em></p><p>None at this time</p></div></div></main><footer class="VPDocFooter" data-v-e6f2a212 data-v-1bcd8184><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-1bcd8184><span class="visually-hidden" id="doc-footer-aria-label" data-v-1bcd8184>Pager</span><div class="pager" data-v-1bcd8184><a class="VPLink link pager-link prev" href="/database-schema.html" data-v-1bcd8184><!--[--><span class="desc" data-v-1bcd8184>Previous page</span><span class="title" data-v-1bcd8184>Database Schema</span><!--]--></a></div><div class="pager" data-v-1bcd8184><a class="VPLink link pager-link next" href="/seed-data.html" data-v-1bcd8184><!--[--><span class="desc" data-v-1bcd8184>Next page</span><span class="title" data-v-1bcd8184>Seed Data</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
-    <script>window.__VP_HASH_MAP__=JSON.parse("{\"adrs.md\":\"YglbWtQe\",\"ai.md\":\"ChLnvDAX\",\"assets.md\":\"BEF6Oz6K\",\"brut-js.md\":\"BMz0X1Rz\",\"business-logic.md\":\"DbuaOYGU\",\"cli.md\":\"DDMar_51\",\"components.md\":\"Ber8UBM0\",\"configuration.md\":\"DrJ6YVoZ\",\"css.md\":\"K5rOCOQY\",\"custom-element-tests.md\":\"DiLe-eFw\",\"database-access.md\":\"Dc8l2Plf\",\"database-schema.md\":\"BJ_JhXmO\",\"deployment.md\":\"CHTx2eTR\",\"dev-environment.md\":\"B1S9p5ZK\",\"dir-structure.md\":\"D1T2kGwj\",\"doc-conventions.md\":\"CDnWaEFg\",\"end-to-end-tests.md\":\"BJJdNDYL\",\"features.md\":\"BDWxnyNO\",\"flash-and-session.md\":\"CUsMxoNl\",\"form-constraints.md\":\"KlfXSKm2\",\"forms.md\":\"RK0zkhm0\",\"getting-started.md\":\"CGJ44juQ\",\"handlers.md\":\"C5tUwmmo\",\"hooks.md\":\"CoiYCKRc\",\"i18n.md\":\"DxkCKhUw\",\"index.md\":\"DnphWyQd\",\"instrumentation.md\":\"BcxjC4jd\",\"javascript.md\":\"D6fxhaQb\",\"jobs.md\":\"Bi3qb3v6\",\"keyword-injection.md\":\"CqLnnzIz\",\"layouts.md\":\"HEbeK7Jr\",\"lsp.md\":\"bE9dW8n9\",\"markdown-examples.md\":\"BPmtHlc-\",\"middleware.md\":\"BhOIsg59\",\"overview.md\":\"BpWAgPFH\",\"pages.md\":\"B3sQXpEd\",\"recipes_alternate-layouts.md\":\"C1QzVkA7\",\"recipes_authentication.md\":\"CyvoIW82\",\"recipes_custom-flash.md\":\"6gFqf2uL\",\"recipes_dev-env-secrets.md\":\"DC_jVY9U\",\"recipes_form-errors.md\":\"B5ptSzMO\",\"recipes_indexed-forms.md\":\"BYYQGW2C\",\"recipes_migrations.md\":\"Cid7-3cu\",\"recipes_text-field-component.md\":\"VhOsCtKI\",\"roadmap.md\":\"DqC1Y7Zt\",\"routes.md\":\"C1dgIBtD\",\"security.md\":\"Jn4SY1uK\",\"seed-data.md\":\"UZW0WxYN\",\"space-time-continuum.md\":\"D9rYGDFH\",\"tutorial.md\":\"BX6f6l00\",\"tutorials_01-intro.md\":\"CzZ3kpF_\",\"tutorials_02-dialog.md\":\"DE5WfCXI\",\"unit-tests.md\":\"vDsdBbO_\",\"why.md\":\"4WpxdrQ2\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Brut RB\",\"description\":\"Documentation for the Brut.RB web framework.\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"search\":{\"provider\":\"local\"},\"nav\":[{\"text\":\"Home\",\"link\":\"/\"},{\"text\":\"Getting Started\",\"link\":\"/getting-started\"},{\"text\":\"Overview\",\"link\":\"/overview\"},{\"text\":\"Brut API\",\"link\":\"/api/index.html\",\"target\":\"_self\"},{\"text\":\"BrutJS\",\"link\":\"/brut-js/api/index.html\",\"target\":\"_self\"},{\"text\":\"BrutCSS\",\"link\":\"/brut-css/index.html\",\"target\":\"_self\"}],\"outline\":[2,3],\"sidebar\":[{\"text\":\"Overview\",\"collapsed\":false,\"items\":[{\"text\":\"Getting Started\",\"link\":\"/getting-started\"},{\"text\":\"Concepts\",\"link\":\"/overview\"},{\"text\":\"Features\",\"link\":\"/features\"},{\"text\":\"Directory Structure\",\"link\":\"/dir-structure\"},{\"text\":\"Dev Environment\",\"link\":\"/dev-environment\"},{\"text\":\"Tutorial\",\"link\":\"/tutorial\"},{\"text\":\"Documentation Conventions\",\"link\":\"/doc-conventions\"}]},{\"text\":\"Front-End\",\"collapsed\":false,\"items\":[{\"text\":\"Routes\",\"link\":\"/routes\"},{\"text\":\"Pages\",\"link\":\"/pages\"},{\"text\":\"Layouts\",\"link\":\"/layouts\"},{\"text\":\"Forms\",\"link\":\"/forms\"},{\"text\":\"Form Constraints\",\"link\":\"/form-constraints\"},{\"text\":\"Handlers and Actions\",\"link\":\"/handlers\"},{\"text\":\"Components\",\"link\":\"/components\"},{\"text\":\"Flash and Session\",\"link\":\"/flash-and-session\"},{\"text\":\"Space/Time Continuum\",\"link\":\"/space-time-continuum\"},{\"text\":\"JavaScript\",\"link\":\"/javascript\"},{\"text\":\"CSS\",\"link\":\"/css\"},{\"text\":\"Assets\",\"link\":\"/assets\"},{\"text\":\"BrutJS\",\"link\":\"/brut-js\"}]},{\"text\":\"Back-End\",\"collapsed\":false,\"items\":[{\"text\":\"Database Schema\",\"link\":\"/database-schema\"},{\"text\":\"Database Access\",\"link\":\"/database-access\"},{\"text\":\"Seed Data\",\"link\":\"/seed-data\"},{\"text\":\"Jobs\",\"link\":\"/jobs\"},{\"text\":\"Business Logic\",\"link\":\"/business-logic\"}]},{\"text\":\"Framework\",\"collapsed\":false,\"items\":[{\"text\":\"Configuration\",\"link\":\"/configuration\"},{\"text\":\"Keyword Injection\",\"link\":\"/keyword-injection\"},{\"text\":\"I18n\",\"link\":\"/i18n\"},{\"text\":\"CLI / Tasks\",\"link\":\"/cli\"},{\"text\":\"Deployment\",\"link\":\"/deployment\"}]},{\"text\":\"Testing\",\"collapsed\":false,\"items\":[{\"text\":\"Unit Tests\",\"link\":\"/unit-tests\"},{\"text\":\"End-to-End Tests\",\"link\":\"/end-to-end-tests\"},{\"text\":\"Testing Custom Elements\",\"link\":\"/custom-element-tests\"}]},{\"text\":\"Advanced Topics\",\"collapsed\":true,\"items\":[{\"text\":\"Route Hooks\",\"link\":\"/hooks\"},{\"text\":\"Middleware\",\"link\":\"/middleware\"},{\"text\":\"Instrumentation\",\"link\":\"/instrumentation\"},{\"text\":\"Security\",\"link\":\"/security\"},{\"text\":\"LSP Support\",\"link\":\"/lsp\"}]},{\"text\":\"Recipes\",\"collapsed\":true,\"items\":[{\"text\":\"Alternate Layouts\",\"link\":\"/recipes/alternate-layouts\"},{\"text\":\"Authentication\",\"link\":\"/recipes/authentication\"},{\"text\":\"Custom Flash Class\",\"link\":\"/recipes/custom-flash\"},{\"text\":\"Indexed Form Elements\",\"link\":\"/recipes/indexed-forms\"},{\"text\":\"Managing Secrets in the Dev Environment\",\"link\":\"/recipes/dev-env-secrets\"},{\"text\":\"Migration Basics\",\"link\":\"/recipes/migrations\"},{\"text\":\"Styling Form Errors\",\"link\":\"/recipes/form-errors\"},{\"text\":\"Text Field Component\",\"link\":\"/recipes/text-field-component\"}]},{\"text\":\"Meta\",\"collapsed\":false,\"items\":[{\"text\":\"Why?!\",\"link\":\"/why\"},{\"text\":\"ADRs\",\"link\":\"/adrs\"},{\"text\":\"Roadmap to 1.0\",\"link\":\"/roadmap\"},{\"text\":\"AI Declaration\",\"link\":\"/ai\"}]}],\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/thirdtank/brut\"}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
-  </body>
-</html>