garnierjm-webrat 0.4.5

Sign up to get free protection for your applications and to get access to all the features.
Files changed (84) hide show
  1. data/.document +4 -0
  2. data/.gitignore +15 -0
  3. data/History.txt +360 -0
  4. data/MIT-LICENSE.txt +19 -0
  5. data/README.rdoc +85 -0
  6. data/Rakefile +217 -0
  7. data/install.rb +1 -0
  8. data/lib/webrat.rb +31 -0
  9. data/lib/webrat/core.rb +14 -0
  10. data/lib/webrat/core/configuration.rb +102 -0
  11. data/lib/webrat/core/elements/area.rb +31 -0
  12. data/lib/webrat/core/elements/element.rb +33 -0
  13. data/lib/webrat/core/elements/field.rb +411 -0
  14. data/lib/webrat/core/elements/form.rb +103 -0
  15. data/lib/webrat/core/elements/label.rb +31 -0
  16. data/lib/webrat/core/elements/link.rb +93 -0
  17. data/lib/webrat/core/elements/select_option.rb +35 -0
  18. data/lib/webrat/core/locators.rb +20 -0
  19. data/lib/webrat/core/locators/area_locator.rb +38 -0
  20. data/lib/webrat/core/locators/button_locator.rb +54 -0
  21. data/lib/webrat/core/locators/field_by_id_locator.rb +37 -0
  22. data/lib/webrat/core/locators/field_labeled_locator.rb +56 -0
  23. data/lib/webrat/core/locators/field_locator.rb +25 -0
  24. data/lib/webrat/core/locators/field_named_locator.rb +41 -0
  25. data/lib/webrat/core/locators/form_locator.rb +19 -0
  26. data/lib/webrat/core/locators/label_locator.rb +34 -0
  27. data/lib/webrat/core/locators/link_locator.rb +74 -0
  28. data/lib/webrat/core/locators/locator.rb +20 -0
  29. data/lib/webrat/core/locators/select_option_locator.rb +59 -0
  30. data/lib/webrat/core/logging.rb +24 -0
  31. data/lib/webrat/core/matchers.rb +4 -0
  32. data/lib/webrat/core/matchers/have_content.rb +73 -0
  33. data/lib/webrat/core/matchers/have_selector.rb +74 -0
  34. data/lib/webrat/core/matchers/have_tag.rb +21 -0
  35. data/lib/webrat/core/matchers/have_xpath.rb +147 -0
  36. data/lib/webrat/core/methods.rb +63 -0
  37. data/lib/webrat/core/mime.rb +29 -0
  38. data/lib/webrat/core/save_and_open_page.rb +48 -0
  39. data/lib/webrat/core/scope.rb +350 -0
  40. data/lib/webrat/core/session.rb +290 -0
  41. data/lib/webrat/core/xml.rb +115 -0
  42. data/lib/webrat/core/xml/hpricot.rb +19 -0
  43. data/lib/webrat/core/xml/nokogiri.rb +76 -0
  44. data/lib/webrat/core/xml/rexml.rb +24 -0
  45. data/lib/webrat/core_extensions/blank.rb +58 -0
  46. data/lib/webrat/core_extensions/deprecate.rb +8 -0
  47. data/lib/webrat/core_extensions/detect_mapped.rb +12 -0
  48. data/lib/webrat/core_extensions/meta_class.rb +6 -0
  49. data/lib/webrat/core_extensions/nil_to_param.rb +5 -0
  50. data/lib/webrat/core_extensions/tcp_socket.rb +27 -0
  51. data/lib/webrat/mechanize.rb +74 -0
  52. data/lib/webrat/merb.rb +9 -0
  53. data/lib/webrat/merb_multipart_support.rb +27 -0
  54. data/lib/webrat/merb_session.rb +80 -0
  55. data/lib/webrat/rack.rb +24 -0
  56. data/lib/webrat/rack_test.rb +32 -0
  57. data/lib/webrat/rails.rb +105 -0
  58. data/lib/webrat/rspec-rails.rb +10 -0
  59. data/lib/webrat/selenium.rb +81 -0
  60. data/lib/webrat/selenium/application_server_factory.rb +40 -0
  61. data/lib/webrat/selenium/application_servers.rb +5 -0
  62. data/lib/webrat/selenium/application_servers/base.rb +46 -0
  63. data/lib/webrat/selenium/application_servers/external.rb +26 -0
  64. data/lib/webrat/selenium/application_servers/merb.rb +50 -0
  65. data/lib/webrat/selenium/application_servers/rails.rb +44 -0
  66. data/lib/webrat/selenium/application_servers/sinatra.rb +37 -0
  67. data/lib/webrat/selenium/location_strategy_javascript/button.js +19 -0
  68. data/lib/webrat/selenium/location_strategy_javascript/label.js +16 -0
  69. data/lib/webrat/selenium/location_strategy_javascript/webrat.js +5 -0
  70. data/lib/webrat/selenium/location_strategy_javascript/webratlink.js +12 -0
  71. data/lib/webrat/selenium/location_strategy_javascript/webratlinkwithin.js +15 -0
  72. data/lib/webrat/selenium/location_strategy_javascript/webratselectwithoption.js +5 -0
  73. data/lib/webrat/selenium/matchers.rb +4 -0
  74. data/lib/webrat/selenium/matchers/have_content.rb +66 -0
  75. data/lib/webrat/selenium/matchers/have_selector.rb +49 -0
  76. data/lib/webrat/selenium/matchers/have_tag.rb +72 -0
  77. data/lib/webrat/selenium/matchers/have_xpath.rb +45 -0
  78. data/lib/webrat/selenium/selenium_extensions.js +6 -0
  79. data/lib/webrat/selenium/selenium_rc_server.rb +86 -0
  80. data/lib/webrat/selenium/selenium_session.rb +248 -0
  81. data/lib/webrat/selenium/silence_stream.rb +18 -0
  82. data/lib/webrat/sinatra.rb +44 -0
  83. data/vendor/selenium-server.jar +0 -0
  84. metadata +136 -0
