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

brut 0.17.0 → 0.18.0

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 (1104) 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/lib/brut/cli/apps/new/version.rb +3 -0
data/{mkbrut/lib/mkbrut → lib/brut/cli/apps/new}/versions.rb +2 -2
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 +191 -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/assets/tutorials_01-intro.md.CzZ3kpF_.lean.js DELETED Viewed

@@ -1 +0,0 @@

- import{_ as i,c as a,o as n,ag as e}from"./chunks/framework.C4nOkCZI.js";const t="/assets/welcome-to-brut.VSWzl17-.png",p="/assets/initial-home-page.DNIaYmgP.png",l="/assets/styled-home-page.BzdI7dWz.png",h="/assets/basic-form.DbHnu0oW.png",o="/assets/basic-form-with-violations.Cv6Y9-Q_.png",k="/assets/styled-form-with-violations.Bv_sa9tg.png",d="/assets/styled-form-with-server-side-violations.Bjxd8Dpv.png",r="/assets/styled-home-page-with-posts.Dd4kG89D.png",c="/assets/new-post-editor.DrHr-5oh.png",g="/assets/new-post-home-page.Bm34lyMg.png",B=JSON.parse('{"title":"Build a Blog in 15 Minutes","description":"","frontmatter":{},"headers":[],"relativePath":"tutorials/01-intro.md","filePath":"tutorials/01-intro.md"}'),E={name:"tutorials/01-intro.md"};function u(y,s,F,b,m,C){return n(),a("div",null,[...s[0]||(s[0]=[e("",330)])])}const f=i(E,[["render",u]]);export{B as __pageData,f as default};

data/docs/assets/tutorials_02-dialog.md.DE5WfCXI.js DELETED Viewed

