updating py docs, adding to docs touch_actions class

docs/api/py/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: a2c69b16b74f140cccba8d6fd78cbe0d
+config: fffa59c39c9b21597e60f50dbfc2bf35
 tags: fbb0d17656682115ca4d033fb2f83ba1

docs/api/py/_modules/index.html

@@ -56,6 +56,7 @@ <h1>All modules for which code is available</h1>
 <li><a href="selenium/webdriver/common/by.html">selenium.webdriver.common.by</a></li>
 <li><a href="selenium/webdriver/common/desired_capabilities.html">selenium.webdriver.common.desired_capabilities</a></li>
 <li><a href="selenium/webdriver/common/keys.html">selenium.webdriver.common.keys</a></li>
+<li><a href="selenium/webdriver/common/touch_actions.html">selenium.webdriver.common.touch_actions</a></li>
 <li><a href="selenium/webdriver/common/utils.html">selenium.webdriver.common.utils</a></li>
 <li><a href="selenium/webdriver/firefox/extension_connection.html">selenium.webdriver.firefox.extension_connection</a></li>
 <li><a href="selenium/webdriver/firefox/firefox_binary.html">selenium.webdriver.firefox.firefox_binary</a></li>

docs/api/py/_modules/selenium/common/exceptions.html

@@ -78,7 +78,7 @@ <h1>Source code for selenium.common.exceptions</h1><div class="highlight"><pre>
                 <span class="o">%</span> <span class="n">exception_msg</span>
         <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">stacktrace</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span><span class="p">:</span>
             <span class="n">exception_msg</span> <span class="o">=</span> <span class="s">&quot;</span><span class="si">%s</span><span class="s">; Stacktrace: </span><span class="si">%s</span><span class="s"> &quot;</span> \
