7142557150

Committed 08 Dec 2023 02:28PM UTC coverage: 36.003% (-1.4%) from 37.36%

Build # 7142557150

Build Type

push

github

Committed by

web-flow

Commit Message

fix(jsonld): remove link to ApiDocumentation when doc is disabled (#6029)

Run Details

0 of 1 new or added line in 1 file covered. (0.0%)

2297 existing lines in 182 files now uncovered.

9992 of 27753 relevant lines covered (36.0%)

147.09 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

0.0

/src/JsonSchema/Command/JsonSchemaGenerateCommand.php

<?php

/*
 * This file is part of the API Platform project.
 *
 * (c) Kévin Dunglas <dunglas@gmail.com>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

declare(strict_types=1);

namespace ApiPlatform\JsonSchema\Command;

use ApiPlatform\JsonSchema\Schema;
use ApiPlatform\JsonSchema\SchemaFactoryInterface;
use ApiPlatform\Metadata\HttpOperation;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Exception\InvalidOptionException;
use Symfony\Component\Console\Input\InputArgument;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Input\InputOption;
use Symfony\Component\Console\Output\OutputInterface;
use Symfony\Component\Console\Style\SymfonyStyle;

/**
 * Generates a resource JSON Schema.
 *
 * @author Jacques Lefebvre <jacques@les-tilleuls.coop>
 */
final class JsonSchemaGenerateCommand extends Command
{
    // @noRector \Rector\Php81\Rector\Property\ReadOnlyPropertyRector
    private array $formats;

    public function __construct(private readonly SchemaFactoryInterface $schemaFactory, array $formats)
    {
        $this->formats = array_keys($formats);

        parent::__construct();
    }

    /**
     * {@inheritdoc}
     */
    protected function configure(): void
    {
        $this
            ->setDescription('Generates the JSON Schema for a resource operation.')
            ->addArgument('resource', InputArgument::REQUIRED, 'The Fully Qualified Class Name (FQCN) of the resource')
            ->addOption('operation', null, InputOption::VALUE_REQUIRED, 'The operation name')
            ->addOption('format', null, InputOption::VALUE_REQUIRED, 'The response format', (string) $this->formats[0])
            ->addOption('type', null, InputOption::VALUE_REQUIRED, sprintf('The type of schema to generate (%s or %s)', Schema::TYPE_INPUT, Schema::TYPE_OUTPUT), Schema::TYPE_INPUT);
    }

    /**
     * {@inheritdoc}
     */
    protected function execute(InputInterface $input, OutputInterface $output): int
    {
        $io = new SymfonyStyle($input, $output);

        /** @var string $resource */
        $resource = $input->getArgument('resource');
        $operation = $input->getOption('operation');
        /** @var string $format */
        $format = $input->getOption('format');
        /** @var string $type */
        $type = $input->getOption('type');

        if (!\in_array($type, [Schema::TYPE_INPUT, Schema::TYPE_OUTPUT], true)) {
            $io->error(sprintf('You can only use "%s" or "%s" for the "type" option', Schema::TYPE_INPUT, Schema::TYPE_OUTPUT));

            return 1;
        }

        if (!\in_array($format, $this->formats, true)) {
            throw new InvalidOptionException(sprintf('The response format "%s" is not supported. Supported formats are : %s.', $format, implode(', ', $this->formats)));
        }

        $schema = $this->schemaFactory->buildSchema($resource, $format, $type, $operation ? (new class() extends HttpOperation {})->withName($operation) : null);

        if (!$schema->isDefined()) {
            $io->error(sprintf('There is no %s defined for the operation "%s" of the resource "%s".', $type, $operation, $resource));

            return 1;
        }

        $io->text((string) json_encode($schema, \JSON_PRETTY_PRINT | \JSON_UNESCAPED_SLASHES));

        return 0;
    }

    public static function getDefaultName(): string
    {
        return 'api:json-schema:generate';
    }
}

1	<?php
2
3	/*
4	* This file is part of the API Platform project.
5	*
6	* (c) Kévin Dunglas <dunglas@gmail.com>
7	*
8	* For the full copyright and license information, please view the LICENSE
9	* file that was distributed with this source code.
10	*/
11
12	declare(strict_types=1);
13
14	namespace ApiPlatform\JsonSchema\Command;
15
16	use ApiPlatform\JsonSchema\Schema;
17	use ApiPlatform\JsonSchema\SchemaFactoryInterface;
18	use ApiPlatform\Metadata\HttpOperation;
19	use Symfony\Component\Console\Command\Command;
20	use Symfony\Component\Console\Exception\InvalidOptionException;
21	use Symfony\Component\Console\Input\InputArgument;
22	use Symfony\Component\Console\Input\InputInterface;
23	use Symfony\Component\Console\Input\InputOption;
24	use Symfony\Component\Console\Output\OutputInterface;
25	use Symfony\Component\Console\Style\SymfonyStyle;
26
27	/**
28	* Generates a resource JSON Schema.
29	*
30	* @author Jacques Lefebvre <jacques@les-tilleuls.coop>
31	*/
32	final class JsonSchemaGenerateCommand extends Command
33	{
34	// @noRector \Rector\Php81\Rector\Property\ReadOnlyPropertyRector
35	private array $formats;
36
37	public function __construct(private readonly SchemaFactoryInterface $schemaFactory, array $formats)
38	{
UNCOV 39	$this->formats = array_keys($formats);	×
40
UNCOV 41	parent::__construct();	×
42	}
43
44	/**
45	* {@inheritdoc}
46	*/
47	protected function configure(): void
48	{
UNCOV 49	$this	×
UNCOV 50	->setDescription('Generates the JSON Schema for a resource operation.')	×
UNCOV 51	->addArgument('resource', InputArgument::REQUIRED, 'The Fully Qualified Class Name (FQCN) of the resource')	×
UNCOV 52	->addOption('operation', null, InputOption::VALUE_REQUIRED, 'The operation name')	×
UNCOV 53	->addOption('format', null, InputOption::VALUE_REQUIRED, 'The response format', (string) $this->formats[0])	×
UNCOV 54	->addOption('type', null, InputOption::VALUE_REQUIRED, sprintf('The type of schema to generate (%s or %s)', Schema::TYPE_INPUT, Schema::TYPE_OUTPUT), Schema::TYPE_INPUT);	×
55	}
56
57	/**
58	* {@inheritdoc}
59	*/
60	protected function execute(InputInterface $input, OutputInterface $output): int
61	{
UNCOV 62	$io = new SymfonyStyle($input, $output);	×
63
64	/** @var string $resource */
UNCOV 65	$resource = $input->getArgument('resource');	×
UNCOV 66	$operation = $input->getOption('operation');	×
67	/** @var string $format */
UNCOV 68	$format = $input->getOption('format');	×
69	/** @var string $type */
UNCOV 70	$type = $input->getOption('type');	×
71
UNCOV 72	if (!\in_array($type, [Schema::TYPE_INPUT, Schema::TYPE_OUTPUT], true)) {	×
73	$io->error(sprintf('You can only use "%s" or "%s" for the "type" option', Schema::TYPE_INPUT, Schema::TYPE_OUTPUT));	×
74
75	return 1;	×
76	}
77
UNCOV 78	if (!\in_array($format, $this->formats, true)) {	×
79	throw new InvalidOptionException(sprintf('The response format "%s" is not supported. Supported formats are : %s.', $format, implode(', ', $this->formats)));	×
80	}
81
UNCOV 82	$schema = $this->schemaFactory->buildSchema($resource, $format, $type, $operation ? (new class() extends HttpOperation {})->withName($operation) : null);	×
83
UNCOV 84	if (!$schema->isDefined()) {	×
85	$io->error(sprintf('There is no %s defined for the operation "%s" of the resource "%s".', $type, $operation, $resource));	×
86
87	return 1;	×
88	}
89
UNCOV 90	$io->text((string) json_encode($schema, \JSON_PRETTY_PRINT \| \JSON_UNESCAPED_SLASHES));	×
91
UNCOV 92	return 0;	×
93	}
94
95	public static function getDefaultName(): string
96	{
UNCOV 97	return 'api:json-schema:generate';	×
98	}
99	}

api-platform / core / 7142557150

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous