Class: Demiurge::StateItem

Inherits:
Object
  • Object
show all
Defined in:
lib/demiurge.rb,
lib/demiurge.rb

Overview

StateItems can be serialized at any time to "structured array" format. That format consists of a set of Plain Old Ruby Objects (POROs) which are guaranteed to be serializable as JSON, and thus consist of only basic data structures like Strings, Arrays, Booleans and Hashes. A single StateItem will serialize itself to a short Array of this form: ["ObjectType", "item name", state_hash]. The ObjectType is the type registered with the engine, such as "ActionItem". The "item name" is the object-unique item name. And the state_hash is a JSON-serializable Ruby Hash with the object's current state. A dump of multiple StateItems will be an Array of these Arrays.

Direct Known Subclasses

ActionItem, InertStateItem

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name, engine, state) ⇒ void

The constructor. This does not register the StateItem with the Engine. For that, see Engine#register_state_item.

Parameters:

  • name (String) —

    The Engine-unique item name

  • engine (Demiurge::Engine) —

    The Engine this item is part of

  • state (Hash) —

    State data to initialize from

See Also:

Since:

  • 0.0.1



746
747
748
749
750
 
# File 'lib/demiurge.rb', line 746

def initialize(name, engine, state)
  @name = name
  @engine = engine
  @state = state
end

Instance Attribute Details

#engine ⇒ Demiurge::Engine (readonly)

Returns The Engine this item is part of.

Returns:



729
730
731
 
# File 'lib/demiurge.rb', line 729

def engine
  @engine
end

#name ⇒ String (readonly)

Returns The unique, registered or registerable name of this Demiurge::StateItem.

Returns:

Since:

  • 0.0.1



726
727
728
 
# File 'lib/demiurge.rb', line 726

def name
  @name
end

Class Method Details

.from_name_type(engine, type, name, state) ⇒ Demiurge::StateItem

Create a single StateItem from structured array format

Returns:

See Also:

Since:

  • 0.0.1



799
800
801
 
# File 'lib/demiurge.rb', line 799

def self.from_name_type(engine, type, name, state)
  engine.get_type(type).new(name, engine, state)
end

Instance Method Details

#agent? ⇒ Boolean

This method determines whether the item will be treated as an agent. Inheriting from Demiurge::Agent will cause that to occur. So will redefining the agent? method to return true. Whether agent? returns true should not depend on state, which may not be set when this method is called.

Returns:

  • (Boolean) —

    Whether this item is considered an Agent.

Since:

  • 0.0.1



772
773
774
 
# File 'lib/demiurge.rb', line 772

def agent?
  false
end

#get_structure ⇒ Array

The StateItem's serialized state in structured array format.

Returns:

  • (Array) —

    The serialized state

See Also:

Since:

  • 0.0.1



790
791
792
 
# File 'lib/demiurge.rb', line 790

def get_structure()
  [state_type, @name, @state]
end

#intentions_for_next_step(*args) ⇒ Array<Demiurge::Intention>

Get this StateItem's Intentions for the upcoming tick, with its current internal state. Note that this can change over the course of a tick as the internal state changes, but it should not change if the state doesn't.

Returns:

Since:

  • 0.0.1



810
811
812
 
# File 'lib/demiurge.rb', line 810

def intentions_for_next_step(*args)
  raise "StateItem must be subclassed to be used!"
end

#state ⇒ Object

Return this StateItem's current state in a JSON-serializable form.

Returns:

  • (Object) —

    The JSON-serializable state, usually a Hash

Since:

  • 0.0.1



781
782
783
 
# File 'lib/demiurge.rb', line 781

def state
  @state
end

#state_type ⇒ String

Returns The default StateItem type of this item. Can be overridden by child classes.

Returns:

  • (String) —

    The default StateItem type of this item. Can be overridden by child classes.

Since:

  • 0.0.1



733
734
735
 
# File 'lib/demiurge.rb', line 733

def state_type
  self.class.name.split("::")[-1]
end

#zone? ⇒ Boolean

This method determines whether the item will be treated as a top-level zone. Inheriting from Demiurge::Zone will cause that to occur. So will redefining the zone? method to return true. Whether zone? returns true should not depend on state, which may not be set when this method is called.

Returns:

  • (Boolean) —

    Whether this item is considered a Zone.

Since:

  • 0.0.1



760
761
762
 
# File 'lib/demiurge.rb', line 760

def zone?
  false
end