radiant-vapor-extension 2.1.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,7 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg
+.svn
+*.gemspec

data/HELP_admin.md

@@ -0,0 +1,37 @@
+With Vapor you can create URLs that will point users to other locations.
+
+## How It Works
+
+Vapor manages the redirection in objects called flow meters. In each flow meter you'll need to have 
+the `catch_url` (which is the URL that will be the false page) and the `redirect_url` (which is an 
+actual page on your site). By default the `status` is set to '307 Temporarily Moved'.
+
+You may also set the redirect_url to an external site beginning with 'http://'.
+
+## What to Catch
+
+You have some options with Vapor. 
+
+By default, each flow meter that you create will only match against
+the exact url. This means that a `catch_url` of `/articles` will not redirect for a url of 
+`/articles/2008/09/19/third-post/`.
+
+To change this, you may set `Radiant::Config['vapor.use_regexp'] = 'true'`. This will catch any url
+that _begins_ with the given `catch_url`. The `catch_url` in this case is a regular expression, and
+the `redirect_url` may contain substitution variables like $0 (the matched string), $1 (the first
+match group), and so on.
+
+You may also nest your flow meters with this setting. Setting `/about` to redirect to `/us` and `/about/team` to 
+redirect to `/team` will work. When the `vapor.use_regexp` option is set, the flow meters will be
+compared to the requests in reverse alphabetical order so that longer `catch_url`s will be processed
+first.
+
+## Where and When
+
+Vapor is a simple solution to allow your users to manage and edit URL redirection themselves. Long-term 
+redirects might be better served by addressing them outside of the application by handling the redirect 
+with your web or application server.
+
+In order to prevent database access with each request to the site, Vapor loads all URL directives into
+memory when the extension is initialized, when a new flow meter is created, and when a flow meter is
+destroyed.

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Jim Gay
+
+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.rdoc

@@ -0,0 +1,11 @@
+= Vapor
+
+The Vapor extension provides an interface to redirect URLs. 
+
+Installing Vapor is as easy as any other Radiant extension. Drop it into your vendor/extensions directory and:
+
+rake radiant:extensions:vapor:migrate
+
+See the HELP_admin.md for more details.
+
+built by Saturn Flyer http://www.saturnflyer.com

data/Rakefile

@@ -0,0 +1,135 @@
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "radiant-vapor-extension"
+    gem.summary = %Q{Provides an interface to redirect URLs in RadiantCMS}
+    gem.description = %Q{Provides an interface to redirect URLs in RadiantCMS}
+    gem.email = "jim@saturnflyer.com"
+    gem.homepage = "http://github.com/saturnflyer/radiant-vapor-extension"
+    gem.authors = ["Jim Gay"]
+    gem.add_development_dependency "radiant"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+# task :test => :check_dependencies
+
+# Determine where the RSpec plugin is by loading the boot
+unless defined? RADIANT_ROOT
+  ENV["RAILS_ENV"] = "test"
+  case
+  when ENV["RADIANT_ENV_FILE"]
+    require File.dirname(ENV["RADIANT_ENV_FILE"]) + "/boot"
+  when File.dirname(__FILE__) =~ %r{vendor/radiant/vendor/extensions}
+    require "#{File.expand_path(File.dirname(__FILE__) + "/../../../../../")}/config/boot"
+  else
+    boot_path = "#{File.expand_path(File.dirname(__FILE__) + "/../../../")}/config/boot"
+    require boot_path if File.exist?(boot_path)
+  end
+end
+
+require 'rake'
+require 'rake/rdoctask'
+require 'rake/testtask'
+
+if defined? RADIANT_ROOT
+  rspec_base = File.expand_path(RADIANT_ROOT + '/vendor/plugins/rspec/lib')
+  $LOAD_PATH.unshift(rspec_base) if File.exist?(rspec_base)
+end
+
+require 'spec/rake/spectask'
+
+# Cleanup the RADIANT_ROOT constant so specs will load the environment
+Object.send(:remove_const, :RADIANT_ROOT) if defined? RADIANT_ROOT
+
+extension_root = File.expand_path(File.dirname(__FILE__))
+
+task :default => :spec
+task :stats => "spec:statsetup"
+
+desc "Run all specs in spec directory"
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.spec_opts = ['--options', "\"#{extension_root}/spec/spec.opts\""]
+  t.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+namespace :spec do
+  desc "Run all specs in spec directory with RCov"
+  Spec::Rake::SpecTask.new(:rcov) do |t|
+    t.spec_opts = ['--options', "\"#{extension_root}/spec/spec.opts\""]
+    t.spec_files = FileList['spec/**/*_spec.rb']
+    t.rcov = true
+    t.rcov_opts = ['--exclude', 'spec', '--rails']
+  end
+  
+  desc "Print Specdoc for all specs"
+  Spec::Rake::SpecTask.new(:doc) do |t|
+    t.spec_opts = ["--format", "specdoc", "--dry-run"]
+    t.spec_files = FileList['spec/**/*_spec.rb']
+  end
+
+  [:models, :controllers, :views, :helpers].each do |sub|
+    desc "Run the specs under spec/#{sub}"
+    Spec::Rake::SpecTask.new(sub) do |t|
+      t.spec_opts = ['--options', "\"#{extension_root}/spec/spec.opts\""]
+      t.spec_files = FileList["spec/#{sub}/**/*_spec.rb"]
+    end
+  end
+
+  # Setup specs for stats
+  task :statsetup do
+    require 'code_statistics'
+    ::STATS_DIRECTORIES << %w(Model\ specs spec/models)
+    ::STATS_DIRECTORIES << %w(View\ specs spec/views)
+    ::STATS_DIRECTORIES << %w(Controller\ specs spec/controllers)
+    ::STATS_DIRECTORIES << %w(Helper\ specs spec/views)
+    ::CodeStatistics::TEST_TYPES << "Model specs"
+    ::CodeStatistics::TEST_TYPES << "View specs"
+    ::CodeStatistics::TEST_TYPES << "Controller specs"
+    ::CodeStatistics::TEST_TYPES << "Helper specs"
+    ::STATS_DIRECTORIES.delete_if {|a| a[0] =~ /test/}
+  end
+
+  namespace :db do
+    namespace :fixtures do
+      desc "Load fixtures (from spec/fixtures) into the current environment's database.  Load specific fixtures using FIXTURES=x,y"
+      task :load => :environment do
+        require 'active_record/fixtures'
+        ActiveRecord::Base.establish_connection(RAILS_ENV.to_sym)
+        (ENV['FIXTURES'] ? ENV['FIXTURES'].split(/,/) : Dir.glob(File.join(RAILS_ROOT, 'spec', 'fixtures', '*.{yml,csv}'))).each do |fixture_file|
+          Fixtures.create_fixtures('spec/fixtures', File.basename(fixture_file, '.*'))
+        end
+      end
+    end
+  end
+end
+
+desc 'Generate documentation for the vapor extension.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  if File.exist?('VERSION')
+    version = File.read('VERSION')
+  else
+    version = ""
+  end
+  
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = "Vapor Extension #{version}"
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+# For extensions that are in transition
+desc 'Test the vapor extension.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+# Load any custom rakefiles for extension
+Dir[File.dirname(__FILE__) + '/tasks/*.rake'].sort.each { |f| require f }

