Contents

h1. find_or_create_on_scopes -- Conditional creators for ActiveRecord

| *Author* | Tim Morgan |
| *Version* | 1.0 (Oct 29, 2010) |
| *License* | Released under the MIT license. |

h2. About

@find_or_create_on_scopes@ adds handy @find_or_create@-type methods to @ActiveRecord@. You can use these methods to conditionally create, initialize, or update records depending on the presence of similar records. They work on your base model class and any scopes derived therefrom. (See _Usage_ for examples.)

h2. Installation

*Important Note:* This gem requires Ruby 1.9. Ruby 1.8 is not and will never be supported.

To install, simply add the @find_or_create_on_scopes@ gem to your Rails application's @Gemfile@:

<pre><code>
gem 'find_or_create_on_scopes'
</code></pre>

h2. Usage

See the @FindOrCreateOnScopes@ module documentation for the complete list of conditional creators/updaters. Some basic examples to give you an overview:

<pre><code>
# Tries to find a user named 'riscfuture'. If such a User exists, returns it. If
# not, creates a user and sets its password to '123'.
User.where(login: 'riscfuture').find_or_create(password: '123')

# Tries to find a user named 'riscfuture'. If such a User exists, updates its
# password to '123'. If not, creates a new user and sets its password to '123'.
# Raises an exception if validation fails.
User.where(login: 'riscfuture').create_or_update!(password: '123')
</code></pre>

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
find_or_create_on_scopes-1.0.0	README.textile