Toolium

------

*Release date: 2024-02-02*

- Add support for Python 3.12
- Upgrade Sphinx version from 4.* to 7.* to fix readthedocs theme format
- Upgrade readthedocs-sphinx-search to 0.3.2 to fix security vulnerability
- Do not log warning messages when toolium system properties are used
- Allow to initialize a `PageElements` class with webview attributes

------

*Release date: 2023-09-19*

- Update `[CONTEXT:a.b.c]` replacement to allow lists access, e.g. [CONTEXT:list.1] to access the second element of list
- Add capabilities configured in `[Capabilities]` section also to Appium tests to use `platformName` and `browserName`
w3c capabilities instead of Appium ones
- `platformVersion` Appium capability must be a string
- Add optional parameter to `compare_downloaded_files` method to allow to compare files with different names
- Remove Python 3.7 support (Python 3.7 reached the end of its life on June 27th, 2023)
- Update _android_automatic_context_selection method to be compatible with latest chromedriver versions

------

*Release date: 2023-06-08*

- `context.storage` must be initialized before dynamic environment steps in `before_feature` method
- Mark scenario as failed when a dynamic environment step fails in `before_scenario`
- Mark all feature scenarios as failed when a dynamic environment step fails in `before_feature` and `after_feature`
- Configure minimal Appium-Python-Client version to 2.3.0 to avoid import errors

------

*Release date: 2023-05-09*

- Allow to search in `context.storage` using `[CONTEXT:a.b.c]` replacement when `before_feature` method is not used
- Execute after scenario methods also when a scenario is skipped to assure that scenario preconditions are cleaned
- Fix `[LANG:key]` replacement bug when it contains carriage returns
- `context.storage` must be initialized before dynamic environment steps in `before_scenario` method
- Fix error in Python 3.11 executing nose2 tests

------

*Release date: 2023-05-03*

- Add support for Python 3.11
- Add support for Selenium 4
- Add support for Appium-Python-Client 2
- Visual testing comparison has changed

| It only needs PIL library to compare images and generate the differences images
| Old PerceptualDiff and Magick engines have been removed
| Config property `engine` in [VisualTests] section has been removed
| Images distance calculation method has changed, it is recommended to review thresholds in tests

- Now `gecko_driver_path`, `chrome_driver_path`, `explorer_driver_path` and `edge_driver_path` config properties
in [Driver] section are optional, due to new SeleniumManager feature, that downloads drivers automatically
- New optional config property `safari_driver_path` in [Driver] section to configure Safari driver
- New optional config property `options` in [Chrome] section to configure Chrome options instead of using old
property `goog:chromeOptions` in [Capabilities] section.
- New optional config property `base_path` in [Server] section to allow using old Selenium 3 or Appium 1 remote servers
- Remove support for lettuce tests
- Remove deprecated parameter `context` from `map_param` and POEditor methods
- Remove deprecated config property `restart_driver_fail` in [Driver] section
- Remove deprecated environment variables `Section_option`, `Config_environment` and `env`
- Update `[RANDOM_PHONE_NUMBER]` replacement using new `DataGenerator` class
- Update `[CONTEXT:a.b.c]` replacement to search data in context, context.storage and context.feature_storage
- Update `[CONTEXT:a.b.c]` replacement to allow dictionaries or classes in context fields

------

*Release date: 2023-02-24*

- Fix drivers not being closed in `after_feature` when errors occur during `before_feature` steps execution
- Allow to add extensions to chrome options from properties file

New config section [ChromeExtensions] with extensions file paths, e.g. 'firebug: resources/firebug-lite.crx'