trails 1.0.2 → 1.0.3

data/History.txt

@@ -1,3 +1,7 @@
+=== 1.0.3 / 2010-03-06
+
+* Fix Manifest so all required files get added (!)
+
 === 1.0.2 / 2010-02-06
 
 * Add support for default twiml layout

data/Manifest.txt

@@ -3,9 +3,54 @@ History.txt
 Manifest.txt
 README.txt
 Rakefile
+assets/layouts/default_layout.twiml.builder
+bin/trails
 lib/trails.rb
 lib/trails/exception.rb
+lib/trails/test_helper.rb
 lib/trails/twilio/account.rb
 lib/trails/twilio/call_handling.rb
 lib/trails/twilio/incoming.rb
+lib/twiliorest.rb
+test/example/README
+test/example/Rakefile
+test/example/app/controllers/application_controller.rb
+test/example/app/controllers/calls_controller.rb
+test/example/app/helpers/application_helper.rb
+test/example/app/helpers/calls_helper.rb
+test/example/app/views/calls/index.html.erb
+test/example/app/views/calls/index.twiml.builder
+test/example/config/boot.rb
+test/example/config/database.yml
+test/example/config/environment.rb
+test/example/config/environments/development.rb
+test/example/config/environments/production.rb
+test/example/config/environments/test.rb
+test/example/config/initializers/backtrace_silencers.rb
+test/example/config/initializers/inflections.rb
+test/example/config/initializers/mime_types.rb
+test/example/config/initializers/new_rails_defaults.rb
+test/example/config/initializers/session_store.rb
+test/example/config/locales/en.yml
+test/example/config/routes.rb
+test/example/config/twilio.yml
+test/example/db/development.sqlite3
+test/example/db/schema.rb
+test/example/db/seeds.rb
+test/example/db/test.sqlite3
+test/example/doc/README_FOR_APP
+test/example/script/about
+test/example/script/console
+test/example/script/dbconsole
+test/example/script/destroy
+test/example/script/generate
+test/example/script/performance/benchmarker
+test/example/script/performance/profiler
+test/example/script/plugin
+test/example/script/runner
+test/example/script/server
+test/example/test/functional/calls_controller_test.rb
+test/example/test/performance/browsing_test.rb
+test/example/test/test_helper.rb
+test/example/test/unit/helpers/calls_helper_test.rb
 test/test_trails.rb

data/README.txt

@@ -4,10 +4,8 @@
 
 == DESCRIPTION:
 
-Code to make developing twilio applications (even) easier in rails.
-
-Includes support for SMS, a special MimeType? (twiml), and functional tests: as_twilio{ get '/my_action' }
-
+Makes developing twilio applications (even) easier in rails.
+Support for SMS, twiml MimeType alias, functional test helpers.
 
 == FEATURES/PROBLEMS:
 

data/assets/layouts/default_layout.twiml.builder

@@ -0,0 +1,4 @@
+xml.instruct!
+xml.Response do
+  xml << yield
+end

data/lib/trails/test_helper.rb

@@ -0,0 +1,127 @@
+require 'ostruct'
+
+module Trails
+  module TestHelper
+    def open_session_as_twilio( as_twilio_opts = {}, *args )
+      session = open_session( *args )
+      modify_session_with_twilio_opts( session, as_twilio_opts )
+      session
+    end
+
+    def as_twilio( as_twilio_opts = {}, &block )
+      if( @integration_session )
+        modify_session_with_twilio_opts( @integration_session, as_twilio_opts )
+        # end integration test
+      elsif( @controller ) # ok we're in a functional test
+        # mess with the controller, allowing us to add parameters
+        header_modifier = lambda{ |h,o| modify_headers_with_twilio_opts( h, o ) }
+        param_modifier = lambda{ |p,o| modify_params_with_twilio_opts( p, o ) }
+        @controller.metaclass.send( :define_method, :process_with_twilio_as_caller ) do |request, response|
+          # unfortunately we have to reach a little deep into the request here...
+          parameters_to_add = {}
+          header_modifier.call( request.env, as_twilio_opts )
+          param_modifier.call( parameters_to_add, as_twilio_opts )
+
+          # add_parameters
+          unless( parameters_to_add.blank? )
+            request.instance_variable_set( :@_memoized_query_string, nil ) # cause the query string to be un-memoized
+            add_parameters( parameters_to_add )
+          end
+
+          process_without_twilio_as_caller( request, response )
+        end # def process_with_twilio_as_caller
+        @controller.metaclass.send( :alias_method_chain, :process, :twilio_as_caller )
+
+        # need to to easily add parameters
+        @controller.metaclass.send( :define_method, :add_parameters ) do |params|
+          params ||= {}
+          request.query_parameters.merge!( params )
+          new_uri = request.request_uri + '&' + params.
+            collect{|k,v| "#{CGI::escape(k.to_s)}=#{CGI::escape(v.to_s)}"}.
+            join('&')
+          request.set_REQUEST_URI( new_uri )
+          request.__send__( :instance_variable_set, :@parameters, nil )
+        end # add_parameters
+      end # functional test
+
+      # cool. call the controller action now:
+      block.call()
+
+    end # as_twilio
+    
+    # message defaults to @response.body
+    def assert_length_of_sms( message = nil )
+      message ||= @response.body
+      assert_block( build_message( "SMS should have been no longer than ? characters, but was ? characters.", 
+                                   Trails::Twilio::Account::MAX_SMS_LENGTH, message.size ) ) {
+        message.size <= Trails::Twilio::Account::MAX_SMS_LENGTH 
+      }
+    end
+
+
+    def user_presses( digits )
+      { 'Digits' => digits }
+    end
+
+    def user_records( sound_url )
+      { 'RecordingUrl' => sound_url }
+    end
+
+    protected
+    def modify_session_with_twilio_opts( session, as_twilio_opts )
+
+      header_modifier = lambda{ |h,o| modify_headers_with_twilio_opts( h, o ) }
+      param_modifier = lambda{ |p,o| modify_params_with_twilio_opts( p, o ) }
+
+      session.metaclass.send( :define_method, :process_with_twilio_as_caller ) do |method, path, params, headers|
+        params ||= {}
+        headers ||= {}
+
+        header_modifier.call( headers, as_twilio_opts )
+        param_modifier.call( params, as_twilio_opts )
+
+        process_without_twilio_as_caller( method, path, params, headers )
+      end # define process_with_twilio_as_caller
+      session.metaclass.send( :alias_method_chain, :process, :twilio_as_caller )
+    end
+
+    def modify_headers_with_twilio_opts( headers, as_twilio_opts )
+      account = if( as_twilio_opts[:account].blank? )
+                  cfg = Twilio::Account.send( :config )
+                  cfg[cfg.keys.first]
+                else
+                  as_twilio_opts[:account]
+                end
+      headers['HTTP_X_TWILIO_ACCOUNTSID'] = account[:sid]
+    end
+
+    def modify_params_with_twilio_opts( params, as_twilio_opts )
+      caller = as_twilio_opts[:caller] || '4155551212'
+      called = as_twilio_opts[:called] || '6155556161'
+      from = as_twilio_opts[:from] || '6665554321'
+      params['Caller'] = caller
+      params['Called'] = called
+      params['From'] = from      
+    end
+
+    private
+    module IntegrationDSL
+    end
+
+  end # module TestHelper
+end # module Trails
+
+# open up the TwilioRest::Account class so that we can keep track of faked requests
+class TwilioRest::Account
+  def self.faked_requests
+    return @@fake_requests
+  end
+  def request_with_fake( url, method, params )
+    @@fake_requests ||= []
+    @@fake_requests.push( OpenStruct.new( :url => url, :method => method, :params => params ) )
+    fake_response = OpenStruct.new
+    fake_response.body = 'Fake Body'
+    fake_response
+  end
+  alias_method_chain :request, :fake
+end

data/lib/trails.rb

@@ -1,5 +1,5 @@
 module Trails
-  VERSION = '1.0.2'
+  VERSION = '1.0.3'
 end
 begin
   TwilioRest

data/lib/twiliorest.rb

@@ -0,0 +1,115 @@
+=begin
+Copyright (c) 2008 Twilio, Inc.
+
+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.
+=end
+
+module TwilioRest
+    require 'net/http'
+    require 'net/https'
+    require 'uri'
+    require 'cgi'
+    
+    TWILIO_API_URL = 'https://api.twilio.com'
+    
+    class TwilioRest::Account
+        
+        #initialize a twilio account object
+        #
+        #id: Twilio account SID/ID
+        #token: Twilio account token
+        #
+        #returns a Twilio account object
+        def initialize(id, token)
+            @id = id
+            @token = token
+        end
+        
+        def _urlencode(params)
+            params.to_a.collect! \
+                { |k, v| "#{k}=#{CGI.escape(v.to_s)}" }.join("&")
+        end
+        
+        def _build_get_uri(uri, params)
+            if params && params.length > 0
+                if uri.include?('?')
+                    if uri[-1, 1] != '&'
+                        uri += '&'
+                    end
+                    uri += _urlencode(params)
+                else
+                    uri += '?' + _urlencode(params)
+                end
+            end
+            return uri
+        end
+        
+        def _fetch(url, params, method=nil)
+            if method && method == 'GET'
+                url = _build_get_uri(url, params)
+            end
+            uri = URI.parse(url)
+            
+            http = Net::HTTP.new(uri.host, uri.port)
+            http.use_ssl = true
+            
+            if method && method == 'GET'
+                req = Net::HTTP::Get.new(uri.request_uri)
+            elsif method && method == 'DELETE'
+                req = Net::HTTP::Delete.new(uri.request_uri)
+            elsif method && method == 'PUT'
+                req = Net::HTTP::Put.new(uri.request_uri)
+                req.set_form_data(params)
+            else
+                req = Net::HTTP::Post.new(uri.request_uri)
+                req.set_form_data(params)
+            end
+            req.basic_auth(@id, @token)
+            
+            return http.request(req)
+        end
+        
+        #sends a request and gets a response from the Twilio REST API
+        #
+        #path: the URL (relative to the endpoint URL, after the /v1
+        #url: the HTTP method to use, defaults to POST
+        #vars: for POST or PUT, a dict of data to send
+        #
+        #returns Twilio response XML or raises an exception on error
+        def request(path, method=nil, vars={})
+            if !path || path.length < 1
+                raise ArgumentError, 'Invalid path parameter'
+            end
+            if method && !['GET', 'POST', 'DELETE', 'PUT'].include?(method)
+                raise NotImplementedError, 'HTTP %s not implemented' % method
+            end
+            
+            if path[0, 1] == '/'
+                uri = TWILIO_API_URL + path
+            else
+                uri = TWILIO_API_URL + '/' + path
+            end
+            
+            return _fetch(uri, vars, method)
+        end
+    end
+end

data/test/example/README

