mpapis/contributors_stats

# Contributors stats

[![Gem Version](https://badge.fury.io/rb/contributors_stats.png)](http://rubygems.org/gems/contributors_stats)
[![Code Climate](https://codeclimate.com/github/mpapis/contributors_stats.png)](https://codeclimate.com/github/mpapis/contributors_stats)
[![Coverage Status](https://coveralls.io/repos/mpapis/contributors_stats/badge.png?branch=master)](https://coveralls.io/r/mpapis/contributors_stats?branch=master)
[![Build Status](https://travis-ci.org/mpapis/contributors_stats.png?branch=master)](https://travis-ci.org/mpapis/contributors_stats)
[![Dependency Status](https://gemnasium.com/mpapis/contributors_stats.png)](https://gemnasium.com/mpapis/contributors_stats)
[Documentation](http://rubydoc.info/gems/contributors_stats/frames)

Update static files with contributors statistics.

* Static content update of contributors statistics.
* Plugable:
 * backends to load data
 * user details calculation
 * output fomratters
 * target files updating

## Usage

Contributors stats consists on two basic parts and few plugins.

```ruby
calculator = ContributorsStats.load(<options>)
calculator.load(:<type> => '<name>')
calculator.user_data_type = :<user_data_type>
formatter = calculator.format(:<format>)
formatter.save('<file>', ...)
formatter.update('<file>', ..., options: <options>)
puts formatter.content
```

Plugins are loaded automatically, for example `calculator.user_data_type = :fetch`
will load `plugins/contributors_stats/user_data/fetch.rb` and use
`ContributorsStats::UserData::Fetch` and use it to process user details calculation.

## Examples

```ruby
ContributorsStats.load(gh_org:  'railsisntaller').format(:markdown).save('public/contributors.md')
ContributorsStats.load(gh_repo: 'railsisntaller/website').format.update('public/index.html')
```

```shell
ruby -I lib:lib/plugins -rcontributors_stats -e "puts ContributorsStats.load(:gh_org => 'rvm', :gh_repo => ['wayneeseguin/rvm', 'wayneeseguin/rvm-capistrano'], :user_data => :fetch).format(:html).content"
```