bcl 0.7.1 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a9c714a1d731180ba6a697a3f945d0269ea258d381b31d83c91752415e60603
-  data.tar.gz: f86719936cbb27b79dd812174d5dc1707fa4426439879a16cfc78f9cb8f2666b
+  metadata.gz: 1d846e29ef5a83888943eb997326d38e40cf6ba17288a17f610b722f2ebfcfe0
+  data.tar.gz: 570843a08e8a90c8ecf0d5c31120c274ad49a2279ac82132529451448a84781d
 SHA512:
-  metadata.gz: 9d0fa86c270c26fd224153d5a8179ff24c46b9f27373879c7a1c140279100098da8c83167345f5518c72f14fd6a7c5c22e50506d9fec8ed258f74afa72dfaade
-  data.tar.gz: 713bfd1a0e94a4a4c7b5cdd702ab250c82cd64e1b8188d810a0879fc9b513ec138c8168988cb0242fedfc9deb1d0e58e61a6e5154fea159c88439d9e2eae1743
+  metadata.gz: 45c82af0745dd00892220dd8b2af6606aa22619eac5790babccc3ed26d925b24166f22ce1863cce7d7a45c0358a324595ea960e1e7a8193d3f59d062bd9f1d2f
+  data.tar.gz: a4b11e62e52d29ff5fdf31cfd6272409631139a9fba906fb69bff4032b7095400055455b84a16f43a7faa2f5db91e027b59c6335c5325d72a68a621d15d2370c

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Change Log
 
+## Version 0.8.0
+* BCLXML validation: adjust schemas
+* removed staging, pushing, updating of components
+* removed login
+* simplified config file to only contain server URL
+* removed test to download component via POST (was that needed?)
+* code clean-up and test clean-up
+* updated dependencies to support Ruby 3.2.2 & OpenStudio 3.8.0
+
 ## Version 0.7.1
 * Update license to standard OpenStudio 4-clause BSD license
 * Upgrade dependencies for security

data/LICENSE.md

@@ -1,4 +1,4 @@
-OpenStudio(R), Copyright (c) 2008-2021, Alliance for Sustainable Energy, LLC. All rights reserved.
+OpenStudio(R), Copyright (c) 2008-2024, Alliance for Sustainable Energy, LLC. All rights reserved.
 
 Redistribution and use in source and binary forms, with or without modification, are permitted 
 provided that the following conditions are met:

data/Rakefile

@@ -1,36 +1,6 @@
 # *******************************************************************************
-# OpenStudio(R), Copyright (c) 2008-2021, Alliance for Sustainable Energy, LLC.
-# All rights reserved.
-# Redistribution and use in source and binary forms, with or without
-# modification, are permitted provided that the following conditions are met:
-#
-# (1) Redistributions of source code must retain the above copyright notice,
-# this list of conditions and the following disclaimer.
-#
-# (2) Redistributions in binary form must reproduce the above copyright notice,
-# this list of conditions and the following disclaimer in the documentation
-# and/or other materials provided with the distribution.
-#
-# (3) Neither the name of the copyright holder nor the names of any contributors
-# may be used to endorse or promote products derived from this software without
-# specific prior written permission from the respective party.
-#
-# (4) Other than as required in clauses (1) and (2), distributions in any form
-# of modifications or other derivative works may not use the "OpenStudio"
-# trademark, "OS", "os", or any other confusingly similar designation without
-# specific prior written permission from Alliance for Sustainable Energy, LLC.
-#
-# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) AND ANY CONTRIBUTORS
-# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
-# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER(S), ANY CONTRIBUTORS, THE
-# UNITED STATES GOVERNMENT, OR THE UNITED STATES DEPARTMENT OF ENERGY, NOR ANY OF
-# THEIR EMPLOYEES, BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
-# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-# OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
-# STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
-# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+# OpenStudio(R), Copyright (c) Alliance for Sustainable Energy, LLC.
+# See also https://openstudio.net/license
 # *******************************************************************************
 
 require 'bundler'
@@ -60,43 +30,36 @@ namespace :test do
     # search with all=false
     # ensure the same a) and b) as above
     bcl = BCL::ComponentMethods.new
-    bcl.login
     results = bcl.search('Add', 'show_rows=10', false)
-    puts "there are #{results[:result].count} results"
+    puts "there are #{results[:result].count} results returned in this response"
+    puts "there are #{results[:complete_results_count]} total results available for this query"
     results[:result].each do |res|
       puts (res[:measure][:name]).to_s
     end
   end
 
