openhab-scripting 5.5.0 → 5.6.1

data/lib/openhab/dsl/rules/triggers/cron/cron_handler.rb

@@ -1,115 +1,120 @@
 # frozen_string_literal: true
 
-require "singleton"
-
-require_relative "cron"
-
-module OpenHAB
-  module DSL
-    module Rules
-      module Triggers
-        # @!visibility private
-        #
-        # Cron trigger handler that provides trigger ID
-        #
-        module CronHandler
-          # Cron Trigger Handler that provides trigger IDs
-          # Unfortunatly because the CronTriggerHandler in openHAB core is marked internal
-          # the entire thing must be recreated here
-          class CronTriggerHandler < org.openhab.core.automation.handler.BaseTriggerModuleHandler
-            include org.openhab.core.scheduler.SchedulerRunnable
-            include org.openhab.core.automation.handler.TimeBasedTriggerHandler
-
-            # Provides access to protected fields
-            field_accessor :callback
-
-            # Creates a new CronTriggerHandler
-            # @param [org.openhab.core.automation.Trigger] trigger openHAB trigger associated with handler
-            #
-            def initialize(trigger)
-              @trigger = trigger
-              @scheduler = OSGi.service("org.openhab.core.scheduler.CronScheduler")
-              @schedule = nil
-              @expression = trigger.configuration.get("cronExpression")
-              super(trigger)
-            end
+# @deprecated OH3.4 this module is not needed in OH4+
+if Gem::Version.new(OpenHAB::Core::VERSION) < Gem::Version.new("4.0.0")
 
-            #
-            # Set the callback to execute when cron trigger fires
-            # @param [Object] callback to run
-            #
-            def setCallback(callback) # rubocop:disable Naming/MethodName
-              synchronized do
-                super(callback)
-                @schedule = @scheduler.schedule(self, @expression)
-                logger.trace("Scheduled cron job '#{@expression}' for trigger '#{@trigger.id}'.")
-              end
-            end
+  require "singleton"
 
-            #
-            # Get the temporal adjuster
-            # @return [CronAdjuster]
-            #
-            def getTemporalAdjuster # rubocop:disable Naming/MethodName
-              org.openhab.core.scheduler.CronAdjuster.new(@expression)
-            end
+  require_relative "cron"
 
-            #
-            # Execute the callback
-            #
-            def run
-              callback&.triggered(@trigger, { "module" => @trigger.id })
-            end
+  module OpenHAB
+    module DSL
+      module Rules
+        module Triggers
+          # @!visibility private
+          #
+          # Cron trigger handler that provides trigger ID
+          #
+          module CronHandler
+            # Cron Trigger Handler that provides trigger IDs
+            # Unfortunatly because the CronTriggerHandler in openHAB core is marked internal
+            # the entire thing must be recreated here
+            class CronTriggerHandler < org.openhab.core.automation.handler.BaseTriggerModuleHandler
+              include org.openhab.core.scheduler.SchedulerRunnable
+              include org.openhab.core.automation.handler.TimeBasedTriggerHandler
 
-            #
-            # Displose of the handler
-            # cancel the cron scheduled task
-            #
-            def dispose
-              synchronized do
-                super
-                return unless @schedule
+              # Provides access to protected fields
+              field_accessor :callback
 
-                @schedule.cancel(true)
+              # Creates a new CronTriggerHandler
+              # @param [org.openhab.core.automation.Trigger] trigger openHAB trigger associated with handler
+              #
+              def initialize(trigger)
+                @trigger = trigger
+                @scheduler = OSGi.service("org.openhab.core.scheduler.CronScheduler")
                 @schedule = nil
+                @expression = trigger.configuration.get("cronExpression")
+                super(trigger)
+              end
+
+              #
+              # Set the callback to execute when cron trigger fires
+              # @param [Object] callback to run
+              #
+              def setCallback(callback) # rubocop:disable Naming/MethodName
+                synchronized do
+                  super(callback)
+                  @schedule = @scheduler.schedule(self, @expression)
+                  logger.trace("Scheduled cron job '#{@expression}' for trigger '#{@trigger.id}'.")
+                end
+              end
+
+              #
+              # Get the temporal adjuster
+              # @return [CronAdjuster]
+              #
+              def getTemporalAdjuster # rubocop:disable Naming/MethodName
+                org.openhab.core.scheduler.CronAdjuster.new(@expression)
               end
-              logger.trace("cancelled job for trigger '#{@trigger.id}'.")
-            end
-          end
 
