brut 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c1fd649346396f27b70064c601a639187c08fec7d38f4efc973c3a9839d2c163
-  data.tar.gz: a06518da1bb198c89acfd13dca787fabb302546097e08d8917bf1c500d399f39
+  metadata.gz: d0a674e5f292d833626132e6cb0d634eb7432a5f814cfdde37456980c5066ace
+  data.tar.gz: dfe06bd16d1af502fc42512c1eb9c6500d2f13e3355587e705bb3e0f314f59be
 SHA512:
-  metadata.gz: 0ecde01ea2f1cdc821e24e835fe18a7420848601d469435c74abe3d020187fccc73004ce063f7c242f663796d2470145981e6ace8a742ae885568abb0533eb74
-  data.tar.gz: da0e5c69737041a6ff25366c4fd4cb41214f97b1ada9c78f878544f380f8370bcd155f8f7e6b77d52b50a77b6270b08847e5b1e10bec657b464d289d84747c4f
+  metadata.gz: d6c1dae45c7e5f30b6e01ff4add890fbc3bbe1581c2363fa872a627d040f1dbe08a99e2d07c1f56e15d4f542cb506fa5a3e1f4d4ce4f0e15accba0ae3976b2fb
+  data.tar.gz: bcdf28454960102dfc70dc7a2b74f52ab7b661a83cd6050473a3de28628c636fd02cb476b44c3ab7000d64500b494682780cd1f60b4d5da5f0747652d33917f9

data/Gemfile.lock

@@ -1,11 +1,8 @@
 PATH
   remote: .
   specs:
-    brut (0.0.2)
+    brut (0.0.3)
       concurrent-ruby
-      dotenv
-      factory_bot
-      faker
       i18n
       irb
       nokogiri
@@ -188,6 +185,9 @@ DEPENDENCIES
   activesupport
   brut!
   bundler
+  dotenv
+  factory_bot
+  faker
   rake
   rdiscount
   rdoc

data/brut.gemspec

@@ -35,11 +35,8 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_runtime_dependency "irb"
-  spec.add_runtime_dependency "dotenv"
   spec.add_runtime_dependency "ostruct" # squelch some warning - this is not used
-  spec.add_runtime_dependency "factory_bot"
   spec.add_runtime_dependency "concurrent-ruby"
-  spec.add_runtime_dependency "faker"
   spec.add_runtime_dependency "i18n"
   spec.add_runtime_dependency "nokogiri"
   spec.add_runtime_dependency "prism"
@@ -64,4 +61,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "yard"
   spec.add_development_dependency "rdiscount"
   spec.add_development_dependency "rdoc"
+  spec.add_development_dependency "dotenv"
+  spec.add_development_dependency "factory_bot"
+  spec.add_development_dependency "faker"
 end

data/lib/brut/framework/mcp.rb

@@ -2,87 +2,54 @@ require_relative "container"
 require_relative "config"
 require_relative "../junk_drawer"
 require_relative "app"
+
 require "sequel"
+
 require "semantic_logger"
+require_relative "patch_semantic_logger"
+
 require "i18n"
 require "zeitwerk"
 require "opentelemetry/sdk"
 require "opentelemetry/exporter/otlp"
 
-
 # The Master Control Program of Brut.  This handles all the bootstrapping and setup of your app. You are not
 # intended to use or interact with this class at all. End of line.
 class Brut::Framework::MCP
 
-  # Create the MCP.
+  # Create and configure the MCP.  The app will not work until {#boot!} has been called, however most of the core configuration
+  # will be available via `Brut.container`.
+  #
+  # In particular, when this initializer is done, the following will be set up:
+  #
+  # * Logging
+  # * I18n
+  # * Zeitwerk
+  # * Initial values and configuration from {Brut::Framework::Config#configure!}.  Note that some values in there are static and some
+  # are lazily-evaluated, i.e. their values will only be calculated when fetched.
+  #
+  # In general, you shouldn't have to interact with this class directly, however for posterity, there are basically two ways in which
+  # to do so:
+  #
+  # * Create the instance and *do not* call `boot!`.  This is what you'd do if you can't or don't want to connect to external services
+  # like the database.  For example, when Brut builds assets, it does not call `boot!`.
+  # * Create the intance and immediately call `boot!`.  This is what happens most of the time, in particular when the app is started
+  # up by Puma to start serving requests.
+  #
+  # What you should avoid doing is creating an instance of this class and performing logic before later calling `boot!`.
   #
   # @param [Class] app_klass subclass of {Brut::Framework::App} representing the Brut app being started up and managed.
   def initialize(app_klass:)
     @config    = Brut::Framework::Config.new
     @booted    = false
     @loader    = Zeitwerk::Loader.new
