Merge pull request #10 from PHPCSStandards/feature/add-jekyllpagegenerator

Add JekyllPageGenerator

Author: afilina

src/Generator/JekyllPageGenerator.php

@@ -0,0 +1,36 @@
+<?php
+declare(strict_types=1);
+
+namespace App\Generator;
+
+use App\Value\Sniff;
+
+class JekyllPageGenerator extends MarkdownGenerator implements Generator
+{
+    public function createSniffDoc(Sniff $sniff): string
+    {
+        $sniffDoc = $this->getFrontMatter($sniff) . "\n";
+        $sniffDoc .= parent::createSniffDoc($sniff);
+
+        return $sniffDoc;
+    }
+
+    private function getFrontMatter(Sniff $sniff): string
+    {
+        $sniffName = $sniff->getSniffName();
+        if ($sniffName === '') {
+            return <<<'MD'
+            ---
+            ---
+
+            MD;
+        }
+
+        return <<<MD
+        ---
+        title: {$sniffName}
+        ---
+
+        MD;
+    }
+}

src/Value/Sniff.php

@@ -8,6 +8,9 @@
 class Sniff
 {
     private string $code;
+    private string $standardName;
+    private string $categoryName;
+    private string $sniffName;
     private string $docblock;
     /**
      * @var Property[]
@@ -42,6 +45,11 @@ public function __construct(
         Assert::that($code)
             ->notBlank();
 
+        $sniffNameParts = explode('.', $code);
+        Assert::that($sniffNameParts)
+            ->isArray()
+            ->count(3);
+
         Assert::thatAll($properties)
             ->isInstanceOf(Property::class);
 
@@ -52,6 +60,9 @@ public function __construct(
             ->isInstanceOf(Violation::class);
 
         $this->code = $code;
+        $this->standardName = $sniffNameParts[0];
+        $this->categoryName = $sniffNameParts[1];
+        $this->sniffName = $sniffNameParts[2];
         $this->docblock = $docblock;
         $this->properties = array_values($properties);
         $this->urls = $urls;
@@ -65,6 +76,21 @@ public function getCode(): string
         return $this->code;
     }
 
+    public function getStandardName(): string
+    {
+        return $this->standardName;
+    }
+
+    public function getCategoryName(): string
+    {
+        return $this->categoryName;
+    }
+
+    public function getSniffName(): string
+    {
+        return $this->sniffName;
+    }
+
     public function getDocblock(): string
     {
         return $this->docblock;

tests/Generator/JekyllPageGeneratorTest.php

@@ -0,0 +1,46 @@
+<?php
+declare(strict_types=1);
+
+namespace App\Tests\Generator;
+
+use App\Generator\JekyllPageGenerator;
+use App\Value\Sniff;
+use App\Value\UrlList;
+use PHPUnit\Framework\TestCase;
+
+/** @covers \App\Generator\JekyllPage */
+class JekyllPageTest extends TestCase
+{
+    private JekyllPageGenerator $generator;
+
+    /** @test */
+    public function fromSniff_WithMinimalData_WriteMinimalDetails()
+    {
+        $doc = new Sniff(
+            'Standard.Category.My',
+            '',
+            [],
+            new UrlList([]),
+            '',
+            [],
+            []
+        );
+
+        self::assertSame(
+            <<<MD
+            ---
+            title: My
+            ---
+
+            # Standard.Category.My
+
+            MD,
+            $this->generator->createSniffDoc($doc)
+        );
+    }
+
+    protected function setUp(): void
+    {
+        $this->generator = new JekyllPageGenerator();
+    }
+}

tests/Value/SniffTest.php

@@ -16,6 +16,9 @@
 class SniffTest extends TestCase
 {
     const CODE = 'Standard.Category.Code';
+    const STANDARD = 'Standard';
+    const CATEGORY = 'Category';
+    const SNIFFNAME = 'Code';
     const DOCBLOCK = 'Docblock';
     const DESCRIPTION = 'Description';
     /**
@@ -128,6 +131,33 @@ public function getCode()
         );
     }
 
+    /** @test */
+    public function getStandardName()
+    {
+        self::assertSame(
+            self::STANDARD,
+            $this->createSniff()->getStandardName()
+        );
+    }
+
+    /** @test */
+    public function getCategoryName()
+    {
+        self::assertSame(
+            self::CATEGORY,
+            $this->createSniff()->getCategoryName()
+        );
+    }
+
+    /** @test */
+    public function getSniffName()
+    {
+        self::assertSame(
+            self::SNIFFNAME,
+            $this->createSniff()->getSniffName()
+        );
+    }
+
     protected function setUp(): void
     {
         $this->PROPERTIES = [