brick 1.0.1 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b4733a804fae7a4759eae48690541f1873cb81fd1b2a9986f849202c1c76c5d
-  data.tar.gz: d721f215cfed0473804f82969fd3c89dd7a94671d24b0f44b0e03cc73d787754
+  metadata.gz: 36447b749972f091f6d4c7c9127a7abfd5291d159f4ab81e0fb423feae7c2c03
+  data.tar.gz: eb2d1c36e67dd692ac765198c132c801c8633e32ecd199f42605f7659e7f3abd
 SHA512:
-  metadata.gz: b73c787a9c7aa6804d2cfce77921252dd77ce3e6e3710bd30875436d0f66011e6043e0ae4cbdaaeff6f4abb725d8051b5c1be139ee28b80648314f124ff7204f
-  data.tar.gz: 000b467728db85565d793df6e22429e3ff804bb7d39e5c4d6346becc24bc940ec9476fe00758d1e4a4fad868239e755ba7bdef596ecb115f358332656fd1be5e
+  metadata.gz: da45315cae612125917448549f3be6cf163c6dc30ac97794f57544321b2c21536600903e9eb30a379fc6a0845656fe7704df863db13ad62a70c623f4f9cba454
+  data.tar.gz: 64ec86f256752004d07447e94788e453f3e6cf9006082629f5e46791b36d6ce8031e22753217d5f23be5b672f65b35ddb9a55b696db5de0bb85686f854154fee

data/lib/brick/config.rb

@@ -57,12 +57,36 @@ module Brick
     end
 
     # Additional table associations to use (Think of these as virtual foreign keys perhaps)
+    def additional_references
+      @mutex.synchronize { @additional_references }
+    end
+
     def additional_references=(references)
       @mutex.synchronize { @additional_references = references }
     end
 
-    def additional_references
-      @mutex.synchronize { @additional_references }
+    def skip_database_views
+      @mutex.synchronize { @skip_database_views }
+    end
+
+    def skip_database_views=(disable)
+      @mutex.synchronize { @skip_database_views = disable }
+    end
+
+    def exclude_tables
+      @mutex.synchronize { @exclude_tables }
+    end
+
+    def exclude_tables=(value)
+      @mutex.synchronize { @exclude_tables = value }
+    end
+
+    def metadata_columns
+      @mutex.synchronize { @metadata_columns }
+    end
+
+    def metadata_columns=(columns)
+      @mutex.synchronize { @metadata_columns = columns }
     end
   end
 end

data/lib/brick/extensions.rb

@@ -33,9 +33,38 @@
 # ==========================================================
 
 # By default all models indicate that they are not views
-class ActiveRecord::Base
-  def self.is_view?
-    false
+module ActiveRecord
+  class Base
+    def self.is_view?
+      false
+    end
+
+    # Used to show a little prettier name for an object
+    def brick_descrip
+      klass = self.class
+      klass.primary_key ? "#{klass.name} ##{send(klass.primary_key)}" : to_s
+    end
+
+  private
+
+    def self._brick_get_fks
+      @_brick_get_fks ||= reflect_on_all_associations.select { |a2| a2.macro == :belongs_to }.map(&:foreign_key)
+    end
+  end
+
+  class Relation
+    def brick_where(params)
+      wheres = {}
+      params.each do |k, v|
+        next unless klass._brick_get_fks.include?(k)
+
+        wheres[k] = v.split(',')
+      end
+      unless wheres.empty?
+        where!(wheres)
+        wheres # Return the specific parameters that we did use
+      end
+    end
   end
 end
 
@@ -88,6 +117,9 @@ class Object
   private
 
     def build_model(model_name, singular_table_name, table_name, relations, matching)
+      return if ((is_view = (relation = relations[matching]).key?(:isView)) && ::Brick.config.skip_database_views) ||
+                ::Brick.config.exclude_tables.include?(matching)
+
       # Are they trying to use a pluralised class name such as "Employees" instead of "Employee"?
       if table_name == singular_table_name && !ActiveSupport::Inflector.inflections.uncountable.include?(table_name)
         raise NameError.new("Class name for a model that references table \"#{matching}\" should be \"#{ActiveSupport::Inflector.singularize(model_name)}\".")
@@ -100,7 +132,7 @@ class Object
 
         # Override models backed by a view so they return true for #is_view?
         # (Dynamically-created controllers and view templates for such models will then act in a read-only way)