-  desc 'test measure upload'
-  task :measure_upload do
-    bcl = BCL::ComponentMethods.new
-    bcl.login
-    filename = "#{File.dirname(__FILE__)}/spec/api/resources/measure_original.tar.gz"
-    valid, res = bcl.push_content(filename, false, 'nrel_measure')
-  end
-
-  desc 'test the BCL login credentials defined in .bcl/config.yml'
-  task :bcl_login do
+  desc 'test search and return ALL versions functionality'
+  task :search_all_versions do
+    # search with all=true
+    # ensure that a) results are returned (> 0) and b) [:measure][:name] is a string
+    # search with all=false
+    # ensure the same a) and b) as above
     bcl = BCL::ComponentMethods.new
-    bcl.login
-  end
-
-  desc 'test component spreadsheet'
-  task :spreadsheet do
-    bclcomponents = BCL::ComponentFromSpreadsheet.new(File.expand_path('lib/files/Components.xls', __dir__), ['Roofing'])
-    bclcomponents.save(File.expand_path('lib/files/staged', __dir__))
+    results = bcl.search('Add', 'show_rows=10&all_content_versions=1', false)
+    puts "there are #{results[:result].count} results returned in this response"
+    puts "there are #{results[:complete_results_count]} total results available for this query"
+    results[:result].each do |res|
+      puts (res[:measure][:name]).to_s
+    end
   end
 
   desc 'test measure download'
   task :measure_download do
     # find a component with keyword 'Ashrae'
     query = 'ashrae'
-    filter = 'fq[]=bundle:nrel_component&show_rows=3'
+    filter = 'fq=bundle:nrel_component&show_rows=3'
 
     bcl = BCL::ComponentMethods.new
-    bcl.login
-
     results = bcl.search(query, filter)
     uids = []
     results[:result].each do |result|
@@ -111,223 +74,33 @@ namespace :test do
     f = File.open("#{download_path}/#{uids[0]}.tar.gz", 'wb')
     f.write(content)
   end
-end
-
-namespace :bcl do
-  STAGED_PATH = Pathname.new(Dir.pwd + '/staged')
-
-  # initialize BCL and login
-  bcl = BCL::ComponentMethods.new
-  bcl.login
-
-  # to call: rake "bcl:stage_and_upload[/path/to/your/content/directory, true]"
-  # content_path arg: path to components or measures to upload
-  # reset flag:
-  # If TRUE: content in the staged directory will be re-generated and receipt files will be deleted.
-  # If FALSE, content that already exists in the staged directory will remain and content with receipt files will not be re-uploaded.
-  desc 'stage and push/update all content in a repo'
-  task :stage_and_upload, [:content_path, :reset] do |t, args|
-    options = { reset: false }
-    options[:content_path] = Pathname.new args[:content_path]
-    if args[:reset].to_s == 'true'
-      options[:reset] = true
-    end
-
-    current_dir = Dir.pwd
-
-    # stage content
-    Rake.application.invoke_task("bcl:stage_content[#{options[:content_path]}, #{options[:reset]}]")
-    Dir.chdir(current_dir)
-
-    # upload (new and updated). pass in skip flag
-    Rake.application.invoke_task("bcl:upload_content[#{options[:reset]}]")
-  end
 
-  # to call: rake "bcl:upload_content[true]"
-  # TODO: catch errors and continue
-  desc 'upload/update BCL content'
-  task :upload_content, [:reset] do |t, args|
-    # process options
-    options = { reset: false }
-    if args[:reset].to_s == 'true'
-      options[:reset] = true
-    end
-
-    total_count = 0
-    successes = 0
-    errors = 0
-    skipped = 0
-
-    # grab all the new measure and component tar files and push to bcl
-    ['measure', 'component'].each do |content_type|
-      items = []
-      paths = Pathname.glob(STAGED_PATH.to_s + "/push/#{content_type}/*.tar.gz")
-      paths.each do |path|
-        # puts path
-        items << path.to_s
-      end
-
-      items.each do |item|
-        puts item.split('/').last
-        total_count += 1
-
-        receipt_file = File.dirname(item) + '/' + File.basename(item, '.tar.gz') + '.receipt'
-        if !options[:reset] && File.exist?(receipt_file)
-          skipped += 1
-          puts 'SKIP: receipt file found'
-          next
-        end
-
-        valid, res = bcl.push_content(item, true, "nrel_#{content_type}")
-        if valid
-          successes += 1
-        else
-          errors += 1
-          if res.key?(:error)
-            puts "  ERROR MESSAGE: #{res[:error]}"
-          else
-            puts "ERROR: #{res.inspect.chomp}"
-          end
-        end
-        puts '', '---'
-      end
-    end
+  desc 'test measure download - legacy syntax'
+  task :measure_download do
+    # find a component with keyword 'Ashrae'
+    query = 'ashrae'
+    filter = 'fq[]=bundle:nrel_component&show_rows=3'
 
