appium_lib_core 5.0.0.beta3 → 5.0.0.beta4
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +7 -6
- data/README.md +2 -1
- data/appium_lib_core.gemspec +2 -2
- data/lib/appium_lib_core.rb +1 -1
- data/lib/appium_lib_core/android/device/auth_finger_print.rb +2 -1
- data/lib/appium_lib_core/common/base/bridge.rb +34 -14
- data/lib/appium_lib_core/common/base/device_ime.rb +49 -0
- data/lib/appium_lib_core/common/base/driver.rb +80 -64
- data/lib/appium_lib_core/common/base/driver_settings.rb +51 -0
- data/lib/appium_lib_core/common/base/has_network_connection.rb +1 -1
- data/lib/appium_lib_core/common/base/rotable.rb +1 -1
- data/lib/appium_lib_core/common/base/search_context.rb +9 -4
- data/lib/appium_lib_core/common/device/keyevent.rb +4 -4
- data/lib/appium_lib_core/common/error.rb +4 -1
- data/lib/appium_lib_core/common/log.rb +4 -1
- data/lib/appium_lib_core/driver.rb +3 -4
- data/lib/appium_lib_core/version.rb +2 -2
- data/release_notes.md +14 -0
- metadata +12 -10
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 6bc30b79d80c1606288087e36a6ed024c3be91ffbc6c5b8b04c9c9c1537d1d9e
|
4
|
+
data.tar.gz: 06b4f5cdbadb770ce7ce4eecd3fcdaf78c002c13982b6a0573e30a0c3aee9d02
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: c68d806651e436131ebd91c9f9b520a8de1a95ad82ee67988c7f475b6ce2c016b50fa15e1ee4f0813f55d59e5237bea34c209096436807ba7f8eb2ac9afbb123
|
7
|
+
data.tar.gz: 3982388d81e2d3d59b51cde803e5e83521772700fc8a82d0733ba650c25b2f46578bb9490113a8792a5b5e24d22488110ff3a6e727cb8d22a210c6bf4fb8632e
|
data/CHANGELOG.md
CHANGED
@@ -10,11 +10,17 @@ Read `release_notes.md` for commit level details.
|
|
10
10
|
|
11
11
|
### Deprecations
|
12
12
|
|
13
|
-
## [5.0.0.
|
13
|
+
## [5.0.0.beta]
|
14
14
|
|
15
15
|
- Update base selenium webdriver version to `4.0.0.beta2`
|
16
16
|
- Support only W3C spec
|
17
17
|
- Support Ruby 2.5+
|
18
|
+
- Raises `::Appium::Core::Error::ArgumentError` instead of `ArgumentError` for this library specific argument errors
|
19
|
+
|
20
|
+
## [4.6.0] - 2021-06-03
|
21
|
+
|
22
|
+
### Enhancements
|
23
|
+
- Add `Appium::Core::Base::Driver#add_command` to allow you to add your own command
|
18
24
|
|
19
25
|
## [4.5.0] - 2021-03-14
|
20
26
|
|
@@ -22,11 +28,6 @@ Read `release_notes.md` for commit level details.
|
|
22
28
|
- Add `speed` argument for `Appium::Core::Base::Driver#set_location` since Appium 1.21.0
|
23
29
|
- Add `multiple` and `match_neighbour_threshold` arguments for `Appium::Core::Base::Driver#find_image_occurrence`
|
24
30
|
|
25
|
-
### Bug fixes
|
26
|
-
|
27
|
-
### Deprecations
|
28
|
-
|
29
|
-
|
30
31
|
## [4.4.1(4.4.0)] - 2021-02-15(2021-02-13)
|
31
32
|
|
32
33
|
### Enhancements
|
data/README.md
CHANGED
@@ -11,6 +11,7 @@ This library wraps [selenium-webdriver](https://github.com/SeleniumHQ/selenium/w
|
|
11
11
|
# Documentation
|
12
12
|
|
13
13
|
- http://www.rubydoc.info/github/appium/ruby_lib_core
|
14
|
+
- You can find working API examples in test code, [test/functional](test/functional)
|
14
15
|
|
15
16
|
# Related library
|
16
17
|
- https://github.com/appium/ruby_lib
|
@@ -120,7 +121,7 @@ $ IGNORE_VERSION_SKIP=true CI=true bundle exec rake test:func:android
|
|
120
121
|
$ ruby test.rb
|
121
122
|
```
|
122
123
|
|
123
|
-
More examples are in [test/functional](test/functional)
|
124
|
+
More examples are in [test/functional](test/functional)
|
124
125
|
|
125
126
|
### Capabilities
|
126
127
|
|
data/appium_lib_core.gemspec
CHANGED
@@ -22,7 +22,7 @@ Gem::Specification.new do |spec|
|
|
22
22
|
spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
|
23
23
|
spec.require_paths = ['lib']
|
24
24
|
|
25
|
-
spec.add_runtime_dependency 'selenium-webdriver', '4.0.0.
|
25
|
+
spec.add_runtime_dependency 'selenium-webdriver', '4.0.0.beta4'
|
26
26
|
spec.add_runtime_dependency 'faye-websocket', '~> 0.11.0'
|
27
27
|
|
28
28
|
spec.add_development_dependency 'bundler', '>= 1.14'
|
@@ -30,7 +30,7 @@ Gem::Specification.new do |spec|
|
|
30
30
|
spec.add_development_dependency 'yard', '~> 0.9.11'
|
31
31
|
spec.add_development_dependency 'minitest', '~> 5.0'
|
32
32
|
spec.add_development_dependency 'minitest-reporters', '~> 1.1'
|
33
|
-
spec.add_development_dependency 'webmock', '~> 3.
|
33
|
+
spec.add_development_dependency 'webmock', '~> 3.13.0'
|
34
34
|
spec.add_development_dependency 'rubocop', '1.12.0'
|
35
35
|
spec.add_development_dependency 'appium_thor', '~> 1.0'
|
36
36
|
spec.add_development_dependency 'pry'
|
data/lib/appium_lib_core.rb
CHANGED
@@ -27,7 +27,7 @@ module Appium
|
|
27
27
|
# https://github.com/rails/docrails/blob/a3b1105ada3da64acfa3843b164b14b734456a50/activesupport/lib/active_support/core_ext/hash/keys.rb#L84
|
28
28
|
# @param [Hash] hash Hash value to make symbolise
|
29
29
|
def self.symbolize_keys(hash)
|
30
|
-
raise ArgumentError, 'symbolize_keys requires a hash' unless hash.is_a? Hash
|
30
|
+
raise ::Appium::Core::Error::ArgumentError, 'symbolize_keys requires a hash' unless hash.is_a? Hash
|
31
31
|
|
32
32
|
hash.each_with_object({}) do |pair, acc|
|
33
33
|
key = begin
|
@@ -21,7 +21,8 @@ module Appium
|
|
21
21
|
::Appium::Core::Device.add_endpoint_method(:finger_print) do
|
22
22
|
def finger_print(finger_id)
|
23
23
|
unless (1..10).cover? finger_id.to_i
|
24
|
-
raise ArgumentError,
|
24
|
+
raise ::Appium::Core::Error::ArgumentError,
|
25
|
+
"finger_id should be integer between 1 to 10. Not #{finger_id}"
|
25
26
|
end
|
26
27
|
|
27
28
|
execute(:finger_print, {}, { fingerprintId: finger_id.to_i })
|
@@ -36,13 +36,17 @@ module Appium
|
|
36
36
|
# Prefix for extra capability defined by W3C
|
37
37
|
APPIUM_PREFIX = 'appium:'
|
38
38
|
|
39
|
-
#
|
39
|
+
# No 'browserName' means the session is native appium connection
|
40
|
+
APPIUM_NATIVE_BROWSER_NAME = 'appium'
|
41
|
+
|
42
|
+
attr_reader :available_commands
|
43
|
+
|
40
44
|
def browser
|
41
45
|
@browser ||= begin
|
42
46
|
name = @capabilities.browser_name
|
43
47
|
name ? name.tr(' ', '_').downcase.to_sym : 'unknown'
|
44
48
|
rescue KeyError
|
45
|
-
|
49
|
+
APPIUM_NATIVE_BROWSER_NAME
|
46
50
|
end
|
47
51
|
end
|
48
52
|
|
@@ -70,16 +74,16 @@ module Appium
|
|
70
74
|
# core = ::Appium::Core.for(caps)
|
71
75
|
# driver = core.start_driver
|
72
76
|
#
|
73
|
-
def create_session(
|
74
|
-
|
77
|
+
def create_session(capabilities)
|
78
|
+
@available_commands = ::Appium::Core::Commands::COMMANDS.dup
|
79
|
+
|
80
|
+
caps = add_appium_prefix(capabilities)
|
75
81
|
response = execute(:new_session, {}, { capabilities: { firstMatch: [caps] } })
|
76
82
|
|
77
83
|
@session_id = response['sessionId']
|
78
|
-
capabilities = response['capabilities']
|
79
|
-
|
80
84
|
raise ::Selenium::WebDriver::Error::WebDriverError, 'no sessionId in returned payload' unless @session_id
|
81
85
|
|
82
|
-
@capabilities = json_create(capabilities)
|
86
|
+
@capabilities = json_create(response['capabilities'])
|
83
87
|
end
|
84
88
|
|
85
89
|
# Append +appium:+ prefix for Appium following W3C spec
|
@@ -90,7 +94,7 @@ module Appium
|
|
90
94
|
def add_appium_prefix(capabilities)
|
91
95
|
w3c_capabilities = ::Selenium::WebDriver::Remote::Capabilities.new
|
92
96
|
|
93
|
-
capabilities = capabilities.
|
97
|
+
capabilities = capabilities.send(:capabilities) unless capabilities.is_a?(Hash)
|
94
98
|
|
95
99
|
capabilities.each do |name, value|
|
96
100
|
next if value.nil?
|
@@ -127,8 +131,17 @@ module Appium
|
|
127
131
|
|
128
132
|
public
|
129
133
|
|
134
|
+
# command for Appium 2.0.
|
135
|
+
def add_command(method:, url:, name:, &block)
|
136
|
+
raise ::Appium::Core::Error::ArgumentError, "#{name} is already defined" if @available_commands.key? name
|
137
|
+
|
138
|
+
@available_commands[name] = [method, url]
|
139
|
+
|
140
|
+
::Appium::Core::Device.add_endpoint_method name, &block
|
141
|
+
end
|
142
|
+
|
130
143
|
def commands(command)
|
131
|
-
|
144
|
+
@available_commands[command]
|
132
145
|
end
|
133
146
|
|
134
147
|
# Returns all available sessions on the Appium server instance
|
@@ -215,7 +228,7 @@ module Appium
|
|
215
228
|
# For Appium
|
216
229
|
# override
|
217
230
|
def find_element_by(how, what, parent = nil)
|
218
|
-
how, what =
|
231
|
+
how, what = convert_locator(how, what)
|
219
232
|
|
220
233
|
id = if parent
|
221
234
|
execute :find_child_element, { id: parent }, { using: how, value: what }
|
@@ -228,7 +241,7 @@ module Appium
|
|
228
241
|
# For Appium
|
229
242
|
# override
|
230
243
|
def find_elements_by(how, what, parent = nil)
|
231
|
-
how, what =
|
244
|
+
how, what = convert_locator(how, what)
|
232
245
|
|
233
246
|
ids = if parent
|
234
247
|
execute :find_child_elements, { id: parent }, { using: how, value: what }
|
@@ -341,9 +354,8 @@ module Appium
|
|
341
354
|
id['ELEMENT'] || id['element-6066-11e4-a52e-4f735466cecf']
|
342
355
|
end
|
343
356
|
|
344
|
-
# Don't convert locators for Appium
|
345
|
-
|
346
|
-
def convert_locators(how, what)
|
357
|
+
# Don't convert locators for Appium in native context
|
358
|
+
def convert_locator(how, what)
|
347
359
|
# case how
|
348
360
|
# when 'class name'
|
349
361
|
# how = 'css selector'
|
@@ -357,6 +369,14 @@ module Appium
|
|
357
369
|
# when 'tag name'
|
358
370
|
# how = 'css selector'
|
359
371
|
# end
|
372
|
+
#
|
373
|
+
# if what.is_a?(Hash)
|
374
|
+
# what = what.each_with_object({}) do |(h, w), hash|
|
375
|
+
# h, w = convert_locator(h.to_s, w)
|
376
|
+
# hash[h] = w
|
377
|
+
# end
|
378
|
+
# end
|
379
|
+
|
360
380
|
[how, what]
|
361
381
|
end
|
362
382
|
end # class Bridge
|
@@ -0,0 +1,49 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
+
# you may not use this file except in compliance with the License.
|
5
|
+
# You may obtain a copy of the License at
|
6
|
+
#
|
7
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
8
|
+
#
|
9
|
+
# Unless required by applicable law or agreed to in writing, software
|
10
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
+
# See the License for the specific language governing permissions and
|
13
|
+
# limitations under the License.
|
14
|
+
|
15
|
+
module Appium
|
16
|
+
module Core
|
17
|
+
class Base
|
18
|
+
#
|
19
|
+
# @api private
|
20
|
+
#
|
21
|
+
class DeviceIME
|
22
|
+
# @private this class is private
|
23
|
+
def initialize(bridge)
|
24
|
+
@bridge = bridge
|
25
|
+
end
|
26
|
+
|
27
|
+
def activate(ime_name)
|
28
|
+
@bridge.ime_activate(ime_name)
|
29
|
+
end
|
30
|
+
|
31
|
+
def available_engines
|
32
|
+
@bridge.ime_available_engines
|
33
|
+
end
|
34
|
+
|
35
|
+
def active_engine
|
36
|
+
@bridge.ime_active_engine
|
37
|
+
end
|
38
|
+
|
39
|
+
def activated?
|
40
|
+
@bridge.ime_activated
|
41
|
+
end
|
42
|
+
|
43
|
+
def deactivate
|
44
|
+
@bridge.ime_deactivate
|
45
|
+
end
|
46
|
+
end
|
47
|
+
end
|
48
|
+
end
|
49
|
+
end
|
@@ -13,6 +13,8 @@
|
|
13
13
|
# limitations under the License.
|
14
14
|
|
15
15
|
require 'base64'
|
16
|
+
require_relative 'device_ime'
|
17
|
+
require_relative 'driver_settings'
|
16
18
|
require_relative 'search_context'
|
17
19
|
require_relative 'screenshot'
|
18
20
|
require_relative 'rotable'
|
@@ -42,8 +44,10 @@ module Appium
|
|
42
44
|
# Do not use this for general use. Used by flutter driver to get bridge for creating a new element
|
43
45
|
attr_reader :bridge
|
44
46
|
|
45
|
-
|
46
|
-
|
47
|
+
def initialize(bridge: nil, listener: nil, **opts)
|
48
|
+
super
|
49
|
+
end
|
50
|
+
|
47
51
|
# Implements protocol handshake which:
|
48
52
|
#
|
49
53
|
# 1. Creates session with driver.
|
@@ -53,6 +57,7 @@ module Appium
|
|
53
57
|
# @return [::Appium::Core::Base::Bridge]
|
54
58
|
#
|
55
59
|
def create_bridge(**opts)
|
60
|
+
# TODO: probably Appium does not need this.
|
56
61
|
opts[:url] ||= service_url(opts)
|
57
62
|
caps = opts.delete(:capabilities)
|
58
63
|
# NOTE: This is deprecated
|
@@ -72,7 +77,7 @@ module Appium
|
|
72
77
|
capabilities = generate_capabilities(cap_array)
|
73
78
|
|
74
79
|
bridge_opts = { http_client: opts.delete(:http_client), url: opts.delete(:url) }
|
75
|
-
raise ArgumentError, "Unable to create a driver with parameters: #{opts}" unless opts.empty?
|
80
|
+
raise ::Appium::Core::Error::ArgumentError, "Unable to create a driver with parameters: #{opts}" unless opts.empty?
|
76
81
|
|
77
82
|
bridge = ::Appium::Core::Base::Bridge.new(**bridge_opts)
|
78
83
|
|
@@ -106,6 +111,75 @@ module Appium
|
|
106
111
|
path: path)
|
107
112
|
end
|
108
113
|
|
114
|
+
AVAILABLE_METHODS = [
|
115
|
+
:get, :head, :post, :put, :delete,
|
116
|
+
:connect, :options, :trace, :patch
|
117
|
+
].freeze
|
118
|
+
# Define a new custom method to the driver so that you can define your own method for
|
119
|
+
# drivers/plugins in Appium 2.0. Appium 2.0 and its custom drivers/plugins allow you
|
120
|
+
# to define custom commands that are not part of W3C spec.
|
121
|
+
#
|
122
|
+
# @param [Symbol] method HTTP request method as https://www.w3.org/TR/webdriver/#endpoints
|
123
|
+
# @param [string] url The url to URL template as https://www.w3.org/TR/webdriver/#endpoints.
|
124
|
+
# +:session_id+ is the placeholder of 'session id'.
|
125
|
+
# Other place holders can be specified with +:+ prefix like +:id+.
|
126
|
+
# Then, the +:id+ will be replaced with a given value as the seconds argument of +execute+
|
127
|
+
# @param [Symbol] name The name of method that is called as the driver instance method.
|
128
|
+
# @param [Proc] block The block to involve as the method
|
129
|
+
# @raise [ArgumentError] If the given +name+ is already defined or +method+ are invalid value.
|
130
|
+
#
|
131
|
+
# @example
|
132
|
+
#
|
133
|
+
# @driver.add_command(
|
134
|
+
# method: :get,
|
135
|
+
# url: 'session/:session_id/path/to/custom/url',
|
136
|
+
# name: :test_command
|
137
|
+
# )
|
138
|
+
# # Send a GET request to 'session/<session id>/path/to/custom/url'
|
139
|
+
# @driver.test_command
|
140
|
+
#
|
141
|
+
#
|
142
|
+
# @driver.add_command(
|
143
|
+
# method: :post,
|
144
|
+
# url: 'session/:session_id/path/to/custom/url',
|
145
|
+
# name: :test_command
|
146
|
+
# ) do
|
147
|
+
# def test_command(argument)
|
148
|
+
# execute(:test_command, {}, { dummy: argument })
|
149
|
+
# end
|
150
|
+
# end
|
151
|
+
# # Send a POST request to 'session/<session id>/path/to/custom/url'
|
152
|
+
# # with body "{ dummy: 1 }" as JSON object. "1" is the argument.
|
153
|
+
# # ':session_id' in the given 'url' is replaced with current 'session id'.
|
154
|
+
# @driver.test_command(1)
|
155
|
+
#
|
156
|
+
# @driver.add_command(
|
157
|
+
# method: :post,
|
158
|
+
# url: 'session/:session_id/element/:id/custom/action',
|
159
|
+
# name: :test_action_command
|
160
|
+
# ) do
|
161
|
+
# def test_action_command(element_id, action)
|
162
|
+
# execute(:test_action_command, {id: element_id}, { dummy_action: action })
|
163
|
+
# end
|
164
|
+
# end
|
165
|
+
# # Send a POST request to 'session/<session id>/element/<element id>/custom/action'
|
166
|
+
# # with body "{ dummy_action: #{action} }" as JSON object. "action" is the seconds argument.
|
167
|
+
# # ':session_id' in the given url is replaced with current 'session id'.
|
168
|
+
# # ':id' in the given url is replaced with the given 'element_id'.
|
169
|
+
# e = @driver.find_element :accessibility_id, 'an element'
|
170
|
+
# @driver.test_action_command(e.ref, 'action')
|
171
|
+
#
|
172
|
+
def add_command(method:, url:, name:, &block)
|
173
|
+
unless AVAILABLE_METHODS.include? method
|
174
|
+
raise ::Appium::Core::Error::ArgumentError, "Available method is either #{AVAILABLE_METHODS}"
|
175
|
+
end
|
176
|
+
|
177
|
+
# TODO: Remove this logger before Appium 2.0 release
|
178
|
+
::Appium::Logger.info '[Experimental] this method is experimental for Appium 2.0. This interface may change.'
|
179
|
+
|
180
|
+
@bridge.add_command method: method, url: url, name: name, &block
|
181
|
+
end
|
182
|
+
|
109
183
|
### Methods for Appium
|
110
184
|
|
111
185
|
# Lock the device
|
@@ -188,36 +262,6 @@ module Appium
|
|
188
262
|
end
|
189
263
|
alias type send_keys
|
190
264
|
|
191
|
-
class DriverSettings
|
192
|
-
# @private this class is private
|
193
|
-
def initialize(bridge)
|
194
|
-
@bridge = bridge
|
195
|
-
end
|
196
|
-
|
197
|
-
# Get appium Settings for current test session.
|
198
|
-
#
|
199
|
-
# @example
|
200
|
-
#
|
201
|
-
# @driver.settings.get
|
202
|
-
#
|
203
|
-
def get
|
204
|
-
@bridge.get_settings
|
205
|
-
end
|
206
|
-
|
207
|
-
# Update Appium Settings for current test session
|
208
|
-
#
|
209
|
-
# @param [Hash] settings Settings to update, keys are settings, values to value to set each setting to
|
210
|
-
#
|
211
|
-
# @example
|
212
|
-
#
|
213
|
-
# @driver.settings.update({'allowInvisibleElements': true})
|
214
|
-
#
|
215
|
-
def update(settings)
|
216
|
-
@bridge.update_settings(settings)
|
217
|
-
end
|
218
|
-
end
|
219
|
-
private_constant :DriverSettings
|
220
|
-
|
221
265
|
# Returns an instance of DriverSettings to call get/update.
|
222
266
|
#
|
223
267
|
# @example
|
@@ -226,7 +270,7 @@ module Appium
|
|
226
270
|
# @driver.settings.update('allowInvisibleElements': true)
|
227
271
|
#
|
228
272
|
def settings
|
229
|
-
@
|
273
|
+
@settings ||= DriverSettings.new(@bridge)
|
230
274
|
end
|
231
275
|
|
232
276
|
# Get appium Settings for current test session.
|
@@ -257,34 +301,6 @@ module Appium
|
|
257
301
|
end
|
258
302
|
alias update_settings settings=
|
259
303
|
|
260
|
-
class DeviceIME
|
261
|
-
# @private this class is private
|
262
|
-
def initialize(bridge)
|
263
|
-
@bridge = bridge
|
264
|
-
end
|
265
|
-
|
266
|
-
def activate(ime_name)
|
267
|
-
@bridge.ime_activate(ime_name)
|
268
|
-
end
|
269
|
-
|
270
|
-
def available_engines
|
271
|
-
@bridge.ime_available_engines
|
272
|
-
end
|
273
|
-
|
274
|
-
def active_engine
|
275
|
-
@bridge.ime_active_engine
|
276
|
-
end
|
277
|
-
|
278
|
-
def activated?
|
279
|
-
@bridge.ime_activated
|
280
|
-
end
|
281
|
-
|
282
|
-
def deactivate
|
283
|
-
@bridge.ime_deactivate
|
284
|
-
end
|
285
|
-
end
|
286
|
-
private_constant :DeviceIME
|
287
|
-
|
288
304
|
# Returns an instance of DeviceIME
|
289
305
|
#
|
290
306
|
# @return [Appium::Core::Base::Driver::DeviceIME]
|
@@ -298,7 +314,7 @@ module Appium
|
|
298
314
|
# @driver.ime.deactivate #=> Deactivate current IME engine
|
299
315
|
#
|
300
316
|
def ime
|
301
|
-
@
|
317
|
+
@ime ||= DeviceIME.new(@bridge)
|
302
318
|
end
|
303
319
|
|
304
320
|
# Android only. Make an engine that is available active.
|
@@ -861,7 +877,7 @@ module Appium
|
|
861
877
|
# @driver.perform_actions [f1, f2] #=> 'nil' if the action succeed
|
862
878
|
#
|
863
879
|
def perform_actions(data)
|
864
|
-
raise ArgumentError, "'#{data}' must be Array" unless data.is_a? Array
|
880
|
+
raise ::Appium::Core::Error::ArgumentError, "'#{data}' must be Array" unless data.is_a? Array
|
865
881
|
|
866
882
|
@bridge.send_actions data.map(&:encode).compact
|
867
883
|
data.each(&:clear_actions)
|
@@ -0,0 +1,51 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
+
# you may not use this file except in compliance with the License.
|
5
|
+
# You may obtain a copy of the License at
|
6
|
+
#
|
7
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
8
|
+
#
|
9
|
+
# Unless required by applicable law or agreed to in writing, software
|
10
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
+
# See the License for the specific language governing permissions and
|
13
|
+
# limitations under the License.
|
14
|
+
|
15
|
+
module Appium
|
16
|
+
module Core
|
17
|
+
class Base
|
18
|
+
#
|
19
|
+
# @api private
|
20
|
+
#
|
21
|
+
class DriverSettings
|
22
|
+
# @private this class is private
|
23
|
+
def initialize(bridge)
|
24
|
+
@bridge = bridge
|
25
|
+
end
|
26
|
+
|
27
|
+
# Get appium Settings for current test session.
|
28
|
+
#
|
29
|
+
# @example
|
30
|
+
#
|
31
|
+
# @driver.settings.get
|
32
|
+
#
|
33
|
+
def get
|
34
|
+
@bridge.get_settings
|
35
|
+
end
|
36
|
+
|
37
|
+
# Update Appium Settings for current test session
|
38
|
+
#
|
39
|
+
# @param [Hash] settings Settings to update, keys are settings, values to value to set each setting to
|
40
|
+
#
|
41
|
+
# @example
|
42
|
+
#
|
43
|
+
# @driver.settings.update({'allowInvisibleElements': true})
|
44
|
+
#
|
45
|
+
def update(settings)
|
46
|
+
@bridge.update_settings(settings)
|
47
|
+
end
|
48
|
+
end
|
49
|
+
end
|
50
|
+
end
|
51
|
+
end
|
@@ -30,7 +30,7 @@ module Appium
|
|
30
30
|
end
|
31
31
|
|
32
32
|
def network_connection_type=(connection_type)
|
33
|
-
raise ArgumentError, 'Invalid connection type' unless valid_type? connection_type
|
33
|
+
raise ::Appium::Core::Error::ArgumentError, 'Invalid connection type' unless valid_type? connection_type
|
34
34
|
|
35
35
|
connection_value = type_to_values[connection_type]
|
36
36
|
|
@@ -30,7 +30,7 @@ module Appium
|
|
30
30
|
#
|
31
31
|
def rotation=(orientation)
|
32
32
|
unless ORIENTATIONS.include?(orientation)
|
33
|
-
raise ArgumentError, "expected #{ORIENTATIONS.inspect}, got #{orientation.inspect}"
|
33
|
+
raise ::Appium::Core::Error::ArgumentError, "expected #{ORIENTATIONS.inspect}, got #{orientation.inspect}"
|
34
34
|
end
|
35
35
|
|
36
36
|
bridge.screen_orientation = orientation.to_s.upcase
|
@@ -159,7 +159,10 @@ module Appium
|
|
159
159
|
|
160
160
|
def _set_by_from_finders(how)
|
161
161
|
by = FINDERS[how.to_sym]
|
162
|
-
|
162
|
+
unless by
|
163
|
+
raise ::Appium::Core::Error::ArgumentError,
|
164
|
+
"cannot find element by #{how.inspect}. Available finders are #{FINDERS.keys}."
|
165
|
+
end
|
163
166
|
|
164
167
|
by
|
165
168
|
end
|
@@ -171,16 +174,18 @@ module Appium
|
|
171
174
|
when 1
|
172
175
|
arg = args.first
|
173
176
|
|
174
|
-
|
177
|
+
unless arg.respond_to?(:shift)
|
178
|
+
raise ::Appium::Core::Error::ArgumentError, "expected #{arg.inspect}:#{arg.class} to respond to #shift"
|
179
|
+
end
|
175
180
|
|
176
181
|
# this will be a single-entry hash, so use #shift over #first or #[]
|
177
182
|
arr = arg.dup.shift
|
178
183
|
|
179
|
-
raise ArgumentError, "expected #{arr.inspect} to have 2 elements" unless arr.size == 2
|
184
|
+
raise ::Appium::Core::Error::ArgumentError, "expected #{arr.inspect} to have 2 elements" unless arr.size == 2
|
180
185
|
|
181
186
|
arr
|
182
187
|
else
|
183
|
-
raise ArgumentError, "wrong number of arguments (#{args.size} for 2)"
|
188
|
+
raise ::Appium::Core::Error::ArgumentError, "wrong number of arguments (#{args.size} for 2)"
|
184
189
|
end
|
185
190
|
end
|
186
191
|
end # module SearchContext
|
@@ -25,8 +25,8 @@ module Appium
|
|
25
25
|
end
|
26
26
|
|
27
27
|
def press_keycode(key, metastate: [], flags: [])
|
28
|
-
raise ArgumentError, 'flags should be Array' unless flags.is_a? Array
|
29
|
-
raise ArgumentError, 'metastates should be Array' unless metastate.is_a? Array
|
28
|
+
raise ::Appium::Core::Error::ArgumentError, 'flags should be Array' unless flags.is_a? Array
|
29
|
+
raise ::Appium::Core::Error::ArgumentError, 'metastates should be Array' unless metastate.is_a? Array
|
30
30
|
|
31
31
|
args = { keycode: key }
|
32
32
|
args[:metastate] = metastate.reduce(0) { |acc, meta| acc | meta } unless metastate.empty?
|
@@ -36,8 +36,8 @@ module Appium
|
|
36
36
|
end
|
37
37
|
|
38
38
|
def long_press_keycode(key, metastate: [], flags: [])
|
39
|
-
raise ArgumentError, 'flags should be Array' unless flags.is_a? Array
|
40
|
-
raise ArgumentError, 'metastates should be Array' unless metastate.is_a? Array
|
39
|
+
raise ::Appium::Core::Error::ArgumentError, 'flags should be Array' unless flags.is_a? Array
|
40
|
+
raise ::Appium::Core::Error::ArgumentError, 'metastates should be Array' unless metastate.is_a? Array
|
41
41
|
|
42
42
|
args = { keycode: key }
|
43
43
|
args[:metastate] = metastate.reduce(0) { |acc, meta| acc | meta } unless metastate.empty?
|
@@ -27,8 +27,11 @@ module Appium
|
|
27
27
|
|
28
28
|
class UnsupportedOperationError < CoreError; end
|
29
29
|
|
30
|
-
# Server side
|
30
|
+
# Server side errors
|
31
31
|
class ServerError < CoreError; end
|
32
|
+
|
33
|
+
# ruby_lib_core library specific errors
|
34
|
+
class ArgumentError < CoreError; end
|
32
35
|
end
|
33
36
|
end
|
34
37
|
end
|
@@ -65,7 +65,10 @@ module Appium
|
|
65
65
|
end
|
66
66
|
|
67
67
|
def event=(log_event)
|
68
|
-
|
68
|
+
unless log_event.is_a?(Hash)
|
69
|
+
raise ::Appium::Core::Error::ArgumentError,
|
70
|
+
'log_event should be Hash like { vendor: "appium", event: "funEvent"}'
|
71
|
+
end
|
69
72
|
|
70
73
|
event vendor: log_event[:vendor], event: log_event[:event]
|
71
74
|
end
|
@@ -367,11 +367,10 @@ module Appium
|
|
367
367
|
end
|
368
368
|
|
369
369
|
begin
|
370
|
-
# included https://github.com/SeleniumHQ/selenium/blob/43f8b3f66e7e01124eff6a5805269ee441f65707/rb/lib/selenium/webdriver/remote/driver.rb#L29
|
371
370
|
@driver = ::Appium::Core::Base::Driver.new(listener: @listener,
|
372
|
-
|
373
|
-
|
374
|
-
|
371
|
+
http_client: @http_client,
|
372
|
+
desired_capabilities: @caps,
|
373
|
+
url: @custom_url)
|
375
374
|
|
376
375
|
if @direct_connect
|
377
376
|
d_c = DirectConnections.new(@driver.capabilities)
|
@@ -14,7 +14,7 @@
|
|
14
14
|
|
15
15
|
module Appium
|
16
16
|
module Core
|
17
|
-
VERSION = '5.0.0.
|
18
|
-
DATE = '2021-
|
17
|
+
VERSION = '5.0.0.beta4' unless defined? ::Appium::Core::VERSION
|
18
|
+
DATE = '2021-06-11' unless defined? ::Appium::Core::DATE
|
19
19
|
end
|
20
20
|
end
|
data/release_notes.md
CHANGED
@@ -1,3 +1,17 @@
|
|
1
|
+
#### v4.6.0 2021-06-03
|
2
|
+
|
3
|
+
- [0dacfab](https://github.com/appium/ruby_lib_core/commit/0dacfab1256e1447e1f7a5974dfcf48ee0a72b9d) Release 4.6.0
|
4
|
+
- [b9f015d](https://github.com/appium/ruby_lib_core/commit/b9f015d7dea14964a0733f2385ebcff68da1e18e) feat: allow to add commands dynamically (#325)
|
5
|
+
- [3de96ee](https://github.com/appium/ruby_lib_core/commit/3de96eea133ccbcbc5c4d77adc7d67c065a5a38c) chore(deps-dev): update webmock requirement from ~> 3.12.1 to ~> 3.13.0 (#324)
|
6
|
+
- [f1a9e79](https://github.com/appium/ruby_lib_core/commit/f1a9e79f3bd4d134e125fc2ed9adcf3d085afc9a) docs: address func test code as working example
|
7
|
+
- [eb85b1b](https://github.com/appium/ruby_lib_core/commit/eb85b1b26623436cb0aae95a00fef7bc2d795520) remove ; in a test
|
8
|
+
- [1632637](https://github.com/appium/ruby_lib_core/commit/1632637fd872c0b80dfb97b8514ada6a7164eebf) chore(deps-dev): update rubocop requirement from = 1.11.0 to = 1.12.0 (#321)
|
9
|
+
- [b9e47aa](https://github.com/appium/ruby_lib_core/commit/b9e47aa9b02f060ffa91e8410ab97dc87d3640a4) docs: add docstring
|
10
|
+
- [954a2fe](https://github.com/appium/ruby_lib_core/commit/954a2feebb768a55b496a2614d9e4dd8b702fc1e) chore(deps-dev): update rubocop requirement from = 1.8.1 to = 1.11.0 (#316)
|
11
|
+
- [a5b9651](https://github.com/appium/ruby_lib_core/commit/a5b9651aa349c10bd9759fedac6f09e27012a5e5) chore(deps-dev): update webmock requirement from ~> 3.11.0 to ~> 3.12.1 (#319)
|
12
|
+
- [485c096](https://github.com/appium/ruby_lib_core/commit/485c096273178aa5e21f28d93545fd127cbb8735) test: add assertion
|
13
|
+
|
14
|
+
|
1
15
|
#### v4.5.0 2021-03-14
|
2
16
|
|
3
17
|
- [656230e](https://github.com/appium/ruby_lib_core/commit/656230e688ed86414c06efaa73bce7359933cc91) Release 4.5.0
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: appium_lib_core
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 5.0.0.
|
4
|
+
version: 5.0.0.beta4
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Kazuaki MATSUO
|
8
|
-
autorequire:
|
8
|
+
autorequire:
|
9
9
|
bindir: exe
|
10
10
|
cert_chain: []
|
11
|
-
date: 2021-
|
11
|
+
date: 2021-06-12 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: selenium-webdriver
|
@@ -16,14 +16,14 @@ dependencies:
|
|
16
16
|
requirements:
|
17
17
|
- - '='
|
18
18
|
- !ruby/object:Gem::Version
|
19
|
-
version: 4.0.0.
|
19
|
+
version: 4.0.0.beta4
|
20
20
|
type: :runtime
|
21
21
|
prerelease: false
|
22
22
|
version_requirements: !ruby/object:Gem::Requirement
|
23
23
|
requirements:
|
24
24
|
- - '='
|
25
25
|
- !ruby/object:Gem::Version
|
26
|
-
version: 4.0.0.
|
26
|
+
version: 4.0.0.beta4
|
27
27
|
- !ruby/object:Gem::Dependency
|
28
28
|
name: faye-websocket
|
29
29
|
requirement: !ruby/object:Gem::Requirement
|
@@ -114,14 +114,14 @@ dependencies:
|
|
114
114
|
requirements:
|
115
115
|
- - "~>"
|
116
116
|
- !ruby/object:Gem::Version
|
117
|
-
version: 3.
|
117
|
+
version: 3.13.0
|
118
118
|
type: :development
|
119
119
|
prerelease: false
|
120
120
|
version_requirements: !ruby/object:Gem::Requirement
|
121
121
|
requirements:
|
122
122
|
- - "~>"
|
123
123
|
- !ruby/object:Gem::Version
|
124
|
-
version: 3.
|
124
|
+
version: 3.13.0
|
125
125
|
- !ruby/object:Gem::Dependency
|
126
126
|
name: rubocop
|
127
127
|
requirement: !ruby/object:Gem::Requirement
|
@@ -257,7 +257,9 @@ files:
|
|
257
257
|
- lib/appium_lib_core/common/base.rb
|
258
258
|
- lib/appium_lib_core/common/base/bridge.rb
|
259
259
|
- lib/appium_lib_core/common/base/capabilities.rb
|
260
|
+
- lib/appium_lib_core/common/base/device_ime.rb
|
260
261
|
- lib/appium_lib_core/common/base/driver.rb
|
262
|
+
- lib/appium_lib_core/common/base/driver_settings.rb
|
261
263
|
- lib/appium_lib_core/common/base/has_location.rb
|
262
264
|
- lib/appium_lib_core/common/base/has_network_connection.rb
|
263
265
|
- lib/appium_lib_core/common/base/http_default.rb
|
@@ -323,7 +325,7 @@ homepage: https://github.com/appium/ruby_lib_core/
|
|
323
325
|
licenses:
|
324
326
|
- Apache-2.0
|
325
327
|
metadata: {}
|
326
|
-
post_install_message:
|
328
|
+
post_install_message:
|
327
329
|
rdoc_options: []
|
328
330
|
require_paths:
|
329
331
|
- lib
|
@@ -338,8 +340,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
338
340
|
- !ruby/object:Gem::Version
|
339
341
|
version: 1.3.1
|
340
342
|
requirements: []
|
341
|
-
rubygems_version: 3.
|
342
|
-
signing_key:
|
343
|
+
rubygems_version: 3.2.15
|
344
|
+
signing_key:
|
343
345
|
specification_version: 4
|
344
346
|
summary: Minimal Ruby library for Appium.
|
345
347
|
test_files: []
|