has_tags 0.0.4 → 0.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8ad1ceeb59db26549f51f3470e4b2fd2dbeb0986
-  data.tar.gz: 31705964c92458f7296f341044343d9700223bf8
+  metadata.gz: 28e794b8649a411c1d4003a1bb1f5f2ef5213661
+  data.tar.gz: 435486ee9d2131acdbdef28cb73a463de1224fcb
 SHA512:
-  metadata.gz: b7f42b7bd4fb85e5e2559242d90e8c3e43ed439e8e343f36b8c3380185873b24291d32b97853df8d7810952bdb6d1097caaecbac7353b07edee9bf2ed9652f24
-  data.tar.gz: 9ed1506104d3996713dc5bf9638df265ce1dd0aaa65f5e20933a6cd5f5a2e29af2053b483c24eb95786ab7a46b97bba290a5353f123006c0be10f54aab35333c
+  metadata.gz: 600995d32c22bdddc71144d9e3e99d400dc937315173b2e71d51b9c516649260ddced1a8e47435ba5ae875653edcecd498cbb9f0d61aab2594c060076f3ef911
+  data.tar.gz: d6effdd771768b4bfa93dbc05cd0b21eaf80a7ae3459746907d29a7377d9f654007ba35e0d356fa307a9ff252da8286694149573bcb7b02089750c58652cbac4

data/README.md

@@ -49,6 +49,40 @@ end
 
 <code>tag_list</code> should be a string with tags separated by commas, or colons to create a context tag.
 
+To find all instances of an object associated with a certain tag, use the <code>tagged_with</code> class method, which takes an array of tag names to search by:
+
+```ruby
+Post.tagged_with(["Sports"]) # => All posts tagged with "Sports"
+
+```
+
+Since it accepts an array of tag names, you can something like this:
+
+```ruby
+Post.tagged_with(["Sports", "Lacrosse", "2014"]) # => All posts tagged with "Sports", "Lacrosse", and "2014"
+```
+
+Input to <code>tagged_with</code> doesn't need to be an exact match, making it good for searching:
+
+```ruby
+search_term = params[:search_term] # Let's say a user input "sport"
+
+Post.tagged_with([search_term]) # => All posts tagged with "Sports"
+```
+
+You can also get all of the top level tags for a specific class:
+
+```ruby
+Post.top_level_tags # => All tags that are associated with a "Post" object and that have have no parent tags
+```
+
+Or for all classes that have tags:
+
+```
+HasTags::Tag.top_level_tags # => All tags that have no parent tags
+```
+
+
 ### Examples
 
 For creating top-level tags, a user can type in tags only separated by commas:

data/lib/has_tags/tag.rb

@@ -1,10 +1,16 @@
 module HasTags
   class Tag < ::ActiveRecord::Base
+    #### Self referential association for contexts ####
     belongs_to :context, class_name: "Tag"
-
     has_many :tags, foreign_key: :context_id
+    ###################################################
+
     has_many :taggings
 
     validates :name, uniqueness: true, presence: true  
+
+    def self.top_level_tags
+      where(context_id: nil)
+    end
   end
 end

data/lib/has_tags/taggable.rb

@@ -24,10 +24,26 @@ module HasTags
       include InstanceMethods
     end
 
+    def tagged_with(tag_names)
+      instances = []
+      tag_names.each do |tag_name|
+        self.all.each do |instance|
+          if instance.tags.where("lower(name) LIKE ?", "%#{tag_name}%").present?
+            instances << instance
+          end
+        end
+      end 
+      instances
+    end
+
+    def top_level_tags
+      HasTags::Tag.where(context_id: nil) && HasTags::Tag.all
+        .collect{|tag| tag if tag.taggings.where(taggable_type: self.to_s).present? }
+    end
+
     module InstanceMethods
       def save_taggings
-        taggings = HasTags::Tagging.where(taggable_type: self.class.to_s, taggable_id: nil)
-        puts taggings.map(&:attributes)
+        taggings = HasTags::Tagging.where(taggable_type: self.class.to_s, taggable_id: nil) 
         taggings.each do |tagging|
           tagging.taggable_id = self.id
           tagging.save

data/lib/has_tags/version.rb

@@ -1,3 +1,3 @@
 module HasTags
-  VERSION = "0.0.4"
+  VERSION = "0.0.5"
 end

data/spec/tag_spec.rb

@@ -15,5 +15,15 @@ describe HasTags::Tag do
     HasTags::Tag.create(name: "Sports")
     HasTags::Tag.create(name: "Sports") 
     expect(HasTags::Tag.all.count).to eq(1)
+  end 
+
+  it "should return all top level tags" do
+    tag1 = HasTags::Tag.create(name: "Sports")
+    tag2 = HasTags::Tag.create(name: "Lax", context_id: tag1.id)
+    tag3 = HasTags::Tag.create(name: "Hockey", context_id: tag1.id)
+    tag4 = HasTags::Tag.create(name: "Food")
+
+    expect(HasTags::Tag.top_level_tags).not_to include(tag2, tag3)
+    expect(HasTags::Tag.top_level_tags).to include(tag1, tag4) 
   end
 end

data/spec/taggable_spec.rb

@@ -43,4 +43,43 @@ describe TaggableModel do
 
     expect(model.tag_list).to eq("Sports, Lacrosse")
   end
+
+  it "should retrieve all top level tags for class" do
+    model = TaggableModel.new(name: "post") 
+    tag_names = "Sports:Lacrosse"
+    model.tag_list = tag_names
+    model.save
+    tag = model.tags.first
+    
+    expect(TaggableModel.top_level_tags).to include(tag)
+  end
+
+  context "TaggableModel.tagged_with" do
+    it "should return all intances of it's class that are tagged with a specific tag" do
+      model = TaggableModel.new(name: "post") 
+      tag_names = "Sports:Lacrosse"
+      model.tag_list = tag_names
+      model.save
+
+      expect(TaggableModel.tagged_with(["sport"])).to include(model)
+    end
+
+    it "should return tag with similar title" do
+      model = TaggableModel.new(name: "post") 
+      tag_names = "Sports:Lacrosse"
+      model.tag_list = tag_names
+      model.save
+
+      expect(TaggableModel.tagged_with(["Sports"])).to include(model) 
+    end
+
+    it "should accept multiple tags to search by" do
+      model = TaggableModel.new(name: "post") 
+      tag_names = "Sports:Lacrosse"
+      model.tag_list = tag_names
+      model.save
+      
+      expect(TaggableModel.tagged_with(["sports", "lacrosse"])).to include(model)
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: has_tags
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.5
 platform: ruby
 authors:
 - Garrett Martin
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-08-27 00:00:00.000000000 Z
+date: 2014-08-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord