oslg 0.2.4 → 0.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06f0805c49f693fad81b68a22ea45477b786e96e0b2894fc32359eb7821eab81
-  data.tar.gz: e07cf0a2d48399d7768e4fa0ba87897950f130a593721e5699f7e704735bc06d
+  metadata.gz: 5d9b0ecd08d5975a017a4133b83cd7deea1a21427d923651ff629347ee4b8e83
+  data.tar.gz: 637c081134c0fc036048c62a17bf7e95087c807c34921bd80ebb3d53f0996346
 SHA512:
-  metadata.gz: f103e01be3e08c21952659297316eaac6faccc8e925805d3f32e3a2f6be4c53d40cf804b6f09c0b6866d8e67756b9f162ca99d398299b00bcd62d2b5a5df5c2b
-  data.tar.gz: 74e202302c1bd8eaf0d2ac78519b3bb189d8b274b9c2cce55fa668ca2f43a40ec3741c08e97a08ad025698bf1a250c3173f238946de75efa6aee8fcb680dcaaa
+  metadata.gz: cf5fddfd6703ac80fdcc94818db3f9c5d58c27a9f7617db8d04b92b78b9e442937551857fa4c7c9a1d470703f89499a484d55f49c1b8e30ebb72cd8266d63676
+  data.tar.gz: 36411cd8958dd7e387e34ecd901c9cc12ff62cf37fb483e3c5d88954732857eaf796609cc358dea417ece8fe06f11f1e5526e2e1760a5444c3ffcdbdcd3d14a2

data/.github/workflows/pull_request.yml

@@ -7,7 +7,7 @@ on:
 
 jobs:
   test_300x:
-    runs-on: ubuntu-18.04
+    runs-on: ubuntu-22.04
     steps:
     - name: Check out repository
       uses: actions/checkout@v2
@@ -23,7 +23,7 @@ jobs:
         docker exec -t test bundle exec rake
         docker kill test
   test_321x:
-    runs-on: ubuntu-18.04
+    runs-on: ubuntu-22.04
     steps:
     - name: Check out repository
       uses: actions/checkout@v2
@@ -39,7 +39,7 @@ jobs:
         docker exec -t test bundle exec rake
         docker kill test
   test_330x:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-22.04
     steps:
     - name: Check out repository
       uses: actions/checkout@v2
@@ -55,7 +55,7 @@ jobs:
         docker exec -t test bundle exec rake
         docker kill test
   test_340x:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-22.04
     steps:
     - name: Check out repository
       uses: actions/checkout@v2
@@ -70,3 +70,19 @@ jobs:
         docker exec -t test bundle update
         docker exec -t test bundle exec rake
         docker kill test
+  test_351x:
+    runs-on: ubuntu-22.04
+    steps:
+    - name: Check out repository
+      uses: actions/checkout@v2
+    - name: Run Tests
+      run: |
+        echo $(pwd)
+        echo $(ls)
+        docker pull nrel/openstudio:3.5.1
+        docker run --name test --rm -d -t -v $(pwd):/work -w /work nrel/openstudio:3.5.1
+        docker exec -t test pwd
+        docker exec -t test ls
+        docker exec -t test bundle update
+        docker exec -t test bundle exec rake
+        docker kill test

data/LICENSE

@@ -1,6 +1,6 @@
 BSD 3-Clause License
 
-Copyright (c) 2022, Denis Bourgeois
+Copyright (c) 2022-2023, Denis Bourgeois
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

data/README.md

@@ -39,7 +39,7 @@ FATAL
 
 DEBUG messages aren't benign at all, but are certainly less informative for the typical Measure user.
 
-Initially, __oslg__ sets 2x internal variable states: `level` (INFO) and `status` (< DEBUG). The variable `level` is a user-set threshold below which less severe logs (e.g. DEBUG) are ignored. For instance, if `level` were _reset_ to DEBUG (e.g. `M.reset(M::DEBUG)`), then all DEBUG messages would also be logged. The variable `status` is reset with each new log entry if the latter's log level is more severe than its predecessor (e.g. `status == M::FATAL` if there is a single log entry registered as FATAL). To check the curent __oslg__ `status` (true or false):  
+Initially, __oslg__ sets 2x internal attributes: `level` (INFO) and `status` (< DEBUG). The `level` attribute is a user-set threshold below which less severe logs (e.g. DEBUG) are ignored. For instance, if `level` were _reset_ to DEBUG (e.g. `M.reset(M::DEBUG)`), then all DEBUG messages would also be logged. The `status` attribute is reset with each new log entry if the latter's log level is more severe than its predecessor (e.g. `status == M::FATAL` if there is a single log entry registered as FATAL). To check the curent __oslg__ `status` (true or false):  
 
 ```
 M.debug?
@@ -48,7 +48,7 @@ M.error?
 M.fatal?
 ```
 
