brut 0.8.0 → 0.9.1

data/lib/brut/rubocop_config.rb

@@ -0,0 +1,123 @@
+require "pathname"
+require "yaml"
+# Not here:
+#  - prevent use of postfix conditonals entirely
+module Brut
+  IM_NOT_CALLING_THEM_COPS = {
+    "Gemspec/AddRuntimeDependency" => true,
+    "Lint/AmbiguousAssignment" => true,
+    "Lint/AmbiguousOperator" => true,
+    "Lint/AmbiguousOperatorPrecedence" => true,
+    "Lint/AmbiguousRange" => true,
+    "Lint/AmbiguousRegexpLiteral" => true,
+    "Lint/DuplicateCaseCondition" => true,
+    "Lint/DuplicateElsifCondition" => true,
+    "Lint/Loop" => true,
+    "Lint/RedundantSplatExpansion" => true,
+    "Lint/RedundantStringCoercion" => true,
+    "Lint/RedundantTypeConversion" => true,
+    "Lint/ToJSON" => true,
+    "Style/ColonMethodDefinition" => true,
+    "Style/DefWithParentheses" => true,
+    "Style/InvertibleUnlessCondition" => true,
+    "Style/KeywordArgumentsMerging" => true,
+    "Style/MethodDefParentheses" => true,
+    "Style/MissingRespondToMissing" => true,
+    "Style/MultilineTernaryOperator" => true,
+    "Style/NegatedUnless" => true,
+    "Style/NestedTernaryOperator" => true,
+    "Style/PreferredHashMethods" => true,
+    "Style/UnlessElse" => true,
+    "Style/UnlessLogicalOperators" => true,
+    "Layout/DotPosition" => {
+      "EnforcedStyle" =>  "trailing",
+    },
+    "Lint/AssignmentInCondition" => {
+      "AllowSafeAssignment" =>  "false",
+    },
+    "Style/ClassMethodsDefinitions" => {
+      "EnforcedStyle" =>  "def_self",
+    },
+    "Style/CollectionMethods" => {
+      "PreferredMethods" => {
+        "find" => "detect",
+        "collect" => "map",
+        "find_all" => "select",
+        "member?" => "include?",
+      },
+    },
+    "Style/EndlessMethod" => {
+      "EnforcedStyle" =>  "allow_single_line",
+    },
+    "Style/For" => {
+      "EnforcedStyle" =>  "each",
+    },
+    "Style/YodaCondition" => {
+      "EnforcedStyle" =>  "forbid_for_all_comparison_operators",
+    },
+    "Style/DisableSyntax" => {
+      "DisableSyntax" => [
+        "unless",
+        "and_or_not",
+        "until",
+      ],
+    },
+    "Style/TrailingCommaInArrayLiteral" => {
+      "EnforcedStyleForMultiline" => "consistent_comma",
+    },
+    "Style/TrailingCommaInHashLiteral" => {
+      "EnforcedStyleForMultiline" => "consistent_comma",
+    },
+    # Documented, but nonexistent
+    #"Style/ItBlockParameter" => {
+    #  "EnforcedStyle" => "allow_single_line",
+    #},
+  }
+  PREAMBLE = {
+    "inherit_mode" => {
+      "merge" => [ "Exclude" ],
+    },
+    "plugins" => [
+      "rubocop-disable_syntax",
+    ],
+    "AllCops" => {
+      "DisabledByDefault" => true,
+      "TargetRubyVersion" => RUBY_VERSION.split(".")[0..1].join("."),
+      "SuggestExtensions" => false,
+      "Exclude" => [
+        "local-gems/**/*",
+        "**/local-gems/**/*",
+        "node_modules/**/*",
+        "**/node_modules/**/*",
+      ],
+    },
+  }
+  class RubocopConfig
+    def create_ridiculous_yaml
+      if !ARGV[0]
+        raise "You must supply the file where the config will be written"
+      end
+      filename = Pathname(ARGV[0])
+      my_big_yaml_hash_of_doom = {}.merge(PREAMBLE)
+      IM_NOT_CALLING_THEM_COPS.each do |not_a_cop, config|
+        body = case config
+               when Hash
+                 config
+               when Array
+                 config
+               when true
+                 {}
+               else
+                 raise "#{config.class}/#{config} is not handled by this contraption"
+               end
+        body["Enabled"] = true
+        my_big_yaml_hash_of_doom[not_a_cop] = body
+      end
+      File.open(filename,"w") do |file|
+        file.puts "# This file is generated! DO NOT EDIT (not that you'd want to - it's YAML!)"
+        file.puts "# The configuration is canonically stored in lib/brut/rubocop_config.rb"
+        file.puts my_big_yaml_hash_of_doom.to_yaml
+      end
+    end
+  end
+end

