NAME

       PerlReq::Utils - auxiliary routines for B::PerlReq, perl.req and perl.prov

DESCRIPTION

       This module provides the following convenience functions:

       path2mod
           Convert file path to module name, e.g. File/Find.pm -> File::Find.

       mod2path
           Convert module name to file path, e.g. File::Find -> File/Find.pm.

       path2dep
           Convert file path to conventional dependency name, e.g. File/Find.pm ->
           perl(File/Find.pm).  Note that this differs from RedHat conventional form
           perl(File::Find).

       mod2dep
           Convert module name to conventional dependency name, e.g. File::Find ->
           perl(File/Find.pm).  Note that this differs from RedHat conventional form
           perl(File::Find).

       verf
           Format module version number, e.g. 2.12 -> 2.120.  Currently truncated to 3 digits
           after decimal point, except for all zeroes, e.g.  2.000 -> 2.0.

           Update.  The algorithm has been amended in almost compatible way so that versions do
           not lose precision when truncated.  Now we allow one more .ddd series at the end, but
           .000 is still truncated by default, e.g. 2.123 -> 2.123, 2.123456 -> 2.123.456.

       verf_perl
           Format Perl version number, e.g. 5.005_03 -> 1:5.5.30.

       sv_version
           Extract version number from B::SV object.  v-strings converted to floats according to
           Perl rules, e.g. 1.2.3 -> 1.002003.

       argv
           Obtain a list of files passed on the command line.  When command line is empty, obtain
           a list of files from standard input, one file per line.  Die when file list is empty.
           Check that each file exists, or die otherwise.  Canonicalize each filename with
           File::Spec::rel2abs() function (which makes no checks against the filesystem).

       inc Obtain a list of Perl library paths from @INC variable, except for current directory.
           The RPM_PERL_LIB_PATH environment variable, if set, is treated as a list of paths,
           seprarated by colons; put these paths in front of the list.  Canonicalize each path in
           the list.

           Finally, the RPM_BUILD_ROOT environment variable, if set, is treated as installation
           root directory; each element of the list is then prefixed with canonicalized
           RPM_BUILD_ROOT path and new values are put in front of the list.

           After all, only existent directories are returned.

       explode
           Split given filename into its prefix (which is a valid Perl library path, according to
           the inc() function above) and basename.  Return empty list if filename does not match
           any prefix.

AUTHOR

       Written by Alexey Tourbin <at@altlinux.org>.

COPYING

       Copyright (c) 2004 Alexey Tourbin, ALT Linux Team.

       This is free software; you can redistribute it and/or modify it under the terms of the GNU
       Library General Public License as published by the Free Software Foundation; either
       version 2 of the License, or (at your option) any later version.

SEE ALSO

       B::PerlReq, perl.req, perl.prov