-          # Implements the ScriptedTriggerHandlerFactory interface to create a new Cron Trigger Handler
-          class CronTriggerHandlerFactory
-            include Singleton
-            include org.openhab.core.automation.module.script.rulesupport.shared.factories.ScriptedTriggerHandlerFactory
-
-            def initialize
-              Core.automation_manager.add_trigger_handler(
-                Cron::CRON_TRIGGER_MODULE_ID,
-                self
-              )
-
-              Core.automation_manager.add_trigger_type(org.openhab.core.automation.type.TriggerType.new(
-                                                         Cron::CRON_TRIGGER_MODULE_ID,
-                                                         nil,
-                                                         "A specific instant occurs",
-                                                         "Triggers when the specified instant occurs",
-                                                         nil,
-                                                         org.openhab.core.automation.Visibility::VISIBLE,
-                                                         nil
-                                                       ))
-              logger.trace("Added script cron trigger handler")
+              #
+              # Execute the callback
+              #
+              def run
+                callback&.triggered(@trigger, { "module" => @trigger.id })
+              end
+
+              #
+              # Dispose of the handler
+              # cancel the cron scheduled task
+              #
+              def dispose
+                synchronized do
+                  super
+                  return unless @schedule
+
+                  @schedule.cancel(true)
+                  @schedule = nil
+                end
+                logger.trace("cancelled job for trigger '#{@trigger.id}'.")
+              end
             end
 
-            # Invoked by openHAB core to get a trigger handler for the supplied trigger
-            # @param [org.openhab.core.automation.Trigger] trigger
-            #
-            # @return [WatchTriggerHandler] trigger handler for supplied trigger
-            def get(trigger)
-              CronTriggerHandler.new(trigger)
+            # Implements the ScriptedTriggerHandlerFactory interface to create a new Cron Trigger Handler
+            class CronTriggerHandlerFactory
+              include Singleton
+              include org.openhab.core.automation.module.script.rulesupport.shared.factories.ScriptedTriggerHandlerFactory # rubocop:disable Layout/LineLength
+
+              def initialize
+                Core.automation_manager.add_trigger_handler(
+                  Cron::CRON_TRIGGER_MODULE_ID,
+                  self
+                )
+
+                Core.automation_manager.add_trigger_type(org.openhab.core.automation.type.TriggerType.new(
+                                                           Cron::CRON_TRIGGER_MODULE_ID,
+                                                           nil,
+                                                           "A specific instant occurs",
+                                                           "Triggers when the specified instant occurs",
+                                                           nil,
+                                                           org.openhab.core.automation.Visibility::VISIBLE,
+                                                           nil
+                                                         ))
+                logger.trace("Added script cron trigger handler")
+              end
+
+              # Invoked by openHAB core to get a trigger handler for the supplied trigger
+              # @param [org.openhab.core.automation.Trigger] trigger
+              #
+              # @return [WatchTriggerHandler] trigger handler for supplied trigger
+              def get(trigger)
+                CronTriggerHandler.new(trigger)
+              end
             end
           end
         end
       end
     end
   end
+
 end

data/lib/openhab/dsl/things/builder.rb

@@ -24,10 +24,10 @@ module OpenHAB
       #   things.build do
       #     thing("mqtt:topic:my-switch", "My Switch", bridge: "mqtt:bridge:mosquitto", config: thing_config) do
       #       channel("switch1", "switch", config: {
-      #         stateTopic: "stat/my-switch/switch1/state", commandTopic="cmnd/my-switch/switch1/command"
+      #         stateTopic: "stat/my-switch/switch1/state", commandTopic: "cmnd/my-switch/switch1/command"
       #       })
       #       channel("button1", "string", config: {
-      #         stateTopic: "stat/my-switch/button1/state", commandTopic="cmnd/my-switch/button1/command"
+      #         stateTopic: "stat/my-switch/button1/state", commandTopic: "cmnd/my-switch/button1/command"
       #       })
       #     end
       #   end
@@ -184,10 +184,11 @@ module OpenHAB
 
         # @!visibility private
         def build
-          configuration = org.openhab.core.config.core.Configuration.new(config)
+          configuration = Core::Configuration.new(config)
           if thing_type
             self.class.thing_factory_helper.apply_default_configuration(
-              configuration, thing_type,
+              configuration,
+              thing_type,
               self.class.config_description_registry
             )
           end
@@ -200,7 +201,8 @@ module OpenHAB
 
           if thing_type
             # can't use with_channels, or it will wipe out custom channels from above