@@ -0,0 +1,243 @@
+== Welcome to Rails
+
+Rails is a web-application framework that includes everything needed to create 
+database-backed web applications according to the Model-View-Control pattern. 
+
+This pattern splits the view (also called the presentation) into "dumb" templates
+that are primarily responsible for inserting pre-built data in between HTML tags.
+The model contains the "smart" domain objects (such as Account, Product, Person,
+Post) that holds all the business logic and knows how to persist themselves to
+a database. The controller handles the incoming requests (such as Save New Account,
+Update Product, Show Post) by manipulating the model and directing data to the view.
+
+In Rails, the model is handled by what's called an object-relational mapping
+layer entitled Active Record. This layer allows you to present the data from
+database rows as objects and embellish these data objects with business logic
+methods. You can read more about Active Record in
+link:files/vendor/rails/activerecord/README.html.
+
+The controller and view are handled by the Action Pack, which handles both
+layers by its two parts: Action View and Action Controller. These two layers
+are bundled in a single package due to their heavy interdependence. This is
+unlike the relationship between the Active Record and Action Pack that is much
+more separate. Each of these packages can be used independently outside of
+Rails.  You can read more about Action Pack in
+link:files/vendor/rails/actionpack/README.html.
+
+
+== Getting Started
+
+1. At the command prompt, start a new Rails application using the <tt>rails</tt> command
+   and your application name. Ex: rails myapp
+2. Change directory into myapp and start the web server: <tt>script/server</tt> (run with --help for options)
+3. Go to http://localhost:3000/ and get "Welcome aboard: You're riding the Rails!"
+4. Follow the guidelines to start developing your application
+
+
+== Web Servers
+
+By default, Rails will try to use Mongrel if it's are installed when started with script/server, otherwise Rails will use WEBrick, the webserver that ships with Ruby. But you can also use Rails
+with a variety of other web servers.
+
+Mongrel is a Ruby-based webserver with a C component (which requires compilation) that is
+suitable for development and deployment of Rails applications. If you have Ruby Gems installed,
+getting up and running with mongrel is as easy as: <tt>gem install mongrel</tt>.
+More info at: http://mongrel.rubyforge.org
+
+Say other Ruby web servers like Thin and Ebb or regular web servers like Apache or LiteSpeed or
+Lighttpd or IIS. The Ruby web servers are run through Rack and the latter can either be setup to use
+FCGI or proxy to a pack of Mongrels/Thin/Ebb servers.
+
+== Apache .htaccess example for FCGI/CGI
+
+# General Apache options
+AddHandler fastcgi-script .fcgi
+AddHandler cgi-script .cgi
+Options +FollowSymLinks +ExecCGI
+
+# If you don't want Rails to look in certain directories,
+# use the following rewrite rules so that Apache won't rewrite certain requests
+# 
+# Example:
+#   RewriteCond %{REQUEST_URI} ^/notrails.*
+#   RewriteRule .* - [L]
+
+# Redirect all requests not available on the filesystem to Rails
+# By default the cgi dispatcher is used which is very slow
+# 
+# For better performance replace the dispatcher with the fastcgi one
+#
+# Example:
+#   RewriteRule ^(.*)$ dispatch.fcgi [QSA,L]
+RewriteEngine On
+
+# If your Rails application is accessed via an Alias directive,
+# then you MUST also set the RewriteBase in this htaccess file.
+#
+# Example:
+#   Alias /myrailsapp /path/to/myrailsapp/public
+#   RewriteBase /myrailsapp
+
+RewriteRule ^$ index.html [QSA]
+RewriteRule ^([^.]+)$ $1.html [QSA]
+RewriteCond %{REQUEST_FILENAME} !-f
+RewriteRule ^(.*)$ dispatch.cgi [QSA,L]
+
+# In case Rails experiences terminal errors
+# Instead of displaying this message you can supply a file here which will be rendered instead
+# 
+# Example:
+#   ErrorDocument 500 /500.html
+
+ErrorDocument 500 "<h2>Application error</h2>Rails application failed to start properly"
+
+
+== Debugging Rails
+
+Sometimes your application goes wrong.  Fortunately there are a lot of tools that
+will help you debug it and get it back on the rails.
+
+First area to check is the application log files.  Have "tail -f" commands running
+on the server.log and development.log. Rails will automatically display debugging
+and runtime information to these files. Debugging info will also be shown in the
+browser on requests from 127.0.0.1.
+
+You can also log your own messages directly into the log file from your code using
+the Ruby logger class from inside your controllers. Example:
+
+  class WeblogController < ActionController::Base
+    def destroy
+      @weblog = Weblog.find(params[:id])
+      @weblog.destroy
+      logger.info("#{Time.now} Destroyed Weblog ID ##{@weblog.id}!")
+    end
+  end
+
+The result will be a message in your log file along the lines of:
+
+  Mon Oct 08 14:22:29 +1000 2007 Destroyed Weblog ID #1
+
+More information on how to use the logger is at http://www.ruby-doc.org/core/
+
+Also, Ruby documentation can be found at http://www.ruby-lang.org/ including:
+
+* The Learning Ruby (Pickaxe) Book: http://www.ruby-doc.org/docs/ProgrammingRuby/
+* Learn to Program: http://pine.fm/LearnToProgram/  (a beginners guide)
+
+These two online (and free) books will bring you up to speed on the Ruby language
+and also on programming in general.
+
+
+== Debugger
+
+Debugger support is available through the debugger command when you start your Mongrel or
+Webrick server with --debugger. This means that you can break out of execution at any point
+in the code, investigate and change the model, AND then resume execution! 
+You need to install ruby-debug to run the server in debugging mode. With gems, use 'gem install ruby-debug'
+Example:
+
+  class WeblogController < ActionController::Base
+    def index
+      @posts = Post.find(:all)
+      debugger
+    end
+  end
+
+So the controller will accept the action, run the first line, then present you
+with a IRB prompt in the server window. Here you can do things like:
+
+  >> @posts.inspect
+  => "[#<Post:0x14a6be8 @attributes={\"title\"=>nil, \"body\"=>nil, \"id\"=>\"1\"}>,
+       #<Post:0x14a6620 @attributes={\"title\"=>\"Rails you know!\", \"body\"=>\"Only ten..\", \"id\"=>\"2\"}>]"
+  >> @posts.first.title = "hello from a debugger"
+  => "hello from a debugger"
+
+...and even better is that you can examine how your runtime objects actually work:
+
+  >> f = @posts.first
+  => #<Post:0x13630c4 @attributes={"title"=>nil, "body"=>nil, "id"=>"1"}>
+  >> f.
+  Display all 152 possibilities? (y or n)
+
+Finally, when you're ready to resume execution, you enter "cont"
+
+
+== Console
+
+You can interact with the domain model by starting the console through <tt>script/console</tt>.
+Here you'll have all parts of the application configured, just like it is when the
+application is running. You can inspect domain models, change values, and save to the
+database. Starting the script without arguments will launch it in the development environment.
+Passing an argument will specify a different environment, like <tt>script/console production</tt>.
+
+To reload your controllers and models after launching the console run <tt>reload!</tt>
+
+== dbconsole
+
+You can go to the command line of your database directly through <tt>script/dbconsole</tt>.
+You would be connected to the database with the credentials defined in database.yml.
+Starting the script without arguments will connect you to the development database. Passing an
+argument will connect you to a different database, like <tt>script/dbconsole production</tt>.
+Currently works for mysql, postgresql and sqlite.
+
+== Description of Contents
+
+app
+  Holds all the code that's specific to this particular application.
+
+app/controllers
+  Holds controllers that should be named like weblogs_controller.rb for
+  automated URL mapping. All controllers should descend from ApplicationController
+  which itself descends from ActionController::Base.
+
+app/models
+  Holds models that should be named like post.rb.
+  Most models will descend from ActiveRecord::Base.
+
+app/views
+  Holds the template files for the view that should be named like
+  weblogs/index.html.erb for the WeblogsController#index action. All views use eRuby
+  syntax.
+
+app/views/layouts
+  Holds the template files for layouts to be used with views. This models the common
+  header/footer method of wrapping views. In your views, define a layout using the
+  <tt>layout :default</tt> and create a file named default.html.erb. Inside default.html.erb,
+  call <% yield %> to render the view using this layout.
+
+app/helpers
+  Holds view helpers that should be named like weblogs_helper.rb. These are generated
+  for you automatically when using script/generate for controllers. Helpers can be used to
+  wrap functionality for your views into methods.
+
+config
+  Configuration files for the Rails environment, the routing map, the database, and other dependencies.
+
+db
+  Contains the database schema in schema.rb.  db/migrate contains all
+  the sequence of Migrations for your schema.
+
+doc
+  This directory is where your application documentation will be stored when generated
+  using <tt>rake doc:app</tt>
+
+lib
+  Application specific libraries. Basically, any kind of custom code that doesn't
+  belong under controllers, models, or helpers. This directory is in the load path.
+
+public
+  The directory available for the web server. Contains subdirectories for images, stylesheets,
+  and javascripts. Also contains the dispatchers and the default HTML files. This should be
+  set as the DOCUMENT_ROOT of your web server.
+
+script
+  Helper scripts for automation and generation.
+
+test
+  Unit and functional tests along with fixtures. When using the script/generate scripts, template
+  test files will be generated for you and placed in this directory.
+
+vendor
+  External libraries that the application depends on. Also includes the plugins subdirectory.
+  If the app has frozen rails, those gems also go here, under vendor/rails/.
+  This directory is in the load path.

