File: Cmd.pm

package info (click to toggle)
systemconfigurator 2.0.10-1
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 724 kB
  • ctags: 313
  • sloc: perl: 7,423; makefile: 48
file content (99 lines) | stat: -rw-r--r-- 2,471 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
package Util::Cmd;
use File::Path;

#   $Id: Cmd.pm,v 1.7 2003/01/19 23:26:21 sdague Exp $

#   Copyright (c) 2001 International Business Machines

#   This program is free software; you can redistribute it and/or modify
#   it under the terms of the GNU General Public License as published by
#   the Free Software Foundation; either version 2 of the License, or
#   (at your option) any later version.
 
#   This program is distributed in the hope that it will be useful,
#   but WITHOUT ANY WARRANTY; without even the implied warranty of
#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
#   GNU General Public License for more details.
 
#   You should have received a copy of the GNU General Public License
#   along with this program; if not, write to the Free Software
#   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

#   Sean Dague <sean@dague.net>

use strict;
use Carp;

require Exporter;
use vars qw(@ISA @EXPORT_OK @EXPORT %EXPORT_TAGS $VERSION);

push @ISA, qw(Exporter);

%EXPORT_TAGS = (
                'all' => [
                          qw(which deltree mkpath)
                         ]
               );

@EXPORT_OK = ( @{ $EXPORT_TAGS{'all'} } );

$VERSION = sprintf("%d.%02d", q$Revision: 1.7 $ =~ /(\d+)\.(\d+)/);

sub which {
    my $exename = shift;
    for (map {"$_/$exename"} split(/:/,$ENV{PATH})) {
        return $_ if(-e and -x);
    }
}

sub deltree {
    rmtree([@_]);
}


1;
__END__

=head1 NAME

Util::Cmd - Additional Unix Commands needed by SC

=head1 SYNOPSIS

  use Util::Cmd qw(:all);
  my $grubpath = which('grub');
  deltree("/tmp/file1");
  deltree("/tmp/directory");
  mkpath("/tmp/tmp2/tmp3");

=head1 DESCRIPTION

Exports I<which()>, I<deltree()> and I<mkpath()> functions.  

I<which> takes an executable and returns the path to it. 

I<deltree> recursively deletes files and directories given a list of
such files and directories.

Note: I<deltree> does not recognize shell metacharacters such as "*"
and "?" so if you want do send it a list of files use something like:

deltree(glob("files*"));

I<mkpath> takes a directory and creates it, along with all the intermediate directories as needed.  Acts exactly like "mkdir -p".

=head2 EXPORT

None by default.  With the I<:all> specification I<which>, I<deltree>,
and I<mkpath> are exported.

=head1 AUTHOR

  Sean Dague <sean@dague.net>
  Vasilios Hoffman <greekboy@users.sourceforge.net>

=head1 SEE ALSO

L<perl>.

=cut