Splinter

========

Added
-----

* The methods WebDriverElement.is_visible() and WebDriverElement.is_not_visible() are now available as a replacement for WebDriver.is_element_not_visible_by_css and WebDriver.is_element_visible_by_css.
See https://splinter.readthedocs.io/en/latest/matchers.html#checking-the-visibility-of-elements for more information.

Changed
-------

* When CookieManager.delete() is called with no arguments then all cookies are deleted. This behaviour has been deprecated. CookieManager.delete_all() should be used instead.
* The message for the error raised when a driver's class is not found has been improved.

Fixed
-----

* FlaskDriver.attach_file() has been fixed.
* urllib3 is now always installed, regardless of driver used.

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

Changed:
* Set Firefox preferences through options instead of FirefoxProfile

Fixed:
* Use dedicated logger in browser.py to avoid clobbing other Python logging
* Removed required selenium import for error handling, making it possible to use splinter without installing selenium (as long as a selenium driver isn't used)

Added:

* WebDriverElement() now implements the `shadow_root` property. This returns a ShadowRootElement() object to interact with the shadow root of an element.
* Failed driver imports are logged at the debug level instead of silently ignored
* `browser.html_snapshot()` now takes the optional `unique_file` argument. Setting this to False will disable the addition of random characters to the filename.

Changed:

* repr(ElementList()) now returns the repr of the internal container.
* Driver.find_link_by_<x> methods have been removed. Use Driver.links.find_by_<x>.
* Screenshot taken by WebDriverElement.screenshot() now implements Selenium's element screenshot instead of cropping a full page screenshot.
* Flask/Django's back/forward methods more accurately store browsing history
* Official Python 3.6 support has been removed

Fixed:

* 0.17.0 would report as 0.16.0. 0.18.0 reports correctly.
* When using Firefox, extensions can now be installed

* Added parameter to DriverAPI.screenshot and ElementAPI.screenshot to indicate if unique filename should be ensured (https://github.com/cobrateam/splinter/pull/949)
* Added Selenium 4 support

Backward incompatible changes

* Removed python 2.7 support (https://github.com/cobrateam/splinter/pull/952)
* Selenium 3 is no longer installed by default. To install Selenium 3, use the `selenium3` extra argument

* Pin Selenium < 4.0 (https://github.com/cobrateam/splinter/pull/930)
* Add support for Microsoft Edge (https://github.com/cobrateam/splinter/pull/912)
* Accept extra arguments for cookies (https://github.com/cobrateam/splinter/pull/895)
* Fix lxmldriver url join when form action is empty (https://github.com/cobrateam/splinter/pull/900)
* Use io.open() to fix encoding issues on some platforms (https://github.com/cobrateam/splinter/pull/904)
* allow passing options to Firefox webdriver (https://github.com/cobrateam/splinter/pull/892)

Backward incompatible changes

* Remove sending a list of cookie dicts to CookieManager.add() (https://github.com/cobrateam/splinter/pull/799)

* Add more input types to Webdriver clear() (https://github.com/cobrateam/splinter/pull/780)
* Standardize init of CookieManager (https://github.com/cobrateam/splinter/pull/795)
* Add delete_all method to CookieManager (https://github.com/cobrateam/splinter/pull/797)
* Warn user when cookies list is used (https://github.com/cobrateam/splinter/pull/801)
* Added retry_count to get_driver (https://github.com/cobrateam/splinter/pull/754)
* Fix full screen screenshot (https://github.com/cobrateam/splinter/pull/810)
* Add flag to ignore missing fields in fill_form (https://github.com/cobrateam/splinter/pull/821)
* Opening a link in a new tab (https://github.com/cobrateam/splinter/pull/800)