NAME Dist::Util::Debian - Utilities related to Perl distribution and Debian VERSION This document describes version 0.007 of Dist::Util::Debian (from Perl distribution Dist-Util-Debian), released on 2018-10-23. SYNOPSIS use Dist::Util::Debian qw( dist2deb deb_exists dist_has_deb deb_ver dist_deb_ver ); say dist2deb("HTTP-Tiny"); # -> libhttp-tiny-perl say dist_has_deb("HTTP-Tiny"); # -> 1 say dist_has_deb("Foo"); # -> 0 say dist_has_deb({use_allpackages=>1}, "HTTP-Tiny", "Foo"); # -> (1, 0) say dist_deb_ver("HTTP-Tiny"); # -> "0.070-1" say dist_deb_ver("Foo"); # -> undef say dist_deb_ver({use_allpackages=>1}, "HTTP-Tiny", "Foo"); # -> ("0.070-1", undef) DESCRIPTION FUNCTIONS dist2deb($dist, ...) => list It uses the simple rule of turning $dist to lowercase and adds "lib" + "-perl" prefix and suffix. A small percentage of distributions do not follow this rule. dist_has_deb([ \%opts, ] $dist, ...) => bool|list[bool] Return true if distribution named $dist has a corresponding Debian package. Currently the way the routine checks this is rather naive: it checks the corresponding Debian package against this URL: <https://packages.debian.org/sid/$package>. Will warn and return undef on error, e.g. the URL cannot be checked or does not contain negative/positive indicator of existence. Can accept multiple dists and will return a list of bools in that case. Known options: * use_allpackages => bool If you need to check a lot of distributions (hundreds or more) then the default way of checking each distribution against a URL might be too slow. An alternative way, enabled if you set this option to true, is to download <https://packages.debian.org/unstable/allpackages?format=txt.gz> (at the time of this writing, Jan 2017, the size is about 1.7M) then parse it locally. The file will be cached to a temporary file and reused for a day. Function will return undef if the allpackages index cannot be donwloaded. deb_exists([ \%opts, ] $deb, ...) => bool|list[bool] deb_ver([ \%opts, ] $deb, ...) => str|list[str] dist_deb_ver([ \%opts, ] $deb, ...) => str|list[str] HOMEPAGE Please visit the project's homepage at <https://metacpan.org/release/Dist-Util-Debian>. SOURCE Source repository is at <https://github.com/perlancar/perl-Dist-Util-Debian>. BUGS Please report any bugs or feature requests on the bugtracker website <https://rt.cpan.org/Public/Dist/Display.html?Name=Dist-Util-Debian> 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) 2018, 2017 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.