mir_extensions 0.2.0

data/public/javascripts/rails.js

@@ -0,0 +1,175 @@
+(function() {
+  // Technique from Juriy Zaytsev
+  // http://thinkweb2.com/projects/prototype/detecting-event-support-without-browser-sniffing/
+  function isEventSupported(eventName) {
+    var el = document.createElement('div');
+    eventName = 'on' + eventName;
+    var isSupported = (eventName in el);
+    if (!isSupported) {
+      el.setAttribute(eventName, 'return;');
+      isSupported = typeof el[eventName] == 'function';
+    }
+    el = null;
+    return isSupported;
+  }
+
+  function isForm(element) {
+    return Object.isElement(element) && element.nodeName.toUpperCase() == 'FORM'
+  }
+
+  function isInput(element) {
+    if (Object.isElement(element)) {
+      var name = element.nodeName.toUpperCase()
+      return name == 'INPUT' || name == 'SELECT' || name == 'TEXTAREA'
+    }
+    else return false
+  }
+
+  var submitBubbles = isEventSupported('submit'),
+      changeBubbles = isEventSupported('change')
+
+  if (!submitBubbles || !changeBubbles) {
+    // augment the Event.Handler class to observe custom events when needed
+    Event.Handler.prototype.initialize = Event.Handler.prototype.initialize.wrap(
+      function(init, element, eventName, selector, callback) {
+        init(element, eventName, selector, callback)
+        // is the handler being attached to an element that doesn't support this event?
+        if ( (!submitBubbles && this.eventName == 'submit' && !isForm(this.element)) ||
+             (!changeBubbles && this.eventName == 'change' && !isInput(this.element)) ) {
+          // "submit" => "emulated:submit"
+          this.eventName = 'emulated:' + this.eventName
+        }
+      }
+    )
+  }
+
+  if (!submitBubbles) {
+    // discover forms on the page by observing focus events which always bubble
+    document.on('focusin', 'form', function(focusEvent, form) {
+      // special handler for the real "submit" event (one-time operation)
+      if (!form.retrieve('emulated:submit')) {
+        form.on('submit', function(submitEvent) {
+          var emulated = form.fire('emulated:submit', submitEvent, true)
+          // if custom event received preventDefault, cancel the real one too
+          if (emulated.returnValue === false) submitEvent.preventDefault()
+        })
+        form.store('emulated:submit', true)
+      }
+    })
+  }
+
+  if (!changeBubbles) {
+    // discover form inputs on the page
+    document.on('focusin', 'input, select, texarea', function(focusEvent, input) {
+      // special handler for real "change" events
+      if (!input.retrieve('emulated:change')) {
+        input.on('change', function(changeEvent) {
+          input.fire('emulated:change', changeEvent, true)
+        })
+        input.store('emulated:change', true)
+      }
+    })
+  }
+
+  function handleRemote(element) {
+    var method, url, params;
+
+    var event = element.fire("ajax:before");
+    if (event.stopped) return false;
+
+    if (element.tagName.toLowerCase() === 'form') {
+      method = element.readAttribute('method') || 'post';
+      url    = element.readAttribute('action');
+      params = element.serialize();
+    } else {
+      method = element.readAttribute('data-method') || 'get';
+      url    = element.readAttribute('href');
+      params = {};
+    }
+
+    new Ajax.Request(url, {
+      method: method,
+      parameters: params,
+      evalScripts: true,
+
+      onComplete:    function(request) { element.fire("ajax:complete", request); },
+      onSuccess:     function(request) { element.fire("ajax:success",  request); },
+      onFailure:     function(request) { element.fire("ajax:failure",  request); }
+    });
+
+    element.fire("ajax:after");
+  }
+
+  function handleMethod(element) {
+    var method = element.readAttribute('data-method'),
+        url = element.readAttribute('href'),
+        csrf_param = $$('meta[name=csrf-param]')[0],
+        csrf_token = $$('meta[name=csrf-token]')[0];
+
+    var form = new Element('form', { method: "POST", action: url, style: "display: none;" });
+    element.parentNode.insert(form);
+
+    if (method !== 'post') {
+      var field = new Element('input', { type: 'hidden', name: '_method', value: method });
+      form.insert(field);
+    }
+
+    if (csrf_param) {
+      var param = csrf_param.readAttribute('content'),
+          token = csrf_token.readAttribute('content'),
+          field = new Element('input', { type: 'hidden', name: param, value: token });
+      form.insert(field);
+    }
+
+    form.submit();
+  }
+
+
+  document.on("click", "*[data-confirm]", function(event, element) {
+    var message = element.readAttribute('data-confirm');
+    if (!confirm(message)) event.stop();
+  });
+
+  document.on("click", "a[data-remote]", function(event, element) {
+    if (event.stopped) return;
+    handleRemote(element);
+    event.stop();
+  });
+
+  document.on("click", "a[data-method]", function(event, element) {
+    if (event.stopped) return;
+    handleMethod(element);
+    event.stop();
+  });
+
+  document.on("submit", function(event) {
+    var element = event.findElement(),
+        message = element.readAttribute('data-confirm');
+    if (message && !confirm(message)) {
+      event.stop();
+      return false;
+    }
+
+    var inputs = element.select("input[type=submit][data-disable-with]");
+    inputs.each(function(input) {
+      input.disabled = true;
+      input.writeAttribute('data-original-value', input.value);
+      input.value = input.readAttribute('data-disable-with');
+    });
+
+    var element = event.findElement("form[data-remote]");
+    if (element) {
+      handleRemote(element);
+      event.stop();
+    }
+  });
+
+  document.on("ajax:after", "form", function(event, element) {
+    var inputs = element.select("input[type=submit][disabled=true][data-disable-with]");
+    inputs.each(function(input) {
+      input.value = input.readAttribute('data-original-value');
+      input.removeAttribute('data-original-value');
+      input.disabled = false;
+    });
+  });
+})();