-    @app_klass = app_klass
-    self.configure!
-  end
-
-  # Configure Brut and initialize the {Brut::Framework::App} subclass. This should, in theory, only set up values and other
-  # ancillary data needed to start the app. It should not connect to databases.
-  def configure!
     @config.configure!
 
-    project_root = Brut.container.project_root
-    project_env  = Brut.container.project_env
-
-    SemanticLogger.default_level = Brut.container.log_level
-    semantic_logger_appenders = Brut.container.semantic_logger_appenders
-    if semantic_logger_appenders.kind_of?(Hash)
-      semantic_logger_appenders = [ semantic_logger_appenders ]
-    end
-    if semantic_logger_appenders.length == 0
-      raise "No loggers are set up - something is wrong"
-    end
-    semantic_logger_appenders.each do |appender|
-      SemanticLogger.add_appender(**appender)
-    end
-    SemanticLogger["Brut"].info("Logging set up")
-
-    i18n_locales_dir = Brut.container.i18n_locales_dir
-    locales = Dir[i18n_locales_dir / "*"].map { |_|
-      Pathname(_).basename
-    }
-    ::I18n.load_path += Dir[i18n_locales_dir / "**/*.rb"]
-    ::I18n.available_locales = locales.map(&:to_s).map(&:to_sym)
-
-    Brut.container.store(
-      "zeitwerk_loader",
-      @loader.class,
-      "Zeitwerk Loader configured for this app",
-      @loader
-    )
-
-    Dir[Brut.container.front_end_src_dir / "*"].each do |dir|
-      if Pathname(dir).directory?
-        @loader.push_dir(dir)
-      end
-    end
-    Dir[Brut.container.back_end_src_dir / "*"].each do |dir|
-      if Pathname(dir).directory?
-        @loader.push_dir(dir)
-      end
-    end
-    @loader.ignore(Brut.container.migrations_dir)
-    @loader.inflector.inflect(
-      "db" => "DB"
-    )
-    if Brut.container.auto_reload_classes?
-      SemanticLogger["Brut"].info("Auto-reloaded configured")
-      @loader.enable_reloading
-    else
-      SemanticLogger["Brut"].info("Classes will not be auto-reloaded")
-    end
+    setup_logging
+    setup_i18n
+    setup_zeitwerk
 
-    @loader.setup
-    @app = @app_klass.new
+    @app = app_klass.new
   end
 
   # Starts up the internals of Brut and that app so that it can receive requests from
@@ -102,6 +69,26 @@ class Brut::Framework::MCP
         SemanticLogger["Sequel::Database"].info "Not connected to database, so not disconnecting"
       end
     end
+    Sequel::Database.extension :pg_array
+
+    sequel_db = Brut.container.sequel_db_handle
+
+    Sequel::Model.db = sequel_db
+
+    Sequel::Model.plugin :find_bang
+    Sequel::Model.plugin :created_at
+    Sequel::Model.plugin :table_select
+    Sequel::Model.plugin :skip_saving_columns
+
+    if !Brut.container.external_id_prefix.nil?
+      Sequel::Model.plugin :external_id, global_prefix: Brut.container.external_id_prefix
+    end
+    if Brut.container.eager_load_classes?
+      SemanticLogger["Brut"].info("Eagerly loading app's classes")
+      @loader.eager_load
+    else
+      SemanticLogger["Brut"].info("Lazily loading app's classes")
+    end
     OpenTelemetry::SDK.configure do |c|
       c.service_name = @app.id
       if ENV["OTEL_TRACES_EXPORTER"]
@@ -121,28 +108,8 @@ class Brut::Framework::MCP
       "Tracer for Open Telemetry",
       OpenTelemetry.tracer_provider.tracer(@app.id)
     )
-
-    Sequel::Database.extension :pg_array
     Sequel::Database.extension :brut_instrumentation
 