data/VERSION

@@ -0,0 +1 @@
+2.1.0

data/app/controllers/admin/flow_meters_controller.rb

@@ -0,0 +1,28 @@
+class Admin::FlowMetersController < ApplicationController
+  only_allow_access_to :index, :create, :destroy,
+    :when => :admin,
+    :denied_url => { :controller => 'pages', :action => 'index' },
+    :denied_message => 'You must be an administrator to manage Redirects.'
+  
+  def index
+    @flow_meter = FlowMeter.new
+    @flow_meters = FlowMeter.find(:all)
+  end
+  
+  def create
+    @flow_meter = FlowMeter.create!(params[:flow_meter])
+    redirect_to admin_flow_meters_url
+  rescue ActiveRecord::RecordInvalid => e
+    flash[:error] = "#{e.message}"
+    redirect_to admin_flow_meters_url
+  rescue FlowMeter::DataMismatch => e
+    flash[:error] = "#{e.message}"
+    redirect_to admin_flow_meters_url
+  end
+  
+  def destroy
+    @flow_meter = FlowMeter.find(params[:id])
+    @flow_meter.destroy
+    redirect_to admin_flow_meters_url
+  end
+end

data/app/helpers/flow_meters_helper.rb

@@ -0,0 +1,2 @@
+module FlowMetersHelper
+end

data/app/metal/vapor_flow.rb

