brick 1.0.47 → 1.0.50

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4180c0164d7f086112339696df9d8fef2aeebcd32d9b81faf22d76ddc11815bc
-  data.tar.gz: 823673bcbecc342f5df15e196ee65ad6f6ac0b75415514079c055af06d0ac7f6
+  metadata.gz: d5f5d009df0d4a7ce06a5dec8986d2664671e8b151f7493e5ce3f8f690ec7028
+  data.tar.gz: 974e86906775728e0ff0c7022cfbd87578b7c3013a8f9a5fe0db2243dcad9bf1
 SHA512:
-  metadata.gz: 1d17b1abd64051066b71839095be1e672b897ad707a2d10f4ca4429131c894ee178711c873cef59957111704437b86b6322b8909ab5cc41cc955547146377dd8
-  data.tar.gz: e210becff69096e73b9b7fa09bb4e1be6c36cd2982305b2c803c9c00e9d2b5b085857ea6edacc62498557cde928e2afbbb42ebbd137180385ec3a8a0c5efdf85
+  metadata.gz: 0f652cf44f9d18eca35304d1660ed3967d39c60dff42bcc05043607fada17d427308b7052a4b474c71d8a65462f86970838771471b6f1dd7a89accabc31ddd27
+  data.tar.gz: 386030a8bd3c603264ed9f534e1188eb5710fe67777ffc9634a9c318e8bac4153d2716bffbf9c34a7ff63999c3af39b2fa6db3b324abc5093467a33b144b41b8

data/lib/brick/config.rb

@@ -190,6 +190,30 @@ module Brick
       @mutex.synchronize { @table_name_prefixes = value }
     end
 
+    def order
+      @mutex.synchronize { @order || {} }
+    end
+
+    # Get something like:
+    # Override how code sorts with:
+    #   { 'on_call_list' => { code: "ORDER BY STRING_TO_ARRAY(code, '.')::int[]" } }
+    # Specify default thing to order_by with:
+    #   { 'on_call_list' => { _brick_default: [:last_name, :first_name] } }
+    #   { 'on_call_list' => { _brick_default: :sequence } }
+    def order=(orders)
+      @mutex.synchronize do
+        case (brick_default = orders.fetch(:_brick_default, nil))
+        when NilClass
+          orders[:_brick_default] = orders.keys.reject { |k| k == :_brick_default }.first
+        when String
+          orders[:_brick_default] = [brick_default.to_sym]
+        when Symbol
+          orders[:_brick_default] = [brick_default]
+        end
+        @order = orders
+      end
+    end
+
     def metadata_columns
       @mutex.synchronize { @metadata_columns }
     end

data/lib/brick/extensions.rb

@@ -221,6 +221,68 @@ module ActiveRecord
       template
     end
 
+    class << self
+      # belongs_to DSL descriptions
+      def _br_bt_descrip
+        @_br_bt_descrip ||= {}
+      end
+      # has_many count definitions
+      def _br_hm_counts
+        @_br_hm_counts ||= {}
+      end
+      # has_many :through associative tables
+      def _br_associatives
+        @_br_associatives ||= {}
+      end
+    end
+
+    # Search for BT, HM, and HMT DSL stuff
+    def self._brick_calculate_bts_hms(translations, join_array)
+      bts, hms, associatives = ::Brick.get_bts_and_hms(self)
+      bts.each do |_k, bt|
+        next if bt[2] # Polymorphic?
+
+        # join_array will receive this relation name when calling #brick_parse_dsl
+        _br_bt_descrip[bt.first] = if bt[1].is_a?(Array)
+                                     bt[1].each_with_object({}) { |bt_class, s| s[bt_class] = bt_class.brick_parse_dsl(join_array, bt.first, translations, true) }
+                                   else
+                                     { bt.last => bt[1].brick_parse_dsl(join_array, bt.first, translations) }
+                                   end
+      end
+      skip_klass_hms = ::Brick.config.skip_index_hms[self.name] || {}
+      hms.each do |k, hm|
+        next if skip_klass_hms.key?(k)
+
+        if hm.macro == :has_one
+          # For our purposes a :has_one is similar enough to a :belongs_to that we can just join forces
+          _br_bt_descrip[k] = { hm.klass => hm.klass.brick_parse_dsl(join_array, k, translations) }
+        else # Standard :has_many
+          _br_hm_counts[k] = hm
+        end
+      end
+    end
+
+    def self._brick_calculate_ordering(ordering, is_do_txt = true)
+      quoted_table_name = table_name.split('.').map { |x| "\"#{x}\"" }.join('.')
+      order_by_txt = [] if is_do_txt
+      ordering = [ordering] if ordering && !ordering.is_a?(Array)
+      order_by = ordering&.map do |ord_part| # %%% If a term is also used as an eqi-condition in the WHERE clause, it can be omitted from ORDER BY
+                   case ord_part
+                   when String
+                     ord_expr = ord_part.gsub('^^^', quoted_table_name)
+                     order_by_txt&.<<("Arel.sql(#{ord_expr})")
+                     Arel.sql(ord_expr)
+                   else # Expecting only Symbol
+                     ord_part = "_br_#{ord_part}_ct" if _br_hm_counts.key?(ord_part)
+                     # Retain any reference to a bt_descrip as being a symbol
+                     # Was:  "#{quoted_table_name}.\"#{ord_part}\""
+                     order_by_txt&.<<(_br_bt_descrip.key?(ord_part) ? ord_part : ord_part.inspect)
+                     ord_part
+                   end
+                 end
+      [order_by, order_by_txt]
+    end
+
   private
 
     def self._brick_get_fks
