mongoid_taggable_on 0.1.0 → 0.1.1

data/README.md

@@ -2,6 +2,10 @@
 
 Mongoid Taggable provides some helpers to create taggable documents, can use many fields.
 
+## Status
+
+[![CI Status](https://secure.travis-ci.org/huacnlee/mongoid_taggable_on.png)](http://travis-ci.org/huacnlee/mongoid_taggable_on)
+
 ## Installation
 
 You can simple install from rubygems:
@@ -36,6 +40,12 @@ Now you can use sample:
     irb> m.countries
     ["United States","China","Mexico"]
     
+find with tag:
+
+    irb> Movie.tagged_with_on(:actors, "Jason Statham, Joseph Gordon-Levitt")
+    irb> Movie.tagged_with_on(:actors, "Jason Statham, Joseph Gordon-Levitt", :match => :any)
+    irb> Movie.tagged_with_on(:actors, "Nicolas Cage", :match => :not)    
+
 ## Allow split chars
 
     , ，| /

data/lib/mongoid/taggable_on.rb

@@ -3,11 +3,70 @@ module Mongoid
   module TaggableOn
     extend ActiveSupport::Concern
     
-    def self.included(base)
-      base.extend(ClassMethods)
+    included do
+=begin rdoc
+find items with tag
+
+*Params*
+
+  * field_name      tagged field
+  * tags            match value, allow String or Array, case insensitive, for example: "Ruby,Python" or ["Ruby","Python"] or "ruby"
+  * match           (any,all,not) match type, default: all
+  
+*Usage*
+
+    Person.tagged_with_on(:skills, "ui design, photograph")
+    Person.tagged_with_on(:skills, "ui design, photograph").tagged_with_on(:languages, "english,chinese")
+    Person.tagged_with_on(:skills, "ui design, photograph").paginate(:page => params[:page])
+    
+=end
+      scope :tagged_with_on, Proc.new { |field_name, tags, opts|
+        return [] if field_name.blank?
+        opts ||= {}
+        opts[:match] ||= ""
+        field_name = field_name.to_s.tableize
+        tags = split_tag(tags) if tags.is_a?(String)
+        tags = tags.collect { |t| /#{t}/i }
+        case opts[:match].to_sym
+        when :any then
+          any_in(:"#{field_name}" => tags)
+        when :not then
+          not_in(:"#{field_name}" => tags)
+        else
+          # ALL
+          all_in(:"#{field_name}" => tags)
+        end
+      }
     end
     
     module ClassMethods
+      
+=begin rdoc
+=Define a tag field
+*For example:*
+
+    class Person
+      include Mongoid::Document
+      include Mongoid::TaggableOn
+      taggable_on :languages
+      taggable_on :skills
+    end
+
+*Then will has there methods and fields:*
+
+    field :languages, :type => Array, :default => []
+    def language_list; end
+    def language_list=(value); end
+    field :skills, :type => Array, :default => []
+    def skill_list; end
+    def skill_list=(value); end
+   
+*Params*
+
+  * field_name      <em>name for tag field</em>
+  * opts[:index]    <em>(true/false) allow create index in MongoDB, default: true</em>
+  
+=end
       def taggable_on(field_name, opts = {})
         field_name = field_name.to_s.tableize
         field_name_single = field_name.singularize
@@ -24,7 +83,7 @@ module Mongoid
           
           def #{field_name_single}_list=(value)
             if !value.blank?
-              self.#{field_name} = value.split(/,|，|\\/|\\|/).collect { |tag| tag.strip }.uniq
+              self.#{field_name} = self.class.split_tag(value)
             end
           end
           
@@ -34,6 +93,10 @@ module Mongoid
           end
         }
       end
+      
+      def split_tag(value)
+        value.split(/,|，|\/|\|/).collect { |tag| tag.strip }.uniq
+      end
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mongoid_taggable_on
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-03-21 00:00:00.000000000 Z
+date: 2012-03-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mongoid
-  requirement: &70127184176480 !ruby/object:Gem::Requirement
+  requirement: &70160600877500 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>'
@@ -21,7 +21,7 @@ dependencies:
         version: 2.0.0
   type: :runtime
   prerelease: false
-  version_requirements: *70127184176480
+  version_requirements: *70160600877500
 description: Mongoid Taggable provides some helpers to create taggable documents,
   can use many fields.
 email:
@@ -53,7 +53,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.11
+rubygems_version: 1.8.10
 signing_key: 
 specification_version: 3
 summary: Mongoid Taggable provides some helpers to create taggable documents, can