-    # grab all the updated content (measures and components) tar files and push to bcl
-    items = []
-    paths = Pathname.glob(STAGED_PATH.to_s + '/update/*.tar.gz')
-    paths.each do |path|
-      # puts path
-      items << path.to_s
+    bcl = BCL::ComponentMethods.new
+    results = bcl.search(query, filter)
+    uids = []
+    results[:result].each do |result|
+      uids << result[:component][:uuid]
     end
-    items.each do |item|
-      puts item.split('/').last
-      total_count += 1
 
-      receipt_file = File.dirname(item) + '/' + File.basename(item, '.tar.gz') + '.receipt'
-      if !options[:reset] && File.exist?(receipt_file)
-        skipped += 1
-        puts 'SKIP: receipt file found'
-        next
-      end
-
-      valid, res = bcl.update_content(item, true)
-      if valid
-        successes += 1
-      else
-        errors += 1
-        if res.key?(:error)
-          puts "  ERROR MESSAGE: #{res[:error]}"
-        else
-          puts "ERROR MESSAGE: #{res.inspect.chomp}"
-        end
-      end
-      puts '', '---'
-    end
+    content = bcl.download_component(uids[0])
 
-    puts "****UPLOAD DONE**** #{total_count} total, #{successes} success, #{errors} failures, #{skipped} skipped"
+    # save as tar.gz
+    download_path = File.expand_path('lib/files/downloads', __dir__)
+    FileUtils.mkdir(download_path) if !File.exist? download_path
+    f = File.open("#{download_path}/#{uids[0]}.tar.gz", 'wb')
+    f.write(content)
   end
 
-  # to call: rake "bcl:stage_content[/path/to/your/content/directory, true]"
-  desc 'stage content for BCL'
-  task :stage_content, [:content_path, :reset] do |t, args|
-    # process options
-    options = { reset: false }
-    options[:content_path] = Pathname.new args[:content_path]
-    if args[:reset].to_s == 'true'
-      options[:reset] = true
-    end
-    puts "OPTIONS -- content_path: #{options[:content_path]}, reset: #{options[:reset]}"
-
-    FileUtils.mkdir_p(STAGED_PATH)
-
-    # delete existing tarballs if reset is true
-    if options[:reset]
-      FileUtils.rm_rf(Dir.glob("#{STAGED_PATH}/*"))
-    end
-
-    # create new and existing directories
-    FileUtils.mkdir_p(STAGED_PATH.to_s + '/update')
-    FileUtils.mkdir_p(STAGED_PATH.to_s + '/push/component')
-    FileUtils.mkdir_p(STAGED_PATH.to_s + '/push/measure')
-
-    # keep track of noop, update, push
-    noops = 0
-    new_ones = 0
-    updates = 0
-
-    # get all content directories to process
-    dirs = Dir.glob("#{options[:content_path]}/*")
-
-    dirs.each do |dir|
-      next if dir.include?('Rakefile')
-
-      current_d = Dir.pwd
-      content_name = File.basename(dir)
-      puts '', '---'
-      puts "Generating #{content_name}"
-
-      Dir.chdir(dir)
-
-      # figure out whether to upload new or update existing
-      files = Pathname.glob('**/*')
-      uuid = nil
-      vid = nil
-      content_type = 'measure'
-
-      paths = []
-      files.each do |file|
-        # don't tar tests/outputs directory
-        next if file.to_s.start_with?('tests/output') # From measure testing process
-        next if file.to_s.start_with?('tests/test') # From openstudio-measure-tester-gem
-        next if file.to_s.start_with?('tests/coverage') # From openstudio-measure-tester-gem
-        next if file.to_s.start_with?('test_results') # From openstudio-measure-tester-gem
-
-        paths << file.to_s
-        if file.to_s =~ /^.{0,2}component.xml$/ || file.to_s =~ /^.{0,2}measure.xml$/
-          if file.to_s.match?(/^.{0,2}component.xml$/)
-            content_type = 'component'
-          end
-          # extract uuid  and vid
-          uuid, vid = bcl.uuid_vid_from_xml(file)
-        end
-      end
-      puts "UUID: #{uuid}, VID: #{vid}"
-
-      # note: if uuid is missing, will assume new content
-      action = bcl.search_by_uuid(uuid, vid)
-      puts "#{content_name} ACTION TO TAKE: #{action}"
-      # new content functionality needs to know if measure or component.  update is agnostic.
-      if action == 'noop' # ignore up-to-date content
-        puts "  - WARNING: local #{content_name} uuid and vid match BCL... no update will be performed"
-        noops += 1
-        next
-      elsif action == 'update'
-        # puts "#{content_name} labeled as update for BCL"
-        destination = STAGED_PATH.join(action, "#{content_name}.tar.gz")
-        updates += 1
-      elsif action == 'push'
-        # puts "#{content_name} labeled as new content for BCL"
-        destination = STAGED_PATH.join(action, content_type, "#{content_name}.tar.gz")
-        new_ones += 1
-      end
-
-      puts "destination: #{destination}"
-
-      # copy over only if 'reset_receipts' is set to TRUE. otherwise ignore if file exists already
-      if File.exist?(destination)
-        if options[:reset]
-          FileUtils.rm(destination)
-          BCL.tarball(destination, paths)
-        else
-          puts "*** WARNING: File #{content_name}.tar.gz already exists in staged directory... keeping existing file. To overwrite, set reset_receipts arg to true ***"
-        end
-      else
-        BCL.tarball(destination, paths)
-      end
-      Dir.chdir(current_d)
-    end
-    puts '', "****STAGING DONE**** #{new_ones} new content, #{updates} updates, #{noops} skipped (already up-to-date on BCL)", ''
+  desc 'test component spreadsheet'
+  task :spreadsheet do
+    bclcomponents = BCL::ComponentFromSpreadsheet.new(File.expand_path('lib/files/Components.xls', __dir__), ['Roofing'])
+    bclcomponents.save(File.expand_path('lib/files/staged', __dir__))
   end
 end
 

