Allow to pass an chrome Options instance to Browser

VERSION

@@ -1 +1 @@
-0.5.4
+0.5.4.1

docs/conf.py

@@ -50,9 +50,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = '0.5.4'
+version = '0.5.4.1'
 # The full version, including alpha/beta/rc tags.
-release = '0.5.4'
+release = '0.5.4.1'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

docs/drivers/chrome.rst

@@ -115,6 +115,29 @@ the ``Browser`` instance:
 
 **Note:** if you have trouble with ``$HOME/.bash_profile``, you can try ``$HOME/.bashrc``.
 
+Using emulation mode in Chrome
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Chrome options can be passed to customize Chrome's behaviour; it is then possible to leverage the
+experimental emulation mode.
+
+.. highlight:: python
+
+::
+
+    from selenium import webdriver
+    from splinter import Browser
+
+    mobile_emulation = {"deviceName": "Google Nexus 5"}
+    chrome_options = webdriver.ChromeOptions()
+    chrome_options.add_experimental_option("mobileEmulation",
+                                           mobile_emulation)
+    browser = Browser('chrome', options=chrome_options)
+
+
+refer to `chrome driver documentation <https://sites.google.com/a/chromium.org/chromedriver/mobile-emulation>`_
+
+
 API docs
 --------
 

setup.py

@@ -13,7 +13,7 @@
 
 setup(
     name='splinter',
-    version='0.5.4',
+    version='0.5.4.1',
     description='browser abstraction for web acceptance testing',
     long_description=README,
     author='CobraTeam',

splinter/__init__.py

@@ -2,5 +2,5 @@
 # Use of this source code is governed by a BSD-style
 # license that can be found in the LICENSE file.
 
-__version__ = '0.5.4'
+__version__ = '0.5.4.1'
 from splinter.browser import Browser

splinter/driver/webdriver/chrome.py

@@ -14,8 +14,8 @@ class WebDriver(BaseWebDriver):
 
     driver_name = "Chrome"
 
-    def __init__(self, user_agent=None, wait_time=2, **kwargs):
-        options = Options()
+    def __init__(self, options=None, user_agent=None, wait_time=2, **kwargs):
+        options = Options() if options is None else options
 
         if user_agent is not None:
             options.add_argument("--user-agent=" + user_agent)