@@ -1,274 +0,0 @@
-import{_ as i,c as a,o as n,ag as e}from"./chunks/framework.C4nOkCZI.js";const t="/assets/02-confirmation-flow.D9gZ0S5U.png",l="/assets/02-confirmation-dialog-browser.DH8ALFO4.png",p="/assets/02-confirmation-dialog-browser-element.DPsf0xUW.png",h="/assets/02-confirmation-dialog-browser-element-styled.3NEGM20-.png",u=JSON.parse('{"title":"Tutorial: Styled Confirmation Dialog","description":"","frontmatter":{},"headers":[],"relativePath":"tutorials/02-dialog.md","filePath":"tutorials/02-dialog.md"}'),r={name:"tutorials/02-dialog.md"};function o(k,s,d,c,g,E){return n(),a("div",null,[...s[0]||(s[0]=[e(`<h1 id="tutorial-styled-confirmation-dialog" tabindex="-1">Tutorial: Styled Confirmation Dialog <a class="header-anchor" href="#tutorial-styled-confirmation-dialog" aria-label="Permalink to &quot;Tutorial: Styled Confirmation Dialog&quot;"></a></h1><p>For actions that can&#39;t be undone, it&#39;s customary to confirm with the visitor that they are sure they want to take that action. Brut provides support for this. You can use <code>window.confirm</code> or create your own styled <code>&lt;dialog&gt;</code> that Brut will use. Both approaches don&#39;t require writing any JavaScript yourself.</p><p><a href="https://video.hardlimit.com/w/4y8Pjd8VVPDK372mozCUdj" target="_blank" rel="noreferrer">You can watching this as a screencast instead</a>.</p><h2 id="set-up" tabindex="-1">Set Up <a class="header-anchor" href="#set-up" aria-label="Permalink to &quot;Set Up&quot;"></a></h2><p>If you haven&#39;t followed the <a href="/tutorials/01-intro.html">initial tutorial</a>, you&#39;ll need to pull down the blog app so you have a place to work.</p><ol><li><p><a href="https://docker.com" target="_blank" rel="noreferrer">Install Docker</a></p><div class="tip custom-block github-alert"><p class="custom-block-title">TIP</p><p>If you are on Windows, we <em>highly</em> recommend you use the Windows Subystem for Linux (WSL2), as this makes Brut, web developement, and, honestly, your entire life as you know it, far easier than trying to get things working natively in Windows.</p></div></li><li><p>Clone the <code>blog-demo</code> repo (<strong>don&#39;t use Codespaces as it is not supported</strong>):</p><div class="vp-code-group vp-adaptive-theme"><div class="tabs"><input type="radio" name="group-V8mJe" id="tab-jeeVnVY" checked><label data-title="Terminal" for="tab-jeeVnVY">Terminal</label><input type="radio" name="group-V8mJe" id="tab-3j_ZrnP"><label data-title="GitHub CLI" for="tab-3j_ZrnP">GitHub CLI</label></div><div class="blocks"><div class="language-bash vp-adaptive-theme active"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> clone</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> git@github.com:thirdtank/blog-demo.git</span></span></code></pre></div><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">gh</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> repo</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> clone</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> thirdtank/blog-demo</span></span></code></pre></div></div></div></li><li><p><code>cd</code> to what you just cloned.</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</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;">cd</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> blog-demo</span></span></code></pre></div></li><li><p>Create a branch named <code>confirmation-dialog</code> off of the <code>02-confirmation-dialog/start</code> branch:</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> checkout</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -b</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> confirmation-dialog</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> 02-confirmation-dialog/start</span></span></code></pre></div></li><li><p>Build your development image.</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">dx/build</span></span></code></pre></div></li><li><p>Start the environment, which will pull down Postgres and otel-desktop-viewer</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">dx/start</span></span></code></pre></div></li><li><p>In another terminal window, &quot;log in&quot; to your dev environment (note that you can use your editor on your computer to edit code)</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">dx/exec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bash</span></span></code></pre></div></li><li><p>Set up and run tests to make sure things are working before you start making changes. Note, this is <strong>inside the container</strong>, not directly on your computer.</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bin/setup</span></span>
-<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bin/ci</span></span></code></pre></div></li></ol><h2 id="what-we-re-doing" tabindex="-1">What We&#39;re Doing <a class="header-anchor" href="#what-we-re-doing" aria-label="Permalink to &quot;What We&#39;re Doing&quot;"></a></h2><p>When writing a blog post, if the title and content satisfy all constraints, the post is saved and shown on the home page. Because this can&#39;t currently be undone, we want the user to confirm the posting, just to avoid any accidents.</p><p>Initially, we will use <code>window.confirm</code> to do this. After that, we&#39;ll create a nicely styled dialog to do the confirmation. While this will require that the browser execute JavaScript, we won&#39;t be writing any. We&#39;ll use Brut-provided Web Components to do this.</p><p><img src="`+t+`" alt="Diagram showing the flow, with a screenshot of the blog post editor on the left, and a pink arrow from
-the &#39;Post it&#39; button going to the text &#39;Are You Sure?&#39;. From there, a pink line labeled &#39;No&#39; goes back
-to the editor, while a pink line labeled &#39;Yes&#39; goes to a screenshot of the home page showing the blog
-post."></p><h2 id="initial-version-using-window-confirm" tabindex="-1">Initial Version Using <code>window.confirm</code> <a class="header-anchor" href="#initial-version-using-window-confirm" aria-label="Permalink to &quot;Initial Version Using \`window.confirm\`&quot;"></a></h2><p>Brut includes an <a href="https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements" target="_blank" rel="noreferrer">autonomous custom element</a> named <a href="/brut-js/api/ConfirmSubmit.html" target="_self" rel="noopener" data-no-router><code style="white-space:nowrap;">&lt;brut-confirm-submit&gt;</code></a>. This element wraps an existing submit button and intercepts its form submission to ask for confirmation. If confirmation is granted, the form is submitted. If not, it&#39;s not.</p><p>It is used on a per-button basis, which gives you flexibility in handling what buttons do what within the form. It <em>only</em> works on <code>&lt;button&gt;</code> and <code>&lt;input type=&quot;submit&quot;&gt;</code> elements.</p><div class="language-html vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">html</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&lt;</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">form</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> ...</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&gt;</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  &lt;</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">input</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> ...</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&gt;</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  &lt;</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">brut-confirm-submit</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> message</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;You sure?&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&gt;</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    &lt;</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">button</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&gt;Submit&lt;/</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">button</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&gt;    </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">&lt;!-- if clicked, confirmation is requested --&gt;</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  &lt;/</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">brut-confirm-submit</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&gt;</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  &lt;</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">button</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&gt;Also Submit&lt;/</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">button</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&gt; </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">&lt;!-- if clicked, form is submitted --&gt;</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&lt;/</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">form</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&gt;</span></span></code></pre></div><h3 id="adding-confirmation-to-blog-posting" tabindex="-1">Adding Confirmation to Blog Posting <a class="header-anchor" href="#adding-confirmation-to-blog-posting" aria-label="Permalink to &quot;Adding Confirmation to Blog Posting&quot;"></a></h3><p>We can use it on <code>BlogPostEditorPage</code>. Open up <code>app/src/front_end/pages/blog_post_editor_page.rb</code> and make this change toward the end of <code>page_template</code></p><div class="language-ruby vp-adaptive-theme line-numbers-mode"><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 highlighted"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">brut_confirm_submit</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">  message:</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;This will post immediately to the home page&quot;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">do</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  button { </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">t</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">([</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">:form</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">:post</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">]) }</span></span>
-<span class="line highlighted"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">end</span></span></code></pre><div class="line-numbers-wrapper" aria-hidden="true"><span class="line-number">21</span><br><span class="line-number">22</span><br><span class="line-number">23</span><br><span class="line-number">24</span><br><span class="line-number">25</span><br></div></div><p>The method <code>brut_confirm_submit</code> is provided by Phlex due to a call to <a href="https://www.phlex.fun/sgml/html-elements.html#custom-elements" target="_blank" rel="noreferrer"><code>register_element</code></a> in <a href="/api/Brut/FrontEnd/Component.html" target="_self" rel="noopener" data-no-router><code>Brut::FrontEnd::Component</code></a>.</p><p>Now, start up your server using <code>bin/dev</code>:</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bin/dev</span></span></code></pre></div><div class="language-txt vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">txt</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span># OUTPUT</span></span>
-<span class="line"><span>« LOTS OF OUTPUT »</span></span>
-<span class="line"><span>15:50:10 startup_message.1 | Your app is now running at</span></span>
-<span class="line"><span>15:50:10 startup_message.1 | </span></span>
-<span class="line"><span>15:50:10 startup_message.1 |   http://localhost:6502</span></span>
-<span class="line"><span>15:50:10 startup_message.1 |</span></span></code></pre></div><p>Open <code>http://localhost:6502</code> in your browser, then click &quot;Write New Blog Post&quot;, write a valid post and click &quot;Post It&quot;. You should see the browser&#39;s <code>window.confirm</code> show up with the value for <code>message:</code> as the message.</p><p><img src="`+l+`" alt="Screenshot showing the browser&#39;s builtin confirmation dialog"></p><p>Click &quot;Cancel&quot; and the dialog goes away and nothing is posted. Click &quot;Post It&quot; again, then click &quot;OK&quot;, and the post goes through as normal.</p><p>Even though we are going to build our own dialog, let&#39;s keep our end-to-end test working.</p><h3 id="interacting-with-window-confirm-in-end-to-end-tests" tabindex="-1">Interacting with <code>window.confirm</code> in End-to-End Tests <a class="header-anchor" href="#interacting-with-window-confirm-in-end-to-end-tests" aria-label="Permalink to &quot;Interacting with \`window.confirm\` in End-to-End Tests&quot;"></a></h3><p>Let&#39;s start by seeing how the test fails:</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bin/test</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> e2e</span></span></code></pre></div><div class="language-txt vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">txt</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span># OUTPUT</span></span>
-<span class="line"><span>&gt; bin/test e2e</span></span>
-<span class="line"><span>[ bin/test ] Rebuilding test database schema</span></span>
-<span class="line"><span>[ bin/test ] Executing [&quot;bin/db rebuild --env=test&quot;]</span></span>
-<span class="line"><span>[ bin/db ] Database exists. Dropping...</span></span>
-<span class="line"><span>[ bin/db ] blog_test does not exit. Creating...</span></span>
-<span class="line"><span>[ bin/db ] Migrations applied</span></span>
-<span class="line"><span>[ bin/test ] [&quot;bin/db rebuild --env=test&quot;] succeeded</span></span>
-<span class="line"><span>[ bin/test ] Running all tests</span></span>
-<span class="line"><span>[ bin/test ] Executing [&quot;bin/rspec -I /Users/davec/Projects/ThirdTank/blog-demo/specs -I /Users/davec/Projects/ThirdTank/blog-demo/app/src -I lib/ --tag e2e -P \\&quot;**/*.spec.rb\\&quot; /Users/davec/Projects/ThirdTank/blog-demo/specs/&quot;]</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>«TONS OF OUTPUT»</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>Failures:</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>  1) We can post a new blog post allows posting a post</span></span>
-<span class="line"><span>     Failure/Error: expect(content_error_message).to have_text(&quot;This field does not have enough words&quot;)</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>       /Users/davec/Projects/ThirdTank/blog-demo/local-gems/gem-home/gems/playwright-ruby-client-1.52.0/lib/playwright/locator_assertions_impl.rb:53:in &#39;Playwright::LocatorAssertionsImpl#expect_impl&#39;:  (Playwright::AssertionError)</span></span>
-<span class="line highlighted"><span>       Locator expected to have text &#39;This field does not have enough words&#39;</span></span>
-<span class="line highlighted"><span>       Actual value &lt;element(s) not found&gt; </span></span>
-<span class="line"><span>       Call log:</span></span>
-<span class="line"><span>        - locator#Playwright::Locator#expect with timeout 5000ms</span></span>
-<span class="line"><span>         - waiting for locator(&quot;brut-cv-messages[input-name=&#39;content&#39;] brut-cv&quot;)</span></span>
-<span class="line"><span>       	from /Users/davec/Projects/ThirdTank/blog-demo/local-gems/gem-home/gems/playwright-ruby-client-1.52.0/lib/playwright/locator_assertions_impl.rb:397:in &#39;Playwright::LocatorAssertionsImpl#to_have_text&#39;</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>«MASSIVE STACK TRACE»</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>       	from /Users/davec/Projects/ThirdTank/blog-demo/local-gems/gem-home/gems/rspec-core-3.13.5/lib/rspec/core/runner.rb:45:in &#39;RSpec::Core::Runner.invoke&#39;</span></span>
-<span class="line"><span>       	from /Users/davec/Projects/ThirdTank/blog-demo/local-gems/gem-home/gems/rspec-core-3.13.5/exe/rspec:4:in &#39;&lt;top (required)&gt;&#39;</span></span>
-<span class="line"><span>       	from bin/rspec:16:in &#39;Kernel#load&#39;</span></span>
-<span class="line"><span>       	from bin/rspec:16:in &#39;&lt;main&gt;&#39;</span></span>
-<span class="line highlighted"><span>     # ./specs/e2e/home_page.spec.rb:34:in &#39;block (2 levels) in &lt;top (required)&gt;&#39;</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>«MASSIVE STACK TRACE»</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>     # ./local-gems/gem-home/gems/brut-0.5.0/lib/brut/spec_support/rspec_setup.rb:129:in &#39;block in Brut::SpecSupport::RSpecSetup#setup!&#39;</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>Finished in 7.6 seconds (files took 0.7169 seconds to load)</span></span>
-<span class="line"><span>1 example, 1 failure</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>Failed examples:</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>bin/test run ./specs/e2e/home_page.spec.rb:4 # We can post a new blog post allows posting a post</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>Randomized with seed 25427</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>[ bin/test ] error: [&quot;bin/rspec -I /Users/davec/Projects/ThirdTank/blog-demo/specs -I /Users/davec/Projects/ThirdTank/blog-demo/app/src -I lib/ --tag e2e -P \\&quot;**/*.spec.rb\\&quot; /Users/davec/Projects/ThirdTank/blog-demo/specs/&quot;] failed - exited 1</span></span></code></pre></div><p>I&#39;ve highlighted the relevant parts. Playwright loves stack traces and obtuse errors.</p><p>Let&#39;s look at line 34 of <code>specs/e2e/home_page.spec.rb</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:#6F42C1;--shiki-dark:#B392F0;">expect</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(title_error_message).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">to</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">   have_text</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;This field is too short&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">expect</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(content_error_message).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">to</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> have_text</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;This field is required&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">title_field.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">fill</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;New blog post&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">content_field.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">fill</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;Too short&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">submit_button.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">click</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">expect</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(page).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">to</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> be_page_for</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">BlogPostEditorPage</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;">expect</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(content_error_message).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">to</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> have_text</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;This field does not have enough words&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">content_field.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">fill</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;This is a longer post, so we should be OK&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">submit_button.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">click</span></span>
-<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">expect</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(page).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">to</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> be_page_for</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">HomePage</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span></code></pre></div><p>The test was expecting to hit the server and re-generate the page with a server-side error message. Although <a href="/brut-js/api/ConfirmSubmit.html" target="_self" rel="noopener" data-no-router><code style="white-space:nowrap;">&lt;brut-confirm-submit&gt;</code></a> did not pop up when there were client-side constraint violations, it doesn&#39;t know there are server-side ones, so it is waiting for us to confirm the submission.</p><p>Playwright will <a href="https://playwright.dev/docs/dialogs" target="_blank" rel="noreferrer">automatically dismiss any browser-based dialogs</a>. To handle them, our test will need to register a handler. To do this with Ruby, we&#39;ll call <code>page.on</code> and given it an event name and a block to handle the event.</p><p>The event name is &quot;dialog&quot; and a Playwright <code>Dialog</code> will be passed. We can call <code>accept</code> on that.</p><p>Here&#39;s the change. Note the line numbers for reference in the file. You want to set this up before <code>submit_button.click</code> is called.</p><div class="language-ruby vp-adaptive-theme line-numbers-mode"><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:#24292E;--shiki-dark:#E1E4E8;">   content_field.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">fill</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;Too short&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"></span>
-<span class="line highlighted"><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">   accept_dialog</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> = </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">-&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(dialog) {</span></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">     dialog.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">accept</span></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">   }</span></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">   page.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">on</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;dialog&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,accept_dialog)</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">   submit_button.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">click</span></span></code></pre><div class="line-numbers-wrapper" aria-hidden="true"><span class="line-number">28</span><br><span class="line-number">29</span><br><span class="line-number">30</span><br><span class="line-number">31</span><br><span class="line-number">32</span><br><span class="line-number">33</span><br><span class="line-number">34</span><br><span class="line-number">35</span><br></div></div><p>Note that this configuration will stay in effect for the rest of the test. That means when we later save the blog post, it will accept the dialog.</p><p>Now, <code>bin/test e2e</code> should pass:</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bin/test</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> e2e</span></span></code></pre></div><div class="language-txt vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">txt</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>#OUTPUT</span></span>
-<span class="line"><span>[ bin/test ] Rebuilding test database schema</span></span>
-<span class="line"><span>[ bin/test ] Executing [&quot;bin/db rebuild --env=test&quot;]</span></span>
-<span class="line"><span>[ bin/db ] Database exists. Dropping...</span></span>
-<span class="line"><span>[ bin/db ] blog_test does not exit. Creating...</span></span>
-<span class="line"><span>[ bin/db ] Migrations applied</span></span>
-<span class="line"><span>[ bin/test ] [&quot;bin/db rebuild --env=test&quot;] succeeded</span></span>
-<span class="line"><span>[ bin/test ] Running all tests</span></span>
-<span class="line"><span>[ bin/test ] Executing [&quot;bin/rspec -I /Users/davec/Projects/ThirdTank/blog-demo/specs -I /Users/davec/Projects/ThirdTank/blog-demo/app/src -I lib/ --tag e2e -P \\&quot;**/*.spec.rb\\&quot; /Users/davec/Projects/ThirdTank/blog-demo/specs/&quot;]</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>«TONS OF OUTPUT»</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>Finished in 3.57 seconds (files took 0.7341 seconds to load)</span></span>
-<span class="line highlighted"><span>1 example, 0 failures</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>Randomized with seed 1445</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>[ bin/test ] [&quot;bin/rspec -I /Users/davec/Projects/ThirdTank/blog-demo/specs -I /Users/davec/Projects/ThirdTank/blog-demo/app/src -I lib/ --tag e2e -P \\&quot;**/*.spec.rb\\&quot; /Users/davec/Projects/ThirdTank/blog-demo/specs/&quot;] succeeded</span></span>
-<span class="line"><span>[ bin/test ] Re-Rebuilding test database schema</span></span>
-<span class="line"><span>[ bin/test ] Executing [&quot;bin/db rebuild --env=test&quot;]</span></span>
-<span class="line"><span>[ bin/db ] Database exists. Dropping...</span></span>
-<span class="line"><span>[ bin/db ] blog_test does not exit. Creating...</span></span>
-<span class="line"><span>[ bin/db ] Migrations applied</span></span>
-<span class="line"><span>[ bin/test ] [&quot;bin/db rebuild --env=test&quot;] succeeded</span></span></code></pre></div><p><code>window.confirm</code> is great in a pinch, but we&#39;d like to use our own styled dialog if possible.</p><h2 id="using-a-styled-dialog" tabindex="-1">Using a Styled Dialog <a class="header-anchor" href="#using-a-styled-dialog" aria-label="Permalink to &quot;Using a Styled Dialog&quot;"></a></h2><p>The <a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/dialog" target="_blank" rel="noreferrer"><code>&lt;dialog&gt;</code></a> element has been available since 2022 and provides some of what we&#39;ll need to confirm a blog post. Brut can enhance a <code>&lt;dialog&gt;</code> to act as a confirmation dialog by using the <a href="/brut-js/api/ConfirmationDialog.html" target="_self" rel="noopener" data-no-router><code style="white-space:nowrap;">&lt;brut-confirmation-dialog&gt;</code></a> custom element.</p><p>Like <a href="/brut-js/api/ConfirmSubmit.html" target="_self" rel="noopener" data-no-router><code style="white-space:nowrap;">&lt;brut-confirm-submit&gt;</code></a>, it wraps an element and enhances it. To work, the <code>&lt;dialog&gt;</code> must include certain elements to represent the message, a button for consent, and a button for denial.</p><p>Let&#39;s see it in action.</p><h3 id="creating-a-styled-dialog" tabindex="-1">Creating a Styled Dialog <a class="header-anchor" href="#creating-a-styled-dialog" aria-label="Permalink to &quot;Creating a Styled Dialog&quot;"></a></h3><p>Edit <code>app/src/front_end/pages/blog_post_editor_page.rb</code> and add the dialog at the end of <code>page_template</code>:</p><div class="language-ruby vp-adaptive-theme line-numbers-mode"><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:#6F42C1;--shiki-dark:#B392F0;">    brut_confirm_submit</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span></span>
-<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">      message:</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;This will post immediately to the home page&quot;</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    ) </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">do</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">      button { </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">t</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">([</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">:form</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">:post</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>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">brut_confirmation_dialog </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">do</span></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  dialog </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">do</span></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    h1</span></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    div </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">do</span></span>
-<span class="line highlighted"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">      button</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">value:</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;ok&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line highlighted"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">      button</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">value:</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;cancel&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) { </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;Don&#39;t Publish&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
-<span class="line highlighted"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">    end</span></span>
-<span class="line highlighted"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">  end</span></span>
-<span class="line highlighted"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">end</span></span></code></pre><div class="line-numbers-wrapper" aria-hidden="true"><span class="line-number">21</span><br><span class="line-number">22</span><br><span class="line-number">23</span><br><span class="line-number">24</span><br><span class="line-number">25</span><br><span class="line-number">26</span><br><span class="line-number">27</span><br><span class="line-number">28</span><br><span class="line-number">29</span><br><span class="line-number">30</span><br><span class="line-number">31</span><br><span class="line-number">32</span><br><span class="line-number">33</span><br><span class="line-number">34</span><br><span class="line-number">35</span><br><span class="line-number">36</span><br></div></div><p>Your browser should provide a default visual style for the dialog (that is terrible), but you can see that <a href="/brut-js/api/ConfirmSubmit.html" target="_self" rel="noopener" data-no-router><code style="white-space:nowrap;">&lt;brut-confirm-submit&gt;</code></a> will now use it when you click &quot;Post It&quot;:</p><p><img src="`+p+`" alt="Screenshot showing the browser&#39;s styling of a dialog element"></p><p><a href="/brut-js/api/ConfirmSubmit.html" target="_self" rel="noopener" data-no-router><code style="white-space:nowrap;">&lt;brut-confirm-submit&gt;</code></a> and <a href="/brut-js/api/ConfirmationDialog.html" target="_self" rel="noopener" data-no-router><code style="white-space:nowrap;">&lt;brut-confirmation-dialog&gt;</code></a> work together to allow you to style these dialog how you&#39;d like. It expects an <code>h1</code> element inside where the message will go. It expects a <code>&lt;button value=&quot;ok&quot;&gt;</code> that, when clicked, indicates the visitor is accepting the dialog. A <code>&lt;button value=&quot;cancel&quot;&gt;</code> should also be present that, when clicked, indicates the visitor wants to abort and not submit the form.</p><p>If you&#39;ve never worked with a <code>&lt;dialog&gt;</code> before, it can be handy to set <code>open</code> on the element so it shows up without having to click something to open it. It doesn&#39;t show exactly as it would when we use JavaScript to show it, but it&#39;s good enough to get your styling work done:</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:#6F42C1;--shiki-dark:#B392F0;">dialog</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">open:</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">do</span></span>
-<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">  # ...</span></span>
-<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">end</span></span></code></pre></div><p>Here&#39;s the CSS I chose. Add this to <code>app/src/front_end/css/index.css</code>, inside the <code>.BlogPostEditorPage</code> block:</p><div class="language-css vp-adaptive-theme line-numbers-mode"><button title="Copy Code" class="copy"></button><span class="lang">css</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">      cursor</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: pointer;</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">      &amp;</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">:hover</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
-<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">        background-color</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">#ACFFAC</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>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  }</span></span>
-<span class="line highlighted"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">  brut-confirmation-dialog</span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;"> dialog</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">    border-radius</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">rem</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">    border-width</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">0</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">    box-shadow</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">rgb</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">200</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">200</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">200</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">px</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> 1</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">px</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> 12.72</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">px</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> 3.46892</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">px</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">    background-color</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">white</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">    padding</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">rem</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">    h</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">1 {</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">      color</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">black</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">      font-size</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">2</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">rem</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    }</span></span>
-<span class="line highlighted"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">    div</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">      width</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">100</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">%</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">      display</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">flex</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">      gap</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">0.25</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">rem</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">      align-items</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">center</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">      justify-content</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">space-between</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">      button</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">        padding-left</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">2</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">rem</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">        padding-right</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">2</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">rem</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">        padding-top</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">rem</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">        padding-bottom</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">rem</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">        border-radius</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">rem</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">        font-size</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">150</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">%</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">        align-self</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">end</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">        cursor</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">pointer</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">        &amp;[</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">value</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">=&quot;</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">ok</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">&quot;] {</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">          background-color</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">#E5FFE5</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">          border</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">solid</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> thin</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> #006300</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">          color</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">#006300</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">        }</span></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">        &amp;[</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">value</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;cancel&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">] {</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">          background-color</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">#FFE5E5</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">          border</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">solid</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> thin</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> #630000</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">          color</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">#630000</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">        }</span></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">      }</span></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">    }</span></span>
-<span class="line highlighted"><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:#22863A;--shiki-dark:#85E89D;">brut-cv</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
-<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">  display</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">none</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span>
-<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">  color</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">#A60053</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">;</span></span></code></pre><div class="line-numbers-wrapper" aria-hidden="true"><span class="line-number">59</span><br><span class="line-number">60</span><br><span class="line-number">61</span><br><span class="line-number">62</span><br><span class="line-number">63</span><br><span class="line-number">64</span><br><span class="line-number">65</span><br><span class="line-number">66</span><br><span class="line-number">67</span><br><span class="line-number">68</span><br><span class="line-number">69</span><br><span class="line-number">70</span><br><span class="line-number">71</span><br><span class="line-number">72</span><br><span class="line-number">73</span><br><span class="line-number">74</span><br><span class="line-number">75</span><br><span class="line-number">76</span><br><span class="line-number">77</span><br><span class="line-number">78</span><br><span class="line-number">79</span><br><span class="line-number">80</span><br><span class="line-number">81</span><br><span class="line-number">82</span><br><span class="line-number">83</span><br><span class="line-number">84</span><br><span class="line-number">85</span><br><span class="line-number">86</span><br><span class="line-number">87</span><br><span class="line-number">88</span><br><span class="line-number">89</span><br><span class="line-number">90</span><br><span class="line-number">91</span><br><span class="line-number">92</span><br><span class="line-number">93</span><br><span class="line-number">94</span><br><span class="line-number">95</span><br><span class="line-number">96</span><br><span class="line-number">97</span><br><span class="line-number">98</span><br><span class="line-number">99</span><br><span class="line-number">100</span><br><span class="line-number">101</span><br><span class="line-number">102</span><br><span class="line-number">103</span><br><span class="line-number">104</span><br><span class="line-number">105</span><br><span class="line-number">106</span><br></div></div><p>Now, reload the page and click &quot;Post It&quot;. You should see a somewhat nicer dialog:</p><p><img src="`+h+`" alt="Screenshot showing the our styling of a dialog element"></p><p>And, sure enough if you click &quot;Don&#39;t Publish&quot;, the dialog clears and nothing happens. If you click &quot;Post It!&quot;, it submits the form.</p><p>A few notes on how this works:</p><ul><li>The contents of the <code>&lt;h1&gt;</code> come from the <code>message</code> attribute of the <strong><a href="/brut-js/api/ConfirmSubmit.html" target="_self" rel="noopener" data-no-router><code style="white-space:nowrap;">&lt;brut-confirm-submit&gt;</code></a></strong>. This allows you to re-use the confirmation dialog for other purposes.</li><li>The content of the <code>&lt;button value=&quot;ok&quot; ...&gt;</code> is the same as the button wrapped by <a href="/brut-js/api/ConfirmSubmit.html" target="_self" rel="noopener" data-no-router><code style="white-space:nowrap;">&lt;brut-confirm-submit&gt;</code></a>.</li></ul><p>Also note how the use of semantic and standard HTML allows us to style the elements without classes or <code>data-</code> tags.</p><p>Let&#39;s look back at our tests.</p><h3 id="interacting-with-our-dialog-in-tests" tabindex="-1">Interacting with Our Dialog in Tests <a class="header-anchor" href="#interacting-with-our-dialog-in-tests" aria-label="Permalink to &quot;Interacting with Our Dialog in Tests&quot;"></a></h3><p>Run our end-to-end test:</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bin/test</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> e2e</span></span></code></pre></div><p>It should fail:</p><div class="language-txt vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">txt</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>#OUTPUT</span></span>
-<span class="line"><span>&gt; bin/test e2e</span></span>
-<span class="line"><span>[ bin/test ] Rebuilding test database schema</span></span>
-<span class="line"><span>[ bin/test ] Executing [&quot;bin/db rebuild --env=test&quot;]</span></span>
-<span class="line"><span>[ bin/db ] Database exists. Dropping...</span></span>
-<span class="line"><span>[ bin/db ] blog_test does not exit. Creating...</span></span>
-<span class="line"><span>[ bin/db ] Migrations applied</span></span>
-<span class="line"><span>[ bin/test ] [&quot;bin/db rebuild --env=test&quot;] succeeded</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>«TONS OF OUTPUT»</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>Failures:</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>  1) We can post a new blog post allows posting a post</span></span>
-<span class="line"><span>     Failure/Error: expect(content_error_message).to have_text(&quot;This field does not have enough words&quot;)</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>       /Users/davec/Projects/ThirdTank/blog-demo/local-gems/gem-home/gems/playwright-ruby-client-1.52.0/lib/playwright/locator_assertions_impl.rb:53:in &#39;Playwright::LocatorAssertionsImpl#expect_impl&#39;:  (Playwright::AssertionError)</span></span>
-<span class="line highlighted"><span>       Locator expected to have text &#39;This field does not have enough words&#39;</span></span>
-<span class="line highlighted"><span>       Actual value &lt;element(s) not found&gt; </span></span>
-<span class="line"><span>       Call log:</span></span>
-<span class="line"><span>        - locator#Playwright::Locator#expect with timeout 5000ms</span></span>
-<span class="line"><span>         - waiting for locator(&quot;brut-cv-messages[input-name=&#39;content&#39;] brut-cv&quot;)</span></span>
-<span class="line"><span>       	from /Users/davec/Projects/ThirdTank/blog-demo/local-gems/gem-home/gems/playwright-ruby-client-1.52.0/lib/playwright/locator_assertions_impl.rb:397:in &#39;Playwright::LocatorAssertionsImpl#to_have_text&#39;</span></span>
-<span class="line"><span>       	from /Users/davec/Projects/ThirdTank/blog-demo/local-gems/gem-home/gems/playwright-ruby-client-1.52.0/lib/playwright_api/locator_assertions.rb:642:in &#39;Playwright::LocatorAssertions#to_have_text&#39;</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>«HUGE STACK TRACE»</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>       	from /Users/davec/Projects/ThirdTank/blog-demo/local-gems/gem-home/gems/rspec-core-3.13.5/lib/rspec/core/runner.rb:45:in &#39;RSpec::Core::Runner.invoke&#39;</span></span>
-<span class="line"><span>       	from /Users/davec/Projects/ThirdTank/blog-demo/local-gems/gem-home/gems/rspec-core-3.13.5/exe/rspec:4:in &#39;&lt;top (required)&gt;&#39;</span></span>
-<span class="line"><span>       	from bin/rspec:16:in &#39;Kernel#load&#39;</span></span>
-<span class="line"><span>       	from bin/rspec:16:in &#39;&lt;main&gt;&#39;</span></span>
-<span class="line"><span>     # ./specs/e2e/home_page.spec.rb:39:in &#39;block (2 levels) in &lt;top (required)&gt;&#39;</span></span>
-<span class="line highlighted"><span></span></span>
-<span class="line"><span>«HUGE STACK TRACE»</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>     # ./local-gems/gem-home/gems/brut-0.5.0/lib/brut/spec_support/rspec_setup.rb:185:in &#39;Brut::SpecSupport::RSpecSetup::OptionalSidekiqSupport#disable_sidekiq_testing&#39;</span></span>
-<span class="line"><span>     # ./local-gems/gem-home/gems/brut-0.5.0/lib/brut/spec_support/rspec_setup.rb:129:in &#39;block in Brut::SpecSupport::RSpecSetup#setup!&#39;</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>Finished in 8.31 seconds (files took 0.66944 seconds to load)</span></span>
-<span class="line"><span>1 example, 1 failure</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>Failed examples:</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>bin/test run ./specs/e2e/home_page.spec.rb:4 # We can post a new blog post allows posting a post</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>Randomized with seed 29349</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>[ bin/test ] error: [&quot;bin/rspec -I /Users/davec/Projects/ThirdTank/blog-demo/specs -I /Users/davec/Projects/ThirdTank/blog-demo/app/src -I lib/ --tag e2e -P \\&quot;**/*.spec.rb\\&quot; /Users/davec/Projects/ThirdTank/blog-demo/specs/&quot;] failed - exited 1</span></span></code></pre></div><p>Line 39 is the same line that failed when we first added the confirmation. Since Playwright interacts with browser dialogs via an event, the event listener we added is never fired, so our error is simply that the page didn&#39;t refresh.</p><p>Let&#39;s remove the listener and instead interact with the new dialog. We should click &quot;cancel&quot; to make sure it doens&#39;t do anything, then click &quot;ok&quot;.</p><p>One problem with Playwright (well, with web pages in general) is that it&#39;s not easy to assert that something didn&#39;t happen or isn&#39;t there. We can&#39;t click the cancel button, then assert that there is no error message.</p><p>Instead, we&#39;ll assert that the dialog is not being shown.</p><p>To do that, we&#39;ll locate the dialog, the ok button, and the cancel button. The assertion that the dialog isn&#39;t shown requires accessing the JavaScript <code>open</code> property and checking that it&#39;s false. The rest of the test works as before, punctuated with calls to <code>dialog_ok_button.click</code> to accept the dialog.</p><div class="language-ruby vp-adaptive-theme line-numbers-mode"><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:#6F42C1;--shiki-dark:#B392F0;">expect</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(content_error_message).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">to</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> have_text</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;This field is required&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">title_field.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">fill</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;New blog post&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">content_field.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">fill</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;Too short&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"></span>
-<span class="line highlighted"><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">dialog</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">               = page.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">locator</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;brut-confirmation-dialog dialog&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line highlighted"><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">dialog_ok_button</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">     = page.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">locator</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;brut-confirmation-dialog button[value=&#39;ok&#39;]&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line highlighted"><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">dialog_cancel_button</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> = page.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">locator</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;brut-confirmation-dialog button[value=&#39;cancel&#39;]&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">submit_button.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">click</span></span>
-<span class="line"></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">dialog_cancel_button.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">click</span></span>
-<span class="line highlighted"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">expect</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(dialog).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">to</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> have_js_property</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">:open</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">false</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">submit_button.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">click</span></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">dialog_ok_button.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">click</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">expect</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(page).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">to</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> be_page_for</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">BlogPostEditorPage</span><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;">expect</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(content_error_message).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">to</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> have_text</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;This field does not have enough words&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">content_field.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">fill</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;This is a longer post, so we should be OK&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">submit_button.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">click</span></span>
-<span class="line highlighted"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">dialog_ok_button.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">click</span></span>
-<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">expect</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(page).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">to</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> be_page_for</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">HomePage</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">new_post</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;">BlogPost</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">order</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:#6F42C1;--shiki-dark:#B392F0;">desc</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">:created_at</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)).</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">first</span></span></code></pre><div class="line-numbers-wrapper" aria-hidden="true"><span class="line-number">25</span><br><span class="line-number">26</span><br><span class="line-number">27</span><br><span class="line-number">28</span><br><span class="line-number">29</span><br><span class="line-number">30</span><br><span class="line-number">31</span><br><span class="line-number">32</span><br><span class="line-number">33</span><br><span class="line-number">34</span><br><span class="line-number">35</span><br><span class="line-number">36</span><br><span class="line-number">37</span><br><span class="line-number">38</span><br><span class="line-number">39</span><br><span class="line-number">40</span><br><span class="line-number">41</span><br><span class="line-number">42</span><br><span class="line-number">43</span><br><span class="line-number">44</span><br><span class="line-number">45</span><br><span class="line-number">46</span><br><span class="line-number">47</span><br><span class="line-number">48</span><br><span class="line-number">49</span><br><span class="line-number">50</span><br><span class="line-number">51</span><br><span class="line-number">52</span><br></div></div><p>The test should now pass:</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bin/test</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> e2e</span></span></code></pre></div><div class="language-txt vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">txt</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>#OUTPUT</span></span>
-<span class="line"><span>[ bin/test ] Rebuilding test database schema</span></span>
-<span class="line"><span>[ bin/test ] Executing [&quot;bin/db rebuild --env=test&quot;]</span></span>
-<span class="line"><span>[ bin/db ] Database exists. Dropping...</span></span>
-<span class="line"><span>[ bin/db ] blog_test does not exit. Creating...</span></span>
-<span class="line"><span>[ bin/db ] Migrations applied</span></span>
-<span class="line"><span>[ bin/test ] [&quot;bin/db rebuild --env=test&quot;] succeeded</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>«TONS OF OUTPUT»</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>[7215] - Goodbye!</span></span>
-<span class="line"><span>[7215] - Gracefully shutting down workers...</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>Finished in 3.45 seconds (files took 0.71481 seconds to load)</span></span>
-<span class="line highlighted"><span>1 example, 0 failures</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>Randomized with seed 30988</span></span>
-<span class="line"><span></span></span>
-<span class="line"><span>[ bin/test ] [&quot;bin/rspec -I /Users/davec/Projects/ThirdTank/blog-demo/specs -I /Users/davec/Projects/ThirdTank/blog-demo/app/src -I lib/ --tag e2e -P \\&quot;**/*.spec.rb\\&quot; /Users/davec/Projects/ThirdTank/blog-demo/specs/&quot;] succeeded</span></span>
-<span class="line"><span>[ bin/test ] Re-Rebuilding test database schema</span></span>
-<span class="line"><span>[ bin/test ] Executing [&quot;bin/db rebuild --env=test&quot;]</span></span>
-<span class="line"><span>[ bin/db ] Database exists. Dropping...</span></span>
-<span class="line"><span>[ bin/db ] blog_test does not exit. Creating...</span></span>
-<span class="line"><span>[ bin/db ] Migrations applied</span></span>
-<span class="line"><span>[ bin/test ] [&quot;bin/db rebuild --env=test&quot;] succeeded</span></span></code></pre></div><h2 id="areas-for-self-exploration" tabindex="-1">Areas for Self-Exploration <a class="header-anchor" href="#areas-for-self-exploration" aria-label="Permalink to &quot;Areas for Self-Exploration&quot;"></a></h2><ul><li>Extract the dialog into its own component</li><li>Use Internationalization for all the dialog values</li></ul>`,79)])])}const y=i(r,[["render",o]]);export{u as __pageData,y as default};

