[Opensrf-commits] r1392 - in branches/sboyette/src/perl: . t
svn at svn.open-ils.org
svn at svn.open-ils.org
Thu Aug 7 16:55:50 EDT 2008
Author: sboyette
Date: 2008-08-07 16:55:41 -0400 (Thu, 07 Aug 2008)
New Revision: 1392
Added:
branches/sboyette/src/perl/Changes
branches/sboyette/src/perl/MANIFEST
branches/sboyette/src/perl/Makefile.PL
branches/sboyette/src/perl/README
branches/sboyette/src/perl/lib/
branches/sboyette/src/perl/t/
branches/sboyette/src/perl/t/00-load.t
branches/sboyette/src/perl/t/boilerplate.t
branches/sboyette/src/perl/t/pod-coverage.t
branches/sboyette/src/perl/t/pod.t
Log:
adding basic module structure
Added: branches/sboyette/src/perl/Changes
===================================================================
--- branches/sboyette/src/perl/Changes (rev 0)
+++ branches/sboyette/src/perl/Changes 2008-08-07 20:55:41 UTC (rev 1392)
@@ -0,0 +1,5 @@
+Revision history for OpenSRF
+
+0.01 Date/time
+ First version, released on an unsuspecting world.
+
Added: branches/sboyette/src/perl/MANIFEST
===================================================================
--- branches/sboyette/src/perl/MANIFEST (rev 0)
+++ branches/sboyette/src/perl/MANIFEST 2008-08-07 20:55:41 UTC (rev 1392)
@@ -0,0 +1,8 @@
+Changes
+MANIFEST
+Makefile.PL
+README
+lib/OpenSRF.pm
+t/00-load.t
+t/pod-coverage.t
+t/pod.t
Added: branches/sboyette/src/perl/Makefile.PL
===================================================================
--- branches/sboyette/src/perl/Makefile.PL (rev 0)
+++ branches/sboyette/src/perl/Makefile.PL 2008-08-07 20:55:41 UTC (rev 1392)
@@ -0,0 +1,16 @@
+use strict;
+use warnings;
+use ExtUtils::MakeMaker;
+
+WriteMakefile(
+ NAME => 'OpenSRF',
+ AUTHOR => 'Equinox <foo at esilibrary.com>',
+ VERSION_FROM => 'lib/OpenSRF.pm',
+ ABSTRACT_FROM => 'lib/OpenSRF.pm',
+ PL_FILES => {},
+ PREREQ_PM => {
+ 'Test::More' => 0,
+ },
+ dist => { COMPRESS => 'gzip -9f', SUFFIX => 'gz', },
+ clean => { FILES => 'OpenSRF-*' },
+);
Added: branches/sboyette/src/perl/README
===================================================================
--- branches/sboyette/src/perl/README (rev 0)
+++ branches/sboyette/src/perl/README 2008-08-07 20:55:41 UTC (rev 1392)
@@ -0,0 +1,52 @@
+OpenSRF
+
+The README is used to introduce the module and provide instructions on
+how to install the module, any machine dependencies it may have (for
+example C compilers and installed libraries) and any other information
+that should be provided before the module is installed.
+
+A README file is required for CPAN modules since CPAN extracts the README
+file from a module distribution so that people browsing the archive
+can use it to get an idea of the module's uses. It is usually a good idea
+to provide version information here so that people can decide whether
+fixes for the module are worth downloading.
+
+
+INSTALLATION
+
+To install this module, run the following commands:
+
+ perl Makefile.PL
+ make
+ make test
+ make install
+
+SUPPORT AND DOCUMENTATION
+
+After installing, you can find documentation for this module with the
+perldoc command.
+
+ perldoc OpenSRF
+
+You can also look for information at:
+
+ RT, CPAN's request tracker
+ http://rt.cpan.org/NoAuth/Bugs.html?Dist=OpenSRF
+
+ AnnoCPAN, Annotated CPAN documentation
+ http://annocpan.org/dist/OpenSRF
+
+ CPAN Ratings
+ http://cpanratings.perl.org/d/OpenSRF
+
+ Search CPAN
+ http://search.cpan.org/dist/OpenSRF
+
+
+COPYRIGHT AND LICENCE
+
+Copyright (C) 2008 Equinox
+
+This program is free software; you can redistribute it and/or modify it
+under the same terms as Perl itself.
+
Added: branches/sboyette/src/perl/t/00-load.t
===================================================================
--- branches/sboyette/src/perl/t/00-load.t (rev 0)
+++ branches/sboyette/src/perl/t/00-load.t 2008-08-07 20:55:41 UTC (rev 1392)
@@ -0,0 +1,9 @@
+#!perl -T
+
+use Test::More tests => 1;
+
+BEGIN {
+ use_ok( 'OpenSRF' );
+}
+
+diag( "Testing OpenSRF $OpenSRF::VERSION, Perl $], $^X" );
Added: branches/sboyette/src/perl/t/boilerplate.t
===================================================================
--- branches/sboyette/src/perl/t/boilerplate.t (rev 0)
+++ branches/sboyette/src/perl/t/boilerplate.t 2008-08-07 20:55:41 UTC (rev 1392)
@@ -0,0 +1,55 @@
+#!perl -T
+
+use strict;
+use warnings;
+use Test::More tests => 3;
+
+sub not_in_file_ok {
+ my ($filename, %regex) = @_;
+ open( my $fh, '<', $filename )
+ or die "couldn't open $filename for reading: $!";
+
+ my %violated;
+
+ while (my $line = <$fh>) {
+ while (my ($desc, $regex) = each %regex) {
+ if ($line =~ $regex) {
+ push @{$violated{$desc}||=[]}, $.;
+ }
+ }
+ }
+
+ if (%violated) {
+ fail("$filename contains boilerplate text");
+ diag "$_ appears on lines @{$violated{$_}}" for keys %violated;
+ } else {
+ pass("$filename contains no boilerplate text");
+ }
+}
+
+sub module_boilerplate_ok {
+ my ($module) = @_;
+ not_in_file_ok($module =>
+ 'the great new $MODULENAME' => qr/ - The great new /,
+ 'boilerplate description' => qr/Quick summary of what the module/,
+ 'stub function definition' => qr/function[12]/,
+ );
+}
+
+TODO: {
+ local $TODO = "Need to replace the boilerplate text";
+
+ not_in_file_ok(README =>
+ "The README is used..." => qr/The README is used/,
+ "'version information here'" => qr/to provide version information/,
+ );
+
+ not_in_file_ok(Changes =>
+ "placeholder date/time" => qr(Date/time)
+ );
+
+ module_boilerplate_ok('lib/OpenSRF.pm');
+
+
+}
+
Added: branches/sboyette/src/perl/t/pod-coverage.t
===================================================================
--- branches/sboyette/src/perl/t/pod-coverage.t (rev 0)
+++ branches/sboyette/src/perl/t/pod-coverage.t 2008-08-07 20:55:41 UTC (rev 1392)
@@ -0,0 +1,18 @@
+use strict;
+use warnings;
+use Test::More;
+
+# Ensure a recent version of Test::Pod::Coverage
+my $min_tpc = 1.08;
+eval "use Test::Pod::Coverage $min_tpc";
+plan skip_all => "Test::Pod::Coverage $min_tpc required for testing POD coverage"
+ if $@;
+
+# Test::Pod::Coverage doesn't require a minimum Pod::Coverage version,
+# but older versions don't recognize some common documentation styles
+my $min_pc = 0.18;
+eval "use Pod::Coverage $min_pc";
+plan skip_all => "Pod::Coverage $min_pc required for testing POD coverage"
+ if $@;
+
+all_pod_coverage_ok();
Added: branches/sboyette/src/perl/t/pod.t
===================================================================
--- branches/sboyette/src/perl/t/pod.t (rev 0)
+++ branches/sboyette/src/perl/t/pod.t 2008-08-07 20:55:41 UTC (rev 1392)
@@ -0,0 +1,12 @@
+#!perl -T
+
+use strict;
+use warnings;
+use Test::More;
+
+# Ensure a recent version of Test::Pod
+my $min_tp = 1.22;
+eval "use Test::Pod $min_tp";
+plan skip_all => "Test::Pod $min_tp required for testing POD" if $@;
+
+all_pod_files_ok();
More information about the opensrf-commits
mailing list