ta_by_star 4.0.0

data/spec/integration/shared/by_calendar_month.rb

@@ -0,0 +1,55 @@
+require 'spec_helper'
+
+shared_examples_for 'by calendar month' do
+
+  describe '#by_calendar_month' do
+
+    context 'point-in-time' do
+      subject { Post.by_calendar_month('Feb') }
+      it { expect(subject.count).to eql(3) }
+    end
+
+    context 'timespan' do
+      subject { Event.by_calendar_month(1) }
+      it { expect(subject.count).to eql(10) }
+    end
+
+    context 'timespan strict' do
+      subject { Event.by_calendar_month(Date.parse('2014-02-01'), strict: true) }
+      it { expect(subject.count).to eql(2) }
+    end
+
+    context 'with :year option' do
+
+      context 'point-in-time' do
+        subject { Post.by_calendar_month(12, year: 2013) }
+        it { expect(subject.count).to eql(12) }
+      end
+
+      context 'timespan' do
+        subject { Event.by_calendar_month('December', year: 2013) }
+        it { expect(subject.count).to eql(13) }
+      end
+
+      context 'timespan strict' do
+        subject { Event.by_calendar_month('Dec', year: 2013, strict: true) }
+        it { expect(subject.count).to eql(9) }
+      end
+    end
+
+    it 'should raise an error when given an invalid argument' do
+      expect{ Post.by_calendar_month(0) }.to raise_error(ByStar::ParseError, 'Month must be a number between 1 and 12 or a month name')
+      expect{ Post.by_calendar_month(13) }.to raise_error(ByStar::ParseError, 'Month must be a number between 1 and 12 or a month name')
+      expect{ Post.by_calendar_month('foobar') }.to raise_error(ByStar::ParseError, 'Month must be a number between 1 and 12 or a month name')
+    end
+
+    it 'should be able to use an alternative field' do
+      expect(Event.by_calendar_month(field: 'end_time').count).to eql(9)
+    end
+
+    context ':start_day option' do
+      subject { Post.by_calendar_month(1, start_day: :wednesday) }
+      it{ expect(subject.count).to eql(7) }
+    end
+  end
+end

data/spec/integration/shared/by_cweek.rb

@@ -0,0 +1,54 @@
+require 'spec_helper'
+
+shared_examples_for 'by cweek' do
+
+  describe '#by_cweek' do
+
+    context 'point-in-time' do
+      subject { Post.by_cweek('2014-01-02') }
+      it { expect(subject.count).to eql(4) }
+    end
+
+    context 'timespan' do
+      subject { Event.by_cweek(1) }
+      it { expect(subject.count).to eql(7) }
+    end
+
+    context 'timespan strict' do
+      subject { Event.by_cweek(Date.parse('2014-01-01'), strict: true) }
+      it { expect(subject.count).to eql(0) }
+    end
+
+    context 'with :year option' do
+
+      context 'point-in-time' do
+        subject { Post.by_cweek(53, year: 2013) }
+        it { expect(subject.count).to eql(4) }
+      end
+
+      context 'timespan' do
+        subject { Event.by_cweek(53, year: 2013) }
+        it { expect(subject.count).to eql(7) }
+      end
+
+      context 'timespan strict' do
+        subject { Event.by_cweek(53, year: 2013, strict: true) }
+        it { expect(subject.count).to eql(0) }
+      end
+    end
+
+    it 'should raise an error when given an invalid argument' do
+      expect { Post.by_cweek(0) }.to raise_error(ByStar::ParseError, 'cweek number must be between 1 and 53')
+      expect { Post.by_cweek(54) }.to raise_error(ByStar::ParseError, 'cweek number must be between 1 and 53')
+    end
+
+    it 'should be able to use an alternative field' do
+      expect(Event.by_cweek(field: 'end_time').count).to eq 3
+    end
+
+    context ':start_day option' do
+      subject { Post.by_cweek('2014-01-02', start_day: :thursday) }
+      it { expect(subject.count).to eql(1) }
+    end
+  end
+end

data/spec/integration/shared/by_day.rb