@@ -0,0 +1,49 @@
1
+ module Webrat
2
+ module Selenium
3
+ module Matchers
4
+ class HaveSelector
5
+ def initialize(expected)
6
+ @expected = expected
7
+ end
8
+
9
+ def matches?(response)
10
+ response.session.wait_for do
11
+ response.selenium.is_element_present("css=#{@expected}")
12
+ end
13
+ rescue Webrat::TimeoutError
14
+ false
15
+ end
16
+
17
+ # ==== Returns
18
+ # String:: The failure message.
19
+ def failure_message
20
+ "expected following text to match selector #{@expected}:\n#{@document}"
21
+ end
22
+
23
+ # ==== Returns
24
+ # String:: The failure message to be displayed in negative matches.
25
+ def negative_failure_message
26
+ "expected following text to not match selector #{@expected}:\n#{@document}"
27
+ end
28
+ end
29
+
30
+ def have_selector(content)
31
+ HaveSelector.new(content)
32
+ end
33
+
34
+ # Asserts that the body of the response contains
35
+ # the supplied selector
36
+ def assert_have_selector(expected)
37
+ hs = HaveSelector.new(expected)
38
+ assert hs.matches?(response), hs.failure_message
39
+ end
40
+
41
+ # Asserts that the body of the response
42
+ # does not contain the supplied string or regepx
43
+ def assert_have_no_selector(expected)
44
+ hs = HaveSelector.new(expected)
45
+ assert !hs.matches?(response), hs.negative_failure_message
46
+ end
47
+ end
48
+ end
49
+ end
@@ -0,0 +1,72 @@
1
+ module Webrat
2
+ module Selenium
3
+ module Matchers
4
+
5
+ class HaveTag < HaveSelector #:nodoc:
6
+ # ==== Returns
7
+ # String:: The failure message.
8
+ def failure_message
9
+ "expected following output to contain a #{tag_inspect} tag:\n#{@document}"
10
+ end
11
+
12
+ # ==== Returns
13
+ # String:: The failure message to be displayed in negative matches.
14
+ def negative_failure_message
15
+ "expected following output to omit a #{tag_inspect}:\n#{@document}"
16
+ end
17
+
18
+ def tag_inspect
19
+ options = @expected.last.dup
20
+ content = options.delete(:content)
21
+
22
+ html = "<#{@expected.first}"
23
+ options.each do |k,v|
24
+ html << " #{k}='#{v}'"
25
+ end
26
+
27
+ if content
28
+ html << ">#{content}</#{@expected.first}>"
29
+ else
30
+ html << "/>"
31
+ end
32
+
33
+ html
34
+ end
35
+
36
+ def query
37
+ options = @expected.last.dup
38
+ selector = @expected.first.to_s
39
+
40
+ selector << ":contains('#{options.delete(:content)}')" if options[:content]
41
+
42
+ options.each do |key, value|
43
+ selector << "[#{key}='#{value}']"
44
+ end
45
+
46
+ Nokogiri::CSS.parse(selector).map { |ast| ast.to_xpath }
47
+ end
48
+ end
49
+
50
+ def have_tag(name, attributes = {}, &block)
51
+ HaveTag.new([name, attributes], &block)
52
+ end
53
+
54
+ alias_method :match_tag, :have_tag
55
+
56
+ # Asserts that the body of the response contains
57
+ # the supplied tag with the associated selectors
58
+ def assert_have_tag(name, attributes = {})
59
+ ht = HaveTag.new([name, attributes])
60
+ assert ht.matches?(response), ht.failure_message
61
+ end
62
+
63
+ # Asserts that the body of the response
64
+ # does not contain the supplied string or regepx
65
+ def assert_have_no_tag(name, attributes = {})
66
+ ht = HaveTag.new([name, attributes])
67
+ assert !ht.matches?(response), ht.negative_failure_message
68
+ end
69
+
70
+ end
71
+ end
72
+ end
@@ -0,0 +1,45 @@
1
+ module Webrat
2
+ module Selenium
3
+ module Matchers
4
+ class HaveXpath
5
+ def initialize(expected)
6
+ @expected = expected
7
+ end
8
+
9
+ def matches?(response)
10
+ response.session.wait_for do
11
+ response.selenium.is_element_present("xpath=#{@expected}")
12
+ end
13
+ rescue Webrat::TimeoutError
14
+ false
15
+ end
16
+
17
+ # ==== Returns
18
+ # String:: The failure message.
19
+ def failure_message
20
+ "expected following text to match xpath #{@expected}:\n#{@document}"
21
+ end
22
+
23
+ # ==== Returns
24
+ # String:: The failure message to be displayed in negative matches.
25
+ def negative_failure_message
26
+ "expected following text to not match xpath #{@expected}:\n#{@document}"
27
+ end
28
+ end
29
+
30
+ def have_xpath(xpath)
31
+ HaveXpath.new(xpath)
32
+ end
33
+
34
+ def assert_have_xpath(expected)
35
+ hs = HaveXpath.new(expected)
36
+ assert hs.matches?(response), hs.failure_message
37
+ end
38
+
39
+ def assert_have_no_xpath(expected)
40
+ hs = HaveXpath.new(expected)
41
+ assert !hs.matches?(response), hs.negative_failure_message
42
+ end
43
+ end
44
+ end
45
+ end
@@ -0,0 +1,6 @@
1
+ PatternMatcher.strategies['evalregex'] = function(regexpString) {
2
+ this.regexp = eval(regexpString);
3
+ this.matches = function(actual) {
4
+ return this.regexp.test(actual);
5
+ };
6
+ };
@@ -0,0 +1,86 @@
1
+ module Webrat
2
+ module Selenium
3
+
4
+ class SeleniumRCServer
5
+
6
+ include Webrat::Selenium::SilenceStream
7
+
8
+ def self.boot
9
+ new.boot
10
+ end
11
+
12
+ def boot
13
+ return if selenium_grid?
14
+
15
+ start
16
+ wait
17
+ stop_at_exit
18
+ end
19
+
20
+ def start
21
+ silence_stream(STDOUT) do
22
+ remote_control.start :background => true
23
+ end
24
+ end
25
+
26
+ def stop_at_exit
27
+ at_exit do
28
+ stop
29
+ end
30
+ end
31
+
32
+ def remote_control
33
+ return @remote_control if @remote_control
34
+
35
+ @remote_control = ::Selenium::RemoteControl::RemoteControl.new("0.0.0.0",
36
+ Webrat.configuration.selenium_server_port,
37
+ :timeout => Webrat.configuration.selenium_browser_startup_timeout)
38
+ @remote_control.jar_file = jar_path
39
+
40
+ return @remote_control
41
+ end
42
+
43
+ def jar_path
44
+ File.expand_path(__FILE__ + "../../../../../vendor/selenium-server.jar")
45
+ end
46
+
47
+ def selenium_grid?
48
+ Webrat.configuration.selenium_server_address
49
+ end
50
+
51
+ def wait
52
+ $stderr.print "==> Waiting for Selenium RC server on port #{Webrat.configuration.selenium_server_port}... "
53
+ wait_for_socket
54
+ $stderr.print "Ready!\n"
55
+ rescue SocketError
56
+ fail
57
+ end
58
+
59
+ def wait_for_socket
60
+ silence_stream(STDOUT) do
61
+ TCPSocket.wait_for_service_with_timeout \
62
+ :host => (Webrat.configuration.selenium_server_address || "0.0.0.0"),
63
+ :port => Webrat.configuration.selenium_server_port,
64
+ :timeout => 15 # seconds
65
+ end
66
+ end
67
+
68
+ def fail
69
+ $stderr.puts
70
+ $stderr.puts
71
+ $stderr.puts "==> Failed to boot the Selenium RC server... exiting!"
72
+ exit
73
+ end
74
+
75
+ def stop
76
+ silence_stream(STDOUT) do
77
+ ::Selenium::RemoteControl::RemoteControl.new("0.0.0.0",
78
+ Webrat.configuration.selenium_server_port,
79
+ :timeout => 5).stop
80
+ end
81
+ end
82
+
83
+ end
84
+
85
+ end
86
+ end
@@ -0,0 +1,248 @@
1
+ require "webrat/core/save_and_open_page"
2
+ require "webrat/selenium/selenium_rc_server"
3
+ require "webrat/selenium/application_server_factory"
4
+ require "webrat/selenium/application_servers/base"
5
+
6
+ module Webrat
7
+ class TimeoutError < WebratError
8
+ end
9
+
10
+ class SeleniumResponse
11
+ attr_reader :body
12
+ attr_reader :session
13
+
14
+ def initialize(session, body)
15
+ @session = session
16
+ @body = body
17
+ end
18
+
19
+ def selenium
20
+ session.selenium
21
+ end
22
+ end
23
+
24
+ class SeleniumSession
25
+ include Webrat::SaveAndOpenPage
26
+ include Webrat::Selenium::SilenceStream
27
+
28
+ def initialize(*args) # :nodoc:
29
+ end
30
+
31
+ def simulate
32
+ end
33
+
34
+ def automate
35
+ yield
36
+ end
37
+
38
+ def visit(url)
39
+ selenium.open(url)
40
+ end
41
+
42
+ webrat_deprecate :visits, :visit
43
+
44
+ def fill_in(field_identifier, options)
45
+ locator = "webrat=#{field_identifier}"
46
+ selenium.wait_for_element locator, :timeout_in_seconds => 5
47
+ selenium.type(locator, "#{options[:with]}")
48
+ end
49
+
50
+ webrat_deprecate :fills_in, :fill_in
51
+
52
+ def response
53
+ SeleniumResponse.new(self, response_body)
54
+ end
55
+
56
+ def response_body #:nodoc:
57
+ selenium.get_html_source
58
+ end
59
+
60
+ def current_url
61
+ selenium.location
62
+ end
63
+
64
+ def click_button(button_text_or_regexp = nil, options = {})
65
+ if button_text_or_regexp.is_a?(Hash) && options == {}
66
+ pattern, options = nil, button_text_or_regexp
67
+ elsif button_text_or_regexp
68
+ pattern = adjust_if_regexp(button_text_or_regexp)
69
+ end
70
+ pattern ||= '*'
71
+ locator = "button=#{pattern}"
72
+
73
+ selenium.wait_for_element locator, :timeout_in_seconds => 5
74
+ selenium.click locator
75
+ end
76
+
77
+ webrat_deprecate :clicks_button, :click_button
78
+
79
+ def click_link(link_text_or_regexp, options = {})
80
+ pattern = adjust_if_regexp(link_text_or_regexp)
81
+ locator = "webratlink=#{pattern}"
82
+ selenium.wait_for_element locator, :timeout_in_seconds => 5
83
+ selenium.click locator
84
+ end
85
+
86
+ webrat_deprecate :clicks_link, :click_link
87
+
88
+ def click_link_within(selector, link_text, options = {})
89
+ locator = "webratlinkwithin=#{selector}|#{link_text}"
90
+ selenium.wait_for_element locator, :timeout_in_seconds => 5
91
+ selenium.click locator
92
+ end
93
+
94
+ webrat_deprecate :clicks_link_within, :click_link_within
95
+
96
+ def select(option_text, options = {})
97
+ id_or_name_or_label = options[:from]
98
+
99
+ if id_or_name_or_label
100
+ select_locator = "webrat=#{id_or_name_or_label}"
101
+ else
102
+ select_locator = "webratselectwithoption=#{option_text}"
103
+ end
104
+
105
+ selenium.wait_for_element select_locator, :timeout_in_seconds => 5
106
+ selenium.select(select_locator, option_text)
107
+ end
108
+
109
+ webrat_deprecate :selects, :select
110
+
111
+ def choose(label_text)
112
+ locator = "webrat=#{label_text}"
113
+ selenium.wait_for_element locator, :timeout_in_seconds => 5
114
+ selenium.click locator
115
+ end
116
+
117
+ webrat_deprecate :chooses, :choose
118
+
119
+ def check(label_text)
120
+ locator = "webrat=#{label_text}"
121
+ selenium.wait_for_element locator, :timeout_in_seconds => 5
122
+ selenium.click locator
123
+ end
124
+ alias_method :uncheck, :check
125
+
126
+ webrat_deprecate :checks, :check
127
+
128
+ def fire_event(field_identifier, event)
129
+ locator = "webrat=#{Regexp.escape(field_identifier)}"
130
+ selenium.fire_event(locator, "#{event}")
131
+ end
132
+
133
+ def key_down(field_identifier, key_code)
134
+ locator = "webrat=#{Regexp.escape(field_identifier)}"
135
+ selenium.key_down(locator, key_code)
136
+ end
137
+
138
+ def key_up(field_identifier, key_code)
139
+ locator = "webrat=#{Regexp.escape(field_identifier)}"
140
+ selenium.key_up(locator, key_code)
141
+ end
142
+
143
+ def wait_for(params={})
144
+ timeout = params[:timeout] || 5
145
+ message = params[:message] || "Timeout exceeded"
146
+
147
+ begin_time = Time.now
148
+
149
+ while (Time.now - begin_time) < timeout
150
+ value = nil
151
+
152
+ begin
153
+ value = yield
154
+ rescue Exception => e
155
+ unless is_ignorable_wait_for_exception?(e)
156
+ raise e
157
+ end
158
+ end
159
+
160
+ return value if value
161
+
162
+ sleep 0.25
163
+ end
164
+
165
+ raise Webrat::TimeoutError.new(message + " (after #{timeout} sec)")
166
+ true
167
+ end
168
+
169
+ def selenium
170
+ return $browser if $browser
171
+ setup
172
+ $browser
173
+ end
174
+
175
+ webrat_deprecate :browser, :selenium
176
+
177
+
178
+ def save_and_open_screengrab
179
+ return unless File.exist?(saved_page_dir)
180
+
181
+ filename = "#{saved_page_dir}/webrat-#{Time.now.to_i}.png"
182
+
183
+ if $browser.chrome_backend?
184
+ $browser.capture_entire_page_screenshot(filename, '')
185
+ else
186
+ $browser.capture_screenshot(filename)
187
+ end
188
+ open_in_browser(filename)
189
+
190
+ end
191
+
192
+ protected
193
+ def is_ignorable_wait_for_exception?(exception) #:nodoc:
194
+ if defined?(::Spec::Expectations::ExpectationNotMetError)
195
+ return true if exception.class == ::Spec::Expectations::ExpectationNotMetError
196
+ end
197
+ return true if [::Selenium::CommandError, Webrat::WebratError].include?(exception.class)
198
+ return false
199
+ end
200
+
201
+ def setup #:nodoc:
202
+ Webrat::Selenium::SeleniumRCServer.boot
203
+ Webrat::Selenium::ApplicationServerFactory.app_server_instance.boot
204
+
205
+ create_browser
206
+ $browser.start
207
+
208
+ extend_selenium
209
+ define_location_strategies
210
+ $browser.window_maximize
211
+ end
212
+
213
+
214
+ def create_browser
215
+ $browser = ::Selenium::Client::Driver.new(Webrat.configuration.selenium_server_address || "localhost",
216
+ Webrat.configuration.selenium_server_port, Webrat.configuration.selenium_browser_key, "http://#{Webrat.configuration.application_address}:#{Webrat.configuration.application_port}")
217
+ $browser.set_speed(0) unless Webrat.configuration.selenium_server_address
218
+
219
+ at_exit do
220
+ silence_stream(STDOUT) do
221
+ $browser.stop
222
+ end
223
+ end
224
+ end
225
+
226
+ def adjust_if_regexp(text_or_regexp) #:nodoc:
227
+ if text_or_regexp.is_a?(Regexp)
228
+ "evalregex:#{text_or_regexp.inspect}"
229
+ else
230
+ "evalregex:/#{text_or_regexp}/"
231
+ end
232
+ end
233
+
234
+ def extend_selenium #:nodoc:
235
+ extensions_file = File.join(File.dirname(__FILE__), "selenium_extensions.js")
236
+ extenions_js = File.read(extensions_file)
237
+ selenium.get_eval(extenions_js)
238
+ end
239
+
240
+ def define_location_strategies #:nodoc:
241
+ Dir[File.join(File.dirname(__FILE__), "location_strategy_javascript", "*.js")].sort.each do |file|
242
+ strategy_js = File.read(file)
243
+ strategy_name = File.basename(file, '.js')
244
+ selenium.add_location_strategy(strategy_name, strategy_js)
245
+ end
246
+ end
247
+ end
248
+ end