initial commit

2026-06-25 21:29:21 +00:00
commit 0d0a7456de
2738 changed files with 542622 additions and 0 deletions
@@ -0,0 +1,217 @@
+Metadata-Version: 2.1
+Name: selenium
+Home-page: https://www.selenium.dev
+License: Apache-2.0
+Description-Content-Type: text/x-rst
+Summary: Official Python bindings for Selenium WebDriver
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.10
+Requires-Dist: certifi>=2026.1.4
+Requires-Dist: trio>=0.31.0,<1.0
+Requires-Dist: trio-websocket>=0.12.2,<1.0
+Requires-Dist: typing_extensions>=4.15.0,<5.0
+Requires-Dist: urllib3[socks]>=2.6.3,<3.0
+Requires-Dist: websocket-client>=1.8.0,<2.0
+Version: 4.43.0
+
+======================
+Selenium Client Driver
+======================
+
+Introduction
+============
+
+Python language bindings for Selenium WebDriver.
+
+The `selenium` package is used to automate web browser interaction from Python.
+
+-------------------+--------------------------------------------------------+
+| **Home**:         | https://selenium.dev                                   |
+-------------------+--------------------------------------------------------+
+| **GitHub**:       | https://github.com/SeleniumHQ/Selenium                 |
+-------------------+--------------------------------------------------------+
+| **PyPI**:         | https://pypi.org/project/selenium                      |
+-------------------+--------------------------------------------------------+
+| **IRC/Slack**:    | https://www.selenium.dev/support/#ChatRoom             |
+-------------------+--------------------------------------------------------+
+| **Docs**:         | https://www.selenium.dev/selenium/docs/api/py          |
+-------------------+--------------------------------------------------------+
+| **API Reference**:| https://www.selenium.dev/selenium/docs/api/py/api.html |
+-------------------+--------------------------------------------------------+
+
+Updated documentation published with each commit is available at: `readthedocs.io <https://selenium-python-api-docs.readthedocs.io/en/latest>`_
+
+----
+
+Supported Python Versions
+=========================
+
+* Python 3.10+
+
+Supported Browsers
+==================
+
+Several browsers are supported, as well as the Remote protocol:
+
+* Chrome
+* Edge
+* Firefox
+* Safari
+* WebKitGTK
+* WPEWebKit
+
+Installing
+==========
+
+Install or upgrade the Python bindings with `pip <https://pip.pypa.io/>`.
+
+Latest official release::
+
+    pip install -U selenium
+
+Nightly development release::
+
+    pip install -U --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ selenium
+
+Note: you should consider using a
+`virtual environment <https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments>`_
+to create an isolated Python environment for installation.
+
+Drivers
+=======
+
+Selenium requires a driver to interface with the chosen browser (chromedriver, edgedriver, geckodriver, etc).
+
+In older versions of Selenium, it was necessary to install and manage these drivers yourself. You had to make sure the
+driver executable was available on your system `PATH`, or specified explicitly in code. Modern versions of Selenium
+handle browser and driver installation for you with
+`Selenium Manager <https://www.selenium.dev/documentation/selenium_manager>`_. You generally don't have to worry about
+driver installation or configuration now that it's done for you when you instantiate a WebDriver. Selenium Manager works
+with most supported platforms and browsers. If it doesn't meet your needs, you can still install and specify browsers
+and drivers yourself.
+
+Links to some of the more popular browser drivers:
+
+--------------+-----------------------------------------------------------------------+
+| **Chrome**:  | https://developer.chrome.com/docs/chromedriver                        |
+--------------+-----------------------------------------------------------------------+
+| **Edge**:    | https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver  |
+--------------+-----------------------------------------------------------------------+
+| **Firefox**: | https://github.com/mozilla/geckodriver                                |
+--------------+-----------------------------------------------------------------------+
+| **Safari**:  | https://webkit.org/blog/6900/webdriver-support-in-safari-10           |
+--------------+-----------------------------------------------------------------------+
+
+Example 0:
+==========
+
+* launch a new Chrome browser
+* load a web page
+* close the browser
+
+.. code-block:: python
+
+    from selenium import webdriver
+
+
+    driver = webdriver.Chrome()
+    driver.get('https://selenium.dev/')
+    driver.quit()
+
+Example 1:
+==========
+
+* launch a new Chrome browser
+* load the Selenium documentation page
+* find the "Webdriver" link
+* click the "WebDriver" link
+* close the browser
+
+.. code-block:: python
+
+    from selenium import webdriver
+    from selenium.webdriver.common.by import By
+
+
+    driver = webdriver.Chrome()
+
+    driver.get('https://selenium.dev/documentation')
+    assert 'Selenium' in driver.title
+
+    elem = driver.find_element(By.ID, 'm-documentationwebdriver')
+    elem.click()
+    assert 'WebDriver' in driver.title
+
+    driver.quit()
+
+Example 2:
+==========
+
+Selenium WebDriver is often used as a basis for testing web applications. Here is a simple example using Python's
+standard `unittest <http://docs.python.org/3/library/unittest.html>`_ library:
+
+.. code-block:: python
+
+    import unittest
+    from selenium import webdriver
+
+
+    class GoogleTestCase(unittest.TestCase):
+
+        def setUp(self):
+            self.driver = webdriver.Firefox()
+            self.addCleanup(self.driver.quit)
+
+        def test_page_title(self):
+            self.driver.get('https://www.google.com')
+            self.assertIn('Google', self.driver.title)
+
+    if __name__ == '__main__':
+        unittest.main(verbosity=2)
+
+Selenium Grid (optional)
+==========================
+
+For local Selenium scripts, the Java server is not needed.
+
+To use Selenium remotely, you need to also run a Selenium Grid. For information on running Selenium Grid:
+https://www.selenium.dev/documentation/grid/getting_started/
+
+To use Remote WebDriver see: https://www.selenium.dev/documentation/webdriver/drivers/remote_webdriver/?tab=python
+
+Use The Source Luke!
+====================
+
+View source code online:
+
+---------------+-------------------------------------------------------+
+| **Official**: | https://github.com/SeleniumHQ/selenium/tree/trunk/py  |
+---------------+-------------------------------------------------------+
+
+Contributing
+=============
+
+ - Fork the selenium repo
+ - Clone your fork locally
+ - Create a branch for your work
+     - `git checkout -b my-cool-branch-name`
+ - Create a virtual environment and install tox
+     - `python -m venv venv && source venv/bin/activate && pip install tox`
+ - Make your changes
+ - Run the linter/formatter
+     - `tox -e linting`
+ - If tox exits `0`, commit and push. Otherwise, fix the newly introduced style violations
+ - Submit a Pull Request
+