@@ -0,0 +1,120 @@
+require 'spec_helper'
+
+shared_examples_for 'by day' do
+
+  describe '#by_day' do
+
+    context 'point-in-time' do
+      it { expect(Post.by_day('2014-01-01').count).to eql(2) }
+    end
+
+    context 'timespan' do
+      it { expect(Event.by_day(Time.zone.parse '2014-01-01').count).to eql(5) }
+    end
+
+    context 'timespan strict' do
+      it { expect(Event.by_day(Date.parse('2014-01-01'), strict: true).count).to eql(0) }
+    end
+
+    it 'should be able to use an alternative field' do
+      expect(Event.by_day(field: 'end_time').count).to eql(0)
+    end
+
+    it 'should support :offset option' do
+      expect(Post.by_day('2014-01-01', offset: -16.hours).count).to eq(1)
+    end
+
+    context 'when DST starts (Sydney)', sydney: true do
+      context 'day before' do
+        subject { Event.by_day('2020-04-04', offset: 5.hours) }
+        it { expect(subject.count).to eq(3) }
+      end
+
+      context 'same day' do
+        subject { Event.by_day('2020-04-05', offset: 5.hours) }
+        it { expect(subject.count).to eq(1) }
+      end
+    end
+
+    context 'when DST ends (Sydney)', sydney: true do
+      context 'day before' do
+        subject { Event.by_day('2020-10-03', offset: 5.hours) }
+        it { expect(subject.count).to eq(1) }
+      end
+
+      context 'same day' do
+        subject { Event.by_day('2020-10-04', offset: 5.hours) }
+        it { expect(subject.count).to eq(3) }
+      end
+    end
+  end
+
+  describe '#today' do # 2014-01-01
+
+    context 'point-in-time' do
+      it { expect(Post.today.count).to eql(2) }
+    end
+
+    context 'timespan' do
+      it { expect(Event.today.count).to eql(5) }
+    end
+
+    context 'timespan strict' do
+      it { expect(Event.today(strict: true).count).to eql(0) }
+    end
+
+    it 'should be able to use an alternative field' do
+      expect(Event.today(field: 'created_at').count).to eql(2)
+    end
+
+    it 'should support :offset option' do
+      expect(Post.today(offset: -24.hours).count).to eql(1)
+    end
+  end
+
+  describe '#yesterday' do # 2013-12-31
+
+    context 'point-in-time' do
+      it { expect(Post.yesterday.count).to eql(1) }
+    end
+
+    context 'timespan' do
+      it { expect(Event.yesterday.count).to eql(5) }
+    end
+
+    context 'timespan strict' do
+      it { expect(Event.yesterday(strict: true).count).to eql(0) }
+    end
+
+    it 'should be able to use an alternative field' do
+      expect(Event.yesterday(field: 'created_at').count).to eql(1)
+    end
+
+    it 'should support :offset option' do
+      expect(Post.yesterday(offset: 24.hours).count).to eql(2)
+    end
+  end
+
+  describe '#tomorrow' do # 2014-01-02
+
+    context 'point-in-time' do
+      it { expect(Post.tomorrow.count).to eql(0) }
+    end
+
+    context 'timespan' do
+      it { expect(Event.tomorrow.count).to eql(5) }
+    end
+
+    context 'timespan strict' do
+      it { expect(Event.tomorrow(strict: true).count).to eql(0) }
+    end
+
+    it 'should be able to use an alternative field' do
+      expect(Event.tomorrow(field: 'created_at').count).to eql(0)
+    end
+
+    it 'should support :offset option' do
+      expect(Post.tomorrow(offset: -24.hours).count).to eql(2)
+    end
+  end
+end

data/spec/integration/shared/by_direction.rb