data/test/example/Rakefile

@@ -0,0 +1,10 @@
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
+
+require(File.join(File.dirname(__FILE__), 'config', 'boot'))
+
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+require 'tasks/rails'

data/test/example/app/controllers/application_controller.rb

@@ -0,0 +1,11 @@
+# Filters added to this controller apply to all controllers in the application.
+# Likewise, all the methods added will be available for all controllers.
+
+class ApplicationController < ActionController::Base
+  helper :all # include all helpers, all the time
+  include Trails::Twilio::CallHandling
+  protect_from_forgery # See ActionController::RequestForgeryProtection for details
+
+  # Scrub sensitive parameters from your log
+  # filter_parameter_logging :password
+end

data/test/example/app/controllers/calls_controller.rb

@@ -0,0 +1,8 @@
+class CallsController < ApplicationController
+  def index
+    respond_to do |format|
+      format.html {}
+      format.twiml {}
+    end
+  end
+end

data/test/example/app/helpers/application_helper.rb

@@ -0,0 +1,3 @@
+# Methods added to this helper will be available to all templates in the application.
+module ApplicationHelper
+end

data/test/example/app/helpers/calls_helper.rb

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

data/test/example/app/views/calls/index.html.erb

@@ -0,0 +1 @@
+<%= link_to 'Click to record a message', :action => :new %>

