openhab-scripting 4.34.1 → 4.37.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b5fd36cfc11c1123c6dc979a7d7072ee7aff804deded7d4bb72716be4c2e216
-  data.tar.gz: f324548ea1075012f58076195a8c25d8cb6bb4afe62344d9752ba4a2415a4394
+  metadata.gz: 152174c3766a83b620a0ec7df6e692bb914e187c788d9c5eecfcedd42bfd641c
+  data.tar.gz: 44084d3557abd293faf97858470414cf5f3dd65e07faa8f74e8f40e0d6ea8edb
 SHA512:
-  metadata.gz: 49b5fab340c77c046ad534568efb939206ab11824f6f08c56622a691d066fd4ce79c308e153d4b45d408cb901f461f5b97c6b14b00deceaba70efbdb46475e2c
-  data.tar.gz: 70c98aaec888f7c889a3bcac861caf216fee51b71c0f086c624ad4caf51f497f6db56c4b218e808524fa3b903d2c149a4c580a862878158fd988d12eb2ce8659
+  metadata.gz: 617deb9b4f75a92a407cf8db6ff695f409ac5f006690751c10100919d414851dc83758ec0560badf3d40097cc896d86de132a215d22a3f505b8e97bff26a8ad2
+  data.tar.gz: 5a2c037047ce9db79d57a153e5df94c631144d511ac716b1862a8a6c4fc567d01c6efa15d93583f2bc80a792c47c85e30dda65ec481a1f14f6a588765638d56f

data/lib/openhab/dsl/dsl.rb

@@ -1,5 +1,9 @@
 # frozen_string_literal: true
 
+require_relative 'imports'
+
+OpenHAB::DSL.import_presets
+
 require 'openhab/log/logger'
 
 # the order of these is important

data/lib/openhab/dsl/imports.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module OpenHAB
+  module DSL
+    include OpenHAB::Log
+    #
+    # Import required java classes
+    #
+    def self.import_presets # rubocop:disable Metrics/AbcSize
+      return if Object.const_get(:ZonedDateTime).is_a?(Class)
+
+      # Fix the import problem in OpenHAB 3.2 addon. Not required in 3.3+
+      [java.time.Duration,
+       java.time.ZonedDateTime,
+       java.time.ZoneId,
+       java.time.temporal.ChronoUnit].each do |klass|
+        Object.const_set(klass.java_class.simple_name.to_sym, klass)
+      end
+    end
+  end
+end

data/lib/openhab/dsl/items/persistence.rb

@@ -76,19 +76,15 @@ module OpenHAB
         private
 
         #
-        # Convert timestamp to ZonedDateTime if it's a TemporalAmount
+        # Convert timestamp to ZonedDateTime with duration negated to indicate a time in the past
         #
-        # @param [Object] timestamp to convert
+        # @param [Object] timestamp timestamp to convert
         #
         # @return [ZonedDateTime]
         #
         def to_zdt(timestamp)
-          if timestamp.is_a? Java::JavaTimeTemporal::TemporalAmount
-            logger.trace("Converting #{timestamp} (#{timestamp.class}) to ZonedDateTime")
-            Java::JavaTime::ZonedDateTime.now.minus(timestamp)
-          else
-            timestamp
-          end
+          timestamp = timestamp.negated if timestamp.is_a? Java::JavaTime::Duration
+          OpenHAB::DSL.to_zdt(timestamp)
         end
 
         #

data/lib/openhab/dsl/items/timed_command.rb

@@ -171,6 +171,7 @@ module OpenHAB
             # rubocop: disable Metrics/AbcSize
             # There is no feasible way to break this method into smaller components
             def execute(_mod = nil, inputs = nil)
+              OpenHAB::DSL.import_presets
               @semaphore.synchronize do
                 thread_local(@thread_locals) do
                   logger.trace "Canceling implicit timer #{@timed_command_details.timer} for "\

data/lib/openhab/dsl/openhab.rb

@@ -3,6 +3,15 @@
 require 'pathname'
 
 module OpenHAB
+  #
+  # Return the OpenHAB conf directory as a ruby pathname
+  #
+  # @return [Pathname] OpenHAB conf path
+  #
+  def self.conf_root
+    Pathname.new(ENV['OPENHAB_CONF'])
+  end
+
   module DSL
     #
     # Provides access to OpenHAB attributes
