griddleware 0.1.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (72) hide show
  1. data/.document +5 -0
  2. data/.gitignore +21 -0
  3. data/LICENSE +20 -0
  4. data/README.rdoc +17 -0
  5. data/Rakefile +54 -0
  6. data/VERSION +1 -0
  7. data/griddleware.gemspec +139 -0
  8. data/lib/griddleware/browser_helper.rb +11 -0
  9. data/lib/griddleware/grid_image.rb +32 -0
  10. data/lib/griddleware.rb +2 -0
  11. data/test/fixtures/baboon.jpg +0 -0
  12. data/test/helper.rb +52 -0
  13. data/test/rails_helper.rb +4 -0
  14. data/test/rails_root/README +243 -0
  15. data/test/rails_root/Rakefile +10 -0
  16. data/test/rails_root/app/controllers/application_controller.rb +10 -0
  17. data/test/rails_root/app/controllers/documents_controller.rb +18 -0
  18. data/test/rails_root/app/helpers/application_helper.rb +3 -0
  19. data/test/rails_root/app/models/document.rb +16 -0
  20. data/test/rails_root/app/views/documents/index.html.erb +5 -0
  21. data/test/rails_root/config/boot.rb +110 -0
  22. data/test/rails_root/config/database.yml +22 -0
  23. data/test/rails_root/config/environment.rb +46 -0
  24. data/test/rails_root/config/environments/development.rb +23 -0
  25. data/test/rails_root/config/environments/production.rb +28 -0
  26. data/test/rails_root/config/environments/test.rb +28 -0
  27. data/test/rails_root/config/initializers/backtrace_silencers.rb +7 -0
  28. data/test/rails_root/config/initializers/griddle.rb +4 -0
  29. data/test/rails_root/config/initializers/inflections.rb +10 -0
  30. data/test/rails_root/config/initializers/mime_types.rb +5 -0
  31. data/test/rails_root/config/initializers/new_rails_defaults.rb +21 -0
  32. data/test/rails_root/config/initializers/session_store.rb +15 -0
  33. data/test/rails_root/config/locales/en.yml +5 -0
  34. data/test/rails_root/config/routes.rb +46 -0
  35. data/test/rails_root/db/development.sqlite3 +0 -0
  36. data/test/rails_root/db/seeds.rb +7 -0
  37. data/test/rails_root/db/test.sqlite3 +0 -0
  38. data/test/rails_root/doc/README_FOR_APP +2 -0
  39. data/test/rails_root/log/development.log +41 -0
  40. data/test/rails_root/log/production.log +0 -0
  41. data/test/rails_root/log/server.log +0 -0
  42. data/test/rails_root/log/test.log +246 -0
  43. data/test/rails_root/public/404.html +30 -0
  44. data/test/rails_root/public/422.html +30 -0
  45. data/test/rails_root/public/500.html +30 -0
  46. data/test/rails_root/public/_index.html +275 -0
  47. data/test/rails_root/public/favicon.ico +0 -0
  48. data/test/rails_root/public/images/rails.png +0 -0
  49. data/test/rails_root/public/javascripts/application.js +2 -0
  50. data/test/rails_root/public/javascripts/controls.js +963 -0
  51. data/test/rails_root/public/javascripts/dragdrop.js +973 -0
  52. data/test/rails_root/public/javascripts/effects.js +1128 -0
  53. data/test/rails_root/public/javascripts/prototype.js +4320 -0
  54. data/test/rails_root/public/robots.txt +5 -0
  55. data/test/rails_root/script/about +4 -0
  56. data/test/rails_root/script/console +3 -0
  57. data/test/rails_root/script/dbconsole +3 -0
  58. data/test/rails_root/script/destroy +3 -0
  59. data/test/rails_root/script/generate +3 -0
  60. data/test/rails_root/script/performance/benchmarker +3 -0
  61. data/test/rails_root/script/performance/profiler +3 -0
  62. data/test/rails_root/script/plugin +3 -0
  63. data/test/rails_root/script/runner +3 -0
  64. data/test/rails_root/script/server +3 -0
  65. data/test/rails_root/test/fixtures/baboon.jpg +0 -0
  66. data/test/rails_root/test/fixtures/fox.jpg +0 -0
  67. data/test/rails_root/test/fixtures/sample.pdf +0 -0
  68. data/test/rails_root/test/integration/grid_image_test.rb +47 -0
  69. data/test/rails_root/test/performance/browsing_test.rb +9 -0
  70. data/test/rails_root/test/test_helper.rb +39 -0
  71. data/test/test_griddleware.rb +38 -0
  72. metadata +181 -0
