Merge 2cbb09a into bf9a207

.gitignore

@@ -8,3 +8,5 @@
 tests/_output/
 tests/.phpunit.result.cache
 tests/clover.xml
+
+tests/coverage\.xml

Makefile

@@ -1,5 +1,8 @@
 test: 
 	vendor/bin/phpunit tests
 
+test7.1:
+	/usr/bin/php7.1 vendor/bin/phpunit tests
+
 coverage:
 	vendor/bin/phpunit --configuration tests/php-unit.xml --coverage-html tests/_output tests

README.md

@@ -42,6 +42,14 @@ You can define vars by creating the file `config/packages/dev/adlarge_fixtures_d
         reloadCommands:
             - php bin/console doctrine:fixtures:load
             - ....
+        entities:
+            Product:
+                - id
+                - name
+                - category
+            Customer:
+                - firstname
+                - lastname
 
 Then you can install assets :
 
@@ -51,6 +59,8 @@ Then you can install assets :
 
 To add fixtures to your documentation you have to get the manager in your fixtures file :
 
+### Adding fixtures manually
+
 ```php
 class AppFixtures extends Fixture
  {
@@ -98,6 +108,83 @@ class AppFixtures extends Fixture
  }
 ```
 
+### Adding fixtures with configuration and entity
+
+If you provided the good entity name and properties in configuration `entities` you can 
+use the method `addFixtureEntity`.
+It only parse scalar properties and can check public properties as well as private ones with a getter (property, getProperty(), hasProperty(), isProperty()).
+It will ignore non scalar properties as well as non existing ones.
+
+With the following configuration :
+
+```yaml
+    adlarge_fixtures_documentation:
+        title: 'Your title'
+        reloadCommands:
+            - php bin/console doctrine:fixtures:load
+        entities:
+            Product:
+                - name
+                - category
+            Customer:
+                - firstname
+                - lastname
+                - email
+```
+
+You can use 
+
+```php
+class AppFixtures extends Fixture
+ {
+     /**
+      * @var FixturesDocumentationManager
+      */
+     private $documentationManager;
+
+     /**
+      * AppFixtures constructor.
+      *
+      * @param FixturesDocumentationManager $documentationManager
+      */
+     public function __construct(FixturesDocumentationManager $documentationManager)
+     {
+         $this->documentationManager = $documentationManager;
+     }
+
+     /**
+      * @param ObjectManager $manager
+      *
+      * @throws DuplicateFixtureException
+      */
+     public function load(ObjectManager $manager)
+     {
+        $doc = $this->documentationManager->getDocumentation();
+
+        $product = (new Product())
+            ->setName("Product 1")
+            ->setCategory("Category 1");
+
+        $doc->addFixtureEntity($product);
+
+        $product = (new Product())
+            ->setName("Product 2")
+            ->setCategory("Category 2");
+
+        $doc->addFixtureEntity($product);
+
+        $customer = (new Customer())
+            ->setFirstname('John')
+            ->setLastname('Doe')
+            ->setEmail('john.doe@test.fr');
+
+        $doc->addFixtureEntity($customer);
+
+        $manager->flush();
+     }
+ }
+```
+
 Then to generate the doc you only have to run : 
 
     php bin/console doctrine:fixtures:load

composer.json

@@ -22,7 +22,8 @@
     "doctrine/orm": "^2.5",
     "doctrine/doctrine-bundle": "^1.8",
     "doctrine/doctrine-fixtures-bundle": "^2.4|^3.0",
-    "ext-json": "*"
+    "ext-json": "*",
+    "symfony/property-access": "^4.3"
   },
   "require-dev": {
     "phpunit/phpunit": "^7.0",

src/DependencyInjection/Configuration.php

@@ -21,11 +21,17 @@ public function getConfigTreeBuilder(): TreeBuilder
         $rootNode
             ->children()
                 ->scalarNode('title')
-                    ->defaultValue('Fixtures documentation')->end()
+                    ->defaultValue('Fixtures documentation')
+                ->end()
                 ->arrayNode('reloadCommands')
                     ->scalarPrototype()->end()
-            ->end()
-        ->end();
+                ->end()
+                ->arrayNode('configEntities')
+                    ->arrayPrototype()
+                        ->scalarPrototype()->end()
+                    ->end()
+                ->end()
+            ->end();
 
         return $treeBuilder;
     }

src/DependencyInjection/FixturesDocumentationExtension.php

@@ -33,6 +33,11 @@ public function load(array $configs, ContainerBuilder $container): void
             $config['reloadCommands']
         );
 
+        $container->setParameter(
+            'adlarge_fixtures_documentation.configEntities',
+            $config['configEntities']
+        );
+
         $loader = new Loader\YamlFileLoader(
             $container,
             new FileLocator(__DIR__ . '/../Resources/config')

src/Model/Documentation.php

@@ -5,7 +5,12 @@
 namespace Adlarge\FixturesDocumentationBundle\Model;
 
 use Adlarge\FixturesDocumentationBundle\Exception\DuplicateFixtureException;
+use Symfony\Component\PropertyAccess\PropertyAccess;
+use Symfony\Component\PropertyAccess\Exception\NoSuchPropertyException;
 use TypeError;
+use ReflectionClass;
+use ReflectionException;
+use function array_key_exists;
 
 class Documentation
 {
@@ -15,15 +20,21 @@ class Documentation
      * @var Section[]
      */
     private $sections = [];
-
+    /**
+     * @var array
+     */
+    private $configEntities;
     /**
      * Documentation constructor.
      *
+     * @param array $configEntities
      * @param string $jsonString
+     * 
      * @throws DuplicateFixtureException
      */
-    public function __construct(string $jsonString = null)
+    public function __construct(array $configEntities, string $jsonString = null)
     {
+        $this->configEntities = $configEntities;
         if ($jsonString) {
             $this->init($jsonString);
         }
@@ -74,6 +85,42 @@ public function addFixture(string $sectionTitle, array $fixture): self
         return $this;
     }
 
+    /**
+     * Add a fixture to the documentation when passing directly the entity.
+     * Use configEntites and their property to create the array of value
+     * to pass to addFixture method
+     *
+     * @param mixed $entity
+     *
+     * @return Documentation
+     *
+     * @throws DuplicateFixtureException
+     * @throws ReflectionException
+     */
+    public function addFixtureEntity($entity): self
+    {
+        $className = (new ReflectionClass($entity))->getShortName();
+        if (array_key_exists($className, $this->configEntities)) {
+            $propertyAccessor = PropertyAccess::createPropertyAccessor();
+            /** @var array $properties */
+            $properties = $this->configEntities[$className];
+            $fixture = [];
+            foreach ($properties as $property) {
+                try {
+                    $value = $propertyAccessor->getValue($entity, $property);
+                    if (is_scalar($value)) {
+                        $fixture[$property] = $value;
+                    }  
+                } catch (NoSuchPropertyException $exception) {
+                    // ignore this exception silently
+                }
+            }
+
+            $this->addFixture($className, $fixture);
+        }
+        return $this;
+    }
+
     /**
      * Reset the documentation by removing all sections.
      *