Rails 3.. This bundle of delight is sure to put a smile on your ugly ass. So scrumptious in fact, after reading this blog post you’re probably going to do one of two things.

• frolic through the sunkissed meadow blowing dandelion petals
• feed splashing narwhals sardines out of you smiling mouth

Thats the kind of elation you’ll get when you bear witness to what Rails 3 pony’s up. Pretty much on par with organic unicorn whispers.

Lets begin this exaltation with our rapture from dependency hell. Meet my new best friend bundler. 1.) Specify your gems in a Gemfile  2.) Run “bundle install” 3.) Profit.. Need to lock down your gems? “bundle lock” I’ll let you marinate on that for a second…

Scope this player..

  class Post < ActiveRecord::Base
    scope :published, lambda {
      where("posts.published_at <= ?", Time.zone.now)
    }
    scope :published_since, lambda { |ago|
      published.where("posts.published_at >= ?", ago)
    }
    scope :recent, published.order("posts.published_at DESC")
  end

Stop drooling all over your keyboard for a second there chief and reflect on the allure of these refactored scoping methods. Ahhh, yes..

Moving on, stay with me..

No more pouting over routing. Rails 3 sprinked nectar all over routing’s face. Basically, more minimalist, succinct, powerful, flexible, sexy routing. e.g.

  # Rails 3
  root :to => 'forthe#win'

  # Rails 2
  map.root :controller => "forthe", :action => 'win'

  # Rails 3
  resources :products do
    resource :category
    member do
      post :short
    end
    collection do
      get :long
    end
  end

  # Rails 2
  map.resources :products, :member => {:short => :post}, :collection => {:long => :get} do |products|
    products.resource :category
  end

Still want more, fine.. How about agnosticism? Use whatever ORM you like. Use whatever javascript library your pretty little head desires. Rails 3 won’t judge you.

Well cupcake, so ends another spectacularly humorless blog post.. Hopefully you’re not nauseated by my writing and are becoming elated to begin working with Rails 3.

Ever since that fated column of light struck my monitor and forced my browser to google Solr, I’ve had the strength to overcome my addiction to SQL searches. Gone are the days of “select intervention_date from developers where search_method like ‘%sql%’”

Get out of that darkness cupcake! Let some light brighten up that dark and dreary world of murky sql search statements and enter a radiant and luminous world of vibrant Sunspot search!

We can get through this together…

Step 1: Installation

  gem install sunspot
  gem install sunspot_rails

Step 2: Define What to Index

  class Rehab
    #...
  end

  Sunspot.setup(Rehab) do
    text :addiction
    integer :relapses
    float :relapse_average
    time :admitted_at
    string :cure do
      addiction.gsub(/(darkness|clouds|shadows)/, 'sunshine')
    end
  end

Step 3: Search

  search = Sunspot.search Rehab do
    keywords 'light sunshine'
    with :patient_name, 'Benny Freshness'
    with(:relapses).any_of [2, 14]
    with(:relapse_average).less_than 4
    any_of do
      with(:admitted_at).less_than(Time.now)
    end
    without :cure, 'Moar SQL'
    order_by :average_relapse, :desc
    facet :cure
  end

Step 4: Profit

In all cerealness, I’d like to shed light on the line ‘facet :cure’ for a lightsecond as this really illuminates the vibrance of Sunspot. A “facet” is a glint of search aurora. Say my search lights up 45 results, by faceting on cure, we can get tallies of how many of each distinct cures are retuned in the result set e.g ‘moar SQL’:10, ‘Solr’:5, ‘Sunspot’:25, ‘Zippo’:1

By faceting we can irradiate our result set and re-kindle that old flame for search burning inside us all.

Furthermore, feast on these tasty Sunspot nuggets:

1. kindergarden easy index control
2. keyword search, ordering, scoping, awesomeing
3. indexing custom/dynamic field goodness
4. DSL which feels like your native toungue
5. faceting for days, CUSTOM FACETS!!
6. extensible, pick an ORM, any ORM
7. will_play with will_paginate
8. order by field value, relevance, geographical distance, or your face

Well folks, thats all I can illuminate for you here today. Hopefully my annoying “light” analogies don’t have you plotting to kill me by now. I also hope I cast some light on something you might be able to use or find interesting.

So remember, use the force, don’t join the dark side of SQL searching, step into the magnificent light of Sunspot!