RubyGems - dentaku_zevo - Versions diffs - 3.5.2 - Mend

dentaku_zevo 3.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (123) hide show

checksums.yaml +7 -0
data/.gitignore +14 -0
data/.pryrc +2 -0
data/.rubocop.yml +114 -0
data/.travis.yml +10 -0
data/CHANGELOG.md +281 -0
data/Gemfile +4 -0
data/LICENSE +21 -0
data/README.md +342 -0
data/Rakefile +31 -0
data/dentaku.gemspec +32 -0
data/lib/dentaku/ast/access.rb +47 -0
data/lib/dentaku/ast/arithmetic.rb +241 -0
data/lib/dentaku/ast/array.rb +41 -0
data/lib/dentaku/ast/bitwise.rb +42 -0
data/lib/dentaku/ast/case/case_conditional.rb +38 -0
data/lib/dentaku/ast/case/case_else.rb +35 -0
data/lib/dentaku/ast/case/case_switch_variable.rb +35 -0
data/lib/dentaku/ast/case/case_then.rb +35 -0
data/lib/dentaku/ast/case/case_when.rb +39 -0
data/lib/dentaku/ast/case.rb +81 -0
data/lib/dentaku/ast/combinators.rb +50 -0
data/lib/dentaku/ast/comparators.rb +89 -0
data/lib/dentaku/ast/datetime.rb +8 -0
data/lib/dentaku/ast/function.rb +56 -0
data/lib/dentaku/ast/function_registry.rb +98 -0
data/lib/dentaku/ast/functions/all.rb +23 -0
data/lib/dentaku/ast/functions/and.rb +25 -0
data/lib/dentaku/ast/functions/any.rb +23 -0
data/lib/dentaku/ast/functions/avg.rb +13 -0
data/lib/dentaku/ast/functions/count.rb +26 -0
data/lib/dentaku/ast/functions/duration.rb +51 -0
data/lib/dentaku/ast/functions/enum.rb +37 -0
data/lib/dentaku/ast/functions/filter.rb +23 -0
data/lib/dentaku/ast/functions/if.rb +51 -0
data/lib/dentaku/ast/functions/map.rb +23 -0
data/lib/dentaku/ast/functions/max.rb +5 -0
data/lib/dentaku/ast/functions/min.rb +5 -0
data/lib/dentaku/ast/functions/mul.rb +12 -0
data/lib/dentaku/ast/functions/not.rb +5 -0
data/lib/dentaku/ast/functions/or.rb +25 -0
data/lib/dentaku/ast/functions/pluck.rb +30 -0
data/lib/dentaku/ast/functions/round.rb +5 -0
data/lib/dentaku/ast/functions/rounddown.rb +8 -0
data/lib/dentaku/ast/functions/roundup.rb +8 -0
data/lib/dentaku/ast/functions/ruby_math.rb +55 -0
data/lib/dentaku/ast/functions/string_functions.rb +212 -0
data/lib/dentaku/ast/functions/sum.rb +12 -0
data/lib/dentaku/ast/functions/switch.rb +8 -0
data/lib/dentaku/ast/functions/xor.rb +44 -0
data/lib/dentaku/ast/grouping.rb +23 -0
data/lib/dentaku/ast/identifier.rb +52 -0
data/lib/dentaku/ast/literal.rb +30 -0
data/lib/dentaku/ast/logical.rb +8 -0
data/lib/dentaku/ast/negation.rb +54 -0
data/lib/dentaku/ast/nil.rb +13 -0
data/lib/dentaku/ast/node.rb +28 -0
data/lib/dentaku/ast/numeric.rb +8 -0
data/lib/dentaku/ast/operation.rb +39 -0
data/lib/dentaku/ast/string.rb +15 -0
data/lib/dentaku/ast.rb +39 -0
data/lib/dentaku/bulk_expression_solver.rb +128 -0
data/lib/dentaku/calculator.rb +169 -0
data/lib/dentaku/date_arithmetic.rb +45 -0
data/lib/dentaku/dependency_resolver.rb +24 -0
data/lib/dentaku/exceptions.rb +102 -0
data/lib/dentaku/flat_hash.rb +38 -0
data/lib/dentaku/parser.rb +349 -0
data/lib/dentaku/print_visitor.rb +101 -0
data/lib/dentaku/string_casing.rb +7 -0
data/lib/dentaku/token.rb +36 -0
data/lib/dentaku/token_matcher.rb +138 -0
data/lib/dentaku/token_matchers.rb +29 -0
data/lib/dentaku/token_scanner.rb +183 -0
data/lib/dentaku/tokenizer.rb +110 -0
data/lib/dentaku/version.rb +3 -0
data/lib/dentaku/visitor/infix.rb +82 -0
data/lib/dentaku.rb +69 -0
data/spec/ast/addition_spec.rb +62 -0
data/spec/ast/all_spec.rb +25 -0
data/spec/ast/and_function_spec.rb +35 -0
data/spec/ast/and_spec.rb +32 -0
data/spec/ast/any_spec.rb +23 -0
data/spec/ast/arithmetic_spec.rb +91 -0
data/spec/ast/avg_spec.rb +37 -0
data/spec/ast/case_spec.rb +84 -0
data/spec/ast/comparator_spec.rb +87 -0
data/spec/ast/count_spec.rb +40 -0
data/spec/ast/division_spec.rb +35 -0
data/spec/ast/filter_spec.rb +25 -0
data/spec/ast/function_spec.rb +69 -0
data/spec/ast/map_spec.rb +27 -0
data/spec/ast/max_spec.rb +33 -0
data/spec/ast/min_spec.rb +33 -0
data/spec/ast/mul_spec.rb +43 -0
data/spec/ast/negation_spec.rb +48 -0
data/spec/ast/node_spec.rb +43 -0
data/spec/ast/numeric_spec.rb +16 -0
data/spec/ast/or_spec.rb +35 -0
data/spec/ast/pluck_spec.rb +32 -0
data/spec/ast/round_spec.rb +35 -0
data/spec/ast/rounddown_spec.rb +35 -0
data/spec/ast/roundup_spec.rb +35 -0
data/spec/ast/string_functions_spec.rb +217 -0
data/spec/ast/sum_spec.rb +43 -0
data/spec/ast/switch_spec.rb +30 -0
data/spec/ast/xor_spec.rb +35 -0
data/spec/benchmark.rb +70 -0
data/spec/bulk_expression_solver_spec.rb +201 -0
data/spec/calculator_spec.rb +898 -0
data/spec/dentaku_spec.rb +52 -0
data/spec/exceptions_spec.rb +9 -0
data/spec/external_function_spec.rb +106 -0
data/spec/parser_spec.rb +166 -0
data/spec/print_visitor_spec.rb +66 -0
data/spec/spec_helper.rb +71 -0
data/spec/token_matcher_spec.rb +134 -0
data/spec/token_scanner_spec.rb +49 -0
data/spec/token_spec.rb +16 -0
data/spec/tokenizer_spec.rb +359 -0
data/spec/visitor/infix_spec.rb +31 -0
data/spec/visitor_spec.rb +138 -0
metadata +335 -0

