cycle / schema-renderer
Utils for Cycle ORM Schema rendering
Installs: 152 069
Dependents: 10
Suggesters: 0
Security: 0
Stars: 11
Watchers: 3
Forks: 6
Open Issues: 2
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
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.