data/docs/assets/tutorials_02-dialog.md.DE5WfCXI.lean.js DELETED Viewed

@@ -1 +0,0 @@

- import{_ as i,c as a,o as n,ag as e}from"./chunks/framework.C4nOkCZI.js";const t="/assets/02-confirmation-flow.D9gZ0S5U.png",l="/assets/02-confirmation-dialog-browser.DH8ALFO4.png",p="/assets/02-confirmation-dialog-browser-element.DPsf0xUW.png",h="/assets/02-confirmation-dialog-browser-element-styled.3NEGM20-.png",u=JSON.parse('{"title":"Tutorial: Styled Confirmation Dialog","description":"","frontmatter":{},"headers":[],"relativePath":"tutorials/02-dialog.md","filePath":"tutorials/02-dialog.md"}'),r={name:"tutorials/02-dialog.md"};function o(k,s,d,c,g,E){return n(),a("div",null,[...s[0]||(s[0]=[e("",79)])])}const y=i(r,[["render",o]]);export{u as __pageData,y as default};

data/docs/assets/unit-tests.md.vDsdBbO_.js DELETED Viewed

@@ -1,13 +0,0 @@
-import{_ as a,c as s,o as t,ag as i}from"./chunks/framework.C4nOkCZI.js";const u=JSON.parse('{"title":"Unit Tests","description":"","frontmatter":{},"headers":[],"relativePath":"unit-tests.md","filePath":"unit-tests.md"}'),n={name:"unit-tests.md"};function o(r,e,l,h,c,d){return t(),s("div",null,[...e[0]||(e[0]=[i(`<h1 id="unit-tests" tabindex="-1">Unit Tests <a class="header-anchor" href="#unit-tests" aria-label="Permalink to &quot;Unit Tests&quot;"></a></h1><p>Tests in Brut use RSpec and given that most of your Brut-powered classes are simple Ruby classes, you can test them in conventional ways.</p><h2 id="overview" tabindex="-1">Overview <a class="header-anchor" href="#overview" aria-label="Permalink to &quot;Overview&quot;"></a></h2><p>When you scaffold something like a page or component, Brut will create an empty test file in <code>specs/</code>, whose path mirrors the class in <code>app/src</code>. For example, <code>specs/front_end/handlers/login_handler.spec.rb</code> will test the class defined in <code>app/src/front_end/handlers/login_handler.rb</code>.</p><p>Each page of Brut&#39;s documentation includes a &quot;Testing&quot; section that outlines additional features avialable to make testing work more easily. This section will talk about general features and behavior.</p><h3 id="tests-run-in-a-database-transaction" tabindex="-1">Tests run in a Database Transaction <a class="header-anchor" href="#tests-run-in-a-database-transaction" aria-label="Permalink to &quot;Tests run in a Database Transaction&quot;"></a></h3><p>At the start of each test (<code>it</code> block in RSpec), a database transaction is opened. At the end, the transaction is rolled back. This means that none of the changes you make to the database have any effect outside the context of the test.</p><p>The downside of this approach is that you cannot test anything that involves database transactions. For example, if you want to ensure that a piece of business logic runs inside a database transaction, you will have to assure that another way, such as spying.</p><h3 id="a-usable-requestcontext-is-created-for-front-end-tests" tabindex="-1">A Usable <code>RequestContext</code> is Created for Front End Tests <a class="header-anchor" href="#a-usable-requestcontext-is-created-for-front-end-tests" aria-label="Permalink to &quot;A Usable \`RequestContext\` is Created for Front End Tests&quot;"></a></h3><p>Although your tests of pages, components, and handlers are generally isolated, it&#39;s possible to trigger codepaths where Brut will use <a href="/keyword-injection.html">keyword injection</a>, such as a global component.</p><p>To make sure this doesn&#39;t fail, Brut sets up a reasonable <code>RequestContext</code> that will be used for any such injections.</p><p>Brut will also <code>let</code> that instance, named <code>request_context</code>. This means you can access it and modify it in your test as needed. It will be recreated new for each test, so you are safe making changes to it.</p><h3 id="bin-test-audit-and-managing-tests" tabindex="-1"><code>bin/test audit</code> and Managing Tests <a class="header-anchor" href="#bin-test-audit-and-managing-tests" aria-label="Permalink to &quot;\`bin/test audit\` and Managing Tests&quot;"></a></h3><p><code>bin/test audit</code> will fail if any file in <code>app/src</code> does not have a corresponding test. This is handy when you are moving fast to make sure you don&#39;t forget to add test coverage.</p><p>That said, sometimes classes are simple and won&#39;t benefit from a test, or a class&#39; behavior may be adequately covered by another test. It&#39;s helpful to record this information so it&#39;s clear that you&#39;ve given consideration to tests and not just forgotten them.</p><p>Every Brut test has <a href="/api/Brut/SpecSupport/GeneralSupport/ClassMethods.html" target="_self" rel="noopener" data-no-router><code>Brut::SpecSupport::GeneralSupport::ClassMethods</code></a> included and it provides three methods to help record your intent with respect to omitting tests. These methods should be called in a <code>describe</code> or <code>context</code> block.</p><ul><li><p><code>implementation_is_covered_by_other_tests(description)</code> used to explain where the coverage for this class is.</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;">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;"> TaxCalculator</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> do</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  implementation_is_covered_by_other_tests </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;e2e tests for checkout&quot;</span></span>
-<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">end</span></span></code></pre></div></li><li><p><code>implementation_is_needed(check_again_at:)</code> used when you want to acknowledge that a test is required, but for whatever reason you cannot provide it now. This will create a test that fails after the date/time given to <code>check_again_at:</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;">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;"> TaxCalculator</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> do</span></span>
-<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">  implementation_is_needed</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">check_again_at:</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;2025-06-13&quot;</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></code></pre></div></li><li><p><code>implementation_is_trivial(check_again_at: nil)</code> used to indicate that code is trivial and would not benefit from the carrying cost of a test. <code>check_again_at:</code> is optional and this will create a failing test after that date. You&#39;d set this for a class that you suspect may grow in complexity, as a way to ensure it&#39;s not forgotten.</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;">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;"> TaxCalculator</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> do</span></span>
-<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  implementation_is_trivial</span></span>
-<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">end</span></span></code></pre></div></li></ul><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>A list of recommended practices for testing could fill many books. Instead, we&#39;ll focus on a few things that will make life easier.</p><h3 id="go-easy-on-rspec-features" tabindex="-1">Go Easy on RSpec Features <a class="header-anchor" href="#go-easy-on-rspec-features" aria-label="Permalink to &quot;Go Easy on RSpec Features&quot;"></a></h3><p>Shared contexts and shared examples usually make a test suite much harder to understand and much worse. You should avoid them entirely.</p><p><code>let</code> and <code>let!</code> also generally make things worse and should be avoided. It&#39;s usually better to have duplication in various <code>it</code> blocks than to try to parameterize the use of <code>let</code>. This is doubly true when you have nested contexts.</p><h3 id="custom-matchers-are-useful" tabindex="-1">Custom Matchers Are Useful <a class="header-anchor" href="#custom-matchers-are-useful" aria-label="Permalink to &quot;Custom Matchers Are Useful&quot;"></a></h3><p>An effective way to re-use test assertions is via custom matchers. Brut makes use of these, and you can easily create your own. The recommended way to do this is:</p><ol><li>Create <code>specs/support/matchers</code></li><li>Create your matcher there, named for the matcher&#39;s method. For example, if your matcher is <code>be_active_account</code>, create <code>specs/support/matchers/be_active_account.rb</code>.</li><li>Implement your matcher per RSpec&#39;s instructions.</li><li>Use <code>require &quot;support/matchers/be_active_account&quot;</code> to require your matcher explicitly. This will make it easier to understand where everything is coming from when others read your test.</li><li>Check your matchers behavior with passing and failing tests and for negated versions. Ensure that <code>failure_message</code> and <code>failure_message_when_negated</code> produce useful messages.</li></ol><h3 id="lint-your-factories" tabindex="-1">Lint Your Factories <a class="header-anchor" href="#lint-your-factories" aria-label="Permalink to &quot;Lint Your Factories&quot;"></a></h3><p>By default, your Brut app should come with a spec to verify that all your Factory Bot factories work:</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/lint_factories.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:#032F62;--shiki-dark:#9ECBFF;"> &quot;factories&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;should be possible to create them all&quot;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> do</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;">lint</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> traits:</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> true</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>This implies that each factory and each trait of that factory can be created without providing any additional attributes. This is <em>critical</em> to sustainable tests over time. If any factory can be created at any time without dependencies, your tests will be easy to write and maintain.</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 May 9, 2025</em></p>`,32)])])}const k=a(n,[["render",o]]);export{u as __pageData,k as default};

