NAME

POE::Component::Lingua::Translate - A non-blocking wrapper around Lingua::Translate

SYNOPSIS

 use POE;
 use POE::Component::Lingua::Translate;

 POE::Session->create(
     package_states => [
         main => [ qw(_start translated) ],
     ],
 );

 $poe_kernel->run();

 sub _start {
     my $heap = $_[HEAP];
     $heap->{trans} = POE::Component::Lingua::Translate->new(
         alias => 'translator',
         back_end => 'Babelfish',
         src      => 'en',
         dest     => 'de',
     );
     
     $poe_kernel->post(translator => translate => 'This is a sentence');
     return;
 }

 sub translated {
     my $result = $_[ARG0];
     # prints 'Dieses ist ein Satz'
     print $result . "\n";
 }

DESCRIPTION

POE::Component::Lingua::Translate is a POE component that provides a non-blocking wrapper around Lingua::Translate. It accepts translate events and emits translated events back.

CONSTRUCTOR

new

Arguments

'alias', an optional alias for the component's session.

Any other arguments will be passed verbatim to Lingua::Translate's constructor.

METHODS

session_id

Takes no arguments. Returns the POE Session ID of the component.

INPUT

The POE events this component will accept.

translate

The first argument should be a string containing some text to translate. The second argument (optional) can be a hash reference containing some context information. You'll get this hash reference back with the translated event.

shutdown

Takes no arguments, terminates the component.

OUTPUT

The POE events emitted by this component.

translated

ARG0 is the translated text. ARG1 is the context hashref from translate. If there was an error, ARG2 will be the error string.

AUTHOR

Hinrik Örn Sigurðsson, hinrik.sig@gmail.com

LICENSE AND COPYRIGHT

Copyright 2008 Hinrik Örn Sigurðsson

This program is free software, you can redistribute it and/or modify it under the same terms as Perl itself.