@@ -310,16 +372,15 @@ module ActiveRecord
       end
     end
 
-    def brick_select(params, selects = nil, bt_descrip = {}, hm_counts = {}, join_array = ::Brick::JoinArray.new
-      # , is_add_bts, is_add_hms
-    )
-      is_add_bts = is_add_hms = true
+    def brick_select(params, selects = nil, order_by = nil, translations = {}, join_array = ::Brick::JoinArray.new)
       is_distinct = nil
       wheres = {}
       params.each do |k, v|
+        next if ['_brick_schema', '_brick_order'].include?(k)
+
         case (ks = k.split('.')).length
         when 1
-          next unless klass._brick_get_fks.include?(k)
+          next unless klass.column_names.any?(k) || klass._brick_get_fks.include?(k)
         when 2
           assoc_name = ks.first.to_sym
           # Make sure it's a good association name and that the model has that column name
@@ -345,33 +406,6 @@ module ActiveRecord
         end
       end
 
-      # Search for BT, HM, and HMT DSL stuff
-      translations = {}
-      if is_add_bts || is_add_hms
-        bts, hms, associatives = ::Brick.get_bts_and_hms(klass)
-        bts.each do |_k, bt|
-          next if bt[2] # Polymorphic?
-
-          # join_array will receive this relation name when calling #brick_parse_dsl
-          bt_descrip[bt.first] = if bt[1].is_a?(Array)
-                                   bt[1].each_with_object({}) { |bt_class, s| s[bt_class] = bt_class.brick_parse_dsl(join_array, bt.first, translations, true) }
-                                 else
-                                   { bt.last => bt[1].brick_parse_dsl(join_array, bt.first, translations) }
-                                 end
-        end
-        skip_klass_hms = ::Brick.config.skip_index_hms[klass.name] || {}
-        hms.each do |k, hm|
-          next if skip_klass_hms.key?(k)
-
-          if hm.macro == :has_one
-            # For our purposes a :has_one is similar enough to a :belongs_to that we can just join forces
-            bt_descrip[k] = { hm.klass => hm.klass.brick_parse_dsl(join_array, k, translations) }
-          else # Standard :has_many
-            hm_counts[k] = hm
-          end
-        end
-      end
-
       if join_array.present?
         left_outer_joins!(join_array)
         # Without working from a duplicate, touching the AREL ast tree sets the @arel instance variable, which causes the relation to be immutable.
@@ -380,7 +414,8 @@ module ActiveRecord
         chains = rel_dupe._brick_chains
         id_for_tables = Hash.new { |h, k| h[k] = [] }
         field_tbl_names = Hash.new { |h, k| h[k] = {} }
-        bt_columns = bt_descrip.each_with_object([]) do |v, s|
+        used_col_aliases = {} # Used to make sure there is not a name clash
+        bt_columns = klass._br_bt_descrip.each_with_object([]) do |v, s|
           v.last.each do |k1, v1| # k1 is class, v1 is array of columns to snag
             next if chains[k1].nil?
 
@@ -391,7 +426,12 @@ module ActiveRecord
 
               # Postgres can not use DISTINCT with any columns that are XML, so for any of those just convert to text
               is_xml = is_distinct && Brick.relations[sel_col.first.table_name]&.[](:cols)&.[](sel_col.last)&.first&.start_with?('xml')
-              selects << "\"#{field_tbl_name}\".\"#{sel_col.last}\"#{'::text' if is_xml} AS \"#{(col_alias = "_brfk_#{v.first}__#{sel_col.last}")}\""
+              # If it's not unique then also include the belongs_to association name before the column name
+              if used_col_aliases.key?(col_alias = "_brfk_#{v.first}__#{sel_col.last}")
+                col_alias = "_brfk_#{v.first}__#{v1[idx][-2..-1].map(&:to_s).join('__')}"
+              end
+              selects << "\"#{field_tbl_name}\".\"#{sel_col.last}\"#{'::text' if is_xml} AS \"#{col_alias}\""
+              used_col_aliases[col_alias] = nil
               v1[idx] << col_alias
             end
 
@@ -416,11 +456,10 @@ module ActiveRecord
         end
       end
       # Add derived table JOIN for the has_many counts
-      hm_counts.each do |k, hm|
+      klass._br_hm_counts.each do |k, hm|
         associative = nil
         count_column = if hm.options[:through]
-                         fk_col = (associative = associatives[hm.name])&.foreign_key
-                         hm.foreign_key if fk_col
+                         hm.foreign_key if (fk_col = (associative = klass._br_associatives&.[](hm.name))&.foreign_key)
                        else
                          fk_col = hm.foreign_key
                          poly_type = hm.inverse_of.foreign_type if hm.options.key?(:as)