data/lib/brut/spec_support/component_support.rb

@@ -51,9 +51,6 @@ module Brut::SpecSupport::ComponentSupport
   #   result = generate_and_parse(HeaderComponent.new(title: "Hello!")
   #   expect(result.e!("h1").text).to eq("Hello!")
   #
-  # @example Using context
-  #   result = generate_and_parse(TableRow.new([ "one", "two" ]), context: "tbody")
-  #
   # @param [Brut::FrontEnd::Component] component the component instance you wish to generate. This should be set up to simulate the test
   # you are running.
   # @yield if the component requires or accepts a yielded block, this is how you do that in the test.

data/lib/brut/spec_support/rspec_setup.rb

@@ -100,10 +100,10 @@ class Brut::SpecSupport::RSpecSetup
       if needs_request_context
         session = {
           "session_id" => "test-session-id",
-          "csrf" => "test-csrf-token"
+          "csrf" => "test-csrf-token",
         }
         env = {
-          "rack.session" => session
+          "rack.session" => session,
         }
         app_session = Brut.container.session_class.new(rack_session: session)
         request_context = Brut::FrontEnd::RequestContext.new(

data/lib/brut/version.rb

@@ -1,4 +1,4 @@
 module Brut
   # @!visibility private
-  VERSION = "0.8.0"
+  VERSION = "0.9.1"
 end

data/mkbrut/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    mkbrut (0.8.0)
+    mkbrut (0.9.1)
 
 GEM
   remote: https://rubygems.org/

data/mkbrut/dx

@@ -0,0 +1 @@
+../dx

data/mkbrut/lib/mkbrut/app.rb

@@ -34,7 +34,7 @@ module MKBrut
           app_options:,
           current_dir:,
           templates_dir:,
-        )
+        ),
       ]
       if app_options.demo?
         @segments << MKBrut::Segments::Demo.new(

data/mkbrut/lib/mkbrut/cli.rb

@@ -100,7 +100,7 @@ module MKBrut
       options[:app_name] = MKBrut::AppName.new(args.first)
       options[:app_id] = options[:'app-id']
       options[:dry_run] = !!options[:'dry-run']
-      MKBrut::AppOptions.new(**options.merge(versions:))
+      MKBrut::AppOptions.new(**options, versions:)
     end
 
   end

data/mkbrut/lib/mkbrut/segments/heroku.rb

@@ -24,7 +24,7 @@ class MKBrut::Segments::Heroku < MKBrut::Base
 # These are generated by bin/deploy
 deploy/Dockerfile.*
 }
-      )
+      ),
     ]
   end
 end

data/mkbrut/lib/mkbrut/version.rb

@@ -1,3 +1,3 @@
 module MKBrut
-  VERSION = "0.8.0"
+  VERSION = "0.9.1"
 end

data/mkbrut/mkbrut.gemspec

@@ -1,5 +1,7 @@
 lib = File.expand_path("../lib", __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+if !$LOAD_PATH.include?(lib)
+  $LOAD_PATH.unshift(lib)
+end
 require "mkbrut/version"
 Gem::Specification.new do |spec|
   spec.name          = "mkbrut"

data/mkbrut/templates/Base/app/config/i18n/en/1_defaults.rb

@@ -114,7 +114,7 @@
       has_interpolations: "Test %{interp} Test",
       has_pluralizations: {
         one: "Once!",
-        other: "More than once!"
+        other: "More than once!",
       },
       has_pluralizations_and_zero: {
         zero: "ZERO",
@@ -123,6 +123,6 @@
       },
       simple1: "SIMPLE1",
       simple2: "SIMPLE2",
-    }
+    },
   },
 }

data/mkbrut/templates/Base/app/config/i18n/en/2_app.rb

@@ -12,7 +12,7 @@
     pages: { # Page-specific messages - this key is relied-upon by Brut to exist
       HomePage: {
         title: "Welcome!",
-      }
+      },
     },
     components: { # Component-specific messages - this key is relied-upon by Brut to exist
     },

data/mkbrut/templates/Base/bin/setup

