From: Uri Guttman Date: Sat, 16 Apr 2011 07:21:53 +0000 (-0400) Subject: changed X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=99916a199e58595166740c3eacb34467fea64607;p=urisagit%2FPerl-Docs.git changed --- diff --git a/Changes b/Changes index 81e61bd..bab6896 100644 --- a/Changes +++ b/Changes @@ -1,6 +1,16 @@ Revision history File::Slurp -9999.14 Wed Apr 21 02:47:45 EDT 2010 +9999.16 Wed Apr 13 03:47:26 EDT 2011 + - Added support for read_file options to be a hash reference. + - Added new feature prepend_file + +9999.15 Thu Mar 24 16:40:19 EDT 2011 + - Fixed error.t test so it works when run as root + - Removed skip lines from error.t + - Fixed pod about binmode option to reflect changes in .14 + +9999.14 Sun Mar 20 16:26:47 EDT 2011 + - Added LICENCE (same as perl) to POD - Added special faster code to slurp in small text files which is a common case - Rewrote the extras/slurp_bench.pl script. It has a full @@ -8,6 +18,8 @@ Revision history File::Slurp entries have more consistant names and it compares the new fast slurp for small files to the general slurp code. Thanks to Mark Friendlich + - Cleaned up pod + - Added more Synopsis examples - Added t/error.t to actually test error conditions. Previous error.t was renamed to error_mode.t which better reflects its tests. @@ -15,6 +27,19 @@ Revision history File::Slurp other tests in the future. - Fixed check for SEEK_SET and other constant subs being defined - Added support for binmode other than :raw and binmode.t test + Thanks to Martin J. Evans, Peter Edwards, Bryce Nesbitt + - Added support for perms option in write_file and perms.t test + Thanks to Peter Corlett and Paul Miller + - Added check to the rename call in atomic mode. Tested in error.t. + Thanks to Daniel Scott Sterling + - Added POD to state that using scalar_ref or buf_ref will be faster + and save memory due to not making a copy + Thanks to Peter Edwards + - read_file in list mode keeps data tainted + Thanks to Sébastien Aperghis-Tramoni + - read_file checks for an overloaded object to get the file + name. + Thanks to Sébastien Aperghis-Tramoni 9999.13 Tue Oct 10 02:04:51 EDT 2006 - Refactored the extras/slurp_bench.pl script. It has options, diff --git a/MANIFEST b/MANIFEST index fa58954..e5d4e98 100644 --- a/MANIFEST +++ b/MANIFEST @@ -3,23 +3,35 @@ lib/File/Slurp.pm Makefile.PL MANIFEST README +TODO +t/TestDriver.pm +t/append_null.t +t/binmode.t +t/data_list.t +t/data_scalar.t t/error.t -t/large.t +t/error_mode.t +t/file_object.t t/handle.t -t/data_scalar.t -t/data_list.t -t/paragraph.t -t/original.t -t/stdin.t t/inode.t -t/pseudo.t -t/read_dir.t -t/slurp.t -t/no_clobber.t -t/append_null.t +t/large.t t/newline.t +t/no_clobber.t +t/original.t +t/paragraph.t +t/perms.t t/pod.t t/pod_coverage.t +t/pseudo.t +t/read_dir.t +t/slurp.t +t/stdin.t +t/stringify.t +t/tainted.t +t/write_file_win32.t +experiment/prepend.pl +experiment/edit_file.pl extras/slurp_bench.pl +extras/FileSlurp_12.pm extras/slurp_article.pod META.yml Module meta-data (added by MakeMaker) diff --git a/Makefile.PL b/Makefile.PL index 07a60d5..364dc45 100644 --- a/Makefile.PL +++ b/Makefile.PL @@ -1,11 +1,22 @@ +use strict ; use ExtUtils::MakeMaker; # See lib/ExtUtils/MakeMaker.pm for details of how to influence # the contents of the Makefile that is written. WriteMakefile( - 'NAME' => 'File::Slurp', - 'VERSION_FROM' => 'lib/File/Slurp.pm', # finds $VERSION - 'PREREQ_PM' => {}, # e.g., Module::Name => 1.1 - ($] >= 5.005 ? ## Add these new keywords supported since 5.005 - (ABSTRACT_FROM => 'lib/File/Slurp.pm', # retrieve abstract from module - AUTHOR => 'Uri Guttman ') : ()), + 'NAME' => 'File::Slurp', + 'LICENSE' => 'perl', + 'AUTHOR' => 'Uri Guttman ', + 'VERSION_FROM' => 'lib/File/Slurp.pm', + 'ABSTRACT_FROM' => 'lib/File/Slurp.pm', + 'META_MERGE' => { + requires => { + perl => 5.004, + }, + }, + 'PREREQ_PM' => { + 'Carp' => 0, + 'Exporter' => 0, + 'Fcntl' => 0, + 'POSIX' => 0, + }, ); diff --git a/README b/README index 1a7a9d4..c499b17 100644 --- a/README +++ b/README @@ -1,4 +1,4 @@ -File::Slurp.pm version 0.04 +File::Slurp.pm =========================== This module provides subroutines to read or write entire files with a @@ -7,18 +7,14 @@ in a directory. In the extras/ directory you can read an article (slurp_article.pod) about file slurping and also run a benchmark (slurp_bench.pl) that -compares many ways of slurping/spewing files. +compares many ways of slurping/spewing files. This benchmark was +rewritten for .14 and is much better. This module was first written and owned by David Muir Sharnoff (MUIR on CPAN). I checked out his module and decided to write a new version -which would be faster, and with many more features. To that end, David +which would be faster and with many more features. To that end, David graciously transfered the namespace to me. -Since then, I discovered and fixed a bug in the original module's test -script (which had only 7 tests), which is included now as t/original.t. -This module now has 164 tests in 7 test scripts, and passes on Windows, -Linux, Solaris and Mac OS X. - There have been some comments about the somewhat unusual version number. The problem was that David used a future date (2004.0904) in his version number, and the only way I could get CPAN to index my new module was to @@ -36,6 +32,6 @@ To install this module type the following: COPYRIGHT AND LICENCE -Copyright (C) 2003 Uri Guttman +Copyright (C) 2010 Uri Guttman Licensed the same as Perl. diff --git a/TODO b/TODO index 6f6d313..9af7980 100644 --- a/TODO +++ b/TODO @@ -1,39 +1,33 @@ -optimize read_file for smaller scalar slurps with no options +File::Slurp TODO -prepend_file() +NEW FEATURES - options: lock file? +prepend_file() -- prepend text to the front of a file + + options: lock file? enable atomic -edit_file() +edit_file() -- slurp into $_, call edit code block, write out $_ options: lock file? -edit_file_lines() +edit_file_lines() -- slurp each line into $_, call edit code block, + write out $_ options: lock file? -add options to read_dir - prepend_dir - grep filter qr or code ref +read_file_lines() + reads lines to array ref or list + same as $list = read_file( $file, { array_ref => 1 } + or @lines = read_file() +new options for read_dir + prepend -- prepend the dir name to each dir entry. + filter -- grep dir entries with qr// or code ref. BUGS: restart sysread/write after a signal (or check i/o count) -fix SEEK stuff - -sent in patches: - -check for objects/refs to filenames - -add chmod mode to write_file - -add perms (same as chmod?) to syswrite - -check result of rename in atomic mode - - - +FEATURE REQUESTS