-                <span class="o">%</span> <span class="p">(</span><span class="n">exception_msg</span><span class="p">,</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">stacktrace</span><span class="p">))</span>
+                <span class="o">%</span> <span class="p">(</span><span class="n">exception_msg</span><span class="p">,</span> <span class="nb">str</span><span class="p">(</span><span class="s">&quot;</span><span class="se">\n</span><span class="s">&quot;</span> <span class="o">+</span> <span class="s">&quot;</span><span class="se">\n</span><span class="s">&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">stacktrace</span><span class="p">)))</span>
         <span class="k">return</span> <span class="n">exception_msg</span>
 </div>
 <div class="viewcode-block" id="ErrorInResponseException"><a class="viewcode-back" href="../../../common/selenium.common.exceptions.html#selenium.common.exceptions.ErrorInResponseException">[docs]</a><span class="k">class</span> <span class="nc">ErrorInResponseException</span><span class="p">(</span><span class="n">WebDriverException</span><span class="p">):</span>
@@ -116,6 +116,9 @@ <h1>Source code for selenium.common.exceptions</h1><div class="highlight"><pre>
 <div class="viewcode-block" id="InvalidElementStateException"><a class="viewcode-back" href="../../../common/selenium.common.exceptions.html#selenium.common.exceptions.InvalidElementStateException">[docs]</a><span class="k">class</span> <span class="nc">InvalidElementStateException</span><span class="p">(</span><span class="n">WebDriverException</span><span class="p">):</span>
     <span class="k">pass</span>
 </div>
+<div class="viewcode-block" id="UnexpectedAlertPresentException"><a class="viewcode-back" href="../../../common/selenium.common.exceptions.html#selenium.common.exceptions.UnexpectedAlertPresentException">[docs]</a><span class="k">class</span> <span class="nc">UnexpectedAlertPresentException</span><span class="p">(</span><span class="n">WebDriverException</span><span class="p">):</span>
+    <span class="k">pass</span>
+</div>
 <div class="viewcode-block" id="NoAlertPresentException"><a class="viewcode-back" href="../../../common/selenium.common.exceptions.html#selenium.common.exceptions.NoAlertPresentException">[docs]</a><span class="k">class</span> <span class="nc">NoAlertPresentException</span><span class="p">(</span><span class="n">WebDriverException</span><span class="p">):</span>
     <span class="k">pass</span>
 </div>

docs/api/py/_modules/selenium/selenium.html

@@ -64,10 +64,19 @@ <h1>Source code for selenium.selenium</h1><div class="highlight"><pre>
 <span class="sd">See the License for the specific language governing permissions and</span>
 <span class="sd">limitations under the License.</span>
 <span class="sd">&quot;&quot;&quot;</span>
+<span class="kn">from</span> <span class="nn">__future__</span> <span class="kn">import</span> <span class="n">unicode_literals</span>
+
 <span class="n">__docformat__</span> <span class="o">=</span> <span class="s">&quot;restructuredtext en&quot;</span>
 
-<span class="kn">import</span> <span class="nn">httplib</span>
-<span class="kn">import</span> <span class="nn">urllib</span>
+<span class="k">try</span><span class="p">:</span>
+    <span class="kn">import</span> <span class="nn">http.client</span> <span class="kn">as</span> <span class="nn">http_client</span>
+<span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span>
+    <span class="kn">import</span> <span class="nn">httplib</span> <span class="kn">as</span> <span class="nn">http_client</span>
+
+<span class="k">try</span><span class="p">:</span>
+    <span class="kn">import</span> <span class="nn">urllib.parse</span> <span class="kn">as</span> <span class="nn">urllib_parse</span>
+<span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span>
+    <span class="kn">import</span> <span class="nn">urllib</span> <span class="kn">as</span> <span class="nn">urllib_parse</span>
 
 <span class="k">class</span> <span class="nc">selenium</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
 <div class="viewcode-block" id="selenium"><a class="viewcode-back" href="../../selenium/selenium.selenium.html#selenium.selenium.selenium">[docs]</a>    <span class="sd">&quot;&quot;&quot;</span>
@@ -240,19 +249,19 @@ <h1>Source code for selenium.selenium</h1><div class="highlight"><pre>
         <span class="k">try</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">sessionId</span> <span class="o">=</span> <span class="n">result</span>
         <span class="k">except</span> <span class="ne">ValueError</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">Exception</span><span class="p">,</span> <span class="n">result</span>
+            <span class="k">raise</span> <span class="ne">Exception</span><span class="p">(</span><span class="n">result</span><span class="p">)</span>
 
     <span class="k">def</span> <span class="nf">stop</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span></div>
 <div class="viewcode-block" id="selenium.stop"><a class="viewcode-back" href="../../selenium/selenium.selenium.html#selenium.selenium.selenium.stop">[docs]</a>        <span class="bp">self</span><span class="o">.</span><span class="n">do_command</span><span class="p">(</span><span class="s">&quot;testComplete&quot;</span><span class="p">,</span> <span class="p">[])</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">sessionId</span> <span class="o">=</span> <span class="bp">None</span>
 
     <span class="k">def</span> <span class="nf">do_command</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">verb</span><span class="p">,</span> <span class="n">args</span><span class="p">):</span></div>
-<div class="viewcode-block" id="selenium.do_command"><a class="viewcode-back" href="../../selenium/selenium.selenium.html#selenium.selenium.selenium.do_command">[docs]</a>        <span class="n">conn</span> <span class="o">=</span> <span class="n">httplib</span><span class="o">.</span><span class="n">HTTPConnection</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">host</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">port</span><span class="p">)</span>
+<div class="viewcode-block" id="selenium.do_command"><a class="viewcode-back" href="../../selenium/selenium.selenium.html#selenium.selenium.selenium.do_command">[docs]</a>        <span class="n">conn</span> <span class="o">=</span> <span class="n">http_client</span><span class="o">.</span><span class="n">HTTPConnection</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">host</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">port</span><span class="p">)</span>
         <span class="k">try</span><span class="p">:</span>
-            <span class="n">body</span> <span class="o">=</span> <span class="s">u&#39;cmd=&#39;</span> <span class="o">+</span> <span class="n">urllib</span><span class="o">.</span><span class="n">quote_plus</span><span class="p">(</span><span class="nb">unicode</span><span class="p">(</span><span class="n">verb</span><span class="p">)</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="s">&#39;utf-8&#39;</span><span class="p">))</span>
+            <span class="n">body</span> <span class="o">=</span> <span class="s">&#39;cmd=&#39;</span> <span class="o">+</span> <span class="n">urllib_parse</span><span class="o">.</span><span class="n">quote_plus</span><span class="p">(</span><span class="nb">unicode</span><span class="p">(</span><span class="n">verb</span><span class="p">)</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="s">&#39;utf-8&#39;</span><span class="p">))</span>
             <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">args</span><span class="p">)):</span>
                 <span class="n">body</span> <span class="o">+=</span> <span class="s">&#39;&amp;&#39;</span> <span class="o">+</span> <span class="nb">unicode</span><span class="p">(</span><span class="n">i</span><span class="o">+</span><span class="mi">1</span><span class="p">)</span> <span class="o">+</span> <span class="s">&#39;=&#39;</span> <span class="o">+</span> \
-                        <span class="n">urllib</span><span class="o">.</span><span class="n">quote_plus</span><span class="p">(</span><span class="nb">unicode</span><span class="p">(</span><span class="n">args</span><span class="p">[</span><span class="n">i</span><span class="p">])</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="s">&#39;utf-8&#39;</span><span class="p">))</span>
+                        <span class="n">urllib_parse</span><span class="o">.</span><span class="n">quote_plus</span><span class="p">(</span><span class="nb">unicode</span><span class="p">(</span><span class="n">args</span><span class="p">[</span><span class="n">i</span><span class="p">])</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="s">&#39;utf-8&#39;</span><span class="p">))</span>
             <span class="k">if</span> <span class="p">(</span><span class="bp">None</span> <span class="o">!=</span> <span class="bp">self</span><span class="o">.</span><span class="n">sessionId</span><span class="p">):</span>
                 <span class="n">body</span> <span class="o">+=</span> <span class="s">&quot;&amp;sessionId=&quot;</span> <span class="o">+</span> <span class="nb">unicode</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">sessionId</span><span class="p">)</span>
             <span class="n">headers</span> <span class="o">=</span> <span class="p">{</span>
@@ -264,7 +273,7 @@ <h1>Source code for selenium.selenium</h1><div class="highlight"><pre>
             <span class="n">response</span> <span class="o">=</span> <span class="n">conn</span><span class="o">.</span><span class="n">getresponse</span><span class="p">()</span>
             <span class="n">data</span> <span class="o">=</span> <span class="nb">unicode</span><span class="p">(</span><span class="n">response</span><span class="o">.</span><span class="n">read</span><span class="p">(),</span> <span class="s">&quot;UTF-8&quot;</span><span class="p">)</span>
             <span class="k">if</span> <span class="p">(</span><span class="ow">not</span> <span class="n">data</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s">&#39;OK&#39;</span><span class="p">)):</span>
-                <span class="k">raise</span> <span class="ne">Exception</span><span class="p">,</span> <span class="n">data</span>
+                <span class="k">raise</span> <span class="ne">Exception</span><span class="p">(</span><span class="n">data</span><span class="p">)</span>
             <span class="k">return</span> <span class="n">data</span>
         <span class="k">finally</span><span class="p">:</span>
             <span class="n">conn</span><span class="o">.</span><span class="n">close</span><span class="p">()</span>
@@ -313,7 +322,7 @@ <h1>Source code for selenium.selenium</h1><div class="highlight"><pre>
             <span class="k">return</span> <span class="bp">True</span>
         <span class="k">if</span> <span class="p">(</span><span class="s">&quot;false&quot;</span> <span class="o">==</span> <span class="n">boolstr</span><span class="p">):</span>
             <span class="k">return</span> <span class="bp">False</span>
-        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">,</span> <span class="s">&quot;result is neither &#39;true&#39; nor &#39;false&#39;: &quot;</span> <span class="o">+</span> <span class="n">boolstr</span>
+        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s">&quot;result is neither &#39;true&#39; nor &#39;false&#39;: &quot;</span> <span class="o">+</span> <span class="n">boolstr</span><span class="p">)</span>
 
     <span class="k">def</span> <span class="nf">get_boolean_array</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">verb</span><span class="p">,</span> <span class="n">args</span><span class="p">):</span></div>
 <div class="viewcode-block" id="selenium.get_boolean_array"><a class="viewcode-back" href="../../selenium/selenium.selenium.html#selenium.selenium.selenium.get_boolean_array">[docs]</a>        <span class="n">boolarr</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_string_array</span><span class="p">(</span><span class="n">verb</span><span class="p">,</span> <span class="n">args</span><span class="p">)</span>
@@ -324,7 +333,7 @@ <h1>Source code for selenium.selenium</h1><div class="highlight"><pre>
             <span class="k">if</span> <span class="p">(</span><span class="s">&quot;false&quot;</span> <span class="o">==</span> <span class="n">boolstr</span><span class="p">):</span>
                 <span class="n">boolarr</span><span class="p">[</span><span class="n">i</span><span class="p">]</span> <span class="o">=</span> <span class="bp">False</span>
                 <span class="k">continue</span>
-            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">,</span> <span class="s">&quot;result is neither &#39;true&#39; nor &#39;false&#39;: &quot;</span> <span class="o">+</span> <span class="n">boolarr</span><span class="p">[</span><span class="n">i</span><span class="p">]</span>
+            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s">&quot;result is neither &#39;true&#39; nor &#39;false&#39;: &quot;</span> <span class="o">+</span> <span class="n">boolarr</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
         <span class="k">return</span> <span class="n">boolarr</span>
 
 

docs/api/py/_modules/selenium/webdriver/chrome/service.html

@@ -140,8 +140,12 @@ <h1>Source code for selenium.webdriver.chrome.service</h1><div class="highlight"
             <span class="k">return</span>
 
         <span class="c">#Tell the Server to die!</span>
-        <span class="kn">import</span> <span class="nn">urllib2</span>
-        <span class="n">urllib2</span><span class="o">.</span><span class="n">urlopen</span><span class="p">(</span><span class="s">&quot;http://127.0.0.1:</span><span class="si">%d</span><span class="s">/shutdown&quot;</span> <span class="o">%</span> <span class="bp">self</span><span class="o">.</span><span class="n">port</span><span class="p">)</span>
+        <span class="k">try</span><span class="p">:</span>
+            <span class="kn">from</span> <span class="nn">urllib</span> <span class="kn">import</span> <span class="n">request</span> <span class="k">as</span> <span class="n">url_request</span>
+        <span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span>
+            <span class="kn">import</span> <span class="nn">urllib2</span> <span class="kn">as</span> <span class="nn">url_request</span>
+
+        <span class="n">url_request</span><span class="o">.</span><span class="n">urlopen</span><span class="p">(</span><span class="s">&quot;http://127.0.0.1:</span><span class="si">%d</span><span class="s">/shutdown&quot;</span> <span class="o">%</span> <span class="bp">self</span><span class="o">.</span><span class="n">port</span><span class="p">)</span>
         <span class="n">count</span> <span class="o">=</span> <span class="mi">0</span>
         <span class="k">while</span> <span class="n">utils</span><span class="o">.</span><span class="n">is_connectable</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">port</span><span class="p">):</span>
             <span class="k">if</span> <span class="n">count</span> <span class="o">==</span> <span class="mi">30</span><span class="p">:</span>

docs/api/py/_modules/selenium/webdriver/chrome/webdriver.html

@@ -66,12 +66,11 @@ <h1>Source code for selenium.webdriver.chrome.webdriver</h1><div class="highligh
 <span class="c"># limitations under the License.</span>
 
 <span class="kn">import</span> <span class="nn">base64</span>
-<span class="kn">import</span> <span class="nn">httplib</span>
 <span class="kn">from</span> <span class="nn">selenium.webdriver.remote.command</span> <span class="kn">import</span> <span class="n">Command</span>
 <span class="kn">from</span> <span class="nn">selenium.webdriver.remote.webdriver</span> <span class="kn">import</span> <span class="n">WebDriver</span> <span class="k">as</span> <span class="n">RemoteWebDriver</span>
 <span class="kn">from</span> <span class="nn">selenium.common.exceptions</span> <span class="kn">import</span> <span class="n">WebDriverException</span>
-<span class="kn">from</span> <span class="nn">service</span> <span class="kn">import</span> <span class="n">Service</span>
-<span class="kn">from</span> <span class="nn">options</span> <span class="kn">import</span> <span class="n">Options</span>
+<span class="kn">from</span> <span class="nn">.service</span> <span class="kn">import</span> <span class="n">Service</span>
+<span class="kn">from</span> <span class="nn">.options</span> <span class="kn">import</span> <span class="n">Options</span>
 
 <div class="viewcode-block" id="WebDriver"><a class="viewcode-back" href="../../../../webdriver_chrome/selenium.webdriver.chrome.webdriver.html#selenium.webdriver.chrome.webdriver.WebDriver">[docs]</a><span class="k">class</span> <span class="nc">WebDriver</span><span class="p">(</span><span class="n">RemoteWebDriver</span><span class="p">):</span>
     <span class="sd">&quot;&quot;&quot;</span>