duranged 0.0.1

data/spec/duranged_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+
+RSpec.describe Duranged do
+  describe 'duration' do
+    it 'returns a Duranged::Duration' do
+      expect(subject.duration(300.seconds)).to be_an_instance_of(Duranged::Duration)
+    end
+  end
+
+  describe 'range' do
+    it 'returns a Duranged::Range' do
+      expect(subject.range(Time.now, (Time.now + 300.seconds))).to be_an_instance_of(Duranged::Range)
+    end
+  end
+end

data/spec/shared/base_examples.rb

@@ -0,0 +1,224 @@
+RSpec.shared_examples "a hash method" do |method|
+  it 'returns a hash of the days, hours, minutes and seconds' do
+    expect(subject.send(method)).to eq({years: 0, months: 0, weeks: 0, days_after_weeks: 1, days: 1, hours: 0, minutes: 2, seconds: 2})
+  end
+end
+
+RSpec.shared_examples "a format conversion" do |period, formatter|
+  context "using the #{period} formatter %#{formatter}" do
+    it 'returns the formatted string' do
+      expect(subject.strfdur("%#{formatter}")).to eq subject.send(:zero_pad, subject.send(period)) % subject.send(period)
+    end
+    
+    context 'with a padding modifier' do
+      it 'uses the provided padding' do
+        expect(subject.strfdur("%5#{formatter}")).to eq subject.send(:zero_pad, subject.send(period), 5) % subject.send(period)
+      end
+
+      context 'with a padding negator' do
+        it 'strips all padding' do
+          expect(subject.strfdur("%-5#{formatter}")).to eq (subject.send(:zero_pad, subject.send(period), 5) % subject.send(period)).to_i.to_s.lstrip
+        end
+      end
+    end
+
+    context 'with a padding negator' do
+      it 'strips all padding' do
+        expect(subject.strfdur("%-#{formatter}")).to eq (subject.send(:zero_pad, subject.send(period)) % subject.send(period)).to_i.to_s.lstrip
+      end
+    end
+
+    context 'when using the space padding flag' do
+      it 'returns the formatted string' do
+        expect(subject.strfdur("%_#{formatter}")).to eq subject.send(:space_pad, subject.send(period)) % subject.send(period)
+      end
+
+      context 'with a padding modifier' do
+        it 'uses the provided padding' do
+          expect(subject.strfdur("%_5#{formatter}")).to eq subject.send(:space_pad, subject.send(period), 5) % subject.send(period)
+        end
+      end
+    end
+  end
+end
+
+RSpec.shared_examples "a complex format string" do |duration, formatter, string|
+  context "using complex formatter '#{formatter}'" do
+    subject { Duranged::Duration.new(duration) }
+
+    it "returns '#{string}'" do
+      expect(subject.strfdur(formatter)).to eq string
+    end
+  end
+end
+
+RSpec.shared_examples "the base class" do |klass|
+  subject { klass.new(86522.seconds) }
+
+  describe 'dump' do
+    it 'dumps the value as an integer' do
+      expect(klass.dump(subject)).to eq subject.to_json
+    end
+  end
+
+  describe 'load' do
+    it 'creates a new value from the integer' do
+      expect(klass.load(subject.to_json)).to be_an_instance_of klass
+      expect(klass.load(subject.to_json).to_json).to eq subject.to_json
+    end
+  end
+
+  describe '#initialize' do
+    context 'when passed an integer' do
+      it 'sets the value to the integer value' do
+        expect(subject.value).to eq 86522
+      end
+    end
+
+    context 'when passed a hash' do
+      subject { klass.new({days: 1, hours: 0, minutes: 2, seconds: 2}) }
+
+      it 'parses the hash keys into time values and sums them' do
+        expect(subject.value).to eq 86522
+      end
+    end
+
+    context 'when passed a parseable string' do
+      subject { klass.new("1 day, 2 minutes, 2 seconds") }
+
+      it 'parses the hash keys into time values and sums them' do
+        expect(subject.value).to eq 86522
+      end
+    end
+  end
+
+  describe '#days?' do
+    it 'returns the total number of days' do
+      expect(subject.days).to eq 1
+    end
+  end
+
+  describe '#hours?' do
+    it 'returns the remainder of hours' do
+      expect(subject.hours).to eq 0
+    end
+  end
+
+  describe '#minutes?' do
+    it 'returns the remainder of minutes' do
+      expect(subject.minutes).to eq 2
+    end
+  end
+
+  describe '#seconds?' do
+    it 'returns the remainder of seconds' do
+      expect(subject.seconds).to eq 2
+    end
+  end
+
+  describe '#+' do
+    context 'when passed an integer' do
+      it 'returns an instance of the same class' do
+        expect(subject + 20).to be_an_instance_of subject.class
+      end
+
+      it 'adds the integer to the value' do
+        expect((subject + 20).value).to eq (subject.value + 20)
+      end
+    end
+
+    context 'when passed a duration' do
+      it 'returns an instance of the same class' do
+        expect(subject + Duranged::Duration.new(20)).to be_an_instance_of subject.class
+      end
+
+      it 'adds the duration to the value' do
+        expect((subject + Duranged::Duration.new(20)).value).to eq (subject.value + 20)
+      end
+    end
+
+    context 'when passed an interval' do
+      it 'returns an instance of the same class' do
+        expect(subject + Duranged::Interval.new(20)).to be_an_instance_of subject.class
+      end
+
+      it 'adds the interval to the value' do
+        expect((subject + Duranged::Interval.new(20)).value).to eq (subject.value + 20)
+      end
+    end
+  end
+
+  describe '#-' do
+    context 'when passed an integer' do
+      it 'returns an instance of the same class' do
+        expect(subject - 20).to be_an_instance_of subject.class
+      end
+
+      it 'adds the integer to the value' do
+        expect((subject - 20).value).to eq (subject.value - 20)
+      end
+    end
+
+    context 'when passed a duration' do
+      it 'returns an instance of the same class' do
+        expect(subject - Duranged::Duration.new(20)).to be_an_instance_of subject.class
+      end
+
+      it 'adds the duration to the value' do
+        expect((subject - Duranged::Duration.new(20)).value).to eq (subject.value - 20)
+      end
+    end
+
+    context 'when passed an interval' do
+      it 'returns an instance of the same class' do
+        expect(subject - Duranged::Interval.new(20)).to be_an_instance_of subject.class
+      end
+
+      it 'adds the interval to the value' do
+        expect((subject - Duranged::Interval.new(20)).value).to eq (subject.value - 20)
+      end
+    end
+  end
+
+  describe '#as_json' do
+    it 'returns the value integer' do
+      expect(subject.as_json).to eq subject.value
+    end
+  end
+
+  describe '#to_h' do
+    it_behaves_like "a hash method", :to_h
+  end
+
+  describe '#to_s' do
+    context 'when no format is specified' do
+      it 'returns a string using the default format' do
+        expect(subject.to_s).to eq '1 day, 2 minutes, 2 seconds'
+      end
+    end
+  end
+
+  describe '#strfdur' do
+    context 'when no format is provided' do
+      it 'raises an ArgumentError' do
+        expect { subject.strfdur }.to raise_error(ArgumentError)
+      end
+    end
+
+    context 'when a format is specified' do
+      it_behaves_like "a format conversion", :seconds, 's'
+      it_behaves_like "a format conversion", :minutes, 'm'
+      it_behaves_like "a format conversion", :hours, 'h'
+      it_behaves_like "a format conversion", :days, 'd'
+      it_behaves_like "a format conversion", :days_after_weeks, 'D'
+      it_behaves_like "a format conversion", :weeks, 'w'
+      it_behaves_like "a format conversion", :months, 'M'
+      it_behaves_like "a format conversion", :years, 'y'
+
+
+      it_behaves_like "a complex format string", (3.days + 1.hour + 5.minutes + 30.seconds), '%d:%h:%m:%s', '03:01:05:30'
+      it_behaves_like "a complex format string", (5.hours + 5.minutes), '%_h hours and %m minutes', ' 5 hours and 05 minutes'
+      it_behaves_like "a complex format string", (3.days + 1.hour + 5.minutes + 30.seconds), '%-d days, %-h hour, %-m minutes, %-s seconds', '3 days, 1 hour, 5 minutes, 30 seconds'
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,78 @@
+require 'duranged'
+require 'rspec'
+require 'coveralls'
+Coveralls.wear!
+
+Dir[File.join(File.dirname(__FILE__), '..', "spec/support/**/*.rb")].each { |f| require f }
+
+RSpec.configure do |config|
+  #config.before(:suite) do
+  #  ActiveRecord::Base.establish_connection adapter: "sqlite3", database: ":memory:"
+  #  capture_stdout { load "db/schema.rb" }
+  #  load 'support/models.rb'
+  #end
+  
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    # be_bigger_than(2).and_smaller_than(4).description
+    #   # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #   # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.default_formatter = 'doc'
+  end
+
+  # Limits the available syntax to the non-monkey patched syntax that is recommended.
+  # For more details, see:
+  #   - http://myronmars.to/n/dev-blog/2012/06/rspecs-new-expectation-syntax
+  #   - http://teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   - http://myronmars.to/n/dev-blog/2014/05/notable-changes-in-rspec-3#new__config_option_to_disable_rspeccore_monkey_patching
+  config.disable_monkey_patching!
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  #config.profile_examples = 10
+
+  # These two settings work together to allow you to limit a spec run
+  # to individual examples or groups you care about by tagging them with
+  # `:focus` metadata. When nothing is tagged with `:focus`, all examples
+  # get run.
+  #config.filter_run :focus
+  #config.run_all_when_everything_filtered = true
+end

