#60: Build interactive configuration tool for populating .env properties

Author: lenaorobei

.env.example

@@ -5,9 +5,9 @@
 MAGENTO_BASE_URL=http://devdocs.magento.com/
 
 #*** Set the Admin Username and Password for your Magento instance ***#
-MAGENTO_BACKEND_NAME=
-MAGENTO_ADMIN_USERNAME=
-MAGENTO_ADMIN_PASSWORD=
+MAGENTO_BACKEND_NAME=admin
+MAGENTO_ADMIN_USERNAME=admin
+MAGENTO_ADMIN_PASSWORD=123123q
 
 #*** Path to CLI entry point and command parameter name. Uncomment and change if folder structure differs from standard Magento installation
 #MAGENTO_CLI_COMMAND_PATH=dev/tests/acceptance/utils/command.php

RoboFile.php

@@ -33,6 +33,7 @@ function cloneFiles()
      */
     function buildProject()
     {
+        $this->writeln("<error>This command will be removed in MFTF v3.0.0. Please use bin/mftf build:project instead.</error>\n");
         $this->cloneFiles();
         $this->_exec('vendor'. DIRECTORY_SEPARATOR .'bin'. DIRECTORY_SEPARATOR .'codecept build');
     }

bin/mftf

@@ -0,0 +1,18 @@
+#!/usr/bin/env php
+
+<?php
+/**
+ * Copyright © Magento, Inc. All rights reserved.
+ * See COPYING.txt for license details.
+ */
+
+require_once __DIR__ . '/../bootstrap.php';
+
+use Symfony\Component\Console\Application;
+
+$application = new Application();
+$application->setName('Magento Functional Testing Framework CLI');
+$application->setVersion('1.0.0');
+$application->add(new Magento\FunctionalTestingFramework\Console\SetupEnvCommand());
+$application->add(new Magento\FunctionalTestingFramework\Console\BuildProjectCommand());
+$application->run();

bootstrap.php

@@ -0,0 +1,8 @@
+<?php
+/**
+ * Copyright © Magento, Inc. All rights reserved.
+ * See COPYING.txt for license details.
+ */
+
+require_once 'vendor/autoload.php';
+define('BP', __DIR__);

src/Magento/FunctionalTestingFramework/Console/BuildProjectCommand.php

@@ -0,0 +1,82 @@
+<?php
+/**
+ * Copyright © Magento, Inc. All rights reserved.
+ * See COPYING.txt for license details.
+ */
+
+declare(strict_types = 1);
+
+namespace Magento\FunctionalTestingFramework\Console;
+
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\ArrayInput;
+use Symfony\Component\Filesystem\Filesystem;
+use Symfony\Component\Console\Input\InputOption;
+use Magento\FunctionalTestingFramework\Util\Env\EnvProcessor;
+use \Symfony\Component\Console\Input\InputInterface;
+use \Symfony\Component\Console\Output\OutputInterface;
+
+class BuildProjectCommand extends Command
+{
+    /**
+     * Array with environment variables for the project.
+     *
+     * @var array
+     */
+    private $env = [];
+
+    /**
+     * @inheritdoc
+     */
+    protected function configure()
+    {
+        $this->setName('build:project');
+        $this->setDescription('Generate configuration files for the project. Build the Codeception project.');
+        $env = $this->getEnv();
+        foreach ($env as $key => $value) {
+            $this->addOption($key, null, InputOption::VALUE_REQUIRED, '', $value);
+        }
+    }
+
+    /**
+     * @inheritdoc
+     */
+    protected function execute(InputInterface $input, OutputInterface $output)
+    {
+        $fileSystem = new Filesystem();
+        $fileSystem->copy(
+            BP . DIRECTORY_SEPARATOR . 'codeception.dist.yml',
+            BP . DIRECTORY_SEPARATOR . 'codeception.yml'
+        );
+        $output->writeln("codeception.yml configuration successfully applied.\n");
+        $fileSystem->copy(
+            BP . DIRECTORY_SEPARATOR . 'dev' . DIRECTORY_SEPARATOR . 'tests' . DIRECTORY_SEPARATOR . 'functional' . DIRECTORY_SEPARATOR . 'MFTF.suite.dist.yml',
+            BP . DIRECTORY_SEPARATOR . 'dev' . DIRECTORY_SEPARATOR . 'tests' . DIRECTORY_SEPARATOR . 'functional' . DIRECTORY_SEPARATOR . 'MFTF.suite.yml'
+        );
+        $output->writeln("MFTF.suite.yml configuration successfully applied.\n");
+        $setupEnvCommand = new SetupEnvCommand();
+        $commandInput = [];
+        $options = $input->getOptions();
+        $env = array_keys($this->getEnv());
+        foreach ($options as $key => $value) {
+            if (in_array($key, $env)) {
+                $commandInput['--' . $key] = $value;
+            }
+        }
+        $commandInput = new ArrayInput($commandInput);
+        $setupEnvCommand->run($commandInput, $output);
+    }
+
+    /**
+     * Retrieves '.env.example' file as associative array.
+     *
+     * @return array
+     */
+    private function getEnv(): array
+    {
+        if (empty($this->env)) {
+            $this->env = EnvProcessor::parseEvnFile(BP);
+        }
+        return $this->env;
+    }
+}

