housekeeper-has_activity 0.4.0

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 [name of plugin creator]
+
+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.textile

@@ -0,0 +1,195 @@
+h1. HasActivity
+---------------
+
+ * Originally created by Cary Dunn
+ * Modified functionality and additional features by HouseKeeper
+
+A simple way to grab recent activity or a sum of values on a given model from a table grouped by day, hour,
+or week with only 1 SQL query and giving the ability to pad the results for days/weeks/hours with no activity.
+
+The plugin offers the ability to...
+  * Present as a Google Chart (line or bar)
+  * Scope your model to given :conditions
+  * Pad your results for days with no activity
+  * Present your data from a set date until present or between two dates
+
+NOTE: MySQL only because of date functions use.
+
+"Example Google Chart Generated":http://chart.apis.google.com/chart?cht=bvs&chs=200x50&chd=t:0,10,15,3,8,4,0,3,2,3,0,11,4,23,14,0,0,0,13,0,4,8,19,10,12,21,1&chco=336699&chbh=a,2&chds=0,23&chf=bg,s,EFEFEF&
+
+h2. USAGE / INSTALLATION
+------------------------
+
+<pre><code>script/plugin install git://github.com/cdunn/has_activity.git</pre></code>
+
+<pre><code>
+  class Feed < ActiveRecord::Base
+    # Defaults to created_at
+    has_activity
+    
+    ...
+  end
+</code></pre>
+
+<pre><code>
+  class Feed < ActiveRecord::Base
+    # Change the timestamp DB field to something custom
+    has_activity :by => "published_at"
+    
+    ...
+  end
+</code></pre>
+  
+<pre><code>
+  # Get all activity since 1 week ago grouped by day (default) 
+  Feed.activity_since(1.week.ago)
+  => [{:activity=>0, :offset=>7, :created_at=>Mon Mar 09 10:27:34 -0700 2009}, {:activity=>0, :offset=>6, :created_at=>Tue Mar 10 10:27:34 -0700 2009}, {:activity=>8, :offset=>5, :created_at=>Wed Mar 11 01:19:09 -0700 2009}, {:activity=>2, :offset=>4, :created_at=>Thu Mar 12 04:26:09 -0700 2009}, {:activity=>0, :offset=>3, :created_at=>Fri Mar 13 10:27:34 -0700 2009}, {:activity=>0, :offset=>2, :created_at=>Sat Mar 14 10:27:34 -0700 2009}, {:activity=>0, :offset=>1, :created_at=>Sun Mar 15 10:27:34 -0700 2009}, {:activity=>0, :offset=>0, :created_at=>Mon Mar 16 10:27:34 -0700 2009}]
+</code></pre>
+
+SQL generated for previous statement...
+<pre><code>
+SELECT
+ published_at AS timestamp,
+ COUNT(*) AS activity_count,
+ DATEDIFF(now(), published_at) as days_ago
+ FROM feeds
+ WHERE 1=1 AND published_at > '2009-03-09 17:27:33'
+ GROUP BY days_ago
+ ORDER BY published_at ASC
+</code></pre>
+
+<pre><code>
+  # Get all activity since 1 day ago grouped by hour scoped to a certain user
+  Feed.activity_since(1.week.ago, :conditions => ["user_id = ?", current_user.id], :group_by => :hour)
+  => [{:activity=>0, :offset=>24, :created_at=>Sun Mar 15 10:29:47 -0700 2009}, {:activity=>0, :offset=>23, :created_at=>Sun Mar 15 11:29:47 -0700 2009}, {:activity=>0, :offset=>22, :created_at=>Sun Mar 15 12:29:47 -0700 2009}, {:activity=>0, :offset=>21, :created_at=>Sun Mar 15 13:29:47 -0700 2009}, {:activity=>0, :offset=>20, :created_at=>Sun Mar 15 14:29:47 -0700 2009}, {:activity=>0, :offset=>19, :created_at=>Sun Mar 15 15:29:47 -0700 2009}, {:activity=>0, :offset=>18, :created_at=>Sun Mar 15 16:29:47 -0700 2009}, {:activity=>0, :offset=>17, :created_at=>Sun Mar 15 17:29:47 -0700 2009}, {:activity=>0, :offset=>16, :created_at=>Sun Mar 15 18:29:47 -0700 2009}, {:activity=>0, :offset=>15, :created_at=>Sun Mar 15 19:29:47 -0700 2009}, {:activity=>0, :offset=>14, :created_at=>Sun Mar 15 20:29:47 -0700 2009}, {:activity=>0, :offset=>13, :created_at=>Sun Mar 15 21:29:47 -0700 2009}, {:activity=>0, :offset=>12, :created_at=>Sun Mar 15 22:29:47 -0700 2009}, {:activity=>0, :offset=>11, :created_at=>Sun Mar 15 23:29:47 -0700 2009}, {:activity=>0, :offset=>10, :created_at=>Mon Mar 16 00:29:47 -0700 2009}, {:activity=>0, :offset=>9, :created_at=>Mon Mar 16 01:29:47 -0700 2009}, {:activity=>0, :offset=>8, :created_at=>Mon Mar 16 02:29:47 -0700 2009}, {:activity=>0, :offset=>7, :created_at=>Mon Mar 16 03:29:47 -0700 2009}, {:activity=>0, :offset=>6, :created_at=>Mon Mar 16 04:29:47 -0700 2009}, {:activity=>0, :offset=>5, :created_at=>Mon Mar 16 05:29:47 -0700 2009}, {:activity=>0, :offset=>4, :created_at=>Mon Mar 16 06:29:47 -0700 2009}, {:activity=>0, :offset=>3, :created_at=>Mon Mar 16 07:29:47 -0700 2009}, {:activity=>0, :offset=>2, :created_at=>Mon Mar 16 08:29:47 -0700 2009}, {:activity=>0, :offset=>1, :created_at=>Mon Mar 16 09:29:47 -0700 2009}, {:activity=>0, :offset=>0, :created_at=>Mon Mar 16 10:29:47 -0700 2009}]\
+</code></pre>
+
+SQL generated for previous statement...
+<pre><code>
+SELECT
+ published_at AS timestamp,
+ COUNT(*) AS activity_count,
+ ((((YEAR(now()) - YEAR(published_at))*365)+(DAYOFYEAR(now())-DAYOFYEAR(published_at)))*24)+(HOUR(now())-HOUR(published_at)) as hours_ago,
+ CONCAT(YEAR(published_at), CONCAT(DAYOFYEAR(published_at), HOUR(published_at))) AS unique_hour
+ FROM feeds
+ WHERE user_id = 1 AND published_at > '2009-03-15 17:29:47'
+ GROUP BY unique_hour
+ ORDER BY published_at ASC
+</code></pre>
+
+<pre><code>
+  # Get all activity since 2 months ago grouped by week and order it from current week to oldest week
+  Feed.activity_since(2.months.ago, :group_by => :week, :order => :desc)
+  => [{:activity=>0, :offset=>0, :created_at=>Mon Mar 16 10:34:28 -0700 2009}, {:activity=>0, :offset=>1, :created_at=>Mon Mar 09 10:34:28 -0700 2009}, {:activity=>0, :offset=>2, :created_at=>Mon Mar 02 10:34:28 -0800 2009}, {:activity=>0, :offset=>3, :created_at=>Mon Feb 23 10:34:28 -0800 2009}, {:activity=>0, :offset=>4, :created_at=>Mon Feb 16 10:34:28 -0800 2009}, {:activity=>0, :offset=>5, :created_at=>Mon Feb 09 10:34:28 -0800 2009}, {:activity=>0, :offset=>6, :created_at=>Mon Feb 02 10:34:28 -0800 2009}, {:activity=>0, :offset=>7, :created_at=>Mon Jan 26 10:34:28 -0800 2009}, {:activity=>0, :offset=>8, :created_at=>Mon Jan 19 10:34:28 -0800 2009}]
+</code></pre>
+
+SQL generated for previous statement...
+<pre><code>
+  SELECT
+   published_at AS timestamp,
+   COUNT(*) AS activity_count,
+   ((YEAR(now()) - YEAR(published_at))*52)+(WEEK(now())-WEEK(published_at)) as weeks_ago,
+   YEARWEEK(published_at) AS unique_week
+   FROM feeds
+   WHERE 1=1 AND published_at > '2009-01-16 17:34:28'
+   GROUP BY unique_week
+   ORDER BY published_at ASC
+</code></pre>
+
+<pre><code>
+  # Get Usd Net Commission in July ago grouped by day and order it in ascending order by the days commission was earnt on for account_id 1
+  AccountPnl.activity_between(july_month.beginning_of_month,
+                              july_month.end_of_month, 
+                              :group_by => :day, 
+                              :padding => false, 
+                              :sum_on => "usd_net_commission",
+                              :conditions => ["crm_account_id=?", 1], 
+                              :order => :asc)
+</code></pre>
+
+SQL generated for previous statement...
+<pre><code>
+SELECT
+ earnt_on AS timestamp,
+ COUNT(*) AS activity_count, SUM(usd_net_commission) as sum,
+ DATEDIFF('2009-07-31 23:59:59', earnt_on) as days_ago
+ FROM crm_daily_account_pnls 
+ WHERE crm_account_id=16 AND earnt_on
+ BETWEEN '2009-07-01 00:00:00' AND '2009-07-31 23:59:59' 
+ GROUP BY days_ago 
+ ORDER BY earnt_on ASC
+</code></pre>
+
+
+h2. CONVERT DATA INTO GOOGLE CHART
+
+<pre><code>
+Feed.activity_since(6.months.ago, :group_by => :week, :order => :desc).to_activity_gchart
+=> "http://chart.apis.google.com/chart?cht=bvs&chs=200x50&chd=t:0,10,15,3,8,4,0,3,2,3,0,11,4,23,14,0,0,0,13,0,4,8,19,10,12,21,1&chco=336699&chbh=a,2&chds=0,23&chf=bg,s,EFEFEF&"
+</code></pre>
+
+<pre><code>
+Feed.activity_since(6.months.ago, :group_by => :week, :order => :desc).to_activity_gchart
+  AccountPnl.activity_between(july_month.beginning_of_month,
+                              july_month.end_of_month, 
+                              :group_by   => :day, 
+                              :padding    => false, 
+                              :sum_on     => "usd_net_commission",
+                              :conditions => ["crm_account_id=?", 1], 
+                              :order      => :asc).to_activity_gchart( :type => :line, 
+                                                                       :column => :sum,
+                                                                       :size => "100x45", 
+                                                                       :bgcolor => "f0ffdc", 
+                                                                       :chart_color => "D1EAFF", 
+                                                                       :area_color => "DFEBFF",
+                                                                       :line_color => "c7c7c7", 
+                                                                       :line_width => "4"))
+=> "http://chart.apis.google.com/chart?chs=100x45&cht=ls&chco=c7c7c7&chm=B,DFEBFF,0,0,0&chd=t:<data>&chds=0,0&chf=bg,s,f0ffdc&"
+</code></pre>
+
+h2. OTHER OPTIONS
+
+<pre><code>
+  # Grabs a hash of the activity since <time ago> grouped by <hour/day/week>
+  # 
+  #   * :conditions
+  #       same as the standard Rails finder. Used to scope your activity to a particular user, etc.
+  #   * :padding
+  #       true/false
+  #   * :group_by
+  #       :hour, :day, :week
+  # 
+  def activity_since(since=1.week.ago, options={})
+</code></pre>
+
+<pre><code>
+  # Returns a URL to a simple google chart the represents the activity returned by the plugin
+  # 
+  #   * :type => :bar/:line
+  #   * :size => "200x50"
+  #   * :bgcolor => "EFEFEF"
+  #   * :chart_color => "336699"
+  #   * :area_color => "DFEBFF" (only for :line)
+  #   * :line_color => "0077CC" (only for :line)
+  #   * :line_width => "2" (only for :line)
+  # 
+  def to_activity_gchart(options={})
+</code></pre>
+
+h2. INDEX THE TIMESTAMP YOU USE
+
+Obviously there is not "one index fits all" but you should include an index on at least the timestamp that fits the conditions you are using.
+The same applies when performing SUM on a column.
+<pre><code>
+add_index :model, [:created_at]
+</code></pre>
+
+h2. NOTES
+
+ * Using sum and creating Bar Charts is not fully tested - HouseKeeper
+ * Some work still needs to be done on the queries and a tidy up of has_activity.rb
+
+Copyright (c) 2009 Cary Dunn <cary.dunn@gmail.com> "http://elctech.com":http://elctech.com, released under the MIT license
+Modified by HouseKeeper
+ - Added the ability to sum a column - giving you a total ammount from a date until now or between 2 dates 
+ - Added Between functionality so you can get activity or sums between 2 specified dates

