mac::aete::parser(3) [osx man page]

Mac::AETE::Parser(3)					User Contributed Perl Documentation				      Mac::AETE::Parser(3)

NAME

       Mac::AETE::Parser - parses Macintosh AETE and AEUT resources.

SYNOPSIS

	    use Mac::AETE::Parser;
	    use Mac::AETE::Format::Dictionary;

	    $aete = Parser->new($aete_handle, $name);
	    $formatter = Dictionary->new;
	    $aete->set_format($formatter);
	    $aete->read;
	    $aete->write;

DESCRIPTION

       The Parser module serves as a base class for the Mac::AETE::App and Mac::AETE::Dialect modules.

       Methods

       new	 Example: ($aete_handle is a handle containing a valid AETE resource. $name is the name of the application.)

		      use Mac::AETE::Parser;
		      use Mac::AETE::Format::Dictionary;

		      $aete = Parser->new($aete_handle, $name);

       read	 Reads the data contained in the AETE resource or handle. Example:

		      $aete->read;

       set_format
		 Sets the output formatter used during by the 'write' subroutine. Example:

		      $formatter = Dictionary->new;
		      $aete->set_format($formatter);

       copy	 Copies all suites from one Parser object into another. Example:

		      $aete2 = Parser->new($aete_handle2, $another_name);
		      $aete->copy($aete2);

		 copies the suites from $aete2 into $aete.

       merge	 Merges suites from one Parser object into another. Only the suites that exist in both objects will be replaced. Example:

		      $aete3 = Parser->new($aete_handle2, $another_name);
		      $aete->merge($aete3);

       write	 Prints the contents of the AETE or AEUT resource using the current formatter.

		      $aete->write;

INHERITANCE

       Parser does not inherit from any other modules.

AUTHOR

       David Schooley <dcschooley@mediaone.net>

       The data structures are adapted from modifications made to the original aeteconvert script by Chris Nandor.

perl v5.10.0							    2006-06-01						      Mac::AETE::Parser(3)

TAP::Parser::SourceHandler::File(3pm)			User Contributed Perl Documentation		     TAP::Parser::SourceHandler::File(3pm)

NAME

       TAP::Parser::SourceHandler::File - Stream TAP from a text file.

VERSION

       Version 3.25

SYNOPSIS

	 use TAP::Parser::Source;
	 use TAP::Parser::SourceHandler::File;

	 my $source = TAP::Parser::Source->new->raw( 'file.tap' );
	 $source->assemble_meta;

	 my $class = 'TAP::Parser::SourceHandler::File';
	 my $vote  = $class->can_handle( $source );
	 my $iter  = $class->make_iterator( $source );

DESCRIPTION

       This is a raw TAP stored in a file TAP::Parser::SourceHandler - it has 2 jobs:

       1. Figure out if the raw source it's given is a file containing raw TAP output.	See TAP::Parser::IteratorFactory for more details.

       2. Takes raw TAP from the text file given, and converts into an iterator.

       Unless you're writing a plugin or subclassing TAP::Parser, you probably won't need to use this module directly.

METHODS

   Class Methods
       "can_handle"

	 my $vote = $class->can_handle( $source );

       Only votes if $source looks like a regular file.  Casts the following votes:

	 0.9 if it's a .tap file
	 0.9 if it has an extension matching any given in user config.

       "make_iterator"

	 my $iterator = $class->make_iterator( $source );

       Returns a new TAP::Parser::Iterator::Stream for the source.  "croak"s on error.

       "iterator_class"

       The class of iterator to use, override if you're sub-classing.  Defaults to TAP::Parser::Iterator::Stream.

CONFIGURATION

	 {
	  extensions => [ @case_insensitive_exts_to_match ]
	 }

SUBCLASSING

       Please see "SUBCLASSING" in TAP::Parser for a subclassing overview.

SEE ALSO

       TAP::Object, TAP::Parser, TAP::Parser::SourceHandler, TAP::Parser::SourceHandler::Executable, TAP::Parser::SourceHandler::Perl,
       TAP::Parser::SourceHandler::Handle, TAP::Parser::SourceHandler::RawTAP

perl v5.14.2							    2012-06-05				     TAP::Parser::SourceHandler::File(3pm)