openHAB

Class: OpenHAB::DSL::Things::ThingBuilder

Inherits:
Object
  • Object
show all
Defined in:
lib/openhab/dsl/things/builder.rb

Overview

The ThingBuilder DSL allows you to customize a thing

Direct Known Subclasses

BridgeBuilder

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(uid, label = nil, binding: nil, type: nil, bridge: nil, location: nil, config: {}, enabled: nil) ⇒ ThingBuilder

Constructor for ThingBuilder

Parameters:

  • uid (String) —

    The ThingUID for the created Thing. This can consist one or more segments separated by a colon. When the uid contains:

    • One segment: When the uid contains one segment, binding or bridge id must be provided.
    • Two segments: typeid:thingid The binding or bridge id must be provided.
    • Three or more segments: bindingid:typeid:[bridgeid...]:thingid. The type and bridge can be omitted
  • label (String) (defaults to: nil) —

    The Thing's label.

  • binding (String) (defaults to: nil) —

    The binding id. When this argument is not provided, the binding id must be deducible from the uid, type, or bridge.

  • type (String) (defaults to: nil) —

    The type id. When this argument is not provided, it will be deducible from the uid if it contains two or more segments. To create a Thing with a blank type id, use one segment for uid and provide the binding id.

  • bridge (String, BridgeBuilder) (defaults to: nil) —

    The bridge uid, if the Thing should belong to a bridge.

  • location (String, Item) (defaults to: nil) —

    The location of this Thing. When given an Item, use the item's label as the location.

  • config (Hash) (defaults to: {}) —

    The Thing's configuration, as required by the binding. The key can be strings or symbols.

  • enabled (true, false) (defaults to: nil) —

    Whether the Thing should be enabled or disabled.



159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
 
# File 'lib/openhab/dsl/things/builder.rb', line 159

def initialize(uid, label = nil, binding: nil, type: nil, bridge: nil, location: nil, config: {}, enabled: nil)
  @channels = []
  uid = uid.to_s
  uid_segments = uid.split(org.openhab.core.common.AbstractUID::SEPARATOR)
  @bridge_uid = nil
  bridge = bridge.uid if bridge.is_a?(org.openhab.core.thing.Bridge) || bridge.is_a?(BridgeBuilder)
  bridge = bridge&.to_s
  bridge_segments = bridge&.split(org.openhab.core.common.AbstractUID::SEPARATOR) || []
  type = type&.to_s

  # infer missing components
  type ||= uid_segments[0] if uid_segments.length == 2
  type ||= uid_segments[1] if uid_segments.length > 2
  binding ||= uid_segments[0] if uid_segments.length > 2
  binding ||= bridge_segments[0] if bridge_segments && bridge_segments.length > 2

  if bridge
    bridge_segments.unshift(binding) if bridge_segments.length < 3
    @bridge_uid = org.openhab.core.thing.ThingUID.new(*bridge_segments)
  end

  thinguid = if uid_segments.length > 2
               [binding, type, uid_segments.last].compact
             else
               [binding, type, @bridge_uid&.id, uid_segments.last].compact
             end

  @uid = org.openhab.core.thing.ThingUID.new(*thinguid)
  @thing_type_uid = org.openhab.core.thing.ThingTypeUID.new(*@uid.all_segments[0..1])
  @label = label
  @location = location
  @location = location.label if location.is_a?(Item)
  @config = config.transform_keys(&:to_s)
  @enabled = enabled
end

Instance Attribute Details

#bridge_uid ⇒ Core::Things::ThingUID? (readonly)

The bridge of this thing

Returns:



105
106
107
 
# File 'lib/openhab/dsl/things/builder.rb', line 105

def bridge_uid
  @bridge_uid
end

#channels ⇒ Array<ChannelBuilder> (readonly)

Explicitly configured channels on this thing

Returns:



114
115
116
 
# File 'lib/openhab/dsl/things/builder.rb', line 114

def channels
  @channels
end

#config ⇒ Hash? (readonly)

The config for this thing

Returns:

  • (Hash, nil) 


108
109
110
 
# File 'lib/openhab/dsl/things/builder.rb', line 108

def config
  @config
end

#enabled ⇒ true, ... (readonly)

If the thing should be enabled after it is created

Returns:

  • (true, false, nil) 


111
112
113
 
# File 'lib/openhab/dsl/things/builder.rb', line 111

def enabled
  @enabled
end

#label ⇒ String?

The label for this thing

Returns:

  • (String, nil) 


93
94
95
 
# File 'lib/openhab/dsl/things/builder.rb', line 93

def label
  @label
end

#location ⇒ String?

The location for this thing

Returns:

  • (String, nil) 


96
97
98
 
# File 'lib/openhab/dsl/things/builder.rb', line 96

def location
  @location
end

#thing_type_uid ⇒ ThingTypeUID (readonly)

The type of this thing

Returns:

  • (ThingTypeUID) 


102
103
104
 
# File 'lib/openhab/dsl/things/builder.rb', line 102

def thing_type_uid
  @thing_type_uid
end

#uid ⇒ Core::Things::ThingUID (readonly)

The id for this thing

Returns:



99
100
101
 
# File 'lib/openhab/dsl/things/builder.rb', line 99

def uid
  @uid
end

Instance Method Details

#channel(*args, **kwargs, &block) ⇒ Core::Things::Channel

Add an explicitly configured channel to this item

Returns:

See Also:



198
199
200
201
202
 
# File 'lib/openhab/dsl/things/builder.rb', line 198

def channel(*args, **kwargs, &block)
  channel = ChannelBuilder.new(*args, thing: self, **kwargs)
  channel.instance_eval(&block) if block
  channel.build.tap { |c| @channels << c }
end