|
1 | 1 | Magento Functional Testing Framework Changelog
|
2 | 2 | ================================================
|
3 |
| -2.6.3 |
| 3 | +3.0.0 |
| 4 | +--------- |
| 5 | + |
| 6 | +### Enhancements |
| 7 | + |
| 8 | +* Customizability |
| 9 | + * Introduced MFTF helpers `<helper>` to create custom actions outside of MFTF.[See custom-helpers page for details](./docs/custom-helpers.md) |
| 10 | + * Removed deprecated actions `<executeSelenium>` and `<performOn>`. |
| 11 | + * `<group value="skip"/>` no longer skips a test. Instead, the test is added to the `skip` group. |
| 12 | + |
| 13 | +* Maintainability |
| 14 | + * Added support for PHP 7.4. |
| 15 | + * Added support for PHPUnit 9. |
| 16 | + * Dropped support for PHP 7.0, 7.1, 7.2. |
| 17 | + * Schema updates for test entities to only allow single entity per file except Data and Metadata. |
| 18 | + * Support for sub-folders in test modules. |
| 19 | + * Removed support to read test entities from `<magento>dev/tests/acceptance/tests/functional/Magento/FunctionalTest`. |
| 20 | + * Removed file attribute for `<module>` in suiteSchema. |
| 21 | + * Removed action `pauseExecution` and added `pause`. [See actions page for details](./docs/test/actions.md#pause) |
| 22 | + * Removed action `formatMoney` and added `formatCurrency`. [See actions page for details](./docs/test/actions.md#formatcurrency) |
| 23 | + * Improved assertion actions to support PHPUnit 9 changes. [See assertions page for details](./docs/test/assertions.md) |
| 24 | + * Added new actions: `assertEqualsWithDelta`, `assertNotEqualsWithDelta`, `assertEqualsCanonicalizing`, `assertNotEqualsCanonicalizing`, `assertEqualsIgnoringCase`, `assertNotEqualsIgnoringCase`. |
| 25 | + * Added new actions: `assertStringContainsString`, `assertStringNotContainsString`, `assertStringContainsStringIgnoringCase`, `assertStringNotContainsStringIgnoringCase` for string haystacks. |
| 26 | + * Removed actions: `assertInternalType`, `assertNotInternalType`, `assertArraySubset`. |
| 27 | + * Removed delta option from `assertEquals` and `assertNotEquals`. |
| 28 | + * Added static check `deprecatedEntityUsage` that checks and reports references to deprecated test entities. |
| 29 | + * Added static check `annotations` that checks and reports missing annotations in tests. |
| 30 | + * Updated `bin/mftf static-checks` command to allow executing static-checks defined in `staticRuleSet.json` by default. [See command page for details](./docs/commands/mftf.md#static-checks) |
| 31 | + * Added support for Two-Factor Authentication (2FA). [See configure-2fa page for details](./docs/configure-2fa.md) |
| 32 | + * Added new upgrade script to remove unused arguments from action groups. |
| 33 | + * `mftf.log` no longer includes notices and warnings at test execution time. |
| 34 | + * Added unhandledPromptBehavior driver capability for Chrome 75+ support. |
| 35 | + * Added the Chrome option `--ignore-certificate-errors` to `functional.suite.dist.yml`. |
| 36 | + |
| 37 | +* Traceability |
| 38 | + * Removed `--debug` option `NONE` to disallow ability to turn off schema validation. |
| 39 | + * Notices added for test entity naming convention violations. |
| 40 | + * Metadata file names changed to `*Meta.xml`. |
| 41 | + * Introduced new `.env` configuration `VERBOSE_ARTIFACTS` to toggle saving attachments in Allure. [See configuration page for details](./docs/configuration.md) |
| 42 | + * Changed the `bin/mftf static-checks` error file directory from the current working directory to `TESTS_BP/tests/_output/static-results/`. |
| 43 | + |
| 44 | +* Readability |
| 45 | + * Support only nested assertion syntax [See assertions page for details](./docs/test/assertions.md). |
| 46 | + * Documented [3.0.0 Backward Incompatible Changes](./docs/backward-incompatible-changes.md). |
| 47 | + * Removed blacklist/whitelist terminology in MFTF. |
| 48 | + |
| 49 | +* Upgrade scripts added to upgrade tests to MFTF major version requirements. See upgrade instructions below. |
| 50 | +* Bumped dependencies to support PHP/PHPUnit upgrade. |
| 51 | + |
| 52 | +### Upgrade Instructions |
| 53 | + |
| 54 | +* Run `bin/mftf reset --hard` to remove old generated configurations. |
| 55 | +* Run `bin/mftf build:project` to generate new configurations. |
| 56 | +* Run `bin/mftf upgrade:tests`. [See command page for details](./docs/commands/mftf.md#upgradetests). |
| 57 | +* After running the above command, some tests may need manually updates: |
| 58 | + * Remove all occurrences of `<executeInSelenium>` and `<performOn>`. |
| 59 | + * Remove all occurrences of `<module file=""/>` from any `<suite>`s. |
| 60 | + * Ensure all `<assert*>` actions in your tests have a valid schema. |
| 61 | +* Lastly, try to generate all tests. Tests should all be generated as a result of the upgrades. |
| 62 | + * If not, the most likely issue will be a changed XML schema. Check error messaging and search your codebase for the attributes listed. |
| 63 | + |
| 64 | +### Fixes |
| 65 | + |
| 66 | +* Throw exception during generation when leaving out .url for `amOnPage`. |
| 67 | +* `request_timeout` and `connection_timeout` added to functional.suite.yml.dist. |
| 68 | +* Fixed `ModuleResolver` to resolve test modules moved out of deprecated path. |
| 69 | +* Fixed issue of resolving arguments of type `entity` in action groups within a custom helper. |
| 70 | +* Fixed reporting issue in output file for `testDependencies` static check. |
| 71 | +* Fixed a bug in `actionGroupArguments` static check when action group filename is missing `ActionGroup`. |
| 72 | +* Fixed issue of running suites under root `_suite` directory in Standalone MFTF. |
| 73 | +* Fixed issue with custom helper usage in suites. |
| 74 | +* Fixed issue with decryption of secrets during data entity creation. |
| 75 | +* Fixed issue with merging of `array` items in data entity. |
| 76 | +* Fixed issue where an extended data entity would not merge array items. Array items should merge properly now. |
| 77 | +* Fixed issue where Chrome remains running after MFTF suite finishes. |
| 78 | +* Fixed javascript error seen on Chrome 83 for dragAndDrop action. |
| 79 | +* Fixed allure issue when `WebDriverCurlException` is encountered in `afterStep`. |
| 80 | + |
| 81 | +### GitHub Issues/Pull Requests |
| 82 | + |
| 83 | +* [#567](https://github.com/magento/magento2-functional-testing-framework/pull/567) -- log attachments for failed requests. |
| 84 | + |
| 85 | +### Demo Video links |
| 86 | + |
| 87 | +* [MFTF 3.0.0 RC1](https://www.youtube.com/watch?v=z0ZaZCmnw-A&t=2s) |
| 88 | +* [MFTF 3.0.0 RC2](https://www.youtube.com/watch?v=BJOQAw6dX5o) |
| 89 | +* [MFTF 3.0.0 RC3](https://www.youtube.com/watch?v=scLb7pi8pR0) |
| 90 | + |
| 91 | +2.6.4 |
4 | 92 | -----
|
5 | 93 |
|
6 | 94 | ### Fixes
|
@@ -70,9 +158,9 @@ Magento Functional Testing Framework Changelog
|
70 | 158 | * Command verifies and troubleshoots some configuration steps required for running tests
|
71 | 159 | * Please see DevDocs for more details
|
72 | 160 | * `<*Data>` actions now contain `API Endpoint` and `Request Header` artifacts.
|
73 |
| - * Introduced new `.env` configurations `ENABLE_BROWSER_LOG` and `BROWSER_LOG_BLACKLIST` |
| 161 | + * Introduced new `.env` configurations `ENABLE_BROWSER_LOG` and `BROWSER_LOG_BLOCKLIST` |
74 | 162 | * Configuration enables allure artifacts for browser log entries if they are present after the step.
|
75 |
| - * Blacklist filters out logs from specific sources. |
| 163 | + * Blocklist filters out logs from specific sources. |
76 | 164 | * Customizability
|
77 | 165 | * Introduced `timeout=""` to `magentoCLI` actions.
|
78 | 166 |
|
|
0 commit comments