Module: Hoardable

Defined in:

lib/hoardable/engine.rb,
lib/hoardable/error.rb,
lib/hoardable/model.rb,
lib/hoardable/scopes.rb,
lib/hoardable/has_one.rb,
lib/hoardable/version.rb,
lib/hoardable/has_many.rb,
lib/hoardable/rich_text.rb,
lib/hoardable/belongs_to.rb,
lib/hoardable/associations.rb,
lib/hoardable/source_model.rb,
lib/hoardable/arel_visitors.rb,
lib/hoardable/has_rich_text.rb,
lib/hoardable/schema_dumper.rb,
lib/hoardable/version_model.rb,
lib/hoardable/finder_methods.rb,
lib/hoardable/database_client.rb,
lib/hoardable/schema_statements.rb,
lib/hoardable/encrypted_rich_text.rb,
lib/generators/hoardable/install_generator.rb,
lib/generators/hoardable/migration_generator.rb

Overview

An ActiveRecord extension for keeping versions of records in uni-temporal inherited tables.

Defined Under Namespace

Modules: ArelVisitors, Associations, FinderMethods, Model, Scopes, SourceModel, VersionModel Classes: CreatedAtColumnMissingError, EncryptedRichText, Engine, Error, InstallGenerator, MigrationGenerator, RichText, UpdatedAtColumnMissingError

Constant Summary

REGISTRY =

Set.new

DATA_KEYS =

Symbols for use with setting contextual data, when creating versions. See README for more.

%i[meta whodunit event_uuid].freeze

CONFIG_KEYS =

Symbols for use with setting Hoardable configuration. See README for more.

%i[enabled version_updates save_trash].freeze

VERSION =

"0.15.0"

Class Method Summary

• .at(datetime) ⇒ Object

  Allows performing a query for record states at a certain time.

• .with(hash) ⇒ Object

  This is a general use method for setting Contextual Data or Configuration around a block.

Class Method Details

.at(datetime) ⇒ Object

Allows performing a query for record states at a certain time. Returned SourceModel instances within the block may be SourceModel or VersionModel records.

Parameters:

• datetime (DateTime, Time) —

  the datetime or time to temporally query records at

# File 'lib/hoardable/engine.rb', line 77

def at(datetime)
  @at = datetime
  yield
ensure
  @at = nil
end

.with(hash) ⇒ Object

This is a general use method for setting Contextual Data or Configuration around a block.

Parameters:

• hash (Hash) —

  config and contextual data to set within a block

# File 'lib/hoardable/engine.rb', line 62

def with(hash)
  current_config = @config
  current_context = @context
  @config = current_config.merge(hash.slice(*CONFIG_KEYS))
  @context = current_context.merge(hash.slice(*DATA_KEYS))
  yield
ensure
  @config = current_config
  @context = current_context
end