-It's sometimes not a bad idea to rely on a _clean_ slate (e.g. within RSpecs). The following flushes out all previous logs and resets `level` (INFO) and `status` (< DEBUG) - use with caution in production code!
+It's sometimes not a bad idea to rely on a _clean_ slate (e.g. within RSpecs). The following purges all previous logs and resets `level` (INFO) and `status` (< DEBUG) - use with caution in production code!
 
 ```
 M.clean!
@@ -60,7 +60,7 @@ EnergyPlus will run, with e.g. out-of-range material or fluid properties, while
 M.log(M::FATAL, "Missing input JSON file")
 ```
 
-Consider logging non-fatal __ERROR__ messages when encountering invalid OpenStudio file entries, i.e. well-defined, yet invalid vis-à-vis EnergyPlus limitations. The invalid object could be simply ignored, while the measure pursues its (otherwise valid) calculations ... with OpenStudio ultimately launching an EnergyPlus simulation. If a simulation indeed ran (ultimately a go/no-go decision made by the EnergyPlus simulation engine), it would be up to users to decide if simulation results were valid or useful, given the context - maybe based on __oslg__ logged messages. In short, non-fatal ERROR logs should ideally point to bad input users can fix.
+Consider logging non-fatal __ERROR__ messages when encountering invalid OpenStudio file entries, i.e. well-defined, yet invalid vis-à-vis EnergyPlus limitations. The invalid object could be simply ignored, while the measure pursues its (otherwise valid) calculations ... with OpenStudio ultimately launching an EnergyPlus simulation. If a simulation indeed ran (ultimately a go/no-go decision made by the EnergyPlus simulation engine), it would be up to users to decide if simulation results were valid or useful, given the context - maybe based on __oslg__ logged messages. In short, non-fatal ERROR logs should ideally point to bad input (that users can fix).
 
 ```
 M.log(M::ERROR, "Measure won't process MASSLESS materials")
@@ -96,7 +96,7 @@ These logs can be first _mapped_ to other structures (then edited), depending on
 
 ### Preset log templates
 
-Typically, developers would first catch bad input, log an error message and possibly exit by returning a variable (e.g. __false__, __nil__), e.g.:  
+Typically, developers would first catch bad input, log an error message and possibly exit by returning an object (e.g. __false__, __nil__), e.g.:  
 
 ```
 unless var.is_a?(Array)
@@ -105,7 +105,7 @@ unless var.is_a?(Array)
 end
 ```
 
-The following are __oslg__ one-liner methods that _log & return_ in one go. These are for some of the most common checks OpenStudio SDK Ruby developers are likely to need. The methods require _valid_ arguments for __oslg__ to actually log. Although often expecting strings as arguments, the methods will try to convert other types to strings (e.g. classes, numbers, even entire arrays) if possible.
+The following are __oslg__ one-liner methods that _log & return_ in one go. These are for some of the most common checks OpenStudio SDK Ruby developers are likely to need. The methods require _valid_ arguments for __oslg__ to actually log. Although often expecting either strings or integers as arguments, the methods will try to convert other types to strings (e.g. classes, numbers, even entire arrays) or integers if possible.
 
 ---
 
@@ -125,8 +125,8 @@ The 3rd argument (e.g. _0_) is ignored unless `> 0` - a useful option when asser
 
 ```
 def sum(areas, units)
