better_counters 1.0.0

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in better_counters.gemspec
+gemspec

data/README.md

@@ -0,0 +1,69 @@
+# Better Counters
+==============
+
+### Description
+
+Counter cache is a great feature in Rails to improve records counting performance by caching the number in a column.
+
+Unfortunately it is tied to `belongs_to`, Many times i had to create similar custom methods from scratch just to work with `delegate` or simply models or shortcut methods that aren't associated through `belongs_to`
+
+Here comes Better Counters with an independent syntax.
+
+### Installation
+
+In your Gemfile add this line:
+
+    gem 'better_counters'
+
+### Usage
+
+First you need to create a migration and add a counter column, like `tasks_count`.
+
+    rails g migration AddTasksCountToUsers tasks_count:integer
+
+Then simply on your model add the method `counter_cache` with a hash of models to keep the count column in.
+
+    class Task < ActiveRecord::Base
+      belongs_to :project
+      counter_cache :user => true
+
+      def user
+        project.user
+      end
+    end
+
+Based on the example above, to fetch a user's total tasks count, run: `@user.tasks_count`.
+You will no longer have to use the slow `@user.tasks.count`
+
+You can use the counter cache in multiple models as long as they all have a counter column.
+
+    counter_cache :user => true, :project => true
+
+### Custom counter column names
+
+You can override the default column name with your own:
+
+    counter_cache :user => :total_tasks
+
+* * *
+
+![God of the Internet](http://i.imgur.com/ETKp5.jpg)
+
+* * *
+
+### Contributing
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+**Copyright**
+
+Copyright (c) 2012 Ryan Sacha. See LICENSE.txt for
+further details.
+
+If you happen to be bored, You can check out my [Portfolio](http://ryansacha.com).

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/better_counters.gemspec

@@ -0,0 +1,20 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "better_counters/version"
+
+Gem::Specification.new do |s|
+  s.name        = "better_counters"
+  s.version     = BetterCounters::VERSION
+  s.authors     = ["Ryan Sacha"]
+  s.email       = ["ryan@ryansacha.com"]
+  s.homepage    = "https://github.com/RyanSacha/BetterCounters"
+  s.summary     = %q{Independent counter cache outside belongs_to}
+  s.description = %q{Improved alternative to rails built-in counter cache to work outside belongs_to}
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_runtime_dependency "activerecord"
+end

data/lib/better_counters.rb

@@ -0,0 +1,37 @@
+require "better_counters/version"
+
+module BetterCounters
+  extend ActiveSupport::Concern
+
+  def update_cache_counters(p = {}, n = 1)
+    p.each do |c|
+      if c[1]
+        column = (c[1] == true) ? self.class.table_name + "_count" : c[1]
+        n > 0 ? send(c[0]).increment(column, 1) : send(c[0]).decrement(column, 1)
+        send(c[0]).save
+      end
+    end
+  end
+
+  module ClassMethods
+    # *Enable counter caching*
+    #
+    # Takes a +Hash+ where keys are the association singular name, and the values are either true or a custom counter column name.
+    #
+    # Example:
+    #   >> counter_cache :user => true
+    #
+    # You can override the counter column name by replacing true with the name.
+    #   >> counter_cache :user => :total_tasks
+    #
+    # Arguments
+    # p: (Hash)
+
+    def counter_cache(p)
+      after_create  Proc.new { update_cache_counters(p, 1) }
+      after_destroy Proc.new { update_cache_counters(p, -1) }
+    end
+  end
+end
+
+ActiveRecord::Base.send(:include, BetterCounters)

data/lib/better_counters/version.rb

@@ -0,0 +1,3 @@
+module BetterCounters
+  VERSION = "1.0.0"
+end

metadata

@@ -0,0 +1,71 @@
+--- !ruby/object:Gem::Specification
+name: better_counters
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Ryan Sacha
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-11-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: &25656288 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *25656288
+description: Improved alternative to rails built-in counter cache to work outside
+  belongs_to
+email:
+- ryan@ryansacha.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- !binary |-
+  LmdpdGlnbm9yZQ==
+- !binary |-
+  R2VtZmlsZQ==
+- !binary |-
+  UkVBRE1FLm1k
+- !binary |-
+  UmFrZWZpbGU=
+- !binary |-
+  YmV0dGVyX2NvdW50ZXJzLmdlbXNwZWM=
+- !binary |-
+  bGliL2JldHRlcl9jb3VudGVycy5yYg==
+- !binary |-
+  bGliL2JldHRlcl9jb3VudGVycy92ZXJzaW9uLnJi
+homepage: https://github.com/RyanSacha/BetterCounters
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.16
+signing_key: 
+specification_version: 3
+summary: Independent counter cache outside belongs_to
+test_files: []