RubyGems - brut - Versions diffs - 0.15.0 → 0.16.0.pre - Mend

brut 0.15.0 → 0.16.0.pre

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 (400) hide show

checksums.yaml +4 -4
data/.gitignore +2 -0
data/CHANGELOG.md +5 -0
data/Dockerfile.dx +3 -6
data/Gemfile.lock +1 -1
data/brut-css/package-lock.json +2 -2
data/brut-css/package.json +1 -1
data/brut-js/package-lock.json +2 -2
data/brut-js/package.json +1 -1
data/brutrb.com/.vitepress/config.mjs +4 -3
data/brutrb.com/deployment.md +23 -9
data/brutrb.com/jobs.md +107 -7
data/brutrb.com/recipes/dev-env-secrets.md +87 -0
data/brutrb.com/roadmap.md +2 -7
data/docs/404.html +2 -2
data/docs/adrs.html +3 -3
data/docs/ai.html +3 -3
data/docs/api/Brut/BackEnd/SeedData.html +1 -1
data/docs/api/Brut/BackEnd/Sidekiq/Middlewares/Server/FlushSpans.html +1 -1
data/docs/api/Brut/BackEnd/Sidekiq/Middlewares/Server.html +1 -1
data/docs/api/Brut/BackEnd/Sidekiq/Middlewares.html +1 -1
data/docs/api/Brut/BackEnd/Sidekiq.html +1 -1
data/docs/api/Brut/BackEnd/Validators/FormValidator.html +1 -1
data/docs/api/Brut/BackEnd/Validators.html +1 -1
data/docs/api/Brut/BackEnd.html +1 -1
data/docs/api/Brut/CLI/App.html +1 -1
data/docs/api/Brut/CLI/AppRunner.html +1 -1
data/docs/api/Brut/CLI/Apps/BuildAssets/All.html +1 -1
data/docs/api/Brut/CLI/Apps/BuildAssets/CSS.html +1 -1
data/docs/api/Brut/CLI/Apps/BuildAssets/Images.html +1 -1
data/docs/api/Brut/CLI/Apps/BuildAssets/JS.html +1 -1
data/docs/api/Brut/CLI/Apps/BuildAssets.html +1 -1
data/docs/api/Brut/CLI/Apps/DB/Create.html +1 -1
data/docs/api/Brut/CLI/Apps/DB/Drop.html +1 -1
data/docs/api/Brut/CLI/Apps/DB/Migrate.html +1 -1
data/docs/api/Brut/CLI/Apps/DB/NewMigration.html +1 -1
data/docs/api/Brut/CLI/Apps/DB/Rebuild.html +1 -1
data/docs/api/Brut/CLI/Apps/DB/Seed.html +1 -1
data/docs/api/Brut/CLI/Apps/DB/Status.html +1 -1
data/docs/api/Brut/CLI/Apps/DB.html +1 -1
data/docs/api/Brut/CLI/Apps/DeployBase/GitChecks.html +1 -1
data/docs/api/Brut/CLI/Apps/DeployBase.html +1 -1
data/docs/api/Brut/CLI/Apps/HerokuContainerBasedDeploy/Deploy.html +1 -1
data/docs/api/Brut/CLI/Apps/HerokuContainerBasedDeploy.html +1 -1
data/docs/api/Brut/CLI/Apps/Scaffold/Action/Route.html +1 -1
data/docs/api/Brut/CLI/Apps/Scaffold/Action.html +1 -1
data/docs/api/Brut/CLI/Apps/Scaffold/Component.html +1 -1
data/docs/api/Brut/CLI/Apps/Scaffold/CustomElementTest.html +1 -1
data/docs/api/Brut/CLI/Apps/Scaffold/DbModel.html +1 -1
data/docs/api/Brut/CLI/Apps/Scaffold/E2ETest.html +1 -1
data/docs/api/Brut/CLI/Apps/Scaffold/Form.html +1 -1
data/docs/api/Brut/CLI/Apps/Scaffold/Page/Route.html +1 -1
data/docs/api/Brut/CLI/Apps/Scaffold/Page.html +1 -1
data/docs/api/Brut/CLI/Apps/Scaffold/RoutesEditor.html +1 -1
data/docs/api/Brut/CLI/Apps/Scaffold/Test.html +1 -1
data/docs/api/Brut/CLI/Apps/Scaffold.html +1 -1
data/docs/api/Brut/CLI/Apps/Test/Audit.html +1 -1
data/docs/api/Brut/CLI/Apps/Test/E2e.html +1 -1
data/docs/api/Brut/CLI/Apps/Test/JS.html +1 -1
data/docs/api/Brut/CLI/Apps/Test/Run.html +1 -1
data/docs/api/Brut/CLI/Apps/Test.html +1 -1
data/docs/api/Brut/CLI/Apps.html +1 -1
data/docs/api/Brut/CLI/Command.html +1 -1
data/docs/api/Brut/CLI/Error.html +1 -1
data/docs/api/Brut/CLI/ExecutionResults/Result.html +1 -1
data/docs/api/Brut/CLI/ExecutionResults.html +1 -1
data/docs/api/Brut/CLI/Executor.html +1 -1
data/docs/api/Brut/CLI/InvalidOption.html +1 -1
data/docs/api/Brut/CLI/Options.html +1 -1
data/docs/api/Brut/CLI/Output.html +1 -1
data/docs/api/Brut/CLI/SystemExecError.html +1 -1
data/docs/api/Brut/CLI.html +1 -1
data/docs/api/Brut/FactoryBot.html +1 -1
data/docs/api/Brut/Framework/App.html +1 -1
data/docs/api/Brut/Framework/Config.html +1 -1
data/docs/api/Brut/Framework/Container.html +1 -1
data/docs/api/Brut/Framework/Error.html +1 -1
data/docs/api/Brut/Framework/Errors/AbstractMethod.html +1 -1
data/docs/api/Brut/Framework/Errors/Bug.html +1 -1
data/docs/api/Brut/Framework/Errors/MissingConfiguration.html +1 -1
data/docs/api/Brut/Framework/Errors/MissingParameter.html +1 -1
data/docs/api/Brut/Framework/Errors/NoClassForPath.html +1 -1
data/docs/api/Brut/Framework/Errors/NotFound.html +1 -1
data/docs/api/Brut/Framework/Errors/NotImplemented.html +1 -1
data/docs/api/Brut/Framework/Errors.html +1 -1
data/docs/api/Brut/Framework/FussyTypeEnforcement.html +1 -1
data/docs/api/Brut/Framework/MCP.html +1 -1
data/docs/api/Brut/Framework/ProjectEnvironment.html +1 -1
data/docs/api/Brut/Framework.html +1 -1
data/docs/api/Brut/FrontEnd/AssetPathResolver.html +1 -1
data/docs/api/Brut/FrontEnd/Component/Helpers.html +1 -1
data/docs/api/Brut/FrontEnd/Component.html +1 -1
data/docs/api/Brut/FrontEnd/Components/ConstraintViolations.html +1 -1
data/docs/api/Brut/FrontEnd/Components/FormTag.html +1 -1
data/docs/api/Brut/FrontEnd/Components/I18nTranslations.html +1 -1
data/docs/api/Brut/FrontEnd/Components/Input.html +1 -1
data/docs/api/Brut/FrontEnd/Components/Inputs/ButtonTag.html +1 -1
data/docs/api/Brut/FrontEnd/Components/Inputs/CsrfToken.html +1 -1
data/docs/api/Brut/FrontEnd/Components/Inputs/InputTag.html +1 -1
data/docs/api/Brut/FrontEnd/Components/Inputs/RadioButton.html +1 -1
data/docs/api/Brut/FrontEnd/Components/Inputs/SelectTagWithOptions.html +1 -1
data/docs/api/Brut/FrontEnd/Components/Inputs/TextareaTag.html +1 -1
data/docs/api/Brut/FrontEnd/Components/Inputs.html +1 -1
data/docs/api/Brut/FrontEnd/Components/LocaleDetection.html +1 -1
data/docs/api/Brut/FrontEnd/Components/PageIdentifier.html +1 -1
data/docs/api/Brut/FrontEnd/Components/TimeTag.html +1 -1
data/docs/api/Brut/FrontEnd/Components/Traceparent.html +1 -1
data/docs/api/Brut/FrontEnd/Components.html +1 -1
data/docs/api/Brut/FrontEnd/CsrfProtector.html +1 -1
data/docs/api/Brut/FrontEnd/Download.html +1 -1
data/docs/api/Brut/FrontEnd/Flash.html +1 -1
data/docs/api/Brut/FrontEnd/Form.html +1 -1
data/docs/api/Brut/FrontEnd/Forms/Button.html +1 -1
data/docs/api/Brut/FrontEnd/Forms/ButtonInputDefinition.html +1 -1
data/docs/api/Brut/FrontEnd/Forms/ConstraintViolation.html +1 -1
data/docs/api/Brut/FrontEnd/Forms/Input/Color.html +1 -1
data/docs/api/Brut/FrontEnd/Forms/Input/TimeOfDay.html +1 -1
data/docs/api/Brut/FrontEnd/Forms/Input.html +1 -1
data/docs/api/Brut/FrontEnd/Forms/InputDeclarations.html +1 -1
data/docs/api/Brut/FrontEnd/Forms/InputDefinition.html +1 -1
data/docs/api/Brut/FrontEnd/Forms/RadioButtonGroupInput.html +1 -1
data/docs/api/Brut/FrontEnd/Forms/RadioButtonGroupInputDefinition.html +1 -1
data/docs/api/Brut/FrontEnd/Forms/SelectInput.html +1 -1
data/docs/api/Brut/FrontEnd/Forms/SelectInputDefinition.html +1 -1
data/docs/api/Brut/FrontEnd/Forms/ValidityState.html +1 -1
data/docs/api/Brut/FrontEnd/Forms.html +1 -1
data/docs/api/Brut/FrontEnd/GenericResponse.html +1 -1
data/docs/api/Brut/FrontEnd/Handler.html +1 -1
data/docs/api/Brut/FrontEnd/Handlers/CspReportingHandler.html +1 -1
data/docs/api/Brut/FrontEnd/Handlers/InstrumentationHandler/TraceParent.html +1 -1
data/docs/api/Brut/FrontEnd/Handlers/InstrumentationHandler.html +1 -1
data/docs/api/Brut/FrontEnd/Handlers/LocaleDetectionHandler.html +1 -1
data/docs/api/Brut/FrontEnd/Handlers/MissingHandler/Form.html +1 -1
data/docs/api/Brut/FrontEnd/Handlers/MissingHandler.html +1 -1
data/docs/api/Brut/FrontEnd/Handlers.html +1 -1
data/docs/api/Brut/FrontEnd/HandlingResults.html +1 -1
data/docs/api/Brut/FrontEnd/HttpMethod.html +1 -1
data/docs/api/Brut/FrontEnd/HttpStatus.html +1 -1
data/docs/api/Brut/FrontEnd/InlineSvgLocator.html +1 -1
data/docs/api/Brut/FrontEnd/Layout.html +1 -1
data/docs/api/Brut/FrontEnd/Middleware.html +1 -1
data/docs/api/Brut/FrontEnd/Middlewares/AnnotateBrutOwnedPaths.html +1 -1
data/docs/api/Brut/FrontEnd/Middlewares/Favicon.html +1 -1
data/docs/api/Brut/FrontEnd/Middlewares/OpenTelemetrySpan.html +1 -1
data/docs/api/Brut/FrontEnd/Middlewares/ReloadApp.html +1 -1
data/docs/api/Brut/FrontEnd/Middlewares.html +1 -1
data/docs/api/Brut/FrontEnd/Page.html +1 -1
data/docs/api/Brut/FrontEnd/Pages/MissingPage.html +1 -1
data/docs/api/Brut/FrontEnd/Pages.html +1 -1
data/docs/api/Brut/FrontEnd/RequestContext.html +1 -1
data/docs/api/Brut/FrontEnd/RouteHook.html +1 -1
data/docs/api/Brut/FrontEnd/RouteHooks/AgeFlash.html +1 -1
data/docs/api/Brut/FrontEnd/RouteHooks/CSPNoInlineScripts.html +1 -1
data/docs/api/Brut/FrontEnd/RouteHooks/CSPNoInlineStylesOrScripts/ReportOnly.html +1 -1
data/docs/api/Brut/FrontEnd/RouteHooks/CSPNoInlineStylesOrScripts.html +1 -1
data/docs/api/Brut/FrontEnd/RouteHooks/LocaleDetection.html +1 -1
data/docs/api/Brut/FrontEnd/RouteHooks/SetupRequestContext.html +1 -1
data/docs/api/Brut/FrontEnd/RouteHooks.html +1 -1
data/docs/api/Brut/FrontEnd/Routing/FormHandlerRoute.html +1 -1
data/docs/api/Brut/FrontEnd/Routing/FormRoute.html +1 -1
data/docs/api/Brut/FrontEnd/Routing/MissingForm.html +1 -1
data/docs/api/Brut/FrontEnd/Routing/MissingHandler.html +1 -1
data/docs/api/Brut/FrontEnd/Routing/MissingPage.html +1 -1
data/docs/api/Brut/FrontEnd/Routing/MissingPath.html +1 -1
data/docs/api/Brut/FrontEnd/Routing/PageRoute.html +1 -1
data/docs/api/Brut/FrontEnd/Routing/Route.html +1 -1
data/docs/api/Brut/FrontEnd/Routing.html +1 -1
data/docs/api/Brut/FrontEnd/Session.html +1 -1
data/docs/api/Brut/FrontEnd.html +1 -1
data/docs/api/Brut/I18n/BaseMethods.html +1 -1
data/docs/api/Brut/I18n/ForBackEnd.html +1 -1
data/docs/api/Brut/I18n/ForCLI.html +1 -1
data/docs/api/Brut/I18n/ForHTML.html +1 -1
data/docs/api/Brut/I18n/HTTPAcceptLanguage/AlwaysEnglish.html +1 -1
data/docs/api/Brut/I18n/HTTPAcceptLanguage.html +1 -1
data/docs/api/Brut/I18n.html +1 -1
data/docs/api/Brut/Instrumentation/LoggerSpanExporter.html +1 -1
data/docs/api/Brut/Instrumentation/Methods/ClassMethods.html +1 -1
data/docs/api/Brut/Instrumentation/Methods.html +1 -1
data/docs/api/Brut/Instrumentation/OpenTelemetry/NormalizedAttributes.html +1 -1
data/docs/api/Brut/Instrumentation/OpenTelemetry/Span.html +1 -1
data/docs/api/Brut/Instrumentation/OpenTelemetry.html +1 -1
data/docs/api/Brut/Instrumentation.html +1 -1
data/docs/api/Brut/RubocopConfig.html +1 -1
data/docs/api/Brut/SinatraHelpers/ClassMethods.html +1 -1
data/docs/api/Brut/SinatraHelpers.html +1 -1
data/docs/api/Brut/SpecSupport/ClockSupport.html +1 -1
data/docs/api/Brut/SpecSupport/ComponentSupport.html +1 -1
data/docs/api/Brut/SpecSupport/E2ETestServer.html +1 -1
data/docs/api/Brut/SpecSupport/E2eSupport.html +1 -1
data/docs/api/Brut/SpecSupport/EnhancedNode.html +1 -1
data/docs/api/Brut/SpecSupport/FlashSupport.html +1 -1
data/docs/api/Brut/SpecSupport/GeneralSupport/ClassMethods.html +1 -1
data/docs/api/Brut/SpecSupport/GeneralSupport.html +1 -1
data/docs/api/Brut/SpecSupport/HandlerSupport.html +1 -1
data/docs/api/Brut/SpecSupport/Matchers/BeABug.html +1 -1
data/docs/api/Brut/SpecSupport/Matchers/BePageFor.html +1 -1
data/docs/api/Brut/SpecSupport/Matchers/BeRoutingFor.html +1 -1
data/docs/api/Brut/SpecSupport/Matchers/HaveConstraintViolation.html +1 -1
data/docs/api/Brut/SpecSupport/Matchers/HaveGenerated.html +1 -1
data/docs/api/Brut/SpecSupport/Matchers/HaveHTMLAttribute.html +1 -1
data/docs/api/Brut/SpecSupport/Matchers/HaveI18nString.html +1 -1
data/docs/api/Brut/SpecSupport/Matchers/HaveLinkTo.html +1 -1
data/docs/api/Brut/SpecSupport/Matchers/HaveRedirectedTo.html +1 -1
data/docs/api/Brut/SpecSupport/Matchers/HaveReturnedHttpStatus.html +1 -1
data/docs/api/Brut/SpecSupport/Matchers/HaveReturnedRackResponse.html +1 -1
data/docs/api/Brut/SpecSupport/Matchers.html +1 -1
data/docs/api/Brut/SpecSupport/RSpecSetup/OptionalSidekiqSupport.html +1 -1
data/docs/api/Brut/SpecSupport/RSpecSetup.html +1 -1
data/docs/api/Brut/SpecSupport/SessionSupport.html +1 -1
data/docs/api/Brut/SpecSupport.html +1 -1
data/docs/api/Brut.html +1 -1
data/docs/api/Clock.html +1 -1
data/docs/api/ModuleName.html +1 -1
data/docs/api/RichString.html +1 -1
data/docs/api/SemanticLogger/Appender/Async.html +1 -1
data/docs/api/Sequel/Extensions/BrutInstrumentation.html +1 -1
data/docs/api/Sequel/Extensions/BrutMigrations.html +1 -1
data/docs/api/Sequel/Extensions.html +1 -1
data/docs/api/Sequel/Plugins/CreatedAt/InstanceMethods.html +1 -1
data/docs/api/Sequel/Plugins/CreatedAt.html +1 -1
data/docs/api/Sequel/Plugins/ExternalId/ClassMethods.html +1 -1
data/docs/api/Sequel/Plugins/ExternalId/InstanceMethods.html +1 -1
data/docs/api/Sequel/Plugins/ExternalId.html +1 -1
data/docs/api/Sequel/Plugins/FindBang/ClassMethods.html +1 -1
data/docs/api/Sequel/Plugins/FindBang.html +1 -1
data/docs/api/Sequel/Plugins.html +1 -1
data/docs/api/Sequel.html +1 -1
data/docs/api/_index.html +1 -1
data/docs/api/file.README.html +1 -1
data/docs/api/index.html +1 -1
data/docs/api/top-level-namespace.html +1 -1
data/docs/assets/{app.B0X8upRm.js → app.Dm7v_ouO.js} +1 -1
data/docs/assets/{brut-js.md.CbJAe2Ky.js → brut-js.md.BMz0X1Rz.js} +1 -1
data/docs/assets/chunks/@localSearchIndexroot.BiNFswvo.js +1 -0
data/docs/assets/chunks/{VPLocalSearchBox.jLmhant1.js → VPLocalSearchBox.DQK6jQou.js} +1 -1
data/docs/assets/chunks/{theme.CtVUdCdt.js → theme.BuExsdM9.js} +2 -2
data/docs/assets/{components.md.C6nWgDP0.js → components.md.Dfd3w6UW.js} +3 -3
data/docs/assets/{configuration.md.CpbYHWPb.js → configuration.md.DTYoV2Ea.js} +1 -1
data/docs/assets/{forms.md.Bii91k3E.js → forms.md.DEkmJUvb.js} +1 -1
data/docs/assets/{getting-started.md.ChAvueK7.js → getting-started.md.DO-4eoGW.js} +2 -2
data/docs/assets/{tutorials_02-dialog.md.De6iTsWX.js → tutorials_02-dialog.md.D2vSjDVf.js} +1 -1
data/docs/assets.html +3 -3
data/docs/brut-js/api/AjaxSubmit.html +2 -2
data/docs/brut-js/api/AjaxSubmit.js.html +2 -2
data/docs/brut-js/api/Autosubmit.html +2 -2
data/docs/brut-js/api/Autosubmit.js.html +2 -2
data/docs/brut-js/api/BaseCustomElement.html +2 -2
data/docs/brut-js/api/BaseCustomElement.js.html +2 -2
data/docs/brut-js/api/BrutCustomElements.html +3 -3
data/docs/brut-js/api/BufferedLogger.html +2 -2
data/docs/brut-js/api/ConfirmSubmit.html +2 -2
data/docs/brut-js/api/ConfirmSubmit.js.html +2 -2
data/docs/brut-js/api/ConfirmationDialog.html +2 -2
data/docs/brut-js/api/ConfirmationDialog.js.html +2 -2
data/docs/brut-js/api/ConstraintViolationMessage.html +2 -2
data/docs/brut-js/api/ConstraintViolationMessage.js.html +2 -2
data/docs/brut-js/api/ConstraintViolationMessages.html +2 -2
data/docs/brut-js/api/ConstraintViolationMessages.js.html +2 -2
data/docs/brut-js/api/CopyToClipboard.html +2 -2
data/docs/brut-js/api/CopyToClipboard.js.html +2 -2
data/docs/brut-js/api/Form.html +2 -2
data/docs/brut-js/api/Form.js.html +2 -2
data/docs/brut-js/api/I18nTranslation.html +2 -2
data/docs/brut-js/api/I18nTranslation.js.html +5 -2
data/docs/brut-js/api/LocaleDetection.html +2 -2
data/docs/brut-js/api/LocaleDetection.js.html +2 -2
data/docs/brut-js/api/Logger.html +2 -2
data/docs/brut-js/api/Logger.js.html +2 -2
data/docs/brut-js/api/Message.html +2 -2
data/docs/brut-js/api/Message.js.html +11 -5
data/docs/brut-js/api/PrefixedLogger.html +2 -2
data/docs/brut-js/api/RichString.html +9 -9
data/docs/brut-js/api/RichString.js.html +6 -3
data/docs/brut-js/api/Tabs.html +2 -2
data/docs/brut-js/api/Tabs.js.html +2 -2
data/docs/brut-js/api/Toast.html +270 -0
data/docs/brut-js/api/Toast.js.html +153 -0
data/docs/brut-js/api/Tracing.html +2 -2
data/docs/brut-js/api/Tracing.js.html +2 -2
data/docs/brut-js/api/external-CustomElementRegistry.html +3 -3
data/docs/brut-js/api/external-Performance.html +3 -3
data/docs/brut-js/api/external-Promise.html +3 -3
data/docs/brut-js/api/external-ValidityState.html +3 -3
data/docs/brut-js/api/external-Window.html +4 -4
data/docs/brut-js/api/external-fetch.html +3 -3
data/docs/brut-js/api/global.html +3 -3
data/docs/brut-js/api/index.html +2 -2
data/docs/brut-js/api/index.js.html +5 -2
data/docs/brut-js/api/module-testing.html +2 -2
data/docs/brut-js/api/testing.AssetMetadata.html +2 -2
data/docs/brut-js/api/testing.AssetMetadataLoader.html +2 -2
data/docs/brut-js/api/testing.CustomElementTest.html +2 -2
data/docs/brut-js/api/testing.DOMCreator.html +2 -2
data/docs/brut-js/api/testing_AssetMetadata.js.html +2 -2
data/docs/brut-js/api/testing_AssetMetadataLoader.js.html +2 -2
data/docs/brut-js/api/testing_CustomElementTest.js.html +2 -2
data/docs/brut-js/api/testing_DOMCreator.js.html +2 -2
data/docs/brut-js/api/testing_index.js.html +2 -2
data/docs/brut-js.html +5 -5
data/docs/business-logic.html +3 -3
data/docs/cli.html +3 -3
data/docs/components.html +7 -7
data/docs/configuration.html +5 -5
data/docs/css.html +3 -3
data/docs/custom-element-tests.html +3 -3
data/docs/database-access.html +3 -3
data/docs/database-schema.html +3 -3
data/docs/deployment.html +3 -3
data/docs/dev-environment.html +3 -3
data/docs/dir-structure.html +3 -3
data/docs/doc-conventions.html +3 -3
data/docs/end-to-end-tests.html +3 -3
data/docs/features.html +3 -3
data/docs/flash-and-session.html +3 -3
data/docs/form-constraints.html +3 -3
data/docs/forms.html +5 -5
data/docs/getting-started.html +6 -6
data/docs/handlers.html +3 -3
data/docs/hashmap.json +1 -1
data/docs/hooks.html +3 -3
data/docs/i18n.html +3 -3
data/docs/index.html +3 -3
data/docs/instrumentation.html +3 -3
data/docs/javascript.html +3 -3
data/docs/jobs.html +3 -3
data/docs/keyword-injection.html +3 -3
data/docs/layouts.html +3 -3
data/docs/lsp.html +3 -3
data/docs/markdown-examples.html +3 -3
data/docs/middleware.html +3 -3
data/docs/overview.html +3 -3
data/docs/pages.html +3 -3
data/docs/recipes/alternate-layouts.html +3 -3
data/docs/recipes/authentication.html +3 -3
data/docs/recipes/custom-flash.html +3 -3
data/docs/recipes/form-errors.html +3 -3
data/docs/recipes/indexed-forms.html +3 -3
data/docs/recipes/migrations.html +3 -3
data/docs/recipes/text-field-component.html +3 -3
data/docs/roadmap.html +3 -3
data/docs/routes.html +3 -3
data/docs/security.html +3 -3
data/docs/seed-data.html +3 -3
data/docs/space-time-continuum.html +3 -3
data/docs/tutorial.html +3 -3
data/docs/tutorials/01-intro.html +3 -3
data/docs/tutorials/02-dialog.html +5 -5
data/docs/unit-tests.html +3 -3
data/docs/why.html +3 -3
data/dx/bash_customizations +3 -4
data/dx/build.pre +15 -0
data/lib/brut/cli/apps/heroku_container_based_deploy.rb +41 -15
data/lib/brut/cli/apps/test.rb +2 -0
data/lib/brut/framework/container.rb +6 -4
data/lib/brut/framework/mcp.rb +1 -1
data/lib/brut/version.rb +1 -1
data/mkbrut/Gemfile.lock +2 -2
data/mkbrut/lib/mkbrut/add_segment.rb +38 -0
data/mkbrut/lib/mkbrut/add_segment_options.rb +22 -0
data/mkbrut/lib/mkbrut/app.rb +7 -2
data/mkbrut/lib/mkbrut/base.rb +1 -0
data/mkbrut/lib/mkbrut/cli.rb +90 -8
data/mkbrut/lib/mkbrut/ops/insert_code_in_method.rb +19 -7
data/mkbrut/lib/mkbrut/ops/insert_into_file.rb +36 -0
data/mkbrut/lib/mkbrut/ops/prism_parsing_op.rb +14 -2
data/mkbrut/lib/mkbrut/ops.rb +1 -0
data/mkbrut/lib/mkbrut/segments/bare_bones.rb +8 -0
data/mkbrut/lib/mkbrut/segments/demo.rb +8 -0
data/mkbrut/lib/mkbrut/segments/heroku.rb +23 -3
data/mkbrut/lib/mkbrut/segments/sidekiq.rb +136 -1
data/mkbrut/lib/mkbrut/segments.rb +1 -1
data/mkbrut/lib/mkbrut/version.rb +1 -1
data/mkbrut/lib/mkbrut.rb +2 -0
data/mkbrut/templates/Base/.gitignore +3 -0
data/mkbrut/templates/Base/Dockerfile.dx +18 -21
data/mkbrut/templates/Base/Gemfile.erb +1 -1
data/mkbrut/templates/Base/bin/run +107 -67
data/mkbrut/templates/Base/bin/run.run +4 -0
data/mkbrut/templates/Base/bin/setup +32 -1
data/mkbrut/templates/Base/dx/bash_customizations +0 -4
data/mkbrut/templates/Base/package.json.erb +1 -1
data/mkbrut/templates/segments/Heroku/deploy/Dockerfile +15 -15
data/mkbrut/templates/segments/Heroku/deploy/heroku_config.rb +5 -4
data/mkbrut/templates/segments/Sidekiq/app/boot_sidekiq.rb +2 -0
data/mkbrut/templates/segments/Sidekiq/app/config/sidekiq.yml +4 -0
data/mkbrut/templates/segments/Sidekiq/app/src/back_end/jobs/app_job.rb +3 -0
data/mkbrut/templates/segments/Sidekiq/app/src/back_end/jobs/example_job.rb +12 -0
data/mkbrut/templates/segments/Sidekiq/app/src/back_end/segments/sidekiq_segment.rb +56 -0
data/mkbrut/templates/segments/Sidekiq/bin/run.sidekiq +4 -0
data/mkbrut/templates/segments/Sidekiq/specs/back_end/jobs/example_job.spec.rb +5 -0
data/mkbrut/templates/segments/Sidekiq/specs/integration/sidekiq_works.spec.rb +38 -0
metadata +34 -18
data/docs/assets/chunks/@localSearchIndexroot.C0s1k0UQ.js +0 -1
/data/docs/assets/{brut-js.md.CbJAe2Ky.lean.js → brut-js.md.BMz0X1Rz.lean.js} +0 -0
/data/docs/assets/{components.md.C6nWgDP0.lean.js → components.md.Dfd3w6UW.lean.js} +0 -0
/data/docs/assets/{configuration.md.CpbYHWPb.lean.js → configuration.md.DTYoV2Ea.lean.js} +0 -0
/data/docs/assets/{forms.md.Bii91k3E.lean.js → forms.md.DEkmJUvb.lean.js} +0 -0
/data/docs/assets/{getting-started.md.ChAvueK7.lean.js → getting-started.md.DO-4eoGW.lean.js} +0 -0
/data/docs/assets/{tutorials_02-dialog.md.De6iTsWX.lean.js → tutorials_02-dialog.md.D2vSjDVf.lean.js} +0 -0