@@ -82,7 +82,7 @@ def setup(update_gems:,update_node:)
   help
 end
 
-def setup_dot_env_local() 
+def setup_dot_env_local
 
   dot_env = ROOT_DIR / ".env.development"
   if !File.exist?(dot_env)

data/mkbrut/templates/segments/Demo/app/src/front_end/components/flash_component.rb

@@ -12,7 +12,7 @@ class FlashComponent < AppComponent
     "pa-3",
     "ba",
     "br-3",
-    "tc"
+    "tc",
   ]
   COLORS = [
     "%{color}-300",

data/specs/brut/junk_drawer.spec.rb

@@ -38,6 +38,10 @@ RSpec.describe "RichString" do
       rich_string = RichString.new("Dash--BoardHTMLPage---")
       expect(rich_string.underscorized.to_s).to eq("dash_board_h_t_m_l_page")
     end
+    it "handles namespaces" do
+      rich_string = RichString.new("WebHooks::Stripe")
+      expect(rich_string.underscorized.to_s).to eq("web_hooks/stripe")
+    end
   end
   describe "#camelize" do
     it "splits on _ and -, captializes each part and joins them" do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: brut
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.1
 platform: ruby
 authors:
 - David Bryant Copeland
@@ -262,21 +262,21 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: dotenv
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -290,7 +290,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: factory_bot
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -304,7 +304,21 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: yard
+  name: faker
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -346,7 +360,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: dotenv
+  name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -360,7 +374,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: factory_bot
+  name: rubocop-disable_syntax
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -374,7 +388,21 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: faker
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: yard
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -397,7 +425,6 @@ files:
 - ".gitignore"
 - ".nvim.lua"
 - ".projections.json"
-- ".rspec"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.txt
 - Dockerfile.dx
@@ -420,10 +447,13 @@ files:
 - bin/ci
 - bin/dev
 - bin/docs
+- bin/generate-and-run-rubocop
 - bin/publish
 - bin/rake
 - bin/rspec
+- bin/rubocop
 - bin/setup
+- bin/test
 - brut-css/.nvim.lua
 - brut-css/README.md
 - brut-css/bin/build
@@ -639,6 +669,16 @@ files:
 - brutrb.com/images/overview.png
 - brutrb.com/images/spa.dot
 - brutrb.com/images/spa.png
+- brutrb.com/images/tutorial/basic-form-with-violations.png
+- brutrb.com/images/tutorial/basic-form.png
+- brutrb.com/images/tutorial/initial-home-page.png
+- brutrb.com/images/tutorial/new-post-editor.png
+- brutrb.com/images/tutorial/new-post-home-page.png
+- brutrb.com/images/tutorial/styled-form-with-server-side-violations.png
+- brutrb.com/images/tutorial/styled-form-with-violations.png
+- brutrb.com/images/tutorial/styled-home-page-with-posts.png
+- brutrb.com/images/tutorial/styled-home-page.png
+- brutrb.com/images/tutorial/welcome-to-brut.png
 - brutrb.com/images/workspace-protocol.dot
 - brutrb.com/images/workspace-protocol.png
 - brutrb.com/index.md
@@ -770,6 +810,7 @@ files:
 - docs/api/Brut/FrontEnd/Components/PageIdentifier.html
 - docs/api/Brut/FrontEnd/Components/TimeTag.html
 - docs/api/Brut/FrontEnd/Components/Traceparent.html
+- docs/api/Brut/FrontEnd/CsrfProtector.html
 - docs/api/Brut/FrontEnd/Download.html
 - docs/api/Brut/FrontEnd/Flash.html
 - docs/api/Brut/FrontEnd/Form.html
@@ -839,6 +880,7 @@ files:
 - docs/api/Brut/Instrumentation/OpenTelemetry.html
 - docs/api/Brut/Instrumentation/OpenTelemetry/NormalizedAttributes.html
 - docs/api/Brut/Instrumentation/OpenTelemetry/Span.html
+- docs/api/Brut/RubocopConfig.html
 - docs/api/Brut/SinatraHelpers.html
 - docs/api/Brut/SinatraHelpers/ClassMethods.html
 - docs/api/Brut/SpecSupport.html
@@ -905,31 +947,33 @@ files:
 - docs/assets/adrs.md.BxjHi9-8.lean.js
 - docs/assets/ai.md.Cy9GWnER.js
 - docs/assets/ai.md.Cy9GWnER.lean.js
-- docs/assets/app.DyQLb4Ot.js
+- docs/assets/app.BuBdZoUg.js
 - docs/assets/assets.md.7C3HWkga.js
 - docs/assets/assets.md.7C3HWkga.lean.js
+- docs/assets/basic-form-with-violations.Cv6Y9-Q_.png
+- docs/assets/basic-form.DbHnu0oW.png
 - docs/assets/brut-js.md.B4GYxQVw.js
 - docs/assets/brut-js.md.B4GYxQVw.lean.js
 - docs/assets/business-logic.md.BY4hGy0m.js
 - docs/assets/business-logic.md.BY4hGy0m.lean.js
-- docs/assets/chunks/@localSearchIndexroot.CmtZyrFA.js
-- docs/assets/chunks/VPLocalSearchBox.T1iA-eJx.js
+- docs/assets/chunks/@localSearchIndexroot.BZ_a3X0T.js
+- docs/assets/chunks/VPLocalSearchBox.UtnyvkX-.js
 - docs/assets/chunks/framework.1L-BeKqY.js
-- docs/assets/chunks/theme.ChwsbWjK.js
+- docs/assets/chunks/theme.DqwvuBEK.js
 - docs/assets/cli.md.CjsktgFz.js
 - docs/assets/cli.md.CjsktgFz.lean.js
-- docs/assets/components.md.DHh-NwKs.js
-- docs/assets/components.md.DHh-NwKs.lean.js
-- docs/assets/configuration.md.D8Wz3oJU.js
-- docs/assets/configuration.md.D8Wz3oJU.lean.js
+- docs/assets/components.md.Bu80E2Nr.js
+- docs/assets/components.md.Bu80E2Nr.lean.js
+- docs/assets/configuration.md.CuIxVsSf.js
+- docs/assets/configuration.md.CuIxVsSf.lean.js
 - docs/assets/css.md.CltvJqAa.js
 - docs/assets/css.md.CltvJqAa.lean.js
 - docs/assets/custom-element-tests.md.B_rbta32.js
 - docs/assets/custom-element-tests.md.B_rbta32.lean.js
 - docs/assets/database-access.md.gnluu54N.js
 - docs/assets/database-access.md.gnluu54N.lean.js
-- docs/assets/database-schema.md.C5gXexJi.js
-- docs/assets/database-schema.md.C5gXexJi.lean.js
+- docs/assets/database-schema.md.LpmBPVEU.js
+- docs/assets/database-schema.md.LpmBPVEU.lean.js
 - docs/assets/deployment.md.BLseERGV.js
 - docs/assets/deployment.md.BLseERGV.lean.js
 - docs/assets/dev-env-protocol.DysDAtnz.png
@@ -947,10 +991,10 @@ files:
 - docs/assets/flash-and-session.md.nPvUpnUx.lean.js
 - docs/assets/form-constraints.md.DK5adCgM.js
 - docs/assets/form-constraints.md.DK5adCgM.lean.js
-- docs/assets/forms.md.BRE85eju.js
-- docs/assets/forms.md.BRE85eju.lean.js
-- docs/assets/getting-started.md.2ioiTe-B.js
-- docs/assets/getting-started.md.2ioiTe-B.lean.js
+- docs/assets/forms.md.DnLbzVDa.js
+- docs/assets/forms.md.DnLbzVDa.lean.js
+- docs/assets/getting-started.md.DdQLmU3C.js
+- docs/assets/getting-started.md.DdQLmU3C.lean.js
 - docs/assets/handlers.md.h84MMB1R.js
 - docs/assets/handlers.md.h84MMB1R.lean.js
 - docs/assets/hooks.md.Jmb5VOLA.js
@@ -959,6 +1003,7 @@ files:
 - docs/assets/i18n.md.BAm9t9JJ.lean.js
 - docs/assets/index.md.Bn9e0sRJ.js
 - docs/assets/index.md.Bn9e0sRJ.lean.js
+- docs/assets/initial-home-page.DNIaYmgP.png
 - docs/assets/instrumentation.md.BgcaGVYH.js
 - docs/assets/instrumentation.md.BgcaGVYH.lean.js
 - docs/assets/javascript.md.DzrMxUmI.js
@@ -975,6 +1020,8 @@ files:
 - docs/assets/markdown-examples.md.CCFEQO44.lean.js
 - docs/assets/middleware.md.Czz_UlJN.js
 - docs/assets/middleware.md.Czz_UlJN.lean.js
+- docs/assets/new-post-editor.DrHr-5oh.png
+- docs/assets/new-post-home-page.Bm34lyMg.png
 - docs/assets/overview.md.DlKiRRG_.js
 - docs/assets/overview.md.DlKiRRG_.lean.js
 - docs/assets/pages.md.B7Hc-i6H.js
@@ -989,8 +1036,8 @@ files:
 - docs/assets/recipes_custom-flash.md.CrQbI5eH.lean.js
 - docs/assets/recipes_indexed-forms.md.CstYyOSo.js
 - docs/assets/recipes_indexed-forms.md.CstYyOSo.lean.js
-- docs/assets/recipes_migrations.md.DPN3gQE3.js
-- docs/assets/recipes_migrations.md.DPN3gQE3.lean.js
+- docs/assets/recipes_migrations.md.CTcnWDJF.js
+- docs/assets/recipes_migrations.md.CTcnWDJF.lean.js
 - docs/assets/recipes_text-field-component.md.H4wLAK0Z.js
 - docs/assets/recipes_text-field-component.md.H4wLAK0Z.lean.js
 - docs/assets/roadmap.md.C6PRi0DX.js
@@ -1005,10 +1052,15 @@ files:
 - docs/assets/space-time-continuum.md.xl44xDos.js
 - docs/assets/space-time-continuum.md.xl44xDos.lean.js
 - docs/assets/style.B1z60PPQ.css
-- docs/assets/tutorial.md.BIb7XT6j.js
-- docs/assets/tutorial.md.BIb7XT6j.lean.js
+- docs/assets/styled-form-with-server-side-violations.Bjxd8Dpv.png
+- docs/assets/styled-form-with-violations.Bv_sa9tg.png
+- docs/assets/styled-home-page-with-posts.Dd4kG89D.png
+- docs/assets/styled-home-page.BzdI7dWz.png
+- docs/assets/tutorial.md.C4zR5XPG.js
+- docs/assets/tutorial.md.C4zR5XPG.lean.js
 - docs/assets/unit-tests.md.DUGrnLj5.js
 - docs/assets/unit-tests.md.DUGrnLj5.lean.js
+- docs/assets/welcome-to-brut.VSWzl17-.png
 - docs/assets/why.md.C-hk5xgJ.js
 - docs/assets/why.md.C-hk5xgJ.lean.js
 - docs/assets/workspace-protocol.C0gXsoDb.png
@@ -1221,6 +1273,7 @@ files:
 - lib/brut/front_end/components/page_identifier.rb
 - lib/brut/front_end/components/time_tag.rb
 - lib/brut/front_end/components/traceparent.rb
+- lib/brut/front_end/csrf_protector.rb
 - lib/brut/front_end/download.rb
 - lib/brut/front_end/flash.rb
 - lib/brut/front_end/form.rb
@@ -1272,6 +1325,7 @@ files:
 - lib/brut/instrumentation/logger_span_exporter.rb
 - lib/brut/instrumentation/open_telemetry.rb
 - lib/brut/junk_drawer.rb
+- lib/brut/rubocop_config.rb
 - lib/brut/sinatra_helpers.rb
 - lib/brut/spec_support.rb
 - lib/brut/spec_support/clock_support.rb
@@ -1319,6 +1373,7 @@ files:
 - mkbrut/brut-welcome.png
 - mkbrut/deploy/.dockerignore
 - mkbrut/deploy/Dockerfile
+- mkbrut/dx
 - mkbrut/exe/mkbrut
 - mkbrut/lib/mkbrut.rb
 - mkbrut/lib/mkbrut/app.rb
@@ -1467,13 +1522,15 @@ files:
 - specs/support.rb
 - specs/support/matchers.rb
 - specs/support/matchers/have_constraint_violation.rb
-homepage: https://naildrivin5.com
+homepage: https://brutrb.com
 licenses: []
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: https://naildrivin5.com
-  source_code_uri: https://naildrivin5.com
-  changelog_uri: https://naildrivin5.com
+  homepage_uri: https://brutrb.com
+  source_code_uri: https://github.com/thirdtank/brut
+  changelog_uri: https://github.com/thirdtank/brut/blob/main/CHANGELOG.md
+  documentation_uri: https://brutrb.com/
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib

data/.rspec

@@ -1,3 +0,0 @@
--I specs
---require spec_helper
--P "specs/**/*.spec.rb"