unitwise-193 1.0.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 447e1bf6c829e89e1ccf811beb286147623868c7
+  data.tar.gz: 9265687e4f7728d36c5bfaad750cc84a38bc2c9a
+SHA512:
+  metadata.gz: 5f4d6dab4e6f77bae8c7992d7fc27b8e4eba9c4aa14703befa63816ff14f37b5351999e5060b69879c0c02e76178bcafb835eed008a95e9dc9e2ea7a2d3698cd
+  data.tar.gz: 147a38baa74d5c85462a8dde1fdcbec208ff83eb2d72713cc8f41e2db18e9417de0681186998067dd5134ca0b860476214f2fa92010103d64801380a4457b3a4

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.ruby-version

@@ -0,0 +1 @@
+2.2.0

data/.travis.yml

@@ -0,0 +1,21 @@
+language: ruby
+cache: bundler
+bundler_args: --without yard pry
+sudo: false
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1
+  - 2.2
+  - ruby-head
+  - rbx-2
+matrix:
+  include:
+    - rvm: jruby-19mode
+      env: JRUBY_OPTS="$JRUBY_OPTS --debug"
+    - rvm: jruby-head
+      env: JRUBY_OPTS="$JRUBY_OPTS --debug"
+  allow_failures:
+    - rvm: ruby-head
+    - rvm: jruby-head
+  fast_finish: true

data/CHANGELOG.md

@@ -0,0 +1,44 @@
+# Unitwise Changelog
+
+All notable changes to Unitwise will be documented in this file, starting at
+version 1.0.0.
+
+Unitwise uses semantic versioning.
+
+## 1.0.4 - 2015-01-10
+
+- Added Ruby 2.2 support.
+- Empty strings are no longer valid units.
+
+## 1.0.3 - 2014-10-05
+
+### Added
+- Unitwise.valid? for checking validity of expressions
+
+## 1.0.2 - 2014-09-14
+
+### Fixed
+- Decomposer caching is now a little smarter. This resulted in a mild
+  performance increase.
+
+## 1.0.1 - 2014-08-30
+
+### Fixed
+- Move conditional dependencies to Gemfile in order to allow proper
+  installation issues on rbx and jruby.
+
+## 1.0.0 - 2014-08-25
+
+### Added
+- Uniwise() now accepts a Unitwise::Measurement as the first argument.
+- Unitwise::Measurement now supports #round.
+
+### Fixed
+- Respect Rationals when inspecting/printing a Unitwise::Measurement.
+- Dynamically created methods from unitwise/ext now work with #respond_to?
+  and #methods appropriately.
+
+### Deprecated
+- Unitwise() and Unitwise::Measurement.new() now requires two non-optional
+  arguments (value and unit).
+- Unitwise::Measurement no longer has an implicit Integer conversion.

data/Gemfile

@@ -0,0 +1,10 @@
+source 'https://rubygems.org'
+
+gem 'coveralls',  '~> 0.7'
+if RUBY_VERSION >= '2.2.0'
+  gem 'bigdecimal', '~> 1.2.6', :platform => :mri
+else
+  gem 'bigdecimal', '~> 1.2.5', :platform => :mri
+end
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Josh Lewis
+
+MIT License
+
+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.

data/README.md

