rails 2.3.18 → 3.0.0.beta

Sign up to get free protection for your applications and to get access to all the features.

Potentially problematic release.


This version of rails might be problematic. Click here for more details.

Files changed (215) hide show
  1. metadata +61 -295
  2. data/CHANGELOG +0 -2193
  3. data/MIT-LICENSE +0 -20
  4. data/README +0 -243
  5. data/Rakefile +0 -365
  6. data/bin/about +0 -4
  7. data/bin/console +0 -3
  8. data/bin/dbconsole +0 -3
  9. data/bin/destroy +0 -3
  10. data/bin/generate +0 -3
  11. data/bin/performance/benchmarker +0 -3
  12. data/bin/performance/profiler +0 -3
  13. data/bin/plugin +0 -3
  14. data/bin/rails +0 -21
  15. data/bin/runner +0 -3
  16. data/bin/server +0 -3
  17. data/builtin/rails_info/rails/info.rb +0 -131
  18. data/builtin/rails_info/rails/info_controller.rb +0 -9
  19. data/builtin/rails_info/rails/info_helper.rb +0 -2
  20. data/builtin/rails_info/rails_info_controller.rb +0 -2
  21. data/configs/databases/frontbase.yml +0 -28
  22. data/configs/databases/ibm_db.yml +0 -62
  23. data/configs/databases/mysql.yml +0 -60
  24. data/configs/databases/oracle.yml +0 -39
  25. data/configs/databases/postgresql.yml +0 -51
  26. data/configs/databases/sqlite2.yml +0 -19
  27. data/configs/databases/sqlite3.yml +0 -22
  28. data/configs/empty.log +0 -0
  29. data/configs/initializers/backtrace_silencers.rb +0 -7
  30. data/configs/initializers/cookie_verification_secret.rb +0 -7
  31. data/configs/initializers/inflections.rb +0 -10
  32. data/configs/initializers/mime_types.rb +0 -5
  33. data/configs/initializers/new_rails_defaults.rb +0 -21
  34. data/configs/initializers/session_store.rb +0 -15
  35. data/configs/locales/en.yml +0 -5
  36. data/configs/routes.rb +0 -43
  37. data/configs/seeds.rb +0 -7
  38. data/dispatches/config.ru +0 -7
  39. data/dispatches/dispatch.fcgi +0 -24
  40. data/dispatches/dispatch.rb +0 -10
  41. data/dispatches/gateway.cgi +0 -97
  42. data/doc/README_FOR_APP +0 -2
  43. data/environments/boot.rb +0 -114
  44. data/environments/development.rb +0 -17
  45. data/environments/environment.rb +0 -41
  46. data/environments/production.rb +0 -28
  47. data/environments/test.rb +0 -28
  48. data/fresh_rakefile +0 -10
  49. data/helpers/application_controller.rb +0 -10
  50. data/helpers/application_helper.rb +0 -3
  51. data/helpers/performance_test.rb +0 -9
  52. data/helpers/test_helper.rb +0 -38
  53. data/html/404.html +0 -30
  54. data/html/422.html +0 -30
  55. data/html/500.html +0 -30
  56. data/html/favicon.ico +0 -0
  57. data/html/images/rails.png +0 -0
  58. data/html/index.html +0 -275
  59. data/html/javascripts/application.js +0 -2
  60. data/html/javascripts/controls.js +0 -963
  61. data/html/javascripts/dragdrop.js +0 -973
  62. data/html/javascripts/effects.js +0 -1128
  63. data/html/javascripts/prototype.js +0 -4320
  64. data/html/robots.txt +0 -5
  65. data/lib/code_statistics.rb +0 -107
  66. data/lib/commands.rb +0 -17
  67. data/lib/commands/about.rb +0 -3
  68. data/lib/commands/console.rb +0 -45
  69. data/lib/commands/dbconsole.rb +0 -87
  70. data/lib/commands/destroy.rb +0 -6
  71. data/lib/commands/generate.rb +0 -6
  72. data/lib/commands/ncgi/listener +0 -86
  73. data/lib/commands/ncgi/tracker +0 -69
  74. data/lib/commands/performance/benchmarker.rb +0 -24
  75. data/lib/commands/performance/profiler.rb +0 -50
  76. data/lib/commands/plugin.rb +0 -968
  77. data/lib/commands/runner.rb +0 -54
  78. data/lib/commands/server.rb +0 -114
  79. data/lib/commands/update.rb +0 -4
  80. data/lib/console_app.rb +0 -30
  81. data/lib/console_sandbox.rb +0 -6
  82. data/lib/console_with_helpers.rb +0 -5
  83. data/lib/dispatcher.rb +0 -24
  84. data/lib/fcgi_handler.rb +0 -239
  85. data/lib/initializer.rb +0 -1152
  86. data/lib/performance_test_help.rb +0 -5
  87. data/lib/rails/backtrace_cleaner.rb +0 -54
  88. data/lib/rails/gem_builder.rb +0 -21
  89. data/lib/rails/gem_dependency.rb +0 -317
  90. data/lib/rails/plugin.rb +0 -179
  91. data/lib/rails/plugin/loader.rb +0 -198
  92. data/lib/rails/plugin/locator.rb +0 -100
  93. data/lib/rails/rack.rb +0 -8
  94. data/lib/rails/rack/debugger.rb +0 -23
  95. data/lib/rails/rack/log_tailer.rb +0 -35
  96. data/lib/rails/rack/metal.rb +0 -51
  97. data/lib/rails/rack/static.rb +0 -46
  98. data/lib/rails/vendor_gem_source_index.rb +0 -140
  99. data/lib/rails/version.rb +0 -9
  100. data/lib/rails_generator.rb +0 -46
  101. data/lib/rails_generator/base.rb +0 -266
  102. data/lib/rails_generator/commands.rb +0 -621
  103. data/lib/rails_generator/generated_attribute.rb +0 -47
  104. data/lib/rails_generator/generators/applications/app/USAGE +0 -9
  105. data/lib/rails_generator/generators/applications/app/app_generator.rb +0 -266
  106. data/lib/rails_generator/generators/applications/app/scm/git.rb +0 -18
  107. data/lib/rails_generator/generators/applications/app/scm/scm.rb +0 -8
  108. data/lib/rails_generator/generators/applications/app/scm/svn.rb +0 -7
  109. data/lib/rails_generator/generators/applications/app/template_runner.rb +0 -401
  110. data/lib/rails_generator/generators/components/controller/USAGE +0 -30
  111. data/lib/rails_generator/generators/components/controller/controller_generator.rb +0 -43
  112. data/lib/rails_generator/generators/components/controller/templates/controller.rb +0 -7
  113. data/lib/rails_generator/generators/components/controller/templates/functional_test.rb +0 -8
  114. data/lib/rails_generator/generators/components/controller/templates/helper.rb +0 -2
  115. data/lib/rails_generator/generators/components/controller/templates/helper_test.rb +0 -4
  116. data/lib/rails_generator/generators/components/controller/templates/view.html.erb +0 -2
  117. data/lib/rails_generator/generators/components/helper/USAGE +0 -24
  118. data/lib/rails_generator/generators/components/helper/helper_generator.rb +0 -25
  119. data/lib/rails_generator/generators/components/helper/templates/helper.rb +0 -2
  120. data/lib/rails_generator/generators/components/helper/templates/helper_test.rb +0 -4
  121. data/lib/rails_generator/generators/components/integration_test/USAGE +0 -8
  122. data/lib/rails_generator/generators/components/integration_test/integration_test_generator.rb +0 -16
  123. data/lib/rails_generator/generators/components/integration_test/templates/integration_test.rb +0 -10
  124. data/lib/rails_generator/generators/components/mailer/USAGE +0 -16
  125. data/lib/rails_generator/generators/components/mailer/mailer_generator.rb +0 -30
  126. data/lib/rails_generator/generators/components/mailer/templates/fixture.erb +0 -3
  127. data/lib/rails_generator/generators/components/mailer/templates/fixture.rhtml +0 -0
  128. data/lib/rails_generator/generators/components/mailer/templates/mailer.rb +0 -15
  129. data/lib/rails_generator/generators/components/mailer/templates/unit_test.rb +0 -20
  130. data/lib/rails_generator/generators/components/mailer/templates/view.erb +0 -3
  131. data/lib/rails_generator/generators/components/mailer/templates/view.rhtml +0 -0
  132. data/lib/rails_generator/generators/components/metal/USAGE +0 -8
  133. data/lib/rails_generator/generators/components/metal/metal_generator.rb +0 -8
  134. data/lib/rails_generator/generators/components/metal/templates/metal.rb +0 -12
  135. data/lib/rails_generator/generators/components/migration/USAGE +0 -29
  136. data/lib/rails_generator/generators/components/migration/migration_generator.rb +0 -20
  137. data/lib/rails_generator/generators/components/migration/templates/migration.rb +0 -11
  138. data/lib/rails_generator/generators/components/model/USAGE +0 -27
  139. data/lib/rails_generator/generators/components/model/model_generator.rb +0 -52
  140. data/lib/rails_generator/generators/components/model/templates/fixtures.yml +0 -23
  141. data/lib/rails_generator/generators/components/model/templates/migration.rb +0 -16
  142. data/lib/rails_generator/generators/components/model/templates/model.rb +0 -5
  143. data/lib/rails_generator/generators/components/model/templates/unit_test.rb +0 -8
  144. data/lib/rails_generator/generators/components/observer/USAGE +0 -13
  145. data/lib/rails_generator/generators/components/observer/observer_generator.rb +0 -16
  146. data/lib/rails_generator/generators/components/observer/templates/observer.rb +0 -2
  147. data/lib/rails_generator/generators/components/observer/templates/unit_test.rb +0 -8
  148. data/lib/rails_generator/generators/components/performance_test/USAGE +0 -8
  149. data/lib/rails_generator/generators/components/performance_test/performance_test_generator.rb +0 -16
  150. data/lib/rails_generator/generators/components/performance_test/templates/performance_test.rb +0 -9
  151. data/lib/rails_generator/generators/components/plugin/USAGE +0 -25
  152. data/lib/rails_generator/generators/components/plugin/plugin_generator.rb +0 -39
  153. data/lib/rails_generator/generators/components/plugin/templates/MIT-LICENSE +0 -20
  154. data/lib/rails_generator/generators/components/plugin/templates/README +0 -13
  155. data/lib/rails_generator/generators/components/plugin/templates/Rakefile +0 -23
  156. data/lib/rails_generator/generators/components/plugin/templates/USAGE +0 -8
  157. data/lib/rails_generator/generators/components/plugin/templates/generator.rb +0 -8
  158. data/lib/rails_generator/generators/components/plugin/templates/init.rb +0 -1
  159. data/lib/rails_generator/generators/components/plugin/templates/install.rb +0 -1
  160. data/lib/rails_generator/generators/components/plugin/templates/plugin.rb +0 -1
  161. data/lib/rails_generator/generators/components/plugin/templates/tasks.rake +0 -4
  162. data/lib/rails_generator/generators/components/plugin/templates/test_helper.rb +0 -4
  163. data/lib/rails_generator/generators/components/plugin/templates/uninstall.rb +0 -1
  164. data/lib/rails_generator/generators/components/plugin/templates/unit_test.rb +0 -8
  165. data/lib/rails_generator/generators/components/resource/USAGE +0 -23
  166. data/lib/rails_generator/generators/components/resource/resource_generator.rb +0 -76
  167. data/lib/rails_generator/generators/components/resource/templates/controller.rb +0 -2
  168. data/lib/rails_generator/generators/components/resource/templates/functional_test.rb +0 -8
  169. data/lib/rails_generator/generators/components/resource/templates/helper.rb +0 -2
  170. data/lib/rails_generator/generators/components/resource/templates/helper_test.rb +0 -4
  171. data/lib/rails_generator/generators/components/scaffold/USAGE +0 -29
  172. data/lib/rails_generator/generators/components/scaffold/scaffold_generator.rb +0 -103
  173. data/lib/rails_generator/generators/components/scaffold/templates/controller.rb +0 -83
  174. data/lib/rails_generator/generators/components/scaffold/templates/functional_test.rb +0 -45
  175. data/lib/rails_generator/generators/components/scaffold/templates/helper.rb +0 -2
  176. data/lib/rails_generator/generators/components/scaffold/templates/helper_test.rb +0 -4
  177. data/lib/rails_generator/generators/components/scaffold/templates/layout.html.erb +0 -17
  178. data/lib/rails_generator/generators/components/scaffold/templates/style.css +0 -54
  179. data/lib/rails_generator/generators/components/scaffold/templates/view_edit.html.erb +0 -18
  180. data/lib/rails_generator/generators/components/scaffold/templates/view_index.html.erb +0 -24
  181. data/lib/rails_generator/generators/components/scaffold/templates/view_new.html.erb +0 -17
  182. data/lib/rails_generator/generators/components/scaffold/templates/view_show.html.erb +0 -10
  183. data/lib/rails_generator/generators/components/session_migration/USAGE +0 -10
  184. data/lib/rails_generator/generators/components/session_migration/session_migration_generator.rb +0 -18
  185. data/lib/rails_generator/generators/components/session_migration/templates/migration.rb +0 -16
  186. data/lib/rails_generator/lookup.rb +0 -249
  187. data/lib/rails_generator/manifest.rb +0 -53
  188. data/lib/rails_generator/options.rb +0 -150
  189. data/lib/rails_generator/scripts.rb +0 -89
  190. data/lib/rails_generator/scripts/destroy.rb +0 -29
  191. data/lib/rails_generator/scripts/generate.rb +0 -7
  192. data/lib/rails_generator/scripts/update.rb +0 -12
  193. data/lib/rails_generator/secret_key_generator.rb +0 -24
  194. data/lib/rails_generator/simple_logger.rb +0 -46
  195. data/lib/rails_generator/spec.rb +0 -44
  196. data/lib/railties_path.rb +0 -1
  197. data/lib/ruby_version_check.rb +0 -17
  198. data/lib/rubyprof_ext.rb +0 -35
  199. data/lib/source_annotation_extractor.rb +0 -102
  200. data/lib/tasks/annotations.rake +0 -20
  201. data/lib/tasks/databases.rake +0 -436
  202. data/lib/tasks/documentation.rake +0 -93
  203. data/lib/tasks/framework.rake +0 -146
  204. data/lib/tasks/gems.rake +0 -78
  205. data/lib/tasks/log.rake +0 -9
  206. data/lib/tasks/middleware.rake +0 -7
  207. data/lib/tasks/misc.rake +0 -63
  208. data/lib/tasks/rails.rb +0 -14
  209. data/lib/tasks/routes.rake +0 -18
  210. data/lib/tasks/statistics.rake +0 -17
  211. data/lib/tasks/testing.rake +0 -139
  212. data/lib/tasks/tmp.rake +0 -37
  213. data/lib/test_help.rb +0 -38
  214. data/lib/webrick_server.rb +0 -156
  215. data/railties.gemspec +0 -22
@@ -1,140 +0,0 @@
1
- require 'rubygems'
2
- require 'yaml'
3
-
4
- module Rails
5
-
6
- class VendorGemSourceIndex
7
- # VendorGemSourceIndex acts as a proxy for the Gem source index, allowing
8
- # gems to be loaded from vendor/gems. Rather than the standard gem repository format,
9
- # vendor/gems contains unpacked gems, with YAML specifications in .specification in
10
- # each gem directory.
11
- include Enumerable
12
-
13
- attr_reader :installed_source_index
14
- attr_reader :vendor_source_index
15
-
16
- @@silence_spec_warnings = false
17
-
18
- def self.silence_spec_warnings
19
- @@silence_spec_warnings
20
- end
21
-
22
- def self.silence_spec_warnings=(v)
23
- @@silence_spec_warnings = v
24
- end
25
-
26
- def initialize(installed_index, vendor_dir=Rails::GemDependency.unpacked_path)
27
- @installed_source_index = installed_index
28
- @vendor_dir = vendor_dir
29
- refresh!
30
- end
31
-
32
- def refresh!
33
- # reload the installed gems
34
- # HACK: I don't think this is needed: @installed_source_index.refresh!
35
- vendor_gems = {}
36
-
37
- # handle vendor Rails gems - they are identified by having loaded_from set to ""
38
- # we add them manually to the list, so that other gems can find them via dependencies
39
- Gem.loaded_specs.each do |n, s|
40
- next unless s.loaded_from.to_s.empty?
41
- vendor_gems[s.full_name] = s
42
- end
43
-
44
- # load specifications from vendor/gems
45
- Dir[File.join(Rails::GemDependency.unpacked_path, '*')].each do |d|
46
- dir_name = File.basename(d)
47
- dir_version = version_for_dir(dir_name)
48
- spec = load_specification(d)
49
- if spec
50
- if spec.full_name != dir_name
51
- # mismatched directory name and gem spec - produced by 2.1.0-era unpack code
52
- if dir_version
53
- # fix the spec version - this is not optimal (spec.files may be wrong)
54
- # but it's better than breaking apps. Complain to remind users to get correct specs.
55
- # use ActiveSupport::Deprecation.warn, as the logger is not set yet
56
- $stderr.puts("config.gem: Unpacked gem #{dir_name} in vendor/gems has a mismatched specification file."+
57
- " Run 'rake gems:refresh_specs' to fix this.") unless @@silence_spec_warnings
58
- spec.version = dir_version
59
- else
60
- $stderr.puts("config.gem: Unpacked gem #{dir_name} in vendor/gems is not in a versioned directory"+
61
- "(should be #{spec.full_name}).") unless @@silence_spec_warnings
62
- # continue, assume everything is OK
63
- end
64
- end
65
- else
66
- # no spec - produced by early-2008 unpack code
67
- # emulate old behavior, and complain.
68
- $stderr.puts("config.gem: Unpacked gem #{dir_name} in vendor/gems has no specification file."+
69
- " Run 'rake gems:refresh_specs' to fix this.") unless @@silence_spec_warnings
70
- if dir_version
71
- spec = Gem::Specification.new
72
- spec.version = dir_version
73
- spec.require_paths = ['lib']
74
- ext_path = File.join(d, 'ext')
75
- spec.require_paths << 'ext' if File.exist?(ext_path)
76
- spec.name = /^(.*)-[^-]+$/.match(dir_name)[1]
77
- files = ['lib']
78
- # set files to everything in lib/
79
- files += Dir[File.join(d, 'lib', '*')].map { |v| v.gsub(/^#{d}\//, '') }
80
- files += Dir[File.join(d, 'ext', '*')].map { |v| v.gsub(/^#{d}\//, '') } if ext_path
81
- spec.files = files
82
- else
83
- $stderr.puts("config.gem: Unpacked gem #{dir_name} in vendor/gems not in a versioned directory."+
84
- " Giving up.") unless @@silence_spec_warnings
85
- next
86
- end
87
- end
88
- spec.loaded_from = File.join(d, '.specification')
89
- # finally, swap out full_gem_path
90
- # it would be better to use a Gem::Specification subclass, but the YAML loads an explicit class
91
- class << spec
92
- def full_gem_path
93
- path = File.join installation_path, full_name
94
- return path if File.directory? path
95
- File.join installation_path, original_name
96
- end
97
- end
98
- vendor_gems[File.basename(d)] = spec
99
- end
100
- @vendor_source_index = Gem::SourceIndex.new(vendor_gems)
101
- end
102
-
103
- def version_for_dir(d)
104
- version = d.split('-').find { |s| s.match(/^\d(\.\d|\.\w+)*$/) }
105
- Gem::Version.new(version)
106
- end
107
-
108
- def load_specification(gem_dir)
109
- spec_file = File.join(gem_dir, '.specification')
110
- YAML.load_file(spec_file) if File.exist?(spec_file)
111
- end
112
-
113
- def find_name(*args)
114
- @installed_source_index.find_name(*args) + @vendor_source_index.find_name(*args)
115
- end
116
-
117
- def search(*args)
118
- # look for vendor gems, and then installed gems - later elements take priority
119
- @installed_source_index.search(*args) + @vendor_source_index.search(*args)
120
- end
121
-
122
- def each(&block)
123
- @vendor_source_index.each(&block)
124
- @installed_source_index.each(&block)
125
- end
126
-
127
- def add_spec(spec)
128
- @vendor_source_index.add_spec spec
129
- end
130
-
131
- def remove_spec(spec)
132
- @vendor_source_index.remove_spec spec
133
- end
134
-
135
- def size
136
- @vendor_source_index.size + @installed_source_index.size
137
- end
138
-
139
- end
140
- end
@@ -1,9 +0,0 @@
1
- module Rails
2
- module VERSION #:nodoc:
3
- MAJOR = 2
4
- MINOR = 3
5
- TINY = 18
6
-
7
- STRING = [MAJOR, MINOR, TINY].join('.')
8
- end
9
- end
@@ -1,46 +0,0 @@
1
- #--
2
- # Copyright (c) 2004 Jeremy Kemper
3
- #
4
- # Permission is hereby granted, free of charge, to any person obtaining
5
- # a copy of this software and associated documentation files (the
6
- # "Software"), to deal in the Software without restriction, including
7
- # without limitation the rights to use, copy, modify, merge, publish,
8
- # distribute, sublicense, and/or sell copies of the Software, and to
9
- # permit persons to whom the Software is furnished to do so, subject to
10
- # the following conditions:
11
- #
12
- # The above copyright notice and this permission notice shall be
13
- # included in all copies or substantial portions of the Software.
14
- #
15
- # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
16
- # EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
17
- # MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
18
- # NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
19
- # LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
20
- # OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
21
- # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
22
- #++
23
-
24
- railties = File.expand_path("..", __FILE__)
25
- $:.unshift(railties) unless $:.include?(railties)
26
-
27
- activesupport = File.expand_path("../../../activesupport/lib", __FILE__)
28
- $:.unshift(activesupport) unless $:.include?(activesupport)
29
-
30
- begin
31
- require 'active_support'
32
- rescue LoadError
33
- require 'rubygems'
34
- gem 'activesupport'
35
- end
36
-
37
- require 'rails_generator/base'
38
- require 'rails_generator/lookup'
39
- require 'rails_generator/commands'
40
-
41
- Rails::Generator::Base.send(:include, Rails::Generator::Lookup)
42
- Rails::Generator::Base.send(:include, Rails::Generator::Commands)
43
-
44
- # Set up a default logger for convenience.
45
- require 'rails_generator/simple_logger'
46
- Rails::Generator::Base.logger = Rails::Generator::SimpleLogger.new(STDOUT)
@@ -1,266 +0,0 @@
1
- require File.dirname(__FILE__) + '/options'
2
- require File.dirname(__FILE__) + '/manifest'
3
- require File.dirname(__FILE__) + '/spec'
4
- require File.dirname(__FILE__) + '/generated_attribute'
5
-
6
- module Rails
7
- # Rails::Generator is a code generation platform tailored for the Rails
8
- # web application framework. Generators are easily invoked within Rails
9
- # applications to add and remove components such as models and controllers.
10
- # New generators are easy to create and may be distributed as RubyGems,
11
- # tarballs, or Rails plugins for inclusion system-wide, per-user,
12
- # or per-application.
13
- #
14
- # For actual examples see the rails_generator/generators directory in the
15
- # Rails source (or the +railties+ directory if you have frozen the Rails
16
- # source in your application).
17
- #
18
- # Generators may subclass other generators to provide variations that
19
- # require little or no new logic but replace the template files.
20
- #
21
- # For a RubyGem, put your generator class and templates in the +lib+
22
- # directory. For a Rails plugin, make a +generators+ directory at the
23
- # root of your plugin.
24
- #
25
- # The layout of generator files can be seen in the built-in
26
- # +controller+ generator:
27
- #
28
- # generators/
29
- # components/
30
- # controller/
31
- # controller_generator.rb
32
- # templates/
33
- # controller.rb
34
- # functional_test.rb
35
- # helper.rb
36
- # view.html.erb
37
- #
38
- # The directory name (+controller+) matches the name of the generator file
39
- # (controller_generator.rb) and class (ControllerGenerator). The files
40
- # that will be copied or used as templates are stored in the +templates+
41
- # directory.
42
- #
43
- # The filenames of the templates don't matter, but choose something that
44
- # will be self-explanatory since you will be referencing these in the
45
- # +manifest+ method inside your generator subclass.
46
- #
47
- #
48
- module Generator
49
- class GeneratorError < StandardError; end
50
- class UsageError < GeneratorError; end
51
-
52
-
53
- # The base code generator is bare-bones. It sets up the source and
54
- # destination paths and tells the logger whether to keep its trap shut.
55
- #
56
- # It's useful for copying files such as stylesheets, images, or
57
- # javascripts.
58
- #
59
- # For more comprehensive template-based passive code generation with
60
- # arguments, you'll want Rails::Generator::NamedBase.
61
- #
62
- # Generators create a manifest of the actions they perform then hand
63
- # the manifest to a command which replays the actions to do the heavy
64
- # lifting (such as checking for existing files or creating directories
65
- # if needed). Create, destroy, and list commands are included. Since a
66
- # single manifest may be used by any command, creating new generators is
67
- # as simple as writing some code templates and declaring what you'd like
68
- # to do with them.
69
- #
70
- # The manifest method must be implemented by subclasses, returning a
71
- # Rails::Generator::Manifest. The +record+ method is provided as a
72
- # convenience for manifest creation. Example:
73
- #
74
- # class StylesheetGenerator < Rails::Generator::Base
75
- # def manifest
76
- # record do |m|
77
- # m.directory('public/stylesheets')
78
- # m.file('application.css', 'public/stylesheets/application.css')
79
- # end
80
- # end
81
- # end
82
- #
83
- # See Rails::Generator::Commands::Create for a list of methods available
84
- # to the manifest.
85
- class Base
86
- include Options
87
-
88
- # Declare default options for the generator. These options
89
- # are inherited to subclasses.
90
- default_options :collision => :ask, :quiet => false
91
-
92
- # A logger instance available everywhere in the generator.
93
- cattr_accessor :logger
94
-
95
- # Every generator that is dynamically looked up is tagged with a
96
- # Spec describing where it was found.
97
- class_inheritable_accessor :spec
98
-
99
- attr_reader :source_root, :destination_root, :args
100
-
101
- def initialize(runtime_args, runtime_options = {})
102
- @args = runtime_args
103
- parse!(@args, runtime_options)
104
-
105
- # Derive source and destination paths.
106
- @source_root = options[:source] || File.join(spec.path, 'templates')
107
- if options[:destination]
108
- @destination_root = options[:destination]
109
- elsif defined? ::RAILS_ROOT
110
- @destination_root = ::RAILS_ROOT
111
- end
112
-
113
- # Silence the logger if requested.
114
- logger.quiet = options[:quiet]
115
-
116
- # Raise usage error if help is requested.
117
- usage if options[:help]
118
- end
119
-
120
- # Generators must provide a manifest. Use the +record+ method to create
121
- # a new manifest and record your generator's actions.
122
- def manifest
123
- raise NotImplementedError, "No manifest for '#{spec.name}' generator."
124
- end
125
-
126
- # Return the full path from the source root for the given path.
127
- # Example for source_root = '/source':
128
- # source_path('some/path.rb') == '/source/some/path.rb'
129
- #
130
- # The given path may include a colon ':' character to indicate that
131
- # the file belongs to another generator. This notation allows any
132
- # generator to borrow files from another. Example:
133
- # source_path('model:fixture.yml') = '/model/source/path/fixture.yml'
134
- def source_path(relative_source)
135
- # Check whether we're referring to another generator's file.
136
- name, path = relative_source.split(':', 2)
137
-
138
- # If not, return the full path to our source file.
139
- if path.nil?
140
- File.join(source_root, name)
141
-
142
- # Otherwise, ask our referral for the file.
143
- else
144
- # FIXME: this is broken, though almost always true. Others'
145
- # source_root are not necessarily the templates dir.
146
- File.join(self.class.lookup(name).path, 'templates', path)
147
- end
148
- end
149
-
150
- # Return the full path from the destination root for the given path.
151
- # Example for destination_root = '/dest':
152
- # destination_path('some/path.rb') == '/dest/some/path.rb'
153
- def destination_path(relative_destination)
154
- File.join(destination_root, relative_destination)
155
- end
156
-
157
- def after_generate
158
- end
159
-
160
- protected
161
- # Convenience method for generator subclasses to record a manifest.
162
- def record
163
- Rails::Generator::Manifest.new(self) { |m| yield m }
164
- end
165
-
166
- # Override with your own usage banner.
167
- def banner
168
- "Usage: #{$0} #{spec.name} [options]"
169
- end
170
-
171
- # Read USAGE from file in generator base path.
172
- def usage_message
173
- File.read(File.join(spec.path, 'USAGE')) rescue ''
174
- end
175
- end
176
-
177
-
178
- # The base generator for named components: models, controllers, mailers,
179
- # etc. The target name is taken as the first argument and inflected to
180
- # singular, plural, class, file, and table forms for your convenience.
181
- # The remaining arguments are aliased to +actions+ as an array for
182
- # controller and mailer convenience.
183
- #
184
- # Several useful local variables and methods are populated in the
185
- # +initialize+ method. See below for a list of Attributes and
186
- # External Aliases available to both the manifest and to all templates.
187
- #
188
- # If no name is provided, the generator raises a usage error with content
189
- # optionally read from the USAGE file in the generator's base path.
190
- #
191
- # For example, the +controller+ generator takes the first argument as
192
- # the name of the class and subsequent arguments as the names of
193
- # actions to be generated:
194
- #
195
- # ./script/generate controller Article index new create
196
- #
197
- # See Rails::Generator::Base for a discussion of manifests,
198
- # Rails::Generator::Commands::Create for methods available to the manifest,
199
- # and Rails::Generator for a general discussion of generators.
200
- class NamedBase < Base
201
- attr_reader :name, :class_name, :singular_name, :plural_name, :table_name
202
- attr_reader :class_path, :file_path, :class_nesting, :class_nesting_depth
203
- alias_method :file_name, :singular_name
204
- alias_method :actions, :args
205
-
206
- def initialize(runtime_args, runtime_options = {})
207
- super
208
-
209
- # Name argument is required.
210
- usage if runtime_args.empty?
211
-
212
- @args = runtime_args.dup
213
- base_name = @args.shift
214
- assign_names!(base_name)
215
- end
216
-
217
- protected
218
- # Override with your own usage banner.
219
- def banner
220
- "Usage: #{$0} #{spec.name} #{spec.name.camelize}Name [options]"
221
- end
222
-
223
- def attributes
224
- @attributes ||= @args.collect do |attribute|
225
- Rails::Generator::GeneratedAttribute.new(*attribute.split(":"))
226
- end
227
- end
228
-
229
-
230
- private
231
- def assign_names!(name)
232
- @name = name
233
- base_name, @class_path, @file_path, @class_nesting, @class_nesting_depth = extract_modules(@name)
234
- @class_name_without_nesting, @singular_name, @plural_name = inflect_names(base_name)
235
- @table_name = (!defined?(ActiveRecord::Base) || ActiveRecord::Base.pluralize_table_names) ? plural_name : singular_name
236
- if @class_nesting.empty?
237
- @class_name = @class_name_without_nesting
238
- else
239
- @table_name = @class_nesting.underscore << "_" << @table_name
240
- @class_name = "#{@class_nesting}::#{@class_name_without_nesting}"
241
- end
242
- @table_name.gsub! '/', '_'
243
- end
244
-
245
- # Extract modules from filesystem-style or ruby-style path:
246
- # good/fun/stuff
247
- # Good::Fun::Stuff
248
- # produce the same results.
249
- def extract_modules(name)
250
- modules = name.include?('/') ? name.split('/') : name.split('::')
251
- name = modules.pop
252
- path = modules.map { |m| m.underscore }
253
- file_path = (path + [name.underscore]).join('/')
254
- nesting = modules.map { |m| m.camelize }.join('::')
255
- [name, path, file_path, nesting, modules.size]
256
- end
257
-
258
- def inflect_names(name)
259
- camel = name.camelize
260
- under = camel.underscore
261
- plural = under.pluralize
262
- [camel, under, plural]
263
- end
264
- end
265
- end
266
- end