[
  {
    "path": ".gitignore",
    "content": "*.gem\n*.rbc\n.bundle\n.config\n.yardoc\nGemfile.lock\nInstalledFiles\n_yardoc\ncoverage\ndoc/\nlib/bundler/man\npkg\nrdoc\nspec/reports\ntest/tmp\ntest/version_tmp\ntmp\n"
  },
  {
    "path": ".travis.yml",
    "content": "language: ruby\nrvm:\n  - 2.2\n  - 2.3\n  - 2.4\n  - jruby-19mode # JRuby in 1.9 mode\n# uncomment this line if your project needs to run something other than `rake`:\nscript: bundle exec rspec spec\ngemfile:\n  - Gemfile.activesupport51\n\nbefore_install:\n  - gem install bundler"
  },
  {
    "path": "CHANGELOG.md",
    "content": "## v0.4.2\n* Support Time, DateTime, and Date class as input\n\n## v0.3.1\n* Support in_each_component as a shortcut for all time components\n\n## v0.2.0\n* Time difference will return absolute value\n\n## v0.1.0\n\n* First release at v0.1.0, here we go!"
  },
  {
    "path": "Gemfile",
    "content": "source 'https://rubygems.org'\n\n# Specify your gem's dependencies in time_difference.gemspec\ngemspec\n"
  },
  {
    "path": "Gemfile.activesupport51",
    "content": "source \"https://rubygems.org\"\t\t\ngemspec\t\t\n\t\t\ngem 'activesupport', '~> 5.1'"
  },
  {
    "path": "LICENSE",
    "content": "Copyright (c) 2013 TM Lee\n\nMIT License\n\nPermission is hereby granted, free of charge, to any person obtaining\na copy of this software and associated documentation files (the\n\"Software\"), to deal in the Software without restriction, including\nwithout limitation the rights to use, copy, modify, merge, publish,\ndistribute, sublicense, and/or sell copies of the Software, and to\npermit persons to whom the Software is furnished to do so, subject to\nthe following conditions:\n\nThe above copyright notice and this permission notice shall be\nincluded in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\nEXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\nMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\nNONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE\nLIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION\nOF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION\nWITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE."
  },
  {
    "path": "README.md",
    "content": "[![Build Status](https://travis-ci.org/tmlee/time_difference.png)](https://travis-ci.org/tmlee/time_difference)\n\nThis latest version of the gem works with ActiveSupport 5.1. For prior version, check out [v0.6.x-activesupport42](https://github.com/tmlee/time_difference/tree/0.6.0-activesupport42)\n\n# TimeDifference\n\nTimeDifference is the missing Ruby method to calculate difference between two given time. You can do a Ruby time difference in year, month, week, day, hour, minute, and seconds.\n\n## Installation\n\nAdd this line to your application's Gemfile:\n\n```ruby\ngem 'time_difference'\n```\n\nAnd then execute:\n\n```bash\n$ bundle install\n```\n\n## Usage\n\n### Works for Time, DateTime, and Date\n\n```ruby\n# Time\nstart_time = Time.new(2013,1)\nend_time = Time.new(2014,1)\n\nTimeDifference.between(start_time, end_time).in_years\n=> 1.0\n\n# DateTime\nstart_time = DateTime.new(2013,1)\nend_time = DateTime.new(2014,1)\n\nTimeDifference.between(start_time, end_time).in_years\n=> 1.0\n\n# Date\nstart_time = Date.new(2013,1)\nend_time = Date.new(2014,1)\n\nTimeDifference.between(start_time, end_time).in_years\n=> 1.0\n```\n\n### Get the time difference in various units\n\n```ruby\nstart_time = Time.new(2013,1)\nend_time = Time.new(2014,1)\n\nTimeDifference.between(start_time, end_time).in_years\n=> 1.0\n\nTimeDifference.between(start_time, end_time).in_months\n=> 12.0\n\nTimeDifference.between(start_time, end_time).in_weeks\n=> 52.14 \n\nTimeDifference.between(start_time, end_time).in_days\n=> 365.0 \n\nTimeDifference.between(start_time, end_time).in_hours\n=> 8760.0\n\nTimeDifference.between(start_time, end_time).in_minutes\n=> 525600.0\n\nTimeDifference.between(start_time, end_time).in_seconds\n=> 31536000.0 \n```\n\n### Get the time difference in each component\n\n```ruby\nstart_time = Time.new(2013,1)\nend_time = Time.new(2014,1)\n\nTimeDifference.between(start_time, end_time).in_each_component\n=> {:years=>1.0, :months=>12.0, :weeks=>52.14, :days=>365.0, :hours=>8760.0, :minutes=>525600.0, :seconds=>31536000.0}\n```\n\n### If you would like an overall estimated time component, use `in_general` _(not that accurate)_\n\n```ruby\nstart_time = Time.new(2013,1)\nend_time = Time.new(2014,1)\n\nTimeDifference.between(start_time, end_time).in_general\n=> {:years=>0, :months=>12, :weeks=>0, :days=>5, :hours=>0, :minutes=>0, :seconds=>0}\n```\n\n### You can also get `in_general` as a human readable string, using `humanize`\n\n```ruby\nstart_time = Time.new(2013,1)\nend_time = Time.new(2014,1)\n\nTimeDifference.between(start_time, end_time).humanize\n=> \"12 Months and 5 Days\"\n```\n\n## Contributing\n\n1. Fork it\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Added some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create new Pull Request\n"
  },
  {
    "path": "Rakefile",
    "content": "#!/usr/bin/env rake\nrequire \"bundler/gem_tasks\"\n\nrequire 'rspec/core/rake_task'\n\ntask :default => :spec\nRSpec::Core::RakeTask.new('spec')"
  },
  {
    "path": "lib/time_difference.rb",
    "content": "require 'rubygems'\nrequire \"active_support/all\"\n\nclass TimeDifference\n\n  private_class_method :new\n\n  TIME_COMPONENTS = [:years, :months, :weeks, :days, :hours, :minutes, :seconds]\n\n  def self.between(start_time, end_time)\n    new(start_time, end_time)\n  end\n\n  def in_years\n    in_component(:years)\n  end\n\n  def in_months\n    (@time_diff / (1.day * 30.42)).round(2)\n  end\n\n  def in_weeks\n    in_component(:weeks)\n  end\n\n  def in_days\n    in_component(:days)\n  end\n\n  def in_hours\n    in_component(:hours)\n  end\n\n  def in_minutes\n    in_component(:minutes)\n  end\n\n  def in_seconds\n    @time_diff\n  end\n\n  def in_each_component\n    Hash[TIME_COMPONENTS.map do |time_component|\n      [time_component, public_send(\"in_#{time_component}\")]\n    end]\n  end\n\n  def in_general\n    remaining = @time_diff\n    Hash[TIME_COMPONENTS.map do |time_component|\n      if remaining > 0\n        rounded_time_component = (remaining / 1.send(time_component).seconds).round(2).floor\n        remaining -= rounded_time_component.send(time_component)\n        [time_component, rounded_time_component]\n      else\n        [time_component, 0]\n      end\n    end]\n  end\n\n  def humanize\n    diff_parts = []\n    in_general.each do |part,quantity|\n      next if quantity <= 0\n      part = part.to_s.humanize\n\n      if quantity <= 1\n        part = part.singularize\n      end\n\n      diff_parts << \"#{quantity} #{part}\"\n    end\n\n    last_part = diff_parts.pop\n    if diff_parts.empty?\n      return last_part\n    else\n      return [diff_parts.join(', '), last_part].join(' and ')\n    end\n  end\n\n  private\n\n  def initialize(start_time, end_time)\n    start_time = time_in_seconds(start_time)\n    end_time = time_in_seconds(end_time)\n\n    @time_diff = (end_time - start_time).abs\n  end\n\n  def time_in_seconds(time)\n    time.to_time.to_f\n  end\n\n  def in_component(component)\n    (@time_diff / 1.send(component)).round(2)\n  end\n\nend\n"
  },
  {
    "path": "spec/spec_helper.rb",
    "content": "require 'rspec'\nrequire 'time_difference'\n\nRSpec.configure do |config|\n  config.formatter     = 'documentation'\n\n  # Configure Timezone for proper tests\n  ENV['TZ'] = 'UTC'\nend"
  },
  {
    "path": "spec/time_difference_spec.rb",
    "content": "require 'spec_helper'\n\ndescribe TimeDifference do\n\n  def self.with_each_class(&block)\n    classes = [Time, Date, DateTime]\n\n    classes.each do |clazz|\n      context \"with a #{clazz.name} class\" do\n        instance_exec clazz, &block\n      end\n    end\n  end\n\n  describe \".between\" do\n    with_each_class do |clazz|\n      it \"returns a new TimeDifference instance in each component\" do\n        start_time = clazz.new(2011, 1)\n        end_time = clazz.new(2011, 12)\n\n        expect(TimeDifference.between(start_time, end_time)).to be_a(TimeDifference)\n      end\n    end\n  end\n\n  describe \"#in_each_component\" do\n    with_each_class do |clazz|\n      it \"returns time difference in each component\" do\n        start_time = clazz.new(2011, 1)\n        end_time = clazz.new(2011, 12)\n\n        expect(TimeDifference.between(start_time, end_time).in_each_component).to eql({years: 0.91, months: 10.98, weeks: 47.71, days: 334.0, hours: 8016.0, minutes: 480960.0, seconds: 28857600.0})\n      end\n    end\n  end\n\n  describe \"#in_general\" do\n    with_each_class do |clazz|\n      it \"returns time difference in general that matches the total seconds\" do\n        start_time = clazz.new(2009, 11)\n        end_time = clazz.new(2011, 1)\n\n        expect(TimeDifference.between(start_time, end_time).in_general).to eql({years: 1, months: 2, weeks: 0, days: 0, hours: 0, minutes: 0, seconds: 0})\n      end\n    end\n  end\n\n  describe \"#humanize\" do\n    with_each_class do |clazz|\n      it \"returns a string representing the time difference from in_general\" do\n        start_time = clazz.new(2009, 11)\n        end_time = clazz.new(2011, 1)\n\n        expect(TimeDifference.between(start_time, end_time).humanize).to eql(\"1 Year and 2 Months\")\n      end\n    end\n  end\n\n  describe \"#in_years\" do\n    with_each_class do |clazz|\n      it \"returns time difference in years based on Wolfram Alpha\" do\n        start_time = clazz.new(2011, 1)\n        end_time = clazz.new(2011, 12)\n\n        expect(TimeDifference.between(start_time, end_time).in_years).to eql(0.91)\n      end\n\n      it \"returns an absolute difference\" do\n        start_time = clazz.new(2011, 12)\n        end_time = clazz.new(2011, 1)\n\n        expect(TimeDifference.between(start_time, end_time).in_years).to eql(0.91)\n      end\n    end\n  end\n\n  describe \"#in_months\" do\n    with_each_class do |clazz|\n      it \"returns time difference in months based on Wolfram Alpha\" do\n        start_time = clazz.new(2011, 1)\n        end_time = clazz.new(2011, 12)\n\n        expect(TimeDifference.between(start_time, end_time).in_months).to eql(10.98)\n      end\n\n      it \"returns an absolute difference\" do\n        start_time = clazz.new(2011, 12)\n        end_time = clazz.new(2011, 1)\n\n        expect(TimeDifference.between(start_time, end_time).in_months).to eql(10.98)\n      end\n    end\n  end\n\n  describe \"#in_weeks\" do\n    with_each_class do |clazz|\n      it \"returns time difference in weeks based on Wolfram Alpha\" do\n        start_time = clazz.new(2011, 1)\n        end_time = clazz.new(2011, 12)\n\n        expect(TimeDifference.between(start_time, end_time).in_weeks).to eql(47.71)\n      end\n\n      it \"returns an absolute difference\" do\n        start_time = clazz.new(2011, 12)\n        end_time = clazz.new(2011, 1)\n\n        expect(TimeDifference.between(start_time, end_time).in_weeks).to eql(47.71)\n      end\n    end\n  end\n\n  describe \"#in_days\" do\n    with_each_class do |clazz|\n      it \"returns time difference in weeks based on Wolfram Alpha\" do\n        start_time = clazz.new(2011, 1)\n        end_time = clazz.new(2011, 12)\n\n        expect(TimeDifference.between(start_time, end_time).in_days).to eql(334.0)\n      end\n\n      it \"returns an absolute difference\" do\n        start_time = clazz.new(2011, 12)\n        end_time = clazz.new(2011, 1)\n\n        expect(TimeDifference.between(start_time, end_time).in_days).to eql(334.0)\n      end\n    end\n  end\n\n  describe \"#in_hours\" do\n    with_each_class do |clazz|\n      it \"returns time difference in hours based on Wolfram Alpha\" do\n        start_time = clazz.new(2011, 1)\n        end_time = clazz.new(2011, 12)\n\n        expect(TimeDifference.between(start_time, end_time).in_hours).to eql(8016.0)\n      end\n\n      it \"returns an absolute difference\" do\n        start_time = clazz.new(2011, 12)\n        end_time = clazz.new(2011, 1)\n\n        expect(TimeDifference.between(start_time, end_time).in_hours).to eql(8016.0)\n      end\n    end\n  end\n\n  describe \"#in_minutes\" do\n    with_each_class do |clazz|\n      it \"returns time difference in minutes based on Wolfram Alpha\" do\n        start_time = clazz.new(2011, 1)\n        end_time = clazz.new(2011, 12)\n\n        expect(TimeDifference.between(start_time, end_time).in_minutes).to eql(480960.0)\n      end\n\n      it \"returns an absolute difference\" do\n        start_time = clazz.new(2011, 12)\n        end_time = clazz.new(2011, 1)\n\n        expect(TimeDifference.between(start_time, end_time).in_minutes).to eql(480960.0)\n      end\n    end\n  end\n\n  describe \"#in_seconds\" do\n    with_each_class do |clazz|\n      it \"returns time difference in seconds based on Wolfram Alpha\" do\n        start_time = clazz.new(2011, 1)\n        end_time = clazz.new(2011, 12)\n\n        expect(TimeDifference.between(start_time, end_time).in_seconds).to eql(28857600.0)\n      end\n\n      it \"returns an absolute difference\" do\n        start_time = clazz.new(2011, 12)\n        end_time = clazz.new(2011, 1)\n\n        expect(TimeDifference.between(start_time, end_time).in_seconds).to eql(28857600.0)\n      end\n    end\n  end\nend\n"
  },
  {
    "path": "time_difference.gemspec",
    "content": "# -*- encoding: utf-8 -*-\nGem::Specification.new do |gem|\n  gem.authors       = [\"TM Lee\"]\n  gem.email         = [\"tmlee.ltm@gmail.com\"]\n  gem.description   = \"TimeDifference is the missing Ruby method to calculate difference between two given time. You can do a Ruby time difference in year, month, week, day, hour, minute, and seconds.\"\n  gem.summary       = \"TimeDifference is the missing Ruby method to calculate difference between two given time. You can do a Ruby time difference in year, month, week, day, hour, minute, and seconds.\"\n  gem.homepage      = \"\"\n\n  gem.files         = `git ls-files`.split($\\)\n  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }\n  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})\n  gem.name          = \"time_difference\"\n  gem.require_paths = [\"lib\"]\n  gem.version       = \"0.7.0\"\n  gem.license = 'MIT'\n\n  gem.add_runtime_dependency('activesupport', '~> 5.1')\n  gem.add_development_dependency('rspec', '~> 3.7.0')\n  gem.add_development_dependency('rake')\n\nend\n"
  }
]