4slv/yaml-config

config code generator from yaml config

Saturday, July 7, 2018
by 4slv
Repository
0 Watchers
0 Stars
426 Installations

PHP
0 Dependents
0 Suggesters
2 Forks
0 Open issues
18 Versions
461 % Grown

The README.md

yaml_config

Модуль позволяет сгенерировать ООП код конфига из yaml-файла.

Например, из yaml-файла:, _(*1)

family: # семья
  father: # отец
    name: Bob # имя
    hobby: # хобби
      - sport # спорт
      - boardgames # настольные игры
    story: | # биография
      родился в Бафало: # место рождения
      учился в церковно-приходской школе
  doter: # дочь
    name: Mila # имя
    age: # возраст
      '2017-04-17': 0
      '2018-04-17': 1
      '2019-04-17': 2

модуль сгенерирует php-код, который, будет позволять обращаться к значениям конфига в ООП-стиле:

$config = new Config($date);
$fatherName = $config
    ->getFamily()
    ->getFather()
    ->getName();

Переменная $fatherName будет содержать значение Bob., _(*2)

Модуль позволяет создавать свойства с ограниченным сроком действия, например, в вышеуказанном yaml-файле обращение к свойству family.doter.age будет зависеть от переданной в конструктор даты:

$dateList = [
    '2018-04-17',
    '2019-09-12',
    '2017-09-01'
];
foreach($dateList as $date){
    $dateTime = new DateTime($date);
    $config = new Config($dateTime);
    $doterAgeList[] = $config
        ->getFamily()
        ->getDoter()
        ->getAge();
}

Переменная $doterAgeList содержит массив: [1,2,0], _(*3)

Создаваемый модулем php-код будет содержать phpDoc-комментарии, соответствующие комментариям в yaml-файле

Как использовать

use YamlConfig\ClassCodeGenerator\ConfigClassTreeGenerator;
use YamlConfig\YamlFileToTree;

$configGenerator = new ConfigClassTreeGenerator();
$yamlFileToTree = new YamlFileToTree(); // объект преобразователь конфигурационного файла в конфигурацию
$yamlFileToTree
    ->setConfigRelativePath($organizationsRelativePath); //относительный путь расположения yaml-файл с настройками
$configGenerator
    ->setProjectPath($rootDir) // путь к папке проекта
    ->setYamlFileToTree($yamlFileToTree) // объект преобразователь конфигурационного файла в конфигурацию
    ->setConfigCodeRelativePath($organizationsCodeRelativePath) // относительный путь к папке в которой будут сгенерирован код конфига
    ->setConfigName('Family') // название класса конфига
    ->setConfigNamespace('Config\Family') // пространство имён конфига
    ->generate(); // Генерация кода конфига

Особенности функции generate: 1) Если изменений в исходном конфиге (по сравнению со сгенерированным кодом) нет, то перегенерация не происходит. 2) В качестве необязательного параметра generate принимает функцию, которая будет вызвана после генерации кода., _(*4)

Интерфейсы

помощью модуля есть возможность генерации интерфейсов для классов конфигурации. 1) Иерархические интерфейсы., _(*5)

По структуре yaml соответствуют yaml конфига. На пример yaml:, _(*6)

family: # семья
   father: # отец
     name: Bob # имя
     hobby: # хобби 
       - sport # спорт
       - boardgames # настольные игры
     story: | # биография
       родился в Бафало: # место рождения
       учился в церковно-приходской школе
   doter: # дочь
     name: Mila # имя
     age: # возраст
       '2017-04-17': 0
       '2018-04-17': 1
       '2019-04-17': 2

Создаст интерфейс на самом верхнем иерархическом уровне:, _(*7)

<?php
  
  namespace Config\Interfaces\Family;
  
  use YamlConfig\InterfaceCodeGenerator\InterfaceConfigNode;
  use Config\Interfaces\Family\Family\Father;
  use Config\Interfaces\Family\Family\Doter;
  
  
  interface Family extends InterfaceConfigNode {
  
     /** @return Father отец */
     public function getFather();
     
     /** @return Doter дочь */
     public function getDoter();
  
  }

На следующем уровне по иерархии будут находится интерфейсы Father и Doter. На пример интерфейс Doter:, _(*8)

