catche 0.2 → 0.2.1

data/README.md

@@ -1,6 +1,6 @@
 # Catche [![Build Status](https://secure.travis-ci.org/Arjeno/catche.png?branch=master)](http://travis-ci.org/Arjeno/catche)
 
-Catche is a caching library for Ruby on Rails. It automates automated resource and collection caching/expiration. It basically tags cached outputs and expires those tags based on configuration.
+Catche is a caching library for Ruby on Rails. It automates resource and collection caching/expiration. It basically tags cached outputs and expires those tags based on configuration.
 
 ## Installation
 
@@ -21,9 +21,24 @@ class ProjectsController < ApplicationController
 end
 ```
 
+This will result in the following expirations:
+
+```ruby
+@project.update_attributes({ :title => 'Update!' }) # or @project.destroy
+
+# => Expires /projects
+# => Expires: /projects/1
+```
+
+```ruby
+@project.create
+
+# => Expires /projects
+```
+
 ### Associative caching
 
-For advanced usage such as advanced caching you need to configure this in the model.
+Catche supports associative (nested) caching.
 
 ```ruby
 class Task < ActiveRecord::Base
@@ -37,18 +52,26 @@ class TasksController < ApplicationController
 end
 ```
 
-On resource `update` and `destroy` this will expire:
+This will result in the following expirations:
 
-* Resource: `tasks_1`
-* Collection: `tasks`
-* Collection: `projects_1_tasks_1`
+```ruby
+@task.update_attributes({ :title => 'Update!' }) # or @task.destroy
+
+# => Expires /tasks
+# => Expires: /projects/1/tasks
+# => Expires: /projects/1/tasks/1
+```
+
+```ruby
+@project.tasks.create
 
-On resource `create` this will expire:
+# => Expires /tasks
+# => Expires: /projects/1/tasks
+```
 
-* Collection: `tasks`
-* Collection: `projects_1_tasks_1`
+### Multiple associations
 
-You can use as many associations as you would like;
+You can use as many associations as you would like. Associations are not nested.
 
 ```ruby
 class Task < ActiveRecord::Base
@@ -56,6 +79,26 @@ class Task < ActiveRecord::Base
 end
 ```
 
+This will result in the following expirations:
+
+```ruby
+@task.update_attributes({ :title => 'Update!' }) # or @task.destroy
+
+# => Expires /tasks
+# => Expires: /projects/1/tasks
+# => Expires: /projects/1/tasks/1
+# => Expires: /users/1/tasks
+# => Expires: /users/1/tasks/1
+```
+
+```ruby
+@project.tasks.create
+
+# => Expires /tasks
+# => Expires: /projects/1/tasks
+# => Expires: /users/1/tasks
+```
+
 ### Advanced configuration
 
 ```ruby
@@ -81,6 +124,28 @@ class Task < ActiveRecord::Base
 end
 ```
 
+## Manually expiring a cache
+
+```ruby
+@task.expire_resource!
+@task.expire_collection!
+@task.expire.expire_resource_and_collection!
+```
+
+## Supported cache stores
+
+Catche currently supports:
+
+* MemoryStore
+* Memcached
+* Dalli
+
+Want support for more? Just fork and open up a pull request.
+
+## Roadmap
+
+* View cache
+
 ## License
 
 This project is released under the MIT license.

data/lib/catche/tag/collect.rb

@@ -32,13 +32,12 @@ module Catche
           set_tags    = []
           expire_tags = []
 
-          if association_tags.any?
-            set_tags  << Tag.join(*association_tags, resource_class.catche_tag)
-          else
-            # Without any associations, add just the collection tag
-            set_tags  << resource_class.catche_tag
+          association_tags.each do |tag|
+            set_tags  << Tag.join(tag, resource_class.catche_tag)
           end
 
+          set_tags    << resource_class.catche_tag if association_tags.blank?
+
           expire_tags << resource_class.catche_tag if include_base
           expire_tags += set_tags
 

data/lib/catche/version.rb

@@ -1,3 +1,3 @@
 module Catche
-  VERSION = "0.2"
+  VERSION = "0.2.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: catche
 version: !ruby/object:Gem::Version
-  version: '0.2'
+  version: 0.2.1
   prerelease: 
 platform: ruby
 authors:
@@ -13,7 +13,7 @@ date: 2012-06-22 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
-  requirement: &70299120119960 !ruby/object:Gem::Requirement
+  requirement: &70193875371180 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -21,10 +21,10 @@ dependencies:
         version: 3.2.0
   type: :runtime
   prerelease: false
-  version_requirements: *70299120119960
+  version_requirements: *70193875371180
 - !ruby/object:Gem::Dependency
   name: sqlite3
-  requirement: &70299120118620 !ruby/object:Gem::Requirement
+  requirement: &70193875370760 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70299120118620
+  version_requirements: *70193875370760
 - !ruby/object:Gem::Dependency
   name: rspec-rails
-  requirement: &70299120117540 !ruby/object:Gem::Requirement
+  requirement: &70193875370300 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70299120117540
+  version_requirements: *70193875370300
 - !ruby/object:Gem::Dependency
   name: capybara
-  requirement: &70299120115880 !ruby/object:Gem::Requirement
+  requirement: &70193875369880 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,10 +54,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70299120115880
+  version_requirements: *70193875369880
 - !ruby/object:Gem::Dependency
   name: guard-rspec
-  requirement: &70299120113480 !ruby/object:Gem::Requirement
+  requirement: &70193875369460 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -65,10 +65,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70299120113480
+  version_requirements: *70193875369460
 - !ruby/object:Gem::Dependency
   name: guard-spork
-  requirement: &70299120112920 !ruby/object:Gem::Requirement
+  requirement: &70193875369040 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -76,7 +76,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70299120112920
+  version_requirements: *70193875369040
 description: ''
 email:
 - mail@arjen.me