openHAB

Class: OpenHAB::DSL::Items::GroupItemBuilder

Inherits:
ItemBuilder
  • Object
show all
Includes:
Builder
Defined in:
lib/openhab/dsl/items/builder.rb

Overview

Allows customizing a group. You can also call any method from Builder, and those items will automatically be a member of this group.

Constant Summary

Constants included from OpenHAB::DSL

VERSION

Instance Attribute Summary collapse

Attributes inherited from ItemBuilder

#autoupdate, #channels, #command_options, #dimension, #format, #groups, #icon, #label, #metadata, #name, #range, #read_only, #state, #state_options, #step, #tags, #type

Instance Method Summary collapse

Methods included from Builder

#call_item, #color_item, #contact_item, #date_time_item, #dimmer_item, #group_item, #image_item, #location_item, #number_item, #player_item, #rollershutter_item, #string_item, #switch_item

Methods included from OpenHAB::DSL

after, between, config_description, debounce_for, ensure_states, ensure_states!, holiday_file, holiday_file!, items, only_every, persistence, persistence!, profile, provider, provider!, rule, rule!, rules, scene, scene!, script, script!, shared_cache, sitemaps, store_states, things, throttle_for, timers, transform, unit, unit!

Methods included from Rules::Terse

#changed, #channel, #channel_linked, #channel_unlinked, #cron, #every, #item_added, #item_removed, #item_updated, #on_start, #received_command, #thing_added, #thing_removed, #thing_updated, #updated

Methods included from Core::ScriptHandling

script_loaded, script_unloaded

Methods included from Core::Actions

notify

Methods included from Core::EntityLookup

#items, #method_missing, #things

Methods inherited from ItemBuilder

#alexa, #channel, #expire, #ga, #group, #homekit, #inspect, #tag, #to_s

Constructor Details

#initialize(*args, type: nil, function: nil, thing: nil, **kwargs) ⇒ GroupItemBuilder

Returns a new instance of GroupItemBuilder.

Parameters:

Raises:

  • (ArgumentError) 


732
733
734
735
736
737
738
739
 
# File 'lib/openhab/dsl/items/builder.rb', line 732

def initialize(*args, type: nil, function: nil, thing: nil, **kwargs)
  raise ArgumentError, "invalid function #{function}" if function && !function.match?(FUNCTION_REGEX)

  super(type, *args, **kwargs)
  @function = function
  @members = []
  @thing = thing
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class OpenHAB::DSL

Instance Attribute Details

#function ⇒ String?

The combiner function for this group

Returns:

  • (String, nil) 


713
714
715
 
# File 'lib/openhab/dsl/items/builder.rb', line 713

def function
  @function
end

#label_base ⇒ String?

A prefix to be added to the label of any member items

Returns:

  • (String, nil) 


722
723
724
 
# File 'lib/openhab/dsl/items/builder.rb', line 722

def label_base
  @label_base
end

#members ⇒ Array<ItemBuilder> (readonly)

Members to be created in this group

Returns:



725
726
727
 
# File 'lib/openhab/dsl/items/builder.rb', line 725

def members
  @members
end

#name_base ⇒ String?

A prefix to be added to the name of any member items

Returns:

  • (String, nil) 


719
720
721
 
# File 'lib/openhab/dsl/items/builder.rb', line 719

def name_base
  @name_base
end

#thing ⇒ Core::Things::ThingUID, ...

A thing to be used as the base for the channel of any member items

Returns:



716
717
718
 
# File 'lib/openhab/dsl/items/builder.rb', line 716

def thing
  @thing
end

#unit ⇒ String? (readonly)

Unit (for number items only)

Due to ItemBuilder#format inference, setting the unit is cross-compatible with openHAB 3.4 and 4.0.

Returns:

  • (String, nil) 


694
695
696
 
# File 'lib/openhab/dsl/items/builder.rb', line 694

def unit
  @unit
end