vector_number 0.4.0 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3958070d42eb34b2a76467cda30a4c33e90838a17211d06bf9088311f6cf82ee
-  data.tar.gz: 5308af739c073e2193ee8199a1118eef011e0aa552cbcceb6a8bae63f8c2da5d
+  metadata.gz: 9c128efe318fd49a1d70b41ec6556902cc765a96d3f329fcbd53b8e633aed64a
+  data.tar.gz: 807e3c711b0b78d5fbd543b459f4045eb43ca38afe5ec81ed6d9b92bdac18bf8
 SHA512:
-  metadata.gz: 515c092ebe57230a92fff99868ccf7fd929fcf9a2aa6d81b10918c68108010b55214bc88fef0112659b513623959c82fd6e8431fbaf16e1917e25d1b07a797a7
-  data.tar.gz: 9738e48084961b2ac7a6e02853ca30c37d736692ac14b3e49ac72f8adea3a31ebc72ea1751e474c57007ef1aa9d3663aa61a2de3ac3b937192c7ae7bd680a6e4
+  metadata.gz: ac7a1cbf596a4020d7b25507fdf68874cd2cded40e6d4a3f7be264612b490ab8f963e188de3130329c95d2c5d0a82af668b3a086a5bd45a8e5709de8ae909010
+  data.tar.gz: 523a6544edf0cbded5a13f76c3d128c2cbb972d20fbb6a59999e6f023878b56f851279b726ff44196c7a25c08f22896e63c1ee3424105f5fb5a3c055fabe88fd

data/README.md

@@ -1,17 +1,22 @@
 # VectorNumber
 
