ruby-units 2.3.0 → 2.4.1

data/Gemfile.lock

@@ -0,0 +1,183 @@
+PATH
+  remote: .
+  specs:
+    ruby-units (2.4.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    backport (1.2.0)
+    benchmark (0.2.0)
+    coderay (1.1.3)
+    debug (1.6.2)
+      irb (>= 1.3.6)
+      reline (>= 0.3.1)
+    diff-lcs (1.5.0)
+    docile (1.4.0)
+    e2mmap (0.1.0)
+    ffi (1.15.5)
+    ffi (1.15.5-java)
+    formatador (1.1.0)
+    guard (2.18.0)
+      formatador (>= 0.2.4)
+      listen (>= 2.7, < 4.0)
+      lumberjack (>= 1.0.12, < 2.0)
+      nenv (~> 0.1)
+      notiffany (~> 0.0)
+      pry (>= 0.13.0)
+      shellany (~> 0.0)
+      thor (>= 0.18.1)
+    guard-compat (1.2.1)
+    guard-rspec (4.7.3)
+      guard (~> 2.1)
+      guard-compat (~> 1.1)
+      rspec (>= 2.99.0, < 4.0)
+    io-console (0.5.11)
+    irb (1.4.1)
+      reline (>= 0.3.0)
+    jaro_winkler (1.5.4)
+    jaro_winkler (1.5.4-java)
+    json (2.6.2)
+    json (2.6.2-java)
+    kramdown (2.4.0)
+      rexml
+    kramdown-parser-gfm (1.1.0)
+      kramdown (~> 2.0)
+    listen (3.7.1)
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
+    lumberjack (1.2.8)
+    method_source (1.0.0)
+    mini_portile2 (2.8.0)
+    nenv (0.3.0)
+    nokogiri (1.13.8)
+      mini_portile2 (~> 2.8.0)
+      racc (~> 1.4)
+    nokogiri (1.13.8-java)
+      racc (~> 1.4)
+    nokogiri (1.13.8-x86_64-darwin)
+      racc (~> 1.4)
+    notiffany (0.1.3)
+      nenv (~> 0.1)
+      shellany (~> 0.0)
+    parallel (1.22.1)
+    parser (3.1.2.1)
+      ast (~> 2.4.1)
+    pry (0.14.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    pry (0.14.1-java)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+      spoon (~> 0.0)
+    racc (1.6.0)
+    racc (1.6.0-java)
+    rainbow (3.1.1)
+    rake (13.0.6)
+    rb-fsevent (0.11.1)
+    rb-inotify (0.10.1)
+      ffi (~> 1.0)
+    redcarpet (3.5.1)
+    regexp_parser (2.5.0)
+    reline (0.3.1)
+      io-console (~> 0.5)
+    reverse_markdown (2.1.1)
+      nokogiri
+    rexml (3.2.5)
+    rspec (3.11.0)
+      rspec-core (~> 3.11.0)
+      rspec-expectations (~> 3.11.0)
+      rspec-mocks (~> 3.11.0)
+    rspec-core (3.11.0)
+      rspec-support (~> 3.11.0)
+    rspec-expectations (3.11.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.11.0)
+    rspec-mocks (3.11.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.11.0)
+    rspec-support (3.11.0)
+    rubocop (1.35.1)
+      json (~> 2.3)
+      parallel (~> 1.10)
+      parser (>= 3.1.2.1)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.20.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.21.0)
+      parser (>= 3.1.1.0)
+    rubocop-rake (0.6.0)
+      rubocop (~> 1.0)
+    rubocop-rspec (2.12.1)
+      rubocop (~> 1.31)
+    ruby-maven (3.3.13)
+      ruby-maven-libs (~> 3.3.9)
+    ruby-maven-libs (3.3.9)
+    ruby-prof (1.4.3)
+    ruby-progressbar (1.11.0)
+    shellany (0.0.1)
+    simplecov (0.21.2)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.12.3)
+    simplecov_json_formatter (0.1.4)
+    solargraph (0.46.0)
+      backport (~> 1.2)
+      benchmark
+      bundler (>= 1.17.2)
+      diff-lcs (~> 1.4)
+      e2mmap
+      jaro_winkler (~> 1.5)
+      kramdown (~> 2.3)
+      kramdown-parser-gfm (~> 1.1)
+      parser (~> 3.0)
+      reverse_markdown (>= 1.0.5, < 3)
+      rubocop (>= 0.52)
+      thor (~> 1.0)
+      tilt (~> 2.0)
+      yard (~> 0.9, >= 0.9.24)
+    spoon (0.0.6)
+      ffi
+    terminal-notifier (2.0.0)
+    terminal-notifier-guard (1.7.0)
+    thor (1.2.1)
+    tilt (2.0.11)
+    unicode-display_width (2.2.0)
+    webrick (1.7.0)
+    yard (0.9.28)
+      webrick (~> 1.7.0)
+
+PLATFORMS
+  java
+  ruby
+  universal-java-11
+  x86_64-darwin-19
+
+DEPENDENCIES
+  debug (>= 1.0.0)
+  guard-rspec
+  pry
+  rake
+  redcarpet
+  rspec (~> 3.0)
+  rubocop
+  rubocop-rake
+  rubocop-rspec
+  ruby-maven
+  ruby-prof
+  ruby-units!
+  simplecov
+  simplecov-html
+  solargraph
+  terminal-notifier
+  terminal-notifier-guard
+  webrick
+  yard
+
+BUNDLED WITH
+   2.3.13

