se

selenium_extensions

Tools that will make writing tests, bots and scrapers using Selenium much easier

Showing:

Popularity

Downloads/wk

0

GitHub Stars

139

Maintenance

Last Commit

3yrs ago

Contributors

4

Package

Dependencies

0

License

MIT license

Categories

Readme

===================

Selenium extensions

.. image:: https://img.shields.io/pypi/pyversions/selenium_extensions.svg :target: https://pypi.python.org/pypi/selenium_extensions :alt: Supported python versions

.. image:: https://img.shields.io/pypi/v/selenium_extensions.svg :target: https://pypi.python.org/pypi/selenium_extensions :alt: PyPI version

.. image:: https://readthedocs.org/projects/selenium_extensions/badge/?version=latest :target: https://selenium_extensions.readthedocs.io/en/latest/?badge=latest :alt: Documentation Status

.. image:: https://pyup.io/repos/github/pythad/selenium_extensions/shield.svg :target: https://pyup.io/repos/github/pythad/selenium_extensions/ :alt: Updates

.. image:: https://img.shields.io/github/license/pythad/selenium_extensions.svg :target: https://pypi.python.org/pypi/selenium_extensions :alt: License

Tools that will make writing tests, bots and scrapers using Selenium much easier


Installation


.. code-block:: console

$ pip install selenium_extensions

Example


Creating a headless Selenium bot and filling in a form is as easy as

.. code-block:: python

from selenium.webdriver.common.by import By
from selenium_extensions.core import SeleniumDriver


class MyBot(SeleniumDriver):

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)

    def goto_google(self):
        self.driver.get('https://google.com')
        searchbox_locator = (By.ID, 'lst-ib')
        self.wait_for_element_to_be_present(searchbox_locator)
        self.populate_text_field(searchbox_locator, 'query')


bot = MyBot(browser='chrome', executable_path='/usr/bin/chromedriver', run_headless=True)
bot.goto_google()
bot.shut_down()

Or do you want to wait until you will be redirected from login page? selenium_extensions makes it easy

.. code-block:: python

from selenium_extensions.helpers import wait_for_function_truth
from selenium_extensions.helpers import element_has_gone_stale


...
login_btn = self.driver.find_element_by_css_selector(
    "button.submit.EdgeButton.EdgeButton--primary")
login_btn.click()

# Wait to be redirected
wait_for_function_truth(element_has_gone_stale, login_btn)

Features


  • selenium_extensions.drivers.chrome_driver - extended Chrome webdriver class with built-in support for headless mode and rendering webpages without media.
  • selenium_extensions.drivers.firefox_driver - extended Firefox webdriver class with built-in support for headless mode and rendering webpages without media.
  • selenium_extensions.core.scroll - scrolls the current page or the Selenium WebElement if one is provided.
  • selenium_extensions.core.element_is_present - shortcut to check if the element is present on the current page.
  • selenium_extensions.core.wait_for_element_to_be_clickable - waits for element described by element_locator to be clickable.
  • selenium_extensions.helpers.element_has_gone_stale - checks if element has gone stale.
  • selenium_extensions.core.SeleniumDriver - class with all necessary tools in one place. User's classes should inherit from this class and initialize it using super(). After this their class will have driver attribute and all the methods ready to go.

and more.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100