MarkdownFormatter.php

<?php
declare(strict_types=1);

namespace App\Generator\Formatter;

use App\Value\Diff;
use App\Value\Property;
use App\Value\Sniff;
use App\Value\Url;
use App\Value\UrlList;
use App\Value\Violation;
use Stringy\Stringy;
use function Stringy\create as s;

final class MarkdownFormatter
{
    public function formatDescription(Sniff $sniff): string
    {
        $description = $sniff->getDescription();
        if ($description === '') {
            return '';
        }

        return <<<MD
        {$description}
        MD;
    }

    public function formatDocblock(Sniff $sniff): string
    {
        $docblock = $sniff->getDocblock();
        if ($docblock === '') {
            return '';
        }

        return <<<MD
        ## Docblock
        
        {$docblock}
        MD;
    }

    /**
     * @param Diff[] $diffs
     */
    public function formatComparisons(array $diffs): string
    {
        if ($diffs === []) {
            return '';
        }

        $diffBlocks = implode("\n\n", $this->getDiffBlocks($diffs));

        return <<<MD
        ## Comparisons
        
        {$diffBlocks}
        MD;
    }

    /**
     * @param Diff[] $diffs
     * @return string[]
     */
    private function getDiffBlocks(array $diffs): array
    {
        return array_map(function (Diff $diff): string {
            return <<<MD
            ```diff
            {$this->prependLinesWith('-', $diff->getBefore())}
            {$this->prependLinesWith('+', $diff->getAfter())}
            ```
            MD;
        }, $diffs);
    }

    private function prependLinesWith(string $prefix, string $lines): string
    {
        $prependedLines = array_map(function (Stringy $line) use ($prefix) {
            return (string)$line->prepend($prefix);
        }, s($lines)->lines());

        return implode("\n", $prependedLines);
    }

    /**
     * @param Property[] $properties
     */
    public function formatPublicProperties(array $properties): string
    {
        if ($properties === []) {
            return '';
        }

        $propertyLines = implode("\n", $this->getPublicPropertyLines($properties));

        return <<<MD
        ## Public Properties
        
        {$propertyLines}
        MD;
    }

    /**
     * @param Property[] $properties
     * @return string[]
     */
    private function getPublicPropertyLines(array $properties): array
    {
        return array_map(function (Property $property) {
            return "- `\${$property->getName()}` : {$property->getType()} {$property->getDescription()}";
        }, $properties);
    }

    /**
     * @return string
     */
    public function formatSeeAlso(UrlList $urls): string
    {
        if ($urls->toArray() === []) {
            return '';
        }

        $linkLines = implode("\n", $this->getLinkLines($urls));

        return <<<MD
        ## See Also
        
        {$linkLines}
        MD;
    }

    /**
     * @return string[]
     */
    private function getLinkLines(UrlList $urls): array
    {
        return array_map(function (Url $url) {
            return "- [$url]($url)";
        }, $urls->toArray());
    }

    /**
     * @param Violation[] $violations
     * @return string
     */
    public function formatViolations(array $violations): string
    {
        if ($violations === []) {
            return '';
        }

        $violations = implode("\n", $this->getViolationBlocks($violations));

        return <<<MD
        ## Troubleshooting
        
        {$violations}
        MD;
    }

    /**
     * @param Violation[] $violations
     * @return string[]
     */
    private function getViolationBlocks(array $violations): array
    {
        return array_map(function (Violation $violation): string {
            return <<<MD
            ```
            <details>
            <summary>{$violation->getCode()}</summary>
            {$violation->getDescription()}
            
            {$this->formatComparisons($violation->getDiffs())}
            
            {$this->formatSeeAlso($violation->getUrls())}
            </details>
            ```
            MD;
        }, $violations);
    }
}