openhab-scripting 5.2.0 → 5.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3d56223cd6766da527070ec31571d7a22cffa7d69ec754a1a1dbeb06c9354d56
-  data.tar.gz: c635cf86c119c54c4b665f28cd91b0804a58c868d23f7a99420d4183f60bf195
+  metadata.gz: a914cbf39d73f385d8f250fb88a72737cabec9106871009f0b4679176251680a
+  data.tar.gz: 402616a86763701e48146d24581c340287c060bb8e86fb28e9c2e1947e19b129
 SHA512:
-  metadata.gz: 79e7ac98695e1fb75a6bf100226a555d2d1d8f7a96efa0779b42439e262bfb63777ee99545782885f509c08f21dc77b2b504fd13078a5e5bc1d82ce456e3cca9
-  data.tar.gz: d735f987f2540cba7b358a4f0550ed723ef807b0a4c5e12ab21177cc844f65a2eec1080778b996e702cd72a5d744b1a7c97fe52ba5679a17a13b4988ccd2bf76
+  metadata.gz: a860c8a2969e3a10b513650f265a3291f1cc5b91fa0b9d1775f40e254904175fe6e077881cb24ebef13677085705c3ae2248420064154da61a7ced4af4a91c67
+  data.tar.gz: 13e3da787706aee119334f4e768a9af3d2eaefc38afb8b2e6618e74e6591bc8cfcfa7ff137fa514d2bed2831e416f6112d8a27b7a6a8a205fdf8eefdbaafff31

data/lib/openhab/core_ext/ruby/object.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module OpenHAB
+  module CoreExt
+    module Ruby
+      # @!visibility private
+      module Object
+        class << self
+          attr_reader :top_self
+        end
+
+        # @!visibility private
+        module ClassMethods
+          # capture methods defined at top level (which get added to Object)
+          def method_added(method)
+            return super unless equal?(::Object)
+
+            if DSL.private_instance_methods.include?(method)
+              # Duplicate methods that conflict with DSL onto `main`'s singleton class,
+              # so that they'll take precedence over DSL's method.
+              Object.top_self.singleton_class.define_method(method, instance_method(method))
+            end
+
+            super
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -22,6 +22,12 @@ module OpenHAB
       #     group_item Equipment, tags: Semantics::HVAC, thing: "binding:thing"
       #       string_item Mode, tags: Semantics::Control, channel: "mode"
       #     end
+      #
+      #     # dimension Temperature inferred
+      #     number_item OutdoorTemp, format: "%.1f %unit%", unit: "°F"
+      #
+      #     # unit lx, dimension Illuminance, format "%s %unit%" inferred
+      #     number_item OutdoorBrightness, state: 10_000 | "lx"
       #   end
       #
       module Builder
@@ -156,9 +162,22 @@ module OpenHAB
         # @return [String, nil]
         attr_accessor :label
         # Unit dimension (for number items only)
+        #
+        # If {unit} is provided, and {dimension} is not, it will be inferred.
+        #
         # @return [String, nil]
         attr_accessor :dimension
+        # Unit (for number items only)
+        #
+        # Due to {format} inference, setting the unit is cross-compatible with
+        # openHAB 3.4 and 4.0.
+        #
+        # @return [String, nil]
+        attr_reader :unit
         # The formatting pattern for the item's state
+        #
+        # If {unit} is provided, and {format} is not, it will be inferred.
+        #
         # @return [String, nil]
         attr_accessor :format
         # The icon to be associated with the item
@@ -179,13 +198,16 @@ module OpenHAB
         # @return [Core::Items::Metadata::NamespaceHash]
         attr_reader :metadata
         # Initial state
+        #
+        # If {state} is set to a {QuantityType}, and {unit} is not set, it will be inferred.
+        #
         # @return [Core::Types::State]
-        attr_accessor :state
+        attr_reader :state
 
         class << self
           # @!visibility private
           def item_factory
-            @item_factory ||= org.openhab.core.library.CoreItemFactory.new
+            @item_factory ||= OpenHAB::OSGi.service("org.openhab.core.items.ItemFactory")
           end
 
           #
@@ -214,6 +236,7 @@ module OpenHAB
         end
 
         # @param dimension [Symbol, nil] The unit dimension for a {NumberItem} (see {ItemBuilder#dimension})