data/Guardfile

@@ -0,0 +1,31 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+## Uncomment and set this to only include directories you want to watch
+directories %w[lib spec]
+
+## Uncomment to clear the screen before every task
+clearing :on
+
+# Note: The cmd option is now required due to the increasing number of ways
+#       rspec may be run, below are examples of the most common uses.
+#  * bundler: 'bundle exec rspec'
+#  * bundler binstubs: 'bin/rspec'
+#  * spring: 'bin/rspec' (This will use spring if running and you have
+#                          installed the spring binstubs per the docs)
+#  * zeus: 'zeus rspec' (requires the server to be started separately)
+#  * 'just' rspec: 'rspec'
+
+guard :rspec, cmd: 'bundle exec rspec' do
+  require 'ostruct'
+
+  # Generic Ruby apps
+  rspec = OpenStruct.new
+  rspec.spec = ->(m) { "spec/#{m}_spec.rb" }
+  rspec.spec_dir = 'spec'
+  rspec.spec_helper = 'spec/spec_helper.rb'
+
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| rspec.spec.call(m[1]) }
+  watch(rspec.spec_helper)      { rspec.spec_dir }
+end

data/LICENSE.txt

@@ -1,20 +1,21 @@
-Copyright (c) 2006-2012 Kevin C. Olbrich, Ph.D.
+The MIT License (MIT)
 
-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:
+Copyright (c) 2019 Kevin Olbrich
 
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
+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 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.
+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.

data/README.md

@@ -1,38 +1,45 @@
-Ruby Units
-==========
+# Ruby Units
 
