cycle/schema-renderer

Utils for Cycle ORM Schema rendering

1.2.0 2022-12-15 16:14 UTC

Requires

• php: >=7.4
• cycle/orm: 1.2 - 2

Requires (Dev)

• phpunit/phpunit: ^9.5
• spiral/code-style: ^1.0
• vimeo/psalm: ^4.10|^5.1

MIT

README

This package may be used to render Cycle ORM Schema in a terminal or generate php representation.

Installation

The preferred way to install this package is through Composer:

composer require cycle/schema-renderer

Example

Convert schema to array

$schema = new Schema([...]);
$converter = new \Cycle\Schema\Renderer\SchemaToArrayConverter();

$schemaArray = $converter->convert($schema);

If passed SchemaInterface doesn't contain toArray() method then the SchemaToArrayConverter will convert only common properties from Cycle\ORM\SchemaInterface. Null values will be skipped also.

In this case Iif you want to use custom properties you can pass them to the constructor

$converter = new \Cycle\Schema\Renderer\SchemaToArrayConverter();

$schemaArray = $converter->convert($schema, [
    42,
    CustomClass::CUSTOM_PROPERTY,
    ...
]);

Render schema to a terminal

use Cycle\Schema\Renderer\OutputSchemaRenderer;

$output = new \Symfony\Component\Console\Output\ConsoleOutput();

$renderer = new OutputSchemaRenderer(colorize: true);

$output->write($renderer->render($schemaArray));

By default, DefaultSchemaOutputRenderer renders in template only common properties and relations. Custom properties will be rendered as is in separated block. If you want to extend default rendering template you can create custom renderers and add them to the Output renderer.

use Cycle\Schema\Renderer\ConsoleRenderer\Renderer;
use Cycle\Schema\Renderer\ConsoleRenderer\Formatter;
use Cycle\Schema\Renderer\OutputSchemaRenderer;

class CustomPropertyRenderer implements Renderer {

    public function render(Formatter $formatter, array $schema, string $role): string
    {
        $data = $schema['my_custom_property'] ?? null;

        return \sprintf(
            '%s: %s',
            $formatter->title($this->title),
            $data === null ? $formatter->error('not defined') : $formatter->typecast($data)
        );
    }
}

$renderer = new OutputSchemaRenderer();

$renderer->addRenderer(
    new CustomPropertyRenderer(),
    new PropertyRenderer('my_custom_property', 'My super property')
);

$output->write($renderer->render($schemaArray))

Store schema in a PHP file

use Cycle\Schema\Renderer\PhpSchemaRenderer;

$path = __DIR__. '/schema.php'

$renderer = new PhpSchemaRenderer();

\file_put_contents($path, $renderer->render($schemaArray));

The Renderer generates valid PHP code, in which constants from Cycle ORM classes are substituted for better readability.

License:

The MIT License (MIT). Please see LICENSE for more information. Maintained by Spiral Scout.