@@ -0,0 +1,126 @@
+require 'spec_helper'
+
+shared_examples_for 'by direction' do
+
+  describe '#before' do
+
+    context 'point-in-time' do
+      subject { Post.before(Date.parse '2014-01-05') }
+      it { expect(subject.count).to eql(12) }
+    end
+
+    context 'timespan default' do
+      subject { Event.before(Time.zone.parse '2014-01-05') }
+      it { expect(subject.count).to eql(13) }
+    end
+
+    context 'timespan strict' do
+      subject { Event.before('2014-01-05', strict: true) }
+      it { expect(subject.count).to eql(13) }
+    end
+
+    context 'timespan not strict' do
+      subject { Event.before('2014-01-05', strict: false) }
+      it { expect(subject.count).to eql(13) }
+    end
+
+    context 'alternative field' do
+      subject { Event.before('2014-01-05', field: 'created_at') }
+      it { expect(subject.count).to eql(20) }
+    end
+
+    context 'with default scope' do
+      subject { Appointment.before('2014-01-05', field: 'created_at') }
+      it { expect(subject.count).to eql(12) }
+    end
+  end
+
+  describe '#after' do
+
+    context 'point-in-time' do
+      subject { Post.after('2014-01-05') }
+      it { expect(subject.count).to eql(10) }
+    end
+
+    context 'timespan default' do
+      subject { Event.after(Date.parse '2014-01-05') }
+      it { expect(subject.count).to eql(17) }
+    end
+
+    context 'timespan strict' do
+      subject { Event.after('2014-01-05', strict: true) }
+      it { expect(subject.count).to eql(17) }
+    end
+
+    context 'timespan not strict' do
+      subject { Event.after('2014-01-05', strict: false) }
+      it { expect(subject.count).to eql(17) }
+    end
+
+    context 'alternative field' do
+      subject { Event.after('2014-01-05', field: 'created_at') }
+      it { expect(subject.count).to eql(10) }
+    end
+
+    context 'with default scope' do
+      subject { Appointment.after('2014-01-05', field: 'created_at') }
+      it { expect(subject.count).to eql(10) }
+    end
+  end
+
+  describe '#oldest and #newest' do
+    context 'point-in-time' do
+      it { expect(Post.newest.created_at).to eq Time.zone.parse('2014-04-15 17:00:00') }
+      it { expect(Post.oldest.created_at).to eq Time.zone.parse('2013-11-01 17:00:00') }
+    end
+
+    context 'timespan' do
+      it { expect(Event.newest.created_at).to eq Time.zone.parse('2011-01-01 00:00:00') }
+      it { expect(Event.oldest.created_at).to eq Time.zone.parse('2013-11-01 17:00:00') }
+    end
+
+    context 'timespan strict' do
+      it { expect(Event.newest(strict: true).created_at).to eq Time.zone.parse('2011-01-01 00:00:00') }
+      it { expect(Event.oldest(strict: true).created_at).to eq Time.zone.parse('2013-11-01 17:00:00') }
+    end
+
+    context 'alternative field' do
+      it { expect(Event.newest(field: 'created_at').created_at).to eq Time.zone.parse('2014-04-15 17:00:00') }
+      it { expect(Event.oldest(field: 'created_at').created_at).to eq Time.zone.parse('2011-01-01 00:00:00') }
+    end
+
+    context 'with default scope' do
+      it { expect(Appointment.newest(field: 'created_at').created_at).to eq Time.zone.parse('2014-04-15 17:00:00') }
+      it { expect(Appointment.oldest(field: 'created_at').created_at).to eq Time.zone.parse('2013-11-01 17:00:00') }
+    end
+  end
+
+  describe '#previous and #next' do
+
+    context 'point-in-time' do
+      subject { Post.where(created_at: Time.zone.parse('2014-01-10 17:00:00')).first }
+      it{ expect(subject.previous.created_at).to eq Time.zone.parse('2014-01-05 17:00:00') }
+      it{ expect(subject.next.created_at).to eq Time.zone.parse('2014-01-12 17:00:00') }
+    end
+
+    context 'timespan' do
+      subject { Event.where(start_time: Time.zone.parse('2014-01-05 17:00:00')).first }
+      it{ expect(subject.previous.start_time).to eq Time.zone.parse('2013-12-31 17:00:00') }
+      it{ expect(subject.next.start_time).to eq Time.zone.parse('2014-01-07 17:00:00') }
+    end
+
+    context 'with default scope' do
+      subject { Appointment.where(created_at: Time.zone.parse('2014-01-05 17:00:00')).first }
+      it{ expect(subject.previous.created_at).to eq Time.zone.parse('2014-01-01 17:00:00') }
+      it{ expect(subject.next.created_at).to eq Time.zone.parse('2014-01-10 17:00:00') }
+    end
+
+    context 'specify a field' do
+      subject { Post.where(created_at: Time.zone.parse('2014-01-01 17:00:00')).first }
+      it{ expect(subject.previous.created_at).to eq Time.zone.parse('2013-12-31 17:00:00') }
+      it{ expect(subject.next.created_at).to eq Time.zone.parse('2014-01-05 17:00:00') }
+      it{ expect(subject.previous(field: 'updated_at').created_at).to eq Time.zone.parse('2013-12-31 17:00:00') }
+      it{ expect(subject.next(field: 'updated_at').created_at).to eq Time.zone.parse('2014-01-01 17:00:00') }
+    end
+  end
+end

data/spec/integration/shared/by_fortnight.rb

