openstudio-extension 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6e84ea4693147440c182272ddb36fce2fab938bd
-  data.tar.gz: 7f9c6fea6520d12cb9179070fcae33e4d28d53e3
+  metadata.gz: 7199026e992efc5a48c8c164cc26ff9a30b78266
+  data.tar.gz: 8e609b0ab15f84fbbf05e15255eb8a38a031695f
 SHA512:
-  metadata.gz: e7f60f747c1ada979e624def3ba692a22198ee58438484c37c93d21764d67fb574eed03c2faf4fe8e8052b6fddd64ea8eb68363d332a1fbde60c386186360b31
-  data.tar.gz: 3dfc4a2d409665ea67bf6adf4ccfaf9fd819368a2dfe5031d6204a995adbf0953eb8382d096afa93bc7028607dc5918298b216e00d201a6ecc6d6a7dbb0f7cc3
+  metadata.gz: 7e6c4367cd3d0b03a463e799461e1705ef9710b4974ee8d0638d369914369fe629e8dfa560e18312179cb133396a0a70730e7de2357c08a9fc7f9a60f8b2f724
+  data.tar.gz: 0c7ad841664b252c48090e6b04b9efd44abe27d02defd91c383e351c1b334a1bbca40570e46e10efa6dd238db79e9d5e1b49398841997f1d6b46a387780f8c1a

data/.gitignore

@@ -8,10 +8,19 @@
 /doc/
 /pkg/
 /spec/reports/
+/spec/test/
 /tmp/
+/test/
+/lib/measures/test_results
+/lib/measures/.rubocop*
 
 # rspec failure tracking
 .rspec_status
 
 # Ignore IDE files
 /.idea
+*.rubocop-http*
+
+# measures tests
+lib/measures/.rubocop.yml
+lib/measures/test_results/*

data/.rubocop.yml

@@ -0,0 +1,9 @@
+AllCops:
+  Exclude:
+    - gems/**/*
+    - lib/measures/**/*
+    - lib/openstudio/extension/core/**/*
+
+inherit_from:
+  - http://s3.amazonaws.com/openstudio-resources/styles/rubocop.yml
+

data/Gemfile

@@ -1,4 +1,6 @@
-source "https://rubygems.org"
+source 'http://rubygems.org'
 
 # Specify your gem's dependencies in openstudio-extension.gemspec
 gemspec
+
+gem 'simplecov', github: 'NREL/simplecov'

data/Jenkinsfile

@@ -0,0 +1,10 @@
+//Jenkins pipelines are stored in shared libaries. Please see: https://github.com/tijcolem/nrel_cbci_jenkins_libs 
+ 
+@Library('cbci_shared_libs') _
+
+// Build for PR to develop branch only. 
+if ((env.CHANGE_ID) && (env.CHANGE_TARGET) ) { // check if set
+
+  openstudio_extension_gems()
+    
+}

data/README.md

@@ -1,10 +1,210 @@
-# OpenStudio::Extension
+# OpenStudio Extension Gem
 
-This gem repository serves as a base for single purpose repositories that host API methods, CLI tools, and OpenStudio measures which leverage those methods and tools.  Other repositories (e.g. urbanopt-geojson-gem) will depend on this repository and inherit/mix-in needed functionality.  The repository is formatted as a gem to allow for semantic versioning via Bundle.  The repository includes methods for testing, documentation, and build tasks.
+This gem repository serves as a base for single purpose repositories that host API methods, CLI tools, and OpenStudio measures which leverage those methods and tools.  Other derivative extension gem repositories will depend on this repository and inherit/mix-in needed functionality.  The repository is formatted as a gem to allow for semantic versioning via Bundle.  The repository includes methods for testing, documentation, and build tasks.
+
+## Overview
+
+The OpenStudio Extension Gem contains methods and patterns to extend OpenStudio.  It is a template that can be used to create other extension gems.  
+
+Derivative extension gems should include this gem to access common functionality, such as:
+* OpenStudio CLI functionality such as list_measures and update_measures
+* adding documentation and license files to measures
+* adding core resource files to measures
+* pushing measures to BCL
+
+Extension gems will contain a small group of related measures. Each extension gem will be the unique location to find these measures, and will be responsible for
+testing and maintaining the measures as well as pushing them to BCL. 
+
+## Usage
+
+The ```openstudio-extension``` gem is meant to be used as a base for creating new gems to use with OpenStudio.  The intention is to standardize best practices and common patterns in one location rather than try to synchronize them across many independent gems.  
+
+Existing gems such as ```openstudio-standards``` and ```openstudio-workflow``` may be refactored to depend on ```openstudio-extension``` in the future.  The immediate use of ```openstudio-extension``` will be for new gems.  New gems that may be considered a part of OpenStudio and potentially distributed with OpenStudio in the future should be named as ```openstudio-#{gem-name}```, e.g. ```openstudio-model-articulation``` is a gem to implement model articulation methods for OpenStudio.  
+Other gems that extend OpenStudio for specific applications or other domains should be named separately, e.g. ```buildingsync``` is an extension of OpenStudio specifically for use with BuildingSync files.
+
+Each OpenStudio extension gem should define its own module name to ensure that there are no code collisions with other extension gems. If the gem name is prefixed with ```openstudio-``` then the module name can be nested under the OpenStudio module.
+
+| openstudio-model-articulation                                                                               	| buildingsync                                                                	|
+|-------------------------------------------------------------------------------------------------------------	|-----------------------------------------------------------------------------	|
+| module OpenStudio   module ModelArticulation     class ModelArticulation < OpenStudio::Extension::Extension 	| module BuildingSync   class BuildingSync < OpenStudio::Extension::Extension 	|
 
 
 ## Installation
 