-            self.class.thing_factory_helper.create_channels(thing_type, uid,
+            self.class.thing_factory_helper.create_channels(thing_type,
+                                                            uid,
                                                             self.class.config_description_registry).each do |channel|
               builder.with_channel(channel)
             end
@@ -280,7 +282,7 @@ module OpenHAB
           org.openhab.core.thing.binding.builder.ChannelBuilder.create(uid)
              .with_kind(kind)
              .with_type(type)
-             .with_configuration(org.openhab.core.config.core.Configuration.new(config))
+             .with_configuration(Core::Configuration.new(config))
              .build
         end
 

data/lib/openhab/dsl/thread_local.rb

@@ -11,6 +11,7 @@ module OpenHAB
 
       # Keys to persist
       KNOWN_KEYS = %i[
+        openhab_context
         openhab_ensure_states
         openhab_holiday_file
         openhab_persistence_service

data/lib/openhab/dsl/timer_manager.rb

@@ -89,7 +89,7 @@ module OpenHAB
       # @param [Object] id
       # @param [java.time.temporal.TemporalAmount, #to_zoned_date_time, Proc, nil] duration
       #   When to reschedule the timer for. `nil` to retain its current interval.
-      # @return [Timer, nil] the timer if it was rescheduled, otherwise `nil`
+      # @return [Core::Timer, nil] the timer if it was rescheduled, otherwise `nil`
       #
       def reschedule(id, duration = nil)
         @timers_by_id.compute_if_present(id) do |_key, timer|
@@ -105,10 +105,10 @@ module OpenHAB
       # state. The timer is created in a thread-safe manner.
       #
       # @param [Object] id
-      # @yieldparam [Timer, nil] timer The existing timer with this id, if one exists.
-      # @yieldreturn [Timer, nil] A new timer to associate with this id, the existing
+      # @yieldparam [Core::Timer, nil] timer The existing timer with this id, if one exists.
+      # @yieldreturn [Core::Timer, nil] A new timer to associate with this id, the existing
       #   timer, or nil. If nil, any existing timer will be cancelled.
-      # @return [Timer, nil]
+      # @return [Core::Timer, nil]
       #
       # @example Extend an existing timer, or schedule a new one
       #   # This is technically the same functionality as just calling `after()` with an `id`,

data/lib/openhab/dsl/version.rb

@@ -4,6 +4,6 @@ module OpenHAB
   module DSL
     # Version of openHAB helper libraries
     # @return [String]
-    VERSION = "5.5.0"
+    VERSION = "5.6.1"
   end
 end

data/lib/openhab/dsl.rb

@@ -2,6 +2,7 @@
 
 require "java"
 require "method_source"
+require "ruby2_keywords"
 
 require "bundler/inline"
 
@@ -77,16 +78,16 @@ module OpenHAB
     # Defines a new profile that can be applied to item channel links.
     #
     # @param [String, Symbol] id The id for the profile.
-    # @yield [event, command: nil, state: nil, link:, item:, channel_uid:, configuration:, context:]
+    # @yield [event, command: nil, state: nil, callback:, link:, item:, channel_uid:, configuration:, context:]
     #   All keyword params are optional. Any that aren't defined won't be passed.
-    # @yieldparam [Core::Things::ProfileCallback] callback
-    #   The callback to be used to customize the action taken.
     # @yieldparam [:command_from_item, :state_from_item, :command_from_handler, :state_from_handler] event
     #   The event that needs to be processed.
     # @yieldparam [Command, nil] command
     #   The command being sent for `:command_from_item` and `:command_from_handler` events.
     # @yieldparam [State, nil] state
     #   The state being sent for `:state_from_item` and `:state_from_handler` events.
+    # @yieldparam [Core::Things::ProfileCallback] callback
+    #   The callback to be used to customize the action taken.
     # @yieldparam [Core::Things::ItemChannelLink] link
     #   The link between the item and the channel, including its configuration.
     # @yieldparam [Item] item The linked item.
@@ -115,7 +116,7 @@ module OpenHAB
     #   # Rollershutter MyShade { channel="thing:rollershutter"[profile="ruby:veto_closing_shades"] }
     #
     # @example Overriding units from a binding
-    #   profile(:set_uom) do |event, configuration:, state:, command:|
+    #   profile(:set_uom) do |event, callback:, configuration:, state:, command:|
     #     unless configuration["unit"]
     #       logger.warn("Unit configuration not provided for set_uom profile")
     #        next true
@@ -970,6 +971,24 @@ module OpenHAB
 
       raise exception
     end
+
+    #
+    # Provide access to the script context / variables
+    # see OpenHAB::DSL::Rules::AutomationRule#execute!
+    #
+    # @!visibility private
+    ruby2_keywords def method_missing(method, *args)
+      return super unless args.empty? && !block_given?
+      return super unless (context = Thread.current[:openhab_context]) && context.key?(method)
+
+      logger.trace("DSL#method_missing found context variable: '#{method}'")
+      context[method]
+    end
+
+    # @!visibility private
+    def respond_to_missing?(method, include_private = false)
+      Thread.current[:openhab_context]&.key?(method) || super
+    end
   end
 end
 

data/lib/openhab/osgi.rb

@@ -46,7 +46,7 @@ module OpenHAB
 
         bundle = org.osgi.framework.FrameworkUtil.get_bundle(interfaces.first.java_class)
         bundle.bundle_context.register_service(
-          interfaces.map(&:java_class).map(&:name).to_java(java.lang.String),
+          interfaces.map { |i| i.java_class.name }.to_java(java.lang.String),
           instance,
           java.util.Hashtable.new(properties)
         )

data/lib/openhab/rspec/karaf.rb

@@ -154,7 +154,9 @@ module OpenHAB
         klass.field_accessor :classLoader, :activatorManager
         klass.field_writer :framework
         klass.field_reader :LOG
-        org.apache.karaf.main.ConfigProperties.field_reader :props, :defaultBundleStartlevel, :karafEtc,
+        org.apache.karaf.main.ConfigProperties.field_reader :props,
+                                                            :defaultBundleStartlevel,
+                                                            :karafEtc,
                                                             :defaultStartLevel
         klass.class_eval do
           def send_private(method_name, *args)
@@ -472,7 +474,8 @@ module OpenHAB
               thf = Mocks::ThingHandlerFactory.instance
               bundle = org.osgi.framework.FrameworkUtil.get_bundle(org.openhab.core.thing.Thing.java_class)
               Mocks::BundleResolver.instance.register_class(thf.class, bundle)
-              bundle.bundle_context.register_service(org.openhab.core.thing.binding.ThingHandlerFactory.java_class, thf,
+              bundle.bundle_context.register_service(org.openhab.core.thing.binding.ThingHandlerFactory.java_class,
+                                                     thf,
                                                      nil)
             end
           end
@@ -574,7 +577,7 @@ module OpenHAB
           bundle.fragment?
       end
 
-      def wait
+      def wait(timeout: 30)
         mutex = Mutex.new
         cond = ConditionVariable.new
         skip_wait = false
@@ -587,7 +590,7 @@ module OpenHAB
         end
         mutex.synchronize do
           yield continue
-          cond.wait(mutex) unless skip_wait
+          cond.wait(mutex, timeout) unless skip_wait
         end
       end
 

data/lib/openhab/rspec/openhab/core/actions.rb

@@ -3,7 +3,6 @@
 module OpenHAB
   module Core
     module Actions
-      # rubocop:disable Lint/UnusedMethodArgument
       # redefine these to do nothing so that rules won't fail
 
       module_function
@@ -31,8 +30,6 @@ module OpenHAB
           end
         end
       end
-
-      # rubocop:enable Lint/UnusedMethodArgument
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: openhab-scripting
 version: !ruby/object:Gem::Version
-  version: 5.5.0
+  version: 5.6.1
 platform: ruby
 authors:
 - Brian O'Connell
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-08-08 00:00:00.000000000 Z
+date: 2023-09-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -214,14 +214,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.13.9
+        version: '1.13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.13.9
+        version: '1.13'
 - !ruby/object:Gem::Dependency
   name: persistent_httparty
   requirement: !ruby/object:Gem::Requirement
@@ -279,33 +279,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '3.11'
 - !ruby/object:Gem::Dependency
-  name: rubocop
+  name: rubocop-inst
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.8'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.8'
-- !ruby/object:Gem::Dependency
-  name: rubocop-performance
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.11'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rubocop-rake
   requirement: !ruby/object:Gem::Requirement
@@ -394,10 +380,12 @@ files:
 - lib/openhab/core/actions/ping.rb
 - lib/openhab/core/actions/transformation.rb
 - lib/openhab/core/actions/voice.rb
+- lib/openhab/core/configuration.rb
 - lib/openhab/core/dependency_tracking.rb
 - lib/openhab/core/dto.rb
 - lib/openhab/core/dto/item_channel_link.rb
 - lib/openhab/core/dto/thing.rb
+- lib/openhab/core/emulate_hash.rb
 - lib/openhab/core/entity_lookup.rb
 - lib/openhab/core/events.rb
 - lib/openhab/core/events/abstract_event.rb
@@ -409,6 +397,7 @@ files:
 - lib/openhab/core/events/item_state_event.rb
 - lib/openhab/core/events/item_state_updated_event.rb
 - lib/openhab/core/events/thing_status_info_event.rb
+- lib/openhab/core/events/timer_event.rb
 - lib/openhab/core/items.rb
 - lib/openhab/core/items/accepted_data_types.rb
 - lib/openhab/core/items/color_item.rb
@@ -416,6 +405,7 @@ files:
 - lib/openhab/core/items/date_time_item.rb
 - lib/openhab/core/items/dimmer_item.rb
 - lib/openhab/core/items/generic_item.rb
+- lib/openhab/core/items/group_function.rb
 - lib/openhab/core/items/group_item.rb
 - lib/openhab/core/items/image_item.rb
 - lib/openhab/core/items/item.rb