@@ -0,0 +1,48 @@
+require 'spec_helper'
+
+shared_examples_for 'by fortnight' do
+
+  describe '#by_fortnight' do
+
+    context 'point-in-time' do
+      subject { Post.by_fortnight('2014-01-01') }
+      it { expect(subject.count).to eql(5) }
+    end
+
+    context 'timespan' do
+      subject { Event.by_fortnight(0) }
+      it { expect(subject.count).to eql(7) }
+    end
+
+    context 'timespan strict' do
+      subject { Event.by_fortnight(Date.parse('2014-01-01'), strict: true) }
+      it { expect(subject.count).to eql(0) }
+    end
+
+    context 'with :year option' do
+
+      context 'point-in-time' do
+        subject { Post.by_fortnight(26, year: 2013) }
+        it { expect(subject.count).to eql(6) }
+      end
+
+      context 'timespan' do
+        subject { Event.by_fortnight(26, year: 2013) }
+        it { expect(subject.count).to eql(7) }
+      end
+
+      context 'timespan strict' do
+        subject { Event.by_fortnight(26, year: 2013, strict: true) }
+        it { expect(subject.count).to eql(1) }
+      end
+    end
+
+    it 'should raise an error when given an invalid argument' do
+      expect { Post.by_fortnight(27) }.to raise_error(ByStar::ParseError, 'Fortnight number must be between 0 and 26')
+    end
+
+    it 'should be able to use an alternative field' do
+      expect(Event.by_fortnight(field: 'end_time').count).to eq 5
+    end
+  end
+end

data/spec/integration/shared/by_month.rb

@@ -0,0 +1,50 @@
+require 'spec_helper'
+
+shared_examples_for 'by month' do
+
+  describe '#by_month' do
+
+    context 'point-in-time' do
+      subject { Post.by_month('Feb') }
+      it { expect(subject.count).to eql(2) }
+    end
+
+    context 'timespan' do
+      subject { Event.by_month(1) }
+      it { expect(subject.count).to eql(9) }
+    end
+
+    context 'timespan strict' do
+      subject { Event.by_month(Date.parse('2014-02-01'), strict: true) }
+      it { expect(subject.count).to eql(1) }
+    end
+
+    context 'with :year option' do
+
+      context 'point-in-time' do
+        subject { Post.by_month(12, year: 2013) }
+        it { expect(subject.count).to eql(8) }
+      end
+
+      context 'timespan' do
+        subject { Event.by_month('December', year: 2013) }
+        it { expect(subject.count).to eql(12) }
+      end
+
+      context 'timespan strict' do
+        subject { Event.by_month('Dec', year: 2013, strict: true) }
+        it { expect(subject.count).to eql(4) }
+      end
+    end
+
+    it 'should raise an error when given an invalid argument' do
+      expect{ Post.by_month(0) }.to raise_error(ByStar::ParseError, 'Month must be a number between 1 and 12 or a month name')
+      expect{ Post.by_month(13) }.to raise_error(ByStar::ParseError, 'Month must be a number between 1 and 12 or a month name')
+      expect{ Post.by_month('foobar') }.to raise_error(ByStar::ParseError, 'Month must be a number between 1 and 12 or a month name')
+    end
+
+    it 'should be able to use an alternative field' do
+      expect(Event.by_month(field: 'end_time').count).to eq 8
+    end
+  end
+end

data/spec/integration/shared/by_quarter.rb

@@ -0,0 +1,49 @@
+require 'spec_helper'
+
+shared_examples_for 'by quarter' do
+
+  describe '#by_quarter' do
+
+    context 'point-in-time' do
+      subject { Post.by_quarter(2) }
+      it { expect(subject.count).to eql(2) }
+    end
+
+    context 'timespan' do
+      subject { Event.by_quarter(1) }
+      it { expect(subject.count).to eql(13) }
+    end
+
+    context 'timespan strict' do
+      subject { Event.by_quarter(Date.parse('2014-02-01'), strict: true) }
+      it { expect(subject.count).to eql(7) }
+    end
+
+    context 'with :year option' do
+
+      context 'point-in-time' do
+        subject { Post.by_quarter(4, year: 2013) }
+        it { expect(subject.count).to eql(10) }
+      end
+
+      context 'timespan' do
+        subject { Event.by_quarter(4, year: 2013) }
+        it { expect(subject.count).to eql(13) }
+      end
+
+      context 'timespan strict' do
+        subject { Event.by_quarter(4, year: 2013, strict: true) }
+        it { expect(subject.count).to eql(8) }
+      end
+    end
+
+    it 'should raise an error when given an invalid argument' do
+      expect{ Post.by_quarter(0) }.to raise_error(ByStar::ParseError, 'Quarter number must be between 1 and 4')
+      expect{ Post.by_quarter(5) }.to raise_error(ByStar::ParseError, 'Quarter number must be between 1 and 4')
+    end
+
+    it 'should be able to use an alternative field' do
+      expect(Event.by_quarter(1, field: 'end_time').count).to eq 12
+    end
+  end
+end

data/spec/integration/shared/by_week.rb

