App-SimpleScan
view release on metacpan or search on metacpan
"options"; these will be initialized with whatever values "Getopt::Long"
got from the command line. You should try to ignore invalid values and
choose defaults for missing items if possible; if not, you should "die"
with an appropriate message.
Methods to alter the input stream
next_line
If a plugin wishes to read the input stream for its own purposes, it may
do so by using "next_line". This returns either a string or undef (at
end of file).
stack_input
Adds lines to the input queue ahead of the next line to be read from
whatever source is supplying them. This allows your plugin to process a
line into multiple lines "in place".
Methods for outputting code
Your pragma will probably use one of the following methods to output
code:
stack_code
A call to "stack_code" will cause the string passed back to be emitted
immediately into the code stream. The test count will remain at its
current value.
stack_test
"stack_test" will immediately emit the code supplied as its argument,
and will increment the test count by one. You should use multiple calls
to "stack_test" if you need to stack more than one test.
Code passed to stack_test will go through all of the filters in the
output filter queue; be careful to not call "stack_test" in an output
filter, as this will cause a recursive loop that will run you out of
memory.
Informational methods
get_current_spec
Returns the current App::SimpleScan::TestSpec object, if there is one.
If code in your plugin is called when either we haven't read any lines
yet, or the last line read was a pragma, there won't be any "current
test spec".
last_line
Returns the actual text of the previous line read. Plugin code that does
not specifically involve the current line (like output filters) may wish
to look at the current line.
DIAGNOSTICS
None as yet.
CONFIGURATION AND ENVIRONMENT
App::SimpleScan requires no configuration files or environment
variables.
DEPENDENCIES
Module::Pluggable and WWW::Mechanize::Pluggable.
INCOMPATIBILITIES
None reported.
BUGS AND LIMITATIONS
No bugs have been reported.
Please report any bugs or feature requests to
"bug-app-simplescan@rt.cpan.org", or through the web interface at
<http://rt.cpan.org>.
AUTHOR
Joe McMahon "<mcmahon@yahoo-inc.com >"
LICENCE AND COPYRIGHT
Copyright (c) 2005, Joe McMahon "<mcmahon@yahoo-inc.com >". All rights
reserved.
This module is free software; you can redistribute it and/or modify it
under the same terms as Perl itself. See perlartistic.
DISCLAIMER OF WARRANTY
BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE
ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH
YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
NECESSARY SERVICING, REPAIR, OR CORRECTION.
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENCE, BE LIABLE
TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL, OR
CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES.
( run in 1.182 second using v1.01-cache-2.11-cpan-39bf76dae61 )