#
# Dev-Editor - Module File::Access
#
-# Some simple routines for doing things with files
-# with only one command
+# Some simple routines for doing things with files by
+# using only one command
#
-# Author: Patrick Canterino <patshaping@gmx.net>
-# Last modified: 2004-02-06
+# Author: Patrick Canterino <patrick@patshaping.de>
+# Last modified: 2005-08-01
+#
+# Copyright (C) 1999-2000 Roland Bluethgen, Frank Schoenmann
+# Copyright (C) 2003-2009 Patrick Canterino
+# All Rights Reserved.
+#
+# This file can be distributed and/or modified under the terms of
+# of the Artistic License 1.0 (see also the LICENSE file found at
+# the top level of the Dev-Editor distribution).
#
use strict;
-use vars qw(@EXPORT);
+use vars qw(@EXPORT
+ $has_flock);
-use Carp qw(croak);
+use Fcntl qw(:DEFAULT
+ :flock);
+
+use File::Copy;
### Export ###
use base qw(Exporter);
-@EXPORT = qw(dir_read
+@EXPORT = qw(dir_copy
+ dir_read
file_create
+ file_lock
file_read
file_save
- file_unlock);
+
+ LOCK_SH
+ LOCK_EX
+ LOCK_UN
+ LOCK_NB);
+
+# Check if flock() is available
+# I found this piece of code somewhere in the internet
+
+$has_flock = eval { local $SIG{'__DIE__'}; flock(STDOUT,0); 1 };
+
+# Predeclaration of dir_copy()
+
+sub dir_copy($$);
+
+# dir_copy()
+#
+# Copy a directory
+#
+# Params: 1. Directory to copy
+# 2. Target
+#
+# Return: Status code (Boolean)
+
+sub dir_copy($$)
+{
+ my ($dir,$target) = @_;
+
+ return unless(-d $dir);
+
+ my $entries = dir_read($dir) or return;
+
+ my $dirs = $entries->{'dirs'};
+ my $files = $entries->{'files'};
+
+ mkdir($target,0777) unless(-d $target);
+
+ foreach my $directory(@$dirs)
+ {
+ unless(-d $target.'/'.$directory)
+ {
+ mkdir($target.'/'.$directory,0777) or next;
+ }
+
+ if(-r $target.'/'.$directory && -x $target.'/'.$directory)
+ {
+ dir_copy($dir.'/'.$directory,$target.'/'.$directory) or next;
+ }
+ }
+
+ foreach my $file(@$files)
+ {
+ copy($dir.'/'.$file,$target.'/'.$file) or next;
+ }
+
+ return 1;
+}
# dir_read()
#
# Params: Directory
#
# Return: Hash reference: dirs => directories
-# files => files
+# files => files and symbolic links
sub dir_read($)
{
# Sort the entries
- @entries = sort(@entries);
+ @entries = sort {uc($a) cmp uc($b)} @entries;
my @files;
my @dirs;
foreach my $entry(@entries)
{
- next if($entry eq "." || $entry eq "..");
+ next if($entry eq '.' || $entry eq '..');
- if(-d $dir."/".$entry)
+ if(-d $dir.'/'.$entry && not -l $dir.'/'.$entry)
{
push(@dirs,$entry);
}
# file_create()
#
-# Create a file
+# Create a file, but only if it doesn't already exist
+#
+# (I wanted to use O_EXCL for this, but `perldoc -f sysopen`
+# doesn't say that it is available on every system - so I
+# created this workaround using O_RDONLY and O_CREAT)
#
# Params: File to create
#
return if(-e $file);
- open(FILE,">$file") or return;
- close(FILE) or return;
+ sysopen(FILE,$file,O_RDONLY | O_CREAT) or return;
+ close(FILE) or return;
return 1;
}
+# file_lock()
+#
+# System independent wrapper function for flock()
+# On systems where flock() is not available, this function
+# always returns true.
+#
+# Params: 1. Filehandle
+# 2. Locking mode
+#
+# Return: Status code (Boolean)
+
+sub file_lock(*$)
+{
+ my ($handle,$mode) = @_;
+
+ return 1 unless($has_flock);
+ return flock($handle,$mode);
+}
+
# file_read()
#
# Read out a file completely
#
-# Params: File
+# Params: 1. File
+# 2. true => open in binary mode
+# false => open in normal mode (default)
#
# Return: Contents of the file (Scalar Reference)
-sub file_read($)
+sub file_read($;$)
{
- my $file = shift;
+ my ($file,$binary) = @_;
local *FILE;
- open(FILE,"<$file") or return;
+ sysopen(FILE,$file,O_RDONLY) or return;
+ file_lock(FILE,LOCK_SH) or do { close(FILE); return };
+ binmode(FILE) if($binary);
+
read(FILE, my $content, -s $file);
- close(FILE) or return;
+
+ close(FILE) or return;
return \$content;
}
#
# Params: 1. File
# 2. File content as Scalar Reference
+# 3. true => open in binary mode
+# false => open in normal mode (default)
#
# Return: Status code (Boolean)
-sub file_save($$)
+sub file_save($$;$)
{
- my ($file,$content) = @_;
+ my ($file,$content,$binary) = @_;
local *FILE;
- open(FILE,">$file") or return;
- print FILE $$content or do { close(FILE); return };
- close(FILE) or return;
-
- return 1;
-}
-
-# file_unlock()
-#
-# Remove a file from the list of files in use
-#
-# Params: 1. File::UseList object
-# 2. File to remove
-#
-# Return: -nothing-
+ sysopen(FILE,$file,O_WRONLY | O_CREAT | O_TRUNC) or return;
+ file_lock(FILE,LOCK_EX) or do { close(FILE); return };
+ binmode(FILE) if($binary);
-sub file_unlock($$)
-{
- my ($uselist,$file) = @_;
+ print FILE $$content or do { close(FILE); return };
- $uselist->remove_file($file);
- $uselist->save;
+ close(FILE) or return;
- return;
+ return 1;
}
# it's true, baby ;-)