-[![Build Status](https://secure.travis-ci.org/olbrich/ruby-units.png)](http://travis-ci.org/olbrich/ruby-units)
+[![Maintainability](https://api.codeclimate.com/v1/badges/4e858d14a07dd453f748/maintainability.svg)](https://codeclimate.com/github/olbrich/ruby-units/maintainability)
+[![CodeClimate Status](https://api.codeclimate.com/v1/badges/4e858d14a07dd453f748/test_coverage.svg)](https://codeclimate.com/github/olbrich/ruby-units/test_coverage)
+[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Folbrich%2Fruby-units.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2Folbrich%2Fruby-units?ref=badge_shield)
 
 Kevin C. Olbrich, Ph.D.
 
-Project page: [http://github.com/olbrich/ruby-units](http://github.com/olbrich/ruby-units)
+Project page:
+[http://github.com/olbrich/ruby-units](http://github.com/olbrich/ruby-units)
 
-Notes
------
+## Introduction
 
-This version removes 'mathn' as a dependency.  Mathn alters the behavior of some mathematical operators, which
-frequently causes unexpected behavior and can be a source of difficult to diagnose bugs.  Mathn is also scheduled to be removed from
-the Ruby standard library.
+Many technical applications make use of specialized calculations at some point.
+Frequently, these calculations require unit conversions to ensure accurate
+results. Needless to say, this is a pain to properly keep track of, and is prone
+to numerous errors.
 
-Introduction
-------------
+## Solution
 
-Many technical applications make use of specialized calculations at some point. Frequently, these calculations require unit conversions to ensure accurate results. Needless to say, this is a pain to properly keep track of, and is prone to numerous errors.
+The 'Ruby units' gem is designed to simplify the handling of units for
+scientific calculations. The units of each quantity are specified when a Unit
+object is created and the Unit class will handle all subsequent conversions and
+manipulations to ensure an accurate result.
 
-Solution
---------
+## Installation
 
-The 'Ruby units' gem is designed to simplify the handling of units for scientific calculations. The units of each quantity are specified when a Unit object is created and the Unit class will handle all subsequent conversions and manipulations to ensure an accurate result.
+This package may be installed using:
 
-Installation:
--------------
-
-This package may be installed using: `gem install ruby-units`
+```bash
+gem install ruby-units
+```
 
-Usage:
-------
+or add this to your `Gemfile`
 
+```ruby
+gem 'ruby-units'
 ```
+
+## Usage
+
+```ruby
 unit = Unit.new("1")                 # constant only
 unit = Unit.new("mm")                # unit only (defaults to a scalar of 1)
 unit = Unit.new("1 mm")              # create a simple unit
@@ -47,32 +54,32 @@ unit = Unit.new('1/4 cup')           # Rational number
 unit = Unit.new('1+1i mm')           # Complex Number
 ```
 
-Rules:
-------
+### Rules
 
-1.	only 1 quantity per unit (with 2 exceptions... 6'5" and '8 lbs 8 oz')
-2.	use SI notation when possible
-3.	spaces in units are allowed, but ones like '11/m' will be recognized as '11 1/m'.
+1. only 1 quantity per unit (with 2 exceptions... 6'5" and '8 lbs 8 oz')
+2. use SI notation when possible
+3. spaces in units are allowed, but ones like '11/m' will be recognized as '11
+   1/m'.
 
-Unit compatibility:
--------------------
+### Unit compatibility
 
-Many methods require that the units of two operands are compatible. Compatible units are those that can be easily converted into each other, such as 'meters' and 'feet'.
+Many methods require that the units of two operands are compatible. Compatible
+units are those that can be easily converted into each other, such as 'meters'
+and 'feet'.
 
-```
+```ruby
 unit1 =~ unit2                  #=> true if units are compatible
 unit1.compatible?(unit2)        #=> true if units are compatible
 ```
 
-Unit Math:
-----------
+### Unit Math
 
-```
+```text
 Unit#+()      # Add. only works if units are compatible
 Unit#-()      # Subtract. only works if units are compatible
-Unit#*()      # Multiply.  
+Unit#*()      # Multiply.
 Unit#/()      # Divide.
-Unit#**()     # Exponentiate.  Exponent must be an integer, can be positive,  negative, or zero                        
+Unit#**()     # Exponentiate.  Exponent must be an integer, can be positive,  negative, or zero
 Unit#inverse  # Returns 1/unit
 Unit#abs      # Returns absolute value of the unit quantity.  Strips off the  units
 Unit#ceil     # rounds quantity to next highest integer
@@ -81,20 +88,20 @@ Unit#round    # rounds quantity to nearest integer
 Unit#to_int   # returns the quantity as an integer
 ```
 
-Unit will coerce other objects into a Unit if used in a formula. This means that ..
+Unit will coerce other objects into a Unit if used in a formula. This means...
 
-```
+```ruby
 Unit.new("1 mm") + "2 mm"  == Unit.new("3 mm")
 ```
 
-This will work as expected so long as you start the formula with a Unit object.
+This will work as expected so long as you start the formula with a `Unit`
+object.
 
-Conversions & comparisons
--------------------------
+### Conversions & Comparisons
 
 Units can be converted to other units in a couple of ways.
 
-```
+```ruby
 unit.convert_to('ft')             # convert
 unit1 = unit >> "ft"              # convert to 'feet'
 unit >>= "ft"                     # convert and overwrite original object
@@ -106,83 +113,89 @@ unit1 + unit2 >> "ft"             # converts result of math to 'ft'
 (unit1 + unit2).convert_to('ft')  # converts result to 'ft'
 ```
 
-Any object that defines a 'to_unit' method will be automatically coerced to a unit during calculations.
+Any object that defines a `to_unit` method will be automatically coerced to a
+unit during calculations.
 
-Text Output
------------
+### Text Output
 
-Units will display themselves nicely based on the display_name for the units and prefixes. Since Unit implements a Unit#to_s, all that is needed in most cases is:
+Units will display themselves nicely based on the display_name for the units and
+prefixes. Since `Unit` implements a `Unit#to_s`, all that is needed in most
+cases is:
 
-```
+```ruby
 "#{Unit.new('1 mm')}"  #=> "1 mm"
 ```
 
-The to_s also accepts some options.
+The `to_s` also accepts some options.
 
-```
+```ruby
 Unit.new('1.5 mm').to_s("%0.2f")  # "1.50 mm".  Enter any valid format
-                                    string.  Also accepts strftime format
+                                  #   string.  Also accepts strftime format
 Unit.new('1.5 mm').to_s("in")     # converts to inches before printing
 Unit.new("2 m").to_s(:ft)         # returns 6'7"
 Unit.new("100 kg").to_s(:lbs)     # returns 220 lbs, 7 oz
 Unit.new("100 kg").to_s(:stone)   # returns 15 stone, 10 lb
 ```
 
-Time Helpers
-------------
+### Time Helpers
 
-Time, Date, and DateTime objects can have time units added or subtracted.
+`Time`, `Date`, and `DateTime` objects can have time units added or subtracted.
 
-```
+```ruby
 Time.now + Unit.new("10 min")
 ```
 
-Several helpers have also been defined. Note: If you include the 'Chronic' gem, you can specify times in natural language.
+Several helpers have also been defined. Note: If you include the 'Chronic' gem,
+you can specify times in natural language.
 
-```
-  Unit.new('min').since(DateTime.parse('9/18/06 3:00pm'))
+```ruby
+Unit.new('min').since(DateTime.parse('9/18/06 3:00pm'))
 ```
 
 Durations may be entered as 'HH:MM:SS, usec' and will be returned in 'hours'.
 
-```
+```ruby
 Unit.new('1:00')     #=> 1 h
 Unit.new('0:30')     #=> 0.5 h
 Unit.new('0:30:30')  #=> 0.5 h + 30 sec
 ```
 
-If only one ":" is present, it is interpreted as the separator between hours and minutes.
+If only one ":" is present, it is interpreted as the separator between hours and
+minutes.
 
-Ranges
-------
+### Ranges
 
-```
+```ruby
 [Unit.new('0 h')..Unit.new('10 h')].each {|x| p x}
 ```
 
 works so long as the starting point has an integer scalar
 
-Math functions
---------------
+### Math functions
 
-All Trig math functions (sin, cos, sinh, hypot...) can take a unit as their parameter. It will be converted to radians and then used if possible.
+All Trig math functions (sin, cos, sinh, hypot...) can take a unit as their
+parameter. It will be converted to radians and then used if possible.
 
-Temperatures
-------------
+### Temperatures
 
-Ruby-units makes a distinction between a temperature (which technically is a property) and degrees of temperature (which temperatures are measured in).
+Ruby-units makes a distinction between a temperature (which technically is a
+property) and degrees of temperature (which temperatures are measured in).
 
-Temperature units (i.e., 'tempK') can be converted back and forth, and will take into account the differences in the zero points of the various scales. Differential temperature (e.g., Unit.new('100 degC')) units behave like most other units.
+Temperature units (i.e., 'tempK') can be converted back and forth, and will take
+into account the differences in the zero points of the various scales.
+Differential temperature (e.g., Unit.new('100 degC')) units behave like most
+other units.
 
-```
+```ruby
 Unit.new('37 tempC').convert_to('tempF')   #=> 98.6 tempF
 ```
 
-Ruby-units will raise an exception if you attempt to create a temperature unit that would fall below absolute zero.
+Ruby-units will raise an exception if you attempt to create a temperature unit
+that would fall below absolute zero.
 
 Unit math on temperatures is fairly limited.
 
-```
+```ruby
 Unit.new('100 tempC') + Unit.new('10 degC')   # '110 tempC'.to_unit
 Unit.new('100 tempC') - Unit.new('10 degC')   # '90 tempC'.to_unit
 Unit.new('100 tempC') + Unit.new('50 tempC')  # exception (can't add two temperatures)
@@ -194,31 +207,31 @@ Unit.new('100 tempC') * unit                  # exception
 Unit.new('100 tempC') / unit                  # exception
 Unit.new('100 tempC') ** N                    # exception
 
-Unit.new('100 tempC').convert_to('degC')  #=> Unit.new('100 degC')   
+Unit.new('100 tempC').convert_to('degC')  #=> Unit.new('100 degC')
 ```
 
 This conversion references the 0 point on the scale of the temperature unit
 
-```
+```ruby
 Unit.new('100 degC').convert_to('tempC')  #=> '-173 tempC'.to_unit
 ```
 
-These conversions are always interpreted as being relative to absolute zero. Conversions are probably better done like this...
+These conversions are always interpreted as being relative to absolute zero.
+Conversions are probably better done like this...
 
-```
+```ruby
 Unit.new('0 tempC') + Unit.new('100 degC') #=> Unit.new('100 tempC')
 ```
 
-Defining Units
---------------
+### Defining Units
 
 It is possible to define new units or redefine existing ones.
 
-### Define New Unit
+#### Define New Unit
 
 The easiest approach is to define a unit in terms of other units.
 
-```
+```ruby
 Unit.define("foobar") do |foobar|
   foobar.definition   = Unit.new("1 foo") * Unit.new("1 bar")   # anything that results in a Unit object
   foobar.aliases      = %w{foobar fb}                   # array of synonyms for the unit
@@ -226,11 +239,13 @@ Unit.define("foobar") do |foobar|
 end
 ```
 
-### Redefine Existing Unit
+#### Redefine Existing Unit
 
-Redefining a unit allows the user to change a single aspect of a definition without having to re-create the entire definition. This is useful for changing display names, adding aliases, etc.
+Redefining a unit allows the user to change a single aspect of a definition
+without having to re-create the entire definition. This is useful for changing
+display names, adding aliases, etc.
 
-```
+```ruby
 Unit.redefine!("cup") do |cup|
   cup.display_name  = "cup"
 end
@@ -238,39 +253,46 @@ end
 
 ### Useful methods
 
-1. `scalar` will return the numeric portion of the unit without the attached units
+1. `scalar` will return the numeric portion of the unit without the attached
+   units
 2. `base_scalar` will return the scalar in base units (SI)
 3. `units` will return the name of the units (without the scalar)
 4. `base` will return the unit converted to base units (SI)
 
 ### Storing in a database
 
-Units can be stored in a database as either the string representation or in two separate columns defining the scalar and the units.
-Note that if sorting by units is desired you will want to ensure that you are storing the scalars in a consistent unit (i.e, the base units).
+Units can be stored in a database as either the string representation or in two
+separate columns defining the scalar and the units. Note that if sorting by
+units is desired you will want to ensure that you are storing the scalars in a
+consistent unit (i.e, the base units).
 
 ### Namespaced Class
 
-Sometimes the default class 'Unit' may conflict with other gems or applications. Internally ruby-units defines itself using the RubyUnits namespace. The actual class of a unit is the RubyUnits::Unit. For simplicity and backwards compatibility, the '::Unit' class is defined as an alias to '::RubyUnits::Unit'.
+Sometimes the default class 'Unit' may conflict with other gems or applications.
+Internally ruby-units defines itself using the RubyUnits namespace. The actual
+class of a unit is the RubyUnits::Unit. For simplicity and backwards
+compatibility, the `::Unit` class is defined as an alias to `::RubyUnits::Unit`.
 
 To load ruby-units without this alias...
 
-```
+```ruby
 require 'ruby_units/namespaced'
 ```
 
 When using bundler...
 
-```
+```ruby
 gem 'ruby-units', require: 'ruby_units/namespaced'
 ```
 
-Note: when using the namespaced version, the Unit.new('unit string') helper will not be defined.
+Note: when using the namespaced version, the `Unit.new('unit string')` helper
+will not be defined.
 
 ### Configuration
 
 Configuration options can be set like:
 
-```
+```ruby
 RubyUnits.configure do |config|
   config.separator = false
 end
@@ -278,14 +300,20 @@ end
 
 Currently there is only one configuration you can set:
 
-1. separator (true/false): should a space be used to separate the scalar from the unit part during output.
-
+1. separator (true/false): should a space be used to separate the scalar from
+   the unit part during output.
 
 ### NOTES
 
 #### Performance vs. Accuracy
 
-Ruby units was originally intended to provide a robust and accurate way to do arbitrary unit conversions.  
-In some cases, these conversions can result in the creation and garbage collection of a lot of intermediate objects during
-calculations.  This in turn can have a negative impact on performance.  The design of ruby-units has emphasized accuracy
-over speed.  YMMV if you are doing a lot of math involving units.
+Ruby units was originally intended to provide a robust and accurate way to do
+arbitrary unit conversions. In some cases, these conversions can result in the
+creation and garbage collection of a lot of intermediate objects during
+calculations. This in turn can have a negative impact on performance. The design
+of ruby-units has emphasized accuracy over speed. YMMV if you are doing a lot of
+math involving units.
+
+## License
+
+[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Folbrich%2Fruby-units.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2Folbrich%2Fruby-units?ref=badge_large)