aggtive_record 0.0.1 → 0.1.2

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    NzY2MmY5YWYwNGY3NTQ2OGZjOWFkNmQ0OGMzMGY0OTBhYTI5YWU5ZQ==
+    YzUxOTY3OTI2MWVmYjg0ZWU0YzVmOTUyMjA0NzhmNGEzMTU5ODhhMg==
   data.tar.gz: !binary |-
-    OGMyYzBiZTRiYWI1NjBhYzA2YTFmYzAwY2U0YzI1MWU0MzYyYmM5Yg==
+    YmIzZWJjOGMzMzEzYTc0NzQwZjc0ODQ1YjUyNTVjZWU4ZTFhMmNmZA==
 !binary "U0hBNTEy":
   metadata.gz: !binary |-
-    MzFjZDIyMzk5MjVlOTNjYjA0ZWFlZjZhM2Q1MzcxMmUzZjQxNWQ2NTZmODRj
-    ZDFkMGIwZjNiODNhODk1NWU1Zjg2Y2UwNzFlM2E5ZDM0YTgwM2UzODA1NzA3
-    MmJkN2FiNjFjNGU1NTRkYWNiMzBmNTgyYWE1ODM3MTU2OWI2NGM=
+    ZDBhZGYwOThkN2U5NjQ4NjNiOTA1ZDdkMTA1MTE4YmNmYjI3M2VjZWQxZDg0
+    NWZkNDE2NDYxNGRiM2QxYjMwMTJmNDIwMDM2MGFhYTAzNDBhM2Y5MGFmMjQw
+    MzI3NGRiYjkzZjMwNWU5NjdiYzhkMjA4OTA5YjBkMmZhNzExYzg=
   data.tar.gz: !binary |-
-    OWYzYjlhNjgwMWZmZjc2MjBmYTUxMjEzYThmOTY0NDQ0M2VhMTg2ZTlmMzYz
-    M2FlZDQ5NzlmMGJmYTc2ZTczZmY0MDFmNGExNWQwNmUxOTE2NzFmMWUwZDRi
-    MjMwMzZlYjEzOTIyZGFiMzZkYmRmNWYyYTZiMzI2NzJmODE5NWQ=
+    ZWQyMjNiMzE3Y2ZlYzZiYmE5MWJkYjdhOWQ1NGM3ODY4YzhmYmUyZDJhNWJl
+    MTg4MWUxOWRlZThkNTYyMWM5ZWUyNWZkN2QwN2MyNzQwNmRjNDhjYzM1ZDc0
+    NzdhMGU3OWVhNGVmMDRhZjNmMDkyY2Q4Yzk4NTVjODlkYzc1ZjY=

data/.ruby-gemset

@@ -0,0 +1 @@
+aggtive_record

data/.ruby-version

@@ -0,0 +1 @@
+1.9.3-head

data/Gemfile

@@ -6,6 +6,10 @@ group :development do
   gem "bundler"
   gem "jeweler", "~> 1.8.4"
   gem 'pry'
+  gem 'database_cleaner', '~> 1.0.1'
+  gem 'mysql2'
+  gem 'activerecord', '~> 3.2.14'
 end
 
+gem 'groupdate'
 gem 'activesupport', '~> 3.2.14'

data/Gemfile.lock

@@ -1,12 +1,22 @@
 GEM
   remote: http://rubygems.org/
   specs:
+    activemodel (3.2.14)
+      activesupport (= 3.2.14)
+      builder (~> 3.0.0)
+    activerecord (3.2.14)
+      activemodel (= 3.2.14)
+      activesupport (= 3.2.14)
+      arel (~> 3.0.2)
+      tzinfo (~> 0.3.29)
     activesupport (3.2.14)
       i18n (~> 0.6, >= 0.6.4)
       multi_json (~> 1.0)
     addressable (2.3.5)
-    builder (3.2.2)
+    arel (3.0.2)
+    builder (3.0.4)
     coderay (1.0.9)
+    database_cleaner (1.0.1)
     diff-lcs (1.2.4)
     faraday (0.8.8)
       multipart-post (~> 1.2.0)
@@ -18,6 +28,8 @@ GEM
       multi_json (~> 1.4)
       nokogiri (~> 1.5.2)
       oauth2
+    groupdate (1.0.4)
+      activerecord (>= 3.0.0)
     hashie (2.0.5)
     highline (1.6.19)
     httpauth (0.2.0)
@@ -35,9 +47,10 @@ GEM
     jwt (0.1.8)
       multi_json (>= 1.5)
     method_source (0.8.2)
-    multi_json (1.7.9)
+    multi_json (1.8.0)
     multi_xml (0.5.5)
     multipart-post (1.2.0)
+    mysql2 (0.3.13)
     nokogiri (1.5.10)
     oauth2 (0.9.2)
       faraday (~> 0.8)
@@ -59,17 +72,22 @@ GEM
       rspec-expectations (~> 2.14.0)
       rspec-mocks (~> 2.14.0)
     rspec-core (2.14.5)
-    rspec-expectations (2.14.2)
+    rspec-expectations (2.14.3)
       diff-lcs (>= 1.1.3, < 2.0)
     rspec-mocks (2.14.3)
     slop (3.4.6)
+    tzinfo (0.3.37)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
+  activerecord (~> 3.2.14)
   activesupport (~> 3.2.14)
   bundler
+  database_cleaner (~> 1.0.1)
+  groupdate
   jeweler (~> 1.8.4)
+  mysql2
   pry
   rspec (~> 2.14.1)

data/README.md

@@ -61,31 +61,31 @@ This gem takes some inspiration from the highly useful groupdate.
 
     @person.messages_count_during_past_year_per_day
 
-    @person.rate_word_count_from_messages_during_past_year_per_day
+    @person.messages_rate_per_day_during_past_year
 
-    @person.count_messages_during_past_year_per_day
-    @person.messages_count_during_past_year_per_day
+    @person.messages_count_in_past_year_by_day
+    @person.messages_count_in_past_year_by_day
 
     Message.count_during_past_year
 
 
 A standard verbose call:
 
-    @person.sum_word_count_from_messages_during_past_year_per_day
+    @person.sum_word_count_from_messages_during_past_year_by_day
 
 
 *Under the hood query:*
 
-    @person.egg.sum(:word_count).
+    @person.egg.
+      collate(:sum, :word_count).
       from(:messages).
-      during(:past_year).
-      per(:day)
-
+      in(:past_year).
+      by(:day)
 *Which translates to this in ActiveRecord:*
 
     @person.messages.
       where('sent_at >= ?', 1.year.ago).
-      group('DAY(sent_at)').
+      group_by_day(:sent_at).
       sum(:word_count)
   
 
@@ -94,6 +94,46 @@ A standard verbose call:
 
 
 
-### Scalars and arrays
+### Scalars
+
+    @messages.count_during_past_year
+    @messages.rate_per_day_during_past_year
+    @messages.average_per_day_of_word_count_during_past_year
+    @messages.sum_of_word_count_during_past_year
+
+### Arrays
+*similar to groupdate*
+
+    @messages.count_in_past_year_by_day
+    @messages.count_in_past_year_by_weekday
+    @messages.count_in_past_year_by_dayhour
+    @messages.count_in_past_year_by_hour
+
+    @messages.rate_per_hour_in_past_year_by_day
+    @messages.average_per_day_of_word_count_during_past_year_by_month
+    @messages.sum_of_word_count_during_past_year_by_day
+    
+
+
+### Custom time periods
+
+    @messages.count_during_year(year: 2010)
+    @messages.count_during_years(years: 2008..2012)
+    @messages.count_during_day(day: '2012-12-01')
+    @messages.count_during_year_by_week(year: 2010, timezone: 'PST', first_day: 'Sunday')
+
+
+
+
+count
+
+rate_per
+average_per, of_numeric_value
+
+sum, of_numeric_value
+
+list_of_proper_nouns_during_past_year
+
+counted_list_of_proper_nouns_during_past_year
 
 

data/VERSION

@@ -1 +1 @@
-0.0.1
+0.1.2

data/aggtive_record.gemspec

