Dist::Util::Debian - Utilities related to Perl distribution and Debian
This document describes version 0.007 of Dist::Util::Debian (from Perl distribution Dist-Util-Debian), released on 2018-10-23.
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)
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
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.
Please visit the project's homepage at https://metacpan.org/release/Dist-Util-Debian.
Source repository is at https://github.com/perlancar/perl-Dist-Util-Debian.
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.
perlancar <perlancar@cpan.org>
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.
To install Dist::Util::Debian, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Dist::Util::Debian
CPAN shell
perl -MCPAN -e shell install Dist::Util::Debian
For more information on module installation, please visit the detailed CPAN module installation guide.