-    sequel_db = Brut.container.sequel_db_handle
-
-    Sequel::Model.db = sequel_db
-
-    Sequel::Model.plugin :find_bang
-    Sequel::Model.plugin :created_at
-    Sequel::Model.plugin :table_select
-    Sequel::Model.plugin :skip_saving_columns
-
-    if !Brut.container.external_id_prefix.nil?
-      Sequel::Model.plugin :external_id, global_prefix: Brut.container.external_id_prefix
-    end
-    if Brut.container.eager_load_classes?
-      SemanticLogger["Brut"].info("Eagerly loading app's classes")
-      @loader.eager_load
-    else
-      SemanticLogger["Brut"].info("Lazily loading app's classes")
-    end
     @app.boot!
 
     require "sinatra/base"
@@ -264,9 +231,68 @@ class Brut::Framework::MCP
 
     @booted = true
   end
+
   # @!visibility private
   def sinatra_app = @sinatra_app
   # @!visibility private
   def app = @app
 
+private
+
+  def setup_logging
+    SemanticLogger.default_level = Brut.container.log_level
+    semantic_logger_appenders = Brut.container.semantic_logger_appenders
+    if semantic_logger_appenders.kind_of?(Hash)
+      semantic_logger_appenders = [ semantic_logger_appenders ]
+    end
+    if semantic_logger_appenders.length == 0
+      raise "No loggers are set up - something is wrong"
+    end
+    semantic_logger_appenders.each do |appender|
+      SemanticLogger.add_appender(**appender)
+    end
+    SemanticLogger["Brut"].info("Logging set up")
+  end
+
+  def setup_i18n
+
+    i18n_locales_dir = Brut.container.i18n_locales_dir
+    locales = Dir[i18n_locales_dir / "*"].map { Pathname(it).basename }
+    ::I18n.load_path += Dir[i18n_locales_dir / "**/*.rb"]
+    ::I18n.available_locales = locales.map(&:to_s).map(&:to_sym)
+  end
+
+  def setup_zeitwerk
+
+    Brut.container.store(
+      "zeitwerk_loader",
+      @loader.class,
+      "Zeitwerk Loader configured for this app",
+      @loader
+    )
+
+    Dir[Brut.container.front_end_src_dir / "*"].each do |dir|
+      if Pathname(dir).directory?
+        @loader.push_dir(dir)
+      end
+    end
+    Dir[Brut.container.back_end_src_dir / "*"].each do |dir|
+      if Pathname(dir).directory?
+        @loader.push_dir(dir)
+      end
+    end
+    @loader.ignore(Brut.container.migrations_dir)
+    @loader.ignore(Brut.container.db_seeds_dir)
+    @loader.inflector.inflect(
+      "db" => "DB"
+    )
+    if Brut.container.auto_reload_classes?
+      SemanticLogger["Brut"].info("Auto-reloaded configured")
+      @loader.enable_reloading
+    else
+      SemanticLogger["Brut"].info("Classes will not be auto-reloaded")
+    end
+
+    @loader.setup
+  end
 end

data/lib/brut/framework/patch_semantic_logger.rb

@@ -0,0 +1,21 @@
+class SemanticLogger::Appender::Async
+  # Set the thread created by SemanticLogger as fork safe to avoid
+  # a warning.
+  #
+  # Here is where Puma uses this
+  #
+  # https://github.com/puma/puma/blob/ca201ef69757f8830b636251b0af7a51270eb68a/lib/puma/cluster.rb#L377
+  #
+  # Of note, this change is only OK because on_worker_boot is set up to reopen 
+  # SemanticLogger's appenders.  Otherwise, the warning is legit.
+  #
+  def thread_with_puma_magic_variable
+    thread = thread_without_puma_magic_variable
+    thread.thread_variable_set(:fork_safe, true)
+    thread
+  end
+
+  alias_method :thread_without_puma_magic_variable, :thread
+  alias_method :thread, :thread_with_puma_magic_variable
+
+end

data/lib/brut/front_end/component.rb

@@ -77,9 +77,11 @@ class Brut::FrontEnd::Component
   #
   # @return [Brut::FrontEnd::Templates::HTMLSafeString] string containing the component's HTML.
   def render
-    Brut.container.component_locator.locate(self.template_name).
-      then { |erb_file| Brut::FrontEnd::Template.new(erb_file) }.
-      then { |template| template.render_template(self).html_safe! }
+    Brut.container.instrumentation.span("#{self.class}.render") do |span|
+      Brut.container.component_locator.locate(self.template_name).
+        then { Brut::FrontEnd::Template.new(it) }.
+        then { it.render_template(self).html_safe! }
+    end
   end
 
   # For components that are private to a page, this returns the name of the page they are a part of.