@@ -0,0 +1,297 @@
+# Unitwise-193
+
+This is a fork of Josh W Lewis's very cool Unitwise library. I've pushed it as a gem so that I can use it in a few situations where a git source isn't possible.
+
+Currently the only differences are that I've dropped support for ruby's pre 1.9.3 so I could upgrade dependencies as they were causing conflicts with other gems.
+
+Primarily this upgrades parslet and nori. If you can use the stock unitwise gem I highly recommend it.
+
+Normal readme follows.
+
+# [Unitwise](//github.com/wizarddevelopment/unitwise)
+
+[![Gem Version](http://img.shields.io/gem/v/unitwise-193.svg?style=flat)](https://rubygems.org/gems/unitwise)
+[![Build Status](http://img.shields.io/travis/wizarddevelopment/unitwise.svg?style=flat)](https://travis-ci.org/wizarddevelopment/unitwise)
+[![Dependency Status](http://img.shields.io/gemnasium/wizarddevelopment/unitwise.svg?style=flat)](https://gemnasium.com/wizarddevelopment/unitwise)
+[![Coverage Status](http://img.shields.io/coveralls/wizarddevelopment/unitwise.svg?style=flat)](https://coveralls.io/r/wizarddevelopment/unitwise)
+[![Code Climate](http://img.shields.io/codeclimate/github/wizarddevelopment/unitwise.svg?style=flat)](https://codeclimate.com/github/wizarddevelopment/unitwise)
+
+Unitwise is a Ruby library for unit measurement conversion and math.
+
+For an over the top example, consider a car (2800 lb) completing the quarter
+mile in 10 seconds (with uniform acceleration).
+
+```ruby
+distance = 0.25.mile # => #<Unitwise::Measurement value=0.25 unit=mile>
+time = 10.second # => #<Unitwise::Measurement value=10 unit=second>
+mass = 2800.pound # => #<Unitwise::Measurement value=2800 unit=pound>
+
+acceleration = 2.0 * distance / time ** 2
+# => #<Unitwise::Measurement value=0.005 unit=[mi_us]/s2>
+
+force = (mass * acceleration).to_lbf
+# => #<Unitwise::Measurement value=2297.5084316991147 unit=lbf>
+
+power = (force * distance / time).to_horsepower
+# => #<Unitwise::Measurement value=551.4031264140402 unit=horsepower>
+
+speed = ((2.0 * acceleration * distance) ** 0.5).convert_to("mile/hour")
+# => #<Unitwise::Measurement value=180.0 unit=mile/hour>
+```
+
+[RubyTapas](http://rubytapas.com) subscribers can also view a screencast:
+[225-Unitwise](https://rubytapas.dpdcart.com/subscriber/post?id=563)
+
+## Rationale
+
+Unitwise is based on the [Unified Code for Units of Measure(UCUM)](http://unitsofmeasure.org/),
+which aims to maintain a cross-platform list of units and their conversions.
+This gives Unitwise a few key advantages:
+
+- An enormous list of units. At the time of writing, there are 96 metric units,
+211 non-metric units, and 24 unit prefixes. Whatever unit/units you need, they
+are here.
+
+- An accurate and up to date set of units. The units, prefixes, and conversions
+are maintained by UCUM, and are imported into this library with a rake task.
+
+One of the objectives of Unitwise was that it should comprehend any combination
+of units. For instance it needed to understand that a unit of
+'kilogram.(meter/second)2' was equivalent to 'kilogram.meter.(meter/second2)'.
+This resulted in two unique features:
+
+- An expression grammar built with a PEG parser. This makes expression
+parsing more efficient and allows nested parentheses. For example, this is possible: '(kilogram.(meter/second)2)2'
+
+- Smart compatibility detection. Each unit is reduced down to its most elementary
+atoms to determine compatibility with another unit. For example, it knows that
+'meter/second2' should be considered compatible with 'kilogram.foot.minute-2/pound'.
+
+## Usage
+
+### Initialization:
+
+Measurements can be instantiated with `Unitwise()`.
+
+```ruby
+require 'unitwise'
+
+Unitwise(2.3, 'kilogram') # => #<Unitwise::Measurement value=2.3 unit=kilogram>
+Unitwise(100, 'pound')    # => #<Unitwise::Measurement value=100 unit=pound>
+```
+
+Unitwise doesn't mess with the core library by default. However, you can
+optionally require the core extensions for some handy helpers.
+
+```ruby
+require 'unitwise/ext'
+
+1.convert_to('liter') # => #<Unitwise::Measurement value=1 unit=liter>
+4.teaspoon            # => #<Unitwise::Measurement value=4 unit=teaspoon>
+```
+
+### Conversion
+
+Unitwise is able to convert any unit within the UCUM spec to any other
+compatible unit.
+
+```ruby
+5.0.kilometer.convert_to('mile')
+# => #<Unitwise::Measurement value=3.106849747474748 unit=mile>
+```
+
+The prettier version of `convert_to(unit)` is appending the unit code, name, etc.
+to a `to_` message name.
+
+```ruby
+Unitwise(26.2, 'mile').to_kilometer
+# => #<Unitwise::Measurement value=42.164897129794255 unit=kilometer>
+```
+
+### Comparison
+
+It also has the ability to compare measurements with the same or different units.
+
+```ruby
+12.inch == 1.foot # => true
+1.meter > 1.yard  # => true
+```
+
+Again, you have to compare compatible units. For example, comparing two
+temperatures will work, comparing a mass to a length would fail.
+
+### SI abbreviations
+
+You can use shorthand for SI units.
+
+```ruby
+1000.m == 1.km  # => true
+1.ml == 0.001.l # => true
+```
+
+### Complex Units
+
+Units can be combined to make more complex ones. There is nothing special about
+them -- they can still be converted, compared, or operated on.
+
+```ruby
+speed = Unitwise(60, 'mile/hour')
+# => #<Unitwise::Measurement value=60 unit=mile/hour>
+
+speed.convert_to('m/s')
+# => #<Unitwise::Measurement value=26.822453644907288 unit=m/s>
+```
+
+Exponents and parenthesis are supported as well.
+
+```ruby
+Unitwise(1000, 'kg.s-1.(m/s)2').to_kilowatt
+# => #<Unitwise::Measurement value=1.0 unit=kilowatt>
+```
+
+### Math
+
+You can add or subtract compatible measurements.
+
+```ruby
+2.0.meter + 3.0.inch - 1.0.yard
+# => #<Unitwise::Measurement value=1.1618 unit=meter>
+```
+
+You can multiply or divide measurements and numbers.
+
+```ruby
+110.volt * 2
+# => #<Unitwise::Measurement value=220 unit=volt>
+```
+
+You can multiply or divide measurements with measurements.
+
+```ruby
+20.milligram / 1.liter
+# => #<Unitwise::Measurement value=20 unit=mg/l>
+
+```
+
+Exponentiation is also supported.
+
+```ruby
+(10.cm ** 3).to_liter
+# => #<Unitwise::Measurement value=1 unit=liter>
+```
+
+### Unit Names and Atom Codes
+
+This library is based around the units in the UCUM specification, which is
+extensive and well thought out. However, not all of our unit systems throughout
+the world and history are consistent or logical. UCUM has devised a system where
+each unit has a unique atom code to try and solve this. The previous code examples
+don't show this, because for the most part you won't need it. Unitwise can
+figure out most of the units by their name or symbol. If you find you need to
+(or just want to be explicit) you use the UCUM atom codes without any
+modification.
+
+Just for example, you can see here that there are actually a few versions of inch
+and foot:
+
+```ruby
+Unitwise(1, '[ft_i]') == Unitwise(1, '[ft_us]') # => false
+
+Unitwise(3, '[in_br]') == Unitwise(3, '[in_i]') # => false
+```
+
+### Available Units
+
+If you are looking for a particular unit, you can search with a string or
+Regexp.
+
+```ruby
+Unitwise.search('fathom')
+# => [ ... ]
+```
+
+You can also get the official list from the UCUM website in XML format at
+[unitsofmeasure.org/ucum-essence.xml](http://unitsofmeasure.org/ucum-essence.xml)
+or a YAML version within this repo
+[github.com/joshwlewis/unitwise/tree/master/data](//github.com/joshwlewis/unitwise/tree/master/data).
+
+### UCUM designations
+UCUM defines several designations for it's units: `names`,
+`primary_code`, `secondary_code`, and `symbol`. You can see them all when
+inspecting an atom:
+
+```ruby
+Unitwise::Atom.all.sample
+# => #<Unitwise::Atom names=["British thermal unit"], primary_code="[Btu]", secondary_code="[BTU]", symbol="btu", scale=#<Unitwise::Scale value=1 unit=[Btu_th]>, classification="heat", property="energy", metric=false, special=false, arbitrary=false, dim="L2.M.T-2">
+```
+
+When initializing a measurement, you can use any of the designations:
+
+```ruby
+Unitwise(1, '[Btu]') == Unitwise(1, 'British thermal unit')
+# => true
+Unitwise(1, 'btu') == Unitwise(1, "[BTU]")
+# => true
+```
+
+When inspecting or printing (`to_s`) that measurement, it will remember the
+desigation you used. However, if you want to print it with another designation,
+that's also possible:
+
+```ruby
+temperature = Unitwise(10, "Cel")
+temperature.to_s # => "10 Cel"
+temperature.to_s(:names) # => "10 degree Celsius"
+temperature.to_s(:symbol) # => "10 °C"
+```
+
+There is on caveat here. You must use the same designation for each atom in a
+complex unit. Meaning you can't mix designations within a unit.
+
+```ruby
+Unitwise(1, "m/s")          # Works, both atoms use their primary_code
+Unitwise(1, "meter/second") # Works, both atoms use a name
+Unitwise(1, "meter/s")      # Does not work, mixed designations (name and primary_code)
+Unitwise(1, "meter") / Unitwise(1, "s") # Also works
+```
+
+## Supported Ruby Versions
+
+This library aims to support and is tested against the following Ruby
+implementations:
+
+* Ruby 1.9.3
+* Ruby 2.0.0
+* Ruby 2.1.0
+* [JRuby](http://jruby.org/)
+* [Rubinius](http://rubini.us/)
+* [Ruby Enterprise Edition](http://www.rubyenterpriseedition.com/)
+
+If something doesn't work on one of these versions, it's a bug.
+
+This library may inadvertently work (or seem to work) on other Ruby versions or
+implementations, however support will only be provided for the implementations
+listed above.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'unitwise'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install unitwise
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,21 @@
+require "bundler/gem_tasks"
+
+require 'rake'
+require 'rake/testtask'
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.pattern = 'test/**/*_test.rb'
+end
+
+task :default => :test
+
+namespace :unitwise do
+  desc "Update Ucum Data"
+  task :update_standard do
+    require 'unitwise'
+    require 'unitwise/standard'
+    Unitwise::Standard::BaseUnit.write
+    Unitwise::Standard::DerivedUnit.write
+    Unitwise::Standard::Prefix.write
+  end
+end