package Filename::Ebook; our $AUTHORITY = 'cpan:PERLANCAR'; # AUTHORITY our $DATE = '2020-05-30'; # DATE our $DIST = 'Filename-Ebook'; # DIST our $VERSION = '0.001'; # VERSION use 5.010001; use strict; use warnings; require Exporter; our @ISA = qw(Exporter); our @EXPORT_OK = qw(check_ebook_filename); our %SPEC; our %SUFFIXES = ( '.azw' => {format=>'kindle'}, '.azw3' => {format=>'kindle'}, '.kf8' => {format=>'kindle'}, '.kfx' => {format=>'kindle'}, '.cbr' => {format=>'cbr'}, '.cbz' => {format=>'cbr'}, '.cb7' => {format=>'cbr'}, '.cbt' => {format=>'cbr'}, '.cba' => {format=>'cbr'}, '.chm' => {format=>'chm'}, '.djvu' => {format=>'djvu'}, '.doc' => {format=>'doc'}, '.docx' => {format=>'docx'}, '.epub' => {format=>'epub'}, '.htm' => {format=>'html'}, '.html' => {format=>'html'}, '.mobi' => {format=>'mobi'}, '.prc' => {format=>'mobi'}, '.pdf' => {format=>'pdf'}, '.ps' => {format=>'postscript'}, '.rtf' => {format=>'rtf'}, '.text' => {format=>'txt'}, '.txt' => {format=>'txt'}, # old/unpopular # .pdb (palm) # .fb2 (fictionbook) # .xeb, .ceb (apabi) # .ibooks (apple ibook) # .inf (ibm) # .lit (microsoft lit) # .pkg (newton) # .opf (open ebook, superseded by epub) # .pdg (ssreader) # .tr2, .tr3 (tomeraider) # .oxps, .xps (open xml paper) # ambiguous # .xml ); our %FORMATS = ( ); our $STR_RE = join "|", map {quotemeta} sort keys %SUFFIXES; our $RE = qr((?:$STR_RE)\z)i; $SPEC{check_ebook_filename} = { v => 1.1, summary => 'Check whether filename indicates being an e-book', description => <<'_', _ args => { filename => { schema => 'str*', req => 1, pos => 0, }, ci => { summary => 'Whether to match case-insensitively', schema => 'bool', default => 1, }, }, result_naked => 1, }; sub check_ebook_filename { my %args = @_; $args{filename} =~ $RE ? {} : 0; } 1; # ABSTRACT: Check whether filename indicates being an e-book __END__ =pod =encoding UTF-8 =head1 NAME Filename::Ebook - Check whether filename indicates being an e-book =head1 VERSION This document describes version 0.001 of Filename::Ebook (from Perl distribution Filename-Ebook), released on 2020-05-30. =head1 SYNOPSIS use Filename::Ebook qw(check_ebook_filename); my $res = check_ebook_filename(filename => "how not to die.pdf"); if ($res) { print "Filename indicates an ebook\n", } else { print "Filename does not indicate an ebook\n"; } =head1 DESCRIPTION =head1 FUNCTIONS =head2 check_ebook_filename Usage: check_ebook_filename(%args) -> any Check whether filename indicates being an e-book. This function is not exported by default, but exportable. Arguments ('*' denotes required arguments): =over 4 =item * B => I (default: 1) Whether to match case-insensitively. =item * B* => I =back Return value: (any) =head1 HOMEPAGE Please visit the project's homepage at L. =head1 SOURCE Source repository is at L. =head1 BUGS Please report any bugs or feature requests on the bugtracker website L 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. =head1 SEE ALSO Other C, e.g. L or L =head1 AUTHOR perlancar =head1 COPYRIGHT AND LICENSE This software is copyright (c) 2020 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. =cut