spinen / connectwise-php-client

generator/generator.php

<?php

use Illuminate\Support\Collection;

require __DIR__ . '/../vendor/autoload.php';

class Swagger
{
    /**
     * @var Collection
     */
    public $map;

    /**
     * @var Collection
     */
    public $models;

    /**
     * @var Collection
     */
    public $specs;

    /**
     * @var string
     */
    public $version;

    public function __construct($file, $version)
    {
        $this->map = collect([]);
        $this->models = collect([]);
        $this->specs = collect(json_decode(file_get_contents($file), true));
        $this->version = $version;
    }

    public function convertDefinitionToModel($class, $attributes)
    {
        $template = <<<EOF
<?php

namespace {{ Namespace }};

use Carbon\Carbon;
use Spinen\ConnectWise\Support\Model;

/**
 * Class {{ Class }} Version {{ Version }}
 *
 * {{ Description }}
 *
{{ Properties }}
 */
class {{ Class }} extends Model
{
    /**
     * Properties that need to be casts to a specific object or type
     *
     * @var array
     */
    protected \$casts = [
{{ Casts }}
    ];
}

EOF;

        // Make array of types keyed by property
        $property_type = collect($attributes['properties'])
            ->map(function ($attributes) {
                return $this->parseType($attributes);
            });

        $casts = $property_type->map(function ($type, $property) {
            $primitives = [
                'array',
                'boolean',
                'float',
                'integer',
                'object',
                'string',
            ];

            return "        '${property}' => " . ((in_array($type, $primitives)) ? "'${type}'" : "${type}::class");
        })
                               ->values()
                               ->sort()
                               ->implode(",\n");

        $properties = $property_type->map(function ($type, $property) {
            return " * @property ${type} $${property}";
        })
                                    ->values()
                                    ->sort()
                                    ->implode("\n");

        $model = preg_replace('|{{ Namespace }}|u', $this->getNamespace(), $template);
        $model = preg_replace('|{{ Version }}|u', $this->version, $model);
        $model = preg_replace('|{{ Class }}|u', $class, $model);
        $model = preg_replace('|{{ Description }}|u', $attributes['description'] ?? 'Model for ' . $class, $model);
        $model = preg_replace('|{{ Casts }}|u', $casts, $model);
        $model = preg_replace('|{{ Properties }}|u', $properties, $model);

        return $model;
    }

    public function getNamespace($class = null)
    {
        return implode(
            '\\',
            array_filter(
                [
                    'Spinen',
                    'ConnectWise',
                    'Models',
                    $this->version,
                    $this->getTitle(),
                    $class,
                ]
            )
        );
    }

    public function getTitle()
    {
        return preg_replace('/\\s+API$/u', '', $this->specs['info']['title']);
    }

    public function parseDefinitions()
    {
        foreach ($this->specs['definitions'] as $class => $attributes) {
            $this->models[$class] = $this->convertDefinitionToModel($class, $attributes);
        };

        return $this;
    }

    public function parseType(array $attributes)
    {
        // Cast to another model
        if (array_key_exists('$ref', $attributes)) {
            return collect(explode('/', $attributes['$ref']))->last();
        }

        $format = $attributes['format'] ?? null;
        $type = $attributes['type'];

        // NOTE: We should consider supporting bigint, but for now, just int
        if (in_array($format, ['int32', 'int64']) || 'integer' === $type) {
            return 'integer';
        }

        if (in_array($format, ['double', 'float']) || 'number' === $type) {
            return 'float';
        }

        if (in_array($format, ['date', 'date-time'])) {
            return 'Carbon';
        }

        // NOTE: Would be nice to parse the 'items' key to get the types of the properties
        if ('array' === $type) {
            return 'array';
        }

        if ('boolean' === $type) {
            return 'boolean';
        }

        if ('object' === $type) {
            return 'object';
        }

        // default to string
        return 'string';
    }

    public function parsePaths()
    {
        foreach ($this->specs['paths'] as $path => $actions) {
            if (array_key_exists('get', $actions) && array_key_exists('schema', $actions['get']['responses'][200])) {
                $schema = $actions['get']['responses'][200]['schema'];

                // Single item or collection of items
                $ref = $schema['$ref'] ?? $schema['items']['$ref'];

                $this->map[$path] = $this->getNamespace(collect(explode('/', $ref))->last());
            }
        };

        return $this;
    }
}

class Loader
{
    /**
     * @var Collection
     */
    public $swaggers;

    /**
     * @var string
     */
    public $version;

    public function loadVersion($version)
    {
        $this->version = $version;

        $this->swaggers = collect([]);

        foreach (glob(__DIR__ . "/swagger/" . $this->version . "/*.json") as $swaggerfile) {
            $this->swaggers->push(new Swagger($swaggerfile, $this->version));
        }

        return $this;
    }

    public function process()
    {
        $this->swaggers->each(
            function (Swagger $swagger) {
                $swagger->parseDefinitions();

                $swagger->parsePaths();
            }
        );

        return $this;
    }
}

/** @var Loader $loader */
$loader = new Loader();

foreach (glob(__DIR__ . "/swagger/*") as $version) {
    $version = basename($version);

    echo "Working on version ${version}\n";

    $loader->loadVersion($version)
           ->process()->swaggers->each(function (Swagger $swagger) use ($version) {
                $directory = __DIR__ . '/Generated/' . $version;

                echo "Writing " . $swagger->getTitle() . "\n";

                mkdir($directory . '/' . $swagger->getTitle(), 0755, true);

                $swagger->models->each(function ($contents, $model) use ($directory, $swagger) {
                    file_put_contents($directory . '/' . $swagger->getTitle() . '/' . $model . '.php', $contents);
                });

                echo "Appending map\n";

                $map = collect(json_decode(@ file_get_contents($directory . '/map.json'), true))

It seems like @file_get_contents($directory . '/map.json') can also be of type false; however, parameter $json of json_decode() does only seem to accept string, maybe add an additional type check?

                    ->merge($swagger->map)
                    ->sort();

                file_put_contents($directory . '/map.json', $map->toJson());
           });
}