dm-is-slug 0.10.2

data/.gitignore

@@ -0,0 +1,3 @@
+pkg
+coverage
+tmp

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Aaron Qian
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.textile

@@ -0,0 +1,56 @@
+= dm-is-slug
+
+DataMapper plugin for creating and slugs(permalinks).
+
+== Installation
+
+NOTE: You no longer need to download dm-more source code in order to install
+this.
+
+All you need to do is:
+
+$ sudo rake install
+
+Remember to require it in your app's init.rb
+
+dependency 'dm-is-slug'
+
+== Getting started
+
+Lets say we have a post-class, and we want to generate permalinks or slugs for all posts.
+
+class Post
+  include DataMapper::Resource
+
+  property :id, Serial
+  property :title, String
+  property :content, String
+
+  # here we define that it should have a slug that uses title as the permalink
+  # it will generate an extra slug property of String type, with the same size as title
+  is :slug, :source => :title
+end
+
+Let's Say we need to define a permalink based on a method instead of a property.
+
+class User
+  include DataMapper::Resource
+
+  property :id, Serial
+  property :email, String
+  property :password, String
+  
+  # we only want to strip out the domain name 
+  # and use only the email account name as the permalink
+  def slug_for_email
+    email.split("@").first
+  end
+  
+  # here we define that it should have a slug that uses title as the permalink
+  # it will generate an extra slug property of String type, with the same size as title
+  is :slug, :source => :slug_for_email, :size => 255
+end
+
+You can now find objects by slug like this:
+
+ post = Post.first(:slug => "your_slug")

data/Rakefile

@@ -0,0 +1,32 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  gem 'jeweler', '~> 1.4'
+  require 'jeweler'
+ 
+  Jeweler::Tasks.new do |gem|
+    gem.name = "dm-is-slug"
+    gem.summary = "DataMapper plugin that generates unique slugs"
+    gem.description = gem.summary
+    gem.email = [
+      'aq1018@gmail.com',
+      'james.herdman@gmail.com',
+      'nik [a] terminaldischarge [d] net',
+      'maverick.stoklosa@gmail.com',
+      'frawl021@gmail.com',
+      'cheba@pointlessone.org'
+    ]
+    gem.homepage = "http://github.com/aq1018/dm-is-slug"
+    gem.authors = ['Aaron Qian', 'James Herdman', 'Nik Radford', 'Paul', 'Mike Frawley', 'Alex Makuta']
+    gem.add_dependency "dm-core", "~>0.10.2"
+    gem.add_dependency "unidecode", "~>1.0.0"
+    gem.add_development_dependency 'rspec', '~> 1.3'
+  end
+ 
+  Jeweler::GemcutterTasks.new
+ 
+  FileList['tasks/**/*.rake'].each { |task| import task }
+rescue LoadError
+  puts 'Jeweler (or a dependency) not available. Install it with: gem install jeweler'
+end

data/TODO

@@ -0,0 +1,4 @@
+TODO
+====
+
+Docs??

data/VERSION

@@ -0,0 +1 @@
+0.10.2

data/dm-is-slug.gemspec