data/docs/assets/unit-tests.md.vDsdBbO_.lean.js DELETED Viewed

	@@ -1 +0,0 @@
1	- import{_ as a,c as s,o as t,ag as i}from"./chunks/framework.C4nOkCZI.js";const u=JSON.parse('{"title":"Unit Tests","description":"","frontmatter":{},"headers":[],"relativePath":"unit-tests.md","filePath":"unit-tests.md"}'),n={name:"unit-tests.md"};function o(r,e,l,h,c,d){return t(),s("div",null,[...e[0]\|\|(e[0]=[i("",32)])])}const k=a(n,[["render",o]]);export{u as __pageData,k as default};

data/docs/assets/welcome-to-brut.VSWzl17-.png DELETED Viewed

Binary file

data/docs/assets/why.md.4WpxdrQ2.js DELETED Viewed

@@ -1 +0,0 @@

- import{_ as a,c as e,o as i,ag as o}from"./chunks/framework.C4nOkCZI.js";const c=JSON.parse('{"title":"Why Does Brut Exist?","description":"","frontmatter":{},"headers":[],"relativePath":"why.md","filePath":"why.md"}'),r={name:"why.md"};function s(n,t,h,d,u,l){return i(),e("div",null,[...t[0]||(t[0]=[o('<h1 id="why-does-brut-exist" tabindex="-1">Why Does Brut Exist? <a class="header-anchor" href="#why-does-brut-exist" aria-label="Permalink to "Why Does Brut Exist?""></a></h1>I love writing Ruby, but grew tired of writing Rails. Rails is great, and has been great to me over the years. I've written a lot of books about it! But the churn and increasing configuration burden made me think: what if we had another way to build web apps in Ruby?What if it was totally different, but still focused on being straightforward and simple? What if it had fewer abstractions, less configuration, and not as much stuff?My thinking is, you need to know HTML, JavaScript, CSS, SQL, Ruby, HTTP, and a few other things to make a web app. What if we tried to limit the additional abstractions you'd have to learn?That's what Brut is trying to be. Straightfoward, direct abstractions or translations of stuff you already know. The raw web…or at least as raw as it can be.',5)])])}const w=a(r,[["render",s]]);export{c as __pageData,w as default};

data/docs/assets/why.md.4WpxdrQ2.lean.js DELETED Viewed

	@@ -1 +0,0 @@
1	- import{_ as a,c as e,o as i,ag as o}from"./chunks/framework.C4nOkCZI.js";const c=JSON.parse('{"title":"Why Does Brut Exist?","description":"","frontmatter":{},"headers":[],"relativePath":"why.md","filePath":"why.md"}'),r={name:"why.md"};function s(n,t,h,d,u,l){return i(),e("div",null,[...t[0]\|\|(t[0]=[o("",5)])])}const w=a(r,[["render",s]]);export{c as __pageData,w as default};

data/docs/assets/workspace-protocol.C0gXsoDb.png DELETED Viewed

Binary file