File Coverage

blib/lib/Task/Template/Benchmark.pm

Criterion	Covered	Total	%
statement	6	6	100.0
branch			n/a
condition			n/a
subroutine	2	2	100.0
pod			n/a
total	8	8	100.0

line	stmt	sub	time	code
1				package Task::Template::Benchmark;
2
3	2	2	48545	use warnings;
	2		6
	2		70
4	2	2	13	use strict;
	2		4
	2		120
5
6				our $VERSION = '1.00';
7
8				1;
9
10				__END__
11
12				=pod
13
14				=head1 NAME
15
16				Task::Template::Benchmark - Task to install all template engines benchmarked by Template::Benchmark.
17
18				=head1 SYNOPSIS
19
20				This distribution contains no actual code, it simply exists to provide
21				a list of dependencies to assist in quickly installing all template engines
22				and optional dependencies used by L<Template::Benchmark>.
23
24				Be warned, between them, the 34 modules installed by this task have a
25				huge number of dependencies and prerequisites, on a fresh build of Perl
26				with only Bundle::CPAN installed this will run for over 20 minutes.
27
28				To use L<Task::Template::Benchmark> simply type at your CPAN prompt:
29
30				install Task::Template::Benchmark
31
32				Or extract the distribution tarball to a directory and do the following:
33
34				perl Build.PL
35				./Build installdeps
36				./Build test
37				./Build install
38
39				The current release of L<Task::Template::Benchmark> aims to always track
40				the dependencies required by the current release of L<Template::Benchmark>.
41
42				However, it should also be perfectly safe to use the current
43				L<Task::Template::Benchmark> with an older install of L<Template::Benchmark>
44				- you'll most likely only end up installing some extra modules that won't
45				be used by that older version.
46
47				=head1 INCLUDED MODULES
48
49				=over
50
51				=item Template Benchmark itself:
52
53				L<Template:Benchmark>
54
55				=item Optional bits for extra L<benchmark_template_engines> behaviour:
56
57				L<Term::ProgressBar::Simple>
58
59				L<JSON::Any>
60
61				=item Modules required by multiple plugins:
62
63				L<File::Spec>
64
65				L<File::Spec> needed by plugins for:
66				L<Mojo::Template>, L<Tenjin>, L<Text::MicroMason>, L<Text::Tmpl>.
67
68				L<IO::File>
69
70				L<IO::File> needed by plugins for:
71				L<Mojo::Template>, L<Tenjin>.
72
73				=item Template Engines:
74
75				L<HTML::Template>
76
77				L<HTML::Template::Compiled>
78
79				L<HTML::Template::Expr>
80
81				L<HTML::Template::JIT>
82
83				L<HTML::Template::Pro>
84
85				L<Mojo>
86
87				L<Mojo::Template>
88
89				L<NTS::Template>
90
91				L<Template::Alloy>
92
93				L<Template::Sandbox>
94
95				Extras for L<Template::Sandbox>:
96
97				L<Cache::CacheFactory>
98				L<Cache::Cache>
99				L<Cache::FastMemoryCache>
100				L<Cache::FastMmap>
101				L<CHI>
102
103				L<Template::Tiny>
104
105				L<Template>
106
107				Extras for L<Template>:
108
109				L<Template::Stash::XS>
110				L<Template::Parser::CET>
111
112				L<Tenjin> 0.05 (pre-0.05 Tenjin was an incompatible API change)
113
114				L<Text::ClearSilver>
115
116				L<Text::MicroMason>
117
118				L<Text::MicroTemplate>
119
120				L<Text::MicroTemplate::Extended>
121
122				L<Text::Template>
123
124				L<Text::Template::Simple>
125
126				L<Text::Tmpl>
127
128				L<Text::Xslate> 0.1030 (0.1030 required for bridge support)
129
130				L<Text::Xslate::Bridge::TT2>
131
132				=back
133
134				=head1 WINDOWS SUPPORT
135
136				Under Windows the following modules are not installed because they
137				appear to fail on Windows:
138
139				=over
140
141				=item L<HTML::Template::Compiled>
142
143				=item L<HTML::Template::JIT>
144
145				=item L<Text::ClearSilver>
146
147				=item L<Text::Xslate>
148
149				=item L<Text::Xslate::Bridge::TT2>
150
151				=item L<Term::ProgressBar::Simple>
152
153				These modules appear to have build failures under windows, or prerequisites
154				that fail to build.
155
156				=item L<NTS::Template>
157
158				Returns empty content.
159
160				=item L<Template::Alloy>
161
162				The L<HTML::Template> emulation for L<Template::Alloy> appears to
163				get confused by the volume letters in Windows filenames.
164
165				=item L<Template::Tiny>
166
167				=item L<Text::Template::Simple>
168
169				Error on attempting to run the template.
170
171				=item L<Text::Tmpl>
172
173				Returns corrupted output at tail end of template.
174
175				=back
176
177				=head1 KNOWN ISSUES AND BUGS
178
179				None currently known.
180
181				=head1 SEE ALSO
182
183				L<Template::Benchmark>
184
185				=head1 AUTHOR
186
187				Sam Graham, C<< <libtemplate-benchmark-perl BLAHBLAH illusori.co.uk> >>
188
189				=head1 BUGS
190
191				Please report any bugs or feature requests to C<bug-task-template-benchmark at rt.cpan.org>, or through
192				the web interface at L<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Task-Template-Benchmark>. I will be notified, and then you'll
193				automatically be notified of progress on your bug as I make changes.
194
195
196
197
198				=head1 SUPPORT
199
200				You can find documentation for this module with the perldoc command.
201
202				perldoc Task::Template::Benchmark
203
204
205				You can also look for information at:
206
207				=over 4
208
209				=item * RT: CPAN's request tracker
210
211				L<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Task-Template-Benchmark>
212
213				=item * AnnoCPAN: Annotated CPAN documentation
214
215				L<http://annocpan.org/dist/Task-Template-Benchmark>
216
217				=item * CPAN Ratings
218
219				L<http://cpanratings.perl.org/d/Task-Template-Benchmark>
220
221				=item * Search CPAN
222
223				L<http://search.cpan.org/dist/Task-Template-Benchmark/>
224
225				=back
226
227
228				=head1 LICENSE AND COPYRIGHT
229
230				Copyright 2010 Sam Graham.
231
232				This program is free software; you can redistribute it and/or modify it
233				under the terms of either: the GNU General Public License as published
234				by the Free Software Foundation; or the Artistic License.
235
236				See http://dev.perl.org/licenses/ for more information.
237
238				=cut