NAME
Sah::Schema::isbn13 - ISBN 13 number
VERSION
This document describes version 0.008 of Sah::Schema::isbn13 (from Perl distribution Sah-Schemas-ISBN), released on 2020-05-27.
SYNOPSIS
To check data against this schema (requires Data::Sah):
use Data::Sah qw(gen_validator);
my $validator = gen_validator("isbn13*");
say $validator->($data) ? "valid" : "INVALID!";
# Data::Sah can also create validator that returns nice error message string
# and/or coerced value. Data::Sah can even create validator that targets other
# language, like JavaScript. All from the same schema. See its documentation
# for more details.
To validate function parameters against this schema (requires Params::Sah):
use Params::Sah qw(gen_validator);
sub myfunc {
my @args = @_;
state $validator = gen_validator("isbn13*");
$validator->(\@args);
...
}
To specify schema in Rinci function metadata and use the metadata with Perinci::CmdLine to create a CLI:
# in lib/MyApp.pm
package MyApp;
our %SPEC;
$SPEC{myfunc} = {
v => 1.1,
summary => 'Routine to do blah ...',
args => {
arg1 => {
summary => 'The blah blah argument',
schema => ['isbn13*'],
},
...
},
};
sub myfunc {
my %args = @_;
...
}
1;
# in myapp.pl
package main;
use Perinci::CmdLine::Any;
Perinci::CmdLine::Any->new(url=>'MyApp::myfunc')->run;
# in command-line
% ./myapp.pl --help
myapp - Routine to do blah ...
...
% ./myapp.pl --version
% ./myapp.pl --arg1 ...
Sample data:
"" # INVALID
"0-545-01022-1" # valid, becomes 9780545010221
"978-1-56619-909-4" # valid, becomes 9781566199094
"978-1-56619-909-45" # INVALID (Too long)
DESCRIPTION
Nondigits [^0-9] will be removed during coercion.
Checksum digit must be valid.
Basically EAN-13, except with additional coercion rule to coerce it from ISBN 10.
HOMEPAGE
Please visit the project's homepage at https://metacpan.org/release/Sah-Schemas-ISBN.
SOURCE
Source repository is at https://github.com/perlancar/perl-Sah-Schemas-ISBN.
BUGS
Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=Sah-Schemas-ISBN
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
AUTHOR
perlancar <perlancar@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2020, 2019, 2018 by perlancar@cpan.org.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.