@@ -0,0 +1,59 @@
+require 'cgi'
+
+class VaporFlow
+  include Vaporizer
+  
+  # Radiant must be restarted if the configuration changes for this setting
+  @@use_regexp = nil
+  class << self  
+    def call(env)
+      if env["PATH_INFO"].blank?
+        return send_to_radiant
+      end
+      url = env["PATH_INFO"].sub(/^\//,'') #clean off the first slash, like it is stored in the db
+      db_escaped_key = ActiveRecord::Base.connection.adapter_name =~ /mysql/i ? '`key`' : 'key'
+      sql = "SELECT * FROM config where #{db_escaped_key} = 'vapor.use_regexp'"
+      if @@use_regexp.nil?
+        config_key = Radiant::Config.connection.select_one(sql)
+        @@use_regexp = (config_key && config_key['value'] == 'true') ? true : false
+      end
+      if @@use_regexp
+        catch_with_regexp(url)
+      else
+        catch_without_regexp(url)
+      end
+    end
+   
+    def catch_with_regexp(url)
+      result = self.send_to_radiant
+      FlowMeter.all.sort.reverse.each do |meter|
+        key = meter[0]
+        value = meter[1]
+        if (match = url.match(Regexp.new('^'+key)))
+          status = value[1].to_i
+          redirect_url = self.match_substitute(value[0], match)
+          result = [status, {"Location" => CGI.unescape(local_or_external_path(redirect_url))}, [status.to_s]]
+          return result
+          break
+        end
+      end
+      return result
+    end
+    
+    def catch_without_regexp(url)
+      url = url.sub(/\/$/, '') unless url == '/' # drop the trailing slash for lookup
+      a_match = FlowMeter.all[url]
+      unless a_match.nil?
+        status = a_match[1].to_i
+        redirect_url = a_match[0]
+        [status, {"Location" => CGI.unescape(local_or_external_path(redirect_url))}, [status.to_s]]
+      else
+        self.send_to_radiant
+      end
+    end 
+    
+    def send_to_radiant
+      [404, {'Content-Type' => 'text/html'}, ['Off to Radiant we go!']]
+    end
+  end
+end

data/app/models/flow_meter.rb

@@ -0,0 +1,137 @@
+class FlowMeter < ActiveRecord::Base
+  class DataMismatch < StandardError; end
+  
+  include Vaporizer
+  
+  before_save :set_default_status
+  after_validation :clean_catch_url
+  after_validation :clean_redirect_url
+  after_save :initialize_all
+  after_destroy :initialize_all
+  
+  validates_presence_of :catch_url, :on => :create, :message => "can't be blank"
+  validates_presence_of :redirect_url, :on => :create, :message => "can't be blank"
+  
+  validates_uniqueness_of :catch_url
+    
+  validate :catch_url_not_restricted
+  validate :redirect_url_not_restricted
+  
+  @@all = {}
+  
+  def self.all
+    @@all
+  end
+  
+  def all
+    @@all
+  end
+  
+  def all=(all_hash)
+    @@all = all_hash
+  end
+  
+  def initialize_all
+    FlowMeter.initialize_all
+  end
+  
+  def self.initialize_all
+    @@all = {}
+    FlowMeter.find(:all).each do |fm|
+      @@all[fm[:catch_url]] = [fm[:redirect_url], fm[:status]]
+    end
+  end
+  
+  def display_url(att)
+    path = self[att]
+    if path == '/'
+      '/'
+    elsif path.match('^https?://')
+      path
+    else
+      radiant_path(self.cleaned_up_path(path))
+    end
+  end
+  
+  [:catch_url, :redirect_url].each do |att|
+    define_method "#{att.to_s}_for_display" do
+      display_url(att)
+    end
+  end
+  
+  def catch_url_not_restricted
+    if catch_url =~ %r{\A\/?(admin)}
+      errors.add(:catch_url, 'cannot catch the admin url')
+    end
+  end
+  
+  def redirect_url_not_restricted
+    if catch_url == redirect_url
+      raise DataMismatch, "Catch URL and Redirect URL may not be the same."
+    end
+  end
+  
+  def self.find_for_page(page)
+    if Radiant::Config['vapor.use_regexp'] == 'true'
+      match = catch_url_match_with_regexp(page.url)
+    else
+      match = catch_url_match(page.url)
+    end
+    match = self.find_by_catch_url(match) if match
+  end
+  
+  def self.redirect_url_for_page(page)
+    if Radiant::Config['vapor.use_regexp'] == true
+      FlowMeter.match_for_page_with_regexp(page).to_s
+    else
+      FlowMeter.match_for_page(page).to_s
+    end
+  end
+  
+  protected
+  
+  def self.match_for_page(page)    
+    url = page.url.sub(/\/$/, '') unless url == '/' # drop the trailing slash for lookup
+    url = url.sub(/^\//, '') unless url == '/'
+    a_match = FlowMeter.all[url]
+    unless a_match.nil?
+      redirect_url = a_match[0]
+      redirect_url = '/' + redirect_url unless redirect_url.match('^https?://') || redirect_url == '/'
+      return redirect_url
+    end
+    nil
+  end
+  
+  def self.match_for_page_with_regexp(page)
+    redirect_url = nil
+    FlowMeter.all.sort.reverse.each do |meter|
+      key = meter[0]
+      value = meter[1]
+      if (match = url.match(Regexp.new('^'+key)))
+        redirect_url = match_substitute(value[0], match)
+        return redirect_url
+        break
+      end
+    end
+    redirect_url
+  end
+  
+  def set_default_status
+    self.status = '307 Temporarily Moved' if self.status.blank?
+  end
+  
+  def clean_catch_url
+    clean_url(:catch_url) unless catch_url.blank?
+  end
+  
+  def clean_redirect_url
+    clean_url(:redirect_url) unless redirect_url.blank? or redirect_url.match('^http://')
+  end
+  
+  def clean_url(att)
+    if !self[att].blank? and !self[att].nil?
+      path = self[att]
+      self.update_attribute(att, self.cleaned_up_path(path))
+    end
+  end
+end

data/app/views/admin/flow_meters/index.html.haml

@@ -0,0 +1,25 @@
+.outset
+  - form_for @flow_meter, :url => admin_flow_meters_path do |f|
+    %table.index
+      %thead
+        %tr
+          %th Catch URL
+          %th Redirect URL
+          %th Status
+          %th Action
+      %tbody
+      - @flow_meters.each do |flow_meter|
+        %tr
+          %td= flow_meter.catch_url_for_display
+          %td= flow_meter.redirect_url_for_display
+          %td= flow_meter.status
+          %td= link_to "Delete", admin_flow_meter_path(flow_meter), :method => :delete
+      %tr
+        %td= f.text_field :catch_url
+        %td= f.text_field :redirect_url
+        %td= f.select :status, ['307 Temporary Redirect','302 Found','301 Moved Permanently'].reverse
+        %td= submit_tag "Create"
+%p With redirects you can create URLs that will point to content elsewhere on your site. Your 'Catch URL' is the part of the URL that will be processed to redirect to the final destination of your 'Redirect URL'.
+- if config['vapor.use_regexp'] == 'true'
+  %p If the incoming request begins with any of your defined 'Catch URLs', the visitor will be redirected to the corresponding  'Redirect URL'. This means that you may protect an entire tree of your site simply by specifying the beginning of the URL.
+%p You may use a full url for the 'Redirect URL' to direct your visitors to another site.

data/app/views/admin/help/_slug_redirect.html.haml

@@ -0,0 +1,4 @@
+- admin_help do
+  %h4 Slugs and Redirects
+  %p= "You've got the Vapor extension installed which allows you to create false pages or false slugs. The #{link_to 'Redirects', admin_flow_meters_path} tab provides you with an area where you can create a slug, or url that will redirect your site visitors to another location."
+  %p So if you want your 'About Us' page to be found at yoursite.com/about and also at yoursite.com/about-us then you can create your page with 'about-us' as the slug, and create a redirect from '/about' to '/about-us'.

data/app/views/admin/pages/_node.html.haml

@@ -0,0 +1,30 @@
+%tr.node{:id => "page-#{page.id}", :class =>"level-#{level}#{children_class}#{virtual_class}"}
+  - render_region :node, :locals => {:page => page, :level => level, :simple => simple} do |node|
+    - node.title_column do
+      %td.page{:style => "padding-left: #{padding_left(level)}px"}
+        %span.w1
+          - if simple
+            = icon
+            = node_title
+          - else
+            = expander + link_to("#{icon} #{node_title}", edit_admin_page_url(page), :title => page.url)
+            = page_type
+            = spinner
+          - flow_meter = page.flow_meter
+          - if flow_meter
+            %small.info
+              Redirects to
+              = link_to flow_meter.redirect_url_for_display, flow_meter.redirect_url_for_display
+    - node.status_column do
+      - unless simple
+        %td.status{:class => "#{page.status.name.downcase}-status"}= page.status.name
+    - node.add_child_column do
+      - unless simple
+        %td.add-child= link_to image('add-child', :alt => 'add child'), new_admin_page_child_url(page)
+    - node.remove_column do
+      - unless simple
+        %td.remove= link_to image('remove', :alt => 'remove page'), remove_admin_page_url(page)
+
+- if expanded
+  - page.children.each do |child|
+    = render_node child, :level => level + 1, :simple => simple

data/app/views/admin/pages/_vapor_details.html.haml

@@ -0,0 +1,9 @@
+- if !@page.new_record? && (flow_meter = @page.flow_meter)
+  %p
+    Visitors to this page will redirected to
+    = link_to flow_meter.redirect_url_for_display, flow_meter.local_or_external_redirect_url
+    - if admin?
+      - unless config['vapor.use_regexp']
+        = link_to "Remove this", admin_flow_meter_path(flow_meter), :method => :delete
+      - else
+        = link_to "Manage your traffic flow...", admin_flow_meters_path

data/db/migrate/001_create_flow_meters.rb

@@ -0,0 +1,15 @@
+class CreateFlowMeters < ActiveRecord::Migration
+  def self.up
+    create_table :flow_meters do |t|
+      t.string :catch_url
+      t.string :redirect_url
+      t.string :status, :default => '307'
+
+      t.timestamps
+    end
+  end
+
+  def self.down
+    drop_table :flow_meters
+  end
+end

data/lib/page_vapor.rb

@@ -0,0 +1,12 @@
+module PageVapor
+  def self.included(base)
+    base.class_eval do
+      include InstanceMethods
+    end
+  end
+  module InstanceMethods
+    def flow_meter
+      FlowMeter.find_for_page(self)
+    end
+  end
+end

data/lib/tasks/vapor_extension_tasks.rake

@@ -0,0 +1,28 @@
+namespace :radiant do
+  namespace :extensions do
+    namespace :vapor do
+      
+      desc "Runs the migration of the Vapor extension"
+      task :migrate => :environment do
+        require 'radiant/extension_migrator'
+        if ENV["VERSION"]
+          VaporExtension.migrator.migrate(ENV["VERSION"].to_i)
+        else
+          VaporExtension.migrator.migrate
+        end
+      end
+      
+      desc "Copies public assets of the Vapor to the instance public/ directory."
+      task :update => :environment do
+        is_svn_or_dir = proc {|path| path =~ /\.svn/ || File.directory?(path) }
+        Dir[VaporExtension.root + "/public/**/*"].reject(&is_svn_or_dir).each do |file|
+          path = file.sub(VaporExtension.root, '')
+          directory = File.dirname(path)
+          puts "Copying #{path}..."
+          mkdir_p RAILS_ROOT + directory
+          cp file, RAILS_ROOT + path
+        end
+      end  
+    end
+  end
+end

data/lib/vaporizer.rb

@@ -0,0 +1,71 @@
+module Vaporizer
+  def self.included(klass)
+    klass.instance_eval do
+      extend  ClassMethods
+      include InstanceMethods
+    end
+  end
+
+  module ClassMethods
+    def catch_url_match_with_regexp(url)
+      result = nil
+      FlowMeter.all.sort.reverse.each do |meter|
+        prepared_url = cleaned_up_path(meter[0])
+        prepared_url = radiant_path(prepared_url)
+        if (match = url.match(Regexp.new('^'+prepared_url)))
+          return meter[0]
+          break
+        end
+      end
+      return result
+    end
+    
+    def catch_url_match(url)
+      url = cleaned_up_path(url)
+      a_match = FlowMeter.all[url]
+      a_match ? url : nil
+    end
+    
+    def cleaned_up_path(path)
+      new_path = path.gsub(%r{//+},'/').gsub(%r{\s+},'')
+      new_path.gsub!(%r{\/$},'') unless new_path == '/'
+      new_path.gsub!(%r{^/},'') unless new_path == '/'
+      new_path
+    end
+    
+    def radiant_path(path)
+      return path if path == '/'
+      '/' + path
+    end
+    
+    def local_or_external_path(path)
+      path.match(/https?:\/\//) ? path : self.radiant_path(path)
+    end
+
+    def match_substitute(string, match)
+      string.gsub(/\$([`&0-9'$])/) do |sub|
+        case $1
+        when "`": match.pre_match
+        when "&": match[0]
+        when "0".."9": puts $1.to_i; match[$1.to_i]
+        when "'": match.post_match
+        when "$": '$'
+        end
+      end
+    end
+  end
+
+  module InstanceMethods
+    def local_or_external_redirect_url
+      self.class.local_or_external_path(redirect_url)
+    end
+    
+    def cleaned_up_path(path)
+      self.class.cleaned_up_path(path)
+    end
+    
+    def radiant_path(path)
+      self.class.radiant_path(path)
+    end
+  end
+end

data/spec/controllers/admin/flow_meters_controller_spec.rb

@@ -0,0 +1,80 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+describe Admin::FlowMetersController do
+  dataset :users
+  
+  before(:each) do
+    login_as :admin
+  end
+  
+  describe "/admin/flow_meters with GET" do
+    before(:each) do
+      @flow_meter = mock_model(FlowMeter)
+      @new_flow_meter = mock_model(FlowMeter)
+      @flow_meters = [@flow_meter]
+      FlowMeter.stub!(:find).with(:all).and_return(@flow_meters)
+      FlowMeter.stub!(:new).and_return(@new_flow_meter)
+      get :index
+    end
+    
+    it "should render the admin/index template" do
+      response.should render_template('index')
+    end
+    
+    it "should get all flow_meters" do
+      assigns[:flow_meters].should == [@flow_meter]
+    end
+    
+    it "should get a new flow_meter" do
+      assigns[:flow_meter].should == @new_flow_meter
+    end
+  end
+  describe "/admin/flow_meters with valid POST" do
+    before(:each) do
+      @flow_meter = FlowMeter.create!(:catch_url => 'this', :redirect_url => 'that', :status => '302 Found')
+      @flow_meter_count = FlowMeter.count
+      post :create, :flow_meter => {:catch_url => 'other', :redirect_url => 'that'}
+    end
+    
+    it "should increase the flow_meter_count by 1" do
+      FlowMeter.count.should > @flow_meter_count
+    end
+    
+    it "should redirect to the index" do
+      response.should redirect_to('/admin/flow_meters')
+    end
+  end
+  describe "/admin/flow_meters with invalid POST" do
+    before(:each) do
+      post :create, :flow_meter => {:catch_url => 'admin', :redirect_url => 'that'}
+    end
+    
+    it "should assign the error message to the flash" do
+      flash[:error].should_not be_blank
+    end
+    
+    it "should redirect to the index" do
+      response.should redirect_to('/admin/flow_meters')
+    end
+  end
+  describe "/admin/flow_meters/:id with DELETE" do
+    before(:each) do
+      @flow_meter = FlowMeter.create!(:catch_url => 'this', :redirect_url => 'that', :status => '302 Found')
+    end
+    
+    it "should find the flow_meter" do
+      FlowMeter.stub!(:find).with(:all).and_return([@flow_meter])
+      FlowMeter.should_receive(:find).with(@flow_meter.id.to_s).and_return(@flow_meter)
+      delete :destroy, :id => @flow_meter.id
+    end
+    it "should reduce the flow_meter count by 1" do
+      @flow_meter_count = FlowMeter.count
+      delete :destroy, :id => @flow_meter.id
+      FlowMeter.count.should < @flow_meter_count
+    end
+    it "should redirect to the index" do
+      delete :destroy, :id => @flow_meter.id
+      response.should redirect_to('/admin/flow_meters')
+    end
+  end
+end

data/spec/metal/vapor_flow_spec.rb

@@ -0,0 +1,28 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe VaporFlow do
+  describe "radiant_path" do
+    it "should return the given path prepended with a /" do
+      VaporFlow.radiant_path('slashy').should == '/slashy'
+    end
+  end
+  describe "local_or_external_path" do
+    it "should return the given path if it begins with 'http'" do
+      VaporFlow.local_or_external_path('http://saturnflyer.com').should == 'http://saturnflyer.com'
+    end
+    it "should return the given path if it begins with 'https'" do
+      VaporFlow.local_or_external_path('https://saturnflyer.com').should == 'https://saturnflyer.com'
+    end
+    it "should return the radiant_path if the given path does not begin with http" do
+      VaporFlow.local_or_external_path('about/the/site').should == VaporFlow.radiant_path('about/the/site')
+    end
+  end
+  describe "send_to_radiant" do
+    it "should return an array" do
+      VaporFlow.send_to_radiant.kind_of?(Array).should be_true
+    end
+    it "should have 404 as the first item in the array" do
+      VaporFlow.send_to_radiant.first.should == 404
+    end
+  end
+end

data/spec/models/flow_meter_spec.rb

@@ -0,0 +1,146 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe FlowMeter do
+  dataset :pages
+  before(:each) do
+    # FlowMeter.all = {}
+    @flow_meter = FlowMeter.new(:catch_url => "/stuff", :redirect_url => '/things', :status => '')
+  end
+
+  it "should err without a catch_url" do
+    @flow_meter.catch_url = nil
+    @flow_meter.valid?
+    @flow_meter.errors.on(:catch_url).should match(/can't be blank/)
+  end
+
+  it "should err without a redirect_url" do
+    @flow_meter.redirect_url = nil
+    @flow_meter.valid?
+    @flow_meter.errors.on(:redirect_url).should match(/can't be blank/)
+  end
+  
+  it "should set '307 Temporarily Moved' as the status if created with no status" do
+    @flow_meter.save!
+    @flow_meter.status.should == '307 Temporarily Moved'
+  end
+  
+  it "should err with a catch_url beginning with 'admin'" do
+    @flow_meter.catch_url = "admin"
+    @flow_meter.valid?
+    @flow_meter.errors.on(:catch_url).should match(/cannot catch the admin url/)
+  end
+  
+  it "should err with a catch_url beginning with '/admin'" do
+    @flow_meter.catch_url = "/admin"
+    @flow_meter.valid?
+    @flow_meter.errors.on(:catch_url).should match(/cannot catch the admin url/)
+  end
+  
+  it "should err with a non-unique catch_url" do
+    @flow_meter.save
+    @flow_meter2 = FlowMeter.new(:catch_url => @flow_meter.catch_url, :redirect_url => '/other')
+    @flow_meter2.valid?
+    @flow_meter2.errors.on(:catch_url).should match(/has already been taken/)
+  end
+  
+  it "should remove the first character from catch_url beginning with a slash" do
+    @flow_meter.save
+    @flow_meter.catch_url.should == 'stuff'
+  end
+  
+  it "should remove the first character from redirect_url beginning with a slash" do
+    @flow_meter.save
+    @flow_meter.redirect_url.should == 'things'
+  end
+  
+  it "should remove consecutive slashes from the catch_url before saving" do
+    @flow_meter.catch_url = "///slasher"
+    @flow_meter.save
+    @flow_meter.catch_url.should == 'slasher'
+  end
+  
+  it "should remove consecutive slashes from the redirect_url before saving" do
+    @flow_meter.redirect_url = "///chop"
+    @flow_meter.save
+    @flow_meter.redirect_url.should == 'chop'
+  end
+  
+  it "should remove a trailing slash from the catch_url before saving" do
+    @flow_meter.catch_url = '/no_trailing_slash/'
+    @flow_meter.save
+    @flow_meter.catch_url.should == 'no_trailing_slash'
+  end
+  
+  it "should remove all whitespace from catch_url before saving" do
+    @flow_meter.catch_url = "hello there"
+    @flow_meter.save
+    @flow_meter.catch_url.should == 'hellothere'
+  end
+  
+  it "should remove all whitespace from redirect_url before saving" do
+    @flow_meter.redirect_url = "how are you"
+    @flow_meter.save
+    @flow_meter.redirect_url.should == 'howareyou'
+  end
+  
+  it "should allow '/' as the redirect_url" do
+    @flow_meter.redirect_url = "/"
+    @flow_meter.save
+    @flow_meter.redirect_url.should == '/'
+  end
+  
+  it "should allow a redirect_url formatted like 'http://www.saturnflyer.com/'" do
+    @flow_meter.redirect_url = 'http://www.saturnflyer.com/'
+    @flow_meter.save!
+    @flow_meter.redirect_url.should == 'http://www.saturnflyer.com/'
+  end
+
+  it "should provide a catch_url_for_display which includes a leading slash" do
+    @flow_meter.catch_url_for_display.should == '/stuff'
+  end
+  
+  it "should provide a redirect_url_for_display which includes a leading slash" do
+    @flow_meter.redirect_url_for_display.should == '/things'
+  end
+  
+  it "should provide the actual redirect_url_for_display if it begins with 'http://'" do
+    @flow_meter.redirect_url = "http://www.saturnflyer.com"
+    @flow_meter.redirect_url_for_display.should == "http://www.saturnflyer.com"
+  end
+
+  it "should err with 'Catch URL and Redirect URL may not be the same.' when given a catch_url that matches the redirect_url" do
+    @flow_meter.redirect_url = "/stuff"
+    lambda {@flow_meter.save!}.should raise_error(FlowMeter::DataMismatch, "Catch URL and Redirect URL may not be the same.")
+  end
+
+  it "should load save all flow_meters into FlowMeter.all, a Hash with the catch_url as the key, and an array of redirect_url and status as the value" do
+    FlowMeter.destroy_all
+    @flow_meter.save
+    FlowMeter.all.should == {'stuff' => ['things', '307 Temporarily Moved']}
+  end
+  
+  it "should reload FlowMeter.all after destroying a flow_meter" do
+    @flow_meter.save
+    @flow_meter2 = FlowMeter.new(:catch_url => 'old', :redirect_url => 'new')
+    @flow_meter2.save
+    @flow_meter.destroy
+    FlowMeter.all.should == {'old' => ['new', '307']}
+  end
+
+  describe "self.find_for_page" do
+    it "should return nil if no flow_meter matches for the page" do
+      FlowMeter.find_for_page(pages(:home)).should be_nil
+    end
+    it "should return the first flow_meter found that matches the page url" do
+      @redirector = FlowMeter.create!({:catch_url => '/first', :redirect_url => '/another', :status => '307'})
+      FlowMeter.find_for_page(pages(:first)).should == @redirector
+    end
+    describe "while vapor.use_regexp" do
+      it "should return the first flow_meter found that matches the page url" do
+        Radiant::Config['vapor.use_regexp'] = 'true'
+        @redirector = FlowMeter.create!({:catch_url => '/fi\w', :redirect_url => '/another', :status => '307'})
+        FlowMeter.find_for_page(pages(:first)).should == @redirector
+      end
+    end
+  end
+end

data/spec/models/page_spec.rb

@@ -0,0 +1,18 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Page do
+  dataset :users_and_pages
+  
+  before(:each) do
+    @redirector = FlowMeter.create!({:catch_url => '/first', :redirect_url => '/another', :status => '307'})
+  end
+  
+  describe 'flow_meter' do
+    it "should return nil if none is found" do
+      pages(:home).flow_meter.should be_nil
+    end
+    it "should return the first flow_meter found which matches the page url" do
+      pages(:first).flow_meter.should == @redirector
+    end
+  end
+end

data/spec/spec.opts

@@ -0,0 +1,6 @@
+--colour
+--format
+progress
+--loadby
+mtime
+--reverse

data/spec/spec_helper.rb

@@ -0,0 +1,37 @@
+unless defined? RADIANT_ROOT
+  ENV["RAILS_ENV"] = "test"
+  case
+  when ENV["RADIANT_ENV_FILE"]
+    require ENV["RADIANT_ENV_FILE"]
+  when File.dirname(__FILE__) =~ %r{vendor/radiant/vendor/extensions}
+    require "#{File.expand_path(File.dirname(__FILE__) + "/../../../../../../")}/config/environment"
+  else
+    require "#{File.expand_path(File.dirname(__FILE__) + "/../../../../")}/config/environment"
+  end
+end
+require "#{RADIANT_ROOT}/spec/spec_helper"
+
+if File.directory?(File.dirname(__FILE__) + "/scenarios")
+  Scenario.load_paths.unshift File.dirname(__FILE__) + "/scenarios"
+end
+if File.directory?(File.dirname(__FILE__) + "/matchers")
+  Dir[File.dirname(__FILE__) + "/matchers/*.rb"].each {|file| require file }
+end
+
+Spec::Runner.configure do |config|
+  # config.use_transactional_fixtures = true
+  # config.use_instantiated_fixtures  = false
+  # config.fixture_path = RAILS_ROOT + '/spec/fixtures'
+
+  # You can declare fixtures for each behaviour like this:
+  #   describe "...." do
+  #     fixtures :table_a, :table_b
+  #
+  # Alternatively, if you prefer to declare them only once, you can
+  # do so here, like so ...
+  #
+  #   config.global_fixtures = :table_a, :table_b
+  #
+  # If you declare global fixtures, be aware that they will be declared
+  # for all of your examples, even those that don't use them.
+end

data/test/radiant-vapor_test.rb

@@ -0,0 +1,7 @@
+require 'test_helper'
+
+class RadiantVaporTest < Test::Unit::TestCase
+  should "probably rename this file and start testing for real" do
+    flunk "hey buddy, you should probably rename this file and start testing for real"
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'radiant-vapor'
+
+class Test::Unit::TestCase
+end

data/vapor_extension.rb

@@ -0,0 +1,37 @@
+require_dependency 'application_controller'
+
+class VaporExtension < Radiant::Extension
+  version "#{File.read(File.expand_path(File.dirname(__FILE__)) + '/VERSION')}"
+  description "Manage redirects without creating useless pages"
+  url "http://saturnflyer.com/"
+  
+  define_routes do |map|
+    map.namespace :admin do |admin|
+      admin.resources 'flow_meters', :only => [:index, :create, :destroy]
+    end
+  end
+  
+  def activate
+    unless respond_to?(:tab)
+      admin.tabs.add "Redirects", "/admin/flow_meters", :after => "Layouts", :visibility => [:admin]
+    else
+      tab 'Content' do
+        add_item 'Redirects', '/admin/flow_meters'
+      end
+    end
+    FlowMeter.initialize_all if ActiveRecord::Base.connection.tables.include?('flow_meters')
+    
+    Page.class_eval { include PageVapor }
+    
+    admin.pages.edit.add :form, 'vapor_details', :before => 'edit_title'
+    
+    if admin.respond_to? :help
+      admin.help.index.add :page_details, 'slug_redirect', :after => 'slug'
+    end
+  end
+  
+  def deactivate
+    
+  end
+  
+end

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification 
+name: radiant-vapor-extension
+version: !ruby/object:Gem::Version 
+  version: 2.1.0
+platform: ruby
+authors: 
+- Jim Gay
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-02-04 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: radiant
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: Provides an interface to redirect URLs in RadiantCMS
+email: jim@saturnflyer.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- HELP_admin.md
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- app/controllers/admin/flow_meters_controller.rb
+- app/helpers/flow_meters_helper.rb
+- app/metal/vapor_flow.rb
+- app/models/flow_meter.rb
+- app/views/admin/flow_meters/index.html.haml
+- app/views/admin/help/_slug_redirect.html.haml
+- app/views/admin/pages/_node.html.haml
+- app/views/admin/pages/_vapor_details.html.haml
+- db/migrate/001_create_flow_meters.rb
+- lib/page_vapor.rb
+- lib/radiant-vapor-extension.rb
+- lib/tasks/vapor_extension_tasks.rake
+- lib/vaporizer.rb
+- spec/controllers/admin/flow_meters_controller_spec.rb
+- spec/metal/vapor_flow_spec.rb
+- spec/models/flow_meter_spec.rb
+- spec/models/page_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- test/radiant-vapor_test.rb
+- test/test_helper.rb
+- vapor_extension.rb
+has_rdoc: true
+homepage: http://github.com/saturnflyer/radiant-vapor-extension
+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: Provides an interface to redirect URLs in RadiantCMS
+test_files: 
+- spec/controllers/admin/flow_meters_controller_spec.rb
+- spec/metal/vapor_flow_spec.rb
+- spec/models/flow_meter_spec.rb
+- spec/models/page_spec.rb
+- spec/spec_helper.rb
+- test/radiant-vapor_test.rb
+- test/test_helper.rb