tagalong 0.0.6 → 0.0.7

data/README.md

@@ -69,24 +69,20 @@ It is necessary to declare at least one Tagger and Taggable in addition to gener
 
 Once Taggers and Taggables are declared, they can be used in numerous ways as outlined below.
 
-### Tagging
+### Tag Usage
 
-To tag, call the `tag` method on a Tagger object and hand it a persisted Taggable object with the given label that you want to apply.
+##### Tagging
 
-    @user.tag(@contact, "sometag")
+To tag a taggable, call the `tag` method on a Tagger object and hand it a persisted Taggable object with the given label that you want to apply.
 
-### Untagging
+    @user.tag(@contact, "sometag")
+    
+##### Untagging
 
 To untag, call the `untag` method on a Tagger object and hand it a persisted Taggable object with the given label that you want to untag.
 
     @user.untag(@contact, "sometag")
-
-### Deleting
-
-To delete a tag, call the `delete_tag` method on a Tagger object and hand it the label of the tag you want to delete. This will remove the tag from the Tagger, as well as all Taggables that might be using it.
-
-    @user.delete_tag("sometag")
-
+    
 ### List Tagger tags
 
 To list Tagger tags, call the `tags` method on a Tagger object. This will return an array of all tags that Tagger has ever used in ascending alphabetical order.
@@ -141,6 +137,21 @@ To check if a Taggable is tagged with a tag, call the `tagged_with?` method on a
     @contact.tagged_with?('some_tag')
     # => true
 
+### Tag Management
+
+##### Creating
+
+To create a tag on the Tagger object without applying the tag to a Taggable, call the `create_tag` method.
+
+  @user.create_tag("sometag")
+
+
+##### Deleting
+
+To delete a tag, call the `delete_tag` method on a Tagger object and hand it the label of the tag you want to delete. This will remove the tag from the Tagger, as well as all Taggables that might be using it.
+
+    @user.delete_tag("sometag")
+
 ## Credits
 
 I just wanted to thank all of the other open source Rails tagging plugins out there. Especially, [acts-as-taggable-on](http://github.com/mbleigh/acts-as-taggable-on), [is_taggable](http://github.com/jamesgolick/is_taggable), and [rocket_tag](http://github.com/bradphelan/rocket_tag). I learned a lot from you all.

data/lib/tagalong/tagger.rb

@@ -20,6 +20,10 @@ module Tagalong
         tag_manager.add_tag(tag_name)
       end
 
+      def create_tag(tag_name)
+        TagalongTag.create!(:tagger_id => self.id, :tagger_type => self.class.to_s, :name => tag_name)
+      end
+
       def untag(taggable_obj, tag_name)
         raise Tagalong::TaggableNotPersisted, "Taggable must be persisted to untag it." if !taggable_obj.persisted?
         tag_manager = Tagalong::TagManager.new(taggable_obj, self)

data/lib/tagalong/version.rb

@@ -1,3 +1,3 @@
 module Tagalong
-  VERSION = "0.0.6"
+  VERSION = "0.0.7"
 end

data/spec/lib/tagalong/tagger_spec.rb

@@ -17,6 +17,13 @@ describe "Tagger" do
       end
     end
 
+    describe "#create_tag" do
+      it "creates a new unassigned tag on the tagger" do
+        @user.create_tag('tag4')
+        @user.tags.should include('tag4')
+      end
+    end
+
     describe "#untag" do
       it "untags the tag from the given taggable object for the tagger" do
         @contact.tagalong_tags.create!(:name => "bar", :tagger_id => @user.id, :tagger_type => @user.class.to_s)
@@ -135,6 +142,13 @@ describe "Tagger" do
       end
     end
 
+    describe "#create_tag" do
+      it "creates a new tagalong tag for the tagger" do
+        Tagalong::TagalongTag.should_receive(:create!).with(hash_including({:tagger_id => @user.id, :tagger_type => @user.class.to_s, :name => 'tag4'}))
+        @user.create_tag('tag4')
+      end
+    end
+
     describe "#untag" do
       it "creates an instance of the tag manager" do
         tag_manager = stub('tag_manager', :remove_tag => nil)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tagalong
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.7
   prerelease: 
 platform: ruby
 authors:
@@ -13,7 +13,7 @@ date: 2012-05-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
-  requirement: &70298657761420 !ruby/object:Gem::Requirement
+  requirement: &70243968132040 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70298657761420
+  version_requirements: *70243968132040
 - !ruby/object:Gem::Dependency
   name: sqlite3
-  requirement: &70298657760980 !ruby/object:Gem::Requirement
+  requirement: &70243968131560 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70298657760980
+  version_requirements: *70243968131560
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70298657760560 !ruby/object:Gem::Requirement
+  requirement: &70243968131120 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70298657760560
+  version_requirements: *70243968131120
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70298657760120 !ruby/object:Gem::Requirement
+  requirement: &70243968130700 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,7 +54,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70298657760120
+  version_requirements: *70243968130700
 description: A Rails tagging plugin that makes sense.
 email:
 - cyphactor@gmail.com