data/docs/why.html CHANGED Viewed

@@ -9,8 +9,8 @@
     <link rel="preload stylesheet" href="/assets/style.B1z60PPQ.css" as="style">
     <link rel="preload stylesheet" href="/vp-icons.css" as="style">
-    <script type="module" src="/assets/app.B0X8upRm.js"></script>
-    <link rel="modulepreload" href="/assets/chunks/theme.CtVUdCdt.js">
+    <script type="module" src="/assets/app.Dm7v_ouO.js"></script>
+    <link rel="modulepreload" href="/assets/chunks/theme.BuExsdM9.js">
     <link rel="modulepreload" href="/assets/chunks/framework.C4nOkCZI.js">
     <link rel="modulepreload" href="/assets/why.md.4WpxdrQ2.lean.js">
     <link rel="icon" href="/favicon.ico">
@@ -23,7 +23,7 @@
   </head>
   <body>
     <div id="app"><div class="Layout" data-v-d8b57b2d><!--[--><!--]--><!--[--><span tabindex="-1" data-v-fcbfc0e0></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-fcbfc0e0>Skip to content</a><!--]--><!----><header class="VPNav" data-v-d8b57b2d data-v-7ad780c2><div class="VPNavBar" data-v-7ad780c2 data-v-9fd4d1dd><div class="wrapper" data-v-9fd4d1dd><div class="container" data-v-9fd4d1dd><div class="title" data-v-9fd4d1dd><div class="VPNavBarTitle has-sidebar" data-v-9fd4d1dd data-v-9f43907a><a class="title" href="/" data-v-9f43907a><!--[--><!--]--><!----><span data-v-9f43907a>Brut RB</span><!--[--><!--]--></a></div></div><div class="content" data-v-9fd4d1dd><div class="content-body" data-v-9fd4d1dd><!--[--><!--]--><div class="VPNavBarSearch search" data-v-9fd4d1dd><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-9fd4d1dd data-v-afb2845e><span id="main-nav-aria-label" class="visually-hidden" data-v-afb2845e> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>Home</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/getting-started.html" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>Getting Started</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/overview.html" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>Overview</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/api/index.html" target="_self" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>Brut API</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/brut-js/api/index.html" target="_self" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>BrutJS</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/brut-css/index.html" target="_self" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>BrutCSS</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-9fd4d1dd data-v-3f90c1a5><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-3f90c1a5 data-v-be9742d9 data-v-b4ccac88><span class="check" data-v-b4ccac88><span class="icon" data-v-b4ccac88><!--[--><span class="vpi-sun sun" data-v-be9742d9></span><span class="vpi-moon moon" data-v-be9742d9></span><!--]--></span></span></button></div><div class="VPSocialLinks VPNavBarSocialLinks social-links" data-v-9fd4d1dd data-v-ef6192dc data-v-e71e869c><!--[--><a class="VPSocialLink no-icon" href="https://github.com/thirdtank/brut" aria-label="github" target="_blank" rel="noopener" data-v-e71e869c data-v-60a9a2d3><span class="vpi-social-github"></span></a><!--]--></div><div class="VPFlyout VPNavBarExtra extra" data-v-9fd4d1dd data-v-f953d92f data-v-bfe7971f><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-bfe7971f><span class="vpi-more-horizontal icon" data-v-bfe7971f></span></button><div class="menu" data-v-bfe7971f><div class="VPMenu" data-v-bfe7971f data-v-20ed86d6><!----><!--[--><!--[--><!----><div class="group" data-v-f953d92f><div class="item appearance" data-v-f953d92f><p class="label" data-v-f953d92f>Appearance</p><div class="appearance-action" data-v-f953d92f><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-f953d92f data-v-be9742d9 data-v-b4ccac88><span class="check" data-v-b4ccac88><span class="icon" data-v-b4ccac88><!--[--><span class="vpi-sun sun" data-v-be9742d9></span><span class="vpi-moon moon" data-v-be9742d9></span><!--]--></span></span></button></div></div></div><div class="group" data-v-f953d92f><div class="item social-links" data-v-f953d92f><div class="VPSocialLinks social-links-list" data-v-f953d92f data-v-e71e869c><!--[--><a class="VPSocialLink no-icon" href="https://github.com/thirdtank/brut" aria-label="github" target="_blank" rel="noopener" data-v-e71e869c data-v-60a9a2d3><span class="vpi-social-github"></span></a><!--]--></div></div></div><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-9fd4d1dd data-v-6bee1efd><span class="container" data-v-6bee1efd><span class="top" data-v-6bee1efd></span><span class="middle" data-v-6bee1efd></span><span class="bottom" data-v-6bee1efd></span></span></button></div></div></div></div><div class="divider" data-v-9fd4d1dd><div class="divider-line" data-v-9fd4d1dd></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-d8b57b2d data-v-2488c25a><div class="container" data-v-2488c25a><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-2488c25a><span class="vpi-align-left menu-icon" data-v-2488c25a></span><span class="menu-text" data-v-2488c25a>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-2488c25a data-v-6b867909><button data-v-6b867909>Return to top</button><!----></div></div></div><aside class="VPSidebar" data-v-d8b57b2d data-v-42c4c606><div class="curtain" data-v-42c4c606></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-42c4c606><span class="visually-hidden" id="sidebar-aria-label" data-v-42c4c606> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Overview</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/getting-started.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Getting Started</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/overview.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Concepts</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/features.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Features</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/dir-structure.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Directory Structure</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/dev-environment.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Dev Environment</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/tutorial.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Tutorial</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/doc-conventions.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Documentation Conventions</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Front-End</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/routes.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Routes</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pages.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Pages</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/layouts.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Layouts</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/forms.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Forms</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/form-constraints.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Form Constraints</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/handlers.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Handlers and Actions</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/components.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Components</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/flash-and-session.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Flash and Session</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/space-time-continuum.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Space/Time Continuum</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/javascript.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>JavaScript</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/css.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>CSS</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/assets.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Assets</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/brut-js.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>BrutJS</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Back-End</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/database-schema.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Database Schema</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/database-access.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Database Access</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/seed-data.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Seed Data</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/jobs.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Jobs</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/business-logic.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Business Logic</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Framework</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/configuration.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Configuration</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/keyword-injection.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Keyword Injection</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/i18n.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>I18n</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/cli.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>CLI / Tasks</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/deployment.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Deployment</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Testing</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/unit-tests.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Unit Tests</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/end-to-end-tests.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>End-to-End Tests</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/custom-element-tests.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Testing Custom Elements</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible collapsed" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Advanced Topics</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/hooks.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Route Hooks</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/middleware.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Middleware</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/instrumentation.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Instrumentation</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/security.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Security</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/lsp.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>LSP Support</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible collapsed" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Recipes</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/migrations.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Migration Basics</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/form-errors.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Styling Form Errors</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/authentication.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Authentication</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/alternate-layouts.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Alternate Layouts</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/custom-flash.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Custom Flash Class</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/indexed-forms.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Indexed Form Elements</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/recipes/text-field-component.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Text Field Component</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible has-active" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>Meta</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/why.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Why?!</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/adrs.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>ADRs</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/roadmap.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>Roadmap to 1.0</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/ai.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>AI Declaration</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-d8b57b2d data-v-9a6c75ad><div class="VPDoc has-sidebar has-aside" data-v-9a6c75ad data-v-e6f2a212><!--[--><!--]--><div class="container" data-v-e6f2a212><div class="aside" data-v-e6f2a212><div class="aside-curtain" data-v-e6f2a212></div><div class="aside-container" data-v-e6f2a212><div class="aside-content" data-v-e6f2a212><div class="VPDocAside" data-v-e6f2a212 data-v-cb998dce><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-cb998dce data-v-f610f197><div class="content" data-v-f610f197><div class="outline-marker" data-v-f610f197></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-f610f197>On this page</div><ul class="VPDocOutlineItem root" data-v-f610f197 data-v-53c99d69><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-cb998dce></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-e6f2a212><div class="content-container" data-v-e6f2a212><!--[--><!--]--><main class="main" data-v-e6f2a212><div style="position:relative;" class="vp-doc _why" data-v-e6f2a212><div><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 &quot;Why Does Brut Exist?&quot;"></a></h1><p>I love writing Ruby, but grew tired of writing Rails. Rails is great, and has been great to me over the years. I&#39;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?</p><p>What if it was totally different, but still focused on being straightforward and simple? What if it had <em>fewer</em> abstractions, <em>less</em> configuration, and not as much <em>stuff</em>?</p><p>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&#39;d have to learn?</p><p>That&#39;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.</p></div></div></main><footer class="VPDocFooter" data-v-e6f2a212 data-v-1bcd8184><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-1bcd8184><span class="visually-hidden" id="doc-footer-aria-label" data-v-1bcd8184>Pager</span><div class="pager" data-v-1bcd8184><a class="VPLink link pager-link prev" href="/recipes/text-field-component.html" data-v-1bcd8184><!--[--><span class="desc" data-v-1bcd8184>Previous page</span><span class="title" data-v-1bcd8184>Text Field Component</span><!--]--></a></div><div class="pager" data-v-1bcd8184><a class="VPLink link pager-link next" href="/adrs.html" data-v-1bcd8184><!--[--><span class="desc" data-v-1bcd8184>Next page</span><span class="title" data-v-1bcd8184>ADRs</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