data/.document ADDED
@@ -0,0 +1,5 @@
1
+ README.rdoc
2
+ lib/**/*.rb
3
+ bin/*
4
+ features/**/*.feature
5
+ LICENSE
data/.gitignore ADDED
@@ -0,0 +1,21 @@
1
+ ## MAC OS
2
+ .DS_Store
3
+
4
+ ## TEXTMATE
5
+ *.tmproj
6
+ tmtags
7
+
8
+ ## EMACS
9
+ *~
10
+ \#*
11
+ .\#*
12
+
13
+ ## VIM
14
+ *.swp
15
+
16
+ ## PROJECT::GENERAL
17
+ coverage
18
+ rdoc
19
+ pkg
20
+
21
+ ## PROJECT::SPECIFIC
data/LICENSE ADDED
@@ -0,0 +1,20 @@
1
+ Copyright (c) 2009 Marcus Rosentrater
2
+
3
+ Permission is hereby granted, free of charge, to any person obtaining
4
+ a copy of this software and associated documentation files (the
5
+ "Software"), to deal in the Software without restriction, including
6
+ without limitation the rights to use, copy, modify, merge, publish,
7
+ distribute, sublicense, and/or sell copies of the Software, and to
8
+ permit persons to whom the Software is furnished to do so, subject to
9
+ the following conditions:
10
+
11
+ The above copyright notice and this permission notice shall be
12
+ included in all copies or substantial portions of the Software.
13
+
14
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
15
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
16
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
17
+ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
18
+ LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
19
+ OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
20
+ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
data/README.rdoc ADDED
@@ -0,0 +1,17 @@
1
+ = griddleware
2
+
3
+ Description goes here.
4
+
5
+ == Note on Patches/Pull Requests
6
+
7
+ * Fork the project.
8
+ * Make your feature addition or bug fix.
9
+ * Add tests for it. This is important so I don't break it in a
10
+ future version unintentionally.
11
+ * Commit, do not mess with rakefile, version, or history.
12
+ (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
13
+ * Send me a pull request. Bonus points for topic branches.
14
+
15
+ == Copyright
16
+
17
+ Copyright (c) 2010 meanmarcus. See LICENSE for details.
data/Rakefile ADDED
@@ -0,0 +1,54 @@
1
+ require 'rubygems'
2
+ require 'rake'
3
+
4
+ begin
5
+ require 'jeweler'
6
+ Jeweler::Tasks.new do |gem|
7
+ gem.name = "griddleware"
8
+ gem.summary = %Q{Rack middleware to assists in serving of GridFileSystem files}
9
+ gem.description = %Q{Rack middleware to assists in serving of GridFileSystem files}
10
+ gem.email = "conradmr@gmail.com"
11
+ gem.homepage = "http://github.com/meanmarcus/griddleware"
12
+ gem.authors = ["meanmarcus", "Matt Mongeau"]
13
+ gem.add_dependency "griddle", ">= 0.1.0"
14
+ gem.add_development_dependency "thoughtbot-shoulda", ">= 0"
15
+ # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
16
+ end
17
+ Jeweler::GemcutterTasks.new
18
+ rescue LoadError
19
+ puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
20
+ end
21
+
22
+ require 'rake/testtask'
23
+ Rake::TestTask.new(:test) do |test|
24
+ test.libs << 'lib' << 'test'
25
+ test.pattern = 'test/**/test_*.rb'
26
+ test.verbose = true
27
+ end
28
+
29
+ begin
30
+ require 'rcov/rcovtask'
31
+ Rcov::RcovTask.new do |test|
32
+ test.libs << 'test'
33
+ test.pattern = 'test/**/test_*.rb'
34
+ test.verbose = true
35
+ end
36
+ rescue LoadError
37
+ task :rcov do
38
+ abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
39
+ end
40
+ end
41
+
42
+ task :test => :check_dependencies
43
+
44
+ task :default => :test
45
+
46
+ require 'rake/rdoctask'
47
+ Rake::RDocTask.new do |rdoc|
48
+ version = File.exist?('VERSION') ? File.read('VERSION') : ""
49
+
50
+ rdoc.rdoc_dir = 'rdoc'
51
+ rdoc.title = "griddleware #{version}"
52
+ rdoc.rdoc_files.include('README*')
53
+ rdoc.rdoc_files.include('lib/**/*.rb')
54
+ end
data/VERSION ADDED
@@ -0,0 +1 @@
1
+ 0.1.0
@@ -0,0 +1,139 @@
1
+ # Generated by jeweler
2
+ # DO NOT EDIT THIS FILE DIRECTLY
3
+ # Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
4
+ # -*- encoding: utf-8 -*-
5
+
6
+ Gem::Specification.new do |s|
7
+ s.name = %q{griddleware}
8
+ s.version = "0.1.0"
9
+
10
+ s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
11
+ s.authors = ["meanmarcus", "Matt Mongeau"]
12
+ s.date = %q{2010-03-15}
13
+ s.description = %q{Rack middleware to assists in serving of GridFileSystem files}
14
+ s.email = %q{conradmr@gmail.com}
15
+ s.extra_rdoc_files = [
16
+ "LICENSE",
17
+ "README.rdoc"
18
+ ]
19
+ s.files = [
20
+ ".document",
21
+ ".gitignore",
22
+ "LICENSE",
23
+ "README.rdoc",
24
+ "Rakefile",
25
+ "VERSION",
26
+ "griddleware.gemspec",
27
+ "lib/griddleware.rb",
28
+ "lib/griddleware/browser_helper.rb",
29
+ "lib/griddleware/grid_image.rb",
30
+ "test/fixtures/baboon.jpg",
31
+ "test/helper.rb",
32
+ "test/rails_helper.rb",
33
+ "test/rails_root/README",
34
+ "test/rails_root/Rakefile",
35
+ "test/rails_root/app/controllers/application_controller.rb",
36
+ "test/rails_root/app/controllers/documents_controller.rb",
37
+ "test/rails_root/app/helpers/application_helper.rb",
38
+ "test/rails_root/app/models/document.rb",
39
+ "test/rails_root/app/views/documents/index.html.erb",
40
+ "test/rails_root/config/boot.rb",
41
+ "test/rails_root/config/database.yml",
42
+ "test/rails_root/config/environment.rb",
43
+ "test/rails_root/config/environments/development.rb",
44
+ "test/rails_root/config/environments/production.rb",
45
+ "test/rails_root/config/environments/test.rb",
46
+ "test/rails_root/config/initializers/backtrace_silencers.rb",
47
+ "test/rails_root/config/initializers/griddle.rb",
48
+ "test/rails_root/config/initializers/inflections.rb",
49
+ "test/rails_root/config/initializers/mime_types.rb",
50
+ "test/rails_root/config/initializers/new_rails_defaults.rb",
51
+ "test/rails_root/config/initializers/session_store.rb",
52
+ "test/rails_root/config/locales/en.yml",
53
+ "test/rails_root/config/routes.rb",
54
+ "test/rails_root/db/development.sqlite3",
55
+ "test/rails_root/db/seeds.rb",
56
+ "test/rails_root/db/test.sqlite3",
57
+ "test/rails_root/doc/README_FOR_APP",
58
+ "test/rails_root/log/development.log",
59
+ "test/rails_root/log/production.log",
60
+ "test/rails_root/log/server.log",
61
+ "test/rails_root/log/test.log",
62
+ "test/rails_root/public/404.html",
63
+ "test/rails_root/public/422.html",
64
+ "test/rails_root/public/500.html",
65
+ "test/rails_root/public/_index.html",
66
+ "test/rails_root/public/favicon.ico",
67
+ "test/rails_root/public/images/rails.png",
68
+ "test/rails_root/public/javascripts/application.js",
69
+ "test/rails_root/public/javascripts/controls.js",
70
+ "test/rails_root/public/javascripts/dragdrop.js",
71
+ "test/rails_root/public/javascripts/effects.js",
72
+ "test/rails_root/public/javascripts/prototype.js",
73
+ "test/rails_root/public/robots.txt",
74
+ "test/rails_root/script/about",
75
+ "test/rails_root/script/console",
76
+ "test/rails_root/script/dbconsole",
77
+ "test/rails_root/script/destroy",
78
+ "test/rails_root/script/generate",
79
+ "test/rails_root/script/performance/benchmarker",
80
+ "test/rails_root/script/performance/profiler",
81
+ "test/rails_root/script/plugin",
82
+ "test/rails_root/script/runner",
83
+ "test/rails_root/script/server",
84
+ "test/rails_root/test/fixtures/baboon.jpg",
85
+ "test/rails_root/test/fixtures/fox.jpg",
86
+ "test/rails_root/test/fixtures/sample.pdf",
87
+ "test/rails_root/test/integration/grid_image_test.rb",
88
+ "test/rails_root/test/performance/browsing_test.rb",
89
+ "test/rails_root/test/test_helper.rb",
90
+ "test/test_griddleware.rb"
91
+ ]
92
+ s.homepage = %q{http://github.com/meanmarcus/griddleware}
93
+ s.rdoc_options = ["--charset=UTF-8"]
94
+ s.require_paths = ["lib"]
95
+ s.rubygems_version = %q{1.3.6}
96
+ s.summary = %q{Rack middleware to assists in serving of GridFileSystem files}
97
+ s.test_files = [
98
+ "test/helper.rb",
99
+ "test/rails_helper.rb",
100
+ "test/rails_root/app/controllers/application_controller.rb",
101
+ "test/rails_root/app/controllers/documents_controller.rb",
102
+ "test/rails_root/app/helpers/application_helper.rb",
103
+ "test/rails_root/app/models/document.rb",
104
+ "test/rails_root/config/boot.rb",
105
+ "test/rails_root/config/environment.rb",
106
+ "test/rails_root/config/environments/development.rb",
107
+ "test/rails_root/config/environments/production.rb",
108
+ "test/rails_root/config/environments/test.rb",
109
+ "test/rails_root/config/initializers/backtrace_silencers.rb",
110
+ "test/rails_root/config/initializers/griddle.rb",
111
+ "test/rails_root/config/initializers/inflections.rb",
112
+ "test/rails_root/config/initializers/mime_types.rb",
113
+ "test/rails_root/config/initializers/new_rails_defaults.rb",
114
+ "test/rails_root/config/initializers/session_store.rb",
115
+ "test/rails_root/config/routes.rb",
116
+ "test/rails_root/db/seeds.rb",
117
+ "test/rails_root/test/integration/grid_image_test.rb",
118
+ "test/rails_root/test/performance/browsing_test.rb",
119
+ "test/rails_root/test/test_helper.rb",
120
+ "test/test_griddleware.rb"
121
+ ]
122
+
123
+ if s.respond_to? :specification_version then
124
+ current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
125
+ s.specification_version = 3
126
+
127
+ if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
128
+ s.add_runtime_dependency(%q<griddle>, [">= 0.1.0"])
129
+ s.add_development_dependency(%q<thoughtbot-shoulda>, [">= 0"])
130
+ else
131
+ s.add_dependency(%q<griddle>, [">= 0.1.0"])
132
+ s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
133
+ end
134
+ else
135
+ s.add_dependency(%q<griddle>, [">= 0.1.0"])
136
+ s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
137
+ end
138
+ end
139
+
@@ -0,0 +1,11 @@
1
+ module Griddleware
2
+ module BrowserHelper
3
+
4
+ def url
5
+ "/grid/#{grid_key}"
6
+ end
7
+
8
+ end
9
+ end
10
+
11
+ Griddle::Attachment.send :include, Griddleware::BrowserHelper
@@ -0,0 +1,32 @@
1
+ module Griddleware
2
+ class GridImage
3
+
4
+ def initialize(app)
5
+ @app = app
6
+ end
7
+
8
+ def call(env)
9
+ rack = Rack::Request.new(env)
10
+ if rack.path =~ /^\/grid\/([\w]+)\/([\w]+)\/(.+)$/
11
+ owner_type, owner_id = [$1.classify, $2]
12
+ style_path = $3.split('/')
13
+ file_name = style_path.pop
14
+ name = style_path.join("/")
15
+ record = {
16
+ :name => name,
17
+ :owner_type => owner_type,
18
+ :owner_id => owner_id
19
+ }
20
+ attachment = Griddle::Attachment.attachment_for(record)
21
+ [200, {"Content-Type" => attachment.content_type}, attachment.file.read]
22
+ else
23
+ @app.call(env)
24
+ end
25
+ end
26
+
27
+ def each(&block)
28
+ @response.each(&block)
29
+ end
30
+
31
+ end
32
+ end
@@ -0,0 +1,2 @@
1
+ require 'griddleware/browser_helper'
2
+ require 'griddleware/grid_image'
Binary file
data/test/helper.rb ADDED
@@ -0,0 +1,52 @@
1
+ $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
2
+ $LOAD_PATH.unshift(File.dirname(__FILE__))
3
+
4
+ require 'rubygems'
5
+ require 'test/unit'
6
+ require 'shoulda'
7
+
8
+ gem 'activesupport', '2.3.5'
9
+ require 'active_support'
10
+
11
+ gem 'griddle', '>= 0.0.7'
12
+ require 'griddle'
13
+
14
+ require 'mongo'
15
+
16
+ require 'griddleware'
17
+
18
+ TEST_DB = 'griddleware-test' unless Object.const_defined?("TEST_DB")
19
+
20
+ db = Mongo::Connection.new.db(TEST_DB)
21
+
22
+ Griddle.database = db
23
+
24
+ class Test::Unit::TestCase
25
+
26
+ def self.all_models
27
+ Dir[File.join(File.dirname(__FILE__), 'rails_root', 'app', 'models', '*.rb')].each do |f|
28
+ require File.expand_path(f)
29
+ end
30
+ end
31
+
32
+ def teardown
33
+ Mongo::Connection.new.drop_database(TEST_DB)
34
+ end
35
+
36
+ # Make sure that each test case has a teardown
37
+ # method to clear the db after each test.
38
+ def inherited(base)
39
+ base.define_method teardown do
40
+ super
41
+ end
42
+ end
43
+ end
44
+
45
+ def style_expectations
46
+ {
47
+ :resized => "150 x 300",
48
+ :fitted => "150 x 114",
49
+ :cropped => '60 x 50',
50
+ :cropped_square => '50 x 50'
51
+ }
52
+ end
@@ -0,0 +1,4 @@
1
+ require 'helper'
2
+
3
+ ENV["RAILS_ENV"] = "test"
4
+ require File.expand_path(File.dirname(__FILE__) + "/rails_root/config/environment")
@@ -0,0 +1,243 @@
1
+ == Welcome to Rails
2
+
3
+ Rails is a web-application framework that includes everything needed to create
4
+ database-backed web applications according to the Model-View-Control pattern.
5
+
6
+ This pattern splits the view (also called the presentation) into "dumb" templates
7
+ that are primarily responsible for inserting pre-built data in between HTML tags.
8
+ The model contains the "smart" domain objects (such as Account, Product, Person,
9
+ Post) that holds all the business logic and knows how to persist themselves to
10
+ a database. The controller handles the incoming requests (such as Save New Account,
11
+ Update Product, Show Post) by manipulating the model and directing data to the view.
12
+
13
+ In Rails, the model is handled by what's called an object-relational mapping
14
+ layer entitled Active Record. This layer allows you to present the data from
15
+ database rows as objects and embellish these data objects with business logic
16
+ methods. You can read more about Active Record in
17
+ link:files/vendor/rails/activerecord/README.html.
18
+
19
+ The controller and view are handled by the Action Pack, which handles both
20
+ layers by its two parts: Action View and Action Controller. These two layers
21
+ are bundled in a single package due to their heavy interdependence. This is
22
+ unlike the relationship between the Active Record and Action Pack that is much
23
+ more separate. Each of these packages can be used independently outside of
24
+ Rails. You can read more about Action Pack in
25
+ link:files/vendor/rails/actionpack/README.html.
26
+
27
+
28
+ == Getting Started
29
+
30
+ 1. At the command prompt, start a new Rails application using the <tt>rails</tt> command
31
+ and your application name. Ex: rails myapp
32
+ 2. Change directory into myapp and start the web server: <tt>script/server</tt> (run with --help for options)
33
+ 3. Go to http://localhost:3000/ and get "Welcome aboard: You're riding the Rails!"
34
+ 4. Follow the guidelines to start developing your application
35
+
36
+
37
+ == Web Servers
38
+
39
+ 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
40
+ with a variety of other web servers.
41
+
42
+ Mongrel is a Ruby-based webserver with a C component (which requires compilation) that is
43
+ suitable for development and deployment of Rails applications. If you have Ruby Gems installed,
44
+ getting up and running with mongrel is as easy as: <tt>gem install mongrel</tt>.
45
+ More info at: http://mongrel.rubyforge.org
46
+
47
+ Say other Ruby web servers like Thin and Ebb or regular web servers like Apache or LiteSpeed or
48
+ Lighttpd or IIS. The Ruby web servers are run through Rack and the latter can either be setup to use
49
+ FCGI or proxy to a pack of Mongrels/Thin/Ebb servers.
50
+
51
+ == Apache .htaccess example for FCGI/CGI
52
+
53
+ # General Apache options
54
+ AddHandler fastcgi-script .fcgi
55
+ AddHandler cgi-script .cgi
56
+ Options +FollowSymLinks +ExecCGI
57
+
58
+ # If you don't want Rails to look in certain directories,
59
+ # use the following rewrite rules so that Apache won't rewrite certain requests
60
+ #
61
+ # Example:
62
+ # RewriteCond %{REQUEST_URI} ^/notrails.*
63
+ # RewriteRule .* - [L]
64
+
65
+ # Redirect all requests not available on the filesystem to Rails
66
+ # By default the cgi dispatcher is used which is very slow
67
+ #
68
+ # For better performance replace the dispatcher with the fastcgi one
69
+ #
70
+ # Example:
71
+ # RewriteRule ^(.*)$ dispatch.fcgi [QSA,L]
72
+ RewriteEngine On
73
+
74
+ # If your Rails application is accessed via an Alias directive,
75
+ # then you MUST also set the RewriteBase in this htaccess file.
76
+ #
77
+ # Example:
78
+ # Alias /myrailsapp /path/to/myrailsapp/public
79
+ # RewriteBase /myrailsapp
80
+
81
+ RewriteRule ^$ index.html [QSA]
82
+ RewriteRule ^([^.]+)$ $1.html [QSA]
83
+ RewriteCond %{REQUEST_FILENAME} !-f
84
+ RewriteRule ^(.*)$ dispatch.cgi [QSA,L]
85
+
86
+ # In case Rails experiences terminal errors
87
+ # Instead of displaying this message you can supply a file here which will be rendered instead
88
+ #
89
+ # Example:
90
+ # ErrorDocument 500 /500.html
91
+
92
+ ErrorDocument 500 "<h2>Application error</h2>Rails application failed to start properly"
93
+
94
+
95
+ == Debugging Rails
96
+
97
+ Sometimes your application goes wrong. Fortunately there are a lot of tools that
98
+ will help you debug it and get it back on the rails.
99
+
100
+ First area to check is the application log files. Have "tail -f" commands running
101
+ on the server.log and development.log. Rails will automatically display debugging
102
+ and runtime information to these files. Debugging info will also be shown in the
103
+ browser on requests from 127.0.0.1.
104
+
105
+ You can also log your own messages directly into the log file from your code using
106
+ the Ruby logger class from inside your controllers. Example:
107
+
108
+ class WeblogController < ActionController::Base
109
+ def destroy
110
+ @weblog = Weblog.find(params[:id])
111
+ @weblog.destroy
112
+ logger.info("#{Time.now} Destroyed Weblog ID ##{@weblog.id}!")
113
+ end
114
+ end
115
+
116
+ The result will be a message in your log file along the lines of:
117
+
118
+ Mon Oct 08 14:22:29 +1000 2007 Destroyed Weblog ID #1
119
+
120
+ More information on how to use the logger is at http://www.ruby-doc.org/core/
121
+
122
+ Also, Ruby documentation can be found at http://www.ruby-lang.org/ including:
123
+
124
+ * The Learning Ruby (Pickaxe) Book: http://www.ruby-doc.org/docs/ProgrammingRuby/
125
+ * Learn to Program: http://pine.fm/LearnToProgram/ (a beginners guide)
126
+
127
+ These two online (and free) books will bring you up to speed on the Ruby language
128
+ and also on programming in general.
129
+
130
+
131
+ == Debugger
132
+
133
+ Debugger support is available through the debugger command when you start your Mongrel or
134
+ Webrick server with --debugger. This means that you can break out of execution at any point
135
+ in the code, investigate and change the model, AND then resume execution!
136
+ You need to install ruby-debug to run the server in debugging mode. With gems, use 'gem install ruby-debug'
137
+ Example:
138
+
139
+ class WeblogController < ActionController::Base
140
+ def index
141
+ @posts = Post.find(:all)
142
+ debugger
143
+ end
144
+ end
145
+
146
+ So the controller will accept the action, run the first line, then present you
147
+ with a IRB prompt in the server window. Here you can do things like:
148
+
149
+ >> @posts.inspect
150
+ => "[#<Post:0x14a6be8 @attributes={\"title\"=>nil, \"body\"=>nil, \"id\"=>\"1\"}>,
151
+ #<Post:0x14a6620 @attributes={\"title\"=>\"Rails you know!\", \"body\"=>\"Only ten..\", \"id\"=>\"2\"}>]"
152
+ >> @posts.first.title = "hello from a debugger"
153
+ => "hello from a debugger"
154
+
155
+ ...and even better is that you can examine how your runtime objects actually work:
156
+
157
+ >> f = @posts.first
158
+ => #<Post:0x13630c4 @attributes={"title"=>nil, "body"=>nil, "id"=>"1"}>
159
+ >> f.
160
+ Display all 152 possibilities? (y or n)
161
+
162
+ Finally, when you're ready to resume execution, you enter "cont"
163
+
164
+
165
+ == Console
166
+
167
+ You can interact with the domain model by starting the console through <tt>script/console</tt>.
168
+ Here you'll have all parts of the application configured, just like it is when the
169
+ application is running. You can inspect domain models, change values, and save to the
170
+ database. Starting the script without arguments will launch it in the development environment.
171
+ Passing an argument will specify a different environment, like <tt>script/console production</tt>.
172
+
173
+ To reload your controllers and models after launching the console run <tt>reload!</tt>
174
+
175
+ == dbconsole
176
+
177
+ You can go to the command line of your database directly through <tt>script/dbconsole</tt>.
178
+ You would be connected to the database with the credentials defined in database.yml.
179
+ Starting the script without arguments will connect you to the development database. Passing an
180
+ argument will connect you to a different database, like <tt>script/dbconsole production</tt>.
181
+ Currently works for mysql, postgresql and sqlite.
182
+
183
+ == Description of Contents
184
+
185
+ app
186
+ Holds all the code that's specific to this particular application.
187
+
188
+ app/controllers
189
+ Holds controllers that should be named like weblogs_controller.rb for
190
+ automated URL mapping. All controllers should descend from ApplicationController
191
+ which itself descends from ActionController::Base.
192
+
193
+ app/models
194
+ Holds models that should be named like post.rb.
195
+ Most models will descend from ActiveRecord::Base.
196
+
197
+ app/views
198
+ Holds the template files for the view that should be named like
199
+ weblogs/index.html.erb for the WeblogsController#index action. All views use eRuby
200
+ syntax.
201
+
202
+ app/views/layouts
203
+ Holds the template files for layouts to be used with views. This models the common
204
+ header/footer method of wrapping views. In your views, define a layout using the
205
+ <tt>layout :default</tt> and create a file named default.html.erb. Inside default.html.erb,
206
+ call <% yield %> to render the view using this layout.
207
+
208
+ app/helpers
209
+ Holds view helpers that should be named like weblogs_helper.rb. These are generated
210
+ for you automatically when using script/generate for controllers. Helpers can be used to
211
+ wrap functionality for your views into methods.
212
+
213
+ config
214
+ Configuration files for the Rails environment, the routing map, the database, and other dependencies.
215
+
216
+ db
217
+ Contains the database schema in schema.rb. db/migrate contains all
218
+ the sequence of Migrations for your schema.
219
+
220
+ doc
221
+ This directory is where your application documentation will be stored when generated
222
+ using <tt>rake doc:app</tt>
223
+
224
+ lib
225
+ Application specific libraries. Basically, any kind of custom code that doesn't
226
+ belong under controllers, models, or helpers. This directory is in the load path.
227
+
228
+ public
229
+ The directory available for the web server. Contains subdirectories for images, stylesheets,
230
+ and javascripts. Also contains the dispatchers and the default HTML files. This should be
231
+ set as the DOCUMENT_ROOT of your web server.
232
+
233
+ script
234
+ Helper scripts for automation and generation.
235
+
236
+ test
237
+ Unit and functional tests along with fixtures. When using the script/generate scripts, template
238
+ test files will be generated for you and placed in this directory.
239
+
240
+ vendor
241
+ External libraries that the application depends on. Also includes the plugins subdirectory.
242
+ If the app has frozen rails, those gems also go here, under vendor/rails/.
243
+ This directory is in the load path.
@@ -0,0 +1,10 @@
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
+
4
+ require(File.join(File.dirname(__FILE__), 'config', 'boot'))
5
+
6
+ require 'rake'
7
+ require 'rake/testtask'
8
+ require 'rake/rdoctask'
9
+
10
+ require 'tasks/rails'
@@ -0,0 +1,10 @@
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
+
4
+ class ApplicationController < ActionController::Base
5
+ helper :all # include all helpers, all the time
6
+ protect_from_forgery # See ActionController::RequestForgeryProtection for details
7
+
8
+ # Scrub sensitive parameters from your log
9
+ # filter_parameter_logging :password
10
+ end
@@ -0,0 +1,18 @@
1
+ class DocumentsController < ApplicationController
2
+
3
+ before_filter :destroy_database
4
+
5
+ def index
6
+ file_path = File.join(File.dirname(__FILE__), '..', '..', 'test', 'fixtures', 'baboon.jpg')
7
+ @document = Document.new
8
+ @document.image = File.new(file_path, 'rb')
9
+ @document.save_attached_files
10
+ end
11
+
12
+ def destroy_database
13
+ Griddle.database.collections.each do |coll|
14
+ coll.remove
15
+ end
16
+ end
17
+
18
+ end
@@ -0,0 +1,3 @@
1
+ # Methods added to this helper will be available to all templates in the application.
2
+ module ApplicationHelper
3
+ end