Module: Stannum::Entities::Properties

Parent Namespace

Stannum::Entities

Defined In

lib/stannum/entities/properties.rb

Table Of Contents

• Overview
• Instance Methods
  • ==
  • []
  • []=
  • assign_properties
  • initialize
  • inspect
  • inspect_with_options
  • properties
  • properties=
  • to_h

Overview

Abstract module for handling heterogenous entity properties.

This module provides a base for accessing and mutating entity properties such as attributes and associations.

Back To Top

Instance Methods

#==(other) =>

Compares the entity with the other object.

The other object must be an instance of the current class. In addition, the properties hashes of the two objects must be equal.

Returns

• () — true if the object is a matching entity.

#[](property) => Object

Retrieves the property with the given key.

Parameters

• property (String, Symbol) — The property key.

Returns

• (Object) — the value of the property.

Raises

• () — ArgumentError if the key is not a valid property.

#[]=(property, value) => Object

Sets the given property to the given value.

Parameters

• property (String, Symbol) — The property key.
• value (Object) — The value for the property.

Raises

• () — ArgumentError if the key is not a valid property.

#assign_properties(properties) => Object

Also known as: assign

Updates the struct’s properties with the given values.

This method is used to update some (but not all) of the properties of the struct. For each key in the hash, it calls the corresponding writer method with the value for that property. If the value is nil, this will set the property value to the default for that property.

Any properties that are not in the given hash are unchanged.

If the properties hash includes any keys that do not correspond to an property, the struct will raise an error.

Parameters

• properties (Hash) — The initial properties for the struct.

Raises

• () — ArgumentError if the key is not a valid property.

See Also

• #properties=

#initialize(**properties) => Object

Parameters

• properties (Hash) — the properties used to initialize the entity.

#inspect => String

Returns

• (String) — a string representation of the entity and its properties.

#inspect_with_options(**options) => String

Parameters

• options (Hash) — options for inspecting the entity.

Options Hash (options)

• memory_address (Boolean) — if true, displays the memory address of the object (as per Object#inspect). Defaults to false.
• properties (Boolean) — if true, displays the entity properties. Defaults to true.

Returns

• (String) — a string representation of the entity and its properties.

#properties => Hash<String, Object>

Collects the entity properties.

Returns

• (Hash<String, Object>) — the entity properties.

#properties=(properties) => Object

Replaces the entity’s properties with the given values.

This method is used to update all of the properties of the entity. For each property, the writer method is called with the value from the hash, or nil if the corresponding key is not present in the hash. Any nil or missing values set the property value to that property’s default value, if any.

If the properties hash includes any keys that do not correspond to a valid property, the entity will raise an error.

Parameters

• properties (Hash) — the properties to assign to the entity.

Raises

• () — ArgumentError if any key is not a valid property.

See Also

• #assign_properties

#to_h => Hash<String, Object>

Returns a Hash representation of the entity.

Returns

• (Hash<String, Object>) — the entity properties.

See Also

• #properties

Back To Top

---

Back to Documentation | Versions | 0.4 | Reference | Stannum | Stannum::Entities