Martin Renvoize
be3924a70f
Signed-off-by: David Nind <david@davidnind.com> Signed-off-by: Tomas Cohen Arazi <tomascohen@theke.io> Signed-off-by: Martin Renvoize <martin.renvoize@ptfs-europe.com>
129 lines
4.2 KiB
Perl
Executable file
129 lines
4.2 KiB
Perl
Executable file
# This file is part of Koha.
|
|
#
|
|
# Koha is free software; you can redistribute it and/or modify it under the
|
|
# terms of the GNU General Public License as published by the Free Software
|
|
# Foundation; either version 3 of the License, or (at your option) any later
|
|
# version.
|
|
#
|
|
# Koha is distributed in the hope that it will be useful, but WITHOUT ANY
|
|
# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
|
|
# A PARTICULAR PURPOSE. See the GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License along
|
|
# with Koha; if not, see <http://www.gnu.org/licenses>.
|
|
|
|
use Modern::Perl;
|
|
|
|
use Test::More tests => 4;
|
|
|
|
use Test::Mojo;
|
|
use Data::Dumper;
|
|
|
|
use FindBin();
|
|
use IPC::Cmd qw(can_run);
|
|
use List::MoreUtils qw(any);
|
|
|
|
my $t = Test::Mojo->new('Koha::REST::V1');
|
|
my $spec = $t->get_ok( '/api/v1/', 'Correctly fetched the spec' )->tx->res->json;
|
|
|
|
my $paths = $spec->{paths};
|
|
|
|
my @missing_additionalProperties = ();
|
|
|
|
foreach my $route ( keys %{$paths} ) {
|
|
foreach my $verb ( keys %{ $paths->{$route} } ) {
|
|
|
|
# p($paths->{$route}->{$verb});
|
|
|
|
# check parameters []
|
|
foreach my $parameter ( @{ $paths->{$route}->{$verb}->{parameters} } ) {
|
|
if ( exists $parameter->{schema}
|
|
&& exists $parameter->{schema}->{type}
|
|
&& ref( $parameter->{schema}->{type} ) ne 'ARRAY'
|
|
&& $parameter->{schema}->{type} eq 'object' )
|
|
{
|
|
|
|
# it is an object type definition
|
|
if (
|
|
$parameter->{name} ne 'query' # our query parameter is under-specified
|
|
and not exists $parameter->{schema}->{additionalProperties}
|
|
)
|
|
{
|
|
push @missing_additionalProperties,
|
|
{
|
|
type => 'parameter',
|
|
route => $route,
|
|
verb => $verb,
|
|
name => $parameter->{name}
|
|
};
|
|
}
|
|
}
|
|
}
|
|
|
|
# check responses {}
|
|
my $responses = $paths->{$route}->{$verb}->{responses};
|
|
foreach my $response ( keys %{$responses} ) {
|
|
if ( exists $responses->{$response}->{schema}
|
|
&& exists $responses->{$response}->{schema}->{type}
|
|
&& ref( $responses->{$response}->{schema}->{type} ) ne 'ARRAY'
|
|
&& $responses->{$response}->{schema}->{type} eq 'object' )
|
|
{
|
|
|
|
# it is an object type definition
|
|
if ( not exists $responses->{$response}->{schema}->{additionalProperties} ) {
|
|
push @missing_additionalProperties,
|
|
{
|
|
type => 'response',
|
|
route => $route,
|
|
verb => $verb,
|
|
name => $response
|
|
};
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
is( scalar @missing_additionalProperties, 0 )
|
|
or diag Dumper \@missing_additionalProperties;
|
|
|
|
subtest 'The spec passes the swagger-cli validation' => sub {
|
|
|
|
plan tests => 1;
|
|
|
|
if ( can_run('swagger-cli') ) {
|
|
my $spec_dir = "$FindBin::Bin/../api/v1/swagger";
|
|
my $var = qx{swagger-cli validate $spec_dir/swagger.yaml 2>&1};
|
|
is( $?, 0, 'Validation exit code is 0' )
|
|
or diag $var;
|
|
} else {
|
|
ok( 0, "Test skipped, swagger-cli missing" );
|
|
}
|
|
};
|
|
|
|
subtest 'tags tests' => sub {
|
|
|
|
plan tests => 1;
|
|
|
|
my @top_level_tags = map { $_->{name} } @{ $spec->{tags} };
|
|
|
|
my @errors;
|
|
|
|
foreach my $route ( keys %{$paths} ) {
|
|
foreach my $verb ( keys %{ $paths->{$route} } ) {
|
|
my @tags = @{ $paths->{$route}->{$verb}->{tags} };
|
|
|
|
# Check tag has an entry in the top level tags section
|
|
foreach my $tag (@tags) {
|
|
push @errors, "$verb $route -> uses tag '$tag' not present in top level list"
|
|
unless any { $_ eq $tag } @top_level_tags;
|
|
}
|
|
}
|
|
}
|
|
|
|
is_deeply( \@errors, [], 'No tag errors in the spec' );
|
|
|
|
foreach my $error (@errors) {
|
|
print STDERR "$error\n";
|
|
}
|
|
};
|