NAME

MIME::Expander::Plugin - Abstract class for plugin of MIME::Expander

SYNOPSIS

# An implement class
package MIME::Expander::Plugin::MyExpander;
use parent qw(MIME::Expander::Plugin);

# This plugin has to be implemented class data 'ACCEPT_TYPES'
# to negotiate for acceptable type
__PACKAGE__->mk_classdata('ACCEPT_TYPES' => [qw(
    type/sub-type
    )]);

# And expand() for determine type
sub expand {
    my $self        = shift;
    my $part        = shift;
    my $callback    = shift;
    my $count       = 0;

    my $contents = $part->body;
    while( my $media = your_expand_function( $contents ) ){
        my $data     = $media->{data};
        my $filename = $media->{name};
        $callback->( \ $contents, {
            filename => $filename, # optional, sometimes it is undef
            });
        ++$count;
    }

    # number of expanded contents
    return $count;
}

DESCRIPTION

MIME::Expander::Plugin is an abstract class for plugin of MIME::Expander.

Each plugins extended this class have to expand the contents of ACCEPT_TYPES and passes each to the callback.

SEE ALSO

MIME::Expander

Class::Data::Inheritable