+To use this and other extension gems, you will need Ruby 2.2.4 and OpenStudio 2.7.1 or greater.  
+
+### Windows Installation
+Install Ruby using the [RubyInstaller](https://rubyinstaller.org/downloads/archives/) for [Ruby 2.2.4 (x64)](https://dl.bintray.com/oneclick/rubyinstaller/rubyinstaller-2.2.4-x64.exe).
+
+Install Dekit using the [mingw64](https://dl.bintray.com/oneclick/rubyinstaller/DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe) installer.
+
+Check the ruby installation returns the correct Ruby version (2.2.4):
+```
+ruby -v
+```
+
+Install bundler from the command line
+```
+gem install bundler -v 1.17
+```
+
+Install OpenStudio.  Create a file ```C:\ruby-2.2.4-x64-mingw32\lib\ruby\site_ruby\openstudio.rb``` and point it to your OpenStudio installation by editing the contents.  E.g.:
+
+```ruby
+require 'C:\openstudio-2.7.1\Ruby\openstudio.rb'
+```
+
+Verify your OpenStudio and Ruby configuration:
+```
+ruby -e "require 'openstudio'" -e "puts OpenStudio::Model::Model.new"
+```
+
+### Mac Installation
+It is recommended that you install [rbenv](https://github.com/rbenv/rbenv) to easily manage difference versions of Ruby.
+rbenv can be installed view Homebrew:
+```ruby
+brew install rbenv
+rbenv init
+rbenv install 2.2.4
+```
+
+Also install bundler
+```ruby
+gem install bundler -v 1.17
+```
+
+Install [OpenStudio](https://www.openstudio.net/downloads).
+
+Add the RUBYLIB environment variable to your bash_profile file. It should point to the Ruby folder within the OpenStudio Application you just downloaded:
+```ruby
+export RUBYLIB=“/Applications/OpenStudio-2.7.2/Ruby”
+```
+
+
+## Contents
+The OpenStudio Extension Gem (this repo) contains methods that can be shared across and extended by other derivative extension gems.
+
+### Directory Structure
+
+Extension gem and the derivative extension gem should have the following directory structure:
+
+├── doc_templates
+
+├── init_templates
+
+├── lib
+
+│       ├── data
+
+│       ├── files
+
+│       ├── measures
+
+│       └── openstudio
+
+│                         └── extension
+
+│                                       └── core
+
+└── spec
+                       ├── files
+
+                       └── openstudio
+   
+                                    └── core
+
+`doc_templates` contains copyright and license file templates that can be copied and added to each measure.  
+The derivative extension gems should have their own doc_templates directory.
+
+`init_templates` are used with the `init-new-gem` rake task to create a derivative extension gem directory structure.
+
+`lib` contains data
+* `data` contains custom data for the gem
+* `files` contains files referenced by measures or workflows
+* `measures` contains the measures included in the gem.  
+* `openstudio` and `openstudio\extension` contain the code related to this gem.
+* `openstudio\extension\core` contains core resource files shared across a variety of measures.  
+
+Your gem should list its gem dependencies (including ```openstudio-extension```) in its gemspec file.  This is what is used to determine dependencies for consumers of your gem.  
+You should only list actual dependencies of your gem in the gemspec.  You can list specific sources for your gems (e.g. on github, local file) in your Gemfile.  If you are writing an application rather than a gem, you can only have a Gemfile. You do not need a gemspec unless you are releasing your code as a gem.
+Once you have included ```openstudio-extension``` as a dependency of your gem, you can inherit common rake tasks into your application's Rakefile.
+
+### Core Library
+The `core` folder located at `lib\openstudio\extension` contains core resource files shared across a variety of measures.  The files should be edited in the OpenStudio-extension-gem, and the rake task (`bundle exec rake openstudio:measures:copy_resources`) should be used to update the measures that depend on them.
+Note that this folder is for 'core' functionality; if a measure's requires a new one-off function, this should be developed in place, within the measure's `resources` folder.
+
+Having a single repository for all measures, such as the OpenStudio-measures repo, can be cumbersome to test and keep up to date. 
+In this new framework, each extension gem will contain one or more related measures.  The gem will be the new 'home' of these measures, and the repo owner will be responsible for testing and keeping the measures up to date.
+
+In the short term, in order to preserve the PAT/OS App functionality, resource files will still be copied directly into the measures, and these measures will be pushed to BCL.
+
+### Rake Tasks
+Common Rake Tasks that are available to derivative extension gems include:
+| Rake Task | Description |
+| --------- | ----------- |
+| openstudio:list_measures             | List all measures in the calling gem |
+| openstudio:measures:add_license      | Add License File to measures in the calling gem |
+| openstudio:measures:add_readme       | Add README.md.erb file if it and the README markdown file do not already exist for a measure |
+| openstudio:measures:copy_resources   | Copy the resources files to individual measures in the calling gem |
+| openstudio:measures:update_copyright | Update copyright on measure files in the calling gem |
+| openstudio:stage_bcl                 | Copy the measures to a location that can be uploaded to BCL |
+| openstudio:push_bcl                  | Upload measures from the specified location to the BCL |
+| openstudio:test_with_docker          | Use openstudio docker image to run tests |
+| openstudio:test_with_openstudio      | Use openstudio system ruby to run tests |
+| openstudio:update_measures           | Run the CLI task to check for measure updates and update the measure xml files |
+
+These can all be invoked from the derivative gem by running the following command in a terminal:
+
+``` bundle exec rake <name_of_rake_task>```
+
+To list all available rake tasks:
+
+``` bundle exec rake -T ```
+
+## Derivative Extension Gems
+
+The following table contains all current extension gems.
+
+| Name   |   Gem Name | Repo | 
+| ------ | ---------- | ------ |
+| OpenStudio Extension Gem | openstudio-extension | https://github.com/NREL/OpenStudio-extension-gem | 
+| OpenStudio Common Measures Gem  | openstudio-common-measures | https://github.com/NREL/openstudio-common-measures-gem |
+| OpenStudio Model Articulation Gem   | openstudio-model-articulation | https://github.com/NREL/openstudio-model-articulation-gem |
+| OpenStudio AEDG Gem | openstudio-aedg | https://github.com/NREL/openstudio-aedg-gem | 
+| OpenStudio District Systems Gem | openstudio-district-systems | https://github.com/NREL/openstudio-district-systems-gem | 
+| UrbanOpt GeoJSON Gem | urbanopt-geojson | https://github.com/urbanopt/urbanopt-geojson-gem | 
+| BuildingSync Gem | buildingsync | https://github.com/BuildingSync/BuildingSync-gem | 
+
+### Initializing a new Extension Gem
+The OpenStudio-extension gem can be used to easily initialize a new derivative extension gem.  
+
+* First, call the rake task:
+    ```ruby
+    bundle exec rake init-new-gem
+    ```
+    * Enter the name of the gem repository (use dashes between words and the repo name should end with '-gem')
+    * Enter the location of the directory where the gem directory should be created
+    The rake task will create the gem directory and stub out the required files.
+    
+* You can then obtain a github repository and commit the newly created gem directory to it
+
+### Coding Conventions
+* Name your extension gem repo:  OpenStudio-<gem name in lowercase>-gem.  Use dashes between words. Example:  OpenStudio-extension-gem
+* Name the actual gem: openstudio-<gem name in lowercase>. 'openstudio' should be lowercase. Use dashes between words.  Example: openstudio-extension
+* Use lowercase snake_case for methods and variables.
+* Use CamelCase for classes and modules. (Keep acronyms like HTTP, RFC, XML uppercase.)
+* All files and classes should have underscores (no dashes) and (lowercase snake_case)
+* Dashes should be used in module names
+
+### Pushing to BCL
+Use the rake tasks listed above to stage and push measures to BCL.  
+**Note of warning**: Use caution when pushing to the BCL.  Public and private measures could be pushed to BCL from within an extension gem, even though the extension gem repo may be private.
+
+TODO: Add warning to rake task and lists what gems will be pushed 
+TODO: Check that license files, etc. are present in each measure before pushing to BCL
+
+## Include in a project
+
 Add this line to your application's Gemfile:
 
 ```ruby
@@ -13,20 +213,38 @@ gem 'openstudio-extension'
 
 And then execute:
 
-    $ bundle
-
+    $ bundle install
+    $ bundle update
+    
 Or install it yourself as:
 
     $ gem install 'openstudio-extension'
 
-## Usage
-
-To be filled out later. 
-
-# Releasing
+# Releasing the gem
 
 * Update change log
-* Update version in `/lib/openstudio_measure_tester/version.rb`
+* Update version in `/lib/openstudio/extension/version.rb`
 * Merge down to master
-* Release via github
-* run `rake release` from master  
+* run `rake release` from master  
+
+# TODO
+
+- [ ] Finalize documentation on naming conventions, etc
+- [X] Add test measure
+- [X] Rake task ```openstudio:update_measures```
+- [X] Rake task ```openstudio:test_with_openstudio```
+- [ ] Rake task ```stage_bcl``` _DLM: BCL gem should be a development dependency only until we can reduce its dependencies and remove native dependencies? should probably put it into a special group so we can bundle without it in openstudio-gems._
+- [ ] Rake task ```push_bcl``` _DLM: how do we want to test this?
+- [X] Get all rake tasks working on Travis
+- [ ] Capture useful output from Travis (measure dashboard results, log files, zip of build products, etc) and put it somewhere (s3?  naming convention?)
+- [X] ```Extension::openstudio_extension_version``` _DLM: should we rename? should people overwrite this in their class?_
+- [X] ```Extension::measures_dir``` _DLM: I think this can have a default implementation, right? If something does not need to be overridden should it be a module method rather than a class one?  KAF: this is in rake task for now
+- [X] ```Extension::list_measures``` _DLM: I think this can have a default implementation, right?_KAF: In Rake task for now
+- [ ] ```Extension::files_dir``` _DLM: I think this can have a default implementation, right?_
+- [ ] ```Extension::minimum_openstudio_version``` _DLM: should we rename? should people overwrite this in their class?_
+- [X] ```Runner::initialize``` _DLM: should say that the path argument should be for a dir with a Gemfile right?_
+- [X] ```Runner::configure_osw``` _DLM: should take in an OSW, add paths to all measure and file dirs for loaded OpenStudio Extensions, write out configured OSW_
+- [ ] Run rubocop on all of the core files and remove exclusion from .rubocop.yml file.
+- [ ] Cleanup task after running tests (may need to be in the OpenStudio Measure Tester)
+- [ ] Add a `rake init new_ext_gem` to Rakefile
+- [ ] Add tests to the extension/core

data/Rakefile

@@ -26,9 +26,94 @@
 #  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 ########################################################################################################################
 
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
 
 RSpec::Core::RakeTask.new(:spec)
 
-task :default => :spec
+require 'openstudio/extension/rake_task'
+require 'openstudio/extension'
+rake_task = OpenStudio::Extension::RakeTask.new
+rake_task.set_extension_class(OpenStudio::Extension::Extension)
+
+require 'rubocop/rake_task'
+RuboCop::RakeTask.new
+
+task default: :spec
+
+desc 'Initialize a new gem'
+task :init_new_gem do
+  puts 'Initializing a new extension gem'
+  print "\n Enter the name of the new gem directory (ex: openstudio-something-gem. Should end with '-gem'): "
+  gem_name = STDIN.gets.chomp
+
+  print "\n Enter the path (full or relative to this repo) where you want the new gem directory to be created: "
+  dir_path = STDIN.gets.chomp
+
+  # check if directory already exists at path, if so error
+  full_dir_name = dir_path + gem_name
+
+  if Dir.exist?(full_dir_name)
+    puts "ERROR:  there is already a directory at path #{full_dir_name}... aborting"
+  else
+    puts "CREATING dir #{full_dir_name}"
+    Dir.mkdir full_dir_name
+  end
+
+  # copy file structure
+  FileUtils.cp('.gitignore', full_dir_name + '/.gitignore')
+  FileUtils.cp_r(File.join(File.dirname(__FILE__), 'init_templates/template_gemfile.txt'), File.join(full_dir_name, 'Gemfile'))
+  FileUtils.cp_r(File.join(File.dirname(__FILE__), 'doc_templates'), full_dir_name)
+
+  Dir.mkdir File.join(full_dir_name, 'lib')
+  Dir.mkdir File.join(full_dir_name, 'lib/measures')
+  Dir.mkdir File.join(full_dir_name, 'lib/files')
+
+  # Replacement tokens
+  gem_name_bare = gem_name.gsub('-gem', '')
+  gem_name_underscores_no_os = gem_name_bare.gsub('openstudio-', '').gsub('openstudio', '').tr('-', '_').tr(' ', '_')
+  gem_name_spaces = gem_name.split('-').map(&:capitalize).join(' ')
+  gem_class_name = gem_name_underscores_no_os.split('_').collect(&:capitalize).join
+
+  # Rewrite the rakefile template
+  text = File.read(File.join(File.dirname(__FILE__), 'init_templates/template_rakefile.txt'))
+  new_contents = text.gsub(/GEM_CLASS_NAME/, gem_class_name)
+  new_contents = new_contents.gsub(/GEM_NAME_UNDERSCORES/, gem_name_underscores_no_os)
+  File.open(File.join(full_dir_name, '/Rakefile'), 'w') { |file| file.puts new_contents }
+
+  # Rewrite README with gem-specific tokens and save
+  text = File.read(File.join(File.dirname(__FILE__), 'init_templates/README.md'))
+  new_contents = text.gsub(/GEM_NAME_SPACES/, gem_name_spaces)
+  new_contents = new_contents.gsub(/GEM_NAME_BARE/, gem_name_bare)
+  File.open(File.join(full_dir_name, '/README.md'), 'w') { |file| file.puts new_contents }
+
+  # Rewrite gemspec
+  text = File.read(File.join(File.dirname(__FILE__), 'init_templates/gemspec.txt'))
+  new_contents = text.gsub(/GEM_NAME_UNDERSCORES/, gem_name_underscores_no_os)
+  new_contents = new_contents.gsub(/GEM_NAME_BARE/, gem_name_bare)
+  new_contents = new_contents.gsub(/GEM_CLASS_NAME/, gem_class_name)
+  File.open(File.join(full_dir_name, "#{gem_name_bare}.gemspec"), 'w') { |file| file.puts new_contents }
+
+  # Rewrite spec and spec_helper with gem-specific tokens and save
+  Dir.mkdir File.join(full_dir_name, 'spec')
+  Dir.mkdir File.join(full_dir_name, 'spec/tests')
+  text = File.read(File.join(File.dirname(__FILE__), 'init_templates/spec.rb'))
+  new_contents = text.gsub(/GEM_CLASS_NAME/, gem_class_name)
+  File.open(File.join(full_dir_name, 'spec', 'tests', "#{gem_name_underscores_no_os}_spec.rb"), 'w') { |file| file.puts new_contents }
+
+  text = File.read(File.join(File.dirname(__FILE__), 'init_templates/spec_helper.rb'))
+  new_contents = text.gsub(/GEM_NAME_UNDERSCORES/, gem_name_underscores_no_os)
+  File.open(File.join(full_dir_name, 'spec', 'spec_helper.rb'), 'w') { |file| file.puts new_contents }
+
+  # Stub out OpenStudio directory
+  Dir.mkdir File.join(full_dir_name, 'lib/openstudio')
+  Dir.mkdir File.join(full_dir_name, 'lib/openstudio', gem_name_underscores_no_os)
+  text = File.read(File.join(File.dirname(__FILE__), 'init_templates/version.rb'))
+  new_contents = text.gsub(/GEM_CLASS_NAME/, gem_class_name)
+  File.open(File.join(full_dir_name, 'lib', 'openstudio', gem_name_underscores_no_os, 'version.rb'), 'w') { |file| file.puts new_contents }
+
+  text = File.read(File.join(File.dirname(__FILE__), 'init_templates/openstudio_module.rb'))
+  new_contents = text.gsub(/GEM_CLASS_NAME/, gem_class_name)
+  new_contents = new_contents.gsub(/GEM_NAME_UNDERSCORES/, gem_name_underscores_no_os)
+  File.open(File.join(full_dir_name, 'lib', 'openstudio', "#{gem_name_underscores_no_os}.rb"), 'w') { |file| file.puts new_contents }
+end

data/bin/console

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 
-require "bundler/setup"
-require "openstudio/extension"
+require 'bundler/setup'
+require 'openstudio/extension'
 
 # You can add fixtures and/or initialization code here to make experimenting
 # with your gem easier. You can also use a different console, if you like.
@@ -10,5 +10,5 @@ require "openstudio/extension"
 # require "pry"
 # Pry.start
 
-require "irb"
+require 'irb'
 IRB.start(__FILE__)

data/doc_templates/LICENSE.md

@@ -0,0 +1,27 @@
+OpenStudio(R), Copyright (c) 2008-2018, 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 HOLDERS AND 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, THE UNITED STATES GOVERNMENT, 
+OR ANY CONTRIBUTORS 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.