@@ -0,0 +1,93 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "aggtive_record"
+  s.version = "0.1.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Dan Nguyen"]
+  s.date = "2013-09-23"
+  s.description = "This is not even remotely finished or even started on. Please don't download."
+  s.email = "dansonguyen@gmail.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    ".ruby-gemset",
+    ".ruby-version",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "aggtive_record.gemspec",
+    "lib/aggtive_record.rb",
+    "lib/aggtive_record/adapter.rb",
+    "lib/aggtive_record/adapter/mysql.rb",
+    "lib/aggtive_record/aggable.rb",
+    "lib/aggtive_record/egg_scopes.rb",
+    "lib/aggtive_record/egg_scopes/collation.rb",
+    "lib/aggtive_record/egg_scopes/collation/count_by.rb",
+    "lib/aggtive_record/egg_scopes/collation/rate.rb",
+    "lib/aggtive_record/egg_scopes/time_bucket.rb",
+    "lib/aggtive_record/egg_scopes/time_span.rb",
+    "lib/aggtive_record/memo.rb",
+    "lib/aggtive_record/time.rb",
+    "spec/functional/basic_object_run_spec.rb",
+    "spec/lib/aggable_spec.rb",
+    "spec/lib/count_by_spec.rb",
+    "spec/lib/rate_spec.rb",
+    "spec/lib/time_bucket_spec.rb",
+    "spec/lib/time_span_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = "http://github.com/dannguyen/aggtive_record"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "2.0.5"
+  s.summary = "A convoluted way to describe aggregations of ActiveRecords over a datetime attribute"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<groupdate>, [">= 0"])
+      s.add_runtime_dependency(%q<activesupport>, ["~> 3.2.14"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.14.1"])
+      s.add_development_dependency(%q<bundler>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.8.4"])
+      s.add_development_dependency(%q<pry>, [">= 0"])
+      s.add_development_dependency(%q<database_cleaner>, ["~> 1.0.1"])
+      s.add_development_dependency(%q<mysql2>, [">= 0"])
+      s.add_development_dependency(%q<activerecord>, ["~> 3.2.14"])
+    else
+      s.add_dependency(%q<groupdate>, [">= 0"])
+      s.add_dependency(%q<activesupport>, ["~> 3.2.14"])
+      s.add_dependency(%q<rspec>, ["~> 2.14.1"])
+      s.add_dependency(%q<bundler>, [">= 0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
+      s.add_dependency(%q<pry>, [">= 0"])
+      s.add_dependency(%q<database_cleaner>, ["~> 1.0.1"])
+      s.add_dependency(%q<mysql2>, [">= 0"])
+      s.add_dependency(%q<activerecord>, ["~> 3.2.14"])
+    end
+  else
+    s.add_dependency(%q<groupdate>, [">= 0"])
+    s.add_dependency(%q<activesupport>, ["~> 3.2.14"])
+    s.add_dependency(%q<rspec>, ["~> 2.14.1"])
+    s.add_dependency(%q<bundler>, [">= 0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
+    s.add_dependency(%q<pry>, [">= 0"])
+    s.add_dependency(%q<database_cleaner>, ["~> 1.0.1"])
+    s.add_dependency(%q<mysql2>, [">= 0"])
+    s.add_dependency(%q<activerecord>, ["~> 3.2.14"])
+  end
+end
+

data/lib/aggtive_record.rb

@@ -4,4 +4,6 @@ module AggtiveRecord
 end
 
 
-
+require_relative 'aggtive_record/aggable'
+require_relative 'aggtive_record/time'
+require_relative 'aggtive_record/egg_scopes'

data/lib/aggtive_record/aggable.rb

@@ -2,13 +2,18 @@ module AggtiveRecord
   module Aggable
     extend ActiveSupport::Concern
 
+
     included do 
+      include AggtiveRecord::EggScopes::TimeBucket
+      include AggtiveRecord::EggScopes::TimeSpan
+      include AggtiveRecord::EggScopes::Collation
+
       class_attribute :datetime_attribute
     end
 
     module ClassMethods
-      def attr_timestamp(attname)
-        raise ArgumentError unless is_a_datetime?(att)
+      def attr_datetime(attname)
+        raise ArgumentError unless is_a_datetime?(attname)
         self.datetime_attribute = attname 
       end
 
@@ -18,12 +23,5 @@ module AggtiveRecord
     end
 
 
-    def method_missing
-
-    end
-
-    def respond_to
-
-    end
   end
 end

data/lib/aggtive_record/egg_scopes.rb

@@ -0,0 +1,10 @@
+module AggtiveRecord
+  module EggScopes
+
+  end
+end
+
+
+require_relative 'egg_scopes/time_bucket'
+require_relative 'egg_scopes/time_span'
+require_relative 'egg_scopes/collation'

data/lib/aggtive_record/egg_scopes/collation.rb

@@ -0,0 +1,47 @@
+require_relative 'collation/count_by'
+require_relative 'collation/rate'
+
+module AggtiveRecord
+  module EggScopes
+    module Collation
+      extend ActiveSupport::Concern
+      include CountBy
+      include Rate
+    
+      module ClassMethods
+        # Public: a helper
+        # sorts the records after ActiveRecord query, ascending
+        #
+        # Returns a mapped array of timestamps
+        def enumerable_asc_sort(records)
+          records.map{|r| r.send(self.datetime_attribute)}.sort 
+        end
+
+        def earliest_time_of(records)
+          enumerable_asc_sort(records).first
+        end
+
+        def latest_time_of(records)
+          enumerable_asc_sort(records).last
+        end
+
+        # Public: 
+        #   records: An ActiveRecord collection
+        #
+        # Returns the number of seconds
+        # TODO - eliminate use of helper methods
+        def timespan_of(records)
+          latest_time_of(records) - earliest_time_of(records)
+        end
+
+        def timespan_to_now(records)
+          ::Time.now - earliest_time_of(records)
+        end
+
+      end
+
+
+    end
+  end
+end
+

data/lib/aggtive_record/egg_scopes/collation/count_by.rb

@@ -0,0 +1,20 @@
+module AggtiveRecord
+  module EggScopes
+    module Collation
+      module CountBy 
+        extend ActiveSupport::Concern
+
+        # Public: convenience for #by_:time_period and #count
+        # self is a ActiveRecord scope
+
+        module ClassMethods
+          def count_by(time_period)
+            span_foo = "by_#{time_period}"
+            self.send(span_foo).count
+          end
+        end
+
+      end
+    end
+  end
+end

data/lib/aggtive_record/egg_scopes/collation/rate.rb

@@ -0,0 +1,35 @@
+module AggtiveRecord
+  module EggScopes
+    module Collation
+      module Rate 
+        extend ActiveSupport::Concern
+
+        # Public: a rate
+        # expects that ActiveRelation has a grouping
+        # self is a ActiveRecord scope
+
+        module ClassMethods
+
+          # Public
+          #
+          # Returns float indicating rate of records per given time period
+          def rate_per(time_period)
+            time_period_secs = AggtiveRecord::Time.to_seconds(time_period)
+            records = self.scoped.to_a
+
+            return records.size.to_f * time_period_secs / self.timespan_to_now(records)
+          end
+        end
+
+      end
+    end
+  end
+end
+
+=begin
+ 
+Record.rate_per :hour
+      .rate_per :day
+
+
+=end

data/lib/aggtive_record/egg_scopes/time_bucket.rb

@@ -0,0 +1,30 @@
+# defines named_scopes
+
+require 'groupdate'
+module AggtiveRecord
+  module EggScopes
+    module TimeBucket
+      extend ActiveSupport::Concern
+
+      included do 
+        #TODO: refactor
+
+        # create a method for each type of groupdate
+        # e.g. by_year == group_by_year(datetime_attribute)
+        AggtiveRecord::Time.periods.each do |bucket_name|          
+          agg_foo_name = "by_#{bucket_name}".to_sym
+          groupdate_foo_name = "group_#{agg_foo_name}".to_sym
+          
+          # defining scope here, dynamically
+          scope agg_foo_name, ->(*args){
+            send( groupdate_foo_name, self.datetime_attribute )
+          }         
+        end 
+
+
+      end
+    
+
+    end
+  end
+end

data/lib/aggtive_record/egg_scopes/time_span.rb

@@ -0,0 +1,43 @@
+# defines named_scopes
+module AggtiveRecord
+  module EggScopes
+    module TimeSpan
+
+      extend ActiveSupport::Concern
+        
+
+      included do 
+
+
+        scope :past_time_periods, ->(num, period_name){ where("#{self.datetime_attribute} >= ?", num.send(period_name).send(:ago)  ) }
+
+
+        # singular time periods       
+        # e.g. scope :past_year, ->{ past_time_periods(1, :year)}
+        AggtiveRecord::Time.periods.each do |period_name|          
+          foo_name = "past_#{period_name}".to_sym
+          # defining scope here, dynamically
+          scope foo_name, ->{
+            send( :past_time_periods, 1, period_name )
+          }         
+        end 
+
+
+        # some custom time periods
+        # e.g. :past_14_days, :past_30_days
+
+        [[14, 'day'], [30, 'day'], [6, 'month']].each do |p_arr|
+          num, period = p_arr
+          foo_name = "past_#{num}_#{period.pluralize}"
+          scope foo_name, ->{
+            send( :past_time_periods, num, period)
+          }
+
+        end
+
+        
+
+      end
+    end
+  end
+end

data/lib/aggtive_record/time.rb

@@ -1,35 +1,45 @@
 module AggtiveRecord
   module Time 
 
+    # A week is always 7 * 24 * 60 * 60, for instance
     UNIFORM_PERIODS = [:week, :day, :hour, :minute, :second]
-    CALENDAR_PERIODS = [:year, :month]
-
-    PERIODS = CALENDAR_PERIODS + UNIFORM_PERIODS 
-
-    TIMESTAMP_QUANTITIES = [
-      year: {
-        str: '%Y' 
-      },
-      month:{
-        str: '%m'
-      },
-      day: {
-        str: '%d'
-      }
-      
-      hour: {
-        str: '%H'
-      },
-
-      minute: {
-        str: '%i'
-      },
-
-      second: {
-        str: '%S'
-      }
-
-    ]
+
+    # e.g. A year may have 365 days or 366
+    NON_UNIFORM_PERIODS = [:year, :month]
+
+    PERIODS = NON_UNIFORM_PERIODS + UNIFORM_PERIODS 
+
+    OTHER_PERIODS = [:day_of_week, :hour_of_day]
+
+    # todo: better naming convention
+
+
+    def self.periods
+      PERIODS + OTHER_PERIODS
+    end
+
+    SECONDS_PER_DAY = 60 * 60 * 24
+
+    # probably reinventing the wheel here...
+    def self.to_seconds(sym)
+      case sym.to_sym
+      when :year
+        SECONDS_PER_DAY * 365
+      when :month
+        SECONDS_PER_DAY * 30
+      when :week 
+        SECONDS_PER_DAY * 7
+      when :day 
+        SECONDS_PER_DAY
+      when :hour
+        60 * 60
+      when :minute
+        60
+      when :second
+        1
+      end
+    end
+
 
   end
 end

data/spec/functional/basic_object_run_spec.rb

@@ -1,6 +1,9 @@
 require 'spec_helper'
 
 require 'hashie'
+=begin
+
+IGNORE ALL OF THIS
 
 class AnObject < ActiveRecord::Base
   include AggtiveRecord
@@ -57,4 +60,5 @@ describe 'AnObject with AggtiveRecord mixedin', skip: true do
     end
   end
 
-end
+end
+=end

data/spec/lib/aggable_spec.rb

@@ -0,0 +1,37 @@
+require 'spec_helper'
+
+describe "AggtiveRecord::Aggable" do
+
+  context 'class methods' do 
+
+    describe '#is_a_datetime?' do 
+      it 'returns true if named column exists and is date/time' do 
+        expect(MusicRecord.is_a_datetime?(:published_at)).to be_true
+      end
+
+      it 'returns false if named column does not exist' do 
+        expect(MusicRecord.is_a_datetime?(:not_a_column)).to be_false
+      end
+
+
+      it 'returns false if named column is not date/time' do 
+        expect(MusicRecord.is_a_datetime?(:title)).to be_false
+      end
+    end
+
+
+    describe '#attr_datetime' do 
+      it 'sets @@datetime_attribute' do 
+#  defined in spec helper already
+#        MusicRecord.attr_datetime :published_at
+        expect(MusicRecord.datetime_attribute).to eq :published_at
+      end
+
+      it 'raises ArgumentError if not a valid datetime column' do 
+        expect{MusicRecord.attr_datetime :title}.to raise_error ArgumentError
+      end
+    end
+
+  end
+
+end

data/spec/lib/count_by_spec.rb

@@ -0,0 +1,37 @@
+require 'spec_helper'
+
+describe AggtiveRecord::EggScopes::Collation::CountBy do 
+  describe '#count_by' do 
+
+    before(:each) do 
+      @a = MusicRecord.create(
+        published_at: "2010-01-20"
+      )
+      
+      @b = MusicRecord.create(
+        published_at: "2010-03-12"
+      )
+
+      @c = MusicRecord.create(
+        published_at: "2012-05-12"
+      )
+
+      @d = MusicRecord.create(
+        published_at: "2012-05-12 15:00"
+      )
+    end
+
+    context 'basic groupdate usage' do
+      it 'can #count_by_year' do 
+        a = MusicRecord.by_year.count.select{|k,v| k.year == 2010}.first
+        b = MusicRecord.count_by(:year).select{|k,v| k.year == 2010}.first
+        expect(a).to eq b
+      end
+    end
+
+  end
+
+
+  it 'should raise error if :time_period is erroneous'
+
+end

data/spec/lib/rate_spec.rb

@@ -0,0 +1,69 @@
+require 'spec_helper'
+
+describe "AggtiveRecord::EggScopes -- .rate" do
+
+
+    describe '#rate_for' do 
+      context 'singular periods' do 
+        it 'should get about 1 a year' do 
+          @record = MusicRecord.create published_at: 12.months.ago
+          expect(MusicRecord.scoped.rate_per(:year) ).to be_within(0.1).of 1
+        end
+      end
+
+      context 'has two optional parameters' do 
+
+        before(:each) do 
+          MusicRecord.create(published_at: 1.day.ago )
+        end
+
+        let(:records){ MusicRecord.scoped }
+        
+        context 'first parameter is the :start_time' do 
+          it 'bounds range with :start_time and Time.now' do 
+            pending 'rethink'
+            expect(records.rate_per(:day, 2.days.ago)).to be_within(0.1).of 0.5
+          end
+        end
+
+        context 'second parameter is the end_time' do 
+          it 'bounds range with :start_time and :end_time' do 
+            pending 'rethink'
+            expect(records.rate_per(:day, 2.days.ago)).to be_within(0.1).of 0.5
+          end
+
+          it 'has no effect on :where' do 
+            pending('This is troublesome. What if a user calls:
+             records.past_year.rate_per(:day, 10.days.ago, 3.days.ago) 
+              -- too many surprises here!
+             ')
+          end
+        end
+
+        
+        it 'should raise an error when a non-time period is passed in'
+        it 'should play nicely with other methods'
+      end
+    end
+  
+    describe '#timespan_of' do 
+      before(:each) do 
+        @latest = 1.months.ago 
+        @earliest = 14.months.ago 
+
+        MusicRecord.create published_at: @latest
+        MusicRecord.create published_at: 2.months.ago
+        MusicRecord.create published_at: @earliest
+
+        @collection = MusicRecord.all
+      end
+
+      it 'should return a range' do
+        expect(MusicRecord.timespan_of(@collection)).to be_within(0.1).of @latest - @earliest
+      end
+
+      it 'should get #latest record in a set without re-querying database'
+    end
+
+
+end

data/spec/lib/time_bucket_spec.rb

@@ -0,0 +1,65 @@
+require 'spec_helper'
+
+describe AggtiveRecord::EggScopes::TimeBucket do 
+
+
+  describe '#by' do 
+
+    before(:each) do 
+      @a = MusicRecord.create(
+        published_at: "2010-01-20"
+      )
+      
+      @b = MusicRecord.create(
+        published_at: "2010-03-12"
+      )
+
+      @c = MusicRecord.create(
+        published_at: "2012-05-12"
+      )
+
+      @d = MusicRecord.create(
+        published_at: "2012-05-12 15:00"
+      )
+    end
+
+    context 'basic groupdate usage' do
+      it 'groups #by_year' do 
+        @group = MusicRecord.by_year.
+                              count.select{|k,v| k.year == 2010}.first
+        expect(@group[1]).to eq 2
+      end
+
+      it 'groups #by_month' do 
+        @group = MusicRecord.by_month.
+                              count.select{|k,v| k.year == 2012 && k.month == 5}.first
+        expect(@group[1]).to eq 2
+      end
+
+      it 'groups #by_hour' do 
+        @group = MusicRecord.by_hour.
+                                count.
+                                select{|k,v| k.hour == 15}.first
+        expect(@group[1]).to eq 1 
+      end
+
+
+      context 'groupdate options' do 
+        describe '#continuous' do 
+          it 'should adopt the usage of groupdate series' do 
+            pending %q{May make more sense to apply this operation at the end, as something separate from
+groupdate as it's not related to ActiveRecord
+            }
+          end
+
+          it 'populates default range between two endpoints'
+          it 'populates a specified range'
+
+        end
+      end
+    end
+
+
+
+  end
+end

data/spec/lib/time_span_spec.rb

@@ -0,0 +1,54 @@
+require 'spec_helper'
+
+describe AggtiveRecord::EggScopes::TimeSpan do 
+
+
+  describe '#in...' do 
+    before(:each) do 
+
+    end
+
+
+    describe '#past...' do 
+      context 'singular periods' do 
+        it 'should span a #year' do 
+          @record = MusicRecord.create published_at: 4.months.ago
+          MusicRecord.create published_at: 2.years.ago
+          expect(MusicRecord.past_year.count).to eq 1
+        end
+
+        it 'should span a #month' do 
+          @record = MusicRecord.create published_at: 4.months.ago
+          MusicRecord.create published_at: 2.days.ago
+          expect(MusicRecord.past_month.count).to eq 1
+        end
+
+        it 'should span an #hour' do 
+          @record = MusicRecord.create published_at: 2.hours.ago
+          MusicRecord.create published_at: 1.minute.ago
+          expect(MusicRecord.past_hour.count).to eq 1
+        end
+      end
+
+      context 'plural periods' do 
+        it 'has a few of these: 14 days, 30 days, 6 months, etc' do 
+          [2.years.ago, 4.months.ago, 15.days.ago, 1.minute.ago].each do |t| 
+            MusicRecord.create published_at: t
+          end
+
+          expect(MusicRecord.past_6_months.count).to eq 3
+          expect(MusicRecord.past_30_days.count).to eq 2
+          expect(MusicRecord.past_14_days.count).to eq 1
+        end
+      end    
+    end
+
+
+    describe 'just period name' do 
+      context 'single argument' do 
+        it 'spans #year(1999)'
+      end
+    end
+
+  end
+end

data/spec/spec_helper.rb

@@ -1,8 +1,13 @@
 $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
 $LOAD_PATH.unshift(File.dirname(__FILE__))
 require 'rspec'
-require 'aggtive_record'
+require 'mysql2'
+
+require 'active_record'
+require 'database_cleaner'
 
+require 'aggtive_record'
+require 'pry'
 
 # Requires supporting files with custom matchers and macros, etc,
 # in ./support/ and its subdirectories.
@@ -10,6 +15,34 @@ Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
 
 
 
+ActiveRecord::Base.establish_connection(
+  :adapter => "mysql2",
+  :database => "test_aggtive_record",
+  username: 'root',
+  password: ''
+
+)
+
+ActiveRecord::Migration.verbose = false
+
+ActiveRecord::Schema.define do
+  create_table :music_records , force: true do |t|
+    t.string     "title"
+    t.string     "genre"
+    t.datetime   'published_at'
+    t.string      'description'
+  end 
+end
+
+class MusicRecord < ActiveRecord::Base 
+  include AggtiveRecord::Aggable
+
+  attr_datetime :published_at
+end
+
+DatabaseCleaner.strategy = :truncation
+
+
 
 RSpec.configure do |config|
   config.color_enabled = true
@@ -17,9 +50,13 @@ RSpec.configure do |config|
   config.formatter = :documentation # :progress, :html, :textmate
 
   config.before(:each) do
+    DatabaseCleaner.start
   end
 
   config.after(:each) do
+    DatabaseCleaner.clean
   end
 end
 
+
+

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: aggtive_record
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Dan Nguyen
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-08-20 00:00:00.000000000 Z
+date: 2013-09-23 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: groupdate
+  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: activesupport
   requirement: !ruby/object:Gem::Requirement
@@ -80,6 +94,48 @@ dependencies:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: database_cleaner
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.1
+- !ruby/object:Gem::Dependency
+  name: mysql2
+  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: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.14
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.14
 description: This is not even remotely finished or even started on. Please don't download.
 email: dansonguyen@gmail.com
 executables: []
@@ -90,25 +146,34 @@ extra_rdoc_files:
 files:
 - .document
 - .rspec
+- .ruby-gemset
+- .ruby-version
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile
 - VERSION
+- aggtive_record.gemspec
 - lib/aggtive_record.rb
 - lib/aggtive_record/adapter.rb
 - lib/aggtive_record/adapter/mysql.rb
 - lib/aggtive_record/aggable.rb
+- lib/aggtive_record/egg_scopes.rb
+- lib/aggtive_record/egg_scopes/collation.rb
+- lib/aggtive_record/egg_scopes/collation/count_by.rb
+- lib/aggtive_record/egg_scopes/collation/rate.rb
+- lib/aggtive_record/egg_scopes/time_bucket.rb
+- lib/aggtive_record/egg_scopes/time_span.rb
 - lib/aggtive_record/memo.rb
-- lib/aggtive_record/scopes.rb
-- lib/aggtive_record/scopes/collation.rb
-- lib/aggtive_record/scopes/time_bucket.rb
-- lib/aggtive_record/scopes/time_span.rb
 - lib/aggtive_record/time.rb
 - spec/functional/basic_object_run_spec.rb
+- spec/lib/aggable_spec.rb
+- spec/lib/count_by_spec.rb
+- spec/lib/rate_spec.rb
+- spec/lib/time_bucket_spec.rb
+- spec/lib/time_span_spec.rb
 - spec/spec_helper.rb
-- spec/unit/aggable.rb
 homepage: http://github.com/dannguyen/aggtive_record
 licenses:
 - MIT

data/lib/aggtive_record/scopes.rb

@@ -1,5 +0,0 @@
-module AggtiveRecord
-  module Scopes
-
-  end
-end

data/lib/aggtive_record/scopes/collation.rb

@@ -1,7 +0,0 @@
-module AggtiveRecord
-  module Scopes
-    module Collation
-      extend ActiveRecord::Concern
-    end
-  end
-end

data/lib/aggtive_record/scopes/time_bucket.rb

@@ -1,12 +0,0 @@
-module AggtiveRecord
-  module Scopes
-    module TimeBucket
-      extend ActiveRecord::Concern
-
-      mattr_reader :prefix
-      self.prefix = 'by'
-    
-
-    end
-  end
-end

data/lib/aggtive_record/scopes/time_span.rb

@@ -1,22 +0,0 @@
-module AggtiveRecord
-  module Scopes
-    module TimeSpan
-
-      extend ActiveRecord::Concern
-      
-      # where("#{}" => 1.year.ago..Time.now)
-      #past_year
-
-      mattr_reader :prefix
-      self.prefix = 'during'
-
-=begin
- 
-  
-  
-=end
-
-
-    end
-  end
-end

data/spec/unit/aggable.rb

@@ -1,24 +0,0 @@
-require 'spec_helper'
-
-describe "AggtiveRecord::Aggable" do
-
-  context 'class methods' do 
-
-    describe '#is_a_datetime?' do 
-      it 'returns true if named column exists and is date/time' do 
-        @klass.is_a_datetime?
-      end
-
-      it 'returns false if named column does not exist'
-      it 'returns false if named column is not date/time'
-    end
-
-
-    describe '#attr_datetime' do 
-      it 'sets @@datetime_attribute'
-      it 'raises ArgumentError if not a valid datetime column'
-    end
-
-  end
-
-end