Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Build up named scopes conditionally.
Branch: master
Failed to load latest commit information.
lib merging scope additions into model additions since it's basically the…
script fixing script/console so it properly loads the environment
tasks initial import
.gitignore rewriting builder to act as a simple delegator
CHANGELOG releasing v0.1.2
LICENSE initial import
Manifest releasing v0.1.2
README.rdoc renaming readme for rdoc
Rakefile releasing v0.1.2
scope-builder.gemspec releasing v0.1.2


Scope Builder

Build up named scopes conditionally.


First specify it in your Rails config.

config.gem 'ryanb-scope-builder', :lib => 'scope_builder', :source => ''

And then install it.

rake gems:install

Rails 2.1 or later required.


This gem adds the scope_builder method to all Active Record models. A builder behaves exactly like any other named scope except that calling other named scopes on it will alter the builder itself rather than returning a new named scope.

builder = Product.scope_builder
builder.released.visible # call a couple named scopes to change builder if only_show_cheap_products? # build scopes conditionally

The scope_builder method can also take a block which will return the builder. This is useful when you are using the builder in a model search method.

# in product model
  scope_builder do |builder|
    builder.released.visible if options[:cheap]

The scope_builder method can also be called on an existing scope.

products = Product.released.visible
builder = products.scope_builder if only_show_cheap_products?


This project can be found on github at the following URL.

If you would like to contribute to this project, please fork the repository and send me a pull request.

Something went wrong with that request. Please try again.