data/test/example/app/views/calls/index.twiml.builder

@@ -0,0 +1,2 @@
+xml.Say "Press 1 to record a message"
+xml.Gather

data/test/example/config/boot.rb

@@ -0,0 +1,110 @@
+# Don't change this file!
+# Configure your app in config/environment.rb and config/environments/*.rb
+
+RAILS_ROOT = "#{File.dirname(__FILE__)}/.." unless defined?(RAILS_ROOT)
+
+module Rails
+  class << self
+    def boot!
+      unless booted?
+        preinitialize
+        pick_boot.run
+      end
+    end
+
+    def booted?
+      defined? Rails::Initializer
+    end
+
+    def pick_boot
+      (vendor_rails? ? VendorBoot : GemBoot).new
+    end
+
+    def vendor_rails?
+      File.exist?("#{RAILS_ROOT}/vendor/rails")
+    end
+
+    def preinitialize
+      load(preinitializer_path) if File.exist?(preinitializer_path)
+    end
+
+    def preinitializer_path
+      "#{RAILS_ROOT}/config/preinitializer.rb"
+    end
+  end
+
+  class Boot
+    def run
+      load_initializer
+      Rails::Initializer.run(:set_load_path)
+    end
+  end
+
+  class VendorBoot < Boot
+    def load_initializer
+      require "#{RAILS_ROOT}/vendor/rails/railties/lib/initializer"
+      Rails::Initializer.run(:install_gem_spec_stubs)
+      Rails::GemDependency.add_frozen_gem_path
+    end
+  end
+
+  class GemBoot < Boot
+    def load_initializer
+      self.class.load_rubygems
+      load_rails_gem
+      require 'initializer'
+    end
+
+    def load_rails_gem
+      if version = self.class.gem_version
+        gem 'rails', version
+      else
+        gem 'rails'
+      end
+    rescue Gem::LoadError => load_error
+      $stderr.puts %(Missing the Rails #{version} gem. Please `gem install -v=#{version} rails`, update your RAILS_GEM_VERSION setting in config/environment.rb for the Rails version you do have installed, or comment out RAILS_GEM_VERSION to use the latest version installed.)
+      exit 1
+    end
+
+    class << self
+      def rubygems_version
+        Gem::RubyGemsVersion rescue nil
+      end
+
+      def gem_version
+        if defined? RAILS_GEM_VERSION
+          RAILS_GEM_VERSION
+        elsif ENV.include?('RAILS_GEM_VERSION')
+          ENV['RAILS_GEM_VERSION']
+        else
+          parse_gem_version(read_environment_rb)
+        end
+      end
+
+      def load_rubygems
+        min_version = '1.3.2'
+        require 'rubygems'
+        unless rubygems_version >= min_version
+          $stderr.puts %Q(Rails requires RubyGems >= #{min_version} (you have #{rubygems_version}). Please `gem update --system` and try again.)
+          exit 1
+        end
+
+      rescue LoadError
+        $stderr.puts %Q(Rails requires RubyGems >= #{min_version}. Please install RubyGems and try again: http://rubygems.rubyforge.org)
+        exit 1
+      end
+
+      def parse_gem_version(text)
+        $1 if text =~ /^[^#]*RAILS_GEM_VERSION\s*=\s*["']([!~<>=]*\s*[\d.]+)["']/
+      end
+
+      private
+        def read_environment_rb
+          File.read("#{RAILS_ROOT}/config/environment.rb")
+        end
+    end
+  end
+end
+
+# All that for this:
+Rails.boot!

data/test/example/config/database.yml

@@ -0,0 +1,22 @@
+# SQLite version 3.x
+#   gem install sqlite3-ruby (not necessary on OS X Leopard)
+development:
+  adapter: sqlite3
+  database: db/development.sqlite3
+  pool: 5
+  timeout: 5000
+
+# Warning: The database defined as "test" will be erased and
+# re-generated from your development database when you run "rake".
+# Do not set this db to the same as development or production.
+test:
+  adapter: sqlite3
+  database: db/test.sqlite3
+  pool: 5
+  timeout: 5000
+
+production:
+  adapter: sqlite3
+  database: db/production.sqlite3
+  pool: 5
+  timeout: 5000

data/test/example/config/environment.rb

@@ -0,0 +1,43 @@
+# Be sure to restart your server when you modify this file
+
+# Specifies gem version of Rails to use when vendor/rails is not present
+RAILS_GEM_VERSION = '2.3.4' unless defined? RAILS_GEM_VERSION
+
+# Bootstrap the Rails environment, frameworks, and default configuration
+require File.join(File.dirname(__FILE__), 'boot')
+$: << File.join( File.dirname( __FILE__ ), '../../../lib/' )
+require 'trails'
+Rails::Initializer.run do |config|
+  # Settings in config/environments/* take precedence over those specified here.
+  # Application configuration should go into files in config/initializers
+  # -- all .rb files in that directory are automatically loaded.
+
+  # Add additional load paths for your own custom dirs
+  # config.load_paths += %W( #{RAILS_ROOT}/extras )
+
+  # Specify gems that this application depends on and have them installed with rake gems:install
+  # config.gem "bj"
+  # config.gem "hpricot", :version => '0.6', :source => "http://code.whytheluckystiff.net"
+  # config.gem "sqlite3-ruby", :lib => "sqlite3"
+  # config.gem "aws-s3", :lib => "aws/s3"
+
+  # Only load the plugins named here, in the order given (default is alphabetical).
+  # :all can be used as a placeholder for all plugins not explicitly named
+  # config.plugins = [ :exception_notification, :ssl_requirement, :all ]
+
+  # Skip frameworks you're not going to use. To use Rails without a database,
+  # you must remove the Active Record framework.
+  # config.frameworks -= [ :active_record, :active_resource, :action_mailer ]
+
+  # Activate observers that should always be running
+  # config.active_record.observers = :cacher, :garbage_collector, :forum_observer
+
+  # Set Time.zone default to the specified zone and make Active Record auto-convert to this zone.
+  # Run "rake -D time" for a list of tasks for finding time zone names.
+  config.time_zone = 'UTC'
+
+  # The default locale is :en and all translations from config/locales/*.rb,yml are auto loaded.
+  # config.i18n.load_path += Dir[Rails.root.join('my', 'locales', '*.{rb,yml}')]
+  # config.i18n.default_locale = :de
+end
+

data/test/example/config/environments/development.rb

@@ -0,0 +1,17 @@
+# Settings specified here will take precedence over those in config/environment.rb
+
+# In the development environment your application's code is reloaded on
+# every request.  This slows down response time but is perfect for development
+# since you don't have to restart the webserver when you make code changes.
+config.cache_classes = false
+
+# Log error messages when you accidentally call methods on nil.
+config.whiny_nils = true
+
+# Show full error reports and disable caching
+config.action_controller.consider_all_requests_local = true
+config.action_view.debug_rjs                         = true
+config.action_controller.perform_caching             = false
+
+# Don't care if the mailer can't send
+config.action_mailer.raise_delivery_errors = false

data/test/example/config/environments/production.rb

@@ -0,0 +1,28 @@
+# Settings specified here will take precedence over those in config/environment.rb
+
+# The production environment is meant for finished, "live" apps.
+# Code is not reloaded between requests
+config.cache_classes = true
+
+# Full error reports are disabled and caching is turned on
+config.action_controller.consider_all_requests_local = false
+config.action_controller.perform_caching             = true
+config.action_view.cache_template_loading            = true
+
+# See everything in the log (default is :info)
+# config.log_level = :debug
+
+# Use a different logger for distributed setups
+# config.logger = SyslogLogger.new
+
+# Use a different cache store in production
+# config.cache_store = :mem_cache_store
+
+# Enable serving of images, stylesheets, and javascripts from an asset server
+# config.action_controller.asset_host = "http://assets.example.com"
+
+# Disable delivery errors, bad email addresses will be ignored
+# config.action_mailer.raise_delivery_errors = false
+
+# Enable threaded mode
+# config.threadsafe!

data/test/example/config/environments/test.rb

@@ -0,0 +1,28 @@
+# Settings specified here will take precedence over those in config/environment.rb
+
+# The test environment is used exclusively to run your application's
+# test suite.  You never need to work with it otherwise.  Remember that
+# your test database is "scratch space" for the test suite and is wiped
+# and recreated between test runs.  Don't rely on the data there!
+config.cache_classes = true
+
+# Log error messages when you accidentally call methods on nil.
+config.whiny_nils = true
+
+# Show full error reports and disable caching
+config.action_controller.consider_all_requests_local = true
+config.action_controller.perform_caching             = false
+config.action_view.cache_template_loading            = true
+
+# Disable request forgery protection in test environment
+config.action_controller.allow_forgery_protection    = false
+
+# Tell Action Mailer not to deliver emails to the real world.
+# The :test delivery method accumulates sent emails in the
+# ActionMailer::Base.deliveries array.
+config.action_mailer.delivery_method = :test
+
+# Use SQL instead of Active Record's schema dumper when creating the test database.
+# This is necessary if your schema can't be completely dumped by the schema dumper,
+# like if you have constraints or database-specific column types
+# config.active_record.schema_format = :sql

data/test/example/config/initializers/backtrace_silencers.rb

@@ -0,0 +1,7 @@
+# Be sure to restart your server when you modify this file.
+
+# You can add backtrace silencers for libraries that you're using but don't wish to see in your backtraces.
+# Rails.backtrace_cleaner.add_silencer { |line| line =~ /my_noisy_library/ }
+
+# You can also remove all the silencers if you're trying do debug a problem that might steem from framework code.
+# Rails.backtrace_cleaner.remove_silencers!

data/test/example/config/initializers/inflections.rb

@@ -0,0 +1,10 @@
+# Be sure to restart your server when you modify this file.
+
+# Add new inflection rules using the following format 
+# (all these examples are active by default):
+# ActiveSupport::Inflector.inflections do |inflect|
+#   inflect.plural /^(ox)$/i, '\1en'
+#   inflect.singular /^(ox)en/i, '\1'
+#   inflect.irregular 'person', 'people'
+#   inflect.uncountable %w( fish sheep )
+# end

data/test/example/config/initializers/mime_types.rb

@@ -0,0 +1,5 @@
+# Be sure to restart your server when you modify this file.
+
+# Add new mime types for use in respond_to blocks:
+# Mime::Type.register "text/richtext", :rtf
+# Mime::Type.register_alias "text/html", :iphone

data/test/example/config/initializers/new_rails_defaults.rb

@@ -0,0 +1,21 @@
+# Be sure to restart your server when you modify this file.
+
+# These settings change the behavior of Rails 2 apps and will be defaults
+# for Rails 3. You can remove this initializer when Rails 3 is released.
+
+if defined?(ActiveRecord)
+  # Include Active Record class name as root for JSON serialized output.
+  ActiveRecord::Base.include_root_in_json = true
+
+  # Store the full class name (including module namespace) in STI type column.
+  ActiveRecord::Base.store_full_sti_class = true
+end
+
+ActionController::Routing.generate_best_match = false
+
+# Use ISO 8601 format for JSON serialized times and dates.
+ActiveSupport.use_standard_json_time_format = true
+
+# Don't escape HTML entities in JSON, leave that for the #json_escape helper.
+# if you're including raw json in an HTML page.
+ActiveSupport.escape_html_entities_in_json = false

data/test/example/config/initializers/session_store.rb

@@ -0,0 +1,15 @@
+# Be sure to restart your server when you modify this file.
+
+# Your secret key for verifying cookie session data integrity.
+# If you change this key, all old sessions will become invalid!
+# Make sure the secret is at least 30 characters and all random, 
+# no regular words or you'll be exposed to dictionary attacks.
+ActionController::Base.session = {
+  :key         => '_example_session',
+  :secret      => '2c1d7e3c41ff13300dd5f19519ceef19ad10787ce1bcf38f9ef5a430bf2bd7a239547301aa433cfd47db542d32a251d9245f4dcb8d38cb3b6802013fe955a278'
+}
+
+# Use the database for sessions instead of the cookie-based default,
+# which shouldn't be used to store highly confidential information
+# (create the session table with "rake db:sessions:create")
+# ActionController::Base.session_store = :active_record_store

data/test/example/config/locales/en.yml

@@ -0,0 +1,5 @@
+# Sample localization file for English. Add more files in this directory for other locales.
+# See http://github.com/svenfuchs/rails-i18n/tree/master/rails%2Flocale for starting points.
+
+en:
+  hello: "Hello world"

data/test/example/config/routes.rb

@@ -0,0 +1,43 @@
+ActionController::Routing::Routes.draw do |map|
+  # The priority is based upon order of creation: first created -> highest priority.
+
+  # Sample of regular route:
+  #   map.connect 'products/:id', :controller => 'catalog', :action => 'view'
+  # Keep in mind you can assign values other than :controller and :action
+
+  # Sample of named route:
+  #   map.purchase 'products/:id/purchase', :controller => 'catalog', :action => 'purchase'
+  # This route can be invoked with purchase_url(:id => product.id)
+
+  # Sample resource route (maps HTTP verbs to controller actions automatically):
+  #   map.resources :products
+
+  # Sample resource route with options:
+  #   map.resources :products, :member => { :short => :get, :toggle => :post }, :collection => { :sold => :get }
+
+  # Sample resource route with sub-resources:
+  #   map.resources :products, :has_many => [ :comments, :sales ], :has_one => :seller
+  
+  # Sample resource route with more complex sub-resources
+  #   map.resources :products do |products|
+  #     products.resources :comments
+  #     products.resources :sales, :collection => { :recent => :get }
+  #   end
+
+  # Sample resource route within a namespace:
+  #   map.namespace :admin do |admin|
+  #     # Directs /admin/products/* to Admin::ProductsController (app/controllers/admin/products_controller.rb)
+  #     admin.resources :products
+  #   end
+
+  # You can have the root of your site routed with map.root -- just remember to delete public/index.html.
+  # map.root :controller => "welcome"
+
+  # See how all your routes lay out with "rake routes"
+
+  # Install the default routes as the lowest priority.
+  # Note: These default routes make all actions in every controller accessible via GET requests. You should
+  # consider removing or commenting them out if you're using named routes and resources.
+  map.connect ':controller/:action/:id'
+  map.connect ':controller/:action/:id.:format'
+end

data/test/example/config/twilio.yml

@@ -0,0 +1,3 @@
+"YourTwilioSid":
+  :sid: "YourTwilioSid"
+  :token: "YourTwilioToken"

data/test/example/db/schema.rb

@@ -0,0 +1,14 @@
+# This file is auto-generated from the current state of the database. Instead of editing this file, 
+# please use the migrations feature of Active Record to incrementally modify your database, and
+# then regenerate this schema definition.
+#
+# Note that this schema.rb definition is the authoritative source for your database schema. If you need
+# to create the application database on another system, you should be using db:schema:load, not running
+# all the migrations from scratch. The latter is a flawed and unsustainable approach (the more migrations
+# you'll amass, the slower it'll run and the greater likelihood for issues).
+#
+# It's strongly recommended to check this file into your version control system.
+
+ActiveRecord::Schema.define(:version => 0) do
+
+end

data/test/example/db/seeds.rb

@@ -0,0 +1,7 @@
+# This file should contain all the record creation needed to seed the database with its default values.
+# The data can then be loaded with the rake db:seed (or created alongside the db with db:setup).
+#
+# Examples:
+#   
+#   cities = City.create([{ :name => 'Chicago' }, { :name => 'Copenhagen' }])
+#   Major.create(:name => 'Daley', :city => cities.first)

data/test/example/doc/README_FOR_APP

@@ -0,0 +1,2 @@
+Use this README file to introduce your application and point to useful places in the API for learning more.
+Run "rake doc:app" to generate API documentation for your models, controllers, helpers, and libraries.

data/test/example/script/about

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require File.expand_path('../../config/boot',  __FILE__)
+$LOAD_PATH.unshift "#{RAILTIES_PATH}/builtin/rails_info"
+require 'commands/about'

data/test/example/script/console

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require File.expand_path('../../config/boot',  __FILE__)
+require 'commands/console'

data/test/example/script/dbconsole

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require File.expand_path('../../config/boot',  __FILE__)
+require 'commands/dbconsole'

data/test/example/script/destroy

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require File.expand_path('../../config/boot',  __FILE__)
+require 'commands/destroy'

data/test/example/script/generate

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require File.expand_path('../../config/boot',  __FILE__)
+require 'commands/generate'

data/test/example/script/performance/benchmarker

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require File.expand_path('../../../config/boot',  __FILE__)
+require 'commands/performance/benchmarker'

data/test/example/script/performance/profiler

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require File.expand_path('../../../config/boot',  __FILE__)
+require 'commands/performance/profiler'

data/test/example/script/plugin

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require File.expand_path('../../config/boot',  __FILE__)
+require 'commands/plugin'

data/test/example/script/runner

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require File.expand_path('../../config/boot',  __FILE__)
+require 'commands/runner'

data/test/example/script/server

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require File.expand_path('../../config/boot',  __FILE__)
+require 'commands/server'

data/test/example/test/functional/calls_controller_test.rb

@@ -0,0 +1,15 @@
+require File.join( File.dirname( __FILE__ ), '../test_helper' )
+require 'trails/test_helper'
+
+class CallsControllerTest < ActionController::TestCase
+  include Trails::TestHelper
+
+  test "the index action" do
+    get :index
+    assert_response :success
+    assert_match(  /Click to /, @response.body )
+    as_twilio{ get :index }
+    assert_response :success
+#    assert_tag( :tag => 'Say' ) # WIP
+  end
+end

data/test/example/test/performance/browsing_test.rb

@@ -0,0 +1,9 @@
+require 'test_helper'
+require 'performance_test_help'
+
+# Profiling results for each test method are written to tmp/performance.
+class BrowsingTest < ActionController::PerformanceTest
+  def test_homepage
+    get '/'
+  end
+end

data/test/example/test/unit/helpers/calls_helper_test.rb

@@ -0,0 +1,4 @@
+require 'test_helper'
+
+class CallsHelperTest < ActionView::TestCase
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: trails
 version: !ruby/object:Gem::Version 
-  version: 1.0.2
+  version: 1.0.3
 platform: ruby
 authors: 
 - Hemant Bhanoo
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-02-07 00:00:00 -08:00
+date: 2010-03-08 00:00:00 -08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -43,13 +43,12 @@ dependencies:
         version: 2.5.0
     version: 
 description: |-
-  Code to make developing twilio applications (even) easier in rails.
-  
-  Includes support for SMS, a special MimeType? (twiml), and functional tests: as_twilio{ get '/my_action' }
+  Makes developing twilio applications (even) easier in rails.
+  Support for SMS, twiml MimeType alias, functional test helpers.
 email: 
 - hemant@bhanoo.com
-executables: []
-
+executables: 
+- trails
 extensions: []
 
 extra_rdoc_files: 
@@ -62,11 +61,56 @@ files:
 - Manifest.txt
 - README.txt
 - Rakefile
+- assets/layouts/default_layout.twiml.builder
+- bin/trails
 - lib/trails.rb
 - lib/trails/exception.rb
+- lib/trails/test_helper.rb
 - lib/trails/twilio/account.rb
 - lib/trails/twilio/call_handling.rb
 - lib/trails/twilio/incoming.rb
+- lib/twiliorest.rb
+- test/example/README
+- test/example/Rakefile
+- test/example/app/controllers/application_controller.rb
+- test/example/app/controllers/calls_controller.rb
+- test/example/app/helpers/application_helper.rb
+- test/example/app/helpers/calls_helper.rb
+- test/example/app/views/calls/index.html.erb
+- test/example/app/views/calls/index.twiml.builder
+- test/example/config/boot.rb
+- test/example/config/database.yml
+- test/example/config/environment.rb
+- test/example/config/environments/development.rb
+- test/example/config/environments/production.rb
+- test/example/config/environments/test.rb
+- test/example/config/initializers/backtrace_silencers.rb
+- test/example/config/initializers/inflections.rb
+- test/example/config/initializers/mime_types.rb
+- test/example/config/initializers/new_rails_defaults.rb
+- test/example/config/initializers/session_store.rb
+- test/example/config/locales/en.yml
+- test/example/config/routes.rb
+- test/example/config/twilio.yml
+- test/example/db/development.sqlite3
+- test/example/db/schema.rb
+- test/example/db/seeds.rb
+- test/example/db/test.sqlite3
+- test/example/doc/README_FOR_APP
+- test/example/script/about
+- test/example/script/console
+- test/example/script/dbconsole
+- test/example/script/destroy
+- test/example/script/generate
+- test/example/script/performance/benchmarker
+- test/example/script/performance/profiler
+- test/example/script/plugin
+- test/example/script/runner
+- test/example/script/server
+- test/example/test/functional/calls_controller_test.rb
+- test/example/test/performance/browsing_test.rb
+- test/example/test/test_helper.rb
+- test/example/test/unit/helpers/calls_helper_test.rb
 - test/test_trails.rb
 has_rdoc: true
 homepage: http://code.google.com/p/twilio-on-rails/
@@ -96,7 +140,7 @@ rubyforge_project: trails
 rubygems_version: 1.3.5
 signing_key: 
 specification_version: 3
-summary: Code to make developing twilio applications (even) easier in rails
+summary: Makes developing twilio applications (even) easier in rails
 test_files: 
 - test/example/test/test_helper.rb
 - test/test_trails.rb