@@ -0,0 +1,54 @@
+require 'spec_helper'
+
+shared_examples_for 'by week' do
+
+  describe '#by_week' do
+
+    context 'point-in-time' do
+      subject { Post.by_week('2014-01-02') }
+      it { expect(subject.count).to eql(4) }
+    end
+
+    context 'timespan' do
+      subject { Event.by_week(0) }
+      it { expect(subject.count).to eql(7) }
+    end
+
+    context 'timespan strict' do
+      subject { Event.by_week(Date.parse('2014-01-01'), strict: true) }
+      it { expect(subject.count).to eql(0) }
+    end
+
+    context 'with :year option' do
+
+      context 'point-in-time' do
+        subject { Post.by_week(52, year: 2013) }
+        it { expect(subject.count).to eql(4) }
+      end
+
+      context 'timespan' do
+        subject { Event.by_week(52, year: 2013) }
+        it { expect(subject.count).to eql(7) }
+      end
+
+      context 'timespan strict' do
+        subject { Event.by_week(52, year: 2013, strict: true) }
+        it { expect(subject.count).to eql(0) }
+      end
+    end
+
+    it 'should raise an error when given an invalid argument' do
+      expect { Post.by_week(-1) }.to raise_error(ByStar::ParseError, 'Week number must be between 0 and 52')
+      expect { Post.by_week(53) }.to raise_error(ByStar::ParseError, 'Week number must be between 0 and 52')
+    end
+
+    it 'should be able to use an alternative field' do
+      expect(Event.by_week(field: 'end_time').count).to eq 3
+    end
+
+    context ':start_day option' do
+      subject { Post.by_week('2014-01-02', start_day: :thursday) }
+      it { expect(subject.count).to eql(1) }
+    end
+  end
+end

data/spec/integration/shared/by_weekend.rb

@@ -0,0 +1,49 @@
+require 'spec_helper'
+
+shared_examples_for 'by weekend' do
+
+  describe '#by_weekend' do
+
+    context 'point-in-time' do
+      subject { Post.by_weekend('2014-01-01') }
+      it { expect(subject.count).to eql(1) }
+    end
+
+    context 'timespan' do
+      subject { Event.by_weekend(0) }
+      it { expect(subject.count).to eql(5) }
+    end
+
+    context 'timespan strict' do
+      subject { Event.by_weekend(Date.parse('2014-01-01'), strict: true) }
+      it { expect(subject.count).to eql(0) }
+    end
+
+    context 'with :year option' do
+
+      context 'point-in-time' do
+        subject { Post.by_weekend(52, year: 2013) }
+        it { expect(subject.count).to eql(1) }
+      end
+
+      context 'timespan' do
+        subject { Event.by_weekend(52, year: 2013) }
+        it { expect(subject.count).to eql(5) }
+      end
+
+      context 'timespan strict' do
+        subject { Event.by_weekend(52, year: 2013, strict: true) }
+        it { expect(subject.count).to eql(0) }
+      end
+    end
+
+    it 'should raise an error when given an invalid argument' do
+      expect { Post.by_weekend(-1) }.to raise_error(ByStar::ParseError, 'Week number must be between 0 and 52')
+      expect { Post.by_weekend(53) }.to raise_error(ByStar::ParseError, 'Week number must be between 0 and 52')
+    end
+
+    it 'should be able to use an alternative field' do
+      expect(Event.by_weekend(field: 'end_time').count).to eq 1
+    end
+  end
+end

data/spec/integration/shared/by_year.rb

@@ -0,0 +1,48 @@
+require 'spec_helper'
+
+shared_examples_for 'by year' do
+
+  describe '#by_year' do
+
+    context 'point-in-time' do
+      subject { Post.by_year('2014') }
+      it { expect(subject.count).to eql(12) }
+    end
+
+    context 'timespan' do
+      subject { Event.by_year(13) }
+      it { expect(subject.count).to eql(13) }
+    end
+
+    context 'timespan strict' do
+      subject { Event.by_year(Date.parse('2014-02-01'), strict: true) }
+      it { expect(subject.count).to eql(9) }
+    end
+
+    context 'integer' do
+
+      context 'point-in-time' do
+        subject { Post.by_year(2013) }
+        it { expect(subject.count).to eql(10) }
+      end
+
+      context 'timespan' do
+        subject { Event.by_year(2014) }
+        it { expect(subject.count).to eql(14) }
+      end
+
+      context 'timespan strict' do
+        subject { Event.by_year(2013, strict: true) }
+        it { expect(subject.count).to eql(8) }
+      end
+    end
+
+    it 'should be able to use an alternative field' do
+      expect(Event.by_year(field: 'end_time').count).to eq 14
+    end
+
+    it 'can use a 2-digit year' do
+      expect(Post.by_year(13).count).to eq 10
+    end
+  end
+end