<?php
  
  namespace Config\Interfaces\Family\Family;
  
  use YamlConfig\InterfaceCodeGenerator\InterfaceConfigNode;
  
  
  interface Doter extends InterfaceConfigNode {
  
     /** @return string отец */
     public function getName();
     
     /** @return int дочь */
     public function getAge();
  
  }

Код для генерации интерфейсов очень похож на код для генерации конфига. Будет выглядеть следующим образом:, _(*9)

<?php
  
  use YamlConfig\InterfaceCodeGenerator\ConfigInterfaceTreeGenerator;
  use \YamlConfig\YamlFileToTree;
  
  $configInterfaceTreeGenerator = new ConfigInterfaceTreeGenerator();
  $yamlFileToTree = new YamlFileToTree(); // объект преобразователь конфигурационного файла в конфигурацию
  $yamlFileToTree
     ->setConfigRelativePath($organizationsRelativePath); //относительный путь расположения yaml-файл с настройками
  $configInterfaceTreeGenerator
     ->setProjectPath($rootDir)  // путь к папке проекта
     ->setYamlFileToTree($yamlFileToTreeInterface) // объект преобразователь конфигурационного файла в конфигурацию
     ->setConfigCodeRelativePath($organizationsCodeRelativePath) // относительный путь к папке в которой будут сгенерирован код конфига
     ->setConfigName('Family') // название класса конфига
     ->setConfigNamespace('Config\Interfaces\Family') // пространство имён конфига
     ->generate();

2) Интерфейсы описанные списком. Пример структуры yaml:, _(*10)

family_member: # Наименование интерфейса(Комментарий будет использоваться как комментарий к интерфейсу)
   xpath: # Список xpath к элементам которые будут его реализовывать
     - /family/*[name]
   property: # Список свойств указывается для указания геттеров для них
     name: # наименование свойства (Комментарий будет использоваться как комментарий к гетерру)
       type: string #тип свойства
  family_father: # Наименование интерфейса 
   xpath: # Список xpath к элементам которые будут его реализовывать
      - /family/father[name and hobby]
   property:
     hobby: # наименование свойства  
       type: string
     name: # наименование свойства
       type: string #тип свойства

Данный yaml будет создавать 2 интерфейса:, _(*11)

<?php
  
  namespace Config\Interfaces\Family;
  
  use YamlConfig\InterfaceCodeGenerator\InterfaceConfigNode;
  
  /**
  * Наименование интерфейса(Комментарий будет использоваться как комментарий к интерфейсу)
  */
  interface FamilyMember extends InterfaceConfigNode {
  
     /** @return string наименование свойства (Комментарий будет использоваться как комментарий к гетерру) */
     public function getName();
  
  }

```php <?php, _(*12)

namespace Config\Interfaces\Family;, _(*13)

use YamlConfig\InterfaceCodeGenerator\InterfaceConfigNode;, _(*14)

/** * Наименование интерфейса */ interface FamilyFather extends InterfaceConfigNode {, _(*15)

/** @return string наименование свойства */ public function getName();, _(*16)

/** @return string наименование свойства */ public function getHobby();, _(*17)

}, _(*18)

Код для генерации интерфейсов:

```php
<?php

use YamlConfig\InterfaceCodeGenerator\ConfigInterfaceListTreeGenerator;
use \YamlConfig\YamlFileToTree;

$configInterfaceTreeGenerator = new ConfigInterfaceListTreeGenerator();
$yamlFileToTree = new YamlFileToTree(); // объект преобразователь конфигурационного файла в конфигурацию
$yamlFileToTree
   ->setConfigRelativePath($organizationsRelativePath); //относительный путь расположения yaml-файл с настройками
$configInterfaceTreeGenerator
   ->setProjectPath($rootDir)  // путь к папке проекта
   ->setYamlFileToTree($yamlFileToTreeInterface) // объект преобразователь конфигурационного файла в конфигурацию
   ->setConfigCodeRelativePath($organizationsCodeRelativePath) // относительный путь к папке в которой будут сгенерирован код конфига
   ->setConfigName('Family') // название класса конфига
   ->setConfigNamespace('Config\Interfaces\Family') // пространство имён конфига
   ->generate();

3) Подключение интерфейсов к объектам конфигурации:, _(*19)