-        if (is_view = (relation = relations[matching]).key?(:isView))
+        if is_view
           new_model_class.define_singleton_method :'is_view?' do
             true
           end
@@ -183,7 +215,6 @@ class Object
       [built_model, code]
     end
 
-
     def build_controller(class_name, plural_class_name, model, relations)
       table_name = ActiveSupport::Inflector.underscore(plural_class_name)
       singular_table_name = ActiveSupport::Inflector.singularize(table_name)
@@ -194,9 +225,11 @@ class Object
 
         code << "  def index\n"
         code << "    @#{table_name} = #{model.name}#{model.primary_key ? ".order(#{model.primary_key.inspect}" : '.all'})\n"
+        code << "    @#{table_name}.brick_where(params)\n"
         code << "  end\n"
         self.define_method :index do
           ar_relation = model.primary_key ? model.order(model.primary_key) : model.all
+          instance_variable_set(:@_brick_params, ar_relation.brick_where(params))
           instance_variable_set("@#{table_name}".to_sym, ar_relation)
         end
 
@@ -234,10 +267,9 @@ end
 # ==========================================================
 
 module ActiveRecord::ConnectionHandling
-  alias old_establish_connection establish_connection
+  alias _brick_establish_connection establish_connection
   def establish_connection(*args)
-    # puts connections.inspect
-    x = old_establish_connection(*args)
+    x = _brick_establish_connection(*args)
 
     if (relations = ::Brick.relations).empty?
       schema = 'public'
@@ -268,9 +300,6 @@ module ActiveRecord::ConnectionHandling
         # next if internal_views.include?(r['relation_name']) # Skip internal views such as v_all_assessments
 
         relation = relations[r['relation_name']]
-        relation[:index] = r['relation_name'].underscore
-        relation[:show] = relation[:index].singularize
-        relation[:index] = relation[:index].pluralize
         relation[:isView] = true if r['table_type'] == 'VIEW'
         col_name = r['column_name']
         cols = relation[:cols] # relation.fetch(:cols) { relation[:cols] = [] }
@@ -303,16 +332,6 @@ module ActiveRecord::ConnectionHandling
         # AND kcu2.TABLE_NAME = ?;", Apartment::Tenant.current, table_name
       ])
       ActiveRecord::Base.connection.execute(sql).values.each { |fk| ::Brick._add_bt_and_hm(fk, relations) }
-
-      # Find associative tables that can be set up for has_many :through
-      relations.each do |_key, tbl|
-        tbl_cols = tbl[:cols].keys
-        fks = tbl[:fks].each_with_object({}) { |fk, s| s[fk.last[:fk]] = fk.last[:inverse_table] if fk.last[:is_bt]; s }
-        # Aside from the primary key and created_at, updated_at,This table has only foreign keys?
-        if fks.length > 1 && (tbl_cols - fks.keys - ['created_at', 'updated_at', 'deleted_at', 'last_update'] - tbl[:pkey].values.first).length.zero?
-          fks.each { |fk| tbl[:hmt_fks][fk.first] = fk.last }
-        end
-      end
     end
 
     puts "Classes built from tables:"

data/lib/brick/frameworks/rails/engine.rb

@@ -37,13 +37,110 @@ module Brick
             alias :_brick_find_template :find_template
             def find_template(*args, **options)
               if @_brick_model
+                model_name = @_brick_model.name
+                pk = @_brick_model.primary_key
+                obj_name = model_name.underscore
+                table_name = model_name.pluralize.underscore
+                # This gets has_many as well as has_many :through
+                # %%% weed out ones that don't have an available model to reference
+                bts, hms = @_brick_model.reflect_on_all_associations.each_with_object([{}, {}]) do |a, s|
+                  case a.macro
+                  when :belongs_to
+                    # Build #brick_descrip if needed
+                    unless a.klass.instance_methods(false).include?(:brick_descrip)
+                      descrip_col = (a.klass.columns.map(&:name) - a.klass._brick_get_fks -
+                                    (::Brick.config.metadata_columns || []) -
+                                    [a.klass.primary_key]).first&.to_sym
+                      if descrip_col
+                        a.klass.define_method :brick_descrip do
+                          send(descrip_col)
+                        end
+                      end
+                    end
+
+                    s.first[a.foreign_key] = [a.name, a.klass]
+                  when :has_many
+                    s.last[a.name] = a
+                  end
+                  s
+                end
+                # Weed out has_manys that go to an associative table
+                hms.select { |k, v| v.options[:through] }.each { |_k, hmt| hms.delete(hmt.options[:through]) }
+                show_obj_blurb = "<td><%= link_to \"#\{#{obj_name}.class.name\} ##\{#{obj_name}.id\}\", #{obj_name} %></td>\n"
+                hms_headers = hms.each_with_object(+'') { |hm, s| s << "<th>HM #{hm.first}</th>\n" }
+                hms_columns = hms.each_with_object(+'') do |hm, s|
+                  s << "<td>
+  <%= link_to \"#\{#{obj_name}.#{hm.first}.count\} #{hm.first}\", #{hm.last.klass.name.underscore.pluralize}_path({ #{hm.last.foreign_key}: #{obj_name}.#{pk} }) %>
+</td>\n"
+                end
+
                 inline = case args.first
                 when 'index'