data/bcl.gemspec

@@ -16,7 +16,6 @@ Gem::Specification.new do |spec|
   spec.metadata = {
     'bug_tracker_uri' => 'https://github.com/NREL/bcl-gem/issues',
     'changelog_uri' => 'https://github.com/NREL/bcl-gem/blob/develop/CHANGELOG.md',
-    # 'documentation_uri' =>  'https://www.rubydoc.info/gems/openstudio-extension-gem/#{gem.version}',
     'source_code_uri' => "https://github.com/NREL/bcl-gem/tree/v#{spec.version}"
   }
 
@@ -27,7 +26,7 @@ Gem::Specification.new do |spec|
   spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.required_ruby_version = '~> 2.7.0'
+  spec.required_ruby_version = '~> 3.2.2'
 
   spec.add_dependency 'builder', '3.2.4'
   spec.add_dependency 'faraday', '~> 1.0.1'
@@ -35,7 +34,7 @@ Gem::Specification.new do |spec|
 
   # Measure tester is not used in this project, but this will force dependencies to match versions
   # requested by OpenStudio. This includes dependencies for running tests/CI
-  spec.add_dependency 'openstudio_measure_tester', '~> 0.3.1'
+  spec.add_dependency 'openstudio_measure_tester', '~> 0.4.0'
   spec.add_dependency 'rexml', '3.2.5'
   spec.add_dependency 'rubyzip', '~> 2.3.2'
   spec.add_dependency 'spreadsheet', '1.2.9'
@@ -43,6 +42,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'yamler', '0.1.0'
   spec.add_dependency 'zliby', '0.0.5'
 
+  spec.add_development_dependency 'bundler', '2.4.10'
   spec.add_development_dependency 'rake', '~> 13.0'
   spec.add_development_dependency 'rspec', '~> 3.9'
 end

data/lib/bcl/base_xml.rb

@@ -1,36 +1,6 @@
 # *******************************************************************************