-  return M.invalid("areas", "sum", 1) unless areas
-  return M.invalid("units", "sum", 2) unless units
+  return M.invalid("areas", "sum", 1) unless areas.respond_to?(:to_f)
+  return M.invalid("units", "sum", 2) unless units.respond_to?(:to_s)
   ...
 end
 ```

data/lib/oslg/oslog.rb

@@ -1,6 +1,6 @@
 # BSD 3-Clause License
 #
-# Copyright (c) 2022, Denis Bourgeois
+# Copyright (c) 2022-2023, Denis Bourgeois
 # All rights reserved.
 #
 # Redistribution and use in source and binary forms, with or without
@@ -127,6 +127,7 @@ module OSlg
   # @return [String] "DEBUG", "INFO", "WARN", "ERROR" or "FATAL"
   def tag(level)
     return @@tag[level] if level >= DEBUG && level <= FATAL
+
     ""
   end
 
@@ -138,6 +139,7 @@ module OSlg
   # @return [String] preset OSlg message
   def msg(status)
     return @@msg[status] if status >= DEBUG && status <= FATAL
+
     ""
   end
 
@@ -163,6 +165,7 @@ module OSlg
       @@logs << {level: level, message: message}
       @@status = level if level > @@status
     end
+
     @@status
   end
 
@@ -171,29 +174,34 @@ module OSlg
   #
   # @param id [String] invalid object identifier
   # @param mth [String] calling method identifier
-  # @param ord [String] calling method argument order number of obj (optional)
+  # @param ord [Integer] calling method argument order number of obj (optional)
   # @param lvl [Integer] DEBUG, INFO, WARN, ERROR or FATAL (optional)
   # @param res [Object] what to return (optional)
   #
   # @return [Object] return object if specified by user
-  # @return [Nil] nil if return object missing or invalid
+  # @return [Nil] nil if return object undefined
   def invalid(id = "", mth = "", ord = 0, lvl = DEBUG, res = nil)
-    return nil unless defined?(res)
-    return res unless defined?(id ) && id
-    return res unless defined?(mth) && mth
-    return res unless defined?(ord) && ord
-    return res unless defined?(lvl) && lvl
+    return res unless id.respond_to?(:to_s)
+    return res unless mth.respond_to?(:to_s)
+    return res unless ord.respond_to?(:to_i)
+    return res unless lvl.respond_to?(:to_i)
+
+    id  = id.to_s.strip
     mth = mth.to_s.strip
-    mth = mth[0...60] + " ..." if mth.length > 60
-    return res if mth.empty?
-    id = id.to_s.strip
+    ord = ord.to_i
+    lvl = lvl.to_i
+
     id = id[0...60] + " ..." if id.length > 60
     return res if id.empty?
-    msg  = "Invalid '#{id}' "
-    msg += "arg ##{ord} " if ord.is_a?(Integer) && ord > 0
+
+    mth = mth[0...60] + " ..." if mth.length > 60
+    return res if mth.empty?
+
+    msg = "Invalid '#{id}' "
+    msg += "arg ##{ord} " if ord > 0
     msg += "(#{mth})"
-    lvl = lvl.to_i unless lvl.is_a?(Integer)
     log(lvl, msg) if lvl >= DEBUG && lvl <= FATAL
+
     res
   end
 
@@ -208,25 +216,27 @@ module OSlg
   # @param res [Object] what to return (optional)
   #
   # @return [Object] return object if specified by user
-  # @return [Nil] nil if return object missing or invalid
+  # @return [Nil] nil if return object undefined
   def mismatch(id = "", obj = nil, cl = nil, mth = "", lvl = DEBUG, res = nil)
-    return nil unless defined?(res)
-    return res unless defined?(id ) && id
-    return res unless defined?(obj) && obj
-    return res unless defined?(cl ) && cl
-    return res unless defined?(mth) && mth
-    return res unless defined?(lvl) && lvl
+    return res unless id.respond_to?(:to_s)
+    return res unless cl.is_a?(Class)
+    return res if obj.is_a?(cl)
+    return res unless mth.respond_to?(:to_s)
+    return res unless lvl.respond_to?(:to_i)
+
     mth = mth.to_s.strip
-    mth = mth[0...60] + " ..." if mth.length > 60
-    return res if mth.empty?
-    id = id.to_s.strip
+    id  = id.to_s.strip
+    lvl = lvl.to_i
+
     id = id[0...60] + " ..." if id.length > 60
     return res if id.empty?
-    return res unless cl.is_a?(Class)
-    return res if obj.is_a?(cl)
+
+    mth = mth[0...60] + " ..." if mth.length > 60
+    return res if mth.empty?
+
     msg = "'#{id}' #{obj.class}? expecting #{cl} (#{mth})"
-    lvl = lvl.to_i unless lvl.is_a?(Integer)
     log(lvl, msg) if lvl >= DEBUG && lvl <= FATAL
+
     res
   end
 
@@ -241,25 +251,27 @@ module OSlg
   # @param res [Object] what to return (optional)
   #
   # @return [Object] return object if specified by user
-  # @return [Nil] nil if return object missing or invalid
+  # @return [Nil] nil if return object undefined
   def hashkey(id = "", hsh = {}, key = "", mth = "", lvl = DEBUG, res = nil)
-    return nil unless defined?(res)
-    return res unless defined?(id ) && id
-    return res unless defined?(hsh) && hsh
-    return res unless defined?(key) && key
-    return res unless defined?(mth) && mth
-    return res unless defined?(lvl) && lvl
+    return res unless id.respond_to?(:to_s)
+    return res unless hsh.is_a?(Hash)
+    return res if hsh.key?(key)
+    return res unless mth.respond_to?(:to_s)
+    return res unless lvl.respond_to?(:to_i)
+
+    id  = id.to_s.strip
     mth = mth.to_s.strip
-    mth = mth[0...60] + " ..." if mth.length > 60
-    return res if mth.empty?
-    id = id.to_s.strip
+    lvl = lvl.to_i
+
     id = id[0...60] + " ..." if id.length > 60
     return res if id.empty?
-    return mismatch(id, hsh, Hash, mth, lvl, res) unless hsh.is_a?(Hash)
-    return res if hsh.key?(key)
-    msg  = "Missing '#{key}' key in '#{id}' Hash (#{mth})"
-    lvl = lvl.to_i unless lvl.is_a?(Integer)
+
+    mth = mth[0...60] + " ..." if mth.length > 60
+    return res if mth.empty?
+
+    msg = "Missing '#{key}' key in '#{id}' Hash (#{mth})"
     log(lvl, msg) if lvl >= DEBUG && lvl <= FATAL
+
     res
   end
 
@@ -272,21 +284,25 @@ module OSlg
   # @param res [Object] what to return (optional)
   #
   # @return [Object] return object if specified by user
-  # @return [Nil] nil if return object missing or invalid
+  # @return [Nil] nil if return object undefined
   def empty(id = "", mth = "", lvl = DEBUG, res = nil)
-    return nil unless defined?(res)
-    return res unless defined?(id ) && id
-    return res unless defined?(mth) && mth
-    return res unless defined?(lvl) && lvl
+    return res unless id.respond_to?(:to_s)
+    return res unless mth.respond_to?(:to_s)
+    return res unless lvl.respond_to?(:to_i)
+
+    id  = id.to_s.strip
     mth = mth.to_s.strip
-    mth = mth[0...60] + " ..." if mth.length > 60
-    return res if mth.empty?
-    id = id.to_s.strip
+    lvl = lvl.to_i
+
     id = id[0...60] + " ..." if id.length > 60
     return res if id.empty?
-    msg  = "Empty '#{id}' (#{mth})"
-    lvl = lvl.to_i unless lvl.is_a?(Integer)
+
+    mth = mth[0...60] + " ..." if mth.length > 60
+    return res if mth.empty?
+
+    msg = "Empty '#{id}' (#{mth})"
     log(lvl, msg) if lvl >= DEBUG && lvl <= FATAL
+
     res
   end
 
@@ -299,21 +315,26 @@ module OSlg
   # @param res [Object] what to return (optional)
   #
   # @return [Object] return object if specified by user
-  # @return [Nil] nil if return object missing or invalid
+  # @return [Nil] nil if return object undefined
   def zero(id = "", mth = "", lvl = DEBUG, res = nil)
-    return nil unless defined?(res)
-    return res unless defined?(id ) && id
-    return res unless defined?(mth) && mth
-    return res unless defined?(lvl) && lvl
+    return res unless id.respond_to?(:to_s)
+    return res unless mth.respond_to?(:to_s)
+    return res unless lvl.respond_to?(:to_i)
+
+    id  = id.to_s.strip
     mth = mth.to_s.strip
-    mth = mth[0...60] + " ..." if mth.length > 60
-    return res if mth.empty?
-    id = id.to_s.strip
+    ord = ord.to_i
+    lvl = lvl.to_i
+
     id = id[0...60] + " ..." if id.length > 60
     return res if id.empty?
-    msg  = "Zero '#{id}' (#{mth})"
-    lvl = lvl.to_i unless lvl.is_a?(Integer)
+
+    mth = mth[0...60] + " ..." if mth.length > 60
+    return res if mth.empty?
+
+    msg = "Zero '#{id}' (#{mth})"
     log(lvl, msg) if lvl >= DEBUG && lvl <= FATAL
+
     res
   end
 
@@ -326,21 +347,26 @@ module OSlg
   # @param res [Object] what to return (optional)
   #
   # @return [Object] return object if specified by user
-  # @return [Nil] nil if return object missing or invalid
+  # @return [Nil] nil if return object undefined
   def negative(id = "", mth = "", lvl = DEBUG, res = nil)
-    return nil unless defined?(res)
-    return res unless defined?(id ) && id
-    return res unless defined?(mth) && mth
-    return res unless defined?(lvl) && lvl
+    return res unless id.respond_to?(:to_s)
+    return res unless mth.respond_to?(:to_s)
+    return res unless lvl.respond_to?(:to_i)
+
+    id  = id.to_s.strip
     mth = mth.to_s.strip
-    mth = mth[0...60] + " ..." if mth.length > 60
-    return res if mth.empty?
-    id = id.to_s.strip
+    ord = ord.to_i
+    lvl = lvl.to_i
+
     id = id[0...60] + " ..." if id.length > 60
     return res if id.empty?
-    msg  = "Negative '#{id}' (#{mth})"
-    lvl = lvl.to_i unless lvl.is_a?(Integer)
+
+    mth = mth[0...60] + " ..." if mth.length > 60
+    return res if mth.empty?
+
+    msg = "Negative '#{id}' (#{mth})"
     log(lvl, msg) if lvl >= DEBUG && lvl <= FATAL
+
     res
   end
 
@@ -351,6 +377,7 @@ module OSlg
   def clean!
     @@status = 0
     @@logs   = []
+
     @@level
   end
 

data/lib/oslg/version.rb

@@ -1,6 +1,6 @@
 # BSD 3-Clause License
 #
-# Copyright (c) 2022, Denis Bourgeois
+# Copyright (c) 2022-2023, Denis Bourgeois
 # All rights reserved.
 #
 # Redistribution and use in source and binary forms, with or without
@@ -29,5 +29,5 @@
 # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 module OSlg
-  VERSION = "0.2.4".freeze
+  VERSION = "0.2.6".freeze
 end

data/lib/oslg.rb

@@ -1,6 +1,6 @@
 # BSD 3-Clause License
 #
-# Copyright (c) 2022, Denis Bourgeois
+# Copyright (c) 2022-2023, Denis Bourgeois
 # All rights reserved.
 #
 # Redistribution and use in source and binary forms, with or without

data/oslg.gemspec

@@ -31,7 +31,7 @@ Gem::Specification.new do |s|
   s.add_development_dependency "rake",    "~> 13.0"
   s.add_development_dependency "rspec",   "~> 3.11"
 
-  s.metadata["homepage_uri"]    = s.homepage
+  s.metadata["homepage_uri"   ] = s.homepage
   s.metadata["source_code_uri"] = "#{s.homepage}/tree/v#{s.version}"
   s.metadata["bug_tracker_uri"] = "#{s.homepage}/issues"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: oslg
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.2.6
 platform: ruby
 authors:
 - Denis Bourgeois
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-07-31 00:00:00.000000000 Z
+date: 2023-01-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -76,7 +76,7 @@ licenses:
 - BSD-3-Clause
 metadata:
   homepage_uri: https://github.com/rd2/oslg
-  source_code_uri: https://github.com/rd2/oslg/tree/v0.2.4
+  source_code_uri: https://github.com/rd2/oslg/tree/v0.2.6
   bug_tracker_uri: https://github.com/rd2/oslg/issues
 post_install_message:
 rdoc_options: []