MAGETWO-64226: Add paths validation

Author: shiftedreality

app/code/Magento/Config/Console/Command/ConfigSetCommand.php

@@ -34,30 +34,38 @@ class ConfigSetCommand extends Command
     /**#@-*/
 
     /**
+     * The factory for config:set processors.
+     *
      * @var ConfigSetProcessorFactory
      */
     private $configSetProcessorFactory;
 
     /**
+     * Scope validator.
+     *
      * @var ValidatorInterface
      */
     private $validator;
 
     /**
+     * Scope manager.
+     *
      * @var ScopeInterface
      */
     private $scope;
 
     /**
+     * The factory for path validator.
+     *
      * @var PathValidatorFactory
      */
     private $pathValidatorFactory;
 
     /**
-     * @param ConfigSetProcessorFactory $configSetProcessorFactory
-     * @param ValidatorInterface $validator
-     * @param ScopeInterface $scope
-     * @param PathValidatorFactory $pathValidatorFactory
+     * @param ConfigSetProcessorFactory $configSetProcessorFactory The factory for config:set processors
+     * @param ValidatorInterface $validator Scope validator
+     * @param ScopeInterface $scope Scope manager
+     * @param PathValidatorFactory $pathValidatorFactory The factory for path validator
      */
     public function __construct(
         ConfigSetProcessorFactory $configSetProcessorFactory,

app/code/Magento/Config/Model/Config/PathValidator.php

@@ -31,8 +31,8 @@ public function __construct(Structure $structure)
      * Validates the config path by config structure schema.
      *
      * @param string $path The config path
-     * @return bool
-     * @throws ValidatorException If provided path can not be validated
+     * @return bool The result of validation
+     * @throws ValidatorException If provided path is not valid
      */
     public function validate($path)
     {

app/code/Magento/Config/Model/Config/Structure.php

@@ -3,12 +3,11 @@
  * Copyright © 2013-2017 Magento, Inc. All rights reserved.
  * See COPYING.txt for license details.
  */
+namespace Magento\Config\Model\Config;
 
 /**
- * System configuration structure
+ * System configuration structure.
  */
-namespace Magento\Config\Model\Config;
-
 class Structure implements \Magento\Config\Model\Config\Structure\SearchInterface
 {
     /**
@@ -275,8 +274,8 @@ public function getFieldPaths()
     /**
      * Iteration that collects config field paths recursively from config schema.
      *
-     * @param array $elements
-     * @return array
+     * @param array $elements The elements to be parsed
+     * @return array An array of config path to config structure path map
      */
     private function getFieldsRecursively(array $elements = [])
     {

app/code/Magento/Config/Test/Unit/Model/Config/PathValidatorTest.php

@@ -57,7 +57,7 @@ public function testValidate()
      * @expectedException \Magento\Framework\Exception\ValidatorException
      * @expectedExceptionMessage The "test/test/test" path does not exists
      */
-    public function testValidateIwthException()
+    public function testValidateWithException()
     {
         $this->structureMock->expects($this->once())
             ->method('getFieldPaths')