data/public/robots.txt

@@ -0,0 +1,5 @@
+# See http://www.robotstxt.org/wc/norobots.html for documentation on how to use the robots.txt file
+#
+# To ban all spiders from the entire site uncomment the next two lines:
+# User-Agent: *
+# Disallow: /

data/script/rails

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# This command will automatically be run when you run "rails" with Rails 3 gems installed from the root of your application.
+
+APP_PATH = File.expand_path('../../config/application',  __FILE__)
+require File.expand_path('../../config/boot',  __FILE__)
+require 'rails/commands'

data/spec/controllers/application_controller_spec.rb

@@ -0,0 +1,41 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe ApplicationController do
+
+  it 'detects its IP address' do
+    ApplicationController.local_ip.should =~ /^192\.168\.[0-9]+\.[0-9]+$|^10\.[0-9]+\.[0-9]+\.[0-9]+$|^127.0.0.1$/
+  end
+
+  before :all do
+    @controller = ApplicationController.new
+  end
+  
+  it 'sanitizes the sort-by param' do
+    @controller.stubs(:params).returns(:by => 'SELECT * FROM accounts')
+    @controller.sanitize_by_param.should == 'id'
+
+    @controller.stubs(:params).returns(:by => 'name')
+    @controller.sanitize_by_param(['name']).should == 'name'
+  end
+
+  it 'sanitizes the sort-direction param' do
+    @controller.stubs(:params).returns(:dir => 'DELETE FROM accounts')
+    @controller.sanitize_dir_param.should == 'ASC'
+
+    @controller.stubs(:params).returns(:dir => 'ASC')
+    @controller.sanitize_dir_param.should == 'ASC'
+
+    @controller.stubs(:params).returns(:dir => 'DESC')
+    @controller.sanitize_dir_param.should == 'DESC'
+  end
+
+  it 'sanitizes params' do
+    @controller.sanitize_params( 2, [1, 2, 3], 1).should == 2
+    @controller.sanitize_params( 0, [1, 2, 3], 1).should == 1
+    @controller.sanitize_params( nil, [1, 2, 3], 1).should == 1
+    @controller.sanitize_params( 0, nil, 1).should == 1
+    lambda{ @controller.sanitize_params( 0, [1, 2, 3], nil) }.should raise_error(ArgumentError)
+    @controller.sanitize_params( nil, nil, 1).should == 1
+  end
+
+end

data/spec/helpers/application_helper_spec.rb

@@ -0,0 +1,40 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe ApplicationHelper do
+  
+  it 'detects its action' do
+    _controller = Object.new
+    _controller.stubs(:action_name).returns('index')
+    controller.stubs(:controller).returns(_controller)
+    controller.action?('index').should be_true
+    controller.action?('destroy').should be_false
+    controller.action?(/index|show/).should be_true
+  end
+
+  it 'formats arrays as HTML lines' do
+    controller.array_to_lines([:a, :b, :c]).should == 'a<br />b<br />c'
+  end
+
+  it 'returns a check-mark div' do
+    controller.checkmark.should == '<div class="checkmark"></div>'
+  end
+
+  it 'detects its action' do
+    _controller = Object.new
+    _controller.stubs(:controller_name).returns('home')
+    controller.stubs(:controller).returns(_controller)
+    controller.controller?('home').should be_true
+    controller.controller?('primary').should be_false
+    controller.controller?(/home|primary/).should be_true
+ end
+
+  it 'returns an options string with the default select prompt' do
+    controller.options_for_array([['1', 'Option 1'], ['2', 'Option 2'], ['3', 'Option 3']]).should == "#{controller.select_prompt_option}<option value=\"1\" >Option 1</option><option value=\"2\" >Option 2</option><option value=\"3\" >Option 3</option>"
+  end
+
+  it 'returns an options string with the default select prompt and a default value' do
+    controller.options_for_array([['1', 'Option 1'], ['2', 'Option 2'], ['3', 'Option 3']], '2').should == "#{controller.select_prompt_option}<option value=\"1\" >Option 1</option><option value=\"2\" selected=\"1\">Option 2</option><option value=\"3\" >Option 3</option>"
+  end
+
+    
+end

