tag_echidna 0.1.0

data/.gitignore

@@ -0,0 +1,2 @@
+Gemfile.lock
+spec/internal/db/*.sqlite

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/app/models/tag_echidna/tag.rb

@@ -0,0 +1,6 @@
+class TagEchidna::Tag < ActiveRecord::Base
+  has_many :taggings, :class_name => 'TagEchidna::Tagging',
+    :dependent => :destroy
+
+  validates :name, :presence => true, :uniqueness => true
+end

data/app/models/tag_echidna/tagging.rb

@@ -0,0 +1,7 @@
+class TagEchidna::Tagging < ActiveRecord::Base
+  belongs_to :taggable, :polymorphic => true
+  belongs_to :tag, :class_name => 'TagEchidna::Tag'
+
+  validates :taggable, :presence => true
+  validates :tag,      :presence => true
+end

data/db/migrate/1_tag_tables.rb

@@ -0,0 +1,27 @@
+class TagTables < ActiveRecord::Migration
+  def up
+    create_table :taggings do |t|
+      t.integer :tag_id,        :null => false
+      t.integer :taggable_id,   :null => false
+      t.string  :taggable_type, :null => false
+      t.timestamps
+    end
+
+    add_index :taggings, :tag_id
+    add_index :taggings, [:taggable_type, :taggable_id]
+    add_index :taggings, [:taggable_type, :taggable_id, :tag_id],
+      :unique => true, :name => 'unique_taggings'
+
+    create_table :tags do |t|
+      t.string :name, :null => false
+      t.timestamps
+    end
+
+    add_index :tags, :name, :unique => true
+  end
+
+  def down
+    drop_table :tags
+    drop_table :taggings
+  end
+end

data/lib/tag_echidna.rb

@@ -0,0 +1,7 @@
+module TagEchidna
+  #
+end
+
+require 'tag_echidna/active_record'
+require 'tag_echidna/engine'
+require 'tag_echidna/tag_names'

data/lib/tag_echidna/active_record.rb

@@ -0,0 +1,26 @@
+module TagEchidna::ActiveRecord
+  def self.included(base)
+    base.extend TagEchidna::ActiveRecord::ClassMethods
+  end
+
+  module ClassMethods
+    def has_many_tags
+      has_many :taggings, :class_name => 'TagEchidna::Tagging',
+        :as => :taggable, :dependent => :destroy
+      has_many :tags,     :class_name => 'TagEchidna::Tag',
+        :through => :taggings
+    end
+  end
+
+  def tag_names
+    @tag_names ||= TagEchidna::TagNames.new self
+  end
+
+  def tag_names=(names)
+    if names.is_a?(TagEchidna::TagNames)
+      @tag_names = names
+    else
+      @tag_names = TagEchidna::TagNames.new_with_names self, names
+    end
+  end
+end

data/lib/tag_echidna/engine.rb

@@ -0,0 +1,9 @@
+require 'rails/engine'
+
+class TagEchidna::Engine < Rails::Engine
+  engine_name :tag_echidna
+
+  ActiveSupport.on_load :active_record do
+    include TagEchidna::ActiveRecord
+  end
+end

data/lib/tag_echidna/tag_names.rb

@@ -0,0 +1,51 @@
+class TagEchidna::TagNames
+  include Enumerable
+
+  def self.new_with_names(taggable, names)
+    tag_names = new(taggable)
+    tag_names.clear
+    names.each { |name| tag_names << name }
+    tag_names
+  end
+
+  def initialize(taggable)
+    @taggable = taggable
+  end
+
+  def to_a
+    taggable.tags.collect &:name
+  end
+
+  def +(array)
+    array.each { |name| self.<< name }
+    self
+  end
+
+  def -(array)
+    array.each { |name| self.delete name }
+    self
+  end
+
+  def <<(name)
+    tag = TagEchidna::Tag.where(:name => name).first ||
+          TagEchidna::Tag.create(:name => name)
+
+    taggable.tags << tag
+  end
+
+  def clear
+    taggable.tags.clear
+  end
+
+  def delete(name)
+    taggable.tags.delete TagEchidna::Tag.where(:name => name).first
+  end
+
+  def each(&block)
+    to_a.each &block
+  end
+
+  private
+
+  attr_reader :taggable
+end

data/spec/acceptance/tag_names_spec.rb

@@ -0,0 +1,64 @@
+require 'spec_helper'
+
+describe "Managing tags via names" do
+  let(:article)   { Article.create }
+
+  it "returns tag names" do
+    article.tags << TagEchidna::Tag.create(:name => 'melbourne')
+
+    article.tag_names.to_a.should == ['melbourne']
+  end
+
+  it "adds tags via their names" do
+    article.tag_names << 'melbourne'
+
+    article.tags.collect(&:name).should == ['melbourne']
+  end
+
+  it "accepts a completely new set of tags" do
+    article.tag_names = ['portland', 'oregon']
+
+    article.tags.collect(&:name).should == ['portland', 'oregon']
+  end
+
+  it "enumerates through tag names" do
+    article.tag_names = ['melbourne', 'victoria']
+    names = []
+
+    article.tag_names.each do |name|
+      names << name
+    end
+
+    names.should == ['melbourne', 'victoria']
+  end
+
+  it "does not allow duplication of tags" do
+    existing = Article.create
+    existing.tags << TagEchidna::Tag.create(:name => 'portland')
+
+    article.tag_names = ['portland']
+
+    existing.tag_ids.should == article.tag_ids
+  end
+
+  it "appends tag names" do
+    article.tag_names  = ['portland']
+    article.tag_names += ['oregon', 'ruby']
+
+    article.tags.collect(&:name).should == ['portland', 'oregon', 'ruby']
+  end
+
+  it "removes a single tag name" do
+    article.tag_names = ['portland', 'oregon']
+    article.tag_names.delete 'oregon'
+
+    article.tags.collect(&:name).should == ['portland']
+  end
+
+  it "removes tag names" do
+    article.tag_names  = ['portland', 'oregon', 'ruby']
+    article.tag_names -= ['oregon', 'ruby']
+
+    article.tags.collect(&:name).should == ['portland']
+  end
+end

data/spec/acceptance/tags_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+describe 'Adding and removing tags' do
+  let(:article)  { Article.create }
+  let(:pancakes) { TagEchidna::Tag.create :name => 'pancakes' }
+
+  it "stores new tags" do
+    article.tags << pancakes
+
+    article.tags.reload.should == [pancakes]
+  end
+
+  it "removes existing tags" do
+    article.tags << pancakes
+
+    article.tags.delete pancakes
+
+    article.tags.reload.should == []
+  end
+end

data/spec/internal/app/models/article.rb

@@ -0,0 +1,3 @@
+class Article < ActiveRecord::Base
+  has_many_tags
+end

data/spec/internal/config/database.yml

@@ -0,0 +1,3 @@
+test:
+  adapter:  sqlite3
+  database: db/combustion_test.sqlite

data/spec/internal/db/schema.rb

@@ -0,0 +1,6 @@
+ActiveRecord::Schema.define do
+  create_table :articles, :force => true do |t|
+    t.string  :title
+    t.timestamps
+  end
+end

data/spec/internal/log/.gitignore

@@ -0,0 +1 @@
+*.log

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+require 'bundler'
+
+Bundler.require :default, :development
+
+Combustion.initialize! :active_record
+
+require 'rspec/rails'
+
+RSpec.configure do |config|
+  config.use_transactional_fixtures = true
+end

data/tag_echidna.gemspec

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*-
+Gem::Specification.new do |s|
+  s.name        = 'tag_echidna'
+  s.version     = '0.1.0'
+  s.authors     = ['Pat Allan']
+  s.email       = ['pat@freelancing-gods.com']
+  s.homepage    = 'https://github.com/pat/tag_echidna'
+  s.summary     = 'The Tag Echidna'
+  s.description = 'This friendly echidna gives you tags in your Rails app.'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {spec}/*`.split("\n")
+  s.require_paths = ['lib']
+
+  s.add_runtime_dependency     'activerecord', '>= 3.2.0'
+  s.add_development_dependency 'combustion',   '~> 0.4.0'
+  s.add_development_dependency 'rspec-rails',  '~> 2.13'
+  s.add_development_dependency 'sqlite3',      '~> 1.3.7'
+end

metadata

@@ -0,0 +1,127 @@
+--- !ruby/object:Gem::Specification
+name: tag_echidna
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Pat Allan
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-04-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+- !ruby/object:Gem::Dependency
+  name: combustion
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.13'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.7
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.7
+description: This friendly echidna gives you tags in your Rails app.
+email:
+- pat@freelancing-gods.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- app/models/tag_echidna/tag.rb
+- app/models/tag_echidna/tagging.rb
+- db/migrate/1_tag_tables.rb
+- lib/tag_echidna.rb
+- lib/tag_echidna/active_record.rb
+- lib/tag_echidna/engine.rb
+- lib/tag_echidna/tag_names.rb
+- spec/acceptance/tag_names_spec.rb
+- spec/acceptance/tags_spec.rb
+- spec/internal/app/models/article.rb
+- spec/internal/config/database.yml
+- spec/internal/db/schema.rb
+- spec/internal/log/.gitignore
+- spec/spec_helper.rb
+- tag_echidna.gemspec
+homepage: https://github.com/pat/tag_echidna
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: The Tag Echidna
+test_files: []
+has_rdoc: