actionpack-2.3.17-rack-upgrade 2.3.17

Sign up to get free protection for your applications and to get access to all the features.
Files changed (441) hide show
  1. data/CHANGELOG +5250 -0
  2. data/MIT-LICENSE +21 -0
  3. data/README +409 -0
  4. data/RUNNING_UNIT_TESTS +24 -0
  5. data/Rakefile +158 -0
  6. data/install.rb +30 -0
  7. data/lib/action_controller.rb +113 -0
  8. data/lib/action_controller/assertions/dom_assertions.rb +55 -0
  9. data/lib/action_controller/assertions/model_assertions.rb +21 -0
  10. data/lib/action_controller/assertions/response_assertions.rb +169 -0
  11. data/lib/action_controller/assertions/routing_assertions.rb +146 -0
  12. data/lib/action_controller/assertions/selector_assertions.rb +638 -0
  13. data/lib/action_controller/assertions/tag_assertions.rb +127 -0
  14. data/lib/action_controller/base.rb +1425 -0
  15. data/lib/action_controller/benchmarking.rb +107 -0
  16. data/lib/action_controller/caching.rb +71 -0
  17. data/lib/action_controller/caching/actions.rb +177 -0
  18. data/lib/action_controller/caching/fragments.rb +120 -0
  19. data/lib/action_controller/caching/pages.rb +152 -0
  20. data/lib/action_controller/caching/sweeper.rb +45 -0
  21. data/lib/action_controller/caching/sweeping.rb +55 -0
  22. data/lib/action_controller/cgi_ext.rb +15 -0
  23. data/lib/action_controller/cgi_ext/cookie.rb +112 -0
  24. data/lib/action_controller/cgi_ext/query_extension.rb +22 -0
  25. data/lib/action_controller/cgi_ext/stdinput.rb +24 -0
  26. data/lib/action_controller/cgi_process.rb +77 -0
  27. data/lib/action_controller/cookies.rb +197 -0
  28. data/lib/action_controller/dispatcher.rb +133 -0
  29. data/lib/action_controller/failsafe.rb +87 -0
  30. data/lib/action_controller/filters.rb +680 -0
  31. data/lib/action_controller/flash.rb +213 -0
  32. data/lib/action_controller/headers.rb +33 -0
  33. data/lib/action_controller/helpers.rb +225 -0
  34. data/lib/action_controller/http_authentication.rb +309 -0
  35. data/lib/action_controller/integration.rb +708 -0
  36. data/lib/action_controller/layout.rb +286 -0
  37. data/lib/action_controller/middleware_stack.rb +119 -0
  38. data/lib/action_controller/middlewares.rb +14 -0
  39. data/lib/action_controller/mime_responds.rb +193 -0
  40. data/lib/action_controller/mime_type.rb +212 -0
  41. data/lib/action_controller/mime_types.rb +21 -0
  42. data/lib/action_controller/params_parser.rb +77 -0
  43. data/lib/action_controller/performance_test.rb +15 -0
  44. data/lib/action_controller/polymorphic_routes.rb +189 -0
  45. data/lib/action_controller/rack_lint_patch.rb +36 -0
  46. data/lib/action_controller/record_identifier.rb +104 -0
  47. data/lib/action_controller/reloader.rb +54 -0
  48. data/lib/action_controller/request.rb +518 -0
  49. data/lib/action_controller/request_forgery_protection.rb +116 -0
  50. data/lib/action_controller/rescue.rb +183 -0
  51. data/lib/action_controller/resources.rb +682 -0
  52. data/lib/action_controller/response.rb +237 -0
  53. data/lib/action_controller/routing.rb +388 -0
  54. data/lib/action_controller/routing/builder.rb +197 -0
  55. data/lib/action_controller/routing/optimisations.rb +130 -0
  56. data/lib/action_controller/routing/recognition_optimisation.rb +167 -0
  57. data/lib/action_controller/routing/route.rb +265 -0
  58. data/lib/action_controller/routing/route_set.rb +503 -0
  59. data/lib/action_controller/routing/routing_ext.rb +49 -0
  60. data/lib/action_controller/routing/segments.rb +343 -0
  61. data/lib/action_controller/session/abstract_store.rb +276 -0
  62. data/lib/action_controller/session/cookie_store.rb +240 -0
  63. data/lib/action_controller/session/mem_cache_store.rb +60 -0
  64. data/lib/action_controller/session_management.rb +54 -0
  65. data/lib/action_controller/status_codes.rb +88 -0
  66. data/lib/action_controller/streaming.rb +181 -0
  67. data/lib/action_controller/string_coercion.rb +29 -0
  68. data/lib/action_controller/templates/rescues/_request_and_response.erb +24 -0
  69. data/lib/action_controller/templates/rescues/_trace.erb +26 -0
  70. data/lib/action_controller/templates/rescues/diagnostics.erb +11 -0
  71. data/lib/action_controller/templates/rescues/layout.erb +29 -0
  72. data/lib/action_controller/templates/rescues/missing_template.erb +2 -0
  73. data/lib/action_controller/templates/rescues/routing_error.erb +10 -0
  74. data/lib/action_controller/templates/rescues/template_error.erb +21 -0
  75. data/lib/action_controller/templates/rescues/unknown_action.erb +2 -0
  76. data/lib/action_controller/test_case.rb +209 -0
  77. data/lib/action_controller/test_process.rb +580 -0
  78. data/lib/action_controller/translation.rb +13 -0
  79. data/lib/action_controller/uploaded_file.rb +44 -0
  80. data/lib/action_controller/url_rewriter.rb +229 -0
  81. data/lib/action_controller/vendor/html-scanner.rb +16 -0
  82. data/lib/action_controller/vendor/html-scanner/html/document.rb +68 -0
  83. data/lib/action_controller/vendor/html-scanner/html/node.rb +537 -0
  84. data/lib/action_controller/vendor/html-scanner/html/sanitizer.rb +173 -0
  85. data/lib/action_controller/vendor/html-scanner/html/selector.rb +828 -0
  86. data/lib/action_controller/vendor/html-scanner/html/tokenizer.rb +105 -0
  87. data/lib/action_controller/vendor/html-scanner/html/version.rb +11 -0
  88. data/lib/action_controller/verification.rb +130 -0
  89. data/lib/action_pack.rb +24 -0
  90. data/lib/action_pack/version.rb +9 -0
  91. data/lib/action_view.rb +58 -0
  92. data/lib/action_view/base.rb +362 -0
  93. data/lib/action_view/helpers.rb +61 -0
  94. data/lib/action_view/helpers/active_record_helper.rb +305 -0
  95. data/lib/action_view/helpers/asset_tag_helper.rb +695 -0
  96. data/lib/action_view/helpers/atom_feed_helper.rb +198 -0
  97. data/lib/action_view/helpers/benchmark_helper.rb +54 -0
  98. data/lib/action_view/helpers/cache_helper.rb +39 -0
  99. data/lib/action_view/helpers/capture_helper.rb +136 -0
  100. data/lib/action_view/helpers/csrf_helper.rb +14 -0
  101. data/lib/action_view/helpers/date_helper.rb +989 -0
  102. data/lib/action_view/helpers/debug_helper.rb +38 -0
  103. data/lib/action_view/helpers/form_helper.rb +1118 -0
  104. data/lib/action_view/helpers/form_options_helper.rb +599 -0
  105. data/lib/action_view/helpers/form_tag_helper.rb +490 -0
  106. data/lib/action_view/helpers/javascript_helper.rb +208 -0
  107. data/lib/action_view/helpers/number_helper.rb +308 -0
  108. data/lib/action_view/helpers/prototype_helper.rb +1305 -0
  109. data/lib/action_view/helpers/raw_output_helper.rb +9 -0
  110. data/lib/action_view/helpers/record_identification_helper.rb +20 -0
  111. data/lib/action_view/helpers/record_tag_helper.rb +58 -0
  112. data/lib/action_view/helpers/sanitize_helper.rb +251 -0
  113. data/lib/action_view/helpers/scriptaculous_helper.rb +226 -0
  114. data/lib/action_view/helpers/tag_helper.rb +151 -0
  115. data/lib/action_view/helpers/text_helper.rb +597 -0
  116. data/lib/action_view/helpers/translation_helper.rb +67 -0
  117. data/lib/action_view/helpers/url_helper.rb +637 -0
  118. data/lib/action_view/inline_template.rb +19 -0
  119. data/lib/action_view/locale/en.yml +117 -0
  120. data/lib/action_view/partials.rb +241 -0
  121. data/lib/action_view/paths.rb +77 -0
  122. data/lib/action_view/reloadable_template.rb +117 -0
  123. data/lib/action_view/renderable.rb +109 -0
  124. data/lib/action_view/renderable_partial.rb +53 -0
  125. data/lib/action_view/template.rb +252 -0
  126. data/lib/action_view/template_error.rb +99 -0
  127. data/lib/action_view/template_handler.rb +34 -0
  128. data/lib/action_view/template_handlers.rb +48 -0
  129. data/lib/action_view/template_handlers/builder.rb +17 -0
  130. data/lib/action_view/template_handlers/erb.rb +25 -0
  131. data/lib/action_view/template_handlers/rjs.rb +13 -0
  132. data/lib/action_view/test_case.rb +162 -0
  133. data/lib/actionpack.rb +2 -0
  134. data/test/abstract_unit.rb +78 -0
  135. data/test/active_record_unit.rb +104 -0
  136. data/test/activerecord/active_record_store_test.rb +221 -0
  137. data/test/activerecord/render_partial_with_record_identification_test.rb +188 -0
  138. data/test/adv_attr_test.rb +20 -0
  139. data/test/controller/action_pack_assertions_test.rb +545 -0
  140. data/test/controller/addresses_render_test.rb +37 -0
  141. data/test/controller/assert_select_test.rb +735 -0
  142. data/test/controller/base_test.rb +217 -0
  143. data/test/controller/benchmark_test.rb +32 -0
  144. data/test/controller/caching_test.rb +743 -0
  145. data/test/controller/capture_test.rb +66 -0
  146. data/test/controller/content_type_test.rb +178 -0
  147. data/test/controller/controller_fixtures/app/controllers/admin/user_controller.rb +0 -0
  148. data/test/controller/controller_fixtures/app/controllers/user_controller.rb +0 -0
  149. data/test/controller/controller_fixtures/vendor/plugins/bad_plugin/lib/plugin_controller.rb +0 -0
  150. data/test/controller/cookie_test.rb +208 -0
  151. data/test/controller/deprecation/deprecated_base_methods_test.rb +32 -0
  152. data/test/controller/dispatcher_test.rb +144 -0
  153. data/test/controller/dom_assertions_test.rb +53 -0
  154. data/test/controller/failsafe_test.rb +60 -0
  155. data/test/controller/fake_controllers.rb +33 -0
  156. data/test/controller/fake_models.rb +19 -0
  157. data/test/controller/filter_params_test.rb +52 -0
  158. data/test/controller/filters_test.rb +885 -0
  159. data/test/controller/flash_test.rb +174 -0
  160. data/test/controller/header_test.rb +14 -0
  161. data/test/controller/helper_test.rb +224 -0
  162. data/test/controller/html-scanner/cdata_node_test.rb +15 -0
  163. data/test/controller/html-scanner/document_test.rb +148 -0
  164. data/test/controller/html-scanner/node_test.rb +89 -0
  165. data/test/controller/html-scanner/sanitizer_test.rb +281 -0
  166. data/test/controller/html-scanner/tag_node_test.rb +238 -0
  167. data/test/controller/html-scanner/text_node_test.rb +50 -0
  168. data/test/controller/html-scanner/tokenizer_test.rb +131 -0
  169. data/test/controller/http_basic_authentication_test.rb +113 -0
  170. data/test/controller/http_digest_authentication_test.rb +254 -0
  171. data/test/controller/integration_test.rb +526 -0
  172. data/test/controller/layout_test.rb +215 -0
  173. data/test/controller/localized_templates_test.rb +24 -0
  174. data/test/controller/logging_test.rb +46 -0
  175. data/test/controller/middleware_stack_test.rb +90 -0
  176. data/test/controller/mime_responds_test.rb +536 -0
  177. data/test/controller/mime_type_test.rb +93 -0
  178. data/test/controller/output_escaping_test.rb +19 -0
  179. data/test/controller/polymorphic_routes_test.rb +297 -0
  180. data/test/controller/rack_test.rb +308 -0
  181. data/test/controller/record_identifier_test.rb +139 -0
  182. data/test/controller/redirect_test.rb +285 -0
  183. data/test/controller/reloader_test.rb +125 -0
  184. data/test/controller/render_test.rb +1783 -0
  185. data/test/controller/request/json_params_parsing_test.rb +65 -0
  186. data/test/controller/request/multipart_params_parsing_test.rb +177 -0
  187. data/test/controller/request/query_string_parsing_test.rb +129 -0
  188. data/test/controller/request/test_request_test.rb +35 -0
  189. data/test/controller/request/url_encoded_params_parsing_test.rb +146 -0
  190. data/test/controller/request/xml_params_parsing_test.rb +103 -0
  191. data/test/controller/request_forgery_protection_test.rb +233 -0
  192. data/test/controller/request_test.rb +398 -0
  193. data/test/controller/rescue_test.rb +541 -0
  194. data/test/controller/resources_test.rb +1393 -0
  195. data/test/controller/routing_test.rb +2592 -0
  196. data/test/controller/selector_test.rb +628 -0
  197. data/test/controller/send_file_test.rb +171 -0
  198. data/test/controller/session/abstract_store_test.rb +64 -0
  199. data/test/controller/session/cookie_store_test.rb +354 -0
  200. data/test/controller/session/mem_cache_store_test.rb +187 -0
  201. data/test/controller/session/test_session_test.rb +58 -0
  202. data/test/controller/test_test.rb +700 -0
  203. data/test/controller/translation_test.rb +26 -0
  204. data/test/controller/url_rewriter_test.rb +395 -0
  205. data/test/controller/verification_test.rb +270 -0
  206. data/test/controller/view_paths_test.rb +141 -0
  207. data/test/controller/webservice_test.rb +273 -0
  208. data/test/fixtures/_top_level_partial.html.erb +1 -0
  209. data/test/fixtures/_top_level_partial_only.erb +1 -0
  210. data/test/fixtures/addresses/list.erb +1 -0
  211. data/test/fixtures/alternate_helpers/foo_helper.rb +3 -0
  212. data/test/fixtures/bad_customers/_bad_customer.html.erb +1 -0
  213. data/test/fixtures/companies.yml +24 -0
  214. data/test/fixtures/company.rb +10 -0
  215. data/test/fixtures/content_type/render_default_content_types_for_respond_to.rhtml +1 -0
  216. data/test/fixtures/content_type/render_default_for_rhtml.rhtml +1 -0
  217. data/test/fixtures/content_type/render_default_for_rjs.rjs +1 -0
  218. data/test/fixtures/content_type/render_default_for_rxml.rxml +1 -0
  219. data/test/fixtures/customers/_customer.html.erb +1 -0
  220. data/test/fixtures/db_definitions/sqlite.sql +49 -0
  221. data/test/fixtures/developer.rb +9 -0
  222. data/test/fixtures/developers.yml +21 -0
  223. data/test/fixtures/developers/_developer.erb +1 -0
  224. data/test/fixtures/developers_projects.yml +13 -0
  225. data/test/fixtures/failsafe/500.html +1 -0
  226. data/test/fixtures/fun/games/_game.erb +1 -0
  227. data/test/fixtures/fun/games/hello_world.erb +1 -0
  228. data/test/fixtures/fun/serious/games/_game.erb +1 -0
  229. data/test/fixtures/functional_caching/_partial.erb +3 -0
  230. data/test/fixtures/functional_caching/formatted_fragment_cached.html.erb +3 -0
  231. data/test/fixtures/functional_caching/formatted_fragment_cached.js.rjs +6 -0
  232. data/test/fixtures/functional_caching/formatted_fragment_cached.xml.builder +5 -0
  233. data/test/fixtures/functional_caching/fragment_cached.html.erb +2 -0
  234. data/test/fixtures/functional_caching/html_fragment_cached_with_partial.html.erb +1 -0
  235. data/test/fixtures/functional_caching/inline_fragment_cached.html.erb +2 -0
  236. data/test/fixtures/functional_caching/js_fragment_cached_with_partial.js.rjs +1 -0
  237. data/test/fixtures/good_customers/_good_customer.html.erb +1 -0
  238. data/test/fixtures/helpers/abc_helper.rb +5 -0
  239. data/test/fixtures/helpers/fun/games_helper.rb +3 -0
  240. data/test/fixtures/helpers/fun/pdf_helper.rb +3 -0
  241. data/test/fixtures/layout_tests/abs_path_layout.rhtml +1 -0
  242. data/test/fixtures/layout_tests/alt/hello.rhtml +1 -0
  243. data/test/fixtures/layout_tests/alt/layouts/alt.rhtml +0 -0
  244. data/test/fixtures/layout_tests/layouts/controller_name_space/nested.rhtml +1 -0
  245. data/test/fixtures/layout_tests/layouts/item.rhtml +1 -0
  246. data/test/fixtures/layout_tests/layouts/layout_test.rhtml +1 -0
  247. data/test/fixtures/layout_tests/layouts/multiple_extensions.html.erb +1 -0
  248. data/test/fixtures/layout_tests/layouts/third_party_template_library.mab +1 -0
  249. data/test/fixtures/layout_tests/views/hello.rhtml +1 -0
  250. data/test/fixtures/layouts/_column.html.erb +2 -0
  251. data/test/fixtures/layouts/block_with_layout.erb +3 -0
  252. data/test/fixtures/layouts/builder.builder +3 -0
  253. data/test/fixtures/layouts/default_html.html.erb +1 -0
  254. data/test/fixtures/layouts/partial_with_layout.erb +3 -0
  255. data/test/fixtures/layouts/standard.erb +1 -0
  256. data/test/fixtures/layouts/talk_from_action.erb +2 -0
  257. data/test/fixtures/layouts/xhr.html.erb +2 -0
  258. data/test/fixtures/layouts/yield.erb +2 -0
  259. data/test/fixtures/localized/hello_world.de.html +1 -0
  260. data/test/fixtures/localized/hello_world.en.html +1 -0
  261. data/test/fixtures/mascot.rb +3 -0
  262. data/test/fixtures/mascots.yml +4 -0
  263. data/test/fixtures/mascots/_mascot.html.erb +1 -0
  264. data/test/fixtures/multipart/binary_file +0 -0
  265. data/test/fixtures/multipart/boundary_problem_file +10 -0
  266. data/test/fixtures/multipart/bracketed_param +5 -0
  267. data/test/fixtures/multipart/empty +10 -0
  268. data/test/fixtures/multipart/hello.txt +1 -0
  269. data/test/fixtures/multipart/large_text_file +10 -0
  270. data/test/fixtures/multipart/mixed_files +0 -0
  271. data/test/fixtures/multipart/mona_lisa.jpg +0 -0
  272. data/test/fixtures/multipart/none +9 -0
  273. data/test/fixtures/multipart/single_parameter +5 -0
  274. data/test/fixtures/multipart/text_file +10 -0
  275. data/test/fixtures/override/test/hello_world.erb +1 -0
  276. data/test/fixtures/override2/layouts/test/sub.erb +1 -0
  277. data/test/fixtures/post_test/layouts/post.html.erb +1 -0
  278. data/test/fixtures/post_test/layouts/super_post.iphone.erb +1 -0
  279. data/test/fixtures/post_test/post/index.html.erb +1 -0
  280. data/test/fixtures/post_test/post/index.iphone.erb +1 -0
  281. data/test/fixtures/post_test/super_post/index.html.erb +1 -0
  282. data/test/fixtures/post_test/super_post/index.iphone.erb +1 -0
  283. data/test/fixtures/project.rb +3 -0
  284. data/test/fixtures/projects.yml +7 -0
  285. data/test/fixtures/projects/_project.erb +1 -0
  286. data/test/fixtures/public/404.html +1 -0
  287. data/test/fixtures/public/500.da.html +1 -0
  288. data/test/fixtures/public/500.html +1 -0
  289. data/test/fixtures/public/absolute/test.css +23 -0
  290. data/test/fixtures/public/absolute/test.js +63 -0
  291. data/test/fixtures/public/images/rails.png +0 -0
  292. data/test/fixtures/public/javascripts/application.js +1 -0
  293. data/test/fixtures/public/javascripts/bank.js +1 -0
  294. data/test/fixtures/public/javascripts/controls.js +1 -0
  295. data/test/fixtures/public/javascripts/dragdrop.js +1 -0
  296. data/test/fixtures/public/javascripts/effects.js +1 -0
  297. data/test/fixtures/public/javascripts/prototype.js +1 -0
  298. data/test/fixtures/public/javascripts/robber.js +1 -0
  299. data/test/fixtures/public/javascripts/subdir/subdir.js +1 -0
  300. data/test/fixtures/public/javascripts/version.1.0.js +1 -0
  301. data/test/fixtures/public/stylesheets/bank.css +1 -0
  302. data/test/fixtures/public/stylesheets/robber.css +1 -0
  303. data/test/fixtures/public/stylesheets/subdir/subdir.css +1 -0
  304. data/test/fixtures/public/stylesheets/version.1.0.css +1 -0
  305. data/test/fixtures/quiz/questions/_question.html.erb +1 -0
  306. data/test/fixtures/replies.yml +15 -0
  307. data/test/fixtures/replies/_reply.erb +1 -0
  308. data/test/fixtures/reply.rb +7 -0
  309. data/test/fixtures/respond_to/all_types_with_layout.html.erb +1 -0
  310. data/test/fixtures/respond_to/all_types_with_layout.js.rjs +1 -0
  311. data/test/fixtures/respond_to/custom_constant_handling_without_block.mobile.erb +1 -0
  312. data/test/fixtures/respond_to/iphone_with_html_response_type.html.erb +1 -0
  313. data/test/fixtures/respond_to/iphone_with_html_response_type.iphone.erb +1 -0
  314. data/test/fixtures/respond_to/layouts/missing.html.erb +1 -0
  315. data/test/fixtures/respond_to/layouts/standard.html.erb +1 -0
  316. data/test/fixtures/respond_to/layouts/standard.iphone.erb +1 -0
  317. data/test/fixtures/respond_to/using_defaults.html.erb +1 -0
  318. data/test/fixtures/respond_to/using_defaults.js.rjs +1 -0
  319. data/test/fixtures/respond_to/using_defaults.xml.builder +1 -0
  320. data/test/fixtures/respond_to/using_defaults_with_type_list.html.erb +1 -0
  321. data/test/fixtures/respond_to/using_defaults_with_type_list.js.rjs +1 -0
  322. data/test/fixtures/respond_to/using_defaults_with_type_list.xml.builder +1 -0
  323. data/test/fixtures/scope/test/modgreet.erb +1 -0
  324. data/test/fixtures/session_autoload_test/session_autoload_test/foo.rb +10 -0
  325. data/test/fixtures/shared.html.erb +1 -0
  326. data/test/fixtures/symlink_parent/symlinked_layout.erb +5 -0
  327. data/test/fixtures/test/_counter.html.erb +1 -0
  328. data/test/fixtures/test/_customer.erb +1 -0
  329. data/test/fixtures/test/_customer_counter.erb +1 -0
  330. data/test/fixtures/test/_customer_counter_with_as.erb +1 -0
  331. data/test/fixtures/test/_customer_greeting.erb +1 -0
  332. data/test/fixtures/test/_customer_with_var.erb +1 -0
  333. data/test/fixtures/test/_form.erb +1 -0
  334. data/test/fixtures/test/_from_helper.erb +1 -0
  335. data/test/fixtures/test/_hash_greeting.erb +1 -0
  336. data/test/fixtures/test/_hash_object.erb +2 -0
  337. data/test/fixtures/test/_hello.builder +1 -0
  338. data/test/fixtures/test/_labelling_form.erb +1 -0
  339. data/test/fixtures/test/_layout_for_block_with_args.html.erb +3 -0
  340. data/test/fixtures/test/_layout_for_partial.html.erb +3 -0
  341. data/test/fixtures/test/_local_inspector.html.erb +1 -0
  342. data/test/fixtures/test/_one.html.erb +1 -0
  343. data/test/fixtures/test/_partial.erb +1 -0
  344. data/test/fixtures/test/_partial.html.erb +1 -0
  345. data/test/fixtures/test/_partial.js.erb +1 -0
  346. data/test/fixtures/test/_partial_for_use_in_layout.html.erb +1 -0
  347. data/test/fixtures/test/_partial_only.erb +1 -0
  348. data/test/fixtures/test/_partial_with_only_html_version.html.erb +1 -0
  349. data/test/fixtures/test/_person.erb +2 -0
  350. data/test/fixtures/test/_raise.html.erb +1 -0
  351. data/test/fixtures/test/_two.html.erb +1 -0
  352. data/test/fixtures/test/_utf8_partial.html.erb +1 -0
  353. data/test/fixtures/test/_utf8_partial_magic.html.erb +2 -0
  354. data/test/fixtures/test/action_talk_to_layout.erb +2 -0
  355. data/test/fixtures/test/array_translation.erb +1 -0
  356. data/test/fixtures/test/calling_partial_with_layout.html.erb +1 -0
  357. data/test/fixtures/test/capturing.erb +4 -0
  358. data/test/fixtures/test/content_for.erb +2 -0
  359. data/test/fixtures/test/content_for_concatenated.erb +3 -0
  360. data/test/fixtures/test/content_for_with_parameter.erb +2 -0
  361. data/test/fixtures/test/delete_with_js.rjs +2 -0
  362. data/test/fixtures/test/dont_pick_me +1 -0
  363. data/test/fixtures/test/dot.directory/render_file_with_ivar.erb +1 -0
  364. data/test/fixtures/test/enum_rjs_test.rjs +6 -0
  365. data/test/fixtures/test/formatted_html_erb.html.erb +1 -0
  366. data/test/fixtures/test/formatted_xml_erb.builder +1 -0
  367. data/test/fixtures/test/formatted_xml_erb.html.erb +1 -0
  368. data/test/fixtures/test/formatted_xml_erb.xml.erb +1 -0
  369. data/test/fixtures/test/greeting.erb +1 -0
  370. data/test/fixtures/test/greeting.js.rjs +1 -0
  371. data/test/fixtures/test/hello.builder +4 -0
  372. data/test/fixtures/test/hello_world.da.html.erb +1 -0
  373. data/test/fixtures/test/hello_world.erb +1 -0
  374. data/test/fixtures/test/hello_world.erb~ +1 -0
  375. data/test/fixtures/test/hello_world.pt-BR.html.erb +1 -0
  376. data/test/fixtures/test/hello_world_container.builder +3 -0
  377. data/test/fixtures/test/hello_world_from_rxml.builder +4 -0
  378. data/test/fixtures/test/hello_world_with_layout_false.erb +1 -0
  379. data/test/fixtures/test/hello_xml_world.builder +11 -0
  380. data/test/fixtures/test/hyphen-ated.erb +1 -0
  381. data/test/fixtures/test/implicit_content_type.atom.builder +2 -0
  382. data/test/fixtures/test/list.erb +1 -0
  383. data/test/fixtures/test/malformed/malformed.en.html.erb~ +1 -0
  384. data/test/fixtures/test/malformed/malformed.erb~ +1 -0
  385. data/test/fixtures/test/malformed/malformed.html.erb~ +1 -0
  386. data/test/fixtures/test/nested_layout.erb +3 -0
  387. data/test/fixtures/test/non_erb_block_content_for.builder +4 -0
  388. data/test/fixtures/test/potential_conflicts.erb +4 -0
  389. data/test/fixtures/test/render_explicit_html_template.js.rjs +1 -0
  390. data/test/fixtures/test/render_file_from_template.html.erb +1 -0
  391. data/test/fixtures/test/render_file_with_ivar.erb +1 -0
  392. data/test/fixtures/test/render_file_with_locals.erb +1 -0
  393. data/test/fixtures/test/render_implicit_html_template.js.rjs +1 -0
  394. data/test/fixtures/test/render_implicit_html_template_from_xhr_request.da.html.erb +1 -0
  395. data/test/fixtures/test/render_implicit_html_template_from_xhr_request.html.erb +1 -0
  396. data/test/fixtures/test/render_implicit_js_template_without_layout.js.erb +1 -0
  397. data/test/fixtures/test/render_to_string_test.erb +1 -0
  398. data/test/fixtures/test/scoped_array_translation.erb +1 -0
  399. data/test/fixtures/test/sub_template_raise.html.erb +1 -0
  400. data/test/fixtures/test/template.erb +1 -0
  401. data/test/fixtures/test/translation.erb +1 -0
  402. data/test/fixtures/test/update_element_with_capture.erb +9 -0
  403. data/test/fixtures/test/using_layout_around_block.html.erb +1 -0
  404. data/test/fixtures/test/using_layout_around_block_with_args.html.erb +1 -0
  405. data/test/fixtures/test/utf8.html.erb +4 -0
  406. data/test/fixtures/test/utf8_magic.html.erb +5 -0
  407. data/test/fixtures/test/utf8_magic_with_bare_partial.html.erb +5 -0
  408. data/test/fixtures/topic.rb +3 -0
  409. data/test/fixtures/topics.yml +22 -0
  410. data/test/fixtures/topics/_topic.html.erb +1 -0
  411. data/test/template/active_record_helper_i18n_test.rb +51 -0
  412. data/test/template/active_record_helper_test.rb +302 -0
  413. data/test/template/asset_tag_helper_test.rb +770 -0
  414. data/test/template/atom_feed_helper_test.rb +315 -0
  415. data/test/template/benchmark_helper_test.rb +86 -0
  416. data/test/template/compiled_templates_test.rb +204 -0
  417. data/test/template/date_helper_i18n_test.rb +121 -0
  418. data/test/template/date_helper_test.rb +2603 -0
  419. data/test/template/erb_util_test.rb +36 -0
  420. data/test/template/form_helper_test.rb +1447 -0
  421. data/test/template/form_options_helper_i18n_test.rb +27 -0
  422. data/test/template/form_options_helper_test.rb +811 -0
  423. data/test/template/form_tag_helper_test.rb +356 -0
  424. data/test/template/javascript_helper_test.rb +106 -0
  425. data/test/template/number_helper_i18n_test.rb +69 -0
  426. data/test/template/number_helper_test.rb +132 -0
  427. data/test/template/prototype_helper_test.rb +639 -0
  428. data/test/template/raw_output_helper_test.rb +21 -0
  429. data/test/template/record_tag_helper_test.rb +58 -0
  430. data/test/template/render_test.rb +329 -0
  431. data/test/template/sanitize_helper_test.rb +57 -0
  432. data/test/template/scriptaculous_helper_test.rb +90 -0
  433. data/test/template/tag_helper_test.rb +98 -0
  434. data/test/template/template_test.rb +32 -0
  435. data/test/template/test_test.rb +54 -0
  436. data/test/template/text_helper_test.rb +601 -0
  437. data/test/template/translation_helper_test.rb +95 -0
  438. data/test/template/url_helper_test.rb +641 -0
  439. data/test/testing_sandbox.rb +15 -0
  440. data/test/view/test_case_test.rb +176 -0
  441. metadata +519 -0
@@ -0,0 +1,107 @@
1
+ require 'benchmark'
2
+
3
+ module ActionController #:nodoc:
4
+ # The benchmarking module times the performance of actions and reports to the logger. If the Active Record
5
+ # package has been included, a separate timing section for database calls will be added as well.
6
+ module Benchmarking #:nodoc:
7
+ def self.included(base)
8
+ base.extend(ClassMethods)
9
+
10
+ base.class_eval do
11
+ alias_method_chain :perform_action, :benchmark
12
+ alias_method_chain :render, :benchmark
13
+ end
14
+ end
15
+
16
+ module ClassMethods
17
+ # Log and benchmark the workings of a single block and silence whatever logging that may have happened inside it
18
+ # (unless <tt>use_silence</tt> is set to false).
19
+ #
20
+ # The benchmark is only recorded if the current level of the logger matches the <tt>log_level</tt>, which makes it
21
+ # easy to include benchmarking statements in production software that will remain inexpensive because the benchmark
22
+ # will only be conducted if the log level is low enough.
23
+ def benchmark(title, log_level = Logger::DEBUG, use_silence = true)
24
+ if logger && logger.level == log_level
25
+ result = nil
26
+ ms = Benchmark.ms { result = use_silence ? silence { yield } : yield }
27
+ logger.add(log_level, "#{title} (#{('%.1f' % ms)}ms)")
28
+ result
29
+ else
30
+ yield
31
+ end
32
+ end
33
+
34
+ # Silences the logger for the duration of the block.
35
+ def silence
36
+ old_logger_level, logger.level = logger.level, Logger::ERROR if logger
37
+ yield
38
+ ensure
39
+ logger.level = old_logger_level if logger
40
+ end
41
+ end
42
+
43
+ protected
44
+ def render_with_benchmark(options = nil, extra_options = {}, &block)
45
+ if logger
46
+ if Object.const_defined?("ActiveRecord") && ActiveRecord::Base.connected?
47
+ db_runtime = ActiveRecord::Base.connection.reset_runtime
48
+ end
49
+
50
+ render_output = nil
51
+ @view_runtime = Benchmark.ms { render_output = render_without_benchmark(options, extra_options, &block) }
52
+
53
+ if Object.const_defined?("ActiveRecord") && ActiveRecord::Base.connected?
54
+ @db_rt_before_render = db_runtime
55
+ @db_rt_after_render = ActiveRecord::Base.connection.reset_runtime
56
+ @view_runtime -= @db_rt_after_render
57
+ end
58
+
59
+ render_output
60
+ else
61
+ render_without_benchmark(options, extra_options, &block)
62
+ end
63
+ end
64
+
65
+ private
66
+ def perform_action_with_benchmark
67
+ if logger
68
+ ms = [Benchmark.ms { perform_action_without_benchmark }, 0.01].max
69
+ logging_view = defined?(@view_runtime)
70
+ logging_active_record = Object.const_defined?("ActiveRecord") && ActiveRecord::Base.connected?
71
+
72
+ log_message = 'Completed in %.0fms' % ms
73
+
74
+ if logging_view || logging_active_record
75
+ log_message << " ("
76
+ log_message << view_runtime if logging_view
77
+
78
+ if logging_active_record
79
+ log_message << ", " if logging_view
80
+ log_message << active_record_runtime + ")"
81
+ else
82
+ ")"
83
+ end
84
+ end
85
+
86
+ log_message << " | #{response.status}"
87
+ log_message << " [#{complete_request_uri rescue "unknown"}]"
88
+
89
+ logger.info(log_message)
90
+ response.headers["X-Runtime"] = "%.0f" % ms
91
+ else
92
+ perform_action_without_benchmark
93
+ end
94
+ end
95
+
96
+ def view_runtime
97
+ "View: %.0f" % @view_runtime
98
+ end
99
+
100
+ def active_record_runtime
101
+ db_runtime = ActiveRecord::Base.connection.reset_runtime
102
+ db_runtime += @db_rt_before_render if @db_rt_before_render
103
+ db_runtime += @db_rt_after_render if @db_rt_after_render
104
+ "DB: %.0f" % db_runtime
105
+ end
106
+ end
107
+ end
@@ -0,0 +1,71 @@
1
+ require 'fileutils'
2
+ require 'uri'
3
+ require 'set'
4
+
5
+ module ActionController #:nodoc:
6
+ # Caching is a cheap way of speeding up slow applications by keeping the result of calculations, renderings, and database calls
7
+ # around for subsequent requests. Action Controller affords you three approaches in varying levels of granularity: Page, Action, Fragment.
8
+ #
9
+ # You can read more about each approach and the sweeping assistance by clicking the modules below.
10
+ #
11
+ # Note: To turn off all caching and sweeping, set Base.perform_caching = false.
12
+ #
13
+ #
14
+ # == Caching stores
15
+ #
16
+ # All the caching stores from ActiveSupport::Cache is available to be used as backends for Action Controller caching. This setting only
17
+ # affects action and fragment caching as page caching is always written to disk.
18
+ #
19
+ # Configuration examples (MemoryStore is the default):
20
+ #
21
+ # ActionController::Base.cache_store = :memory_store
22
+ # ActionController::Base.cache_store = :file_store, "/path/to/cache/directory"
23
+ # ActionController::Base.cache_store = :drb_store, "druby://localhost:9192"
24
+ # ActionController::Base.cache_store = :mem_cache_store, "localhost"
25
+ # ActionController::Base.cache_store = :mem_cache_store, Memcached::Rails.new("localhost:11211")
26
+ # ActionController::Base.cache_store = MyOwnStore.new("parameter")
27
+ module Caching
28
+ autoload :Actions, 'action_controller/caching/actions'
29
+ autoload :Fragments, 'action_controller/caching/fragments'
30
+ autoload :Pages, 'action_controller/caching/pages'
31
+ autoload :Sweeper, 'action_controller/caching/sweeper'
32
+ autoload :Sweeping, 'action_controller/caching/sweeping'
33
+
34
+ def self.included(base) #:nodoc:
35
+ base.class_eval do
36
+ @@cache_store = nil
37
+ cattr_reader :cache_store
38
+
39
+ # Defines the storage option for cached fragments
40
+ def self.cache_store=(store_option)
41
+ @@cache_store = ActiveSupport::Cache.lookup_store(store_option)
42
+ end
43
+
44
+ include Pages, Actions, Fragments
45
+ include Sweeping if defined?(ActiveRecord)
46
+
47
+ @@perform_caching = true
48
+ cattr_accessor :perform_caching
49
+
50
+ def self.cache_configured?
51
+ perform_caching && cache_store
52
+ end
53
+ end
54
+ end
55
+
56
+ protected
57
+ # Convenience accessor
58
+ def cache(key, options = {}, &block)
59
+ if cache_configured?
60
+ cache_store.fetch(ActiveSupport::Cache.expand_cache_key(key, :controller), options, &block)
61
+ else
62
+ yield
63
+ end
64
+ end
65
+
66
+ private
67
+ def cache_configured?
68
+ self.class.cache_configured?
69
+ end
70
+ end
71
+ end
@@ -0,0 +1,177 @@
1
+ require 'set'
2
+
3
+ module ActionController #:nodoc:
4
+ module Caching
5
+ # Action caching is similar to page caching by the fact that the entire output of the response is cached, but unlike page caching,
6
+ # every request still goes through the Action Pack. The key benefit of this is that filters are run before the cache is served, which
7
+ # allows for authentication and other restrictions on whether someone is allowed to see the cache. Example:
8
+ #
9
+ # class ListsController < ApplicationController
10
+ # before_filter :authenticate, :except => :public
11
+ # caches_page :public
12
+ # caches_action :index, :show, :feed
13
+ # end
14
+ #
15
+ # In this example, the public action doesn't require authentication, so it's possible to use the faster page caching method. But both the
16
+ # show and feed action are to be shielded behind the authenticate filter, so we need to implement those as action caches.
17
+ #
18
+ # Action caching internally uses the fragment caching and an around filter to do the job. The fragment cache is named according to both
19
+ # the current host and the path. So a page that is accessed at http://david.somewhere.com/lists/show/1 will result in a fragment named
20
+ # "david.somewhere.com/lists/show/1". This allows the cacher to differentiate between "david.somewhere.com/lists/" and
21
+ # "jamis.somewhere.com/lists/" -- which is a helpful way of assisting the subdomain-as-account-key pattern.
22
+ #
23
+ # Different representations of the same resource, e.g. <tt>http://david.somewhere.com/lists</tt> and <tt>http://david.somewhere.com/lists.xml</tt>
24
+ # are treated like separate requests and so are cached separately. Keep in mind when expiring an action cache that <tt>:action => 'lists'</tt> is not the same
25
+ # as <tt>:action => 'list', :format => :xml</tt>.
26
+ #
27
+ # You can set modify the default action cache path by passing a :cache_path option. This will be passed directly to ActionCachePath.path_for. This is handy
28
+ # for actions with multiple possible routes that should be cached differently. If a block is given, it is called with the current controller instance.
29
+ #
30
+ # And you can also use :if (or :unless) to pass a Proc that specifies when the action should be cached.
31
+ #
32
+ # Finally, if you are using memcached, you can also pass :expires_in.
33
+ #
34
+ # class ListsController < ApplicationController
35
+ # before_filter :authenticate, :except => :public
36
+ # caches_page :public
37
+ # caches_action :index, :if => Proc.new { |c| !c.request.format.json? } # cache if is not a JSON request
38
+ # caches_action :show, :cache_path => { :project => 1 }, :expires_in => 1.hour
39
+ # caches_action :feed, :cache_path => Proc.new { |controller|
40
+ # controller.params[:user_id] ?
41
+ # controller.send(:user_list_url, controller.params[:user_id], controller.params[:id]) :
42
+ # controller.send(:list_url, controller.params[:id]) }
43
+ # end
44
+ #
45
+ # If you pass :layout => false, it will only cache your action content. It is useful when your layout has dynamic information.
46
+ #
47
+ module Actions
48
+ def self.included(base) #:nodoc:
49
+ base.extend(ClassMethods)
50
+ base.class_eval do
51
+ attr_accessor :rendered_action_cache, :action_cache_path
52
+ end
53
+ end
54
+
55
+ module ClassMethods
56
+ # Declares that +actions+ should be cached.
57
+ # See ActionController::Caching::Actions for details.
58
+ def caches_action(*actions)
59
+ return unless cache_configured?
60
+ options = actions.extract_options!
61
+ filter_options = { :only => actions, :if => options.delete(:if), :unless => options.delete(:unless) }
62
+
63
+ cache_filter = ActionCacheFilter.new(:layout => options.delete(:layout), :cache_path => options.delete(:cache_path), :store_options => options)
64
+ around_filter(filter_options) do |controller, action|
65
+ cache_filter.filter(controller, action)
66
+ end
67
+ end
68
+ end
69
+
70
+ protected
71
+ def expire_action(options = {})
72
+ return unless cache_configured?
73
+
74
+ if options[:action].is_a?(Array)
75
+ options[:action].dup.each do |action|
76
+ expire_fragment(ActionCachePath.path_for(self, options.merge({ :action => action }), false))
77
+ end
78
+ else
79
+ expire_fragment(ActionCachePath.path_for(self, options, false))
80
+ end
81
+ end
82
+
83
+ class ActionCacheFilter #:nodoc:
84
+ def initialize(options, &block)
85
+ @options = options
86
+ end
87
+
88
+ def filter(controller, action)
89
+ should_continue = before(controller)
90
+ action.call if should_continue
91
+ after(controller)
92
+ end
93
+
94
+ def before(controller)
95
+ cache_path = ActionCachePath.new(controller, path_options_for(controller, @options.slice(:cache_path)))
96
+ if cache = controller.read_fragment(cache_path.path, @options[:store_options])
97
+ controller.rendered_action_cache = true
98
+ set_content_type!(controller, cache_path.extension)
99
+ options = { :text => cache }
100
+ options.merge!(:layout => true) if cache_layout?
101
+ controller.__send__(:render, options)
102
+ false
103
+ else
104
+ controller.action_cache_path = cache_path
105
+ end
106
+ end
107
+
108
+ def after(controller)
109
+ return if controller.rendered_action_cache || !caching_allowed(controller)
110
+ action_content = cache_layout? ? content_for_layout(controller) : controller.response.body
111
+ controller.write_fragment(controller.action_cache_path.path, action_content, @options[:store_options])
112
+ end
113
+
114
+ private
115
+ def set_content_type!(controller, extension)
116
+ controller.response.content_type = Mime::Type.lookup_by_extension(extension).to_s if extension
117
+ end
118
+
119
+ def path_options_for(controller, options)
120
+ ((path_options = options[:cache_path]).respond_to?(:call) ? path_options.call(controller) : path_options) || {}
121
+ end
122
+
123
+ def caching_allowed(controller)
124
+ controller.request.get? && controller.response.status.to_i == 200
125
+ end
126
+
127
+ def cache_layout?
128
+ @options[:layout] == false
129
+ end
130
+
131
+ def content_for_layout(controller)
132
+ controller.response.layout && controller.response.template.instance_variable_get('@cached_content_for_layout')
133
+ end
134
+ end
135
+
136
+ class ActionCachePath
137
+ attr_reader :path, :extension
138
+
139
+ class << self
140
+ def path_for(controller, options, infer_extension = true)
141
+ new(controller, options, infer_extension).path
142
+ end
143
+ end
144
+
145
+ # When true, infer_extension will look up the cache path extension from the request's path & format.
146
+ # This is desirable when reading and writing the cache, but not when expiring the cache -
147
+ # expire_action should expire the same files regardless of the request format.
148
+ def initialize(controller, options = {}, infer_extension = true)
149
+ if infer_extension
150
+ extract_extension(controller.request)
151
+ options = options.reverse_merge(:format => @extension) if options.is_a?(Hash)
152
+ end
153
+
154
+ path = controller.url_for(options).split('://').last
155
+ normalize!(path)
156
+ add_extension!(path, @extension)
157
+ @path = URI.unescape(path)
158
+ end
159
+
160
+ private
161
+ def normalize!(path)
162
+ path << 'index' if path[-1] == ?/
163
+ end
164
+
165
+ def add_extension!(path, extension)
166
+ path << ".#{extension}" if extension and !path.ends_with?(extension)
167
+ end
168
+
169
+ def extract_extension(request)
170
+ # Don't want just what comes after the last '.' to accommodate multi part extensions
171
+ # such as tar.gz.
172
+ @extension = request.path[/^[^.]+\.(.+)$/, 1] || request.cache_format
173
+ end
174
+ end
175
+ end
176
+ end
177
+ end
@@ -0,0 +1,120 @@
1
+ module ActionController #:nodoc:
2
+ module Caching
3
+ # Fragment caching is used for caching various blocks within templates without caching the entire action as a whole. This is useful when
4
+ # certain elements of an action change frequently or depend on complicated state while other parts rarely change or can be shared amongst multiple
5
+ # parties. The caching is done using the cache helper available in the Action View. A template with caching might look something like:
6
+ #
7
+ # <b>Hello <%= @name %></b>
8
+ # <% cache do %>
9
+ # All the topics in the system:
10
+ # <%= render :partial => "topic", :collection => Topic.find(:all) %>
11
+ # <% end %>
12
+ #
13
+ # This cache will bind to the name of the action that called it, so if this code was part of the view for the topics/list action, you would
14
+ # be able to invalidate it using <tt>expire_fragment(:controller => "topics", :action => "list")</tt>.
15
+ #
16
+ # This default behavior is of limited use if you need to cache multiple fragments per action or if the action itself is cached using
17
+ # <tt>caches_action</tt>, so we also have the option to qualify the name of the cached fragment with something like:
18
+ #
19
+ # <% cache(:action => "list", :action_suffix => "all_topics") do %>
20
+ #
21
+ # That would result in a name such as "/topics/list/all_topics", avoiding conflicts with the action cache and with any fragments that use a
22
+ # different suffix. Note that the URL doesn't have to really exist or be callable - the url_for system is just used to generate unique
23
+ # cache names that we can refer to when we need to expire the cache.
24
+ #
25
+ # The expiration call for this example is:
26
+ #
27
+ # expire_fragment(:controller => "topics", :action => "list", :action_suffix => "all_topics")
28
+ module Fragments
29
+ # Given a key (as described in <tt>expire_fragment</tt>), returns a key suitable for use in reading,
30
+ # writing, or expiring a cached fragment. If the key is a hash, the generated key is the return
31
+ # value of url_for on that hash (without the protocol). All keys are prefixed with "views/" and uses
32
+ # ActiveSupport::Cache.expand_cache_key for the expansion.
33
+ def fragment_cache_key(key)
34
+ ActiveSupport::Cache.expand_cache_key(key.is_a?(Hash) ? url_for(key).split("://").last : key, :views)
35
+ end
36
+
37
+ def fragment_for(buffer, name = {}, options = nil, &block) #:nodoc:
38
+ if perform_caching
39
+ if cache = read_fragment(name, options)
40
+ buffer.safe_concat(cache.html_safe)
41
+ else
42
+ pos = buffer.length
43
+ block.call
44
+ write_fragment(name, buffer[pos..-1], options)
45
+ end
46
+ else
47
+ block.call
48
+ end
49
+ end
50
+
51
+ # Writes <tt>content</tt> to the location signified by <tt>key</tt> (see <tt>expire_fragment</tt> for acceptable formats)
52
+ def write_fragment(key, content, options = nil)
53
+ return content unless cache_configured?
54
+
55
+ self.class.benchmark "Cached fragment miss: #{key}" do
56
+ key = fragment_cache_key(key)
57
+ content = content.html_safe.to_str if content.respond_to?(:html_safe)
58
+ cache_store.write(key, content, options)
59
+ end
60
+
61
+ content
62
+ end
63
+
64
+ # Reads a cached fragment from the location signified by <tt>key</tt> (see <tt>expire_fragment</tt> for acceptable formats)
65
+ def read_fragment(key, options = nil)
66
+ return unless cache_configured?
67
+
68
+ key = fragment_cache_key(key)
69
+ self.class.benchmark "Cached fragment hit: #{key}" do
70
+ result = cache_store.read(key, options)
71
+ result.respond_to?(:html_safe) ? result.html_safe : result
72
+ end
73
+ end
74
+
75
+ # Check if a cached fragment from the location signified by <tt>key</tt> exists (see <tt>expire_fragment</tt> for acceptable formats)
76
+ def fragment_exist?(key, options = nil)
77
+ return unless cache_configured?
78
+
79
+ key = fragment_cache_key(key)
80
+
81
+ self.class.benchmark "Cached fragment exists?: #{key}" do
82
+ cache_store.exist?(key, options)
83
+ end
84
+ end
85
+
86
+ # Removes fragments from the cache.
87
+ #
88
+ # +key+ can take one of three forms:
89
+ # * String - This would normally take the form of a path, like
90
+ # <tt>"pages/45/notes"</tt>.
91
+ # * Hash - Treated as an implicit call to +url_for+, like
92
+ # <tt>{:controller => "pages", :action => "notes", :id => 45}</tt>
93
+ # * Regexp - Will remove any fragment that matches, so
94
+ # <tt>%r{pages/\d*/notes}</tt> might remove all notes. Make sure you
95
+ # don't use anchors in the regex (<tt>^</tt> or <tt>$</tt>) because
96
+ # the actual filename matched looks like
97
+ # <tt>./cache/filename/path.cache</tt>. Note: Regexp expiration is
98
+ # only supported on caches that can iterate over all keys (unlike
99
+ # memcached).
100
+ #
101
+ # +options+ is passed through to the cache store's <tt>delete</tt>
102
+ # method (or <tt>delete_matched</tt>, for Regexp keys.)
103
+ def expire_fragment(key, options = nil)
104
+ return unless cache_configured?
105
+
106
+ key = key.is_a?(Regexp) ? key : fragment_cache_key(key)
107
+
108
+ if key.is_a?(Regexp)
109
+ self.class.benchmark "Expired fragments matching: #{key.source}" do
110
+ cache_store.delete_matched(key, options)
111
+ end
112
+ else
113
+ self.class.benchmark "Expired fragment: #{key}" do
114
+ cache_store.delete(key, options)
115
+ end
116
+ end
117
+ end
118
+ end
119
+ end
120
+ end