Added interface for #315

src/Modules/Generators/ContentGeneratorFactory.php

@@ -2,7 +2,6 @@
 
 namespace Tapestry\Modules\Generators;
 
-use Tapestry\Entities\Generators\FileGenerator;
 use Tapestry\Entities\Project;
 use Tapestry\Modules\Source\AbstractSource;
 
@@ -19,7 +18,7 @@ class ContentGeneratorFactory
     /**
      * Registered item stack.
      *
-     * @var array|FileGenerator[]
+     * @var string[]
      */
     private $items = [];
 
@@ -62,9 +61,9 @@ public function add(string $class)
      *
      * @param string $name
      * @param AbstractSource $file
-     * @return FileGenerator
+     * @return GeneratorInterface
      */
-    public function get(string $name, AbstractSource $file): FileGenerator
+    public function get(string $name, AbstractSource $file): GeneratorInterface
     {
         // @todo register new FileGenerator with the graph for #315
         return new $this->items[$name]($file);

src/Modules/Generators/GeneratorInterface.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Tapestry\Modules\Generators;
+
+use Tapestry\Entities\Project;
+use Tapestry\Modules\Source\SourceInterface;
+
+/**
+ * Interface GeneratorInterface
+ *
+ * Each Generator should implement this basic interface and
+ * regardless of whether they generate one file or many
+ * the generate method should always return an array.
+ */
+interface GeneratorInterface
+{
+    /**
+     * Set the source that this generator works from.
+     *
+     * @param SourceInterface $source
+     * @return void
+     */
+    public function setSource(SourceInterface $source);
+
+    /**
+     * Run the generation and return an array of generated
+     * files (oddly implementing SourceInterface, naming
+     * things is hard!)
+     *
+     * @param Project $project
+     * @return array|SourceInterface[]
+     */
+    public function generate(Project $project): array;
+}