-                  # Something like:  <%= @categories.inspect %>
-                  "<%= @#{@_brick_model.name.underscore.pluralize}.inspect %>"
+                  "<p style=\"color: green\"><%= notice %></p>
+
+<h1>#{model_name.pluralize}</h1>
+<% if @_brick_params&.present? %><h3>where <%= @_brick_params.each_with_object([]) { |v, s| s << \"#\{v.first\} = #\{v.last.inspect\}\" }.join(', ') %></h3><% end %>
+
+<table id=\"#{table_name}\">
+  <tr>
+  <% is_first = true; is_need_id_col = nil
+     bts = { #{bts.each_with_object([]) { |v, s| s << "#{v.first.inspect} => [#{v.last.first.inspect}, #{v.last.last.name}, #{v.last.last.primary_key.inspect}]"}.join(', ')} }
+     @#{table_name}.columns.map(&:name).each do |col| %>
+    <% next if col == '#{pk}' || ::Brick.config.metadata_columns.include?(col) %>
+    <th>
+    <% if bt = bts[col]
+        if is_first
+          is_first = false
+          is_need_id_col = true %>
+          </th><th>
+        <% end %>
+      BT <%= bt[1].name %>
+    <% else
+        is_first = false %>
+      <%= col %>
+    <% end %>
+    </th>
+  <% end %>
+  <% if is_first # STILL haven't been able to write a first non-key / non-metadata column?
+    is_first = false
+    is_need_id_col = true %>
+    <td></td>
+  <% end %>
+#{hms_headers}
+  </tr>
+
+  <% @#{table_name}.each do |#{obj_name}| %>
+  <tr>
+    <% if is_need_id_col %>
+      <td>#{show_obj_blurb}</td>
+    <% end %>
+    <% is_first = true; #{obj_name}.attributes.each do |k, val| %>
+      <% next if k == '#{pk}' || ::Brick.config.metadata_columns.include?(k) %>
+      <% if (bt = bts[k]) %>
+        <td>
+        <%= obj = bt[1].find_by(bt.last => val); link_to obj.brick_descrip, obj %>
+      <% elsif is_first %>
+        <td>
+        <%= is_first = false; link_to val, #{obj_name} %>
+      <% else %>
+        <td>
+        <%= val %>
+      <% end %>
+      </td>
+    <% end %>
+#{hms_columns}
+    <!-- td>X</td -->
+  </tr>
+  <% end %>
+</table>
+
+<%= link_to \"New #{obj_name}\", new_#{obj_name}_path %>
+"
+                  # "<%= @#{@_brick_model.name.underscore.pluralize}.inspect %>"
                 when 'show'
                   "<%= @#{@_brick_model.name.underscore}.inspect %>"
                 end
+puts inline
                 # As if it were an inline template (see #determine_template in actionview-5.2.6.2/lib/action_view/renderer/template_renderer.rb)
                 keys = options.has_key?(:locals) ? options[:locals].keys : []
                 handler = ActionView::Template.handler_for_extension(options[:type] || 'erb')
@@ -55,10 +152,39 @@ module Brick
           end
         end
 
-        # Auto-routing behaviour
         if (::Brick.enable_routes = app.config.brick.fetch(:enable_routes, true))
-          ::Brick.append_routes
+          ActionDispatch::Routing::RouteSet.class_exec do
+            alias _brick_finalize_routeset! finalize!
+            def finalize!(*args, **options)
+              unless @finalized
+                existing_controllers = routes.each_with_object({}) { |r, s| c = r.defaults[:controller]; s[c] = nil if c }
+                ::Rails.application.routes.append do
+                  # %%% TODO: If no auto-controllers then enumerate the controllers folder in order to build matching routes
+                  # If auto-controllers and auto-models are both enabled then this makes sense:
+                  relations = (::Brick.instance_variable_get(:@relations) || {})[ActiveRecord::Base.connection_pool.object_id] || {}
+                  relations.each do |k, v|
+                    unless existing_controllers.key?(controller_name = k.underscore.pluralize)
+                      options = {}
+                      options[:only] = [:index, :show] if v.key?(:isView)
+                      send(:resources, controller_name.to_sym, **options)
+                    end
+                  end
+                end
+              end
+              _brick_finalize_routeset!(*args, **options)
+            end
+          end
         end
+
+        # Do not consider database views when auto-creating models
+        ::Brick.skip_database_views = app.config.brick.fetch(:skip_database_views, false)
+
+        # Specific database tables and views to omit when auto-creating models
+        ::Brick.exclude_tables = app.config.brick.fetch(:exclude_tables, [])
+
+        # Columns to treat as being metadata for purposes of identifying associative tables for has_many :through
+        ::Brick.metadata_columns = app.config.brick.fetch(:metadata_columns, ['created_at', 'updated_at', 'deleted_at'])
+
         # Additional references (virtual foreign keys)
         if (ars = (::Brick.additional_references = app.config.brick.fetch(:additional_references, nil)))
           ars = ars.call if ars.is_a?(Proc)
@@ -68,6 +194,17 @@ module Brick
             ::Brick._add_bt_and_hm(fk[0..2])
           end
         end
+
+        # Find associative tables that can be set up for has_many :through
+        ::Brick.relations.each do |_key, tbl|
+          tbl_cols = tbl[:cols].keys
+          fks = tbl[:fks].each_with_object({}) { |fk, s| s[fk.last[:fk]] = fk.last[:inverse_table] if fk.last[:is_bt]; s }
+          # Aside from the primary key and the metadata columns created_at, updated_at, and deleted_at, if this table only has
+          # foreign keys then it can act as an associative table and thus be used with has_many :through.
+          if fks.length > 1 && (tbl_cols - fks.keys - (::Brick.config.metadata_columns || []) - tbl[:pkey].values.first).length.zero?
+            fks.each { |fk| tbl[:hmt_fks][fk.first] = fk.last }
+          end
+        end
       end
     end
   end

data/lib/brick/version_number.rb

@@ -5,7 +5,7 @@ module Brick
   module VERSION
     MAJOR = 1
     MINOR = 0
-    TINY = 1
+    TINY = 2
 
     # PRE is nil unless it's a pre-release (beta, RC, etc.)
     PRE = nil

data/lib/brick.rb

@@ -79,17 +79,6 @@ require 'brick/config'
 require 'brick/frameworks/rails'
 module Brick
   class << self
-    def append_routes
-      ::Rails.application.routes.append do
-        relations = (::Brick.instance_variable_get(:@relations) || {})[ActiveRecord::Base.connection_pool.object_id] || {}
-        relations.each do |k, v|
-          options = {}
-          options[:only] = [:index, :show] if v.key?(:isView)
-          send(:resources, k.underscore.pluralize.to_sym, **options)
-        end
-      end
-    end
-
     # All tables and views (what Postgres calls "relations" including column and foreign key info)
     def relations
       connections = Brick.instance_variable_get(:@relations) ||
@@ -150,6 +139,21 @@ module Brick
       !!Brick.config.enable_routes
     end
 
+    # @api public
+    def skip_database_views=(value)
+      Brick.config.skip_database_views = value
+    end
+
+    # @api public
+    def exclude_tables=(value)
+      Brick.config.exclude_tables = value
+    end
+
+    # @api public
+    def metadata_columns=(value)
+      Brick.config.metadata_columns = value
+    end
+
     # Additional table associations to use (Think of these as virtual foreign keys perhaps)
     # @api public
     def additional_references=(value)

data/lib/generators/brick/install_generator.rb

@@ -1,12 +1,11 @@
 # frozen_string_literal: true
 
 require 'rails/generators'
-require 'rails/generators/active_record'
+# require 'rails/generators/active_record'
 
 module Brick
-  # Auto-generates an IMPORT_TEMPLATE entry for one or more models
   class InstallGenerator < ::Rails::Generators::Base
-    include ::Rails::Generators::Migration
+    # include ::Rails::Generators::Migration
 
     source_root File.expand_path('templates', __dir__)
     class_option(
@@ -16,81 +15,128 @@ module Brick
       desc: 'Store changeset (diff) with each version'
     )
 
-    desc 'Generates (but does not run) a migration to add a versions table.' \
-         '  Also generates an initializer file for configuring Brick'
+    desc 'Generates an initializer file for configuring Brick'
 
-    def create_migration_file
-      add_brick_migration('create_versions')
-      add_brick_migration('add_object_changes_to_versions') if options.with_changes?
-    end
+    def create_initializer_file
+      unless File.exists?(filename = 'config/initializers/brick.rb')
+        create_file filename, "# frozen_string_literal: true
 
-    def self.next_migration_number(dirname)
-      ::ActiveRecord::Generators::Base.next_migration_number(dirname)
-    end
+# # Settings for the Brick gem
+# # (By default this auto-creates models, controllers, views, and routes on-the-fly.)
 
-  protected
+# # Normally these all start out as being enabled, but can be selectively disabled:
+# Brick.enable_routes = false
+# Brick.enable_models = false
+# Brick.enable_controllers = false
+# Brick.enable_views = false
+
+# # By default models are auto-created from database views, and set to be read-only.  This can be skipped.
+# Brick.skip_database_views = true
+
+# # Any tables or views you'd like to skip when auto-creating models
+# Brick.exclude_tables = ['custom_metadata', 'version_info']
 
-    def add_brick_migration(template)
-      migration_dir = File.expand_path('db/migrate')
-      if self.class.migration_exists?(migration_dir, template)
-        ::Kernel.warn "Migration already exists: #{template}"
-      else
-        migration_template(
-          "#{template}.rb.erb",
-          "db/migrate/#{template}.rb",
-          item_type_options: item_type_options,
-          migration_version: migration_version,
-          versions_table_options: versions_table_options
-        )
+# # Additional table references which are used to create has_many / belongs_to associations inside auto-created
+# # models.  (You can consider these to be \"virtual foreign keys\" if you wish)...  You only have to add these
+# # in cases where your database for some reason does not have foreign key constraints defined.  Sometimes for
+# # performance reasons or just out of sheer laziness these might be missing.
+# # Each of these virtual foreign keys is defined as an array having three values:
+# #   foreign table name / foreign key column / primary table name.
+# # (We boldly expect that the primary key identified by ActiveRecord on the primary table will be accurate,
+# # usually this is \"id\" but there are some good smarts that are used in case some other column has been set
+# # to be the primary key.
+# Brick.additional_references = [['orders', 'customer_id', 'customer'],
+#                                ['customer', 'region_id', 'regions']]
+
+# # We normally don't consider the timestamp columns \"created_at\", \"updated_at\", and \"deleted_at\" to count when
+# # finding tables which can serve as associative tables in an N:M association.  That is, ones that can be a
+# # part of a has_many :through association.  If you want to use different exclusion columns than our defaults
+# # then this setting resets that list.  For instance, here is the override for the Sakila sample database:
+# Brick.metadata_columns = ['last_updated']
+
+# # If a default route is not supplied, Brick attempts to find the most \"central\" table and wires up the default
+# # route to go to the :index action for what would be a controller for that table.  You can specify any controller
+# # name and action you wish in order to override this and have that be the default route when none other has been
+# # specified in routes.rb or elsewhere.  (Or just use an empty string in order to disable this behaviour.)
+# Brick.default_route_fallback = 'customers' # This defaults to \"customers/index\"
+# Brick.default_route_fallback = 'orders/outstanding' # Example of a non-RESTful route
+# Brick.default_route_fallback = '' # Omits setting a default route in the absence of any other
+"
       end
     end
 
+    # def create_migration_file
+    #   add_brick_migration('create_versions')
+    #   add_brick_migration('add_object_changes_to_versions') if options.with_changes?
+    # end
+
+    # def self.next_migration_number(dirname)
+    #   ::ActiveRecord::Generators::Base.next_migration_number(dirname)
+    # end
+
+  protected
+
+    # def add_brick_migration(template)
+    #   migration_dir = File.expand_path('db/migrate')
+    #   if self.class.migration_exists?(migration_dir, template)
+    #     ::Kernel.warn "Migration already exists: #{template}"
+    #   else
+    #     migration_template(
+    #       "#{template}.rb.erb",
+    #       "db/migrate/#{template}.rb",
+    #       item_type_options: item_type_options,
+    #       migration_version: migration_version,
+    #       versions_table_options: versions_table_options
+    #     )
+    #   end
+    # end
+
   private
 
-    # MySQL 5.6 utf8mb4 limit is 191 chars for keys used in indexes.
-    def item_type_options
-      opt = { null: false }
-      opt[:limit] = 191 if mysql?
-      ", #{opt}"
-    end
+    # # MySQL 5.6 utf8mb4 limit is 191 chars for keys used in indexes.
+    # def item_type_options
+    #   opt = { null: false }
+    #   opt[:limit] = 191 if mysql?
+    #   ", #{opt}"
+    # end
 
-    def migration_version
-      return unless (major = ActiveRecord::VERSION::MAJOR) >= 5
+    # def migration_version
+    #   return unless (major = ActiveRecord::VERSION::MAJOR) >= 5
 
-      "[#{major}.#{ActiveRecord::VERSION::MINOR}]"
-    end
+    #   "[#{major}.#{ActiveRecord::VERSION::MINOR}]"
+    # end
 
-    # Class names of MySQL adapters.
-    # - `MysqlAdapter` - Used by gems: `mysql`, `activerecord-jdbcmysql-adapter`.
-    # - `Mysql2Adapter` - Used by `mysql2` gem.
-    def mysql?
-      [
-        'ActiveRecord::ConnectionAdapters::MysqlAdapter',
-        'ActiveRecord::ConnectionAdapters::Mysql2Adapter'
-      ].freeze.include?(ActiveRecord::Base.connection.class.name)
-    end
+    # # Class names of MySQL adapters.
+    # # - `MysqlAdapter` - Used by gems: `mysql`, `activerecord-jdbcmysql-adapter`.
+    # # - `Mysql2Adapter` - Used by `mysql2` gem.
+    # def mysql?
+    #   [
+    #     'ActiveRecord::ConnectionAdapters::MysqlAdapter',
+    #     'ActiveRecord::ConnectionAdapters::Mysql2Adapter'
+    #   ].freeze.include?(ActiveRecord::Base.connection.class.name)
+    # end
 
-    # Even modern versions of MySQL still use `latin1` as the default character
-    # encoding. Many users are not aware of this, and run into trouble when they
-    # try to use Brick in apps that otherwise tend to use UTF-8. Postgres, by
-    # comparison, uses UTF-8 except in the unusual case where the OS is configured
-    # with a custom locale.
-    #
-    # - https://dev.mysql.com/doc/refman/5.7/en/charset-applications.html
-    # - http://www.postgresql.org/docs/9.4/static/multibyte.html
-    #
-    # Furthermore, MySQL's original implementation of UTF-8 was flawed, and had
-    # to be fixed later by introducing a new charset, `utf8mb4`.
-    #
-    # - https://mathiasbynens.be/notes/mysql-utf8mb4
-    # - https://dev.mysql.com/doc/refman/5.5/en/charset-unicode-utf8mb4.html
-    #
-    def versions_table_options
-      if mysql?
-        ', { options: "ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci" }'
-      else
-        ''
-      end
-    end
+    # # Even modern versions of MySQL still use `latin1` as the default character
+    # # encoding. Many users are not aware of this, and run into trouble when they
+    # # try to use Brick in apps that otherwise tend to use UTF-8. Postgres, by
+    # # comparison, uses UTF-8 except in the unusual case where the OS is configured
+    # # with a custom locale.
+    # #
+    # # - https://dev.mysql.com/doc/refman/5.7/en/charset-applications.html
+    # # - http://www.postgresql.org/docs/9.4/static/multibyte.html
+    # #
+    # # Furthermore, MySQL's original implementation of UTF-8 was flawed, and had
+    # # to be fixed later by introducing a new charset, `utf8mb4`.
+    # #
+    # # - https://mathiasbynens.be/notes/mysql-utf8mb4
+    # # - https://dev.mysql.com/doc/refman/5.5/en/charset-unicode-utf8mb4.html
+    # #
+    # def versions_table_options
+    #   if mysql?
+    #     ', { options: "ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci" }'
+    #   else
+    #     ''
+    #   end
+    # end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: brick
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.2
 platform: ruby
 authors:
 - Lorin Thwaits