-    <script>window.__VP_HASH_MAP__=JSON.parse("{\"adrs.md\":\"YglbWtQe\",\"ai.md\":\"ChLnvDAX\",\"assets.md\":\"BEF6Oz6K\",\"brut-js.md\":\"CbJAe2Ky\",\"business-logic.md\":\"DbuaOYGU\",\"cli.md\":\"DDMar_51\",\"components.md\":\"C6nWgDP0\",\"configuration.md\":\"CpbYHWPb\",\"css.md\":\"K5rOCOQY\",\"custom-element-tests.md\":\"DiLe-eFw\",\"database-access.md\":\"Dc8l2Plf\",\"database-schema.md\":\"BJ_JhXmO\",\"deployment.md\":\"C1u5ep0g\",\"dev-environment.md\":\"B1S9p5ZK\",\"dir-structure.md\":\"D1T2kGwj\",\"doc-conventions.md\":\"CDnWaEFg\",\"end-to-end-tests.md\":\"BJJdNDYL\",\"features.md\":\"BDWxnyNO\",\"flash-and-session.md\":\"CUsMxoNl\",\"form-constraints.md\":\"KlfXSKm2\",\"forms.md\":\"Bii91k3E\",\"getting-started.md\":\"ChAvueK7\",\"handlers.md\":\"C5tUwmmo\",\"hooks.md\":\"CoiYCKRc\",\"i18n.md\":\"DxkCKhUw\",\"index.md\":\"DnphWyQd\",\"instrumentation.md\":\"BcxjC4jd\",\"javascript.md\":\"D6fxhaQb\",\"jobs.md\":\"Bc7Y1YpK\",\"keyword-injection.md\":\"CqLnnzIz\",\"layouts.md\":\"HEbeK7Jr\",\"lsp.md\":\"bE9dW8n9\",\"markdown-examples.md\":\"BPmtHlc-\",\"middleware.md\":\"BhOIsg59\",\"overview.md\":\"BpWAgPFH\",\"pages.md\":\"B3sQXpEd\",\"recipes_alternate-layouts.md\":\"C1QzVkA7\",\"recipes_authentication.md\":\"CyvoIW82\",\"recipes_custom-flash.md\":\"6gFqf2uL\",\"recipes_form-errors.md\":\"B5ptSzMO\",\"recipes_indexed-forms.md\":\"BYYQGW2C\",\"recipes_migrations.md\":\"Cid7-3cu\",\"recipes_text-field-component.md\":\"VhOsCtKI\",\"roadmap.md\":\"CJsbUmK_\",\"routes.md\":\"C1dgIBtD\",\"security.md\":\"Jn4SY1uK\",\"seed-data.md\":\"UZW0WxYN\",\"space-time-continuum.md\":\"D9rYGDFH\",\"tutorial.md\":\"BX6f6l00\",\"tutorials_01-intro.md\":\"CzZ3kpF_\",\"tutorials_02-dialog.md\":\"De6iTsWX\",\"unit-tests.md\":\"vDsdBbO_\",\"why.md\":\"4WpxdrQ2\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Brut RB\",\"description\":\"Documentation for the Brut.RB web framework.\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"search\":{\"provider\":\"local\"},\"nav\":[{\"text\":\"Home\",\"link\":\"/\"},{\"text\":\"Getting Started\",\"link\":\"/getting-started\"},{\"text\":\"Overview\",\"link\":\"/overview\"},{\"text\":\"Brut API\",\"link\":\"/api/index.html\",\"target\":\"_self\"},{\"text\":\"BrutJS\",\"link\":\"/brut-js/api/index.html\",\"target\":\"_self\"},{\"text\":\"BrutCSS\",\"link\":\"/brut-css/index.html\",\"target\":\"_self\"}],\"outline\":[2,3],\"sidebar\":[{\"text\":\"Overview\",\"collapsed\":false,\"items\":[{\"text\":\"Getting Started\",\"link\":\"/getting-started\"},{\"text\":\"Concepts\",\"link\":\"/overview\"},{\"text\":\"Features\",\"link\":\"/features\"},{\"text\":\"Directory Structure\",\"link\":\"/dir-structure\"},{\"text\":\"Dev Environment\",\"link\":\"/dev-environment\"},{\"text\":\"Tutorial\",\"link\":\"/tutorial\"},{\"text\":\"Documentation Conventions\",\"link\":\"/doc-conventions\"}]},{\"text\":\"Front-End\",\"collapsed\":false,\"items\":[{\"text\":\"Routes\",\"link\":\"/routes\"},{\"text\":\"Pages\",\"link\":\"/pages\"},{\"text\":\"Layouts\",\"link\":\"/layouts\"},{\"text\":\"Forms\",\"link\":\"/forms\"},{\"text\":\"Form Constraints\",\"link\":\"/form-constraints\"},{\"text\":\"Handlers and Actions\",\"link\":\"/handlers\"},{\"text\":\"Components\",\"link\":\"/components\"},{\"text\":\"Flash and Session\",\"link\":\"/flash-and-session\"},{\"text\":\"Space/Time Continuum\",\"link\":\"/space-time-continuum\"},{\"text\":\"JavaScript\",\"link\":\"/javascript\"},{\"text\":\"CSS\",\"link\":\"/css\"},{\"text\":\"Assets\",\"link\":\"/assets\"},{\"text\":\"BrutJS\",\"link\":\"/brut-js\"}]},{\"text\":\"Back-End\",\"collapsed\":false,\"items\":[{\"text\":\"Database Schema\",\"link\":\"/database-schema\"},{\"text\":\"Database Access\",\"link\":\"/database-access\"},{\"text\":\"Seed Data\",\"link\":\"/seed-data\"},{\"text\":\"Jobs\",\"link\":\"/jobs\"},{\"text\":\"Business Logic\",\"link\":\"/business-logic\"}]},{\"text\":\"Framework\",\"collapsed\":false,\"items\":[{\"text\":\"Configuration\",\"link\":\"/configuration\"},{\"text\":\"Keyword Injection\",\"link\":\"/keyword-injection\"},{\"text\":\"I18n\",\"link\":\"/i18n\"},{\"text\":\"CLI / Tasks\",\"link\":\"/cli\"},{\"text\":\"Deployment\",\"link\":\"/deployment\"}]},{\"text\":\"Testing\",\"collapsed\":false,\"items\":[{\"text\":\"Unit Tests\",\"link\":\"/unit-tests\"},{\"text\":\"End-to-End Tests\",\"link\":\"/end-to-end-tests\"},{\"text\":\"Testing Custom Elements\",\"link\":\"/custom-element-tests\"}]},{\"text\":\"Advanced Topics\",\"collapsed\":true,\"items\":[{\"text\":\"Route Hooks\",\"link\":\"/hooks\"},{\"text\":\"Middleware\",\"link\":\"/middleware\"},{\"text\":\"Instrumentation\",\"link\":\"/instrumentation\"},{\"text\":\"Security\",\"link\":\"/security\"},{\"text\":\"LSP Support\",\"link\":\"/lsp\"}]},{\"text\":\"Recipes\",\"collapsed\":true,\"items\":[{\"text\":\"Migration Basics\",\"link\":\"/recipes/migrations\"},{\"text\":\"Styling Form Errors\",\"link\":\"/recipes/form-errors\"},{\"text\":\"Authentication\",\"link\":\"/recipes/authentication\"},{\"text\":\"Alternate Layouts\",\"link\":\"/recipes/alternate-layouts\"},{\"text\":\"Custom Flash Class\",\"link\":\"/recipes/custom-flash\"},{\"text\":\"Indexed Form Elements\",\"link\":\"/recipes/indexed-forms\"},{\"text\":\"Text Field Component\",\"link\":\"/recipes/text-field-component\"}]},{\"text\":\"Meta\",\"collapsed\":false,\"items\":[{\"text\":\"Why?!\",\"link\":\"/why\"},{\"text\":\"ADRs\",\"link\":\"/adrs\"},{\"text\":\"Roadmap to 1.0\",\"link\":\"/roadmap\"},{\"text\":\"AI Declaration\",\"link\":\"/ai\"}]}],\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/thirdtank/brut\"}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
+    <script>window.__VP_HASH_MAP__=JSON.parse("{\"adrs.md\":\"YglbWtQe\",\"ai.md\":\"ChLnvDAX\",\"assets.md\":\"BEF6Oz6K\",\"brut-js.md\":\"BMz0X1Rz\",\"business-logic.md\":\"DbuaOYGU\",\"cli.md\":\"DDMar_51\",\"components.md\":\"Dfd3w6UW\",\"configuration.md\":\"DTYoV2Ea\",\"css.md\":\"K5rOCOQY\",\"custom-element-tests.md\":\"DiLe-eFw\",\"database-access.md\":\"Dc8l2Plf\",\"database-schema.md\":\"BJ_JhXmO\",\"deployment.md\":\"C1u5ep0g\",\"dev-environment.md\":\"B1S9p5ZK\",\"dir-structure.md\":\"D1T2kGwj\",\"doc-conventions.md\":\"CDnWaEFg\",\"end-to-end-tests.md\":\"BJJdNDYL\",\"features.md\":\"BDWxnyNO\",\"flash-and-session.md\":\"CUsMxoNl\",\"form-constraints.md\":\"KlfXSKm2\",\"forms.md\":\"DEkmJUvb\",\"getting-started.md\":\"DO-4eoGW\",\"handlers.md\":\"C5tUwmmo\",\"hooks.md\":\"CoiYCKRc\",\"i18n.md\":\"DxkCKhUw\",\"index.md\":\"DnphWyQd\",\"instrumentation.md\":\"BcxjC4jd\",\"javascript.md\":\"D6fxhaQb\",\"jobs.md\":\"Bc7Y1YpK\",\"keyword-injection.md\":\"CqLnnzIz\",\"layouts.md\":\"HEbeK7Jr\",\"lsp.md\":\"bE9dW8n9\",\"markdown-examples.md\":\"BPmtHlc-\",\"middleware.md\":\"BhOIsg59\",\"overview.md\":\"BpWAgPFH\",\"pages.md\":\"B3sQXpEd\",\"recipes_alternate-layouts.md\":\"C1QzVkA7\",\"recipes_authentication.md\":\"CyvoIW82\",\"recipes_custom-flash.md\":\"6gFqf2uL\",\"recipes_form-errors.md\":\"B5ptSzMO\",\"recipes_indexed-forms.md\":\"BYYQGW2C\",\"recipes_migrations.md\":\"Cid7-3cu\",\"recipes_text-field-component.md\":\"VhOsCtKI\",\"roadmap.md\":\"CJsbUmK_\",\"routes.md\":\"C1dgIBtD\",\"security.md\":\"Jn4SY1uK\",\"seed-data.md\":\"UZW0WxYN\",\"space-time-continuum.md\":\"D9rYGDFH\",\"tutorial.md\":\"BX6f6l00\",\"tutorials_01-intro.md\":\"CzZ3kpF_\",\"tutorials_02-dialog.md\":\"D2vSjDVf\",\"unit-tests.md\":\"vDsdBbO_\",\"why.md\":\"4WpxdrQ2\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Brut RB\",\"description\":\"Documentation for the Brut.RB web framework.\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"search\":{\"provider\":\"local\"},\"nav\":[{\"text\":\"Home\",\"link\":\"/\"},{\"text\":\"Getting Started\",\"link\":\"/getting-started\"},{\"text\":\"Overview\",\"link\":\"/overview\"},{\"text\":\"Brut API\",\"link\":\"/api/index.html\",\"target\":\"_self\"},{\"text\":\"BrutJS\",\"link\":\"/brut-js/api/index.html\",\"target\":\"_self\"},{\"text\":\"BrutCSS\",\"link\":\"/brut-css/index.html\",\"target\":\"_self\"}],\"outline\":[2,3],\"sidebar\":[{\"text\":\"Overview\",\"collapsed\":false,\"items\":[{\"text\":\"Getting Started\",\"link\":\"/getting-started\"},{\"text\":\"Concepts\",\"link\":\"/overview\"},{\"text\":\"Features\",\"link\":\"/features\"},{\"text\":\"Directory Structure\",\"link\":\"/dir-structure\"},{\"text\":\"Dev Environment\",\"link\":\"/dev-environment\"},{\"text\":\"Tutorial\",\"link\":\"/tutorial\"},{\"text\":\"Documentation Conventions\",\"link\":\"/doc-conventions\"}]},{\"text\":\"Front-End\",\"collapsed\":false,\"items\":[{\"text\":\"Routes\",\"link\":\"/routes\"},{\"text\":\"Pages\",\"link\":\"/pages\"},{\"text\":\"Layouts\",\"link\":\"/layouts\"},{\"text\":\"Forms\",\"link\":\"/forms\"},{\"text\":\"Form Constraints\",\"link\":\"/form-constraints\"},{\"text\":\"Handlers and Actions\",\"link\":\"/handlers\"},{\"text\":\"Components\",\"link\":\"/components\"},{\"text\":\"Flash and Session\",\"link\":\"/flash-and-session\"},{\"text\":\"Space/Time Continuum\",\"link\":\"/space-time-continuum\"},{\"text\":\"JavaScript\",\"link\":\"/javascript\"},{\"text\":\"CSS\",\"link\":\"/css\"},{\"text\":\"Assets\",\"link\":\"/assets\"},{\"text\":\"BrutJS\",\"link\":\"/brut-js\"}]},{\"text\":\"Back-End\",\"collapsed\":false,\"items\":[{\"text\":\"Database Schema\",\"link\":\"/database-schema\"},{\"text\":\"Database Access\",\"link\":\"/database-access\"},{\"text\":\"Seed Data\",\"link\":\"/seed-data\"},{\"text\":\"Jobs\",\"link\":\"/jobs\"},{\"text\":\"Business Logic\",\"link\":\"/business-logic\"}]},{\"text\":\"Framework\",\"collapsed\":false,\"items\":[{\"text\":\"Configuration\",\"link\":\"/configuration\"},{\"text\":\"Keyword Injection\",\"link\":\"/keyword-injection\"},{\"text\":\"I18n\",\"link\":\"/i18n\"},{\"text\":\"CLI / Tasks\",\"link\":\"/cli\"},{\"text\":\"Deployment\",\"link\":\"/deployment\"}]},{\"text\":\"Testing\",\"collapsed\":false,\"items\":[{\"text\":\"Unit Tests\",\"link\":\"/unit-tests\"},{\"text\":\"End-to-End Tests\",\"link\":\"/end-to-end-tests\"},{\"text\":\"Testing Custom Elements\",\"link\":\"/custom-element-tests\"}]},{\"text\":\"Advanced Topics\",\"collapsed\":true,\"items\":[{\"text\":\"Route Hooks\",\"link\":\"/hooks\"},{\"text\":\"Middleware\",\"link\":\"/middleware\"},{\"text\":\"Instrumentation\",\"link\":\"/instrumentation\"},{\"text\":\"Security\",\"link\":\"/security\"},{\"text\":\"LSP Support\",\"link\":\"/lsp\"}]},{\"text\":\"Recipes\",\"collapsed\":true,\"items\":[{\"text\":\"Migration Basics\",\"link\":\"/recipes/migrations\"},{\"text\":\"Styling Form Errors\",\"link\":\"/recipes/form-errors\"},{\"text\":\"Authentication\",\"link\":\"/recipes/authentication\"},{\"text\":\"Alternate Layouts\",\"link\":\"/recipes/alternate-layouts\"},{\"text\":\"Custom Flash Class\",\"link\":\"/recipes/custom-flash\"},{\"text\":\"Indexed Form Elements\",\"link\":\"/recipes/indexed-forms\"},{\"text\":\"Text Field Component\",\"link\":\"/recipes/text-field-component\"}]},{\"text\":\"Meta\",\"collapsed\":false,\"items\":[{\"text\":\"Why?!\",\"link\":\"/why\"},{\"text\":\"ADRs\",\"link\":\"/adrs\"},{\"text\":\"Roadmap to 1.0\",\"link\":\"/roadmap\"},{\"text\":\"AI Declaration\",\"link\":\"/ai\"}]}],\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/thirdtank/brut\"}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
   </body>
 </html>

data/dx/bash_customizations CHANGED Viewed

@@ -1,7 +1,6 @@
 if [ ! -n "$PROJECT_ROOT" ]; then
-  echo "[ bash_customizations ] WARNING: PROJECT_ROOT is not set - this will break RubyGems"
+  echo "[ bash_customizations ] WARNING: PROJECT_ROOT is not set - this will break RubyGems and NPM"
 fi
 export GEM_HOME=${PROJECT_ROOT}/local-gems/gem-home
-export PATH=${PATH}:${GEM_HOME}/bin
-. ~/.nvm/nvm.sh
-nvm use default
+export NPM_CONFIG_PREFIX=${PROJECT_ROOT}/.npm-global
+export PATH=${PATH}:${GEM_HOME}/bin:${NPM_CONFIG_PREFIX}/bin

data/dx/build.pre ADDED Viewed

@@ -0,0 +1,15 @@
+#!/bin/bash
+set -e
+SCRIPT_DIR=$( cd -- "$( dirname -- "${0}" )" > /dev/null 2>&1 && pwd )
+if [ ! -f "${SCRIPT_DIR}"/bash_customizations.local ]; then
+  echo "[ $0 ] Creating bash_customizations.local file - you may edit this later to customize your bash experience."
+  echo "# Insert developer-specifilc Bash customizations here." > "${SCRIPT_DIR}"/bash_customizations.local
+  echo "# This file is not checked into version control" >> "${SCRIPT_DIR}"/bash_customizations.local
+  echo "# Sets up a multi-line prompt since the working directory" >> "${SCRIPT_DIR}"/bash_customizations.local
+  echo "# may be very deep.  Customize or change at your leisure." >> "${SCRIPT_DIR}"/bash_customizations.local
+  echo "PS1='\[\e[35m\]docker-container\[\e[0m\] - \[\e[37m\]\w\n\[\e[0m\]> '" >> "${SCRIPT_DIR}"/bash_customizations.local
+fi

data/lib/brut/cli/apps/heroku_container_based_deploy.rb CHANGED Viewed

@@ -65,7 +65,7 @@ Manages a deploy process based on using Heroku's Container Registry. See
       out.puts "Reading HerokuConfig:"
       require_relative Brut.container.project_root / "deploy" / "heroku_config"
-      additional_images = HerokuConfig.additional_images.map { |name,config|
+      additional_images = (HerokuConfig.additional_images || {}).map { |name,config|
         cmd = config.fetch(:cmd)
         out.puts "  - #{name} will run #{cmd} in production"
         image_name = %{#{@organization}/#{@app_id}:#{short_version}-#{name}}
@@ -98,7 +98,8 @@ Manages a deploy process based on using Heroku's Container Registry. See
       out.puts "  - release will run bin/release in production"
       local_repo_checks.check!
-require_heroku_login!(options)
+      require_heroku_login!(options)
+      login_to_heroku_container_registry!(options)
       FileUtils.chdir Brut.container.project_root do
@@ -171,24 +172,49 @@ require_heroku_login!(options)
         end
       end
     end
   private
     def require_heroku_login!(options)
-      if system("heroku whoami")
-        out.puts "You are logged in to Heroku"
-      else
+      logged_into_heroku = system("heroku whoami > /dev/null 2>&1")
+      if !logged_into_heroku
         out.puts "You are not logged into Heroku."
-        out.puts "Please run the following:"
-        out.puts ""
-        out.puts "heroku auth:login"
-        out.puts "heroku container:login"
-        out.puts ""
-        out.puts "Then, re-run this"
-        if options.dry_run?
-          out.puts "Dry run - ignoring"
-          return
-        end
+        out.puts
+        out.puts "There are two ways to do this:"
+        out.puts
+        out.puts "1 - Set HEROKU_API_KEY in your environment. You can get a"
+        out.puts "    value in a lot of ways, but a comand-line based one is"
+        out.puts
+        out.puts "    heroku authorizations:create -d 'container pushes' --expires-in 31536000"
+        out.puts
+        out.puts "    This reuqires logging into the CLI via heroku auth:login, but using the"
+        out.puts "    key will prevent you from having to login every day."
+        out.puts
+        out.puts "    See Brut's documentation for how to persist this value between rebuilds"
+        out.puts "    of your dev environment."
+        out.puts
+        out.puts "2 - heroku auth:login"
+        out.puts
+        out.puts "    This is simpler, however you will need to do this every day."
+        out.puts
+        exit 1
+      end
+      out.puts "You are logged into Heroku"
+    end
+    def login_to_heroku_container_registry!(options)
+      if !system("heroku container:login")
+        out.puts "Failed to login to Heroku Container Registry"
+        out.puts
+        out.puts "Since you are logged into Heroku, this should've passed, so there"
+        out.puts "may be something else wrong.  The command used was"
+        out.puts
+        out.puts "    heroku container:login"
+        out.puts
         exit 1
       end
+      out.puts "Logged into Heroku Container Registry"
     end
   end
 end

data/lib/brut/cli/apps/test.rb CHANGED Viewed

@@ -167,7 +167,9 @@ class Brut::CLI::Apps::Test < Brut::CLI::App
              type == "back_end" ||
              type == "seed" ||
              type == "migrations" ||
+             type == "segments" ||
              pathname.basename.to_s == "app_data_model.rb" ||
+             pathname.basename.to_s == "app_job.rb" ||
              pathname.basename.to_s == "db.rb"
             hash[:type] = :infrastructure

data/lib/brut/framework/container.rb CHANGED Viewed

@@ -228,10 +228,12 @@ class Brut::Framework::Container
           contained_value.delete(:value)
         else
           klass = contained_value[:value]
-          new_klass = klass.name.split(/::/).reduce(Module) { |mod,part|
-            mod.const_get(part)
-          }
-          contained_value[:value] = new_klass
+          if klass
+            new_klass = klass.name.split(/::/).reduce(Module) { |mod,part|
+              mod.const_get(part)
+            }
+            contained_value[:value] = new_klass
+          end
         end
       end
     end

data/lib/brut/framework/mcp.rb CHANGED Viewed

@@ -188,7 +188,7 @@ class Brut::Framework::MCP
           {
             allow_if: ->(env) {
               brut_owned_path = env["brut.owned_path"]
-              app_allowed = Brut.container.csrf_protector.tap {|_| puts _.class.name }.allowed?(env)
+              app_allowed = Brut.container.csrf_protector.allowed?(env)
               brut_owned_path || app_allowed
             },

data/lib/brut/version.rb CHANGED Viewed

@@ -1,4 +1,4 @@
 module Brut
   # @!visibility private
-  VERSION = "0.15.0"
+  VERSION = "0.16.0.pre"
 end

data/mkbrut/Gemfile.lock CHANGED Viewed

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    mkbrut (0.15.0)
+    mkbrut (0.16.0.pre)
 GEM
   remote: https://rubygems.org/
@@ -16,4 +16,4 @@ DEPENDENCIES
   rake
 BUNDLED WITH
-   2.7.1
+   2.7.2

data/mkbrut/lib/mkbrut/add_segment.rb ADDED Viewed

@@ -0,0 +1,38 @@
+require "fileutils"
+require "erb"
+module MKBrut
+  class AddSegment
+    def initialize(current_dir:, add_segment_options:, out:, err:)
+      @out = out
+      @add_segment_options = add_segment_options
+      @out.puts "Adding #{@add_segment_options.segment_name} to this app"
+      if @add_segment_options.dry_run?
+        @out.puts "Dry Run"
+        MKBrut::Ops::BaseOp.dry_run = true
+      end
+      templates_dir = Pathname(
+        Gem::Specification.find_by_name("mkbrut").gem_dir
+      ) / "templates"
+      @segment = if @add_segment_options.segment_name == "sidekiq"
+                   MKBrut::Segments::Sidekiq.new(
+                     project_root: add_segment_options.project_root,
+                     templates_dir:
+                   )
+                 elsif @add_segment_options.segment_name == "heroku"
+                   MKBrut::Segments::Heroku.new(
+                     project_root: add_segment_options.project_root,
+                     templates_dir:
+                   )
+                 end
+    end
+    def add!
+      @segment.add!
+    end
+  end
+end

data/mkbrut/lib/mkbrut/add_segment_options.rb ADDED Viewed

@@ -0,0 +1,22 @@
+class MKBrut::AddSegmentOptions
+  attr_reader :segment_name, :project_root
+  def initialize(
+    segment_name:,
+    project_root:,
+    dry_run: nil,
+    versions: nil,
+    **rest
+  )
+    if segment_name.nil?
+      raise ArgumentError, "segment_name is required"
+    end
+    @segment_name =   segment_name
+    @project_root =   project_root
+    @dry_run      = !!dry_run
+    @versions     =   versions
+  end
+  def dry_run? = @dry_run
+end

data/mkbrut/lib/mkbrut/app.rb CHANGED Viewed

@@ -47,14 +47,19 @@ module MKBrut
         case segment
         when "heroku"
           @segments << MKBrut::Segments::Heroku.new(
-            app_options:,
-            current_dir:,
+            project_root: @base.project_root,
+            templates_dir:
+          )
+        when "sidekiq"
+          @segments << MKBrut::Segments::Sidekiq.new(
+            project_root: @base.project_root,
             templates_dir:
           )
         else
           raise "Segment #{segment} is not supported"
         end
       end
+      @segments.sort!
     end
     def create!

data/mkbrut/lib/mkbrut/base.rb CHANGED Viewed

@@ -8,6 +8,7 @@ class MKBrut::Base
     def session_secret = SecureRandom.hex(64)
   end
+  attr_reader :project_root
   def initialize(app_options:, current_dir:, templates_dir:)
     @project_root  = current_dir / app_options.app_name
     @templates_dir = templates_dir / "Base"

data/mkbrut/lib/mkbrut/cli.rb CHANGED Viewed

@@ -11,14 +11,56 @@ module MKBrut
     def run
-      app_options = parse_options(@args, MKBrut::Versions.new)
-      new_app = MKBrut::App.new(
-        current_dir: Pathname.pwd.expand_path,
-        app_options:,
-        out: PrefixedIO.new(@out, "mkbrut"),
-        err: @err
-      )
-      new_app.create!
+      command = if @args.first == "add-segment"
+                  @args.shift
+                  :add_segment
+                elsif @args.first == "new-app" || @args.first == "new"
+                  @args.shift
+                  :new_app
+                else
+                  :new_app
+                end
+      if command == :new_app
+        app_options = parse_options(@args, MKBrut::Versions.new)
+        new_app = MKBrut::App.new(
+          current_dir: Pathname.pwd.expand_path,
+          app_options:,
+          out: PrefixedIO.new(@out, "mkbrut"),
+          err: @err
+        )
+        new_app.create!
+      elsif command == :add_segment
+        add_segment_options = parse_add_segment_options(@args, MKBrut::Versions.new)
+        add_segment = MKBrut::AddSegment.new(
+          current_dir: add_segment_options.project_root,
+          add_segment_options:,
+          out: PrefixedIO.new(@out, "mkbrut"),
+          err: @err
+        )
+        add_segment.add!
+        @out.puts ""
+        @out.puts "Sidekiq has now been set up for your app. The configuration used is"
+        @out.puts "a basic one, suitable for getting started, however you know own this"
+        @out.puts "configuration.  Most of it is in these files:"
+        @out.puts ""
+        @out.puts "    app/config/sidekiq.yml"
+        @out.puts "    app/src/back_end/segments/sidekiq_segment.rb"
+        @out.puts ""
+        @out.puts "You are encouraged to verify everything is set up as follows:"
+        @out.puts ""
+        @out.puts "1. Quit dx/start, and start it back up - this will downloaded and set up ValKey/Redis"
+        @out.puts "2. Re-run bin/setup. This will install needed gems and create binstubs"
+        @out.puts "3. Run the example integration test:"
+        @out.puts ""
+        @out.puts "   bin/test e2e specs/integration/sidekiq_works.spec.rb"
+        @out.puts ""
+        @out.puts "   This will use the actual Sidekiq server, so if it passes, you should"
+        @out.puts "   all set and can start creating jobs"
+        @out.puts ""
+      else
+        raise "Unknown command #{command}"
+      end
       0
     rescue => e
       @err.puts "Error: #{e.message}"
@@ -103,5 +145,45 @@ module MKBrut
       MKBrut::AppOptions.new(**options, versions:)
     end
+    def parse_add_segment_options(args, versions)
+      options = {}
+      @option_parser = OptionParser.new do |opts|
+        opts.banner = [
+          "Usage: mkbrut add-segment [options] segment-name",
+          "",
+          "    Adds a segment to an existing Brut-powered app",
+          "",
+          "VERSION",
+          "",
+          "    #{MKBrut::VERSION}",
+          "",
+          "OPTIONS",
+          "",
+        ].join("\n")
+        opts.on("-r PROJECT_ROOT_DIR", "--project-root=PROJECT_ROOT_DIR", "Path to the root of the existing Brut app (defaults to current directory)")
+        opts.on("--dry-run", "Only show what would happen, don't actually do anything")
+        opts.on("--[no-]demo", "Include, or not, additional files that demonstrate Brut's features (default is true for now")
+        opts.on("-h", "--help", "Show this help message") do
+          @out.puts @option_parser
+          @out.puts
+          @out.puts "ARGUMENTS"
+          @out.puts
+          @out.puts "    segment-name - name of the segment to add.  Known values:"
+          @out.puts "                   sidekiq - add support for Sidekiq"
+          @out.puts "                   heroku  - add support for Heroku container-based deployment"
+          @out.puts
+          @out.puts "ENVIRONMENT VARIABLES"
+          @out.puts
+          @out.puts "  BRUT_CLI_RAISE_ON_ERROR - if set to 'true', any error will raise an exception instead of printing to stderr"
+          @out.puts
+          exit
+        end
+      end
+      @option_parser.parse!(args, into: options)
+      options[:project_root] = Pathname.new(options[:'project-root'] || ".").expand_path
+      MKBrut::AddSegmentOptions.new(segment_name: @args[0], **options, versions:)
+    end
   end
 end

data/mkbrut/lib/mkbrut/ops/insert_code_in_method.rb CHANGED Viewed

@@ -1,14 +1,25 @@
 class MKBrut::Ops::InsertCodeInMethod < MKBrut::Ops::PrismParsingOp
-  def initialize(file:, class_name:, method_name:, code:, where: :end)
-    @file        = file
-    @class_name  = class_name
-    @method_name = method_name.to_sym
-    @code        = code
-    @where       = where
+  def initialize(file:,
+                 class_name:,
+                 method_name:,
+                 class_method: false,
+                 code:,
+                 ignore_if_file_not_found: false,
+                 where: :end)
+    @file                     = file
+    @class_name               = class_name
+    @method_name              = method_name.to_sym
+    @class_method             = class_method
+    @code                     = code
+    @ignore_if_file_not_found = ignore_if_file_not_found
+    @where                    = where
   end
   def call
-    method_node = find_method(class_name: @class_name, method_name: @method_name)
+    if !@file.exist? && @ignore_if_file_not_found
+      return
+    end
+    method_node = find_method(class_name: @class_name, method_name: @method_name, class_method: @class_method)
     insertion_point = if @where == :start
                         insertion_point_for_code_at_start_of_method(method_node: method_node)
@@ -42,6 +53,7 @@ private
       }.join("\n") + post_indent
   end
+  # XXX: This does not work with non-ASCII strings
   def insertion_point_for_code_at_end_of_method(method_node:)
     line_number_of_method_end = method_node.location.end_line - 1
     length_of_method_end      = @source.lines[line_number_of_method_end].length

data/mkbrut/lib/mkbrut/ops/insert_into_file.rb ADDED Viewed

@@ -0,0 +1,36 @@
+class MKBrut::Ops::InsertIntoFile < MKBrut::Ops::BaseOp
+  def initialize(file:, content:, before_line:)
+    @file        = file
+    @content     = content
+    @before_line = before_line
+  end
+  def call
+    contents = File.read(@file)
+    locations = []
+    new_contents = []
+    contents.split("\n").each_with_index do |line, index|
+      if line == @before_line
+        new_contents << @content
+        locations << (index + 1)
+      end
+      new_contents << line
+    end
+    if locations.empty?
+      raise "Did not find line '#{@before_line}' exactly in #{@file}"
+    end
+    if locations.size > 1
+      raise "Found exact line '#{@before_line}' #{locations.size} times in #{@file}, should be exactly once so we know where to insert"
+    end
+    if dry_run?
+      puts "Would add to #{@file}, resulting in this content:\n#{new_contents.join("\n")}\n"
+      return
+    end
+    File.open(@file, "w") do |file|
+      file.puts new_contents.join("\n")
+    end
+  end
+end

data/mkbrut/lib/mkbrut/ops/prism_parsing_op.rb CHANGED Viewed

@@ -56,10 +56,22 @@ private
     class_node
   end
-  def find_method(class_name:, method_name:)
+  def find_method(class_name:, method_name:, class_method: false)
     class_node = find_class(class_name:)
     method_node = class_node.body.body.detect { |node|
-      node.is_a?(Prism::DefNode) && node.name == @method_name
+      is_def            = node.is_a?(Prism::DefNode)
+      method_name_match = node.name == @method_name
+      receiver_match    = if class_method
+                            node.receiver.is_a?(Prism::SelfNode)
+                          else
+                            node.receiver.nil?
+                          end
+      if is_def && method_name_match && !receiver_match
+        puts "Found method '#{method_name}' in class '#{class_name}' but it was a #{node.receiver.class} receiver"
+      end
+      is_def && method_name_match && receiver_match
     }
     if !method_node