NAME

FP::Abstract::Show - data constructor protocol

SYNOPSIS

    package FPShowExample::Foo {
        sub new { my $class = shift; bless [@_], $class }
        sub FP_Show_show {
            my ($self, $show) = @_;
            # $show is for recursive use
            "FPShowExample::Foo->new(".join(", ",
                 map { $show->($_) } @$self).")"
        }
    }

    use FP::Show;

    is show(FPShowExample::Foo->new("hey", new FPShowExample::Foo 5+5)),
       "FPShowExample::Foo->new('hey', FPShowExample::Foo->new(10))";

DESCRIPTION

For an introduction, see FP::Show.

The reason that FP_Show_show is getting a $show argument is to provide for (probably evil, though) context sensitive formatting, but more importantly to hopefully enable to do pretty-printing and cut-off features (this is *alpha* though, see whether this works out).

TODO

Handle circular data structures.

Pretty-printing -- for this, probably move to returning FP::AST::Perl nodes instead of strings.

Declare that non-pretty-printing show must only print one line?

Cut-offs at configurable size

Configuration for whether to force promises

SEE ALSO

FP::Show -- functions to access this protocol usefully

FP::Mixin::Utils -- implemented by this protocol

NOTE

This is alpha software! Read the status section in the package README or on the website.