checksums.yaml ADDED Viewed

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d7c9f8852e6d9afdac9c55605bade0c06e0eab6f4e6abd86fcabe64ed839b6b1
+  data.tar.gz: 3ebbbf999b825dcd7fba39045756bb52745588e6b4c1148eb232ea2a28270f39
+SHA512:
+  metadata.gz: 614f78757cef069932968d4a37a13ba1360875a34bea99df90ae2808ffe776180b976e54bf4ec6d84aa347a8731ec212c49476e800dc1a372d16645f7b7f3421
+  data.tar.gz: 8f86743fbd6f6363fa14dd30886e37446d791212a8b9d28bda0f7c79a3c16fa8e5453a762e99d00b9704c9f45591dc52926afccd73c9e0906b8bcd633434c412

data/.gitignore ADDED Viewed

@@ -0,0 +1,14 @@
+*.gem
+.bundle
+.rbenv-version
+Gemfile.lock
+bin/*
+pkg/*
+vendor/*
+/.ruby-gemset
+/.ruby-version
+/.rspec
+.byebug_history
+coverage

data/.pryrc ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ require "bundler"
2	+ Bundler.require

data/.rubocop.yml ADDED Viewed

@@ -0,0 +1,114 @@
+AllCops:
+  TargetRubyVersion: 2.6
+  # RuboCop has a bunch of cops enabled by default. This setting tells RuboCop
+  # to ignore them, so only the ones explicitly set in this file are enabled.
+  DisabledByDefault: true
+# Prefer &&/|| over and/or.
+Style/AndOr:
+  Enabled: true
+# Align `when` with `case`.
+Layout/CaseIndentation:
+  Enabled: true
+# Align comments with method definitions.
+Layout/CommentIndentation:
+  Enabled: true
+# No extra empty lines.
+Layout/EmptyLines:
+  Enabled: true
+# In a regular class definition, no empty lines around the body.
+Layout/EmptyLinesAroundClassBody:
+  Enabled: true
+# In a regular method definition, no empty lines around the body.
+Layout/EmptyLinesAroundMethodBody:
+  Enabled: true
+# In a regular module definition, no empty lines around the body.
+Layout/EmptyLinesAroundModuleBody:
+  Enabled: true
+# Use Ruby >= 1.9 syntax for hashes. Prefer { a: :b } over { :a => :b }.
+Style/HashSyntax:
+  Enabled: true
+# Method definitions after `private` or `protected` isolated calls need one
+# extra level of indentation.
+Layout/IndentationConsistency:
+  Enabled: false
+# Two spaces, no tabs (for indentation).
+Layout/IndentationWidth:
+  Enabled: true
+Layout/SpaceAfterColon:
+  Enabled: true
+Layout/SpaceAfterComma:
+  Enabled: true
+Layout/SpaceAroundEqualsInParameterDefault:
+  Enabled: true
+Layout/SpaceAroundKeyword:
+  Enabled: true
+Layout/SpaceAroundOperators:
+  Enabled: true
+Layout/SpaceBeforeFirstArg:
+  Enabled: true
+# Defining a method with parameters needs parentheses.
+Style/MethodDefParentheses:
+  Enabled: true
+# Use `foo {}` not `foo{}`.
+Layout/SpaceBeforeBlockBraces:
+  Enabled: true
+# Use `foo { bar }` not `foo {bar}`.
+Layout/SpaceInsideBlockBraces:
+  Enabled: true
+# Use `{a: 1}` not `{ a:1 }`.
+Layout/SpaceInsideHashLiteralBraces:
+  Enabled: false
+Layout/SpaceInsideParens:
+  Enabled: true
+# Check quotes usage according to lint rule below.
+Style/StringLiterals:
+  Enabled: false
+  EnforcedStyle: double_quotes
+# Detect hard tabs, no hard tabs.
+Layout/IndentationStyle:
+  Enabled: true
+# Blank lines should not have any spaces.
+Layout/TrailingEmptyLines:
+  Enabled: true
+# No trailing whitespace.
+Layout/TrailingWhitespace:
+  Enabled: true
+# Use quotes for string literals when they are enough.
+Style/RedundantPercentQ:
+  Enabled: true
+# Align `end` with the matching keyword or starting expression except for
+# assignments, where it should be aligned with the LHS.
+Layout/EndAlignment:
+  Enabled: true
+  EnforcedStyleAlignWith: variable
+# Use my_method(my_arg) not my_method( my_arg ) or my_method my_arg.
+Lint/RequireParentheses:
+  Enabled: true

data/.travis.yml ADDED Viewed

@@ -0,0 +1,10 @@
+language: ruby
+sudo: false
+rvm:
+  - 2.5.9
+  - 2.6.7
+  - 2.7.3
+  - 3.0.1
+before_install:
+  - gem update bundler
+  - gem update --system

data/CHANGELOG.md ADDED Viewed

@@ -0,0 +1,281 @@
+# Change Log
+## [v3.5.2]
+- handle floating point multiply
+## [v3.5.1]
+- add bitwise shift left and shift right operators
+- improve numeric conversions
+- improve parse exceptions
+- improve bitwise exceptions
+- include variable name in bulk expression exceptions
+## [v3.5.0]
+- fix bug with function argument count
+- add XOR operator
+- make function args publicly accessible
+- better argument handling for collection functions
+- better dependency reporting for collection functions
+- allow ruby math-backed functions to be serialized
+- improve scientific notation handling
+- improve comparator argument errors
+- respect case sensitivity in nested case statments
+- add visitor pattern
+## [v3.4.2]
+- add FILTER function
+- add concurrent-ruby dependency to make global calculator object thread safe
+- add Ruby 3 support
+- allow formulas to access intermediate context values
+- fix incorrect Ruby Math function return type
+- fix context mutation bug
+- fix dependency resolution bug
+## [v3.4.1] 2020-12-12
+- prevent extra evaluations in bulk expression solver
+## [v3.4.0] 2020-12-07
+- allow access to intermediate values of flattened hashes
+- catch invalid array syntax in the parse phase
+- drop support for Ruby < 2.5, add support for Ruby 2.7
+- add support for subtracting date literals
+- improve error handling
+- improve math function implementation
+- add caching for calculated variable values
+- allow custom unbound variable handling block at Dentaku module level
+- add enum functions `ANY`, `ALL`, `MAP` and `PLUCK`
+- allow self-referential formulas in bulk expression solver
+- misc internal fixes and enhancements
+## [v3.3.4] 2019-11-21
+- bugfix release
+## [v3.3.3] 2019-11-20
+- date / duration addition and subtraction
+- validate arity for custom functions with variable arity
+- make AST serializable with Marshal.dump
+- performance optimization for arithmetic node validation
+- support lazy evaluation for expensive values
+- short-circuit IF function
+- better error when empty string is used in arithmetic operation
+## [v3.3.2] 2019-06-10
+- add ability to pre-load AST cache
+- fix negation node bug
+## [v3.3.1] 2019-03-26
+- better errors for parse failures and exceptions in internal functions
+- fix Ruby 2.6.0 deprecation warnings
+- fix issue with functions in nested case statements
+## [v3.3.0] 2018-12-04
+- add array literal syntax
+- return correct type from string function AST nodes
+## [v3.2.1] 2018-10-24
+- make `evaluate` rescue more exceptions
+## [v3.2.0] 2018-03-14
+- add `COUNT` and `AVG` functions
+- add unicode support 😎
+- fix CASE parsing bug
+- allow dependency filtering based on context
+- add variadic MUL function
+- performance optimization
+## [v3.1.0] 2018-01-10
+- allow decimals with no leading zero
+- nested hash and array support in bulk expression solver
+- add a variadic SUM function
+- support array arguments to min, max, sum, and Math functions
+- add case-sensitive variable support
+- allow opt-out of nested data for performance boost
+## [v3.0.0] 2017-10-11
+- add && and || as aliases for AND and OR
+- add hexadecimal literal support
+- add the SWITCH function
+- add AND and OR functions
+- add array access
+- make UnboundVariableError show all missing values
+- cast inputs to numeric function to numeric
+- fix issue with zero-arity functions used as function args
+- fix division when context values contain one or more strings
+- drop Ruby 1.9 support
+## [v2.0.11] 2017-05-08
+- fix dependency checking for logical AST nodes
+- make `CONCAT` variadic
+- fix casting strings to numeric in negation operations
+- add date/time support
+- add `&` (bitwise and) and `|` (bitwise or) operators
+- fix incompatibility with 'mathn' module
+- add `CONTAINS` string function
+- allow storage of nested hashes in calculator memory
+- allow duck type arithmetic
+- fix error handling code to work with Ruby 2.4.0
+- allow calculators to store own registry of functions
+- add timezone support to time literals
+- optimizations
+## [v2.0.10] 2016-12-30
+- fix string function initialization bug
+- fix issues with CASE statements
+- allow injecting AST cache
+## [v2.0.9] 2016-09-19
+- namespace tokenization errors
+- automatically coerce arguments to string functions as strings
+- selectively disable or clear AST cache
+## [v2.0.8] 2016-05-10
+- numeric input validations
+- fail with gem-specific error for invalid arithmetic operands
+- add `LEFT`, `RIGHT`, `MID`, `LEN`, `FIND`, `SUBSTITUTE`, and `CONCAT` string functions
+## [v2.0.7] 2016-02-25
+- fail with gem-specific error for parsing issues
+- support NULL literals and nil variables
+- keep reference to variable that caused failure when bulk-solving
+## [v2.0.6] 2016-01-26
+- support array parameters for external functions
+- support case statements
+- support precision for `ROUNDUP` and `ROUNDDOWN` functions
+- prevent errors from corrupting calculator memory
+## [v2.0.5] 2015-09-03
+- fix bug with detecting unbound nodes
+- silence warnings
+- allow registration of custom token scanners
+## [v2.0.4] 2015-09-03
+- fix BigDecimal conversion bug
+- add caching for bulk expression solving dependency order
+- allow for custom configuration for token scanners
+## [v2.0.3] 2015-08-25
+- bug fixes
+- performance enhancements
+- code cleanup
+## [v2.0.1] 2015-08-15
+- add support for boolean literals
+- implement basic parse-time type checking
+## [v2.0.0] 2015-08-07
+- shunting-yard parser for performance enhancement and AST generation
+- AST caching for performance enhancement
+- support comments in formulas
+- support all functions from the Ruby Math module
+## [v1.2.6] 2015-05-30
+- support custom error handlers for systems of formulas
+## [v1.2.5] 2015-05-23
+- fix memory leak
+## [v1.2.2] 2014-12-19
+- performance enhancements
+- unary minus bug fixes
+- preserve provided hash keys for systems of formulas
+## [v1.2.0] 2014-10-21
+- add dependency resolution to automatically solve systems of formulas
+## [v1.1.0] 2014-07-30
+- add strict evaluation mode to raise `UnboundVariableError` if not all variable values are provided
+- return division results as `BigDecimal` values
+## [v1.0.0] 2014-03-06
+- cleanup and 1.0 release
+## [v0.2.14] 2014-01-24
+- add modulo operator
+- add unary percentage operator
+- support registration of custom functions at runtime
+## [v0.2.10] 2012-12-10
+- return integer result for exact division, decimal otherwise
+## [v0.2.9] 2012-10-17
+- add `ROUNDUP` / `ROUNDDOWN` functions
+## [v0.2.8] 2012-09-30
+- make function name matching case-insensitive
+## [v0.2.7] 2012-09-26
+- support passing arbitrary expressions as function arguments
+## [v0.2.6] 2012-09-19
+- add `NOT` function
+## [v0.2.5] 2012-06-20
+- add exponent operator
+- add support for digits in variable identifiers
+## [v0.2.4] 2012-02-29
+- add support for `min < x < max` syntax for inequality ranges
+## [v0.2.2] 2012-02-22
+- support `ROUND` to arbitrary decimal place on older Rubies
+- ensure case is preserved for string values
+## [v0.2.1] 2012-02-12
+- add `ROUND` function
+## [v0.1.3] 2012-01-31
+- add support for string datatype
+## [v0.1.1] 2012-01-24
+- change from square bracket to parentheses for top-level evaluation
+- add `IF` function
+## [v0.1.0] 2012-01-20
+- initial release
+[Unreleased]: https://github.com/rubysolo/dentaku/compare/v3.5.1...HEAD
+[v3.5.1]: https://github.com/rubysolo/dentaku/compare/v3.5.0...v3.5.1
+[v3.5.0]:  https://github.com/rubysolo/dentaku/compare/v3.4.2...v3.5.0
+[v3.4.2]:  https://github.com/rubysolo/dentaku/compare/v3.4.1...v3.4.2
+[v3.4.1]:  https://github.com/rubysolo/dentaku/compare/v3.4.0...v3.4.1
+[v3.4.0]:  https://github.com/rubysolo/dentaku/compare/v3.3.4...v3.4.0
+[v3.3.4]:  https://github.com/rubysolo/dentaku/compare/v3.3.3...v3.3.4
+[v3.3.3]:  https://github.com/rubysolo/dentaku/compare/v3.3.2...v3.3.3
+[v3.3.2]:  https://github.com/rubysolo/dentaku/compare/v3.3.1...v3.3.2
+[v3.3.1]:  https://github.com/rubysolo/dentaku/compare/v3.3.0...v3.3.1
+[v3.3.0]:  https://github.com/rubysolo/dentaku/compare/v3.2.1...v3.3.0
+[v3.2.1]:  https://github.com/rubysolo/dentaku/compare/v3.2.0...v3.2.1
+[v3.2.0]:  https://github.com/rubysolo/dentaku/compare/v3.1.0...v3.2.0
+[v3.1.0]:  https://github.com/rubysolo/dentaku/compare/v3.0.0...v3.1.0
+[v3.0.0]:  https://github.com/rubysolo/dentaku/compare/v2.0.11...v3.0.0
+[v2.0.11]:  https://github.com/rubysolo/dentaku/compare/v2.0.10...v2.0.11
+[v2.0.10]:  https://github.com/rubysolo/dentaku/compare/v2.0.9...v2.0.10
+[v2.0.9]:  https://github.com/rubysolo/dentaku/compare/v2.0.8...v2.0.9
+[v2.0.8]:  https://github.com/rubysolo/dentaku/compare/v2.0.7...v2.0.8
+[v2.0.7]:  https://github.com/rubysolo/dentaku/compare/v2.0.6...v2.0.7
+[v2.0.6]:  https://github.com/rubysolo/dentaku/compare/v2.0.5...v2.0.6
+[v2.0.5]:  https://github.com/rubysolo/dentaku/compare/v2.0.4...v2.0.5
+[v2.0.4]:  https://github.com/rubysolo/dentaku/compare/v2.0.3...v2.0.4
+[v2.0.3]:  https://github.com/rubysolo/dentaku/compare/v2.0.1...v2.0.3
+[v2.0.1]:  https://github.com/rubysolo/dentaku/compare/v2.0.0...v2.0.1
+[v2.0.0]:  https://github.com/rubysolo/dentaku/compare/v1.2.6...v2.0.0
+[v1.2.6]:  https://github.com/rubysolo/dentaku/compare/v1.2.5...v1.2.6
+[v1.2.5]:  https://github.com/rubysolo/dentaku/compare/v1.2.2...v1.2.5
+[v1.2.2]:  https://github.com/rubysolo/dentaku/compare/v1.2.0...v1.2.2
+[v1.2.0]:  https://github.com/rubysolo/dentaku/compare/v1.1.0...v1.2.0
+[v1.1.0]:  https://github.com/rubysolo/dentaku/compare/v1.0.0...v1.1.0
+[v1.0.0]:  https://github.com/rubysolo/dentaku/compare/v0.2.14...v1.0.0
+[v0.2.14]: https://github.com/rubysolo/dentaku/compare/v0.2.10...v0.2.14
+[v0.2.10]: https://github.com/rubysolo/dentaku/compare/v0.2.9...v0.2.10
+[v0.2.9]:  https://github.com/rubysolo/dentaku/compare/v0.2.8...v0.2.9
+[v0.2.8]:  https://github.com/rubysolo/dentaku/compare/v0.2.7...v0.2.8
+[v0.2.7]:  https://github.com/rubysolo/dentaku/compare/v0.2.6...v0.2.7
+[v0.2.6]:  https://github.com/rubysolo/dentaku/compare/v0.2.5...v0.2.6
+[v0.2.5]:  https://github.com/rubysolo/dentaku/compare/v0.2.4...v0.2.5
+[v0.2.4]:  https://github.com/rubysolo/dentaku/compare/v0.2.2...v0.2.4
+[v0.2.2]:  https://github.com/rubysolo/dentaku/compare/v0.2.1...v0.2.2
+[v0.2.1]:  https://github.com/rubysolo/dentaku/compare/v0.1.3...v0.2.1
+[v0.1.3]:  https://github.com/rubysolo/dentaku/compare/v0.1.1...v0.1.3
+[v0.1.1]:  https://github.com/rubysolo/dentaku/compare/v0.1.0...v0.1.1
+[v0.1.0]:  https://github.com/rubysolo/dentaku/commit/68724fd9c8fa637baf7b9d5515df0caa31e226bd

data/Gemfile ADDED Viewed

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+# Specify your gem's dependencies in dentaku.gemspec
+gemspec

data/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2012 Solomon White
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.