tags 0.0.1 → 1.0.0

data/.gitignore

@@ -1,4 +1,6 @@
 *.gem
 .bundle
+.rspec
+.rvmrc
 Gemfile.lock
 pkg/*

data/Gemfile

@@ -1,3 +1,3 @@
 source "http://rubygems.org"
 
-gemspec
+gemspec

data/README.rdoc

@@ -0,0 +1,34 @@
+= Tags
+
+A Ruby object that acts like a set of tags.
+
+== Notice
+
+This gem is still an infant. Although at a stable version, many expected features aren't available. See "Future API" below.
+
+== Current API
+
+=== Removing tags
+
+    Tags.new("one two three") - Tags.new("one three")
+    # Tags.new("two")
+
+=== Adding tags
+
+    Tags.new("one two three") - Tags.new("three four five")
+    # Tags.new("one two three four five")
+
+=== Conversions
+
+    Tags.new("one two three").to_s
+    # "one two three"
+
+    Tags.new("one two three").to_a
+    # ["one", "two", "three"]
+
+    Tags.new("one two three").to_set
+    # #<Set: {"one", "two", "three"}>
+
+== Future API
+
+- I will fill this out soon

data/lib/tags/version.rb

@@ -1,3 +1,3 @@
-module Tags
-  VERSION = "0.0.1"
+class Tags
+  VERSION = "1.0.0"
 end

data/lib/tags.rb

@@ -1,3 +1,48 @@
-module Tags
-  # Your code goes here...
-end
+require 'set'
+require 'active_support'
+
+class Tags
+
+  include Comparable
+
+  ##################################################
+
+  def initialize(str_or_ary = nil)
+    ary = str_or_ary.is_a?(Array) ? str_or_ary : str_or_ary.to_s.split(' ')
+    @tags_set = Set.new(ary)
+  end
+
+  def to_s
+    to_a.join(' ')
+  end
+
+  def to_a
+    tags_set.to_a
+  end
+
+  def to_set
+    tags_set.dup
+  end
+
+  def -(other)
+    raise ArgumentError, "must be a #{self.class} object" unless other.is_a?(self.class)
+    ary_diff = (tags_set - other.to_set).to_a
+    self.class.new(ary_diff)
+  end
+
+  def +(other)
+    raise ArgumentError, "must be a #{self.class} object" unless other.is_a?(self.class)
+    ary_add = (tags_set + other.to_set).to_a
+    self.class.new(ary_add)
+  end
+
+  def <=>(other)
+    tags_set <=> other.to_set
+  end
+
+  ##################################################
+  private
+
+  attr_reader :tags_set
+
+end

data/spec/lib/tags_spec.rb

@@ -0,0 +1,70 @@
+require 'spec_helper'
+
+describe Tags do
+
+  describe "#to_s" do
+    it { Tags.new("one two").to_s.should eq("one two") }
+    it { Tags.new.to_s.should eq("") }
+  end
+
+  describe "#to_a" do
+    it { Tags.new("one two").to_a.should eq(["one", "two"]) }
+    it { Tags.new.to_a.should eq([]) }
+  end
+
+  describe "#to_set" do
+    it { Tags.new("one two").to_set.should eq(Set.new(["one", "two"])) }
+    it { Tags.new.to_set.should eq(Set.new) }
+  end
+
+  describe "#-" do
+    context "with a Tags" do
+      it { (Tags.new - Tags.new("one")).should eq(Tags.new) }
+      it { (Tags.new("one") - Tags.new("one")).should eq(Tags.new) }
+      it { (Tags.new("one two") - Tags.new("one")).should eq(Tags.new("two")) }
+      it { (Tags.new("one two") - Tags.new("three")).should eq(Tags.new("one two")) }
+      it { (Tags.new("one two three") - Tags.new("one three")).should eq(Tags.new("two")) }
+    end
+
+    it "argument must be of the Tags type" do
+      lambda do
+        Tags.new("one") - ["one"]
+      end.should raise_error(ArgumentError, "must be a Tags object")
+    end
+  end
+
+  describe "#+" do
+    context "with a Tags" do
+      it { (Tags.new + Tags.new("one")).should eq(Tags.new("one")) }
+      it { (Tags.new("one") + Tags.new("one")).should eq(Tags.new("one")) }
+      it { (Tags.new("one two") + Tags.new).should eq(Tags.new("one two")) }
+      it { (Tags.new("one two") + Tags.new("three")).should eq(Tags.new("one two three")) }
+    end
+
+    it "argument must be of the Tags type" do
+      lambda do
+        Tags.new("one") + ["one"]
+      end.should raise_error(ArgumentError, "must be a Tags object")
+    end
+  end
+
+  describe "#==" do
+    context "with a Tags containing the same items" do
+      it { Tags.new("one two").should eq(Tags.new("one two")) }
+      it { Tags.new("one two three").should eq(Tags.new("one two three")) }
+      it { Tags.new("one two").should eq(Tags.new("one two")) }
+      it { Tags.new.should eq(Tags.new) }
+
+      it { Tags.new("one two").should_not eq(Tags.new("one two three")) }
+      it { Tags.new.should_not eq(Tags.new("one two three")) }
+    end
+
+    context "with a non-Tags" do
+      it { Tags.new("one").should_not eq("str") }
+      it { Tags.new("one").should_not eq(["str"]) }
+      it { Tags.new("one").should_not eq(Set.new(["str"])) }
+      it { Tags.new.should_not eq(nil) }
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require File.expand_path(File.dirname(__FILE__) + '/../lib/tags')

data/tags.gemspec

@@ -17,4 +17,8 @@ Gem::Specification.new do |s|
   s.test_files= `git ls-files -- {test,spec,features}/*`.split("\n")
   s.executables = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   s.require_paths = ["lib"]
+
+  s.add_development_dependency "rspec", "~> 2"
+
+  s.add_dependency "activesupport", "~> 3"
 end

metadata

@@ -3,10 +3,10 @@ name: tags
 version: !ruby/object:Gem::Version 
   prerelease: false
   segments: 
+  - 1
   - 0
   - 0
-  - 1
-  version: 0.0.1
+  version: 1.0.0
 platform: ruby
 authors: 
 - Austin Schneider
@@ -14,10 +14,35 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-02-08 00:00:00 -05:00
+date: 2011-02-16 00:00:00 -05:00
 default_executable: 
-dependencies: []
-
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        version: "2"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 3
+        version: "3"
+  type: :runtime
+  version_requirements: *id002
 description: A Ruby object with the behavior of a list of tags.
 email: 
 - soccer022483@gmail.com
@@ -34,6 +59,8 @@ files:
 - Rakefile
 - lib/tags.rb
 - lib/tags/version.rb
+- spec/lib/tags_spec.rb
+- spec/spec_helper.rb
 - tags.gemspec
 has_rdoc: true
 homepage: http://github.com/soccer022483/tags
@@ -67,5 +94,6 @@ rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
 summary: A Ruby object with the behavior of a list of tags.
-test_files: []
-
+test_files: 
+- spec/lib/tags_spec.rb
+- spec/spec_helper.rb