@@ -450,6 +489,25 @@ JOIN (SELECT #{selects.join(', ')}, COUNT(#{'DISTINCT ' if hm.options[:through]}
         joins!("#{join_clause} ON #{on_clause.join(' AND ')}")
       end
       where!(wheres) unless wheres.empty?
+      # Must parse the order_by and see if there are any symbols which refer to BT associations
+      # as they must be expanded to find the corresponding _br_model__column naming for each.
+      if order_by.present?
+        final_order_by = *order_by.each_with_object([]) do |v, s|
+          if v.is_a?(Symbol)
+            # Add the ordered series of columns derived from the BT based on its DSL
+            if (bt_cols = klass._br_bt_descrip[v])
+              bt_cols.values.each do |v1|
+                v1.each { |v2| s << v2.last if v2.length > 1 }
+              end
+            else
+              s << v
+            end
+          else # String stuff just comes straight through
+            s << v
+          end
+        end
+        order!(*final_order_by)
+      end
       limit!(1000) # Don't want to get too carried away just yet
       wheres unless wheres.empty? # Return the specific parameters that we did use
     end
@@ -619,7 +677,7 @@ Module.class_exec do
                               else
                                 ActiveSupport::Inflector.pluralize(singular_table_name)
                               end
-                 if ::Brick.config.schema_behavior[:multitenant] && Object.const_defined?('Apartment') &&
+                 if ::Brick.apartment_multitenant &&
                     Apartment.excluded_models.include?(table_name.singularize.camelize)
                    schema_name = Apartment.default_schema
                  end
@@ -654,7 +712,7 @@ class Object
   private
 
     def build_model(schema_name, inheritable_name, model_name, singular_table_name, table_name, relations, matching)
-      if ::Brick.config.schema_behavior[:multitenant] && Object.const_defined?('Apartment') &&
+      if ::Brick.apartment_multitenant &&
          schema_name == Apartment.default_schema
         relation = relations["#{schema_name}.#{matching}"]
       end
@@ -665,7 +723,7 @@ class Object
                                       schema_name
                                     else
                                       matching = "#{schema_name}.#{matching}"
-                                      (Brick.db_schemas[schema_name] ||= self.const_get(schema_name.singularize.camelize))
+                                      (Brick.db_schemas[schema_name] ||= self.const_get(schema_name.camelize))
                                     end
                     "#{schema_module&.name}::#{inheritable_name || model_name}"
                   end
@@ -846,7 +904,7 @@ class Object
                 if (inverse = assoc[:inverse])
                   # If it's multitenant with something like:  public.____ ...
                   if (it_parts = inverse_table.split('.')).length > 1 &&
-                     ::Brick.config.schema_behavior[:multitenant] && Object.const_defined?('Apartment') &&
+                     ::Brick.apartment_multitenant &&
                      it_parts.first == Apartment.default_schema
                     it_parts.shift # ... then ditch the generic schema name
                   end
@@ -926,21 +984,26 @@ class Object
         (namespace || Object).const_set(class_name.to_sym, new_controller_class)
 
         # Brick-specific pages
-        if plural_class_name == 'BrickGem'
+        case plural_class_name
+        when 'BrickGem'
           self.define_method :orphans do
             instance_variable_set(:@orphans, ::Brick.find_orphans(::Brick.set_db_schema(params)))
           end
           return [new_controller_class, code + ' # BrickGem controller']
+        when 'BrickSwagger'
+          is_swagger = true # if request.format == :json)
         end
 
-        unless (is_swagger = plural_class_name == 'BrickSwagger') # && request.format == :json)
-          code << "  def index\n"
-          code << "    @#{table_name} = #{model.name}#{pk&.present? ? ".order(#{pk.inspect})" : '.all'}\n"
-          code << "    @#{table_name}.brick_select(params)\n"
-          code << "  end\n"
-        end
         self.protect_from_forgery unless: -> { self.request.format.js? }
         self.define_method :index do
+          # We do all of this now so that bt_descrip and hm_counts are available on the model early in case the user
+          # wants to do an ORDER BY based on any of that
+          translations = {}
+          join_array = ::Brick::JoinArray.new
+          is_add_bts = is_add_hms = true
+          # This builds out bt_descrip and hm_counts on the model
+          model._brick_calculate_bts_hms(translations, join_array) if is_add_bts || is_add_hms
+
           if is_swagger
             json = { 'openapi': '3.0.1', 'info': { 'title': 'API V1', 'version': 'v1' },
                      'servers': [
@@ -990,6 +1053,32 @@ class Object
             render inline: json.to_json, content_type: request.format
             return
           end
+
+          # Normal (non-swagger) request
+
+          # %%% Allow params to define which columns to use for order_by
+          ordering = if (order_tbl = ::Brick.config.order[table_name])
+                       case (order_default = order_tbl[:_brick_default])
+                       when Array
+                         order_default.map { |od_part| order_tbl[od_part] || od_part }
+                       when Symbol
+                         order_tbl[order_default] || order_default
+                       else
+                         pk
+                       end
+                     else
+                       pk # If it's not a custom ORDER BY, just use the key
+                     end
+          order_by, order_by_txt = model._brick_calculate_ordering(ordering)
+          if (order_params = params['_brick_order']&.split(',')&.map(&:to_sym)) # Overriding the default by providing a querystring param?
+            order_by, _ = model._brick_calculate_ordering(order_params, true) # Don't do the txt part
+          end
+
+          code << "  def index\n"
+          code << "    @#{table_name} = #{model.name}#{pk&.present? ? ".order(#{order_by_txt.join(', ')})" : '.all'}\n"
+          code << "    @#{table_name}.brick_select(params)\n"
+          code << "  end\n"
+
           ::Brick.set_db_schema(params)
           if request.format == :csv # Asking for a template?
             require 'csv'
@@ -1003,19 +1092,16 @@ class Object
             return
           end
 
-          quoted_table_name = model.table_name.split('.').map { |x| "\"#{x}\"" }.join('.')
-          order = pk.each_with_object([]) { |pk_part, s| s << "#{quoted_table_name}.\"#{pk_part}\"" }
-          ar_relation = order.present? ? model.order("#{order.join(', ')}") : model.all
-          @_brick_params = ar_relation.brick_select(params, (selects = []), (bt_descrip = {}), (hm_counts = {}), (join_array = ::Brick::JoinArray.new))
+          @_brick_params = (ar_relation = model.all).brick_select(params, (selects = []), order_by, translations, join_array)
           # %%% Add custom HM count columns
           # %%% What happens when the PK is composite?
-          counts = hm_counts.each_with_object([]) { |v, s| s << "_br_#{v.first}._ct_ AS _br_#{v.first}_ct" }
+          counts = model._br_hm_counts.each_with_object([]) { |v, s| s << "_br_#{v.first}._ct_ AS _br_#{v.first}_ct" }
           instance_variable_set("@#{table_name}".to_sym, ar_relation.dup._select!(*selects, *counts))
           if namespace && (idx = lookup_context.prefixes.index(table_name))
             lookup_context.prefixes[idx] = "#{namespace.name.underscore}/#{lookup_context.prefixes[idx]}"
           end
-          @_brick_bt_descrip = bt_descrip
-          @_brick_hm_counts = hm_counts
+          @_brick_bt_descrip = model._br_bt_descrip
+          @_brick_hm_counts = model._br_hm_counts
           @_brick_join_array = join_array
         end
 
@@ -1142,7 +1228,8 @@ module ActiveRecord::ConnectionHandling
       end
       # Load the initializer for the Apartment gem a little early so that if .excluded_models and
       # .default_schema are specified then we can work with non-tenanted models more appropriately
-      if Object.const_defined?('Apartment') && File.exist?(apartment_initializer = Rails.root.join('config/initializers/apartment.rb'))
+      apartment = Object.const_defined?('Apartment')
+      if apartment && File.exist?(apartment_initializer = Rails.root.join('config/initializers/apartment.rb'))
         load apartment_initializer
         apartment_excluded = Apartment.excluded_models
       end
@@ -1345,17 +1432,20 @@ module ActiveRecord::ConnectionHandling
       end
     end
 
-    apartment = Object.const_defined?('Apartment') && Apartment
     tables = []
     views = []
     relations.each do |k, v|
       name_parts = k.split('.')
+      idx = 1
+      name_parts = name_parts.map do |x|
+        ((idx += 1) < name_parts.length ? x.singularize : x).camelize
+      end
       if v.key?(:isView)
         views
       else
         name_parts.shift if apartment && name_parts.length > 1 && name_parts.first == Apartment.default_schema
         tables
-      end << name_parts.map { |x| x.singularize.camelize }.join('::')
+      end << name_parts.join('::')
     end
     unless tables.empty?
       puts "\nClasses that can be built from tables:"
@@ -1437,7 +1527,7 @@ module Brick
       unless (cnstr_name = fk[5])
         # For any appended references (those that come from config), arrive upon a definitely unique constraint name
         pri_tbl = is_class ? fk[4][:class].underscore : pri_tbl
-        pri_tbl = "#{bt_assoc_name}_#{pri_tbl}" if pri_tbl.singularize != bt_assoc_name
+        pri_tbl = "#{bt_assoc_name}_#{pri_tbl}" if pri_tbl&.singularize != bt_assoc_name
         cnstr_base = cnstr_name = "(brick) #{for_tbl}_#{pri_tbl}"
         cnstr_added_num = 1
         cnstr_name = "#{cnstr_base}_#{cnstr_added_num += 1}" while bts&.key?(cnstr_name) || hms&.key?(cnstr_name)
@@ -1463,6 +1553,8 @@ module Brick
           return
         end
       end
+      return unless bts # Rails 5.0 and older can have bts end up being nil
+
       if (assoc_bt = bts[cnstr_name])
         if is_polymorphic
           # Assuming same fk (don't yet support composite keys for polymorphics)

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

@@ -33,6 +33,9 @@ module Brick
         # Additional references (virtual foreign keys)
         ::Brick.additional_references = app.config.brick.fetch(:additional_references, nil)
 
+        # When table names have specific prefixes, automatically place them in their own module with a table_name_prefix.
+        ::Brick.order = app.config.brick.fetch(:order, {})
+
         # Skip creating a has_many association for these
         ::Brick.exclude_hms = app.config.brick.fetch(:exclude_hms, nil)
 
@@ -101,7 +104,7 @@ module Brick
                 path_obj_name = model_name.underscore.tr('/', '_')
                 table_name = obj_name.pluralize
                 template_link = nil
-                bts, hms, associatives = ::Brick.get_bts_and_hms(@_brick_model) # This gets BT and HM and also has_many :through (HMT)
+                bts, hms = ::Brick.get_bts_and_hms(@_brick_model) # This gets BT and HM and also has_many :through (HMT)
                 hms_columns = [] # Used for 'index'
                 skip_klass_hms = ::Brick.config.skip_index_hms[model_name] || {}
                 hms_headers = hms.each_with_object([]) do |hm, s|
@@ -109,7 +112,7 @@ module Brick
                               "H#{hm_assoc.macro == :has_one ? 'O' : 'M'}#{'T' if hm_assoc.options[:through]}",
                               (assoc_name = hm.first)]
                   hm_fk_name = if hm_assoc.options[:through]
-                                 associative = associatives[hm.first]
+                                 associative = @_brick_model._br_associatives[hm.first]
                                  tbl_nm = if hm_assoc.options[:source]
                                             associative.klass.reflect_on_association(hm_assoc.options[:source]).inverse_of&.name
                                           else
@@ -162,13 +165,13 @@ module Brick
               schema_options = ::Brick.db_schemas.keys.each_with_object(+'') { |v, s| s << "<option value=\"#{v}\">#{v}</option>" }.html_safe
               # %%% If we are not auto-creating controllers (or routes) then omit by default, and if enabled anyway, such as in a development
               # environment or whatever, then get either the controllers or routes list instead
-              apartment_default_schema = ::Brick.config.schema_behavior[:multitenant] && Object.const_defined?('Apartment') && Apartment.default_schema
-              table_options = (::Brick.relations.keys - ::Brick.config.exclude_tables).map do |tbl|
+              apartment_default_schema = ::Brick.apartment_multitenant && Apartment.default_schema
+              table_options = (::Brick.relations.keys - ::Brick.config.exclude_tables).each_with_object({}) do |tbl, s|
                                 if (tbl_parts = tbl.split('.')).first == apartment_default_schema
                                   tbl = tbl_parts.last
                                 end
-                                tbl
-                              end.sort.each_with_object(+'') do |v, s|
+                                s[tbl] = nil
+                              end.keys.sort.each_with_object(+'') do |v, s|
                                 s << "<option value=\"#{v.underscore.gsub('.', '/').pluralize}\">#{v}</option>"
                               end.html_safe
               table_options << '<option value="brick_orphans">(Orphans)</option>'.html_safe if is_orphans
@@ -199,6 +202,9 @@ table thead tr th, table tr th {
   color: #fff;
   text-align: left;
 }
+#headerTop th:hover, #headerTop th:hover {
+  background-color: #18B090;
+}
 table thead tr th a, table tr th a {
   color: #80FFB8;
 }
@@ -537,7 +543,7 @@ if (headerTop) {
        k, id = @_brick_params.first
        id = id.first if id.is_a?(Array) && id.length == 1
        origin = (key_parts = k.split('.')).length == 1 ? #{model_name} : #{model_name}.reflect_on_association(key_parts.first).klass
-       if (destination_fk = Brick.relations[origin.table_name][:fks].values.find { |fk| puts fk.inspect; fk[:fk] == key_parts.last }) &&
+       if (destination_fk = Brick.relations[origin.table_name][:fks].values.find { |fk| fk[:fk] == key_parts.last }) &&
           (obj = (destination = origin.reflect_on_association(destination_fk[:assoc_name])&.klass)&.find(id)) %>
          <h3>for <%= link_to \"#{"#\{obj.brick_descrip\} (#\{destination.name\})\""}, send(\"#\{destination.name.underscore.tr('/', '_')\}_path\".to_sym, id) %></h3><%
        end
@@ -547,30 +553,33 @@ if (headerTop) {
 <br>
 <table id=\"headerTop\">
 <table id=\"#{table_name}\">
-  <thead><tr>#{'<th></th>' if pk.present?}<%
+  <thead><tr>#{"<th x-order=\"#{pk.join(',')}\"></th>" if pk.present?}<%
      col_order = []
      @#{table_name}.columns.each do |col|
        next if (#{(pk || []).inspect}.include?(col_name = col.name) && col.type == :integer && !bts.key?(col_name)) ||
                ::Brick.config.metadata_columns.include?(col_name) || poly_cols.include?(col_name)
 
        col_order << col_name
-    %><th<%= \" title = \\\"#\{col.comment}\\\"\".html_safe if col.respond_to?(:comment) && !col.comment.blank? %>><%
+    %><th<%= \" title=\\\"#\{col.comment}\\\"\".html_safe if col.respond_to?(:comment) && !col.comment.blank? %><%
        if (bt = bts[col_name]) %>
-         BT <%
+         <%= \" x-order=\\\"#\{bt.first}\\\"\".html_safe unless bt[2] # Allow sorting any BT except polymorphics
+         %>>BT <%
          bt[1].each do |bt_pair| %><%=
            bt_pair.first.bt_link(bt.first) %> <%
          end %><%
-       else %><%=
-         col_name %><%
+       else %><%= \" x-order=\\\"#\{col_name}\\\"\".html_safe if true # Currently we always allow click to sort
+         %>><%= col_name %><%
        end
     %></th><%
      end
      # Consider getting the name from the association -- h.first.name -- if a more \"friendly\" alias should be used for a screwy table name
   %>#{hms_headers.map do |h|
+        # Currently we always allow click to sort
+        "<th#{" x-order=\"#{h.first.name}\"" if true}>" +
         if h.first.options[:through] && !h.first.through_reflection
-    "<th>#{h[1]} #{h[2]} %></th>" # %%% Would be able to remove this when multiple foreign keys to same destination becomes bulletproof
+    "#{h[1]} #{h[2]} %></th>" # %%% Would be able to remove this when multiple foreign keys to same destination becomes bulletproof
         else
-    "<th>#{h[1]} <%= link_to('#{h[2]}', #{h.first.klass.name.underscore.tr('/', '_').pluralize}_path) %></th>"
+    "#{h[1]} <%= link_to('#{h[2]}', #{h.first.klass.name.underscore.tr('/', '_').pluralize}_path) %></th>"
         end
       end.join
   }</tr></thead>
@@ -658,7 +667,7 @@ end
     <tr>
     <% next if (#{(pk || []).inspect}.include?(k) && !bts.key?(k)) ||
                ::Brick.config.metadata_columns.include?(k) %>
-    <th class=\"show-field\"<%= \" title = \\\"#\{col.comment}\\\"\".html_safe if col.respond_to?(:comment) && !col.comment.blank? %>>
+    <th class=\"show-field\"<%= \" title=\\\"#\{col.comment}\\\"\".html_safe if col.respond_to?(:comment) && !col.comment.blank? %>>
     <% has_fields = true
       if (bt = bts[k])
         # Add a final member in this array with descriptive options to be used in <select> drop-downs
@@ -729,9 +738,14 @@ end
       <% when :uuid %>
         <%=
           # Postgres naturally uses the +uuid_generate_v4()+ function from the uuid-ossp extension
-          # If it's not yet enabled then:  enable_extension 'uuid-ossp'
+          # If it's not yet enabled then:  create extension \"uuid-ossp\";
           # ActiveUUID gem created a new :uuid type
           val %>
+      <% when :ltree %>
+        <%=
+          # In Postgres labels of data stored in a hierarchical tree-like structure
+          # If it's not yet enabled then:  create extension ltree;
+          val %>
       <% when :binary, :primary_key %>
       <% end %>
     <% end %>
@@ -789,6 +803,15 @@ flatpickr(\".timepicker\", {enableTime: true, noCalendar: true});
 </script>
 <% end %>
 <script>
+<% # Make column headers sort when clicked
+   # %%% Create a smart javascript routine which can do this client-side %>
+[... document.getElementsByTagName(\"TH\")].forEach(function (th) {
+  th.addEventListener(\"click\", function (e) {
+    var xOrder;
+    if (xOrder = this.getAttribute(\"x-order\"))
+      location.href = changeout(location.href, \"_brick_order\", xOrder);
+  });
+});
 document.querySelectorAll(\"input, select\").forEach(function (inp) {
   var origVal = getInpVal(),
       prevVal = origVal;

data/lib/brick/version_number.rb

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

data/lib/brick.rb

@@ -47,7 +47,6 @@ end
 
 # Add left_outer_join! to Associations::JoinDependency and Relation::QueryMethods
 if ActiveRecord.version < ::Gem::Version.new('5')
-  is_add_left_outer_join = true
   ::Brick::Util._patch_require(
     'active_record/associations/join_dependency.rb', '/activerecord', # /associations
       ["def join_constraints(outer_joins)
@@ -140,6 +139,13 @@ module Brick
       (@relations ||= {})[ActiveRecord::Base.connection_pool.object_id] ||= Hash.new { |h, k| h[k] = Hash.new { |h, k| h[k] = {} } }
     end
 
+    def apartment_multitenant
+      if @apartment_multitenant.nil?
+        @apartment_multitenant = ::Brick.config.schema_behavior[:multitenant] && Object.const_defined?('Apartment')
+      end
+      @apartment_multitenant
+    end
+
     # If multitenancy is enabled, a list of non-tenanted "global" models
     def non_tenanted_models
       @pending_models ||= {}
@@ -166,14 +172,14 @@ module Brick
       # Mark has_manys that go to an associative ("join") table so that they are skipped in the UI,
       # as well as any possible polymorphic associations
       skip_hms = {}
-      associatives = hms.each_with_object({}) do |hmt, s|
+      hms.each do |hmt|
         if (through = hmt.last.options[:through])
           skip_hms[through] = nil # if hms[through]
           # binding.pry if !hms[through]
           # End up with a hash of HMT names pointing to join-table associations
           # Last part was:  hmt.last.name
           # Changed up because looking for:  hms[:issue_issue_duplicates]
-          s[hmt.first] = hms[through] # || hms["#{(opt = hmt.last.options)[:through].to_s.singularize}_#{opt[:source].to_s.pluralize}".to_sym]
+          model._br_associatives[hmt.first] = hms[through] # || hms["#{(opt = hmt.last.options)[:through].to_s.singularize}_#{opt[:source].to_s.pluralize}".to_sym]
         elsif hmt.last.inverse_of.nil?
           puts "SKIPPING #{hmt.last.name.inspect}"
           # %%% If we don't do this then below associative.name will find that associative is nil
@@ -181,7 +187,7 @@ module Brick
         end
       end
       skip_hms.each { |k, _v| hms.delete(k) }
-      [bts, hms, associatives]
+      [bts, hms]
     end
 
     # Switches Brick auto-models on or off, for all threads
@@ -277,6 +283,11 @@ module Brick
       end
     end
 
+    # @api public
+    def order=(value)
+      Brick.config.order = value
+    end
+
     # Skip creating a has_many association for these
     # (Uses the same exact three-part format as would define an additional_reference)
     # @api public
@@ -451,7 +462,7 @@ In config/initializers/brick.rb appropriate entries would look something like:
         ::Brick.relations.each do |rel_name, v|
           rel_name = rel_name.split('.').map(&:underscore)
           schema_names = rel_name[0..-2]
-          schema_names.shift if ::Brick.config.schema_behavior[:multitenant] && Object.const_defined?('Apartment') && schema_names.first == Apartment.default_schema
+          schema_names.shift if ::Brick.apartment_multitenant && schema_names.first == Apartment.default_schema
           k = rel_name.last
           unless existing_controllers.key?(controller_name = k.pluralize)
             options = {}
@@ -481,7 +492,8 @@ require 'brick/version_number'
 # Older versions of ActiveRecord would only show more serious error information from "panic" level, which is
 # a level only available in Postgres 12 and older.  This patch will allow older and newer versions of Postgres
 # to work along with fairly old versions of Rails.
-if Object.const_defined?('PG::VERSION') && ActiveRecord.version < ::Gem::Version.new('4.2.6')
+if (is_postgres = (Object.const_defined?('PG::VERSION') || Gem::Specification.find_all_by_name('pg').present?)) &&
+   ActiveRecord.version < ::Gem::Version.new('4.2.6')
   ::Brick::Util._patch_require(
     'active_record/connection_adapters/postgresql_adapter.rb', '/activerecord', ["'panic'", "'error'"]
   )
@@ -489,13 +501,28 @@ end
 
 require 'active_record'
 require 'active_record/relation'
-require 'active_record/relation/query_methods' if is_add_left_outer_join
+# To support adding left_outer_join
+require 'active_record/relation/query_methods' if ActiveRecord.version < ::Gem::Version.new('5')
+require 'rails/railtie' if ActiveRecord.version < ::Gem::Version.new('4.2')
 
 # Rake tasks
 class Railtie < Rails::Railtie
   Dir.glob("#{File.expand_path(__dir__)}/brick/tasks/**/*.rake").each { |task| load task }
 end
 
+# Rails < 4.2 does not have env
+module Rails
+  unless respond_to?(:env)
+    def self.env
+      @_env ||= ActiveSupport::StringInquirer.new(ENV["RAILS_ENV"] || ENV["RACK_ENV"] || "development")
+    end
+
+    def self.env=(environment)
+      @_env = ActiveSupport::StringInquirer.new(environment)
+    end
+  end
+end
+
 # Major compatibility fixes for ActiveRecord < 4.2
 # ================================================
 ActiveSupport.on_load(:active_record) do
@@ -510,6 +537,15 @@ ActiveSupport.on_load(:active_record) do
           end
         end
       end
+      # ActiveRecord < 4.2 does not have default_timezone
+      # :singleton-method:
+      # Determines whether to use Time.utc (using :utc) or Time.local (using :local) when pulling
+      # dates and times from the database. This is set to :utc by default.
+      unless respond_to?(:default_timezone)
+        puts "ADDING!!! 4.w"
+        mattr_accessor :default_timezone, instance_writer: false
+        self.default_timezone = :utc
+      end
     end
 
     # Rails < 4.0 cannot do #find_by, #find_or_create_by, or do #pluck on multiple columns, so here are the patches:
@@ -715,58 +751,60 @@ ActiveSupport.on_load(:active_record) do
         end
       end
 
-      if is_add_left_outer_join
-        # Final pieces for left_outer_joins support, which was derived from this commit:
-        # https://github.com/rails/rails/commit/3f46ef1ddab87482b730a3f53987e04308783d8b
-        module Associations
-          class JoinDependency
-            def make_left_outer_joins(parent, child)
-              tables    = child.tables
-              join_type = Arel::Nodes::OuterJoin
-              info      = make_constraints parent, child, tables, join_type
-
-              [info] + child.children.flat_map { |c| make_left_outer_joins(child, c) }
-            end
+      # Final pieces for left_outer_joins support, which was derived from this commit:
+      # https://github.com/rails/rails/commit/3f46ef1ddab87482b730a3f53987e04308783d8b
+      module Associations
+        class JoinDependency
+          def make_left_outer_joins(parent, child)
+            tables    = child.tables
+            join_type = Arel::Nodes::OuterJoin
+            info      = make_constraints parent, child, tables, join_type
+
+            [info] + child.children.flat_map { |c| make_left_outer_joins(child, c) }
           end
         end
-        module Querying
-          delegate :left_outer_joins, to: :all
+      end
+      module Querying
+        delegate :left_outer_joins, to: :all
+      end
+      class Relation
+        unless MULTI_VALUE_METHODS.include?(:left_outer_joins)
+          _multi_value_methods = MULTI_VALUE_METHODS + [:left_outer_joins]
+          send(:remove_const, :MULTI_VALUE_METHODS)
+          MULTI_VALUE_METHODS = _multi_value_methods
         end
-        class Relation
-          MULTI_VALUE_METHODS = MULTI_VALUE_METHODS + [:left_outer_joins] unless MULTI_VALUE_METHODS.include?(:left_outer_joins)
+      end
+      module QueryMethods
+        attr_writer :left_outer_joins_values
+        def left_outer_joins_values
+          @left_outer_joins_values ||= []
         end
-        module QueryMethods
-          attr_writer :left_outer_joins_values
-          def left_outer_joins_values
-            @left_outer_joins_values ||= []
-          end
 
-          def left_outer_joins(*args)
-            check_if_method_has_arguments!(:left_outer_joins, args)
+        def left_outer_joins(*args)
+          check_if_method_has_arguments!(:left_outer_joins, args)
 
-            args.compact!
-            args.flatten!
+          args.compact!
+          args.flatten!
 
-            spawn.left_outer_joins!(*args)
-          end
+          spawn.left_outer_joins!(*args)
+        end
 
-          def left_outer_joins!(*args) # :nodoc:
-            self.left_outer_joins_values += args
-            self
-          end
+        def left_outer_joins!(*args) # :nodoc:
+          self.left_outer_joins_values += args
+          self
+        end
 
-          def build_left_outer_joins(manager, outer_joins)
-            buckets = outer_joins.group_by do |join|
-              case join
-              when Hash, Symbol, Array
-                :association_join
-              else
-                raise ArgumentError, 'only Hash, Symbol and Array are allowed'
-              end
+        def build_left_outer_joins(manager, outer_joins)
+          buckets = outer_joins.group_by do |join|
+            case join
+            when Hash, Symbol, Array
+              :association_join
+            else
+              raise ArgumentError, 'only Hash, Symbol and Array are allowed'
             end
-
-            build_join_query(manager, buckets, Arel::Nodes::OuterJoin)
           end
+
+          build_join_query(manager, buckets, Arel::Nodes::OuterJoin)
         end
       end
       # (End of left_outer_joins support)
@@ -788,7 +826,8 @@ ActiveSupport.on_load(:active_record) do
 end
 
 # Do this earlier because stuff here gets mixed into JoinDependency::JoinAssociation and AssociationScope
-if ActiveRecord.version < ::Gem::Version.new('5.0') && Object.const_defined?('PG::Connection')
+if is_postgres && ActiveRecord.version < ::Gem::Version.new('5.0') # Was:  && Object.const_defined?('PG::Connection')
+  require 'pg' # For ActiveRecord < 4.2
   # Avoid pg gem deprecation warning:  "You should use PG::Connection, PG::Result, and PG::Error instead"
   PGconn = PG::Connection
   PGresult = PG::Result

data/lib/generators/brick/install_generator.rb

@@ -159,6 +159,41 @@ module Brick
 # # When table names have specific prefixes automatically place them in their own module with a table_name_prefix.
 # Brick.table_name_prefixes = { 'nav_' => 'Navigation' }
 
+# # COLUMN SEQUENCING AND INCLUSION / EXCLUSION
+
+# # By default if there is a primary key present then rows in an index view are ordered by this primary key.  To
+# # use a different rule for doing ORDER BY, you can override this default ordering done by The Brick, for instance
+# # to have the rows in a contact list sorted by email:
+# Brick.order = { 'contacts' => { _brick_default: :email } }
+# # or by last name then first name:
+# Brick.order = { 'contacts' => { _brick_default: [:lastname, :firstname] } }
+# # Totally legitimate to have the default order be the name of a belongs_to or has_many association instead of an
+# # actual column name, in which case for has_many it just orders by the count of how many records are associated,
+# # and for belongs_to it's based on the primary table's DSL if any is defined (since that is what is used to
+# # calculate what is shown when a foreign table lists out related records).  If contacts relates to addresses,
+# # then this is perfectly fine:
+# Brick.order = { 'contacts' => { _brick_default: :address } }
+# # You can even have a specific custom clause used in the ORDER BY.  In this case it is recommended to include a
+# # special placeholder for the table name with the sequence \"^^^\".  Here is an example of having the default
+# # ordering happening on the \"code\" column, and also defining custom sorting to be done, in this case proper
+# # ordering if that code is stored as a dotted numeric value:
+# Brick.order = { 'document_trees' => { _brick_default: :code,
+#                                       code: \"ORDER BY STRING_TO_ARRAY(^^^.code, '.')::int[]\" } }
+
+# # Sequence of columns for each model.  This also allows you to add read-only calculated columns in the same
+# # kind of way that they can be added in the include: portion of include/exclude columns, below.
+# # Designated by { <table name> => [<column name>, <column name>] }
+# Brick.column_sequence = { 'users' => ['email', 'profile.firstname', 'profile.lastname'] }
+
+# # Specific columns to include or exclude for each model.  If there are only inclusions then only those
+# # columns show.  If there are any exclusions then all non-excluded columns are attempted to be shown,
+# # which negates the usefulness of inclusions except to add calculated column detail built from DSL.
+# # Designated by <table name>.<column name>
+# Brick.column_sequence = { 'users' =>   { include: ['email', 'profile.firstname', 'profile.lastname'] },
+#                           'profile' => { exclude: ['birthdate'] } }
+
+# # EXTRA FOREIGN KEYS AND OTHER HAS_MANY SETTINGS
+
 # # 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
@@ -176,8 +211,9 @@ module Brick
 # Brick.exclude_hms = [['users', 'favourite_colour_id', 'colours']]
 
 # # Skip showing counts for these specific has_many associations when building auto-generated #index views.
-# # When there are related tables with a significant number of records, this can lessen the load on the database
-# # considerably, sometimes fixing what might appear to be an index page that just \"hangs\" for no apparent reason.
+# # When there are related tables with a significant number of records (generally 100,000 or more), this can lessen
+# # the load on the database considerably, sometimes fixing what might appear to be an index page that just \"hangs\"
+# # for no apparent reason.
 # Brick.skip_index_hms = ['User.litany_of_woes']
 
 # # By default primary tables involved in a foreign key relationship will indicate a \"has_many\" relationship pointing
@@ -199,6 +235,8 @@ module Brick
 # # Designated by <table name>.<column name>
 # Brick.not_nullables = ['users.name']
 
+# # FRIENDLY DSL
+
 # # A simple DSL is available to allow more user-friendly display of objects.  Normally a user object might be shown
 # # as its first non-metadata column, or if that is not available then something like \"User #45\" where 45 is that
 # # object's ID.  If there is no primary key then even that is not possible, so the object's .to_s method is called.
@@ -206,6 +244,8 @@ module Brick
 # # user, then you can use model_descrips like this, putting expressions with property references in square brackets:
 # Brick.model_descrips = { 'User' => '[profile.firstname] [profile.lastname]' }
 
+# # SINGLE TABLE INHERITANCE
+
 # # Specify STI subclasses either directly by name or as a general module prefix that should always relate to a specific
 # # parent STI class.  The prefixed :: here for these examples is mandatory.  Also having a suffixed :: means instead of
 # # a class reference, this is for a general namespace reference.  So in this case requests for, say, either of the
@@ -221,6 +261,8 @@ module Brick
 # Brick.sti_type_column = 'sti_type'
 # Brick.sti_type_column = { 'rails_type' => ['sales.specialoffer'] }
 
+# # POLYMORPHIC ASSOCIATIONS
+
 # # Database schema to use when analysing existing data, such as deriving a list of polymorphic classes in the case that
 # # it wasn't originally specified.
 # Brick.schema_behavior = :namespaced
@@ -231,6 +273,8 @@ module Brick
 
 # # Polymorphic associations are set up by providing a model name and polymorphic association name#{poly}
 
+# # DEFAULT ROOT ROUTE
+
 # # 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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: brick
 version: !ruby/object:Gem::Version
-  version: 1.0.47
+  version: 1.0.50
 platform: ruby
 authors:
 - Lorin Thwaits
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-07-17 00:00:00.000000000 Z
+date: 2022-07-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -17,9 +17,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '4.2'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '7.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -27,9 +24,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '4.2'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '7.2'
 - !ruby/object:Gem::Dependency
   name: fancy_gets
   requirement: !ruby/object:Gem::Requirement