allow SAUCE_ENDPOINT env var to override sauce server url/path (#485)

Author: jlipps

lib/appium_lib/driver.rb

@@ -289,6 +289,8 @@ class Driver
     attr_accessor :sauce_username
     # Access Key for use on Sauce Labs. Set `false` to disable Sauce, even when SAUCE_ACCESS_KEY is in ENV.
     attr_accessor :sauce_access_key
+    # Override the Sauce Appium endpoint to allow e.g. TestObject tests
+    attr_accessor :sauce_endpoint
     # Appium's server port
     attr_accessor :appium_port
     # Device type to request from the appium server
@@ -376,6 +378,9 @@ def initialize(opts = {})
       @sauce_username   = nil if !@sauce_username || (@sauce_username.is_a?(String) && @sauce_username.empty?)
       @sauce_access_key = appium_lib_opts.fetch :sauce_access_key, ENV['SAUCE_ACCESS_KEY']
       @sauce_access_key = nil if !@sauce_access_key || (@sauce_access_key.is_a?(String) && @sauce_access_key.empty?)
+      @sauce_endpoint   = appium_lib_opts.fetch :sauce_endpoint, ENV['SAUCE_ENDPOINT']
+      @sauce_endpoint   = 'ondemand.saucelabs.com:443/wd/hub' if
+                          !@sauce_endpoint || (@sauce_endpoint.is_a?(String) && @sauce_endpoint.empty?)
       @appium_port      = appium_lib_opts.fetch :port, 4723
       # timeout and interval used in ::Appium::Comm.wait/wait_true
       @appium_wait_timeout  = appium_lib_opts.fetch :wait_timeout, 30
@@ -441,6 +446,7 @@ def driver_attributes
           default_wait:     @default_wait,
           sauce_username:   @sauce_username,
           sauce_access_key: @sauce_access_key,
+          sauce_endpoint:   @sauce_endpoint,
           port:             @appium_port,
           device:           @appium_device,
           debug:            @appium_debug,
@@ -549,7 +555,7 @@ def self.absolute_app_path(opts)
     def server_url
       return @custom_url if @custom_url
       if !@sauce_username.nil? && !@sauce_access_key.nil?
-        "https://#{@sauce_username}:#{@sauce_access_key}@ondemand.saucelabs.com:443/wd/hub"
+        "https://#{@sauce_username}:#{@sauce_access_key}@#{@sauce_endpoint}"
       else
         "http://127.0.0.1:#{@appium_port}/wd/hub"
       end

readme.md

@@ -1,4 +1,4 @@
-#### appium_lib 
+#### appium_lib
 
 [![Gem Version](https://badge.fury.io/rb/appium_lib.svg)](http://badge.fury.io/rb/appium_lib)
 [![Dependency Status](https://gemnasium.com/appium/ruby_lib.svg)](https://gemnasium.com/appium/ruby_lib)
@@ -44,6 +44,7 @@ gem install --no-rdoc --no-ri appium_lib
 
 - `SAUCE_USERNAME` Sauce username
 - `SAUCE_ACCESS_KEY` Sauce API key
+- `SAUCE_ENDPOINT` Alternative Sauce Appium Server endpoint (only use if directed)
 
 (Note: If these variables are set, all tests will use Sauce Labs unless over-ridden in configuration.)
 
@@ -55,7 +56,7 @@ gem install --no-rdoc --no-ri appium_lib
 #### Documentation
 
 - [Installing Appium on OS X](https://github.com/appium/ruby_console/blob/master/osx.md)
-- [Overview](https://github.com/appium/ruby_lib/blob/master/docs/docs.md) 
+- [Overview](https://github.com/appium/ruby_lib/blob/master/docs/docs.md)
 - [Ruby Android methods](https://github.com/appium/ruby_lib/blob/master/docs/android_docs.md)
 - [Ruby iOS methods](https://github.com/appium/ruby_lib/blob/master/docs/ios_docs.md)
     - [Tips for XCUITest for iOS](https://github.com/appium/ruby_lib/blob/master/docs/ios_xcuitest.md)