ActiveRecordMask

ActiveRecordMask is a small ruby library that provides an easy way to mask read access to database attributes and associations in ActiveRecord objects.

It allows you to configure default or empty values with configuration on a per-model basis.

some_object = SomeClass.first

some_object.title == 'Real Title'
=> false

some_object.some_associations.count == 0
=> true

some_object.title == 'some configured default'
=> true

# Allow reading of real data.
some_object.mask_down!

some_object.title == 'Real Title'
=> true

some_object.some_associations.count
=> 2342

# Prevent reading of real data.
some_object.mask_up!

some_object.title == 'Real Title'
=> false

• Whitelist attributes and associations that should be returned by default.
• Define custom default values for attributes.
• Toggle between showing real data or default values.
• All configurable per model.

Add this line to your application's Gemfile:

gem 'active_record_mask'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install active_record_mask

Include the ActiveRecordMask module in your ActiveRecord model and use the configure_active_record_mask block to set up the configuration.

class SomeClass < ActiveRecord::Base
  include ActiveRecordMask

  has_many :another_classes
  
  # ActiveRecordMask configuration
  configure_active_record_mask do |config|
    config.show_real_data_by_default(false)
    config.allow_attributes([:id])
    # config.allow_associations([:another_classes])
    config.revealed_defaults({ title: 'hidden' })
  end
end

• show_real_data_by_default: Set to true if you want real data to be shown by default, without calling mask_down!. Default: false

• revealed_defaults: Define custom default values for specific attributes. It accepts a attribute-name value hash. Default: {}

• allow_attributes: Define a list of attributes that should not be protected. Default: [:id]

• allow_associations: Define a list of associations that should not be protected. Default: []

bundle exec rspec

Bug reports and pull requests are welcome: https://github.com/sventantau/active_record_mask

The gem is available as open source under the terms of the MIT License.