page_magic 1.2.8 → 2.0.2
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- data/.rubocop.yml +23 -4
- data/.simplecov +5 -3
- data/.zsh_config +6 -0
- data/Dockerfile +11 -0
- data/Gemfile +13 -13
- data/Gemfile.lock +136 -148
- data/Makefile +17 -0
- data/README.md +26 -5
- data/Rakefile +12 -2
- data/VERSION +1 -1
- data/circle.yml +3 -1
- data/lib/active_support/core_ext/object/to_query.rb +84 -0
- data/lib/page_magic.rb +31 -24
- data/lib/page_magic/class_methods.rb +5 -2
- data/lib/page_magic/comparator.rb +37 -0
- data/lib/page_magic/comparator/fuzzy.rb +23 -0
- data/lib/page_magic/comparator/literal.rb +22 -0
- data/lib/page_magic/comparator/null.rb +26 -0
- data/lib/page_magic/comparator/parameter_map.rb +52 -0
- data/lib/page_magic/driver.rb +3 -0
- data/lib/page_magic/drivers.rb +6 -5
- data/lib/page_magic/drivers/poltergeist.rb +2 -0
- data/lib/page_magic/drivers/rack_test.rb +3 -1
- data/lib/page_magic/drivers/selenium.rb +4 -2
- data/lib/page_magic/element.rb +35 -15
- data/lib/page_magic/element/locators.rb +8 -5
- data/lib/page_magic/element/not_found.rb +38 -0
- data/lib/page_magic/element/query.rb +21 -20
- data/lib/page_magic/element/query/multiple_results.rb +21 -0
- data/lib/page_magic/element/query/prefetched_result.rb +26 -0
- data/lib/page_magic/element/query/single_result.rb +20 -0
- data/lib/page_magic/element/selector.rb +41 -16
- data/lib/page_magic/element/selector/methods.rb +18 -0
- data/lib/page_magic/element/selector/model.rb +21 -0
- data/lib/page_magic/element_context.rb +7 -21
- data/lib/page_magic/element_definition_builder.rb +20 -24
- data/lib/page_magic/elements.rb +65 -69
- data/lib/page_magic/elements/config.rb +103 -0
- data/lib/page_magic/elements/inheritance_hooks.rb +15 -0
- data/lib/page_magic/elements/types.rb +25 -0
- data/lib/page_magic/exceptions.rb +6 -1
- data/lib/page_magic/instance_methods.rb +8 -3
- data/lib/page_magic/mapping.rb +79 -0
- data/lib/page_magic/session.rb +15 -35
- data/lib/page_magic/session_methods.rb +3 -1
- data/lib/page_magic/transitions.rb +49 -0
- data/lib/page_magic/utils/string.rb +18 -0
- data/lib/page_magic/utils/url.rb +20 -0
- data/lib/page_magic/wait_methods.rb +3 -0
- data/lib/page_magic/watcher.rb +12 -17
- data/lib/page_magic/watchers.rb +31 -15
- data/page_magic.gemspec +15 -11
- data/spec/lib/active_support/core_ext/object/to_query_test.rb +78 -0
- data/spec/page_magic/class_methods_spec.rb +66 -37
- data/spec/page_magic/comparator/fuzzy_spec.rb +44 -0
- data/spec/page_magic/comparator/literal_spec.rb +41 -0
- data/spec/page_magic/comparator/null_spec.rb +35 -0
- data/spec/page_magic/comparator/parameter_map_spec.rb +75 -0
- data/spec/page_magic/driver_spec.rb +26 -28
- data/spec/page_magic/drivers/poltergeist_spec.rb +6 -7
- data/spec/page_magic/drivers/rack_test_spec.rb +6 -9
- data/spec/page_magic/drivers/selenium_spec.rb +11 -12
- data/spec/page_magic/drivers_spec.rb +38 -29
- data/spec/page_magic/element/locators_spec.rb +28 -25
- data/spec/page_magic/element/not_found_spec.rb +24 -0
- data/spec/page_magic/element/query/multiple_results_spec.rb +14 -0
- data/spec/page_magic/element/query/single_result_spec.rb +21 -0
- data/spec/page_magic/element/query_spec.rb +26 -45
- data/spec/page_magic/element/selector_spec.rb +120 -110
- data/spec/page_magic/element_context_spec.rb +47 -87
- data/spec/page_magic/element_definition_builder_spec.rb +14 -71
- data/spec/page_magic/element_spec.rb +256 -0
- data/spec/page_magic/elements/config_spec.rb +203 -0
- data/spec/page_magic/elements_spec.rb +90 -134
- data/spec/page_magic/instance_methods_spec.rb +65 -63
- data/spec/page_magic/mapping_spec.rb +181 -0
- data/spec/page_magic/session_methods_spec.rb +29 -25
- data/spec/page_magic/session_spec.rb +109 -199
- data/spec/page_magic/transitions_spec.rb +43 -0
- data/spec/page_magic/utils/string_spec.rb +29 -0
- data/spec/page_magic/utils/url_spec.rb +9 -0
- data/spec/page_magic/wait_methods_spec.rb +16 -22
- data/spec/page_magic/watcher_spec.rb +22 -0
- data/spec/page_magic/watchers_spec.rb +58 -62
- data/spec/page_magic_spec.rb +37 -29
- data/spec/spec_helper.rb +9 -2
- data/spec/support/shared_contexts.rb +3 -1
- data/spec/support/shared_examples.rb +17 -17
- metadata +101 -48
- data/lib/page_magic/element/query_builder.rb +0 -48
- data/lib/page_magic/element/selector_methods.rb +0 -13
- data/lib/page_magic/matcher.rb +0 -121
- data/spec/element_spec.rb +0 -249
- data/spec/page_magic/element/query_builder_spec.rb +0 -108
- data/spec/page_magic/matcher_spec.rb +0 -336
- data/spec/support/shared_contexts/files_context.rb +0 -7
- data/spec/support/shared_contexts/nested_elements_html_context.rb +0 -16
- data/spec/support/shared_contexts/rack_application_context.rb +0 -9
- data/spec/support/shared_contexts/webapp_fixture_context.rb +0 -39
- data/spec/watcher_spec.rb +0 -61
@@ -0,0 +1,35 @@
|
|
1
|
+
RSpec.describe PageMagic::Comparator::Null do
|
2
|
+
describe '#fuzzy?' do
|
3
|
+
context 'when one value is fuzzy' do
|
4
|
+
it 'returns true' do
|
5
|
+
expect(described_class.new).not_to be_fuzzy
|
6
|
+
end
|
7
|
+
end
|
8
|
+
end
|
9
|
+
|
10
|
+
describe 'match?' do
|
11
|
+
it 'returns false' do
|
12
|
+
expect(described_class.new).to be_match(true)
|
13
|
+
end
|
14
|
+
end
|
15
|
+
|
16
|
+
describe '#<=>' do
|
17
|
+
context 'when other is `Null`' do
|
18
|
+
it 'is equal' do
|
19
|
+
expect(described_class.new <=> described_class.new).to be 0
|
20
|
+
end
|
21
|
+
end
|
22
|
+
|
23
|
+
context 'when other is `Fuzzy`' do
|
24
|
+
it 'is greater' do
|
25
|
+
expect(described_class.new <=> PageMagic::Comparator::Fuzzy.new(//)).to be 1
|
26
|
+
end
|
27
|
+
end
|
28
|
+
|
29
|
+
context 'when other is `Literal`' do
|
30
|
+
it 'is greater' do
|
31
|
+
expect(described_class.new <=> PageMagic::Comparator::Literal.new('/')).to be 1
|
32
|
+
end
|
33
|
+
end
|
34
|
+
end
|
35
|
+
end
|
@@ -0,0 +1,75 @@
|
|
1
|
+
RSpec.describe PageMagic::Comparator::ParameterMap do
|
2
|
+
describe '#fuzzy?' do
|
3
|
+
context 'when one value is fuzzy' do
|
4
|
+
it 'returns true' do
|
5
|
+
map = described_class.new({ param1: //, param2: '' })
|
6
|
+
expect(map).to be_fuzzy
|
7
|
+
end
|
8
|
+
end
|
9
|
+
|
10
|
+
context 'when all values are literal' do
|
11
|
+
it 'returns true' do
|
12
|
+
map = described_class.new({ param1: '', param2: '' })
|
13
|
+
expect(map).not_to be_fuzzy
|
14
|
+
end
|
15
|
+
end
|
16
|
+
end
|
17
|
+
|
18
|
+
describe '#match?' do
|
19
|
+
context 'when param has compatible params' do
|
20
|
+
it 'returns true' do
|
21
|
+
expect(described_class.new({ param: '1' })).to be_match(param: '1')
|
22
|
+
end
|
23
|
+
end
|
24
|
+
|
25
|
+
context 'when it does not have compatible params' do
|
26
|
+
it 'returns false' do
|
27
|
+
expect(described_class.new({ param: '1' })).not_to be_match(param: '2')
|
28
|
+
end
|
29
|
+
end
|
30
|
+
|
31
|
+
context 'when it does not meet all of the requirements' do
|
32
|
+
it 'returns false' do
|
33
|
+
expect(described_class.new({ param: '1', another_param: '2' })).not_to be_match(param: '1')
|
34
|
+
end
|
35
|
+
end
|
36
|
+
end
|
37
|
+
|
38
|
+
describe '#<=>' do
|
39
|
+
context 'when other is empty' do
|
40
|
+
context 'and self is empty' do
|
41
|
+
it 'is equal' do
|
42
|
+
expect(described_class.new({}) <=> described_class.new({})).to be 0
|
43
|
+
end
|
44
|
+
end
|
45
|
+
|
46
|
+
context 'self is not empty' do
|
47
|
+
it 'is greater' do
|
48
|
+
expect(described_class.new({ param: 1 }) <=> described_class.new({})).to be 1
|
49
|
+
end
|
50
|
+
end
|
51
|
+
end
|
52
|
+
|
53
|
+
context 'when other contains matchers' do
|
54
|
+
context 'when other has the same number' do
|
55
|
+
context 'and matchers are of the same type' do
|
56
|
+
it 'is equal' do
|
57
|
+
expect(described_class.new({ param: // }) <=> described_class.new({ param: // })).to be 0
|
58
|
+
end
|
59
|
+
end
|
60
|
+
|
61
|
+
context 'and has less literal matchers' do
|
62
|
+
it 'is lesser' do
|
63
|
+
expect(described_class.new({ param: '' }) <=> described_class.new({ param: // })).to be 1
|
64
|
+
end
|
65
|
+
end
|
66
|
+
end
|
67
|
+
|
68
|
+
context 'when other has the less' do
|
69
|
+
it 'is lesser' do
|
70
|
+
expect(described_class.new({ param: // }) <=> described_class.new({})).to be 1
|
71
|
+
end
|
72
|
+
end
|
73
|
+
end
|
74
|
+
end
|
75
|
+
end
|
@@ -1,41 +1,39 @@
|
|
1
|
-
|
1
|
+
# frozen_string_literal: true
|
2
2
|
|
3
|
-
|
4
|
-
describe
|
5
|
-
|
6
|
-
described_class.new
|
3
|
+
RSpec.describe PageMagic::Driver do
|
4
|
+
describe '#build' do
|
5
|
+
it 'returns the result of the block passed to the driver class constructor' do
|
6
|
+
subject = described_class.new(:custom_browser) do
|
7
|
+
:driver
|
8
|
+
end
|
9
|
+
expect(subject.build(:rack_app, browser: :custom_browser, options: {})).to eq(:driver)
|
7
10
|
end
|
8
11
|
|
9
|
-
|
10
|
-
|
11
|
-
|
12
|
-
|
13
|
-
|
14
|
-
expect(subject.build(:rack_app, browser: :custom_browser, options: :options)).to eq(:driver)
|
12
|
+
it 'passes rack app to the handler' do
|
13
|
+
subject = described_class.new(:custom_browser) do |app, options, browser|
|
14
|
+
expect(app).to eq(:rack_app)
|
15
|
+
expect(options).to eq(:options)
|
16
|
+
expect(browser).to eq(:browser)
|
15
17
|
end
|
16
18
|
|
17
|
-
|
18
|
-
|
19
|
-
|
20
|
-
expect(options).to eq(:options)
|
21
|
-
expect(browser).to eq(:browser)
|
22
|
-
end
|
19
|
+
subject.build(:rack_app, options: :options, browser: :browser)
|
20
|
+
end
|
21
|
+
end
|
23
22
|
|
24
|
-
|
25
|
-
|
23
|
+
describe '#supports?' do
|
24
|
+
subject do
|
25
|
+
described_class.new :custom_browser
|
26
26
|
end
|
27
27
|
|
28
|
-
|
29
|
-
|
30
|
-
|
31
|
-
expect(subject.support?(:custom_browser)).to eq(true)
|
32
|
-
end
|
28
|
+
context 'browser is in supported browsers' do
|
29
|
+
it 'returns true' do
|
30
|
+
expect(subject.support?(:custom_browser)).to eq(true)
|
33
31
|
end
|
32
|
+
end
|
34
33
|
|
35
|
-
|
36
|
-
|
37
|
-
|
38
|
-
end
|
34
|
+
context 'browser is not in supported browsers' do
|
35
|
+
it 'returns false' do
|
36
|
+
expect(subject.support?(:unsupported_browser)).to eq(false)
|
39
37
|
end
|
40
38
|
end
|
41
39
|
end
|
@@ -1,9 +1,8 @@
|
|
1
|
-
|
2
|
-
|
3
|
-
|
4
|
-
|
5
|
-
|
6
|
-
|
7
|
-
end
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
RSpec.describe PageMagic::Drivers::Poltergeist do
|
4
|
+
it "is capybara's poltergeist driver" do
|
5
|
+
driver = described_class.build(:app, browser: :poltergeist, options: {})
|
6
|
+
expect(driver).to be_a(Capybara::Poltergeist::Driver)
|
8
7
|
end
|
9
8
|
end
|
@@ -1,11 +1,8 @@
|
|
1
|
-
|
2
|
-
|
3
|
-
|
4
|
-
|
5
|
-
|
6
|
-
|
7
|
-
expect(driver).to be_a(Capybara::RackTest::Driver)
|
8
|
-
end
|
9
|
-
end
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
RSpec.describe PageMagic::Drivers::RackTest do
|
4
|
+
it "is capybara's rack test driver" do
|
5
|
+
driver = described_class.build(:app, browser: :rack_test, options: {})
|
6
|
+
expect(driver).to be_a(Capybara::RackTest::Driver)
|
10
7
|
end
|
11
8
|
end
|
@@ -1,16 +1,15 @@
|
|
1
|
-
|
2
|
-
module PageMagic
|
3
|
-
describe Drivers::Selenium do
|
4
|
-
subject do
|
5
|
-
described_class.build(:app, browser: :selenium, options: {})
|
6
|
-
end
|
1
|
+
# frozen_string_literal: true
|
7
2
|
|
8
|
-
|
9
|
-
|
10
|
-
|
3
|
+
RSpec.describe PageMagic::Drivers::Selenium do
|
4
|
+
subject do
|
5
|
+
described_class.build(:app, browser: :selenium, options: {})
|
6
|
+
end
|
7
|
+
|
8
|
+
it 'is selenium' do
|
9
|
+
expect(subject).to be_a(Capybara::Selenium::Driver)
|
10
|
+
end
|
11
11
|
|
12
|
-
|
13
|
-
|
14
|
-
end
|
12
|
+
it 'sets the browser option' do
|
13
|
+
expect(subject.options[:browser]).to be(:selenium)
|
15
14
|
end
|
16
15
|
end
|
@@ -1,39 +1,48 @@
|
|
1
|
-
|
2
|
-
|
3
|
-
|
4
|
-
|
5
|
-
|
6
|
-
|
7
|
-
|
8
|
-
|
9
|
-
|
10
|
-
|
11
|
-
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
RSpec.describe PageMagic::Drivers do
|
4
|
+
describe '#find' do
|
5
|
+
it 'returns the registered driver' do
|
6
|
+
drivers = described_class.new
|
7
|
+
expected_driver = PageMagic::Driver.new(:browser_driver)
|
8
|
+
|
9
|
+
drivers.register expected_driver
|
10
|
+
expect(drivers.find(:browser_driver)).to eq(expected_driver)
|
11
|
+
end
|
12
|
+
end
|
13
|
+
|
14
|
+
describe '#load' do
|
15
|
+
require 'tmpdir'
|
16
|
+
|
17
|
+
def scratch_dir
|
18
|
+
@scratch_dir ||= Dir.mktmpdir
|
12
19
|
end
|
13
20
|
|
14
|
-
|
15
|
-
|
16
|
-
|
17
|
-
|
18
|
-
|
19
|
-
def self.support? browser
|
20
|
-
true
|
21
|
-
end
|
21
|
+
let(:class_definition) do
|
22
|
+
<<-RUBY
|
23
|
+
class CustomDriver;
|
24
|
+
def self.support?(_browser)
|
25
|
+
true
|
22
26
|
end
|
23
|
-
|
27
|
+
end
|
28
|
+
RUBY
|
29
|
+
end
|
24
30
|
|
25
|
-
|
31
|
+
it 'loads the drivers in the specified path' do
|
32
|
+
File.write("#{scratch_dir}/custom_driver.rb", class_definition)
|
26
33
|
|
27
|
-
|
28
|
-
|
29
|
-
|
34
|
+
drivers = described_class.new
|
35
|
+
drivers.load(scratch_dir)
|
36
|
+
expect(drivers.find(:custom_browser)).to be(::CustomDriver)
|
30
37
|
end
|
38
|
+
end
|
31
39
|
|
32
|
-
|
33
|
-
|
34
|
-
|
35
|
-
|
36
|
-
|
40
|
+
describe '#register' do
|
41
|
+
it 'stores the driver' do
|
42
|
+
drivers = described_class.new
|
43
|
+
expected_driver = PageMagic::Driver.new(:browser_driver)
|
44
|
+
drivers.register expected_driver
|
45
|
+
expect(drivers.all).to eq([expected_driver])
|
37
46
|
end
|
38
47
|
end
|
39
48
|
end
|
@@ -1,32 +1,35 @@
|
|
1
|
-
|
2
|
-
|
3
|
-
|
4
|
-
|
5
|
-
|
6
|
-
|
7
|
-
|
8
|
-
|
9
|
-
|
10
|
-
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
RSpec.describe PageMagic::Element::Locators do
|
4
|
+
subject { element_clazz.new }
|
5
|
+
|
6
|
+
let(:element_clazz) do
|
7
|
+
Class.new do
|
8
|
+
extend(PageMagic::Elements)
|
9
|
+
include(PageMagic::Element::Locators)
|
10
|
+
end
|
11
|
+
end
|
11
12
|
|
12
|
-
|
13
|
-
|
14
|
-
|
15
|
-
|
16
|
-
|
13
|
+
describe '#element_by_name' do
|
14
|
+
it 'returns the required element' do
|
15
|
+
selector = { id: 'child' }
|
16
|
+
element_clazz.element :child1, selector
|
17
|
+
element_clazz.element :child2, id: 'child 2'
|
17
18
|
|
18
|
-
|
19
|
+
child_1_builder = PageMagic::ElementDefinitionBuilder.new(
|
20
|
+
definition_class: PageMagic::Element,
|
21
|
+
selector: PageMagic::Element::Selector.find(:id).build(:element, 'child')
|
22
|
+
)
|
19
23
|
|
20
|
-
|
21
|
-
|
24
|
+
expect(subject.element_by_name(:child1)).to eq(child_1_builder)
|
25
|
+
end
|
22
26
|
|
23
|
-
|
24
|
-
|
25
|
-
|
26
|
-
|
27
|
-
|
28
|
-
|
29
|
-
end
|
27
|
+
context 'element not found' do
|
28
|
+
it 'raises an error' do
|
29
|
+
expected_message = (described_class::ELEMENT_NOT_DEFINED_MSG % :child)
|
30
|
+
expect do
|
31
|
+
subject.element_by_name(:child)
|
32
|
+
end.to raise_exception PageMagic::ElementMissingException, expected_message
|
30
33
|
end
|
31
34
|
end
|
32
35
|
end
|
@@ -0,0 +1,24 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
describe PageMagic::Element::NotFound do
|
4
|
+
describe '#method_missing' do
|
5
|
+
it 'raises an error' do
|
6
|
+
subject = described_class.new(Exception.new('message'))
|
7
|
+
expect { subject.any_missing_method }.to raise_exception(PageMagic::ElementMissingException, 'message')
|
8
|
+
end
|
9
|
+
end
|
10
|
+
|
11
|
+
describe '#visible?' do
|
12
|
+
it 'returns false' do
|
13
|
+
subject = described_class.new(Exception.new('message'))
|
14
|
+
expect(subject.visible?).to eq(false)
|
15
|
+
end
|
16
|
+
end
|
17
|
+
|
18
|
+
describe '#present?' do
|
19
|
+
it 'returns false' do
|
20
|
+
subject = described_class.new(Exception.new('message'))
|
21
|
+
expect(subject.present?).to eq(false)
|
22
|
+
end
|
23
|
+
end
|
24
|
+
end
|
@@ -0,0 +1,14 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
RSpec.describe PageMagic::Element::Query::MultipleResults do
|
4
|
+
describe '#find' do
|
5
|
+
context 'when multiple results found' do
|
6
|
+
it 'returns an array' do
|
7
|
+
element = PageMagic::Element.load('<a></a><a></a>')
|
8
|
+
subject = described_class.new('a')
|
9
|
+
result = subject.execute(element)
|
10
|
+
expect(result.size).to eq(2)
|
11
|
+
end
|
12
|
+
end
|
13
|
+
end
|
14
|
+
end
|
@@ -0,0 +1,21 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
RSpec.describe PageMagic::Element::Query::SingleResult do
|
4
|
+
describe '#find' do
|
5
|
+
context 'when more than one result is returned' do
|
6
|
+
it 'raises an error' do
|
7
|
+
element = PageMagic::Element.load('<a></a><a></a>')
|
8
|
+
query = described_class.new('a')
|
9
|
+
expected_message = 'Ambiguous match, found 2 elements matching visible css "a"'
|
10
|
+
expect { query.execute(element) }.to raise_error PageMagic::AmbiguousQueryException, expected_message
|
11
|
+
end
|
12
|
+
end
|
13
|
+
|
14
|
+
it 'returns the result of the capybara query' do
|
15
|
+
element = PageMagic::Element.load('<a>link</a>')
|
16
|
+
query = described_class.new('a')
|
17
|
+
result = query.execute(element)
|
18
|
+
expect(result.text).to eq('link')
|
19
|
+
end
|
20
|
+
end
|
21
|
+
end
|