0.02
No commit activity in last 3 years
No release in over 3 years
Tagged caching support for Rails
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

 Project Readme

Rails Cache Tags Build Status

Tagged caching support within your Rails application. Tested against Rails 3.x and Rails 4.0. Dalli store is also supported!

Installation

Add this line to your application's Gemfile:

gem 'rails-cache-tags'

And then execute:

$ bundle

Or install it yourself as:

$ gem install rails-cache-tags

Usage

Anywhere:

cache = Rails.cache

cache.write "foo", "bar", :tags => %w(baz foo)
cache.read "foo" # => "bar"

cache.delete_tag "baz"
cache.read "foo" => nil

More realistic example:

class PostsController < ApplicationController
  def index
    @posts = cache.read("posts") || begin
      posts_from_db = Post.all

      cache.write "posts", posts_from_db, :tags => {:post => posts_from_db.map(&:id)}

      posts_from_db
    end
  end

  def show
    id = params[:id]

    @post = cache.fetch(["post", id], :tags => {:post => id}) do
      Post.find(id)
    end
  end

  def update
    @post = Post.find(params[:id])

    if @post.update_attributes
      cache.delete_tag :post => @post.id
    end
  end
end

In your controller:

class PostController < ActionController::Base
  def update
    @post = Post.find_by_id(params[:id])

    if @post.update_attributes(params)
      expire_fragments_by_tags :post => @post.id
    else
      render :edit
    end
  end
end

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Write tests!
  5. Run tests against all major version of Rails starting from 3.0
  6. Push to the branch (git push origin my-new-feature)
  7. Create new Pull Request