data/Rakefile

@@ -0,0 +1,23 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the has_activity plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the has_activity plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'HasActivity'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION.yml

@@ -0,0 +1,5 @@
+---
+:major: 0
+:minor: 4
+:patch: 0
+

data/has_activity.gemspec

@@ -0,0 +1,50 @@
+# -*- encoding: utf-8 -*-
+ 
+Gem::Specification.new do |s|
+  s.name = %q{has_activity}
+  s.version = "0.4.0"
+ 
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Cary Dunn", "Carl Burton"]
+  s.date = %q{2009-09-17}
+  s.description = %q{A simple way to grab recent activity or a columns sum on a given model from a table grouped by day, hour, or week with only 1 SQL query and giving the ability to pad the results for days/weeks/hours with no activity.}
+  s.email = %q{carl@house-keeping.com}
+  s.extra_rdoc_files = [
+    "README.textile"
+  ]
+  s.files = [
+     "VERSION.yml",
+     "uninstall.rb",
+     "README.textile",
+     "Rakefile",
+     "MIT-LICENSE",
+     "install.rb",
+     "init.rb",
+     "has_activity.gemspec",
+     "test/test_helper.rb",
+     "test/has_activity_test.rb",
+     "tasks/has_activity_tasks.rake",
+     "lib/has_activity.rb",
+     "lib/core_ext.rb"
+  ]
+  s.has_rdoc = false
+  s.homepage = %q{http://github.com/housekeeper/has_activity}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{A simple way to grab recent activity or a columns sum on a given model from a table grouped by day, hour, or week with only 1 SQL query and giving the ability to pad the results for days/weeks/hours with no activity.}
+  s.test_files = [
+    "test/test_helper.rb",
+    "test/has_activity_test.rb"
+  ]
+ 
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+ 
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/init.rb

@@ -0,0 +1,3 @@
+# Include hook code here
+require 'has_activity'
+ActiveRecord::Base.send(:include, Elctech::Has::Activity)

data/install.rb

@@ -0,0 +1 @@
+# Install hook code here

data/lib/core_ext.rb

@@ -0,0 +1,53 @@
+# Original Author Cary Dunn <cary.dunn@gmail.com>
+# Modified by HouseKeeper
+
+unless Array.instance_methods.include? 'to_activity_gchart'
+  Array.class_eval do
+    # Returns a URL to a simple google chart the represents the activity returned by the plugin
+    # 
+    #   * :type => :bar/:line
+    #   * :column => :activity/:sum
+    #   * :size => "200x50"
+    #   * :bgcolor => "EFEFEF"
+    #   * :chart_color => "336699"
+    #   * :area_color => "DFEBFF" (only for :line)
+    #   * :line_color => "0077CC" (only for :line)
+    #   * :line_width => "2" (only for :line)
+    # 
+    def to_activity_gchart(options={})
+      options[:type] ||= :graph
+      options[:column] ||= :activity 
+      options[:size] ||= "200x50"
+      options[:bgcolor] ||= "EFEFEF"
+      options[:chart_color] ||= "336699"
+      options[:area_color] ||= "DFEBFF"
+      options[:line_color] ||= "0077CC"
+      options[:line_width] ||= "2"
+      
+      case options[:column]
+        when :activity
+          activity_min_data_point = self.min{|a,b| a[:activity] <=> b[:activity] }[:activity]
+          activity_max_data_point = self.max{|a,b| a[:activity] <=> b[:activity] }[:activity]
+          activity_str = self.map{|a| a[:activity]}.join(",")
+          return generate_url(activity_str, activity_min_data_point, activity_max_data_point, options)        
+        when :sum
+          sum_min_data_point = self.min{|a,b| a[:sum] <=> b[:sum] }[:sum]
+          sum_max_data_point = self.max{|a,b| a[:sum] <=> b[:sum] }[:sum]
+          sum_str = self.map{|a| a[:sum]}.join(",")  
+          return generate_url(sum_str, sum_min_data_point, sum_max_data_point, options)
+      end
+      
+    end
+    
+    private
+    
+    def generate_url(data, min_data_point, max_data_point, options={})
+      if options[:type] == :line  
+        return "http://chart.apis.google.com/chart?chs=#{options[:size]}&cht=ls&chco=#{options[:line_color]}&chm=B,#{options[:area_color]},0,0,0&chd=t:#{data}&chds=#{min_data_point},#{max_data_point}&chf=bg,s,#{options[:bgcolor]}&"
+      else
+        return "http://chart.apis.google.com/chart?cht=bvs&chs=#{options[:size]}&chd=t:#{data}&chco=#{options[:chart_color]}&chbh=a,#{options[:line_width]}&chds=#{min_data_point},#{max_data_point}&chf=bg,s,#{options[:bgcolor]}&"
+      end      
+    end
+    
+  end
+end

data/lib/has_activity.rb

@@ -0,0 +1,232 @@
+#  
+# => has_activity
+# => Cary Dunn <cary.dunn@gmail.com>
+# => Modified by HouseKeeper: added between methods and sum option 
+
+# HasActivity
+
+require 'core_ext'
+
+module Elctech
+  module Has #:nodoc:
+    module Activity #:nodoc:
+      def self.included(base)
+        base.extend(ClassMethods)
+      end
+      
+      module ClassMethods
+        
+        def self.extended(base)
+          base.class_inheritable_accessor :activity_options
+        end
+        
+        def has_activity(options={})
+          options[:by] ||= "created_at"
+          include Elctech::Has::Activity::InstanceMethods
+          extend Elctech::Has::Activity::SingletonMethods
+          
+          self.activity_options = options
+        end
+      end
+      
+      module SingletonMethods
+        
+        # Grabs a hash of the activity between <time a> AND <time b>grouped by <hour/day/week>
+        # 
+        #   * :conditions
+        #       same as the standard Rails finder. Used to scope your activity to a particular user, etc.
+        #   * :padding
+        #       true/false
+        #   * :group_by
+        #       :hour, :day, :week
+        # 
+        def activity_between(between=1.week.ago, andbetween=Time.now.utc, options={})
+          activity_scope = (options.has_key?(:conditions) ? sanitize_sql(options[:conditions]) : "1=1")
+          options[:padding] ||= true
+          options[:order] ||= :asc
+          options[:group_by] ||= :day
+          sum = options[:sum_on] ? "SUM(#{options[:sum_on]}) as sum," : ""
+           
+          case options[:group_by]
+          when :hour
+            sql_statement = sanitize_sql(
+              ["SELECT
+                  #{activity_options[:by]} AS timestamp,
+                  COUNT(*) AS activity_count, #{sum}
+                  ((((YEAR(now()) - YEAR(#{activity_options[:by]}))*365)+(DAYOFYEAR(now())-DAYOFYEAR(#{activity_options[:by]})))*24)+(HOUR(now())-HOUR(#{activity_options[:by]})) as hours_ago,
+                  CONCAT(YEAR(#{activity_options[:by]}), CONCAT(DAYOFYEAR(#{activity_options[:by]}), HOUR(#{activity_options[:by]}))) AS unique_hour
+                FROM #{self.table_name}
+                WHERE #{activity_scope} AND #{activity_options[:by]} > ?
+                GROUP BY unique_hour
+                ORDER BY #{activity_options[:by]} ASC",
+                between.to_s(:db)
+              ]
+            )
+            unit = "hours_ago"
+            oldest_possible_unit = ((andbetween-between)/60)/60
+          when :week
+            sql_statement = sanitize_sql(
+              ["SELECT
+                  #{activity_options[:by]} AS timestamp,
+                  COUNT(*) AS activity_count, #{sum}
+                  ((YEAR(now()) - YEAR(#{activity_options[:by]}))*52)+(WEEK(now())-WEEK(#{activity_options[:by]})) as weeks_ago,
+                  YEARWEEK(#{activity_options[:by]}) AS unique_week
+                FROM #{self.table_name}
+                WHERE #{activity_scope} AND #{activity_options[:by]} 
+                BETWEEN ? AND ?
+                GROUP BY unique_week
+                ORDER BY #{activity_options[:by]} ASC",
+                between.to_s(:db),andbetween.to_s(:db)
+              ]
+            )
+            unit = "weeks_ago"
+            oldest_possible_unit = ((((andbetween-between)/60)/60)/24)/7
+          else
+            sql_statement = sanitize_sql(
+              ["SELECT
+                  #{activity_options[:by]} AS timestamp,
+                  COUNT(*) AS activity_count, #{sum}
+                  DATEDIFF('#{andbetween.to_s(:db)}', #{activity_options[:by]}) as days_ago
+                  FROM #{self.table_name} 
+                WHERE #{activity_scope} AND #{activity_options[:by]}
+                BETWEEN ? AND ? 
+                GROUP BY days_ago 
+                ORDER BY #{activity_options[:by]} ASC",
+                between.to_s(:db), andbetween.to_s(:db)
+              ]
+            )
+            unit = "days_ago"
+            oldest_possible_unit = (((andbetween-between)/60)/60)/24
+          end
+          
+          results = connection.select_all(sql_statement)
+          (options[:padding] ? pad_activity_results(results, unit, oldest_possible_unit.round, options[:order]) : format_activity_results(results, unit, order))
+        end
+        
+        # Grabs a hash of the activity since <time ago> grouped by <hour/day/week>
+        # 
+        #   * :conditions
+        #       same as the standard Rails finder. Used to scope your activity to a particular user, etc.
+        #   * :padding
+        #       true/false
+        #   * :group_by
+        #       :hour, :day, :week
+        # 
+        def activity_since(since=1.week.ago, options={})
+          activity_scope = (options.has_key?(:conditions) ? sanitize_sql(options[:conditions]) : "1=1")
+          options[:padding] ||= true
+          options[:order] ||= :asc
+          options[:group_by] ||= :day
+          sum = options[:sum_on] ? "SUM(#{options[:sum_on]}) as sum," : ""
+           
+          case options[:group_by]
+          when :hour
+            sql_statement = sanitize_sql(
+              ["SELECT
+                  #{activity_options[:by]} AS timestamp,
+                  COUNT(*) AS activity_count, #{sum}
+                  ((((YEAR(now()) - YEAR(#{activity_options[:by]}))*365)+(DAYOFYEAR(now())-DAYOFYEAR(#{activity_options[:by]})))*24)+(HOUR(now())-HOUR(#{activity_options[:by]})) as hours_ago,
+                  CONCAT(YEAR(#{activity_options[:by]}), CONCAT(DAYOFYEAR(#{activity_options[:by]}), HOUR(#{activity_options[:by]}))) AS unique_hour
+                FROM #{self.table_name}
+                WHERE #{activity_scope} AND #{activity_options[:by]} > ?
+                GROUP BY unique_hour
+                ORDER BY #{activity_options[:by]} ASC",
+                since.to_s(:db)
+              ]
+            )
+            unit = "hours_ago"
+            oldest_possible_unit = ((Time.now-since)/60)/60
+          when :week
+            sql_statement = sanitize_sql(
+              ["SELECT
+                  #{activity_options[:by]} AS timestamp,
+                  COUNT(*) AS activity_count, #{sum}
+                  ((YEAR(now()) - YEAR(#{activity_options[:by]}))*52)+(WEEK(now())-WEEK(#{activity_options[:by]})) as weeks_ago,
+                  YEARWEEK(#{activity_options[:by]}) AS unique_week
+                FROM #{self.table_name}
+                WHERE #{activity_scope} AND #{activity_options[:by]} > ?
+                GROUP BY unique_week
+                ORDER BY #{activity_options[:by]} ASC",
+                since.to_s(:db)
+              ]
+            )
+            unit = "weeks_ago"
+            oldest_possible_unit = ((((Time.now-since)/60)/60)/24)/7
+          else
+            sql_statement = sanitize_sql(
+              ["SELECT
+                  #{activity_options[:by]} AS timestamp,
+                  COUNT(*) AS activity_count, #{sum}
+                  DATEDIFF(now(), #{activity_options[:by]}) as days_ago
+                FROM #{self.table_name}
+                WHERE #{activity_scope} AND #{activity_options[:by]} > ?
+                GROUP BY days_ago
+                ORDER BY #{activity_options[:by]} ASC",
+                since.to_s(:db)
+              ]
+            )
+            unit = "days_ago"
+            oldest_possible_unit = (((Time.now-since)/60)/60)/24
+          end
+          
+          results = connection.select_all(sql_statement)
+          (options[:padding] ? pad_activity_results(results, unit, oldest_possible_unit.round, options[:order]) : format_activity_results(results, unit, order))
+        end
+      
+      private
+        def format_activity_results(results, unit, order)
+          results.inject([]) do |rs,r|
+            entry = {
+              :offset => r[unit].to_i,
+              :activity => r["activity_count"].to_i,
+              :sum => r["sum"].to_f,
+              :date => Time.parse(r["timestamp"])
+            }
+            (order == :asc) ? rs.push(entry) : rs.unshift(entry)
+          end
+        end
+        
+        def pad_activity_results(results, unit, oldest_possible_offset, order)
+          padded_results = []
+          
+          current_unit_offset = oldest_possible_offset
+          current_result_index = 0
+          
+          while current_unit_offset >= 0 do
+            if current_result_index < results.size && results[current_result_index][unit].to_i == current_unit_offset
+              entry = {
+                :offset => current_unit_offset,
+                :activity => results[current_result_index]["activity_count"].to_i,
+                :sum => results[current_result_index]["sum"].to_f,
+                :created_at => Time.parse(results[current_result_index]["timestamp"])
+              }
+              current_result_index = current_result_index+1
+            else
+              case unit
+              when "hours_ago"
+                created_at_given_offset = Time.now-current_unit_offset.hours
+              when "weeks_ago"
+                created_at_given_offset = Time.now-current_unit_offset.weeks
+              else
+                created_at_given_offset = Time.now-current_unit_offset.days
+              end
+              entry = {
+                :offset => current_unit_offset,
+                :activity => 0,
+                :sum => 0,
+                :created_at => created_at_given_offset
+              }
+            end
+            current_unit_offset = current_unit_offset-1
+            (order == :asc) ? padded_results.push(entry) : padded_results.unshift(entry)
+          end
+          
+          padded_results
+        end
+      end
+      
+      module InstanceMethods;end
+      
+    end
+  end
+end

data/tasks/has_activity_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :has_activity do
+#   # Task goes here
+# end

data/test/has_activity_test.rb

@@ -0,0 +1,8 @@
+require 'test_helper'
+
+class HasActivityTest < ActiveSupport::TestCase
+  # Replace this with your real tests.
+  test "the truth" do
+    assert true
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,3 @@
+require 'rubygems'
+require 'active_support'
+require 'active_support/test_case'

data/uninstall.rb

@@ -0,0 +1 @@
+# Uninstall hook code here

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification 
+name: housekeeper-has_activity
+version: !ruby/object:Gem::Version 
+  version: 0.4.0
+platform: ruby
+authors: 
+- Cary Dunn
+- Carl Burton
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-09-17 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: A simple way to grab recent activity or a columns sum on a given model from a table grouped by day, hour, or week with only 1 SQL query and giving the ability to pad the results for days/weeks/hours with no activity.
+email: carl@house-keeping.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.textile
+files: 
+- VERSION.yml
+- uninstall.rb
+- README.textile
+- Rakefile
+- MIT-LICENSE
+- install.rb
+- init.rb
+- has_activity.gemspec
+- test/test_helper.rb
+- test/has_activity_test.rb
+- tasks/has_activity_tasks.rake
+- lib/has_activity.rb
+- lib/core_ext.rb
+has_rdoc: false
+homepage: http://github.com/housekeeper/has_activity
+licenses: 
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 2
+summary: A simple way to grab recent activity or a columns sum on a given model from a table grouped by day, hour, or week with only 1 SQL query and giving the ability to pad the results for days/weeks/hours with no activity.
+test_files: 
+- test/test_helper.rb
+- test/has_activity_test.rb