NAME

Zoidberg::Utils::Output - Zoidberg output routines

SYNOPSIS

        use Zoidberg::Utils qw/:output/;

        # use this instead of perlfunc print
        output "get some string outputted";
        output { string => 'or some data struct dumped' };

DESCRIPTION

This module provides some routines used by various Zoidberg modules to output data.

Although when working within the Zoidberg framework this module should be used through the Zoidberg::Utils interface, it also can be used on it's own.

EXPORT

By default all of the below except typed_output.

METHODS

output(@_)

Output a list of possibly mixed data structs as nice as possible.

A reference to an array of plain scalars may be outputted as a multicolumn list, more complex data will be dumped using Data::Dumper.

message(@_)

Like output() but tags data as a message, in non-interactive mode these may not be printed at all.

debug(@_)

Like output() tags the data as debug output, will only be printed when in debug mode. Debug ouput will be printed to STDERR if printed at all.

complain(@_)

Like output but intended for error messages, data will be printed to STDERR. Has some glue for error objects created by Zoidberg::Utils::Error. Prints $@ when no argument is given.

typed_output($type, @_)

Method that can be used to define output types that don't fit in the above group. $type must be a plain string that is used as output 'tag'.

output_is_captured($type, @_)

Method that returns a boolean that tells whether output is captured or not. This can be used to make terminal output different from data struct output.

AUTHOR

Jaap Karssenberg || Pardus [Larus] <pardus@cpan.org>

Copyright (c) 2011 Jaap G Karssenberg and Joel Berger. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

Zoidberg, Zoidberg::Utils