@@ -130,25 +132,25 @@ class Brut::FrontEnd::Component
     def component(component_instance,&block)
       component_name = component_instance.kind_of?(Class) ? component_instance.name : component_instance.class.name
       Brut.container.instrumentation.span(component_name) do |span|
-      if component_instance.kind_of?(Class)
-        if !component_instance.ancestors.include?(Brut::FrontEnd::Component)
-          raise ArgumentError,"#{component_instance} is not a component and cannot be created"
+        if component_instance.kind_of?(Class)
+          if !component_instance.ancestors.include?(Brut::FrontEnd::Component)
+            raise ArgumentError,"#{component_instance} is not a component and cannot be created"
+          end
+          component_instance = Thread.current.thread_variable_get(:request_context).
+            then { |request_context| request_context.as_constructor_args(component_instance,request_params: nil)
+            }.then { |constructor_args| component_instance.new(**constructor_args) }
+          span.add_attributes("global_component" => true, "class" => component_instance.class.name)
+        else
+          span.add_attributes("global_component" => false, "class" => component_instance.class.name)
         end
-        component_instance = Thread.current.thread_variable_get(:request_context).
-          then { |request_context| request_context.as_constructor_args(component_instance,request_params: nil)
-        }.then { |constructor_args| component_instance.new(**constructor_args) }
-        span.add_attributes("global_component" => true, "class" => component_instance.class.name)
-      else
-        span.add_attributes("global_component" => false, "class" => component_instance.class.name)
-      end
-      if !block.nil?
-        component_instance.yielded_block = block
-      end
-      Thread.current.thread_variable_get(:request_context).then {
-        it.as_method_args(component_instance,:render,request_params: nil, form: nil)
-      }.then { |render_args|
-        component_instance.render(**render_args).html_safe!
-      }
+        if !block.nil?
+          component_instance.yielded_block = block
+        end
+        Thread.current.thread_variable_get(:request_context).then {
+          it.as_method_args(component_instance,:render,request_params: nil, form: nil)
+        }.then { |render_args|
+          component_instance.render(**render_args).html_safe!
+        }
       end
     end
 

data/lib/brut/version.rb

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

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: brut
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - David Bryant Copeland
 bindir: exe
 cert_chain: []
-date: 2025-02-18 00:00:00.000000000 Z
+date: 2025-02-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: irb
@@ -24,7 +24,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: dotenv
+  name: ostruct
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -38,7 +38,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: ostruct
+  name: concurrent-ruby
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -52,7 +52,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: factory_bot
+  name: i18n
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -66,7 +66,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: concurrent-ruby
+  name: nokogiri
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -80,7 +80,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: faker
+  name: prism
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -94,7 +94,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: i18n
+  name: rack-protection
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -108,7 +108,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: nokogiri
+  name: rackup
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -122,7 +122,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: prism
+  name: rexml
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -136,7 +136,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rack-protection
+  name: semantic_logger
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -150,7 +150,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rackup
+  name: sequel
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -164,7 +164,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rexml
+  name: sinatra
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -178,7 +178,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: semantic_logger
+  name: temple
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -192,7 +192,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: sequel
+  name: tilt
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -206,7 +206,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: sinatra
+  name: tzinfo
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -220,7 +220,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: temple
+  name: tzinfo-data
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -234,7 +234,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: tilt
+  name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -248,7 +248,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: tzinfo
+  name: opentelemetry-sdk
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -262,7 +262,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: tzinfo-data
+  name: opentelemetry-exporter-otlp
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -276,13 +276,13 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: zeitwerk
+  name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :runtime
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -290,27 +290,27 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: opentelemetry-sdk
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
+        version: '3.0'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.0'
 - !ruby/object:Gem::Dependency
-  name: opentelemetry-exporter-otlp
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :runtime
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -318,7 +318,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: activesupport
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -332,21 +332,21 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: yard
   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: rdiscount
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -360,7 +360,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: rdoc
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -374,7 +374,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: yard
+  name: dotenv
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -388,7 +388,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rdiscount
+  name: factory_bot
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -402,7 +402,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rdoc
+  name: faker
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -484,6 +484,7 @@ files:
 - lib/brut/framework/errors/not_implemented.rb
 - lib/brut/framework/fussy_type_enforcement.rb
 - lib/brut/framework/mcp.rb
+- lib/brut/framework/patch_semantic_logger.rb
 - lib/brut/framework/project_environment.rb
 - lib/brut/front_end/asset_metadata.rb
 - lib/brut/front_end/component.rb