@@ -0,0 +1,69 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{dm-is-slug}
+  s.version = "0.10.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Aaron Qian", "James Herdman", "Nik Radford", "Paul", "Mike Frawley", "Alex Makuta"]
+  s.date = %q{2010-02-07}
+  s.description = %q{DataMapper plugin that generates unique slugs}
+  s.email = ["aq1018@gmail.com", "james.herdman@gmail.com", "nik [a] terminaldischarge [d] net", "maverick.stoklosa@gmail.com", "frawl021@gmail.com", "cheba@pointlessone.org"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.textile",
+     "TODO"
+  ]
+  s.files = [
+    ".gitignore",
+     "LICENSE",
+     "README.textile",
+     "Rakefile",
+     "TODO",
+     "VERSION",
+     "dm-is-slug.gemspec",
+     "lib/dm-is-slug.rb",
+     "lib/dm-is-slug/is/slug.rb",
+     "spec/integration/slug_spec.rb",
+     "spec/rcov.opts",
+     "spec/spec.opts",
+     "spec/spec_helper.rb",
+     "tasks/ci.rake",
+     "tasks/metrics.rake",
+     "tasks/spec.rake",
+     "tasks/yard.rake",
+     "tasks/yardstick.rake"
+  ]
+  s.homepage = %q{http://github.com/aq1018/dm-is-slug}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{DataMapper plugin that generates unique slugs}
+  s.test_files = [
+    "spec/integration/slug_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<dm-core>, ["~> 0.10.2"])
+      s.add_runtime_dependency(%q<unidecode>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<rspec>, ["~> 1.3"])
+    else
+      s.add_dependency(%q<dm-core>, ["~> 0.10.2"])
+      s.add_dependency(%q<unidecode>, ["~> 1.0.0"])
+      s.add_dependency(%q<rspec>, ["~> 1.3"])
+    end
+  else
+    s.add_dependency(%q<dm-core>, ["~> 0.10.2"])
+    s.add_dependency(%q<unidecode>, ["~> 1.0.0"])
+    s.add_dependency(%q<rspec>, ["~> 1.3"])
+  end
+end
+

data/lib/dm-is-slug.rb

@@ -0,0 +1,7 @@
+require 'pathname'
+require 'dm-core'
+
+# Require plugin-files
+require Pathname(__FILE__).dirname.expand_path / 'dm-is-slug' / 'is' / 'slug.rb'
+
+DataMapper::Model.append_extensions DataMapper::Is::Slug

data/lib/dm-is-slug/is/slug.rb

@@ -0,0 +1,185 @@
+require 'unidecode'
+require 'dm-core/support/chainable'
+
+module DataMapper
+  module Is
+    module Slug
+      class InvalidSlugSourceError < StandardError; end
+
+      # @param [String] str A string to escape for use as a slug
+      # @return [String] an URL-safe string
+      def self.escape(str)
+        s = str.to_ascii
+        s.gsub!(/\W+/, ' ')
+        s.strip!
+        s.downcase!
+        s.gsub!(/\ +/, '-')
+        s
+      end
+
+      ##
+      # Methods that should be included in DataMapper::Model.
+      # Normally this should just be your generator, so that the namespace
+      # does not get cluttered. ClassMethods and InstanceMethods gets added
+      # in the specific resources when you fire is :slug
+      ##
+
+      # Defines a +slug+ property on your model with the same length as your
+      # source property. This property is Unicode escaped, and treated so as
+      # to be fit for use in URLs.
+      #
+      # ==== Example
+      # Suppose your source attribute was the following string: "Hot deals on
+      # Boxing Day". This string would be escaped to "hot-deals-on-boxing-day".
+      #
+      # Non-ASCII characters are attempted to be converted to their nearest
+      # approximate.
+      #
+      # ==== Parameters
+      # +permanent_slug+::
+      #   Permanent slugs are not changed even if the source property has
+      # +source+::
+      #   The property on the model to use as the source of the generated slug,
+      #   or an instance method defined in the model, the method must return
+      #   a string or nil.
+      # +length+::
+      #   The length of the +slug+ property
+      #
+      # @param [Hash] provide options in a Hash. See *Parameters* for details
+      def is_slug(options)
+        if options.key?(:size)
+          warn "Slug with :size option is deprecated, use :length instead"
+          options[:length] = options.delete(:size)
+        end
+
+        extend  DataMapper::Is::Slug::ClassMethods
+        include DataMapper::Is::Slug::InstanceMethods
+        extend Chainable
+
+        @slug_options = {}
+
+        @slug_options[:permanent_slug] = options.delete(:permanent_slug)
+        @slug_options[:permanent_slug] = true if @slug_options[:permanent_slug].nil?
+
+        @slug_options[:source] = options.delete(:source)
+        raise InvalidSlugSourceError, 'You must specify a :source to generate slug.' unless slug_source
+
+
+        options[:length] ||= get_slug_length
+        property(:slug, String, options.merge(:unique => true)) unless slug_property
+
+        before :valid?, :generate_slug
+        before :save, :generate_slug
+      end
+
+      module ClassMethods
+        attr_reader :slug_options
+
+        def permanent_slug?
+          slug_options[:permanent_slug]
+        end
+
+        def slug_source
+          slug_options[:source] ? slug_options[:source].to_sym : nil
+        end
+
+        def slug_source_property
+          detect_slug_property_by_name(slug_source)
+        end
+
+        def slug_property
+          detect_slug_property_by_name(:slug)
+        end
+
+        private
+
+        def detect_slug_property_by_name(name)
+          p = properties[name]
+          !p.nil? && p.type == String ? p : nil
+        end
+
+        def get_slug_length
+          slug_property.nil? ? (slug_source_property.nil? ? DataMapper::Property::DEFAULT_LENGTH : slug_source_property.length) : slug_property.length
+        end
+      end # ClassMethods
+
+      module InstanceMethods
+        def to_param
+          [slug]
+        end
+
+        def permanent_slug?
+          self.class.permanent_slug?
+        end
+
+        def slug_source
+          self.class.slug_source
+        end
+
+        def slug_source_property
+          self.class.slug_source_property
+        end
+
+        def slug_property
+          self.class.slug_property
+        end
+
+        def slug_source_value
+          self.send(slug_source)
+        end
+
+        # The slug is not stale if
+        # 1. the slug is permanent, and slug column has something valid in it
+        # 2. the slug source value is nil or empty
+        def stale_slug?
+          !((permanent_slug? && slug && !slug.empty?) || (slug_source_value.nil? || slug_source_value.empty?))
+        end
+
+        private
+
+        def generate_slug
+          #puts "\nGenerating slug for #{self.class.name}: #{self.key.inspect}\n"
+          return unless self.class.respond_to?(:slug_options) && self.class.slug_options
+          raise InvalidSlugSourceError, 'Invalid slug source.' unless slug_source_property || self.respond_to?(slug_source)
+          return unless stale_slug?
+          attribute_set :slug, unique_slug
+        end
+
+        def unique_slug
+          old_slug = self.slug
+          max_length = self.class.send(:get_slug_length)
+          base_slug = ::DataMapper::Is::Slug.escape(slug_source_value)[0, max_length]
+          i = 1
+          new_slug = base_slug
+
+          if old_slug != new_slug
+            not_self_conditions = {}
+            unless new?
+              self.model.key.each do |property|
+                not_self_conditions.merge!(property.name.not => self.send(property.name))
+              end
+              #puts "Not self: #{not_self_conditions.inspect}"
+            end
+
+            lambda do
+              #puts "Lambda new slug: #{new_slug}"
+              dupe = self.class.first(not_self_conditions.merge(:slug => new_slug))
+              if dupe
+                #puts "Got dupe: #{dupe.inspect}"
+                i = i + 1
+                slug_length = max_length - i.to_s.length - 1
+                new_slug = "#{base_slug[0, slug_length]}-#{i}"
+                #puts "New slug: #{new_slug}"
+                redo
+              end
+            end.call
+            #puts "Found new slug: #{new_slug}"
+            new_slug
+          else
+            old_slug
+          end
+        end
+      end # InstanceMethods
+    end # Slug
+  end # Is
+end # DataMapper

data/spec/integration/slug_spec.rb

@@ -0,0 +1,269 @@
+require 'pathname'
+require Pathname(__FILE__).dirname.expand_path.parent + 'spec_helper'
+
+if HAS_SQLITE3 || HAS_MYSQL || HAS_POSTGRES
+  describe 'DataMapper::Is::Slug' do
+
+    class User
+      include DataMapper::Resource
+
+      property :id, Serial
+      property :email, String
+      has n, :posts
+      has n, :todos
+
+      def slug_for_email
+        email.split("@").first
+      end
+
+      is :slug, :source => :slug_for_email, :length => 80, :permanent_slug => false
+    end
+
+    class Post
+      include DataMapper::Resource
+
+      property :id, Serial
+      property :title, String, :length => 30
+      property :content, Text
+
+      belongs_to :user
+
+      is :slug, :source => :title
+    end
+
+    class Todo
+      include DataMapper::Resource
+      property :id, Serial
+      property :title, String
+
+      belongs_to :user
+    end
+
+    class SlugKey
+      include DataMapper::Resource
+      property :title, String
+
+      is :slug, :source => :title, :key => true
+    end
+
+    before :all do
+      User.auto_migrate!(:default)
+      Post.auto_migrate!(:default)
+      Todo.auto_migrate!(:default)
+      SlugKey.auto_migrate!(:default)
+
+      @u1 = User.create(:email => "john@ekohe.com")
+      @p1 = Post.create(:user => @u1, :title => "My first shinny blog post")
+      @p2 = Post.create(:user => @u1, :title => "My second shinny blog post")
+      @p3 = Post.create(:user => @u1, :title => "My third shinny blog post")
+
+      @u2 = User.create(:email => "john@someotherplace.com")
+      @p4 = Post.create(:user => @u2, :title => "My first Shinny blog post")
+      @p5 = Post.create(:user => @u2, :title => "i heart merb and dm")
+      @p6 = Post.create(:user => @u2, :title => "A fancy café")
+      @p7 = Post.create(:user => @u2, :title => "你好")
+
+      (1..10).each do |i|
+        instance_variable_set "@p1_#{i}".to_sym, Post.create(:user => @u2, :title => "another productive day!!")
+      end
+      (1..10).each do |i|
+        instance_variable_set "@p2_#{i}".to_sym, Post.create(:user => @u2, :title => "DM tricks")
+      end
+
+      @sk = SlugKey.create(:title => 'slug key')
+
+      @post1 = Post.create :user => @u1, :title => 'a' * Post.slug_property.length
+      @post2 = Post.create :user => @u1, :title => 'a' * Post.slug_property.length
+    end
+    
+    it "should raise error if :source option is not specified" do
+      lambda {
+        class BadUsage
+          include DataMapper::Resource
+
+          property :id, Serial
+
+          is :slug, {}
+        end        
+      }.should raise_error(DataMapper::Is::Slug::InvalidSlugSourceError)
+    end
+    
+    it "should display obsolete warning if :size option is used" do
+      class Thingy
+      end
+      Thingy.stub!(:warn)
+      Thingy.should_receive(:warn).with("Slug with :size option is deprecated, use :length instead")
+
+      lambda {
+        class Thingy
+          include DataMapper::Resource
+          property :title, String
+
+          is :slug, :source => :title, :size => 20
+        end
+      }.should_not raise_error
+
+    end
+
+    it "should generate slugs" do
+      User.all.each do |u|
+        u.slug.should_not be_nil
+      end
+
+      Post.all.each do |p|
+        p.slug.should_not be_nil
+      end
+    end
+
+    it "should generate unique slugs" do
+      @u1.slug.should_not == @u2.slug
+      @p1.slug.should_not == @p4.slug
+    end
+
+    it "should generate correct slug for user" do
+      @u1.slug.should == "john"
+      @u2.slug.should == "john-2"
+    end
+
+    it "should generate correct slug for post" do
+      @p1.slug.should == "my-first-shinny-blog-post"
+      @p2.slug.should == "my-second-shinny-blog-post"
+      @p3.slug.should == "my-third-shinny-blog-post"
+      @p4.slug.should == "my-first-shinny-blog-post-2"
+      @p5.slug.should == "i-heart-merb-and-dm"
+
+      @p1_1.slug.should == "another-productive-day"
+      (2..10).each do |i|
+        instance_variable_get("@p1_#{i}".to_sym).slug.should == "another-productive-day-#{i}"
+      end
+
+      @p2_1.slug.should == 'dm-tricks'
+      (2..10).each do |i|
+        instance_variable_get("@p2_#{i}".to_sym).slug.should == "dm-tricks-#{i}"
+      end
+    end
+
+    it "should update slug if :permanent_slug => :false is specified" do
+      user = User.create(:email => "a_person@ekohe.com")
+      user.slug.should == "a_person"
+
+      user.should_not be_permanent_slug
+
+      user.email = "changed@ekohe.com"
+      user.should be_dirty
+
+      user.save.should be_true
+      user.slug.should == "changed"
+      user.destroy
+    end
+
+    it "should not update slug if :permanent_slug => :true or not specified" do
+      post = Post.create(:user => @u1, :title => "hello world!")
+      post.slug.should ==  "hello-world"
+      post.should be_permanent_slug
+      post.title = "hello universe!"
+      post.should be_dirty
+      post.save.should be_true
+      post.slug.should == "hello-world"
+      post.destroy
+    end
+
+    it "should have the right size for properties" do
+      user_slug_property = User.properties[:slug]
+      user_slug_property.should_not be_nil
+      user_slug_property.type.should == String
+      user_slug_property.length.should == 80
+
+      post_title_property = Post.properties[:title]
+      post_title_property.type.should == String
+      post_title_property.length.should == 30
+
+      post_slug_property = Post.properties[:slug]
+      post_slug_property.type.should == String
+      post_slug_property.should_not be_nil
+      post_slug_property.length.should == 30
+    end
+
+    it "should output slug with to_param method" do
+      @u1.to_param.should == ["john"]
+      @p1.to_param.should == ["my-first-shinny-blog-post"]
+    end
+
+    it "should find model using get method using id" do
+      u = User.get(@u1.id)
+      u.should_not be_nil
+      u.should == @u1
+    end
+
+    it "should find model using get method using id with non-slug models" do
+      todo = Todo.create(:user => @u1, :title => "blabla")
+      todo.should_not be_nil
+
+      Todo.get(todo.id).should == todo
+      @u1.todos.get(todo.id).should == todo
+    end
+
+    it 'should unidecode latin characters from the slug' do
+      @p6.slug.should == 'a-fancy-cafe'
+    end
+    
+    it 'should unidecode chinese characters from the slug' do
+      @p7.slug.should == 'ni-hao'
+    end
+    
+    it 'should have slug_property on instance' do
+      @p1.slug_property.should == @p1.class.properties.detect{|p| p.name == :slug}
+    end
+
+    it 'should properly increment slug suffix' do
+      @p2_10.slug.should == 'dm-tricks-10'
+    end
+
+    it 'should work with key on slug and validations' do
+      @sk.title.should == 'slug key'
+      @sk.slug.should == 'slug-key'
+    end
+
+    it 'should have slug no longer than slug_property.length' do
+      @post1.slug.length.should == @post1.slug_property.length
+    end
+
+    it 'should have suffixed slug no longer than slug_property.length' do
+      @post2.slug.length.should == @post2.class.slug_property.length
+    end
+
+    it 'should generate right slug for long sources' do
+      @post1.slug.should == 'a' * @post1.class.slug_property.length
+      @post2.slug.should == ('a' * (@post2.class.slug_property.length - 2) + '-2')
+    end
+
+    describe 'editing' do
+      class Post2
+        include DataMapper::Resource
+        property :id, Serial
+        property :title, String, :length => 30
+        property :content, Text
+
+        is :slug, :source => :title, :permanent_slug => false
+      end
+
+      Post2.auto_migrate!
+
+      before :each do
+        Post2.all.destroy!
+        @post = Post2.create :title => 'The Post', :content => 'The content.'
+      end
+
+      it 'should not change slug if source is not changed' do
+        @post.update :content => 'The other content.'
+        Post2.first.slug.should == 'the-post'
+      end
+
+      it 'should change slug if source is changed' do
+        @post.update :title => 'The Other Post'
+        post = Post2.first
+        post.slug.should == 'the-other-post'
+      end
+    end
+  end
+end

data/spec/rcov.opts

@@ -0,0 +1,6 @@
+--exclude "spec"
+--sort coverage
+--callsites
+--xrefs
+--profile
+--text-summary

data/spec/spec.opts

@@ -0,0 +1,4 @@
+--colour
+--loadby random
+--format profile
+--backtrace

data/spec/spec_helper.rb

@@ -0,0 +1,38 @@
+require 'rubygems'
+ 
+# use local dm-core if running from a typical dev checkout.
+lib = File.join('..', '..', 'dm-core', 'lib')
+$LOAD_PATH.unshift(lib) if File.directory?(lib)
+require 'dm-core'
+ 
+# use local dm-adjust if running from a typical dev checkout.
+lib = File.join('..', 'dm-adjust', 'lib')
+$LOAD_PATH.unshift(lib) if File.directory?(lib)
+require 'dm-adjust'
+ 
+# Support running specs with 'rake spec' and 'spec'
+$LOAD_PATH.unshift('lib') unless $LOAD_PATH.include?('lib')
+ 
+require 'dm-validations'
+require 'dm-is-slug'
+ 
+def load_driver(name, default_uri)
+  return false if ENV['ADAPTER'] != name.to_s
+ 
+  begin
+    DataMapper.setup(name, ENV["#{name.to_s.upcase}_SPEC_URI"] || default_uri)
+    DataMapper::Repository.adapters[:default] = DataMapper::Repository.adapters[name]
+    true
+  rescue LoadError => e
+    warn "Could not load do_#{name}: #{e}"
+    false
+  end
+end
+ 
+ENV['ADAPTER'] ||= 'sqlite3'
+ 
+HAS_SQLITE3 = load_driver(:sqlite3, 'sqlite3::memory:')
+HAS_MYSQL = load_driver(:mysql, 'mysql://localhost/dm_core_test')
+HAS_POSTGRES = load_driver(:postgres, 'postgres://postgres@localhost/dm_core_test')
+
+

data/tasks/ci.rake

@@ -0,0 +1 @@
+task :ci => [ :verify_measurements, 'metrics:all' ]

data/tasks/metrics.rake

@@ -0,0 +1,36 @@
+begin
+  require 'metric_fu'
+rescue LoadError
+  namespace :metrics do
+    task :all do
+      abort 'metric_fu is not available. In order to run metrics:all, you must: gem install metric_fu'
+    end
+  end
+end
+
+begin
+  require 'reek/adapters/rake_task'
+
+  Reek::RakeTask.new do |t|
+    t.fail_on_error = true
+    t.verbose       = false
+    t.source_files  = 'lib/**/*.rb'
+  end
+rescue LoadError
+  task :reek do
+    abort 'Reek is not available. In order to run reek, you must: gem install reek'
+  end
+end
+
+begin
+  require 'roodi'
+  require 'roodi_task'
+
+  RoodiTask.new do |t|
+    t.verbose = false
+  end
+rescue LoadError
+  task :roodi do
+    abort 'Roodi is not available. In order to run roodi, you must: gem install roodi'
+  end
+end

data/tasks/spec.rake

@@ -0,0 +1,41 @@
+spec_defaults = lambda do |spec|
+  spec.pattern    = 'spec/**/*_spec.rb'
+  spec.libs      << 'lib' << 'spec'
+  spec.spec_opts << '--options' << 'spec/spec.opts'
+end
+
+begin
+  require 'spec/rake/spectask'
+
+  Spec::Rake::SpecTask.new(:spec, &spec_defaults)
+rescue LoadError
+  task :spec do
+    abort 'rspec is not available. In order to run spec, you must: gem install rspec'
+  end
+end
+
+begin
+  require 'rcov'
+  require 'spec/rake/verify_rcov'
+
+  Spec::Rake::SpecTask.new(:rcov) do |rcov|
+    spec_defaults.call(rcov)
+    rcov.rcov      = true
+    rcov.rcov_opts = File.read('spec/rcov.opts').split(/\s+/)
+  end
+
+  RCov::VerifyTask.new(:verify_rcov => :rcov) do |rcov|
+    rcov.threshold = 100
+  end
+rescue LoadError
+  %w[ rcov verify_rcov ].each do |name|
+    task name do
+      abort "rcov is not available. In order to run #{name}, you must: gem install rcov"
+    end
+  end
+end
+
+task :spec => :check_dependencies
+task :rcov => :check_dependencies
+
+task :default => :spec

data/tasks/yard.rake

@@ -0,0 +1,9 @@
+begin
+  require 'yard'
+
+  YARD::Rake::YardocTask.new
+rescue LoadError
+  task :yard do
+    abort 'YARD is not available. In order to run yard, you must: gem install yard'
+  end
+end

data/tasks/yardstick.rake

@@ -0,0 +1,19 @@
+begin
+  require 'pathname'
+  require 'yardstick/rake/measurement'
+  require 'yardstick/rake/verify'
+
+  # yardstick_measure task
+  Yardstick::Rake::Measurement.new
+
+  # verify_measurements task
+  Yardstick::Rake::Verify.new do |verify|
+    verify.threshold = 100
+  end
+rescue LoadError
+  %w[ yardstick_measure verify_measurements ].each do |name|
+    task name.to_s do
+      abort "Yardstick is not available. In order to run #{name}, you must: gem install yardstick"
+    end
+  end
+end

metadata

@@ -0,0 +1,115 @@
+--- !ruby/object:Gem::Specification 
+name: dm-is-slug
+version: !ruby/object:Gem::Version 
+  version: 0.10.2
+platform: ruby
+authors: 
+- Aaron Qian
+- James Herdman
+- Nik Radford
+- Paul
+- Mike Frawley
+- Alex Makuta
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-02-07 00:00:00 +08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: dm-core
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.10.2
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: unidecode
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.0.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "1.3"
+    version: 
+description: DataMapper plugin that generates unique slugs
+email: 
+- aq1018@gmail.com
+- james.herdman@gmail.com
+- nik [a] terminaldischarge [d] net
+- maverick.stoklosa@gmail.com
+- frawl021@gmail.com
+- cheba@pointlessone.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.textile
+- TODO
+files: 
+- .gitignore
+- LICENSE
+- README.textile
+- Rakefile
+- TODO
+- VERSION
+- dm-is-slug.gemspec
+- lib/dm-is-slug.rb
+- lib/dm-is-slug/is/slug.rb
+- spec/integration/slug_spec.rb
+- spec/rcov.opts
+- spec/spec.opts
+- spec/spec_helper.rb
+- tasks/ci.rake
+- tasks/metrics.rake
+- tasks/spec.rake
+- tasks/yard.rake
+- tasks/yardstick.rake
+has_rdoc: true
+homepage: http://github.com/aq1018/dm-is-slug
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: DataMapper plugin that generates unique slugs
+test_files: 
+- spec/integration/slug_spec.rb
+- spec/spec_helper.rb