@@ -12,13 +21,9 @@ module OpenHAB
 
       module_function
 
-      #
-      # Return the OpenHAB conf directory as a ruby pathname
-      #
-      # @return [Pathname] OpenHAB conf path
-      #
+      # @deprecated Please use {OpenHAB.conf_root} instead
       def __conf__
-        Pathname.new(ENV['OPENHAB_CONF'])
+        OpenHAB.conf_root
       end
     end
   end

data/lib/openhab/dsl/rules/automation_rule.rb

@@ -23,7 +23,6 @@ module OpenHAB
         include OpenHAB::Log
         include OpenHAB::Core::ThreadLocal
         include OpenHAB::DSL::Between
-        java_import java.time.ZonedDateTime
 
         #
         # Create a new Rule
@@ -55,6 +54,7 @@ module OpenHAB
         #
         #
         def execute(mod = nil, inputs = nil)
+          OpenHAB::DSL.import_presets
           thread_local(RULE_NAME: name) do
             logger.trace { "Execute called with mod (#{mod&.to_string}) and inputs (#{inputs.inspect})" }
             logger.trace { "Event details #{inputs['event'].inspect}" } if inputs&.key?('event')

data/lib/openhab/dsl/states.rb

@@ -28,6 +28,18 @@ module OpenHAB
         end
         states
       end
+
+      #
+      # Check if all the given items have a state (not UNDEF or NULL)
+      #
+      # @param [Array] items whose state must be non-nil
+      # @param [<Type>] check_things when true, also ensures that all linked things are online
+      #
+      # @return [Boolean] true if all the items have a state, false otherwise
+      #
+      def state?(*items, things: false)
+        items.flatten.all? { |item| (!things || item.things.all?(&:online?)) && item.state? }
+      end
     end
 
     module Support

data/lib/openhab/dsl/timers/manager.rb

@@ -95,11 +95,24 @@ module OpenHAB
       class TimerSet < Set
         #
         # A shorthand to cancel all the timer objects held within the set
-        # so that timers[timer_id].cancel_all is equivalent to timers[timer_id].each(&:cancel)
+        # so that timers[timer_id].cancel is equivalent to timers[timer_id].each(&:cancel)
         #
-        def cancel_all
+        def cancel
           each(&:cancel)
         end
+        # @deprecated Please use {cancel} instead
+        alias cancel_all cancel
+
+        #
+        # A shorthand to reschedule all the timer objects held within the set
+        #
+        # @param [Duration] duration An optional duration to reschedule
+        #
+        # @return [TimerSet] Set of timers
+        #
+        def reschedule(duration = nil)
+          each { |timer| timer.reschedule duration }
+        end
       end
     end
   end

data/lib/openhab/dsl/timers/timer.rb

@@ -9,7 +9,6 @@ require 'openhab/core/thread_local'
 module OpenHAB
   module DSL
     java_import org.openhab.core.model.script.actions.ScriptExecution
-    java_import java.time.ZonedDateTime
 
     # Ruby wrapper for OpenHAB Timer
     # This class implements delegator to delegate methods to the OpenHAB timer
@@ -29,7 +28,6 @@ module OpenHAB
       # @param [Duration] duration Duration until timer should fire
       # @param [Block] block Block to execute when timer fires
       #
-      # rubocop: disable Metrics/MethodLength
       def initialize(duration:, thread_locals: {}, &block)
         @duration = duration
         @thread_locals = thread_locals
@@ -39,15 +37,12 @@ module OpenHAB
         semaphore = Mutex.new
 
         semaphore.synchronize do
-          @timer = ScriptExecution.createTimer(
-            ZonedDateTime.now.plus(to_duration(@duration)), timer_block(semaphore, &block)
-          )
+          @timer = ScriptExecution.createTimer(OpenHAB::DSL.to_zdt(@duration), timer_block(semaphore, &block))
           @rule_timers = Thread.current[:rule_timers]
           super(@timer)
           Timers.timer_manager.add(self)
         end
       end
-      # rubocop: enable Metrics/MethodLength
 
       #
       # Reschedule timer
@@ -60,7 +55,7 @@ module OpenHAB
         duration ||= @duration
 
         Timers.timer_manager.add(self)
-        @timer.reschedule(ZonedDateTime.now.plus(to_duration(duration)))
+        @timer.reschedule(OpenHAB::DSL.to_zdt(duration))
       end
 
       #
@@ -84,6 +79,7 @@ module OpenHAB
       #
       def timer_block(semaphore)
         proc {
+          OpenHAB::DSL.import_presets
           semaphore.synchronize do
             Timers.timer_manager.delete(self)
             thread_local(@thread_locals) do
@@ -92,26 +88,44 @@ module OpenHAB
           end
         }
       end
+    end
 
-      #
-      # Convert argument to a duration
-      #
-      # @param [Java::JavaTimeTemporal::TemporalAmount, #to_f, #to_i, nil] duration Duration
-      #
-      # @raise if duration cannot be used for a timer
-      #
-      # @return Argument converted to seconds if it responds to #to_f or #to_i, otherwise duration unchanged
-      #
-      def to_duration(duration)
-        if duration.nil? || duration.is_a?(Java::JavaTimeTemporal::TemporalAmount)
-          duration
-        elsif duration.respond_to?(:to_f)
-          duration.to_f.seconds
-        elsif duration.respond_to?(:to_i)
-          duration.to_i.seconds
-        else
-          raise ArgumentError, "Supplied argument '#{duration}' cannot be converted to a duration"
-        end
+    #
+    # Convert TemporalAmount (Duration), seconds (float, integer), and Ruby Time to ZonedDateTime
+    # Note: TemporalAmount is added to now
+    #
+    # @param [Object] timestamp to convert
+    #
+    # @return [ZonedDateTime]
+    #
+    def self.to_zdt(timestamp)
+      logger.trace("Converting #{timestamp} (#{timestamp.class}) to ZonedDateTime")
+      return unless timestamp
+
+      case timestamp
+      when Java::JavaTimeTemporal::TemporalAmount then ZonedDateTime.now.plus(timestamp)
+      when ZonedDateTime then timestamp
+      when Time then timestamp.to_java(ZonedDateTime)
+      else
+        to_zdt(seconds_to_duration(timestamp)) ||
+          raise(ArgumentError, 'Timestamp must be a ZonedDateTime, a Duration, a Numeric, or a Time object')
+      end
+    end
+
+    #
+    # Convert numeric seconds to a Duration object
+    #
+    # @param [Float, Integer] secs The number of seconds in integer or float
+    #
+    # @return [Duration]
+    #
+    def self.seconds_to_duration(secs)
+      return unless secs
+
+      if secs.respond_to?(:to_f)
+        secs.to_f.seconds
+      elsif secs.respond_to?(:to_i)
+        secs.to_i.seconds
       end
     end
   end

data/lib/openhab/dsl/types/date_time_type.rb

@@ -8,7 +8,6 @@ module OpenHAB
   module DSL
     module Types
       DateTimeType = org.openhab.core.library.types.DateTimeType
-      java_import java.time.ZonedDateTime # This is needed for the addon prior to ruby_class fix (OH 3.2.0)
 
       # global alias - required for jrubyscripting addon <= OH3.2.0
       ::DateTimeType = DateTimeType if ::DateTimeType.is_a?(Java::JavaLang::Class)

data/lib/openhab/version.rb

@@ -5,5 +5,5 @@
 #
 module OpenHAB
   # @return [String] Version of OpenHAB helper libraries
-  VERSION = '4.34.1'
+  VERSION = '4.37.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: openhab-scripting
 version: !ruby/object:Gem::Version
-  version: 4.34.1
+  version: 4.37.0
 platform: ruby
 authors:
 - Brian O'Connell
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-03-16 00:00:00.000000000 Z
+date: 2022-04-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -60,6 +60,7 @@ files:
 - lib/openhab/dsl/dsl.rb
 - lib/openhab/dsl/gems.rb
 - lib/openhab/dsl/group.rb
+- lib/openhab/dsl/imports.rb
 - lib/openhab/dsl/items/color_item.rb
 - lib/openhab/dsl/items/comparable_item.rb
 - lib/openhab/dsl/items/contact_item.rb