src/Magento/FunctionalTestingFramework/Console/SetupEnvCommand.php

@@ -0,0 +1,69 @@
+<?php
+/**
+ * Copyright © Magento, Inc. All rights reserved.
+ * See COPYING.txt for license details.
+ */
+
+declare(strict_types = 1);
+
+namespace Magento\FunctionalTestingFramework\Console;
+
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputOption;
+use Symfony\Component\Console\Exception\InvalidOptionException;
+use Magento\FunctionalTestingFramework\Util\Env\EnvProcessor;
+use \Symfony\Component\Console\Input\InputInterface;
+use \Symfony\Component\Console\Output\OutputInterface;
+
+class SetupEnvCommand extends Command
+{
+    /**
+     * Array with environment variables for the project.
+     *
+     * @var array
+     */
+    private $env = [];
+
+    /**
+     * @inheritdoc
+     */
+    protected function configure()
+    {
+        $this->setName('setup:env');
+        $this->setDescription("Generate .env file.");
+        $env = $this->getEnv();
+        foreach ($env as $key => $value) {
+            $this->addOption($key, null, InputOption::VALUE_REQUIRED, '', $value);
+        }
+    }
+
+    /**
+     * @inheritdoc
+     */
+    protected function execute(InputInterface $input, OutputInterface $output)
+    {
+        $config = $this->getEnv();
+        $userEnv = [];
+        foreach ($config as $key => $value) {
+            if ($input->getOption($key) === '') {
+                throw new InvalidOptionException(sprintf("Parameter $key cannot be empty.", $key));
+            }
+            $userEnv[$key] = $input->getOption($key);
+        }
+        EnvProcessor::putEnvFile($userEnv, BP);
+        $output->writeln(".env configuration successfully applied.\n");
+    }
+
+    /**
+     * Retrieves '.env.example' file as associative array.
+     *
+     * @return array
+     */
+    private function getEnv(): array
+    {
+        if (empty($this->env)) {
+            $this->env = EnvProcessor::parseEvnFile(BP);
+        }
+        return $this->env;
+    }
+}

src/Magento/FunctionalTestingFramework/Util/Env/EnvProcessor.php

@@ -0,0 +1,61 @@
+<?php
+/**
+ * Copyright © Magento, Inc. All rights reserved.
+ * See COPYING.txt for license details.
+ */
+declare(strict_types = 1);
+
+namespace Magento\FunctionalTestingFramework\Util\Env;
+
+/**
+ * Helper class EnvProcessor for reading and writing .env files.
+ *
+ * @package Magento\FunctionalTestingFramework\Util\Env
+ */
+class EnvProcessor
+{
+    /**
+     * Constants with env file names.
+     */
+    const ENV_EXAMPLE_FILE = '.env.example';
+    const ENV_FILE = '.env';
+
+    /**
+     * Serves for parsing '.env.example' file into associative array.
+     *
+     * @param string $fileDir
+     * @return array
+     */
+    public static function parseEvnFile(string $fileDir = ''): array
+    {
+        $envLines = file(
+            $fileDir . DIRECTORY_SEPARATOR . self::ENV_EXAMPLE_FILE,
+            FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES
+        );
+        $env = [];
+        foreach ($envLines as $line) {
+            // do not use commented out lines
+            if (strpos($line, '#') !== 0) {
+                list($key, $value) = explode('=', $line);
+                $env[$key] = $value;
+            }
+        }
+        return $env;
+    }
+
+    /**
+     * Serves for putting array with environment variables into .env file.
+     *
+     * @param array $config
+     * @param string $destination
+     * @return void
+     */
+    public static function putEnvFile(array $config = [], string $destination = '')
+    {
+        $envData = '';
+        foreach ($config as $key => $value) {
+            $envData .= $key . '=' . $value . PHP_EOL;
+        }
+        file_put_contents($destination . DIRECTORY_SEPARATOR . self::ENV_FILE, $envData);
+    }
+}