refinerycms 0.9.6.19 → 0.9.6.21

data/vendor/plugins/friendly_id/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2008-2010 Norman Clarke, Adrian Mugnolo and Emilio Tagua.
+
+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/vendor/plugins/friendly_id/README.md

@@ -0,0 +1,76 @@
+# FriendlyId
+
+FriendlyId is the "Swiss Army bulldozer" of slugging and permalink plugins for
+Ruby on Rails. It allows you to create pretty URL's and work with
+human-friendly strings as if they were numeric ids for ActiveRecord models.
+
+Using FriendlyId, it's easy to make your application use URL's like:
+
+    http://example.com/states/washington
+
+instead of:
+
+    http://example.com/states/4323454
+
+## FriendlyId Features
+
+FriendlyId offers many advanced features, including: slug history and
+versioning, scoped slugs, reserved words, custom slug generators, and
+excellent Unicode support. For complete information on using FriendlyId,
+please see the {http://norman.github.com/friendly_id/file.Guide.html FriendlyId Guide}.
+
+## Rails Quickstart
+
+    gem install friendly_id
+
+    rails my_app
+
+    cd my_app
+
+    # add to config/environment.rb
+    config.gem "friendly_id", :version => ">= 2.3.0"
+
+    ./script/generate friendly_id
+    ./script/generate scaffold user name:string cached_slug:string
+
+    rake db:migrate
+
+    # edit app/models/user.rb
+    class User < ActiveRecord::Base
+      has_friendly_id :name, :use_slug => true
+    end
+
+    User.create! :name => "Joe Schmoe"
+
+    ./script/server
+
+    GET http://0.0.0.0:3000/users/joe-schmoe
+
+## Docs, Info and Support
+
+* [FriendlyId Guide](http://norman.github.com/friendly_id/file.Guide.html)
+* [API Docs](http://norman.github.com/friendly_id)
+* [Google Group](http://groups.google.com/group/friendly_id)
+* [Source Code](http://github.com/norman/friendly_id/)
+* [Issue Tracker](http://github.com/norman/friendly_id/issues)
+
+## Bugs:
+
+Please report them on the [Github issue tracker](http://github.com/norman/friendly_id/issues)
+for this project.
+
+If you have a bug to report, please include the following information:
+
+* Stack trace and error message.
+* Version information for FriendlyId, Rails and Ruby.
+* Any snippets of relevant model, view or controller code that shows how your
+  are using FriendlyId.
+
+If you are able to, it helps even more if you can fork FriendlyId on Github,
+and add a test that reproduces the error you are experiencing.
+
+## Credits:
+
+FriendlyId was created by Norman Clarke, Adrian Mugnolo, and Emilio Tagua.
+
+Copyright (c) 2008-2010, released under the MIT license.

data/vendor/plugins/friendly_id/Rakefile

@@ -0,0 +1,68 @@
+require "rake"
+require "rake/testtask"
+require "rake/gempackagetask"
+require "rake/rdoctask"
+require "rake/clean"
+
+CLEAN << "pkg" << "doc" << "coverage" << ".yardoc"
+
+Rake::GemPackageTask.new(eval(File.read("friendly_id.gemspec"))) { |pkg| }
+Rake::RDocTask.new do |r|
+  r.rdoc_dir = "doc"
+  r.rdoc_files.include "lib/**/*.rb"
+end
+
+begin
+  require "yard"
+  YARD::Rake::YardocTask.new do |t|
+    t.options = ["--output-dir=doc"]
+    t.options << "--files" << ["Guide.md", "Contributors.md", "Changelog.md"].join(",")
+  end
+rescue LoadError
+end
+
+begin
+  require "rcov/rcovtask"
+  Rcov::RcovTask.new do |r|
+    r.test_files = FileList["test/**/*_test.rb"]
+    r.verbose = true
+    r.rcov_opts << "--exclude gems/*"
+  end
+rescue LoadError
+end
+
+
+task :test do
+  Rake::Task["test:friendly_id"].invoke
+  Rake::Task["test:ar"].invoke
+end
+
+namespace :test do
+  task :rails do
+    rm_rf "fid"
+    sh "rails --template extras/template-gem.rb fid"
+    sh "cd fid; rake test"
+  end
+  Rake::TestTask.new(:friendly_id) { |t| t.pattern = "test/*_test.rb" }
+  Rake::TestTask.new(:ar) { |t| t.pattern = "test/active_record2/*_test.rb" }
+  
+  namespace :rails do
+    task :plugin do
+      rm_rf "fid"
+      sh "rails --template extras/template-plugin.rb fid"
+      sh "cd fid; rake test"
+    end
+  end
+
+end
+
+task :pushdocs do
+  branch = `git branch | grep "*"`.chomp.gsub("* ", "")
+  sh "git stash"
+  sh "git checkout gh-pages"
+  sh "cp -rp doc/* ."
+  sh 'git commit -a -m "Regenerated docs"'
+  sh "git push origin gh-pages"
+  sh "git checkout #{branch}"
+  sh "git stash apply"
+end

data/vendor/plugins/friendly_id/extras/README.txt

@@ -0,0 +1,3 @@
+These templates are here to generate FriendlyId-enabled Rails apps for
+testing. They are for developers, they are not intended for generating
+"real" applications.

data/vendor/plugins/friendly_id/extras/bench.rb

@@ -0,0 +1,59 @@
+#!/usr/bin/env ruby -KU
+require File.dirname(__FILE__) + '/extras'
+require 'rbench'
+FACTOR = 100
+RBench.run(TIMES) do
+
+  column :times
+  column :ar
+
+  report 'find model using id', (TIMES * FACTOR).ceil do
+    ar { User.find(get_id) }
+  end
+
+  report 'find model using array of ids', (TIMES * FACTOR).ceil do
+    ar { User.find([get_id, get_id]) }
+  end
+
+  report 'find unslugged model using friendly id', (TIMES * FACTOR).ceil do
+    ar { User.find(USERS.rand) }
+  end
+
+  report 'find unslugged model using array of friendly ids', (TIMES * FACTOR).ceil do
+    ar { User.find([USERS.rand, USERS.rand]) }
+  end
+
+  report 'find slugged model using friendly id', (TIMES * FACTOR).ceil do
+    ar { Post.find(POSTS.rand) }
+  end
+
+  report 'find slugged model using array of friendly ids', (TIMES * FACTOR).ceil do
+    ar { Post.find([POSTS.rand, POSTS.rand]) }
+  end
+
+  report 'find cached slugged model using friendly id', (TIMES * FACTOR).ceil do
+    ar { District.find(DISTRICTS.rand) }
+  end
+
+  report 'find cached slugged model using array of friendly ids', (TIMES * FACTOR).ceil do
+    ar { District.find([DISTRICTS.rand, DISTRICTS.rand]) }
+  end
+
+  report 'find model using id, then to_param', (TIMES * FACTOR).ceil do
+    ar { User.find(get_id).to_param }
+  end
+
+  report 'find unslugged model using friendly id, then to_param', (TIMES * FACTOR).ceil do
+    ar { User.find(USERS.rand).to_param }
+  end
+
+  report 'find slugged model using friendly id, then to_param', (TIMES * FACTOR).ceil do
+    ar { Post.find(POSTS.rand).to_param }
+  end
+
+  report 'find cached slugged model using friendly id, then to_param', (TIMES * FACTOR).ceil do
+    ar { District.find(DISTRICTS.rand).to_param }
+   end
+
+  summary 'Total'
+end

data/vendor/plugins/friendly_id/extras/extras.rb

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby -KU
+require File.dirname(__FILE__) + '/../test/test_helper'
+require File.dirname(__FILE__) + '/../test/active_record2/test_helper'
+require 'ffaker'
+
+TIMES = (ENV['N'] || 100).to_i
+POSTS     = []
+DISTRICTS = []
+USERS     = []
+
+User.delete_all
+Post.delete_all
+District.delete_all
+(Slug or Slug).delete_all
+
+100.times do
+  name = Faker::Name.name
+  USERS     << (User.create!     :name => name).friendly_id
+  POSTS     << (Post.create!     :name => name).friendly_id
+  DISTRICTS << (District.create! :name => name).friendly_id
+end
+
+def get_id
+  rand(99) + 1
+end
+
+class Array
+  def rand
+    self[Kernel.rand(length)]
+  end
+end

data/vendor/plugins/friendly_id/extras/prof.rb

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby -KU
+require File.dirname(__FILE__) + '/extras'
+require 'ruby-prof'
+
+# RubyProf.measure_mode = RubyProf::MEMORY
+GC.disable
+RubyProf.start
+100.times do
+  Post.find(slug = POSTS.rand)
+end
+result = RubyProf.stop
+GC.enable
+printer = RubyProf::CallTreePrinter.new(result)
+printer.print(File.new("prof.txt", "w"))

data/vendor/plugins/friendly_id/extras/template-gem.rb

@@ -0,0 +1,26 @@
+run "rm public/index.html"
+gem "friendly_id"
+gem "haml"
+gem "will_paginate"
+run "haml --rails ."
+generate "friendly_id"
+generate :haml_scaffold, "post title:string"
+route "map.root :controller => 'posts', :action => 'index'"
+rake "db:migrate"
+rake "db:fixtures:load"
+file 'app/models/post.rb',
+%q{class Post < ActiveRecord::Base
+  has_friendly_id :title, :use_slug => true
+end}
+file 'test/fixtures/slugs.yml',
+%q{
+one:
+  name: mystring
+  sequence: 1
+  sluggable: one (Post)
+
+two:
+  name: mystring
+  sequence: 1
+  sluggable: two (Post)
+}

data/vendor/plugins/friendly_id/extras/template-plugin.rb

@@ -0,0 +1,28 @@
+run "rm public/index.html"
+inside 'vendor/plugins' do
+  run "git clone ../../../ friendly_id"
+end
+gem "haml"
+gem "will_paginate"
+run "haml --rails ."
+generate "friendly_id"
+generate :haml_scaffold, "post title:string"
+route "map.root :controller => 'posts', :action => 'index'"
+rake "db:migrate"
+rake "db:fixtures:load"
+file 'app/models/post.rb',
+%q{class Post < ActiveRecord::Base
+  has_friendly_id :title, :use_slug => true
+end}
+file 'test/fixtures/slugs.yml',
+%q{
+one:
+  name: mystring
+  sequence: 1
+  sluggable: one (Post)
+
+two:
+  name: mystring
+  sequence: 2
+  sluggable: two (Post)
+}

data/vendor/plugins/friendly_id/friendly_id.gemspec

@@ -0,0 +1,40 @@
+require "lib/friendly_id/version"
+
+spec = Gem::Specification.new do |s|
+  s.name              = "friendly_id"
+  s.rubyforge_project = "friendly-id"
+  s.version           = FriendlyId::Version::STRING
+  s.authors           = ["Norman Clarke", "Adrian Mugnolo", "Emilio Tagua"]
+  s.email             = ["norman@njclarke.com", "adrian@mugnolo.com", "miloops@gmail.com"]
+  s.homepage          = "http://norman.github.com/friendly_id"
+  s.summary           = "A comprehensive slugging and pretty-URL plugin."
+  s.description       = <<-EOM
+    FriendlyId is the "Swiss Army bulldozer" of slugging and permalink plugins
+    for Ruby on Rails. It allows you to create pretty URL’s and work with
+    human-friendly strings as if they were numeric ids for ActiveRecord models.
+  EOM
+
+  s.has_rdoc         = true
+  s.test_files       = Dir.glob "test/**/*_test.rb"
+  s.files            = Dir["lib/**/*.rb", "lib/**/*.rake", "*.md", "LICENSE",
+    "Rakefile", "rails/init.rb", "generators/**/*.*", "test/**/*.*",
+    "extras/**/*.*" ]
+
+  s.add_dependency "activerecord", ">= 2.2"
+  s.add_dependency "activesupport", ">= 2.2"
+
+  s.post_install_message = <<-EOM
+
+    ***********************************************************
+
+      If you are upgrading friendly_id, please run
+
+          ./script/generate friendly_id --skip-migration
+
+      in your Rails application to ensure that you have the
+      latest friendly_id Rake tasks.
+
+    ***********************************************************
+
+  EOM
+end

data/vendor/plugins/friendly_id/generators/friendly_id/friendly_id_generator.rb

@@ -0,0 +1,28 @@
+class FriendlyIdGenerator < Rails::Generator::Base
+
+  def manifest
+    record do |m|
+      unless options[:skip_migration]
+        m.migration_template('create_slugs.rb', 'db/migrate', :migration_file_name => 'create_slugs')
+      end
+      unless options[:skip_tasks]
+        m.directory "lib/tasks"
+        m.file "/../../../lib/friendly_id/active_record2/tasks/friendly_id.rake", "lib/tasks/friendly_id.rake"
+      end
+    end
+  end
+
+  protected
+
+  def add_options!(opt)
+    opt.separator ''
+    opt.separator 'Options:'
+    opt.on("--skip-migration", "Don't generate a migration for the slugs table") do |value|
+      options[:skip_migration] = value
+    end
+    opt.on("--skip-tasks", "Don't add friendly_id Rake tasks to lib/tasks") do |value|
+      options[:skip_tasks] = value
+    end
+  end
+
+end

data/vendor/plugins/friendly_id/generators/friendly_id/templates/create_slugs.rb

@@ -0,0 +1,18 @@
+class CreateSlugs < ActiveRecord::Migration
+  def self.up
+    create_table :slugs do |t|
+      t.string :name
+      t.integer :sluggable_id
+      t.integer :sequence, :null => false, :default => 1
+      t.string :sluggable_type, :limit => 40
+      t.string :scope
+      t.datetime :created_at
+    end
+    add_index :slugs, :sluggable_id
+    add_index :slugs, [:name, :sluggable_type, :sequence, :scope], :name => "index_slugs_on_n_s_s_and_s", :unique => true
+  end
+
+  def self.down
+    drop_table :slugs
+  end
+end

data/vendor/plugins/friendly_id/lib/friendly_id.rb

@@ -0,0 +1,67 @@
+require File.join(File.dirname(__FILE__), "friendly_id", "slug_string")
+require File.join(File.dirname(__FILE__), "friendly_id", "configuration")
+require File.join(File.dirname(__FILE__), "friendly_id", "status")
+require File.join(File.dirname(__FILE__), "friendly_id", "finders")
+require File.join(File.dirname(__FILE__), "friendly_id", "slugged")
+
+# FriendlyId is a comprehensive Ruby library for slugging and permalinks with
+# ActiveRecord.
+# @author Norman Clarke
+# @author Emilio Tagua
+# @author Adrian Mugnolo
+module FriendlyId
+
+  # An error based on this class is raised when slug generation fails
+  class SlugGenerationError < StandardError ; end
+
+  # Raised when the slug text is blank.
+  class BlankError < SlugGenerationError ; end
+
+  # Raised when the slug text is reserved.
+  class ReservedError < SlugGenerationError ; end
+
+  module Base
+    # Set up a model to use a friendly_id. This method accepts a hash with
+    # {FriendlyId::Configuration several possible options}.
+    #
+    # @param [#to_sym] method The column or method that should be used as the
+    #   basis of the friendly_id string.
+    #
+    # @param [Hash] options For valid configuration options, see
+    #   {FriendlyId::Configuration}.
+    #
+    # @param [block] block An optional block through which to filter the
+    #   friendly_id text; see {FriendlyId::Configuration#normalizer}. Note that
+    #   passing a block parameter is now deprecated and will be removed
+    #   from FriendlyId 3.0.
+    #
+    # @example
+    #
+    #   class User < ActiveRecord::Base
+    #     has_friendly_id :user_name
+    #   end
+    #
+    #   class Post < ActiveRecord::Base
+    #     has_friendly_id :title, :use_slug => true, :approximate_ascii => true
+    #   end
+    #
+    # @see FriendlyId::Configuration
+    def has_friendly_id(method, options = {}, &block)
+      raise NotImplementedError
+    end
+
+    # Does the model class use the FriendlyId plugin?
+    def uses_friendly_id?
+      respond_to? :friendly_id_config
+    end
+  end
+
+end
+
+class String
+  def parse_friendly_id(separator = nil)
+    separator ||= FriendlyId::Configuration::DEFAULTS[:sequence_separator]
+    name, sequence = split(/#{Regexp.escape(separator)}(\d+)*\z/)
+    return name, sequence ||= "1"
+  end
+end