unit_soup 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e113ee9650c678b102c4788dd2aa7e8f51f9176d
+  data.tar.gz: c614b7fd95cc1b150e1fee659305b80eaf0eb32e
+SHA512:
+  metadata.gz: a1d5e2ddf493db14064bdb275ce195924658e23b5f280253ea97075ba2a004da198cd4db3191ba4dd71095e6ac9916ca06833a5dd18b3650d6b7caaca4aa1cd7
+  data.tar.gz: ffcb15850fef0a8601bea78c77faa78ca5480cf1edaf5c8b22c71e530de0cf846e96c4d10cfa91fc10e3c8bb6088a069e38945c9323548d86fd8f3bc5ce4a56e

data/.gitignore

@@ -0,0 +1,8 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 rutvij
+
+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,230 @@
+# UnitSoup
+
+Unit Soup is a DRY approach to unit conversion.
+Specify a set of conversion rules and you can start converting from one unit to another.
+
+## Analogy
+- `Mix` is a ready-made set of units and conversion rules.
+- `Soup` is made from (soup) mixes.
+- `Measurement` is amount of items of a particular type (unit). (e.g. 3 cars, 4 miles)
+- `Soup` can convert one `measurement` to another if possible.
+
+## Usage
+* Add as many `mixes` to `soup`.
+* Make the `soup`.
+* Start converting `measurements` from one unit to another.
+
+## Examples
+#### Metric Units
+
+```ruby
+require "unit_soup/mix"
+require "unit_soup/soup"
+
+metric_units_mix = Mix.new("Metric Units") do |m|
+  m << "1 cm = 10 mm"
+  m << "1 dm = 10 cm"
+  m << "1 m = 100 cm"
+  m << "1 dcm = 10 m"
+  m << "1 hcm = 100 m"
+  m << "1 km = 1000 m"
+end
+soup = Soup.new("Metric Soup (mm to km)")
+soup << metric_units_mix
+soup.make
+
+# convert 550 centimeters to meters
+soup.convert(550, :cm, :m) #=> 5.5
+# convert 50000 centimeters to kilometers
+soup.convert(50000, :cm, :km) #=> 0.5
+```
+
+#### Simple expenses calculator
+
+```ruby
+require "unit_soup/mix"
+require "unit_soup/soup"
+
+expenses_per_time_period_mix = Mix.new("Expenses/TimePeriod") do |mix|
+  mix << "1 per_day = 7 per_week"
+  mix << "1 per_week = 4 per_month"
+  mix << "1 per_month = 12 per_year"
+  mix << "1 per_weekend = 1 per_week"
+  mix << "1 per_weekday = 5 per_week"
+end
+
+soup = Soup.new("Expense calculator")
+soup << expenses_per_time_period_mix
+soup.make
+
+
+parking_per_week = Measurement.new(50, "per_week")
+parking_per_month = soup.convert(parking_per_week, :per_month) #=> 200
+parking_per_year = soup.convert(parking_per_week, :per_year) #=> 2400
+```
+
+
+## Details
+### Unit
+- Has `name` and `symbol`
+- `Unit.new("Kilometer", :km)` or `Unit.new(:km)`
+- Usually inferred from the rules
+
+### Measurement
+- Describes things like "3 cars", "4 miles"
+- Has `amount` and `unit`
+- m = `Measurement.new("3 car")`
+  - `m.unit` => `:car`
+  - `m.amount` => `3/1 (rational)`
+- Other ways to initialize
+  - `Measurement.from("4 mile")`
+  - `Measurement.new(4, :mile)`
+  - `Measurement.new(4, Unit.new(:mile))`
+  - `Measurement.new(2.5, :mile)`
+  - `Measurement.new("2.5", :mile)`
+  - `Measurement.new(3/2r, :mile)`
+  - `Measurement.new("3/2", :mile)`
+  - `Measurement.from(another_measurement)`
+
+### Rule
+- Describes conversion rule from one unit to another.
+- Can be specified as equality of two measurements.
+- `1 km = 1000 m`
+  - `this_measurement` = `1 km`, `that_measurement` = `1000 m`
+- r = `Rule.new("1 km = 1000 m")` or `Rule.new("1000 m = 1 km")`  
+- `valid?` can be used to check if a string can be parsed into a `Rule`
+- Can be initialized as
+  - `Rule.new "1 km = 1000 m"`     
+  - `Rule.from "1 km = 1000 m"`
+  - `Rule.from another_rule`
+  - `Rule.new measurement_a, measurement_b`
+  - `Rule.new Measurement.new("1 km"), Measurement.new(1000, :m)`
+
+### Mix
+- Represents a set of rules
+- Can be used to group related units together. e.g. Metric Units, time units, etc.
+- Has a name and a Set of rules
+- Initializing: time_units = `Mix.new("Time Units")` or `Mix.define("Time Units")`
+- Adding Rules:
+  - `time_units << "1 minute = 60 second"`
+  - `time_units << Rule.new("1 minute = 60 second")`
+  - `time_units.add "1 minute = 60 second"`
+  - `time_units.add Rule.new("1 minute = 60 second")`
+  - From Rule strings list: `distance << ["1cm = 10mm", "1km = 1.60934mile"]`
+  - From Rule list: `distance << [Rule.new("1cm = 10mm"), Rule.new("1km = 1.60934mile")]`
+  - From mixed list: `distance << ["1cm = 10mm", Rule.new("1km = 1.60934mile")]`
+  - From other mixes:
+    - `my_mix << time_units`
+    - `my_mix << distance_units`
+
+- Initialize via block:
+```
+time_units = Mix.define("Time units") do |m|  
+  m << "1 minute = 60 second"
+  m << ["1 hour = 60 minute", "1 millisecond  = 1000 second"]
+end
+```
+
+### Soup
+- Soup allows conversion from one unit to another
+- Has an optional name
+- Supports adding rules from strings, lists and mixes exactly like `Mix`
+  - `Soup.new("time_soup") << time_units_mix`
+- Add as many related/unrelated rules and mixes as you like to the soup
+- `make`: Make the soup (internally creates a graph of all rules for conversion lookups)
+- `convert(value, from, to)` => rational representing converted value in target unit
+  - `convert(2, :minute, :second)` => 120/1  
+  - `convert(2, Unit.new(:minute), :second)` => 120/1
+  - `convert(50, :foo, :bar)` => `nil` #if conversion was not possible  
+- Return value is a rational to keep precision
+- `make` needs to be called before `convert`s can work
+
+#### Conversion
+- `soup.make` Creates a graph from the rules. So,  
+
+  ```ruby
+  soup = Soup.new("my_distance_converter")
+  soup << Mix.new("my_distance_mix") do |m|
+    m << "1 centimeter = 10 millimeter"
+    m << "1 decimeter = 10 centimeter"
+    m << "1 centimeter = 100 meter"    
+    m << "1 centimeter = 0.39 inch"    
+    m << "1 foot = 12 inch"
+    m << "1 kilometer = 1000 meter"    
+    m << "1 kilometer = 0.62 mile"    
+  end
+  soup.make
+  ```
+
+  becomes
+  ```
+                    +------------+
+                    | millimeter |
+                    +------------+
+                          |
+                          |
+                          |
+  +-----------+     +------------+     +------+     +------+
+  | decimeter | --- | centimeter | --- | inch | --- | foot |
+  +-----------+     +------------+     +------+     +------+
+                          |
+                          |
+                          |
+  +-----------+     +------------+
+  | kilometer | --- |   meter    |
+  +-----------+     +------------+
+        |
+        |
+        |
+  +-----------+
+  |   mile    |
+  +-----------+
+  ```
+
+- Any rules added after `soup.make` will not be a part of the graph until another call to `soup.make` is made.
+
+- A `lookup` is initialized internally with all direct conversions inferred from the set of rules. e.g. From "1 foot = 12 inch" we can infer `lookup[:foot][:inch]=12` and `lookup[:inch][:foot]=1/12`
+
+- `soup.convert(2, :foot, :inch)` - `lookup` has information to convert from `foot` to `inch`, so `convert` returns `2 * (lookup[:foot][:inch]=12) = 24/1`
+
+- `soup.convert(200, :foot, :meter)` - `lookup` does not have this information, so a `bfs` graph traversal starting from `foot` is performed. It gives us the following chain that can be traversed to get the right fraction for multiplication to perform conversion:
+
+  ```
+  +-------+      +------------+      +------+      +------+
+  | meter | <--- | centimeter | <--- | inch | <--- | foot |
+  +-------+      +------------+      +------+      +------+
+
+  200 * lookup[:foot][:inch] * lookup[:inch][:centimeter] * lookup[:centimeter][meter]
+  ```
+
+  This conversion fraction is also saved in `lookup[:foot][:meter]` and `lookup[:meter][:foot]` so the next conversion from `foot` to `meter` does not perform a graph traversal.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'unit_soup'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install unit_soup
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+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`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new('spec')
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "unit_soup"
+
+# 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.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/unit_soup.rb

@@ -0,0 +1,8 @@
+require 'unit_soup/unit'
+require 'unit_soup/measurement'
+require 'unit_soup/mix'
+require 'unit_soup/rule'
+require 'unit_soup/soup'
+
+module UnitSoup
+end

data/lib/unit_soup/measurement.rb

@@ -0,0 +1,57 @@
+require "unit_soup/unit"
+
+include UnitSoup
+
+module UnitSoup
+  class Measurement
+    # captures "(num)(symbol)" where num = decimal|integer|fraction
+    @@measurement_format = %r{^(\d+|\d+\.\d+|\d+/[1-9]+|\d+\.\d+/[1-9]+)([a-zA-Z_]+)$}
+
+    def self.valid?(str)
+      str && !str.to_s.gsub("\s", "").match(@@measurement_format).nil?
+    end
+
+    def self.from(*args)
+      self.new *args
+    end
+
+    attr_reader :amount, :unit
+
+    def initialize(*args)
+      case args.length
+      when 1
+        if args[0].is_a? Measurement
+          @amount = args[0].amount
+          @unit = args[0].unit
+        else
+          str = args[0]
+          raise ArgumentError.new("No argument provided") unless str
+          str = str.to_s
+          match_data = str.to_s.gsub("\s", "").match(@@measurement_format)
+          raise ArgumentError.new("Format: 12 inch") unless match_data
+          @amount = match_data[1].to_r
+          @unit = Unit.new(match_data[2])
+        end
+      else
+        @amount = args[0].is_a?(String) ? args[0].to_r : args[0].rationalize
+        @unit = Unit.new(args[1].to_sym)
+      end
+    end
+
+    def to_s
+      "#{amount} #{unit}"
+    end
+
+    def ==(o)
+      amount == o.amount && unit == o.unit
+    end
+
+    def eql?(o)
+      amount == o.amount && unit == o.unit
+    end
+
+    def hash
+      to_s.hash
+    end
+  end
+end

data/lib/unit_soup/mix.rb

@@ -0,0 +1,51 @@
+require "unit_soup/rule"
+require "unit_soup/unit"
+require "set"
+
+module UnitSoup
+  class Mix
+    def self.define(name, &block)
+      mix = Mix.new name
+      if(block)
+        block.arity < 1 ? mix.instance_eval(&block) : block.call(mix)
+      end
+      mix
+    end
+
+    attr_reader :name, :rules
+
+    def initialize(name, &block)
+      @name = name
+      @rules = Set.new
+      if(block)
+        block.arity < 1 ? instance_eval(&block) : block.call(self)
+      end
+    end
+
+    def <<(arg)
+      new_rules = []
+      if arg.is_a? Mix
+        new_rules += arg.rules.to_a
+      elsif arg.is_a? Rule
+        new_rules << arg
+      elsif arg.is_a? Enumerable
+        new_rules += arg.map do |a|
+          if a.is_a? Rule
+            a
+          else
+            Rule.new(a)
+          end
+        end
+      else
+        new_rules << Rule.new(arg)
+      end
+      new_rules.each {|r| @rules.add r}
+    end
+
+    alias_method :add, :<<
+
+    def add_rules_from_file(file)
+      #TODO: parse rules from file
+    end
+  end
+end

data/lib/unit_soup/rule.rb

@@ -0,0 +1,56 @@
+require "unit_soup/unit"
+require "unit_soup/measurement"
+
+include UnitSoup
+
+module UnitSoup
+  class Rule
+    def self.valid?(str)
+      return false unless str
+      strs = str.split '='
+      strs.length > 1 && Measurement.valid?(strs[0]) && Measurement.valid?(strs[1])
+    end
+
+    def self.from(r)
+      self.new r
+    end
+
+    attr_reader :this_measurement, :that_measurement
+
+    def initialize(*args)
+      case args.length
+      when 1
+        r = args[0]
+        raise ArgumentError.new("No argument provided") unless r
+        if r.is_a? Rule
+          @this_measurement = Measurement.new r.this_measurement
+          @that_measurement = Measurement.new r.that_measurement
+        else
+          strs = r.to_s.split '='
+          raise ArgumentError.new("Format: 12 inch = 1 foot") unless strs.length == 2
+          @this_measurement = Measurement.new strs[0]
+          @that_measurement = Measurement.new strs[1]
+        end
+      else
+        @this_measurement = Measurement.new(args[0])
+        @that_measurement = Measurement.new(args[1])
+      end
+    end
+
+    def to_s
+      "#{this_measurement} = #{that_measurement}"
+    end
+
+    def ==(o)
+      this_measurement == o.this_measurement && that_measurement == o.that_measurement
+    end
+
+    def eql?(o)
+      this_measurement == o.this_measurement && that_measurement == o.that_measurement
+    end
+
+    def hash
+      to_s.hash
+    end
+  end
+end

data/lib/unit_soup/soup.rb

@@ -0,0 +1,88 @@
+require "unit_soup/rule"
+require "unit_soup/unit"
+require "unit_soup/mix"
+
+include UnitSoup
+
+module UnitSoup
+  class Soup
+    attr_reader :name
+    def initialize(name="_")
+      @name = name
+      @mix = Mix.new("default")
+      @units = Set.new
+      @rules = Set.new
+      # symbol -> unit
+      @symbols_map = {}
+      @lookup = {}
+      @graph = {}
+    end
+
+    def <<(m)
+      @mix << m
+    end
+
+    def rules
+      @mix.rules
+    end
+
+    def make
+      @units.clear
+      @lookup = {}
+      @graph = {}
+      @mix.rules.each do |r|
+        @units << r.this_measurement.unit
+        @units << r.that_measurement.unit
+        this_unit = r.this_measurement.unit
+        that_unit = r.that_measurement.unit
+
+        this_in_that = Measurement.new((r.that_measurement.amount/r.this_measurement.amount).rationalize, that_unit)
+        that_in_this = Measurement.new((r.this_measurement.amount/r.that_measurement.amount).rationalize, this_unit)
+
+        # add direct conversions to lookup
+        @lookup[[r.this_measurement.unit, r.that_measurement.unit]] = this_in_that
+        @lookup[[r.that_measurement.unit, r.this_measurement.unit]] = that_in_this
+
+        # build graph
+        # rule "3 foo = 4 bar" represented as {foo => [4/3 bar], bar => [3/4 foo]}
+        @graph[r.this_measurement.unit] = Set.new unless @graph.include?(r.this_measurement.unit)
+        @graph[r.this_measurement.unit] << this_in_that
+        @graph[r.that_measurement.unit] = Set.new unless @graph.include?(r.that_measurement.unit)
+        @graph[r.that_measurement.unit] << that_in_this
+      end
+    end
+
+    def convert(value, from, to)
+      from = Unit.new(from)
+      to = Unit.new(to)
+      return nil unless @units.include?(from) && @units.include?(to)
+      return (value * (@lookup[[from, to]]).amount) if @lookup.include? [from, to]
+      # bfs graph from from-to. When found, walk through parent path and multiply all conversion factors.
+      Struct.new("Child", :measurement, :parent)
+      queue = [Struct::Child.new(Measurement.new(value, from), nil)]
+      while !queue.empty? do
+        parent = queue.first
+        # Find all measurement matches
+        # e.g. if graph[:from] = ["3/4 :foo", "4/5 :bar", "3/1 :to", "5/1 :to"]
+        #    then matches = ["3/1 :to", "5/1 :to"]
+        #    Since there are two valid rules to convert :from -> :to, we pick the first one
+        matches = @graph[parent.measurement.unit].select{|m|m.unit == to}
+        if(matches.size > 0)
+          # create the chain [from, a, b, c, to], starting with 'to' and building back
+          chain_from_to = [Struct::Child.new(matches.first, parent)]
+          curr = chain_from_to.first
+          while(curr.parent) do
+            chain_from_to.unshift curr.parent # add current parent to front of chain
+            curr = curr.parent
+          end
+          return chain_from_to.map{|c|c.measurement.amount}.inject(1){|m1,m2| m1 * m2}
+        else
+          children = @graph[parent.measurement.unit]
+          children_not_in_queue = children.reject{|m| queue.include? m}
+          queue += children_not_in_queue.map{|m| Struct::Child.new(m, parent)}
+          queue.shift
+        end
+      end
+    end
+  end
+end

data/lib/unit_soup/unit.rb

@@ -0,0 +1,35 @@
+module UnitSoup
+
+  class Unit
+    attr_reader :name, :symbol
+
+    def initialize(name=nil, symbol)
+      @symbol = symbol.to_sym
+      @name = name.nil? ? @symbol.to_sym : name.to_sym
+    end
+
+    def name=(name)
+      @name = name.to_sym
+    end
+
+    def to_s
+      symbol.to_s
+    end
+
+    def to_sym
+      symbol.to_sym
+    end
+
+    def ==(o)
+      symbol == o.symbol
+    end
+
+    def eql?(o)
+      symbol == o.symbol
+    end
+
+    def hash
+      symbol.hash
+    end
+  end
+end

data/lib/unit_soup/version.rb

@@ -0,0 +1,3 @@
+module UnitSoup
+  VERSION = "0.1.1"
+end

data/tmp/test.rb

@@ -0,0 +1,5 @@
+require_relative 'unit_soup'
+
+puts UnitSoup::UnitSet.define do 
+    "hello" + " world"
+end

data/tmp/tmp.rb

@@ -0,0 +1,143 @@
+# trying out api
+
+pack = UnitPack.create(name: "time periods") do |p|
+  p.name = "time periods"
+  p.desc = "some description"
+  p.rules  = [
+    "7 days = 1 week"
+  ]
+  p.rules File("conversion.rules")
+  # p.rules [
+  #   {days: 7, week: 1}
+  #   {weekday: 5, week: 1}
+  #   {weekday: 1, days: 1}
+  #   {weekend: 1, days: 2}
+  #   {weekend: 1, week: 1}
+  # ]
+  p.aliases = {
+    days: %w(day days)
+
+  }
+end
+
+
+Rule.new("1 days", "24 hours")
+Convertible::Unit(:name, %w(aliases), rules)
+Convertible::Measurement
+Convertible::Unit
+Convertible::DefinitionSet
+Convertible::RuleSet
+Measurement/Reading
+Rule = measurementA = measurementB
+UnitPack.merge()
+UnitPack.convert measurementA unitB
+UnitPack.conversionFactor measurementA unitB
+DefinitionSet/ConversionRuleSet/UnitPack/UnitGroup
+
+UnitSoup::Unit
+UnitSoup::Measurement
+UnitSoup::Mix
+
+soupmix = Mix.new()
+soup.make
+soup.add(Mix::ImperialUnits)
+soup.make
+soup.convert(measurement, "cm")
+soup.conversion_factor("inch", "cm")
+soup.conversion_path("inch", "cm")
+soup.rules << Mix | Rule | rules
+soup.rules = Mix | Rule | rules
+soup.rules Mix | Rule | rules
+soup.rule = Rule
+soup.rule Rule
+
+BudgetItem < Convertible::Measurement
+
+SetDefinition
+
+metric_units = Convertible::Set.define do
+  name "Metric Units"
+  rules [
+    "100 cm = 1 decimeter",
+    "100 decimeter = 1 meter",
+    "1000 meter = 1 km"
+  ]
+  rule "2.5 cm = 1 inch"
+  rules_from_file :file_path
+  unit(:km).same_as("KM", :kilo_meters) # aliases
+  unit(:centimeter).use_symbol("cm")
+  unit(:cm).use_plural("centimeters")
+  unit(:cm).use_singular(short: cm, long="centimeter")
+  unit(:cm).use(symbol: :cm, singular: :centimeter, :plural: "centimeters", name: "Centimeter")
+  unit(:cm).rule("2.5cm", "1 inch")
+  unit(:cm).rule("2.5", 1, unit(:inch))
+  unit(:cm).rule("2.5", unit(1, :inch))
+end
+
+Convertible::Set.from/with/union (Convertible::SetDefinition::Metric, dollar_units)
+my_set.add(dollar_units).
+
+
+# algo
+@lookup @graph
+convert(measurement, from, to)
+  return from lookup if lookup has from, to factor
+  bfssearch from to - when found, take path, collect factors
+  return converted or show error
+
+when rules change
+    reset lookup and graph
+    build graph from rules
+      rules.each do
+        graph[this][that]=factor
+        graph[that][this]=1/factor
+
+# classes
+Rule = Measurement - Measurement
+Measurement = Amount.to_r Unit
+Unit(to_sym, symbols)
+Amount(to_r)
+Soup = set<rule>
+
+Soup
+ @mix = Mix.new(name)
+  @units = []
+  @rules = []
+ @symbols_map = {:symbol => unit}
+ @lookup
+ @graph
+
+
+# brainstorming unit singletons
+mix << rules
+mix[:unit].symbols << :cms
+soup.prepare
+soup.unit[:unit].same_as :longer_name
+soup.make
+soup = Soup.new("mysoup", mix1, mix2)
+soup << mix3
+soup << rule1, rule2, mix
+soup.unit(:unit).field
+soup.units[:unit].symbols
+
+
+
+# unit additional functionality
+:singular, :plural,
+def initialize(options={})
+  @symbols = []
+  @name = options[:name].to_sym if options[:name]
+  @singular = options[:singular].to_sym if options[:singular]
+  @plural = options[:plural].to_sym if options[:plural]
+  @symbol = options[:use].to_sym if options[:use]
+  @symbol = options[:symbol].to_sym if @symbol.nil? && options[:symbol]
+  @symbol = options[:preffered].to_sym if @symbol.nil? && options[:preffered]
+  @symbols += options[:aliases] if options[:aliases]
+  @symbols += options[:symbols] if options[:symbols]
+end
+
+def symbols
+  (@symbols + [@name, @singular, @plural, @symbol]).reject{|s|s.blank?}.sort.uniq
+end
+
+alias_method :preffered, :symbol

data/unit_soup.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "unit_soup/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "unit_soup"
+  spec.version       = UnitSoup::VERSION
+  spec.authors       = ["Rutvij"]
+  spec.email         = ["code@rutvijshah.com"]
+
+  spec.summary       = %q{A DRY approach to unit conversion.}
+  spec.description   = %q{A DRY approach to unit conversion. Define rules, make soup, convert.}
+  spec.homepage      = "http://www.rutvijshah.com"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.15"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", '~> 3.5', '>= 3.5.0'
+end

metadata

@@ -0,0 +1,110 @@
+--- !ruby/object:Gem::Specification
+name: unit_soup
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Rutvij
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-10-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.5.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.5.0
+description: A DRY approach to unit conversion. Define rules, make soup, convert.
+email:
+- code@rutvijshah.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/unit_soup.rb
+- lib/unit_soup/measurement.rb
+- lib/unit_soup/mix.rb
+- lib/unit_soup/rule.rb
+- lib/unit_soup/soup.rb
+- lib/unit_soup/unit.rb
+- lib/unit_soup/version.rb
+- tmp/test.rb
+- tmp/tmp.rb
+- unit_soup.gemspec
+homepage: http://www.rutvijshah.com
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.13
+signing_key: 
+specification_version: 4
+summary: A DRY approach to unit conversion.
+test_files: []