Skip to content

Commit b9824fe

Browse files
authored
Merge pull request #18 from cxw42/issue17
Convert to CPAN form
2 parents 78f8025 + b211056 commit b9824fe

26 files changed

+666
-100
lines changed

.gitignore

Lines changed: 51 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,53 @@
1-
.*.swp
1+
# Specific
22
/tags
3+
/fatlib
4+
/stuff
35

6+
# Dist
7+
/Text-PerlPP*
8+
9+
# Editor
10+
*.bak
11+
*~
12+
~*
13+
*.swp
14+
15+
# from GitHub's perl .gitignore:
16+
!Build/
17+
.last_cover_stats
18+
/META.yml
19+
/META.json
20+
/MYMETA.*
21+
*.o
22+
*.pm.tdy
23+
*.bs
24+
25+
# Devel::Cover
26+
cover_db/
27+
28+
# Devel::NYTProf
29+
nytprof.out
30+
31+
# Dizt::Zilla
32+
/.build/
33+
34+
# Module::Build
35+
_build/
36+
Build
37+
Build.bat
38+
39+
# Module::Install
40+
inc/
41+
42+
# ExtUtils::MakeMaker
43+
/blib/
44+
/_eumm/
45+
/*.gz
46+
/Makefile
47+
/Makefile.old
48+
/MANIFEST.bak
49+
/pm_to_blib
50+
/*.zip
51+
52+
# Capture::Tiny
53+
DEBUG*

Changes

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
Revision history for Text-PerlPP
2+
3+
0.3.1 2018/05/11
4+
First CPAN version, released on an unsuspecting world.
5+

LICENSE.txt renamed to LICENSE

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
The MIT License (MIT)
22
Copyright © 2013 Andrey Shubin <[email protected]>
3-
Portions copyright © 2016 Chris White <[email protected]>
3+
Portions copyright © 2016-2018 Chris White <[email protected]>
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy
66
of this software and associated documentation files (the “Software”), to deal

MANIFEST

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
bin/perlpp The command-line invoker
2+
Changes
3+
lib/Text/PerlPP.pm The main code and perldoc
4+
LICENSE
5+
Makefile.PL
6+
MANIFEST This list of files
7+
MANIFEST.SKIP
8+
pack.PL Script to make the packed version
9+
README
10+
README.md The tutorial
11+
t/00-load.t
12+
t/01-basic.t
13+
t/01-readme.t
14+
t/02-cmdline.t
15+
t/03-idempotency.t
16+
t/04-include.t
17+
t/05-external-command.t
18+
t/06-macro.t
19+
t/07-invalid.t
20+
t/a.txt
21+
t/b.txt
22+
t/c.txt
23+
t/included.txt

MANIFEST.SKIP

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
# MANIFEST.SKIP for Text::PerlPP
2+
3+
#!start included /home/ChrisW/perl5/perlbrew/perls/perl-5.26.1/lib/5.26.1/ExtUtils/MANIFEST.SKIP
4+
# Avoid version control files.
5+
\bRCS\b
6+
\bCVS\b
7+
\bSCCS\b
8+
,v$
9+
\B\.svn\b
10+
\B\.git\b
11+
\B\.gitignore\b
12+
\b_darcs\b
13+
\B\.cvsignore$
14+
15+
# Avoid VMS specific MakeMaker generated files
16+
\bDescrip.MMS$
17+
\bDESCRIP.MMS$
18+
\bdescrip.mms$
19+
20+
# Avoid Makemaker generated and utility files.
21+
\bMANIFEST\.bak
22+
\bMakefile$
23+
\bblib/
24+
\bMakeMaker-\d
25+
\bpm_to_blib\.ts$
26+
\bpm_to_blib$
27+
\bblibdirs\.ts$ # 6.18 through 6.25 generated this
28+
\b_eumm/ # 7.05_05 and above
29+
30+
# Avoid Module::Build generated and utility files.
31+
\bBuild$
32+
\b_build/
33+
\bBuild.bat$
34+
\bBuild.COM$
35+
\bBUILD.COM$
36+
\bbuild.com$
37+
38+
# and Module::Build::Tiny generated files
39+
\b_build_params$
40+
41+
# Avoid temp and backup files.
42+
~$
43+
\.old$
44+
\#$
45+
\b\.#
46+
\.bak$
47+
\.tmp$
48+
\.#
49+
\.rej$
50+
\..*\.sw.?$
51+
52+
# Avoid OS-specific files/dirs
53+
# Mac OSX metadata
54+
\B\.DS_Store
55+
# Mac OSX SMB mount metadata files
56+
\B\._
57+
58+
# Avoid Devel::Cover and Devel::CoverX::Covered files.
59+
\bcover_db\b
60+
\bcovered\b
61+
62+
# Avoid prove files
63+
\B\.prove$
64+
65+
# Avoid MYMETA files
66+
^MYMETA\.
67+
#!end included /home/ChrisW/perl5/perlbrew/perls/perl-5.26.1/lib/5.26.1/ExtUtils
68+
/MANIFEST.SKIP
69+
70+
# Skip directories
71+
^stuff\b
72+
^fatlib\b
73+
^xt\b
74+
75+
# Skip some specific files
76+
^Makefile-premodule
77+
^tags

Makefile

Lines changed: 0 additions & 11 deletions
This file was deleted.

Makefile.PL

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
use 5.010;
2+
use strict;
3+
use warnings;
4+
use ExtUtils::MakeMaker;
5+
6+
sub MY::postamble {
7+
return <<EOT;
8+
authortest:
9+
\tRELEASE_TESTING=1 prove -l xt"
10+
11+
testhere: # Run the tests from lib rather than blib
12+
\texport PERLPP_CMD="perl -Ilib bin/perlpp"; \\
13+
\tperl -Ilib -e 'use Test::Harness "runtests"; runtests \@ARGV;' -- t/*.t
14+
15+
testpacked: pack # Test the packed version
16+
\texport PERLPP_NOUSE=1 PERLPP_CMD="perl blib/perlpp"; \\
17+
\tperl -e 'use Test::Harness "runtests"; runtests \@ARGV;' -- t/*.t
18+
EOT
19+
} #postamble
20+
21+
WriteMakefile(
22+
NAME => 'Text::PerlPP',
23+
AUTHOR => q{Christopher White <[email protected]>},
24+
VERSION_FROM => 'lib/Text/PerlPP.pm',
25+
ABSTRACT_FROM => 'lib/Text/PerlPP.pm',
26+
LICENSE => 'mit',
27+
28+
EXE_FILES => [ 'bin/perlpp' ],
29+
MIN_PERL_VERSION => '5.010',
30+
CONFIGURE_REQUIRES => {
31+
'ExtUtils::MakeMaker' => '0',
32+
},
33+
BUILD_REQUIRES => {
34+
'Test::More' => '0',
35+
'App::FatPacker' => '0',
36+
},
37+
PREREQ_PM => {
38+
'Pod::Usage' => '0',
39+
'Getopt::Long' => '2.50', # Per issue #17
40+
},
41+
dist => { COMPRESS => 'gzip -9f', SUFFIX => 'gz', },
42+
clean => { FILES => 'Text-PerlPP-* fatlib' },
43+
);
44+
# vi: set ts=4 sts=4 sw=4 et ai: #

README

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
Text-PerlPP - a Perl preprocessor
2+
3+
Translates text files with embedded Perl code to plain text files.
4+
See README.md for details. A simple example:
5+
6+
<? my $x = 42; ?><?! echo Hello, World! ?><?= $x ?>
7+
8+
will output
9+
10+
Hello, World!
11+
42
12+
13+
<? ... ?> is a Perl code chunk, <?! ... ?> runs an external command, and
14+
<?= ... ?> prints a Perl expression. There are more commands, listed in
15+
README.md.
16+
17+
REQUIRES
18+
19+
Perl 5.10+ and Getopt::Long 2.50. There is a fatpacked version that
20+
already includes Getopt::Long in the GitHub releases archive:
21+
https://github.com/interpreters/perlpp/releases
22+
23+
INSTALLATION
24+
25+
Easy installation, using App::cpanminus:
26+
27+
cpanm Text::PerlPP
28+
29+
Easy installation, using the release from GitHub:
30+
31+
- Copy the release file to a directory in your PATH
32+
33+
Slightly less easy installation, using ExtUtils::MakeMaker:
34+
35+
- Unpack the tarball
36+
- In the resulting directory, run the following commands:
37+
38+
perl Makefile.PL
39+
make
40+
make test
41+
make install
42+
43+
Yet another alternative way of installing
44+
45+
- Copy lib/Text/PerlPP.pm to a directory in your @INC
46+
- Copy bin/perlpp to a directory in your PATH.
47+
48+
SUPPORT AND DOCUMENTATION
49+
50+
After installing, you can find documentation for this module with the
51+
perldoc command.
52+
53+
perldoc Text::PerlPP
54+
55+
You can also look for information at:
56+
57+
GitHub (report bugs here)
58+
https://github.com/interpreters/perlpp
59+
60+
AnnoCPAN, Annotated CPAN documentation
61+
http://annocpan.org/dist/Text-PerlPP
62+
63+
CPAN Ratings
64+
http://cpanratings.perl.org/d/Text-PerlPP
65+
66+
Search CPAN
67+
http://search.cpan.org/dist/Text-PerlPP/
68+
69+
LICENSE AND COPYRIGHT
70+
71+
Copyright 2013-2018 Andrey Shubin and Christopher White.
72+
73+
This program is distributed under the MIT (X11) License:
74+
http://www.opensource.org/licenses/mit-license.php
75+
76+
See LICENSE for full details.
77+

bin/perlpp

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
#!perl -w
2+
# To run this manually from the source tree, do
3+
# perl -Ilib bin/perlpp
4+
use strict; use warnings; use Text::PerlPP;
5+
exit(Text::PerlPP::Main(\@ARGV));
6+
# vi: set ft=perl: #

0 commit comments

Comments
 (0)