<?php
  use YamlConfig\ClassCodeGenerator\ConfigClassTreeGenerator;
  use YamlConfig\YamlFileToTree;
  
  $configGenerator = new ConfigClassTreeGenerator();
  $yamlFileToTree = new YamlFileToTree(); // объект преобразователь конфигурационного файла в конфигурацию
  $yamlFileToTree
     ->setConfigRelativePath($organizationsRelativePath); //относительный путь расположения yaml-файл с настройками
  $yamlFileToTreeHierarchicalInterface = new YamlFileToTree(); // объект преобразователь конфигурационного файла в конфигурацию
  $yamlFileToTreeHierarchicalInterface
     ->setConfigRelativePath($organizationsRelativePath); //относительный путь расположения yaml-файл с настройками
  $yamlFileToTreeDescribedInterfaces = new YamlFileToTree(); // объект преобразователь конфигурационного файла в конфигурацию
  $yamlFileToTreeDescribedInterfaces
     ->setConfigRelativePath($organizationsRelativePath); //относительный путь расположения yaml-файл с настройками
  $configGenerator
     ->setProjectPath($rootDir) // путь к папке проекта
     ->setYamlFileToTree($yamlFileToTree) // объект преобразователь конфигурационного файла в конфигурацию
     ->setConfigCodeRelativePath($organizationsCodeRelativePath) // относительный путь к папке в которой будут сгенерирован код конфига
     ->setConfigName('Family') // название класса конфига
     ->setConfigNamespace('Config\Family') // пространство имён конфига
     ->setYamlFileToTreeHierarchicalInterfaces($yamlFileToTreeHierarchicalInterface) // преобразователь конфигурационного файла в конфигурацию для иерархических интерфейсов 
     ->setYamlFileToTreeDescribedInterfaces($yamlFileToTreeDescribedInterfaces) // преобразователь конфигурационного файла в конфигурацию для описанных интерфейсов
     ->setConfigHierarchicalInterfacesNamespace('Config\Interfaces\HierarchicalInterface') // пространство имён иерархических интерфейсов для узлов конфига
     ->setConfigDescribedInterfacesNamespace('Config\Interfaces\DescribedInterfaces') //  пространство имён описанных интерфейсов для узлов конфига
     ->generate(); // Генерация кода конфига

Пример класса Father генерируемого этим кодом:, _(*20)

<?php
  
  namespace Config\Family\Family;
  
  use YamlConfig\InterfaceCodeGenerator\InterfaceConfigNode;
  use Config\Interfaces\HierarchicalInterface\Family\Family\Father as FatherInterface;
  use Config\Interfaces\DescribedInterfaces\FamilyFather as FamilyFatherInterface;
  use use Config\Interfaces\DescribedInterfaces\FamilyMember as FamilyMemberInterface;
  
  /**
  * Наименование интерфейса
  */
  class Father extends InterfaceConfigNode implements FatherInterface, FamilyFatherInterface, FamilyMemberInterface
  {
  
     /** @return string наименование свойства */
     public function getName()
     {
         return $this->getActualProperty('name');
     }
  
     /** @return string наименование свойства */
     public function getHobby()
     {
         return $this->getActualProperty('hobby');
     }
  
  }

The Versions

07/07 2018

dev-master

9999999-dev

config code generator from yaml config

library yaml-config

config code generator from yaml config

4slv/yaml-config

The README.md

yaml_config

Как использовать

Интерфейсы

The Versions

dev-master

The Requires

The Development Requires

by Alexey Dobrynin

v1.1.3

The Requires

The Development Requires

by Alexey Dobrynin

v1.1.2

The Requires

The Development Requires

by Alexey Dobrynin

v1.1.1

The Requires

The Development Requires

by Alexey Dobrynin

v1.1.0

The Requires

The Development Requires

by Alexey Dobrynin

v1.0.9

The Requires

by Alexey Dobrynin

v1.0.8

The Requires

by Alexey Dobrynin

v1.0.7

The Requires

by Alexey Dobrynin

dev-SLOV-3120

The Requires

by Alexey Dobrynin

v1.0.5

The Requires

by Alexey Dobrynin

v1.0.6

The Requires

by Alexey Dobrynin

dev-SLOV-3110

The Requires

by Alexey Dobrynin

v1.0.4

The Requires

by Alexey Dobrynin

v1.0.3

The Requires

by Alexey Dobrynin

dev-patch-1

The Requires

by Alexey Dobrynin

v1.0.2

The Requires

by Alexey Dobrynin

v1.0.1

The Requires

by Alexey Dobrynin

v1.0.0

The Requires

by Alexey Dobrynin