1App::Prove::Plugin::HTMULs(e3r)Contributed Perl DocumentAaptpi:o:nProve::Plugin::HTML(3)
2
3
4

NAME

6       App::Prove::Plugin::HTML - a prove plugin for HTML output
7

SYNOPSIS

9        # command-line usage:
10        prove -P HTML=outfile:out.html,css_uri:style.css,js_uri:foo.js,force_inline_css:0
11
12        # NOTE: this is currently in alpha, this usage will likely change!
13

DESCRIPTION

15       This is a quick & dirty second attempt at making TAP::Formatter::HTML
16       easier to use from the command line.  It will change once App::Prove
17       has better support for plugins than need to take cmdline data.
18
19       The original goal was to be able to specify all the args on the
20       cmdline, ala:
21
22         prove --html=output.html --css-uri foo.css --css-uri bar.css --force-inline-css 0
23
24       But this is currently not possible with the way the App::Prove plugin
25       system works.
26
27       As a compromise, you must use the following syntax:
28
29         prove -P HTML=arg1:val1,arg2:val2,...
30
31       Where argN is any TAP::Formatter::HTML parameter that is configurable
32       via %ENV.
33
34   Example
35         prove -P HTML=outfile:out.html,css_uri:style.css,js_uri:foo.js,force_inline_css:0
36
37       This will cause prove to load this plugin, which loads
38       TAP::Formatter::HTML for you, and sets formatter to
39       "TAP::Formatter::HTML" to save you some typing.
40
41       To configure TAP::Formatter::HTML, the following %ENV vars are set:
42
43         TAP_FORMATTER_HTML_OUTFILE=out.html
44         TAP_FORMATTER_HTML_FORCE_INLINE_CSS=0
45         TAP_FORMATTER_HTML_CSS_URIS=style.css
46         TAP_FORMATTER_HTML_JS_URIS=func.js
47
48       Yes, you can pass 2 or more css_uri or js_uri args.
49
50   %ENV vars?!
51       Briefly, App::Prove currently only lets you specify the
52       "formatter_class" for TAP::Harness, it doesn't let you instantiate a
53       formatter, or pass config to the formatter.
54
55       Yes, I know %ENV vars are a horrible way to do things.  If it bugs you
56       too, then join the TAP::Harness devs and help us fix it ;-).
57

BUGS

59       Please use http://rt.cpan.org to report any issues.
60

AUTHOR

62       Steve Purkis <spurkis@cpan.org>
63

65       Copyright (c) 2008-2010 Steve Purkis <spurkis@cpan.org>, S Purkis
66       Consulting Ltd.  All rights reserved.
67
68       This module is released under the same terms as Perl itself.
69

SEE ALSO

71       prove, App::Prove, TAP::Formatter::HTML
72
73
74
75perl v5.36.0                      2023-01-20       App::Prove::Plugin::HTML(3)
Impressum