-# OpenStudio(R), Copyright (c) 2008-2021, Alliance for Sustainable Energy, LLC.
-# All rights reserved.
-# Redistribution and use in source and binary forms, with or without
-# modification, are permitted provided that the following conditions are met:
-#
-# (1) Redistributions of source code must retain the above copyright notice,
-# this list of conditions and the following disclaimer.
-#
-# (2) Redistributions in binary form must reproduce the above copyright notice,
-# this list of conditions and the following disclaimer in the documentation
-# and/or other materials provided with the distribution.
-#
-# (3) Neither the name of the copyright holder nor the names of any contributors
-# may be used to endorse or promote products derived from this software without
-# specific prior written permission from the respective party.
-#
-# (4) Other than as required in clauses (1) and (2), distributions in any form
-# of modifications or other derivative works may not use the "OpenStudio"
-# trademark, "OS", "os", or any other confusingly similar designation without
-# specific prior written permission from Alliance for Sustainable Energy, LLC.
-#
-# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) AND ANY CONTRIBUTORS
-# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
-# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER(S), ANY CONTRIBUTORS, THE
-# UNITED STATES GOVERNMENT, OR THE UNITED STATES DEPARTMENT OF ENERGY, NOR ANY OF
-# THEIR EMPLOYEES, BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
-# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-# OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
-# STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
-# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+# OpenStudio(R), Copyright (c) Alliance for Sustainable Energy, LLC.
+# See also https://openstudio.net/license
 # *******************************************************************************
 
 # KAF 2/13/2018

data/lib/bcl/component.rb

@@ -1,36 +1,6 @@
 # *******************************************************************************
-# OpenStudio(R), Copyright (c) 2008-2021, Alliance for Sustainable Energy, LLC.
-# All rights reserved.
-# Redistribution and use in source and binary forms, with or without
-# modification, are permitted provided that the following conditions are met:
-#
-# (1) Redistributions of source code must retain the above copyright notice,
-# this list of conditions and the following disclaimer.
-#
-# (2) Redistributions in binary form must reproduce the above copyright notice,
-# this list of conditions and the following disclaimer in the documentation
-# and/or other materials provided with the distribution.
-#
-# (3) Neither the name of the copyright holder nor the names of any contributors
-# may be used to endorse or promote products derived from this software without
-# specific prior written permission from the respective party.
-#
-# (4) Other than as required in clauses (1) and (2), distributions in any form
-# of modifications or other derivative works may not use the "OpenStudio"
-# trademark, "OS", "os", or any other confusingly similar designation without
-# specific prior written permission from Alliance for Sustainable Energy, LLC.
-#
-# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) AND ANY CONTRIBUTORS
-# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
-# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER(S), ANY CONTRIBUTORS, THE
-# UNITED STATES GOVERNMENT, OR THE UNITED STATES DEPARTMENT OF ENERGY, NOR ANY OF
-# THEIR EMPLOYEES, BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
-# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-# OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
-# STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
-# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+# OpenStudio(R), Copyright (c) Alliance for Sustainable Energy, LLC.
+# See also https://openstudio.net/license
 # *******************************************************************************
 
 # Provides programmatic access to the component.xsd schema needed for

data/lib/bcl/component_from_spreadsheet.rb

@@ -1,36 +1,6 @@
 # *******************************************************************************
-# OpenStudio(R), Copyright (c) 2008-2021, Alliance for Sustainable Energy, LLC.
-# All rights reserved.
-# Redistribution and use in source and binary forms, with or without
-# modification, are permitted provided that the following conditions are met:
-#
-# (1) Redistributions of source code must retain the above copyright notice,
-# this list of conditions and the following disclaimer.
-#
-# (2) Redistributions in binary form must reproduce the above copyright notice,
-# this list of conditions and the following disclaimer in the documentation
-# and/or other materials provided with the distribution.
-#
-# (3) Neither the name of the copyright holder nor the names of any contributors
-# may be used to endorse or promote products derived from this software without
-# specific prior written permission from the respective party.
-#
-# (4) Other than as required in clauses (1) and (2), distributions in any form
-# of modifications or other derivative works may not use the "OpenStudio"
-# trademark, "OS", "os", or any other confusingly similar designation without
-# specific prior written permission from Alliance for Sustainable Energy, LLC.
-#
-# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) AND ANY CONTRIBUTORS
-# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
-# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER(S), ANY CONTRIBUTORS, THE
-# UNITED STATES GOVERNMENT, OR THE UNITED STATES DEPARTMENT OF ENERGY, NOR ANY OF
-# THEIR EMPLOYEES, BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
-# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
-# OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
-# STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
-# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+# OpenStudio(R), Copyright (c) Alliance for Sustainable Energy, LLC.
+# See also https://openstudio.net/license
 # *******************************************************************************
 
 # Converts a custom Excel spreadsheet format to BCL components for upload