# Dase

## Overview

Dase gem provides 'includes_count_of' method on a relation, which works similar to ActiveRecord's 'includes' method.

![Dase example](https://vovayartsev-home.s3.amazonaws.com/dase-mockup.png)

Calling 'includes_count_of(:articles)' on a relation object adds 'articles_count' method to each of the authors:
```
  authors = Author.includes(:publisher).includes_count_of(:articles, :conditions => {:year => 2012})  
  authors.first.name             # => 'Billy'                
  authors.first.articles_count   # => 2                
```


## Installation

Add this line to your application's Gemfile:

    gem 'dase', "~> 3.2.0"

### Note on version numbers

Dase version number correlates with the Active Record's versions number,
which it has been tested with.
E.g. the latest 3.2.* version of Dase will play nicely with the latest 3.2.* version of Active Record.
Since it's a sort of a "hack", make sure you specified the version number for "dase" gem in your Gemfile.

## Usage

### Basic usage:

```
  Author.includes_count_of(:articles).find_each do |author|
    puts "#{author.name} has #{author.articles_count} articles published"
  end
```

### Advanced usage:

You can specify a hash of options which will be passed to the underlying finder 
which retrieves the association. Valid keys are: :conditions, :group, :having, :joins, :include
```
Author.includes_count_of(:articles, :conditions => {:year => 2012})
```


### Known problems

1. Dase doesn't support :through option on associations
2. You can't put includes_count_of calls into a scope declaration, like this:

```
class Author
   scope :with_counters, lambda {
      includes_count_of(:articles)    # this will not work!!!
   }
end
```

## How it works

Here's a pseudo-code that gives an idea on how it works internally
```
  counters_hash = Article.where(:year => 2012).count(:group => :author_id)
  Author.find_each do |author|
    puts "#{author.name} has #{counters_hash[author.id] || 0} articles published"
  end
```




## Name origin

The gem is named by the german mathematician [Johann Dase](http://en.wikipedia.org/wiki/Zacharias_Dase),
who was a mental calculator - he could count and multiply numbers very quickly. 

## Contributing

1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request