Contents

Active_Ext
==========

[![Code Climate](https://codeclimate.com/github/darthjee/active_ext/badges/gpa.svg)](https://codeclimate.com/github/darthjee/active_ext)
[![Test Coverage](https://codeclimate.com/github/darthjee/active_ext/badges/coverage.svg)](https://codeclimate.com/github/darthjee/active_ext/coverage)
[![Issue Count](https://codeclimate.com/github/darthjee/active_ext/badges/issue_count.svg)](https://codeclimate.com/github/darthjee/active_ext)

# Usage
This project adds some new methods to the core active_record classes

To use active-ext either intall directly

```console
gem install darthjee-active_ext
```

or add it to Gemfile

```
gem 'darthjee-active_ext'
```

```console
bundle install darthjee-active_ext
```

# methods added

## ActiveRecord::Relation

```ruby
ActiveRecord::Schema.define do
  self.verbose = false
  
  create_table :documents, :force => true do |t|
    t.string :status
    t.boolean :active, default: false
    t.timestamps null: true
  end
end


class Document < ActiveRecord::Base
  scope :with_error, -> { where(status: :error) }
  scope :with_success, -> { where(status: :success) }
  scope :active, -> { where(active: true) }
end

2.times { Document.with_error.create }
Document.active.with_error.create
Document.active.with_success.create
```

### #percentage
Returns the percentage of objects of a certain scope within another scope

```ruby
Document.percentage(:with_error)
0.75
```

```ruby
Document.percentage(status: :error)
0.75
```

```ruby
Document.percentage("status = 'error'")
0.75
```
Works also when using nested scopes

```ruby
Document.active.percentage(:with_error)
0.5
```

### #pluck_as_json
Just as pluck returns some specifc columns, pluck_as_json returns the same coluns with keys to identify

```ruby
Document.pluck(:id, :active)
[[1, true], [2, true]]
```

```ruby
Document.pluck_as_json(:id, :active)
[
  {id: 18, active: false},
  {id: 19, active: false},
  {id: 20, active: true},
  {id: 21, active: true}
]
```

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
darthjee-active_ext-1.3.0	README.md
darthjee-active_ext-1.2.0	README.md