view release on metacpan or  search on metacpan

scripts/jsonvalidate  view on Meta::CPAN

When enabled, perform resolution of relative or file:// references.

=item B<--allow-http>

Disabled by default.

This is an alias for B<--remote-refs>

=item B<--compile> / B<--no-compile>

Enable compiled fast-path for repeated validation.

=item B<--content-checks>

Enable C<contentEncoding>, C<contentMediaType>, C<contentSchema>. Registers a basic C<application/json> validator/decoder.

=item B<--extensions>

Enables non-standard extensions. Right now this includes C<uniqueKeys>

=item B<--ignore-unknown-required-vocab>

Ignore unknown vocabularies listed in schema C<C<'$vocabulary'>> I<required>.

=item B<--register-formats>

Register built-in C<format> validators (date, email, hostname, ip, uri, uuid, JSON Pointer, regex, etc.).

=item B<--max-errors N>

Maximum recorded errors per validation (default 200).

=item B<--normalize> / B<--no-normalize>

Round-trip instances through L<JSON> to enforce strict JSON typing (default on).

=item B<--remote-refs>

Allow fetching of http:// and https:// $ref URIs.

By default this is OFF — fictional $id values like
"https://schemas.example.com/..." will NOT be fetched.

This is the modern, safe default (prevents SSRF, accidental traffic).

=item B<--schema-base DIR>

A base directory to resolve relative file C<$ref> (defaults to the directory of the first C<--schema>).

=item B<--trace>

Record lightweight trace; cap with C<--trace-limit>; sample with C<--trace-sample>.

=item B<--trace-limit N>

Max number of trace entries per validation (0 = unlimited).

=item B<--trace-sample P>

Sampling percentage for trace events.

=item B<--unique-keys> / B<--no-unique-keys>

Enables the non-standard extension C<uniqueKeys>

=back

=head1 EXIT CODES

=over 4

=item * C<0>

All instances validated.

=item * C<1>

At least one instance failed.

=item * C<2>

Usage error.

=back

=head1 SEE ALSO

L<JSON::Schema::Validate>, L<JSON>

=head1 AUTHOR

Jacques Deguest E<lt>F<jack@deguest.jp>E<gt>

=head1 COPYRIGHT

Copyright(c) 2025 DEGUEST Pte. Ltd.

All rights reserved

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

=cut