metadata

@@ -0,0 +1,136 @@
+--- !ruby/object:Gem::Specification
+name: duranged
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Mark Rebec
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-10-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: chronic_duration
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: canfig
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: API for working with durations and time ranges.
+email:
+- mark@markrebec.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/duranged.rb
+- lib/duranged/base.rb
+- lib/duranged/duration.rb
+- lib/duranged/interval.rb
+- lib/duranged/occurrence.rb
+- lib/duranged/range.rb
+- lib/duranged/version.rb
+- spec/duranged/base_spec.rb
+- spec/duranged/duration_spec.rb
+- spec/duranged/interval_spec.rb
+- spec/duranged/occurrence_spec.rb
+- spec/duranged/range_spec.rb
+- spec/duranged_spec.rb
+- spec/shared/base_examples.rb
+- spec/spec_helper.rb
+homepage: http://github.com/markrebec/duranged
+licenses: []
+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.2.2
+signing_key: 
+specification_version: 4
+summary: API for working with durations and time ranges.
+test_files:
+- spec/duranged/base_spec.rb
+- spec/duranged/duration_spec.rb
+- spec/duranged/interval_spec.rb
+- spec/duranged/occurrence_spec.rb
+- spec/duranged/range_spec.rb
+- spec/duranged_spec.rb
+- spec/shared/base_examples.rb
+- spec/spec_helper.rb