Getting Started with MFTF

Prepare Environment

1. Disable Add Secret Key in URLs option in Stores->Configuration->Admin->Security.

   • Getting started with the Magento Functional Testing Framework | Magento 2 Developer Documentation

2. Run the Selenium Server:

   • Download the latest Selenium Server Standalone JAR.
     • https://www.seleniumhq.org/download/
   • Download a Selenium web driver for your web browser into the same directory that contains the Selenium server.
   • Add the directory with the web driver to PATH.
   • Run the Selenium server in terminal (or other command line interface):

     java -jar <path_to_selenium_directory>/selenium-server-standalone-<version>.jar
     

---

Prepare Repository

Below is a rough overview of the key steps outlined in the Official MFTF Dev Docs tailored to Extension Developers and the MSI project.

1. Clone MSI Repo: * git clone https://github.com/magento-engcom/msi.git [PATH_TO_MAGENTO_MSI]
2. CD to the acceptance test directory of msi:
   • cd [PATH_TO_MAGENTO_MSI]/dev/tests/acceptance
3. Install the dependencies:
   • composer install
4. Build the project:
   • ./vendor/bin/robo build:project
5. Locate and Open the .env file.
6. Fill in the minimal necessary details:

   #Magento Base url. It should include `index.php/` if rewrites rules are not enabled.
   MAGENTO_BASE_URL=http://mageto.url/
   
   #Magento backend route name
   MAGENTO_BACKEND_NAME=admin
   
   #admin username
   MAGENTO_ADMIN_USERNAME=admin
   
   #admin password
   MAGENTO_ADMIN_PASSWORD=admin123

7. Configure the location of the tests in the MSI modules. Uncomment the #CUSTOM_MODULE_PATH attribute. Set the comma separated FULL PATHs to your Modules' MFTF Test directories:

   CUSTOM_MODULE_PATHS=[PATH_TO_MAGENTO_MSI]/app/code/Magento/Inventory/Test/Acceptance,[PATH_TO_MAGENTO_MSI]/app/code/Magento/InventoryApi/Test/Acceptance
   

8. Generate the tests:
   • ./vendor/bin/robo generate:tests

---

Run MSI Tests

1. Execute the MSI group of the tests:
   • cd [PATH_TO_MAGENTO_MSI]/dev/tests/acceptance
   • ./vendor/bin/robo group msi