+        # @param unit [Symbol, String, nil] The unit for a {NumberItem} (see {ItemBuilder#unit})
         # @param format [String, nil] The formatting pattern for the item's state (see {ItemBuilder#format})
         # @param icon [Symbol, nil] The icon to be associated with the item (see {ItemBuilder#icon})
         # @param group [String,
@@ -246,6 +269,7 @@ module OpenHAB
         def initialize(type, name = nil, label = nil,
                        provider:,
                        dimension: nil,
+                       unit: nil,
                        format: nil,
                        icon: nil,
                        group: nil,
@@ -274,6 +298,7 @@ module OpenHAB
           @label = label
           @dimension = dimension
           @format = format
+          self.unit = unit
           @icon = icon
           @groups = []
           @tags = []
@@ -291,7 +316,7 @@ module OpenHAB
           self.alexa(alexa) if alexa
           self.ga(ga) if ga
           self.homekit(homekit) if homekit
-          @state = state
+          self.state = state
 
           self.group(*group)
           self.group(*groups)
@@ -434,6 +459,39 @@ module OpenHAB
           @expire += ",command=#{command}" if command
         end
 
+        # @!attribute [w] unit
+        #
+        # Unit (for number items only).
+        #
+        # If dimension or format are not yet set, they will be inferred.
+        #
+        # @return [String, nil]
+        def unit=(unit)
+          @unit = unit
+
+          self.dimension ||= unit && org.openhab.core.types.util.UnitUtils.parse_unit(unit)&.then do |u|
+            org.openhab.core.types.util.UnitUtils.get_dimension_name(u)
+          end
+          self.format ||= unit && (if Gem::Version.new(Core::VERSION) >= Gem::Version.new("4.0.0.M3")
+                                     "%s %unit%"
+                                   else
+                                     "%s #{unit.gsub("%", "%%")}"
+                                   end)
+        end
+
+        # @!attribute [w] state
+        #
+        # Initial state
+        #
+        # If {state} is set to a {QuantityType}, and {unit} is not set, it will be inferred.
+        #
+        # @return [Core::Types::State]
+        def state=(state)
+          @state = state
+
+          self.unit ||= state.unit.to_s if state.is_a?(QuantityType)
+        end
+
         # @!visibility private
         def build
           item = create_item
@@ -450,6 +508,7 @@ module OpenHAB
           item.metadata["autoupdate"] = autoupdate.to_s unless autoupdate.nil?
           item.metadata["expire"] = expire if expire
           item.metadata["stateDescription"] = { "pattern" => format } if format
+          item.metadata["unit"] = unit if unit
           item.state = item.format_update(state) unless state.nil?
           item
         end
@@ -488,6 +547,12 @@ module OpenHAB
       class GroupItemBuilder < ItemBuilder
         include Builder
 
+        # This has to be duplicated here, since {Builder} includes DSL, so DSL#unit
+        # will be seen first, but we really want ItemBuilder#unit
+
+        # (see ItemBuilder#unit)
+        attr_reader :unit
+
         Builder.public_instance_methods.each do |m|
           next unless Builder.instance_method(m).owner == Builder
 

data/lib/openhab/dsl/version.rb

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

data/lib/openhab/dsl.rb

@@ -975,5 +975,8 @@ OpenHAB::Core::Items.import_into_global_namespace
 
 # Extend `main` with DSL methods
 singleton_class.include(OpenHAB::DSL)
+# Patch Object to work around https://github.com/openhab/openhab-jruby/issues/4
+Object.extend(OpenHAB::CoreExt::Ruby::Object::ClassMethods)
+OpenHAB::CoreExt::Ruby::Object.instance_variable_set(:@top_self, self)
 
 logger.debug "openHAB JRuby Scripting Library Version #{OpenHAB::DSL::VERSION} Loaded"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: openhab-scripting
 version: !ruby/object:Gem::Version
-  version: 5.2.0
+  version: 5.3.0
 platform: ruby
 authors:
 - Brian O'Connell
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-05-02 00:00:00.000000000 Z
+date: 2023-05-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -504,6 +504,7 @@ files:
 - lib/openhab/core_ext/ruby/date_time.rb
 - lib/openhab/core_ext/ruby/module.rb
 - lib/openhab/core_ext/ruby/numeric.rb
+- lib/openhab/core_ext/ruby/object.rb
 - lib/openhab/core_ext/ruby/range.rb
 - lib/openhab/core_ext/ruby/symbol.rb
 - lib/openhab/core_ext/ruby/time.rb