Skip to main content

Ready-to-run Selenium.

Project description

AutoSelenium: Ready-to-run Selenium

This Python 3 library solves most of the problems usually found when using Selenium.

Installing

  1. Install a version of Firefox compatible with geckodriver 0.26.0 (see this compatibility table)
  2. Install this library via pip using: pip install autoselenium

Usage

>>> from autoselenium import Firefox
>>>
>>> driver = Firefox(headless=True)
>>>
>>> driver.get('https://juancroldan.com')
>>> driver.find_element_by_tag_name('div').get_attribute('outerHTML')
'<div id="mw-page-base" class="noprint"></div>'
>>>
>>> driver.get_with_render('https://juancroldan.com')
>>> driver.find_element_by_tag_name('div').get_attribute('outerHTML')
'<div id="mw-page-base" class="noprint"\
	data-xpath="/html[1]/body[1]/div[1]"\
	data-computed-style="align-content:normal;align-items:normal;...;z-index:auto"\
	data-width="1356" data-height="80"\
	data-width-rel="1" data-height-rel="0.11527377521613832"></div>'

This library only have one class: Firefox, a child of selenium.drivers.Firefox with extended construction parameters:

  • headless: A boolean, False by default. When true, the Firefox interface won't be shown.
  • detect_driver_path: A boolean, True by default. When true, geckodriver will be automatically located and downloaded.
  • disable_images: A boolean, True by default. When true, images won't be loaded to improve the performance.
  • disable_flash: A boolean, True by default. When true, Flash will be disabled.
  • open_links_same_tab: A boolean, False by default. When true, even new tab links will be opened in the same tab.
  • timeout: An integer, 15 by default. Page load timeout.
  • version: A string, 0.26.0 by default. If detect_driver_path is set, this geckodriver version will be downloaded. When a new geckodriver is relased, it is tested with the latest Selenium version to use the most recent compatible version.
  • Any of the Selenium Firefox parameters.

It also implements one extra function, driver.get_with_render(url, render_selector='body'), which works the same way as driver.get(url), processing the nodes selected by render_selector with a few rendering operations:

  • Nodes without rendering are removed.
  • For every node and child, a few data properties are added:
    • data-xpath: XPath of the node.
    • data-computed-style: Computed style of the nodes, using the same notation of the style element attribute.
    • data-width: Width of the node.
    • data-height: Height of the node.
    • data-width-rel: Width of the node relative to the page width.
    • data-height-rel: Height of the node relative to the page height.

Features

  • Full Selenium compatibility: the automatic drivers inherit the Selenium driver, so every available functionality is preserved.
  • Geckodriver management: a valid Geckodriver is automatically downloaded, unzipped and stored according to the Selenium version and operative system.
  • Updated defaults: some of the most common driver configurations are automatically set, such as disabling Flash, ignoring the txt log file or closing the driver when the program ends. All of them can be edited via construction params.
  • Rendering analysis: the rendering features such as computed style, width, height or XPath are added to the page source when using driver.get_with_render instead of driver.get.

Contributions ✨

You can take any of the pending enhancements, work on it and open a pull request.

Changes

Find here the changes on this library (from recent to older) and the features of each version. We follow Semantic Versioning 2.0.0 guidelines to improve the dependency management automation.

v0.1.0

Relased on Oct 28, 2019.

  • More helpful exceptions (including install exceptions).
  • Friendlier readme.
  • Bugfix: now compatible with any Python 3 library.

v0.0.1

Released on Oct 10, 2019.

  • Initial package upload.
  • Removed table-specific features.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

autoselenium-0.1.10.tar.gz (6.9 kB view details)

Uploaded Source

Built Distribution

autoselenium-0.1.10-py3-none-any.whl (7.3 kB view details)

Uploaded Python 3

File details

Details for the file autoselenium-0.1.10.tar.gz.

File metadata

  • Download URL: autoselenium-0.1.10.tar.gz
  • Upload date:
  • Size: 6.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.11.3 pkginfo/1.7.1 requests/2.27.1 requests-toolbelt/0.9.1 tqdm/4.61.2 CPython/3.9.1

File hashes

Hashes for autoselenium-0.1.10.tar.gz
Algorithm Hash digest
SHA256 3b7a67b39e99cb215a6172196452a3cf7d957e0404082d97fa25217ba4c3d76a
MD5 3049e8f7d25206c00e2d5db81a913909
BLAKE2b-256 6088e931435a9a2736945b839f7fe96bee36320c440fa3a9f2525e3e43eb5c5d

See more details on using hashes here.

Provenance

File details

Details for the file autoselenium-0.1.10-py3-none-any.whl.

File metadata

  • Download URL: autoselenium-0.1.10-py3-none-any.whl
  • Upload date:
  • Size: 7.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.11.3 pkginfo/1.7.1 requests/2.27.1 requests-toolbelt/0.9.1 tqdm/4.61.2 CPython/3.9.1

File hashes

Hashes for autoselenium-0.1.10-py3-none-any.whl
Algorithm Hash digest
SHA256 6c4b1537eb4c3e20228081e1d0580b9422b11ffc04d99af7baacfeca55bd27d8
MD5 11cc668c7420625cf071b699d1fa268a
BLAKE2b-256 82b5f886c264c5cba3271a5b5af7e4e4e9a62c2b98eb0ffd34022f5f6062772c

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page