Commit e23ad913d1d30e9199274356dde89d712d74246e

* Added rails test_app
* Added mutex blocks around shared handle data
* Added basic request/sec storing

Commit diff

extra/test_app/README

 
1== Welcome to Rails
2
3Rails is a web-application and persistence framework that includes everything
4needed to create database-backed web-applications according to the
5Model-View-Control pattern of separation. This pattern splits the view (also
6called the presentation) into "dumb" templates that are primarily responsible
7for inserting pre-built data in between HTML tags. The model contains the
8"smart" domain objects (such as Account, Product, Person, Post) that holds all
9the business logic and knows how to persist themselves to a database. The
10controller handles the incoming requests (such as Save New Account, Update
11Product, Show Post) by manipulating the model and directing data to the view.
12
13In Rails, the model is handled by what's called an object-relational mapping
14layer entitled Active Record. This layer allows you to present the data from
15database rows as objects and embellish these data objects with business logic
16methods. You can read more about Active Record in
17link:files/vendor/rails/activerecord/README.html.
18
19The controller and view are handled by the Action Pack, which handles both
20layers by its two parts: Action View and Action Controller. These two layers
21are bundled in a single package due to their heavy interdependence. This is
22unlike the relationship between the Active Record and Action Pack that is much
23more separate. Each of these packages can be used independently outside of
24Rails. You can read more about Action Pack in
25link:files/vendor/rails/actionpack/README.html.
26
27
28== Getting Started
29
301. At the command prompt, start a new Rails application using the <tt>rails</tt> command
31 and your application name. Ex: rails myapp
32 (If you've downloaded Rails in a complete tgz or zip, this step is already done)
332. Change directory into myapp and start the web server: <tt>script/server</tt> (run with --help for options)
343. Go to http://localhost:3000/ and get "Welcome aboard: You’re riding the Rails!"
354. Follow the guidelines to start developing your application
36
37
38== Web Servers
39
40By default, Rails will try to use Mongrel and lighttpd if they are installed, otherwise
41Rails will use WEBrick, the webserver that ships with Ruby. When you run script/server,
42Rails will check if Mongrel exists, then lighttpd and finally fall back to WEBrick. This ensures
43that you can always get up and running quickly.
44
45Mongrel is a Ruby-based webserver with a C component (which requires compilation) that is
46suitable for development and deployment of Rails applications. If you have Ruby Gems installed,
47getting up and running with mongrel is as easy as: <tt>gem install mongrel</tt>.
48More info at: http://mongrel.rubyforge.org
49
50If Mongrel is not installed, Rails will look for lighttpd. It's considerably faster than
51Mongrel and WEBrick and also suited for production use, but requires additional
52installation and currently only works well on OS X/Unix (Windows users are encouraged
53to start with Mongrel). We recommend version 1.4.11 and higher. You can download it from
54http://www.lighttpd.net.
55
56And finally, if neither Mongrel or lighttpd are installed, Rails will use the built-in Ruby
57web server, WEBrick. WEBrick is a small Ruby web server suitable for development, but not
58for production.
59
60But of course its also possible to run Rails on any platform that supports FCGI.
61Apache, LiteSpeed, IIS are just a few. For more information on FCGI,
62please visit: http://wiki.rubyonrails.com/rails/pages/FastCGI
63
64
65== Debugging Rails
66
67Sometimes your application goes wrong. Fortunately there are a lot of tools that
68will help you debug it and get it back on the rails.
69
70First area to check is the application log files. Have "tail -f" commands running
71on the server.log and development.log. Rails will automatically display debugging
72and runtime information to these files. Debugging info will also be shown in the
73browser on requests from 127.0.0.1.
74
75You can also log your own messages directly into the log file from your code using
76the Ruby logger class from inside your controllers. Example:
77
78 class WeblogController < ActionController::Base
79 def destroy
80 @weblog = Weblog.find(params[:id])
81 @weblog.destroy
82 logger.info("#{Time.now} Destroyed Weblog ID ##{@weblog.id}!")
83 end
84 end
85
86The result will be a message in your log file along the lines of:
87
88 Mon Oct 08 14:22:29 +1000 2007 Destroyed Weblog ID #1
89
90More information on how to use the logger is at http://www.ruby-doc.org/core/
91
92Also, Ruby documentation can be found at http://www.ruby-lang.org/ including:
93
94* The Learning Ruby (Pickaxe) Book: http://www.ruby-doc.org/docs/ProgrammingRuby/
95* Learn to Program: http://pine.fm/LearnToProgram/ (a beginners guide)
96
97These two online (and free) books will bring you up to speed on the Ruby language
98and also on programming in general.
99
100
101== Debugger
102
103Debugger support is available through the debugger command when you start your Mongrel or
104Webrick server with --debugger. This means that you can break out of execution at any point
105in the code, investigate and change the model, AND then resume execution! Example:
106
107 class WeblogController < ActionController::Base
108 def index
109 @posts = Post.find(:all)
110 debugger
111 end
112 end
113
114So the controller will accept the action, run the first line, then present you
115with a IRB prompt in the server window. Here you can do things like:
116
117 >> @posts.inspect
118 => "[#<Post:0x14a6be8 @attributes={\"title\"=>nil, \"body\"=>nil, \"id\"=>\"1\"}>,
119 #<Post:0x14a6620 @attributes={\"title\"=>\"Rails you know!\", \"body\"=>\"Only ten..\", \"id\"=>\"2\"}>]"
120 >> @posts.first.title = "hello from a debugger"
121 => "hello from a debugger"
122
123...and even better is that you can examine how your runtime objects actually work:
124
125 >> f = @posts.first
126 => #<Post:0x13630c4 @attributes={"title"=>nil, "body"=>nil, "id"=>"1"}>
127 >> f.
128 Display all 152 possibilities? (y or n)
129
130Finally, when you're ready to resume execution, you enter "cont"
131
132
133== Console
134
135You can interact with the domain model by starting the console through <tt>script/console</tt>.
136Here you'll have all parts of the application configured, just like it is when the
137application is running. You can inspect domain models, change values, and save to the
138database. Starting the script without arguments will launch it in the development environment.
139Passing an argument will specify a different environment, like <tt>script/console production</tt>.
140
141To reload your controllers and models after launching the console run <tt>reload!</tt>
142
143
144== Description of Contents
145
146app
147 Holds all the code that's specific to this particular application.
148
149app/controllers
150 Holds controllers that should be named like weblogs_controller.rb for
151 automated URL mapping. All controllers should descend from ApplicationController
152 which itself descends from ActionController::Base.
153
154app/models
155 Holds models that should be named like post.rb.
156 Most models will descend from ActiveRecord::Base.
157
158app/views
159 Holds the template files for the view that should be named like
160 weblogs/index.erb for the WeblogsController#index action. All views use eRuby
161 syntax.
162
163app/views/layouts
164 Holds the template files for layouts to be used with views. This models the common
165 header/footer method of wrapping views. In your views, define a layout using the
166 <tt>layout :default</tt> and create a file named default.erb. Inside default.erb,
167 call <% yield %> to render the view using this layout.
168
169app/helpers
170 Holds view helpers that should be named like weblogs_helper.rb. These are generated
171 for you automatically when using script/generate for controllers. Helpers can be used to
172 wrap functionality for your views into methods.
173
174config
175 Configuration files for the Rails environment, the routing map, the database, and other dependencies.
176
177db
178 Contains the database schema in schema.rb. db/migrate contains all
179 the sequence of Migrations for your schema.
180
181doc
182 This directory is where your application documentation will be stored when generated
183 using <tt>rake doc:app</tt>
184
185lib
186 Application specific libraries. Basically, any kind of custom code that doesn't
187 belong under controllers, models, or helpers. This directory is in the load path.
188
189public
190 The directory available for the web server. Contains subdirectories for images, stylesheets,
191 and javascripts. Also contains the dispatchers and the default HTML files. This should be
192 set as the DOCUMENT_ROOT of your web server.
193
194script
195 Helper scripts for automation and generation.
196
197test
198 Unit and functional tests along with fixtures. When using the script/generate scripts, template
199 test files will be generated for you and placed in this directory.
200
201vendor
202 External libraries that the application depends on. Also includes the plugins subdirectory.
203 This directory is in the load path.
toggle raw diff

extra/test_app/Rakefile

 
1# Add your own tasks in files placed in lib/tasks ending in .rake,
2# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
3
4require(File.join(File.dirname(__FILE__), 'config', 'boot'))
5
6require 'rake'
7require 'rake/testtask'
8require 'rake/rdoctask'
9
10require 'tasks/rails'
toggle raw diff

extra/test_app/app/controllers/application.rb

 
1# Filters added to this controller apply to all controllers in the application.
2# Likewise, all the methods added will be available for all controllers.
3
4class ApplicationController < ActionController::Base
5 helper :all # include all helpers, all the time
6
7 # See ActionController::RequestForgeryProtection for details
8 # Uncomment the :secret if you're not using the cookie session store
9 protect_from_forgery # :secret => '674675c2db3fcd0a5d44060c41cebc8f'
10end
toggle raw diff

extra/test_app/app/controllers/home_controller.rb

 
1class HomeController < ApplicationController
2 def simple
3 render :text => 'hello'
4 end
5
6end
toggle raw diff

extra/test_app/app/helpers/application_helper.rb

 
1# Methods added to this helper will be available to all templates in the application.
2module ApplicationHelper
3end
toggle raw diff

extra/test_app/app/helpers/home_helper.rb

 
1module HomeHelper
2end
toggle raw diff

extra/test_app/config/boot.rb

 
1# Don't change this file!
2# Configure your app in config/environment.rb and config/environments/*.rb
3
4RAILS_ROOT = "#{File.dirname(__FILE__)}/.." unless defined?(RAILS_ROOT)
5
6module Rails
7 class << self
8 def boot!
9 unless booted?
10 preinitialize
11 pick_boot.run
12 end
13 end
14
15 def booted?
16 defined? Rails::Initializer
17 end
18
19 def pick_boot
20 (vendor_rails? ? VendorBoot : GemBoot).new
21 end
22
23 def vendor_rails?
24 File.exist?("#{RAILS_ROOT}/vendor/rails")
25 end
26
27 # FIXME : Ruby 1.9
28 def preinitialize
29 load(preinitializer_path) if File.exists?(preinitializer_path)
30 end
31
32 def preinitializer_path
33 "#{RAILS_ROOT}/config/preinitializer.rb"
34 end
35 end
36
37 class Boot
38 def run
39 load_initializer
40 Rails::Initializer.run(:set_load_path)
41 end
42 end
43
44 class VendorBoot < Boot
45 def load_initializer
46 require "#{RAILS_ROOT}/vendor/rails/railties/lib/initializer"
47 end
48 end
49
50 class GemBoot < Boot
51 def load_initializer
52 self.class.load_rubygems
53 load_rails_gem
54 require 'initializer'
55 end
56
57 def load_rails_gem
58 if version = self.class.gem_version
59 gem 'rails', version
60 else
61 gem 'rails'
62 end
63 rescue Gem::LoadError => load_error
64 $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.)
65 exit 1
66 end
67
68 class << self
69 def rubygems_version
70 Gem::RubyGemsVersion if defined? Gem::RubyGemsVersion
71 end
72
73 def gem_version
74 if defined? RAILS_GEM_VERSION
75 RAILS_GEM_VERSION
76 elsif ENV.include?('RAILS_GEM_VERSION')
77 ENV['RAILS_GEM_VERSION']
78 else
79 parse_gem_version(read_environment_rb)
80 end
81 end
82
83 def load_rubygems
84 require 'rubygems'
85
86 unless rubygems_version >= '0.9.4'
87 $stderr.puts %(Rails requires RubyGems >= 0.9.4 (you have #{rubygems_version}). Please `gem update --system` and try again.)
88 exit 1
89 end
90
91 rescue LoadError
92 $stderr.puts %(Rails requires RubyGems >= 0.9.4. Please install RubyGems and try again: http://rubygems.rubyforge.org)
93 exit 1
94 end
95
96 def parse_gem_version(text)
97 $1 if text =~ /^[^#]*RAILS_GEM_VERSION\s*=\s*["']([!~<>=]*\s*[\d.]+)["']/
98 end
99
100 private
101 def read_environment_rb
102 File.read("#{RAILS_ROOT}/config/environment.rb")
103 end
104 end
105 end
106end
107
108# All that for this:
109Rails.boot!
toggle raw diff

extra/test_app/config/database.yml

 
1# SQLite version 3.x
2# gem install sqlite3-ruby (not necessary on OS X Leopard)
3development:
4 adapter: sqlite3
5 database: db/development.sqlite3
6 timeout: 5000
7
8# Warning: The database defined as 'test' will be erased and
9# re-generated from your development database when you run 'rake'.
10# Do not set this db to the same as development or production.
11test:
12 adapter: sqlite3
13 database: db/test.sqlite3
14 timeout: 5000
15
16production:
17 adapter: sqlite3
18 database: db/production.sqlite3
19 timeout: 5000
toggle raw diff

extra/test_app/config/environment.rb

 
1# Be sure to restart your server when you modify this file
2
3# Uncomment below to force Rails into production mode when
4# you don't control web/app server and can't set it the proper way
5# ENV['RAILS_ENV'] ||= 'production'
6
7# Specifies gem version of Rails to use when vendor/rails is not present
8RAILS_GEM_VERSION = '2.0.2' unless defined? RAILS_GEM_VERSION
9
10# Bootstrap the Rails environment, frameworks, and default configuration
11require File.join(File.dirname(__FILE__), 'boot')
12
13Rails::Initializer.run do |config|
14 # Settings in config/environments/* take precedence over those specified here.
15 # Application configuration should go into files in config/initializers
16 # -- all .rb files in that directory are automatically loaded.
17 # See Rails::Configuration for more options.
18
19 # Skip frameworks you're not going to use (only works if using vendor/rails).
20 # To use Rails without a database, you must remove the Active Record framework
21 # config.frameworks -= [ :active_record, :active_resource, :action_mailer ]
22
23 # Only load the plugins named here, in the order given. By default, all plugins
24 # in vendor/plugins are loaded in alphabetical order.
25 # :all can be used as a placeholder for all plugins not explicitly named
26 # config.plugins = [ :exception_notification, :ssl_requirement, :all ]
27
28 # Add additional load paths for your own custom dirs
29 # config.load_paths += %W( #{RAILS_ROOT}/extras )
30
31 # Force all environments to use the same logger level
32 # (by default production uses :info, the others :debug)
33 # config.log_level = :debug
34
35 # Your secret key for verifying cookie session data integrity.
36 # If you change this key, all old sessions will become invalid!
37 # Make sure the secret is at least 30 characters and all random,
38 # no regular words or you'll be exposed to dictionary attacks.
39 config.action_controller.session = {
40 :session_key => '_test_app_session',
41 :secret => '6a29173e61f6b39be85d9a5bd4be3475a6b25178333f876327e80d5ac66afead642e79a1c3d0ebde1ea086f38d0d7d03de4b45451a7822d47b412ff42960bb99'
42 }
43
44 # Use the database for sessions instead of the cookie-based default,
45 # which shouldn't be used to store highly confidential information
46 # (create the session table with 'rake db:sessions:create')
47 # config.action_controller.session_store = :active_record_store
48
49 # Use SQL instead of Active Record's schema dumper when creating the test database.
50 # This is necessary if your schema can't be completely dumped by the schema dumper,
51 # like if you have constraints or database-specific column types
52 # config.active_record.schema_format = :sql
53
54 # Activate observers that should always be running
55 # config.active_record.observers = :cacher, :garbage_collector
56
57 # Make Active Record use UTC-base instead of local time
58 # config.active_record.default_timezone = :utc
59end
toggle raw diff

extra/test_app/config/environments/development.rb

 
1# Settings specified here will take precedence over those in config/environment.rb
2
3# In the development environment your application's code is reloaded on
4# every request. This slows down response time but is perfect for development
5# since you don't have to restart the webserver when you make code changes.
6config.cache_classes = false
7
8# Log error messages when you accidentally call methods on nil.
9config.whiny_nils = true
10
11# Show full error reports and disable caching
12config.action_controller.consider_all_requests_local = true
13config.action_view.debug_rjs = true
14config.action_controller.perform_caching = false
15config.action_view.cache_template_extensions = false
16
17# Don't care if the mailer can't send
18config.action_mailer.raise_delivery_errors = false
toggle raw diff

extra/test_app/config/environments/production.rb

 
1# Settings specified here will take precedence over those in config/environment.rb
2
3# The production environment is meant for finished, "live" apps.
4# Code is not reloaded between requests
5config.cache_classes = true
6
7# Use a different logger for distributed setups
8# config.logger = SyslogLogger.new
9
10# Full error reports are disabled and caching is turned on
11config.action_controller.consider_all_requests_local = false
12config.action_controller.perform_caching = true
13config.action_view.cache_template_loading = true
14
15# Enable serving of images, stylesheets, and javascripts from an asset server
16# config.action_controller.asset_host = "http://assets.example.com"
17
18# Disable delivery errors, bad email addresses will be ignored
19# config.action_mailer.raise_delivery_errors = false
toggle raw diff

extra/test_app/config/environments/test.rb

 
1# Settings specified here will take precedence over those in config/environment.rb
2
3# The test environment is used exclusively to run your application's
4# test suite. You never need to work with it otherwise. Remember that
5# your test database is "scratch space" for the test suite and is wiped
6# and recreated between test runs. Don't rely on the data there!
7config.cache_classes = true
8
9# Log error messages when you accidentally call methods on nil.
10config.whiny_nils = true
11
12# Show full error reports and disable caching
13config.action_controller.consider_all_requests_local = true
14config.action_controller.perform_caching = false
15
16# Disable request forgery protection in test environment
17config.action_controller.allow_forgery_protection = false
18
19# Tell ActionMailer not to deliver emails to the real world.
20# The :test delivery method accumulates sent emails in the
21# ActionMailer::Base.deliveries array.
22config.action_mailer.delivery_method = :test
toggle raw diff

extra/test_app/config/initializers/inflections.rb

 
1# Be sure to restart your server when you modify this file.
2
3# Add new inflection rules using the following format
4# (all these examples are active by default):
5# Inflector.inflections do |inflect|
6# inflect.plural /^(ox)$/i, '\1en'
7# inflect.singular /^(ox)en/i, '\1'
8# inflect.irregular 'person', 'people'
9# inflect.uncountable %w( fish sheep )
10# end
toggle raw diff