data/spec/mir_extensions_spec.rb

@@ -0,0 +1,269 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "MirExtensions" do
+
+  describe 'class methods' do
+  
+    describe 'state codes' do
+    
+      it 'returns the state code for a given state' do
+        MirExtensions.state_code_for('Virginia').should == 'VA'
+      end
+      
+      it 'returns the state for a given state code' do
+        MirExtensions.state_name_for('VA').should == 'Virginia'
+      end
+      
+      it 'handles failures gracefully' do
+        MirExtensions.state_name_for('XX').should be_nil
+      end
+      
+    end
+    
+    it 'returns the month name for a month number' do
+      MirExtensions.month_name_for(0).should == 'JAN'
+    end
+    
+    it 'returns a canonical URL' do
+      MirExtensions.canonical_url('cnn.com').should == 'cnn.com/'
+    end
+  
+    it 'normalizes slugs' do
+      MirExtensions.normalize_slug('!@#$%^&*()').should == ''
+      MirExtensions.normalize_slug('abcdefghijklmnopqrstuvwxyz').should == 'abcdefghijklmnopqrstuvwxyz'
+      MirExtensions.normalize_slug('ABCDEFGHIJKLMNOPQRSTUVWXYZ').should == 'abcdefghijklmnopqrstuvwxyz'
+      MirExtensions.normalize_slug('0123456789').should == '0123456789'
+      MirExtensions.normalize_slug('mir-utility').should == 'mir-utility'
+      MirExtensions.normalize_slug('mir--utility').should == 'mir-utility'
+      MirExtensions.normalize_slug('mir-utility').should == 'mir-utility'
+      MirExtensions.normalize_slug('mir-utility/index//').should == 'mir-utility-index'
+    end
+
+  end
+  
+  describe 'string extensions' do
+
+    it 'formats phone numbers' do
+      '3125555252'.to_phone.should == '312-555-5252'
+    end
+  
+    it 'formats phone numbers, accepting options' do
+      '3125555252'.to_phone(:area_code => true).should == '(312) 555-5252'
+    end
+  
+  end
+ 
+  it 'formats phone numbers' do
+    ''.number_to_phone('5168675309').should == '516-867-5309'
+  end
+
+  it 'formats phone numbers with separate area codes' do
+    '5168675309'.formatted_phone.should == '(516) 867-5309'
+  end
+
+  it 'handles invalid phone numbers gracefully' do
+    'Alphabet Soup'.formatted_phone.should == 'Alphabet Soup'
+    'Transylvania 6-5000'.formatted_phone.should == 'Transylvania 6-5000'
+    '123-45-6789'.formatted_phone.should == '123-45-6789'
+  end
+
+  it 'formats zip codes' do
+    '205000003'.formatted_zip.should == '20500-0003'
+  end
+
+  it 'calculates arithmetic means' do
+    _a = [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ]
+    _a.mean.should == (_a.sum.to_f/_a.size.to_f).to_f
+  end
+
+  it 'aliases count to size' do
+    _a = [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ]
+    _a.count.should == _a.size
+  end
+
+  it 'converts seconds to hours:minutes:seconds' do
+    86400.to_hrs_mins_secs.should == '24:00:00'
+  end
+
+  it 'rounds to the nearest tenth' do
+    Math::PI.to_nearest_tenth.should == 3.1
+  end
+
+  it 'converts active records to an array of name-value pairs suitable for select tags' do
+    Primary.stubs(:all).returns([Primary.new(:name => 'Admin'), Primary.new(:name => 'User')])
+    Primary.to_option_values.should == [ ['Admin', nil], ['User', nil] ]
+  end
+
+  it 'strips the values of specified attributes' do
+    p = Primary.new(:name => ' foo bar  ')
+    p.strip(:name)
+    p.name.should == 'foo bar'
+  end
+
+  it 'converts arrays to a histogram hash' do
+    [:r, :r, :o, :y, :g, :b, :i, :v, :v, :o].to_histogram.should == {:o=>2, :g=>1, :v=>2, :r=>2, :i=>1, :y=>1, :b=>1}
+  end
+
+  it 'converts a hash to HTTP parameters' do
+    _return = {
+      :string => 1,
+      :array => [2, 3],
+      :hash => {
+        :a => 4,
+        :b => {
+          :c => 5
+        }
+      }
+    }.to_params
+
+    _return.include?('string=1').should be_true
+    _return.include?('array[0]=2&array[1]=3').should be_true
+    _return.include?('hash[a]=4').should be_true
+    _return.include?('hash[b][c]=5').should be_true
+  end
+
+  it 'converts a hash to SQL conditions' do
+    _hash = {
+      :first_name => 'Quentin',
+      :last_name => 'Tarantino'
+    }
+    _hash.to_sql.should =~ /first_name = 'Quentin'/
+    _hash.to_sql.should =~ /last_name = 'Tarantino'/
+    _hash.to_sql.should =~ / AND /
+  end
+
+  it 'initializes SOAP headers' do
+    _control = {
+      :tag => '',
+      :value => ''
+    }
+    _header = Header.new( _control[:tag], _control[:value] )
+    _header.on_simple_outbound.should == _control[:value]
+  end
+
+  it 'capitalizes words without omitting characters like titleize' do
+    'vice-president of the united states of america'.capitalize_words.should == 'Vice-President Of The United States Of America'
+  end
+
+  it 'expands address abbreviations' do
+    _control = {
+      '1600 Pennsylvania Av' => '1600 Pennsylvania Avenue',
+      '1600 Pennsylvania Av.' => '1600 Pennsylvania Avenue',
+      '1600 Pennsylvania Ave' => '1600 Pennsylvania Avenue',
+      '1600 Pennsylvania Ave.' => '1600 Pennsylvania Avenue',
+      '77 Sunset Bl' => '77 Sunset Boulevard',
+      '77 Sunset Bl.' => '77 Sunset Boulevard',
+      '77 Sunset Bld' => '77 Sunset Boulevard',
+      '77 Sunset Bld.' => '77 Sunset Boulevard',
+      '77 Sunset Blv' => '77 Sunset Boulevard',
+      '77 Sunset Blv.' => '77 Sunset Boulevard',
+      '77 Sunset Blvd' => '77 Sunset Boulevard',
+      '77 Sunset Blvd.' => '77 Sunset Boulevard',
+      '10 Columbus Cr' => '10 Columbus Circle',
+      '10 Columbus Cr.' => '10 Columbus Circle',
+      '10 Lincoln Ctr Plz' => '10 Lincoln Center Plaza',
+      '10 Lincoln Ctr. Plz.' => '10 Lincoln Center Plaza',
+      '157 King Arthur Ct' => '157 King Arthur Court',
+      '157 King Arthur Ct.' => '157 King Arthur Court',
+      '157 King Arthur Crt' => '157 King Arthur Court',
+      '157 King Arthur Crt.' => '157 King Arthur Court',
+      '680 N Lake Shore Dr' => '680 North Lake Shore Drive',
+      '680 N. Lake Shore Dr.' => '680 North Lake Shore Drive',
+      '8900 Van Wyck Expy' => '8900 Van Wyck Expressway',
+      '8900 Van Wyck Expy.' => '8900 Van Wyck Expressway',
+      '8900 Van Wyck Expw' => '8900 Van Wyck Expressway',
+      '8900 Van Wyck Expw.' => '8900 Van Wyck Expressway',
+      '8900 Van Wyck Expressw' => '8900 Van Wyck Expressway',
+      '8900 Van Wyck Expressw.' => '8900 Van Wyck Expressway',
+      '837 E Magical Frwy' => '837 East Magical Freeway',
+      '837 E. Magical Frwy.' => '837 East Magical Freeway',
+      '750 W Sunrise Hwy' => '750 West Sunrise Highway',
+      '750 W. Sunrise Hwy.' => '750 West Sunrise Highway',
+      '9264 Penny Ln' => '9264 Penny Lane',
+      '9264 Penny Ln.' => '9264 Penny Lane',
+      '10099 Ridge Gate Pky Ste 200' => '10099 Ridge Gate Parkway Suite 200',
+      '10099 Ridge Gate Pky. Ste. 200' => '10099 Ridge Gate Parkway Suite 200',
+      '10099 Ridge Gate Pkw Suite 200' => '10099 Ridge Gate Parkway Suite 200',
+      '10099 Ridge Gate Pkw. Suite 200' => '10099 Ridge Gate Parkway Suite 200',
+      '10099 Ridge Gate Pkwy Suite 200' => '10099 Ridge Gate Parkway Suite 200',
+      '10099 Ridge Gate Pkwy. Suite 200' => '10099 Ridge Gate Parkway Suite 200',
+      '10099 Ridge Gate Prkwy Suite 200' => '10099 Ridge Gate Parkway Suite 200',
+      '10099 Ridge Gate Prkwy. Suite 200' => '10099 Ridge Gate Parkway Suite 200',
+      "5137 Zebulon's Pk" => "5137 Zebulon's Pike",
+      "5137 Zebulon's Pk." => "5137 Zebulon's Pike",
+      "King's Plz" => "King's Plaza",
+      "King's Plz." => "King's Plaza",
+      '4616 Melrose Pl' => '4616 Melrose Place',
+      '4616 Melrose Pl.' => '4616 Melrose Place',
+      '93812 S Hightower Rd' => '93812 South Hightower Road',
+      '93812 S. Hightower Rd.' => '93812 South Hightower Road',
+      '249 NE Rural Rt' => '249 Northeast Rural Route',
+      '249 N.E. Rural Rt.' => '249 Northeast Rural Route',
+      '249 NE Rural Rte' => '249 Northeast Rural Route',
+      '249 N.E. Rural Rte.' => '249 Northeast Rural Route',
+      '1 SW Main St' => '1 Southwest Main Street',
+      '1 S.W. Main St.' => '1 Southwest Main Street',
+      '1935 SE Trpk' => '1935 Southeast Turnpike',
+      '1935 S.E. Trpk.' => '1935 Southeast Turnpike',
+      '369 NW Army Tr' => '369 Northwest Army Trail',
+      '369 N.W. Army Tr.' => '369 Northwest Army Trail'
+    }
+    _control.keys.each do |_key|
+      _key.expand_address_abbreviations.should == _control[_key]
+    end
+  end
+
+  it 'converts 24-hour time' do
+    '18:20'.to_12_hour_time == '6:20 PM'
+  end
+
+  it 'adds the HTTP-protocol prefix' do
+    'www.seologic.com'.add_http_prefix.should == 'http://www.seologic.com'
+    'ftp.seologic.com'.add_http_prefix.should == 'http://ftp.seologic.com'
+    'ftp://ftp.seologic.com'.add_http_prefix.should == 'ftp://ftp.seologic.com'
+    'http://'.add_http_prefix.should == 'http://'
+  end
+
+  it 'detects HTTP URLs' do
+    'http://www.seologic.com/'.valid_http_url?.should be_true
+    'https://www.seologic.com/'.valid_http_url?.should be_true
+    'www.seologic.com'.valid_http_url?.should be_false
+  end
+
+  it 'detects trailing slashes' do
+    'www.seologic.com'.has_http?.should be_false
+    'www.seologic.com/'.has_trailing_slash?.should be_true
+    'www.seologic.com/index'.has_trailing_slash?.should be_false
+    'www.seologic.com/users/'.has_trailing_slash?.should be_true
+  end
+
+  it 'detects page URLs' do
+    'www.seologic.com'.is_page?.should be_false
+    'www.seologic.com/index'.is_page?.should be_false
+    'www.seologic.com/index.cgi'.is_page?.should be_false
+    'www.seologic.com/index.htm'.is_page?.should be_true
+    'www.seologic.com/index.html'.is_page?.should be_true
+  end
+
+  it 'returns the host of a valid URI string' do
+    'www.seologic.com'.to_host.should be_nil
+    'www.seologic.com/webmaster-tools/link-popularity-check.php'.to_host.should be_nil
+    'http://www.seologic.com'.to_host.should == 'www.seologic.com'
+    'http://www.seologic.com/webmaster-tools/link-popularity-check.php'.to_host.should == 'www.seologic.com'
+  end
+
+  it 'converts a URI string to a URI object' do
+    'www.seologic.com'.to_uri.is_a?(URI).should be_true
+    'http://www.seologic.com'.to_uri.is_a?(URI::HTTP).should be_true
+    'SEO Logic'.to_uri.should be_nil
+  end
+
+  it 'detects a valid HTTP URL' do
+    'www.seologic.com'.valid_http_url?.should be_false
+    'http://'.valid_http_url?.should be_false
+    'http://www.seologic.com'.valid_http_url?.should be_true
+    'http://http://www.seologic.com'.valid_http_url?.should be_false
+    'SEO Logic'.valid_http_url?.should be_false
+  end
+
+end