NAME

Uplug::IO::Any - libraries for handling various kinds of input/output

SYNOPSIS

use Uplug::IO::Any;
use Uplug::Data;

 %InSpec = (
   format      => 'text',
   file        => $input_filename,
   access_mode => 'read',
   encoding    => 'iso-8859-1' );

 %OutSpec = (
   format      => 'xml',
   file        => $output_filename,
   access_mode => 'overwrite',
   root        => 's' );


$input  = new Uplug::IO::Any( \%InSpec )
$output = new Uplug::IO::Any( \%OutSpec )

$data=Uplug::Data->new();

while ($input->read($data)){
   # do somwthing with the data
   $output->write($data);
}

$input->close;
$output->close;

DESCRIPTION

This is a class factory for creating data streams of various kinds. Supported sub-classes are:

Uplug::IO::Text ........... plain text
Uplug::IO::XML ............ generic XML class

Uplug::IO::XCESAlign ...... XCES-based sentence alignment
Uplug::IO::MosesWordAlign . word alignment in Moses format
Uplug::IO::PlugXML ........ parallel corpus format (used in the project PLUG)
Uplug::IO::LWA ............ format used by the Linköping Word Aligner (PLUG)
Uplug::IO::LiuAlign ....... Linköping's parallel corpus format (PLUG)

Uplug::IO::DBM ............ databases using AnyDBM
Uplug::IO::Tab ............ tab-separated data
Uplug::IO::Storable ....... storable objects
Uplug::IO::Collection ..... generic class to combine several input streams

Methods

Constructor

$handler = new Uplug::IO::Any( \%spec, $format );

Create a new I/O handler according to the specifications of %spec and the optional format $format. If %spec includes the key stream name: Try to load the specifications of a named stream (see Uplug::Config for more information).

Accepted data formats:

IO-class                    format parameter
-----------------------------------------------
Uplug::IO::Text ........... text
Uplug::IO::XML ............ xml

Uplug::IO::XCESAlign ...... align | xces
Uplug::IO::MosesWordAlign . moses
Uplug::IO::PlugXML ........ plug
Uplug::IO::LWA ............ lwa
Uplug::IO::LiuAlign ....... liu | koma

Uplug::IO::DBM ............ dbm
Uplug::IO::Tab ............ tab | uwa tab
Uplug::IO::Storable ....... storable
Uplug::IO::Collection ..... collection

If no format is given: Check file name extension:

*.dbm ..................... Uplug::IO::DBM
*.uwa ..................... Uplug::IO::Tab
*.txt ..................... Uplug::IO::Text
*.xml ..................... Uplug::IO::XML