Sha256: 8d095c97137570b03c2af38acab70b3a9850843ef3bb2e00f9e2a3ae98d2ee28

Contents?: true

Size: 1.81 KB

Versions: 157

Compression:

Stored size: 1.81 KB

Contents

# frozen-string-literal: true

module Sequel
  module Plugins
    # The accessed_columns plugin records which columns have been
    # accessed for a model instance.  This is useful if you are
    # looking to remove other columns from being SELECTed by the
    # dataset that retrieved the instance, which can significantly
    # improve performance:
    #
    #   a = Album[1]
    #   a.accessed_columns # []
    #   a.name
    #   a.accessed_columns # [:name]
    #   a.artist_id
    #   a.accessed_columns # [:name, :artist_id]
    #
    # Note that this plugin should probably not be used in production,
    # as it causes a performance hit.
    # 
    # Usage:
    #
    #   # Make all model subclass instances record accessed columns (called before loading subclasses)
    #   Sequel::Model.plugin :accessed_columns
    #
    #   # Make the Album instances record accessed columns
    #   Album.plugin :accessed_columns
    module AccessedColumns
      module InstanceMethods
        # Record the column access before retrieving the value.
        def [](c)
          (@accessed_columns ||= {})[c] = true unless frozen?
          super
        end

        # Clear the accessed columns when saving.
        def after_save
          super
          @accessed_columns = nil
        end

        # The columns that have been accessed.
        def accessed_columns
          @accessed_columns ? @accessed_columns.keys : []
        end

        # Copy the accessed columns when duping and cloning.
        def initialize_copy(other)
          other.instance_variable_set(:@accessed_columns, Hash[@accessed_columns]) if @accessed_columns
          super
        end

        private

        # Clear the accessed columns when refreshing.
        def _refresh(_)
          @accessed_columns = nil
          super
        end
      end
    end
  end
end

Version data entries

157 entries across 138 versions & 2 rubygems

Version Path
sequel-5.90.0 lib/sequel/plugins/accessed_columns.rb
sequel-5.89.0 lib/sequel/plugins/accessed_columns.rb
sequel-5.88.0 lib/sequel/plugins/accessed_columns.rb
sequel-5.87.0 lib/sequel/plugins/accessed_columns.rb
sequel-5.86.0 lib/sequel/plugins/accessed_columns.rb
sequel-5.85.0 lib/sequel/plugins/accessed_columns.rb
sequel-5.84.0 lib/sequel/plugins/accessed_columns.rb
sequel-5.83.1 lib/sequel/plugins/accessed_columns.rb
sequel-5.83.0 lib/sequel/plugins/accessed_columns.rb
sequel-5.82.0 lib/sequel/plugins/accessed_columns.rb
sequel-5.81.0 lib/sequel/plugins/accessed_columns.rb
sequel-5.80.0 lib/sequel/plugins/accessed_columns.rb
sequel-5.79.0 lib/sequel/plugins/accessed_columns.rb
sequel-5.78.0 lib/sequel/plugins/accessed_columns.rb
sequel-5.77.0 lib/sequel/plugins/accessed_columns.rb
sequel-5.76.0 lib/sequel/plugins/accessed_columns.rb
sequel-5.75.0 lib/sequel/plugins/accessed_columns.rb
sequel-5.74.0 lib/sequel/plugins/accessed_columns.rb
sequel-5.73.0 lib/sequel/plugins/accessed_columns.rb
sequel-5.72.0 lib/sequel/plugins/accessed_columns.rb