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
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
|
=head1 NAME
MDK::Common::File - miscellaneous file/filename manipulation functions
=head1 SYNOPSIS
use MDK::Common::File qw(:all);
=head1 EXPORTS
=over
=item dirname(FILENAME)
=item basename(FILENAME)
returns the dirname/basename of the file name
=item cat_(FILENAME)
returns the file content: in scalar context it returns a single string, in
array context it returns the lines.
If the file doesn't exist, it returns undef
=item cat__(FILEHANDLE REF)
returns the file content: in scalar context it returns a single string, in
array context it returns the lines
=item output(FILENAME, LIST)
creates a file and outputs the list (if the file exists, it is clobbered)
=item linkf(SOURCE, DESTINATION)
=item symlinkf(SOURCE, DESTINATION)
=item renamef(SOURCE, DESTINATION)
same as link/symlink/rename but removes the destination file first
=item touch(FILENAME)
ensure the file exists, set the modification time to current time
=item all(DIRNAME)
returns all the file in directory (except "." and "..")
=item glob_(STRING)
simple version of C<glob>: doesn't handle wildcards in directory (eg:
*/foo.c), nor special constructs (eg: [0-9] or {a,b})
=item substInFile { CODE } FILENAME
executes the code for each line of the file. You can know the end of the file
is reached using C<eof>
=item expand_symlinks(FILENAME)
expand the symlinks in the absolute filename:
C<expand_symlinks("/etc/X11/X")> gives "/usr/X11R6/bin/XFree86"
=item openFileMaybeCompressed(FILENAME)
opens the file and returns the file handle. If the file is not found, tries to
gunzip the file + .gz
=item catMaybeCompressed(FILENAME)
cat_ alike. If the file is not found, tries to gunzip the file + .gz
=back
=head1 SEE ALSO
L<MDK::Common>
=cut
package MDK::Common::File;
use vars qw(@ISA %EXPORT_TAGS @EXPORT_OK);
@ISA = qw(Exporter);
@EXPORT_OK = qw(dirname basename cat_ cat__ output linkf symlinkf renamef touch all glob_ substInFile expand_symlinks openFileMaybeCompressed catMaybeCompressed);
%EXPORT_TAGS = (all => [ @EXPORT_OK ]);
sub dirname { local $_ = shift; s|[^/]*/*\s*$||; s|(.)/*$|$1|; $_ || '.' }
sub basename { local $_ = shift; s|/*\s*$||; s|.*/||; $_ }
sub cat_ { local *F; open F, $_[0] or return; my @l = <F>; wantarray ? @l : join '', @l }
sub cat__ { my ($f) = @_; my @l = <$f>; wantarray ? @l : join '', @l }
sub output { my $f = shift; local *F; open F, ">$f" or die "output in file $f failed: $!\n"; print F foreach @_; }
sub linkf { unlink $_[1]; link $_[0], $_[1] }
sub symlinkf { unlink $_[1]; symlink $_[0], $_[1] }
sub renamef { unlink $_[1]; rename $_[0], $_[1] }
sub touch {
my ($f) = @_;
unless (-e $f) {
local *F;
open F, ">$f";
}
my $now = time;
utime $now, $now, $f;
}
sub all {
my $d = shift;
local *F;
opendir F, $d or return;
my @l = grep { $_ ne '.' && $_ ne '..' } readdir F;
closedir F;
@l;
}
sub glob_ {
my ($d, $f) = ($_[0] =~ /\*/) ? (dirname($_[0]), basename($_[0])) : ($_[0], '*');
$d =~ /\*/ and die "glob_: wildcard in directory not handled ($_[0])\n";
($f = quotemeta $f) =~ s/\\\*/.*/g;
$d =~ m|/$| or $d .= '/';
map { $d eq './' ? $_ : "$d$_" } grep { /^$f$/ } all($d);
}
sub substInFile(&@) {
my ($f, $file) = @_;
if (-s $file) {
local @ARGV = $file;
local ($^I, $_) = '';
while (<>) {
$_ .= "\n" if eof && !/\n/;
&$f($_);
print;
}
} else {
local *F; my $old = select F; # that way eof return true
local $_ = '';
&$f($_);
select $old;
eval { output($file, $_) };
}
}
sub concat_symlink {
my ($f, $l) = @_;
$l =~ m|^\.\./(/.*)| and return $1;
$f =~ s|/$||;
while ($l =~ s|^\.\./||) {
$f =~ s|/[^/]+$|| or die "concat_symlink: $f $l\n";
}
"$f/$l";
}
sub expand_symlinks {
my ($first, @l) = split '/', $_[0];
$first eq '' or die "expand_symlinks: $_[0] is relative\n";
my ($f, $l);
foreach (@l) {
$f .= "/$_";
$f = concat_symlink($f, "../$l") while $l = readlink $f;
}
$f;
}
sub openFileMaybeCompressed {
my ($f) = @_;
-e $f || -e "$f.gz" or die "file $f not found";
local *F;
open F, -e $f ? $f : "gzip -dc $f.gz|" or die "file $f is not readable";
*F;
}
sub catMaybeCompressed { cat__(openFileMaybeCompressed($_[0])) }
1;
|