-> [!TIP]
-> You may be viewing documentation for an older (or newer) version of the gem.
-> Check badges below to see what the latest released version is.
-> Look at [Changelog](https://github.com/trinistr/vector_number/blob/main/CHANGELOG.md)
-> to see all versions, including unreleased changes!
-
-Latest: [![Gem Version](https://badge.fury.io/rb/vector_number.svg?icon=si%3Arubygems)](https://rubygems.org/gems/vector_number)
+[![Gem Version](https://badge.fury.io/rb/vector_number.svg?icon=si%3Arubygems)](https://rubygems.org/gems/vector_number)
 [![CI](https://github.com/trinistr/vector_number/actions/workflows/CI.yaml/badge.svg)](https://github.com/trinistr/vector_number/actions/workflows/CI.yaml)
 
+> [!TIP]
+> You may be viewing documentation for an older (or newer) version of the gem. Look at [Changelog](https://github.com/trinistr/dicey/blob/main/CHANGELOG.md) to see all versions, including unreleased changes.
+
 ***
 
-A library to add together anything: be it a number, string or random Object, it can be added together with math operations available on results in a real vector space, though some operations are modeled on hypercomplex numbers.
+VectorNumber is a Ruby gem that provides a Numeric-like experience for doing arithmetics on heterogeneous objects, with more advanced operations based on real vector spaces available when needed.
+
+Features:
+- [Add and subtract](#basics) (almost) any object, with no setup or declaration.
+- [Multiply and divide](#basics) vectors by any real number to create 1.35 of an array and -2 of a string. What does that mean? Only you know!
+- [Use vectors instead of inbuilt numbers](#numerical-behavior) in most situtations with no difference in behavior. Or, use familiar methods from numerics with sane semantics!
+- [Enumerate vectors in a hash-like fashion](#enumeration-and-hash-like-behavior), or transform to an array or hash as needed.
+- Enjoy a mix of vector-, complex- and polynomial-like behavior at appropriate times.
+- No dependencies, no extensions. It just works!
 
 Similar projects:
 - [vector_space](https://github.com/tomstuart/vector_space) aims to provide typed vector spaces with limited dimensions and nice formatting;
@@ -20,11 +25,23 @@ Similar projects:
 
 However, none of them have been updated in *years*.
 
-## Installation
+## Table of contents
 
-VectorNumber does not have any dependencies and does not include extensions.
+- [Installation](#installation)
+  - [Ruby engine support status](#ruby-engine-support-status)
+- [Usage](#usage)
+  - [Basics](#basics)
+  - [(Somewhat) advanced usage](#somewhat-advanced-usage)
+    - [Frozenness](#frozenness)
+    - [Numerical behavior](#numerical-behavior)
+    - [Enumeration and hash-like behavior](#enumeration-and-hash-like-behavior)
+- [Development](#development)
+- [Contributing](#contributing)
+- [License](#license)
 
-Install with `gem` (available from [0.2.4](https://github.com/trinistr/vector_number/tree/v0.2.4)):
+## Installation
+
+Install with `gem`:
 ```sh
 gem install vector_number
 ```
@@ -34,52 +51,100 @@ If using Bundler, add gem to your Gemfile:
 gem "vector_number"
 ```
 
+### Ruby engine support status
+
+VectorNumber is developed on MRI (CRuby) but should work on other engines too.
+- TruffleRuby: there are some minor differences in behavior, but otherwise works as expected.
+- JRuby: significant problems, but may work, currently not tested.
+- Other engines: untested, but should work, depending on compatibility with MRI.
+
 ## Usage
 
-Usage is pretty simple and intuitive:
-```ruby
-require "vector_number"
-VectorNumber["string"] + "str" # => (1⋅'string' + 1⋅'str')
-VectorNumber[5] + VectorNumber["string"] - 0.5 # => (4.5 + 1⋅'string')
-VectorNumber["string", "string", "string", "str"] # => (3⋅'string' + 1⋅'str')
-VectorNumber[:s] * 2 + VectorNumber["string"] * 0.3 # => (2⋅s + 0.3⋅'string')
-VectorNumber[:s] / 3 # => (1/3⋅s)
-1/3r * VectorNumber[[]] # => (1/3⋅[])
-```
+> [!Note]
+> - Latest API documentation from `main` branch is automatically deployed to [GitHub Pages](https://trinistr.github.io/vector_number).
+> - Documentation for published versions is available on [RubyDoc](https://rubydoc.info/gems/vector_number).
+
+### Basics
 
-VectorNumbers are mostly useful for summing up heterogeneous objects:
+VectorNumbers are mostly useful for tallying up heterogeneous objects:
 ```ruby
-sum = VectorNumber[]
-[4, "death", "death", 13, nil].each { sum = sum + _1 }
+sum = [4, "death", "death", 13, nil].reduce(VectorNumber[], :+)
 sum # => (17 + 2⋅'death' + 1⋅)
-sum.to_a # => [[1, 17], ["death", 2], [nil, 1]]
 sum.to_h # => {1=>17, "death"=>2, nil=>1}
-```
+sum.to_a # => [[1, 17], ["death", 2], [nil, 1]]
 
-Alternatively, the same result can be equivalently (and more efficiently) achieved by
-passing all values to a constructor:
-```ruby
+# Alternatively, the same result can be equivalently (and more efficiently)
+# achieved by passing all values to a constructor:
 VectorNumber[4, "death", "death", 13, nil]
 VectorNumber.new([4, "death", "death", 13, nil])
 ```
 
-## Ruby engine support status
+Doing arithmetic with vectors is simple and intuitive:
+```ruby
+VectorNumber["string"] + "string" # => (2⋅'string')
+VectorNumber["string"] - "str" # => (1⋅'string' - 1⋅'str')
+VectorNumber[5] + VectorNumber["string"] - 0.5 # => (4.5 + 1⋅'string')
+VectorNumber["string", "string", "string", "str"] # => (3⋅'string' + 1⋅'str')
+# Multiply and divide by any real number:
+VectorNumber[:s] * 2 + VectorNumber["string"] * 0.3 # => (2⋅s + 0.3⋅'string')
+VectorNumber[:s] / VectorNumber[3] # => (1/3⋅s)
+# Multiplication even works when the left operand is a regular number:
+1/3r * VectorNumber[[]] # => (1/3⋅[])
+```
 
-VectorNumber is developed on MRI (CRuby) but should work on other engines too.
-- TruffleRuby: works as expected, but there are differences in core Ruby code, so some tests fail.
-- JRuby: significant problems, but may work, currently not tested.
-- Other engines: untested, but should work, depending on compatibility.
+### (Somewhat) advanced usage
+
+> [!TIP]
+> Look at [API documentation](https://rubydoc.info/gems/vector_number) for all methods.
+
+#### Frozenness
+VectorNumbers are always frozen, as a number should be. However, they hold references to units (keys), which aren't frozen or duplicated. It is the user's responsibility to ensure that keys aren't mutated, the same as it is for Hash.
+
+As vectors are immutable, `+@`, `dup` and `clone` return the same instance.
+
+#### Numerical behavior
+VectorNumbers implement most of the methods you can find in `Numeric`, with appropriate behavior. For example:
+- `abs` (`magnitude`) calculates length of the vector;
+- `infinite?` checks whether any coefficient is infinite (or NaN), in the same way as `Complex` does it;
+- `positive?` is true if all coefficients are positive, the same for `negative?` (though this is different from `Complex`) (and they can both be false);
+- `round` and friends round each coefficient, with all the bells and whistles;
+- `div` and `%` perform division and remainder operations elementwise;
+- `5 < VectorNumber[6]` returns `true` and `5 < VectorNumber["string"]` raises `ArgumentError`, etc.
+
+VectorNumbers, if only consisting of a real number, can mostly be used interchangeably with core numbers due to `coerce` and conversion (`to_i`, etc.) methods. They can even be used as array indices! Due to including `Comparable`, they can also participate in comparison and sorting.
+
+#### Enumeration and Hash-like behavior
+VectorNumbers implement `each` (`each_pair`) in the same way as Hash does, allowing `Enumerable` methods to be used in a familiar way.
+
+There are also the usual `[]`, `unit?` (`key?`), `units` (`keys`), `coefficients` (`values`) methods. `to_h` and `to_a` can be used if a regular Hash or Array is needed.
+
+> [!NOTE]
+> Be aware that `[]` always returns `0` for "missing" units. `unit?` will return `false` for them.
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests, `rake rubocop` to check code, `rake steep` to check typing or just `rake` to do everything. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+After checking out the repo, run `bundle install` to install dependencies. Then, run `rake spec` to run the tests, `rake rubocop` to lint code and check style compliance, `rake rbs` to validate signatures or just `rake` to do everything above. There is also `rake steep` to check typing, and `rake docs` to generate YARD documentation.
+
+You can also run `bin/console` for an interactive prompt that will allow you to experiment, or `bin/benchmark` to run a benchmark script and generate a StackProf flamegraph.
+
+To install this gem onto your local machine, run `rake install`.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, change Next version in `CHANGELOG.md`, commit changes and tag the commit. Alternatively, an appropriate `rake bump:{major|minor|patch}` command can be used.
+To release a new version, run `rake version:{major|minor|patch}`, and then run `rake release`, which will build the package and push the `.gem` file to [rubygems.org](https://rubygems.org). After that, push the release commit and tags to the repository with `git push --follow-tags`.
 
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at [https://github.com/trinistr/vector_number]().
 
+### Checklist for a new or updated feature
+
+- Running `rake spec` reports 100% coverage (unless it's impossible to achieve in one run).
+- Running `rake rubocop` reports no offenses.
+- Running `rake steep` reports no new warnings or errors.
+- Tests cover the behavior and its interactions. 100% coverage *is not enough*, as it does not guarantee that all code paths are tested.
+- Documentation is up-to-date: generate it with `rake docs` and read it.
+- "*CHANGELOG.md*" lists the change if it has impact on users.
+- "*README.md*" is updated if the feature should be visible there.
+
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+This gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT), see [LICENSE.txt](https://github.com/trinistr/vector_number/blob/main/LICENSE.txt).

data/lib/vector_number/comparing.rb

@@ -45,6 +45,7 @@ class VectorNumber
     #
     # Values are considered equal only if +other+ is a VectorNumber
     # and it has exactly the same units and coefficients, though possibly in a different order.
+    # Additionally, `a.eql?(b)` implies `a.hash == b.hash`.
     #
     # Note that {#options} are not considered for equality.
     #
@@ -69,6 +70,22 @@ class VectorNumber
       end
     end
 
+    # Generate an Integer hash value for self.
+    #
+    # Hash values are stable during runtime, but not between processes.
+    #
+    # @example
+    #   VectorNumber["b", "a"].hash # => 3081872088394655324
+    #   VectorNumber["a", "b", mult: :cross].hash # => 3081872088394655324
+    #   VectorNumber["b", "c"].hash # => -1002381358514682371
+    #
+    # @return [Integer]
+    #
+    # @since 0.4.2
+    def hash
+      [self.class, @data].hash
+    end
+
     # Compare to +other+ and return -1, 0, or 1
     # if +self+ is less than, equal, or larger than +other+.
     #

data/lib/vector_number/math_converting.rb

@@ -111,9 +111,11 @@ class VectorNumber
           else :half_up
           end
         new { _1.is_a?(BigDecimal) ? _1.round(digits, bd_mode) : _1.round(digits, half:) }
+      # :nocov:
       else
         new { _1.round(digits, half:) }
       end
+      # :nocov:
     end
   end
 end

data/lib/vector_number/version.rb

@@ -2,5 +2,5 @@
 
 class VectorNumber
   # @return [String]
-  VERSION = "0.4.0"
+  VERSION = "0.4.2"
 end

data/sig/vector_number.rbs

@@ -208,6 +208,8 @@ class VectorNumber
 
     def eql?: (in_value_type other) -> bool
 
+    def hash: () -> Integer
+
     def <=>: (in_value_type other) -> Integer?
   end
 

metadata

@@ -1,26 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: vector_number
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.2
 platform: ruby
 authors:
 - Alexandr Bulancov
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-07-07 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
-description:
-email:
+description: |
+  VectorNumber provides a Numeric-like experience for doing arithmetics on heterogeneous objects, with more advanced operations based on real vector spaces available when needed.
+
+  Features:
+  - Add and subtract (almost) any object, with no setup or declaration.
+  - Multiply and divide vectors by any real number to create 1.35 of an array and -2 of a string. What does that mean? Only you know!
+  - Use vectors instead of inbuilt numbers in most situtations with no difference in behavior. Or, use familiar methods from numerics with sane semantics!
+  - Enumerate vectors in a hash-like fashion, or transform to an array or hash as needed.
+  - Enjoy a mix of vector-, complex- and polynomial-like behavior at appropriate times.
+  - No dependencies, no extensions. It just works!
 executables: []
 extensions: []
 extra_rdoc_files:
 - README.md
-- CHANGELOG.md
-- LICENSE.txt
 files:
-- CHANGELOG.md
-- LICENSE.txt
 - README.md
 - lib/vector_number.rb
 - lib/vector_number/comparing.rb
@@ -39,16 +42,13 @@ licenses:
 metadata:
   homepage_uri: https://github.com/trinistr/vector_number
   bug_tracker_uri: https://github.com/trinistr/vector_number/issues
-  documentation_uri: https://rubydoc.info/gems/vector_number/0.4.0
-  source_code_uri: https://github.com/trinistr/vector_number/tree/v0.4.0
-  changelog_uri: https://github.com/trinistr/vector_number/blob/v0.4.0/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/vector_number/0.4.2
+  source_code_uri: https://github.com/trinistr/vector_number/tree/v0.4.2
+  changelog_uri: https://github.com/trinistr/vector_number/blob/v0.4.2/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options:
 - "--main"
 - README.md
-- "--files"
-- CHANGELOG.md,LICENSE.txt
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
@@ -62,8 +62,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
-summary: A library to add together anything.
+summary: Add, subtract and do math with any objects
 test_files: []

data/CHANGELOG.md

@@ -1,162 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Next]
-## [v0.4.0] — 2025-07-07
-
-**Changed**
-- [🍄 BREAKING] Change `R` and `I` constants to be `1` and `2` instead of `0i` and `1i` respectively.
-   Their values are still semi-private and should not be relied on.
-- [🍄 BREAKING] Calling `new` with an unsupported value now raises `ArgumentError` instead of treating it like air.
-- Optimize various initialization paths. It is now 1.5-2.5 times faster, depending on arguments.
-- [🚀 CI] Disable JRuby testing on CI.
-
-[Compare v0.3.1...main](https://github.com/trinistr/vector_number/compare/v0.3.1...main)
-
-## [v0.3.1] — 2025-06-21
-
-This is mostly a documentation update with a side of improved gemspec.
-
-**Changed**
-- Improve method documentation and unify documentation style across the board.
-- Improve gemspec:
-  - change source code and changelog links to point to a tagged commit;
-  - add links to bugtracker and documentation (for appropriate version);
-  - properly add CHANGELOG.md to doc generation.
-- Improve documentation for NumericRefinements to include examples and more info.
-- `#dup` is now an alias of `#+@` with no change in function.
-- `#abs` is now calculated from `#abs2` instead of the other way around to reduce errors.
-
-**Fixed**
-- Correct broken changelog link in gem metadata.
-
-[Compare v0.3.0...v0.3.1](https://github.com/trinistr/vector_number/compare/v0.3.0...v0.3.1)
-
-## [v0.3.0] — 2025-05-12
-
-**Added**
-- Add aliases to other operators:
-   `#neg` for `#-@`, `#add` for `#+`, `#sub` for `#-`, `#mult` for `#*`.
-   `#+@` was already practically aliased by `#dup`.
-
-**Changed**
-- [🍄 BREAKING] Long-existing but broken options feature is now fixed.
-   When creating new vector through any operation, participating vector's options
-   are copied to the new one. When several vectors are present, only first one matters.
-- Both `#+@` and `#dup` are now aliases of `#itself` instead of full methods.
-- [🚀 CI] "CI" workflow now reports status of all checks,
-   excluding allowed-to-fail workflows (currently JRuby and TruffleRuby).
-
-[Compare v0.2.6...v0.3.0](https://github.com/trinistr/vector_number/compare/v0.2.6...v0.3.0)
-
-## [v0.2.6] — 2025-04-30
-
-**Added**
-- Add `#div`, `#%` (aliased as `#modulo`), `#divmod` and `#remainder` methods.
-- Add `#quo` alias to `#/`.
-
-**Fixed**
-- `#/`, `#fdiv` as well as new division methods now properly check for division by zero.
-   VectorNumber does not support this as not all Numeric classes do.
-
-**Changed**
-- [🚀 CI] Add Ruby 3.4 to CI.
-
-[Compare v0.2.5...v0.2.6](https://github.com/trinistr/vector_number/compare/v0.2.5...v0.2.6)
-
-## [v0.2.5] — 2025-02-26
-
-Technical update after release to rubygems.org.
-README was updated to reflect this change.
-
-[Compare v0.2.4...v0.2.5](https://github.com/trinistr/vector_number/compare/v0.2.4...v0.2.5)
-
-## [v0.2.4] — 2025-02-26
-
-**Added**
-- Add hash-like methods `#[]` and `#unit?` (aliased as `#key?`).
-
-**Changed**
-- [🍄 BREAKING] Change `positive?` and `negative?` to no longer return `nil`
-   when number is neither strictly positive or negative,
-   these cases will now return `false`.
-- Make `VectorNumber.new` accept options when initializing from a VectorNumber
-   instead of only copying. Options will be merged.
-- Remove `Initializing` module, move its methods to the actual class.
-- Update development gems' versions.
-
-**Fixed**
-- `#dup` and `#clone` now behave exactly like Numeric versions, preventing unfreezing.
-
-[Compare v0.2.3...v0.2.4](https://github.com/trinistr/vector_number/compare/v0.2.3...v0.2.4)
-
-## [v0.2.3] — 2024-10-15
-
-**Fixed**
-- BigDecimal tests are now properly skipped when BigDecimal is not available, instead of always.
-
-[Compare v0.2.2...v0.2.3](https://github.com/trinistr/vector_number/compare/v0.2.2...v0.2.3)
-
-## [v0.2.2] — 2024-10-07
-
-**Added**
-- Add `#abs` (aliased as `#magnitude`) and `#abs2`.
-- Add `#ceil`, `#floor` and `#round`.
-
-**Changed**
-- [🚀 CI] Add ruby 3.1.0, covering the earliest supported version, and ruby-next (3.4) to CI.
-- [🚀 CI] Add JRuby and TruffleRuby to CI, without full support.
-- [🚀 CI] Make tests runnable even without available `bigdecimal` gem.
-
-**Fixed**
-- `Kernel#BigDecimal` refinement now correctly works without `ndigits` argument.
-
-[Compare v0.2.1...v0.2.2](https://github.com/trinistr/vector_number/compare/v0.2.1...v0.2.2)
-
-## [v0.2.1] — 2024-08-24
-
-**Added**
-- Add `#*` and `#/` for working with real numbers.
-- Add `#fdiv`, `#truncate`, `#nonnumeric?` and `#integer?`.
-
-**Changed**
-- Allow to use fully real VectorNumbers as real numbers.
-
-**Fixed**
-- Fix reversed result in refined `#<=>`.
-
-**Removed**
-- Remove `#to_str`, as VectorNumber is not a String-like object.
-- Due to the above, `Kernel.BigDecimal` no longer works without refinements.
-
-[Compare v0.2.0...v0.2.1](https://github.com/trinistr/vector_number/compare/v0.2.0...v0.2.1)
-
-## [v0.2.0] — 2024-08-19
-
-**Added**
-- VectorNumbers can be created from any object or collection.
-- Addition and subtraction are supported.
-- VectorNumbers are mostly interoperable with core numbers.
-
-[Compare v0.1.0...v0.2.0](https://github.com/trinistr/vector_number/compare/v0.1.0...v0.2.0)
-
-## [v0.1.0] — 2024-05-09
-
-- Initial work.
-
-[Next]: https://github.com/trinistr/vector_number/tree/main
-[v0.3.1]: https://github.com/trinistr/vector_number/tree/v0.3.1
-[v0.3.0]: https://github.com/trinistr/vector_number/tree/v0.3.0
-[v0.2.6]: https://github.com/trinistr/vector_number/tree/v0.2.6
-[v0.2.5]: https://github.com/trinistr/vector_number/tree/v0.2.5
-[v0.2.4]: https://github.com/trinistr/vector_number/tree/v0.2.4
-[v0.2.3]: https://github.com/trinistr/vector_number/tree/v0.2.3
-[v0.2.2]: https://github.com/trinistr/vector_number/tree/v0.2.2
-[v0.2.1]: https://github.com/trinistr/vector_number/tree/v0.2.1
-[v0.2.0]: https://github.com/trinistr/vector_number/tree/v0.2.0
-[v0.1.0]: https://github.com/trinistr/vector_number/tree/v0.1.0
-[🚀 CI]: https://github.com/trinistr/vector_number/actions/workflows/CI.yaml

data/LICENSE.txt

@@ -1,21 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) 2024-2025 Alexandr Bulancov
-
-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.