TAP::Parser::Source - Online Linux Manual PageSection : 3
Updated : 2022-01-21
Source : perl v5.34.0
Note : User Contributed Perl Documentation

NAMETAP::Parser::Source − a TAP source & meta data about it

VERSIONVersion 3.43

SYNOPSIS​ use TAP::Parser::Source; ​ my $source = TAP::Parser::Source−>new; ​ $source−>raw( \'reference to raw TAP source' ) ​ −>config( \%config ) ​ −>merge( $boolean ) ​ −>switches( \@switches ) ​ −>test_args( \@args ) ​ −>assemble_meta; ​ ​ do { ... } if $source−>meta−>{is_file}; ​ # see assemble_meta for a full list of data available

DESCRIPTIONA TAP source is something that produces a stream of TAP for the parser to consume, such as an executable file, a text file, an archive, an IO handle, a database, etc. TAP::Parser::Sources encapsulate these raw sources, and provide some useful meta data about them. They are used by TAP::Parser::SourceHandlers, which do whatever is required to produce & capture a stream of TAP from the raw source, and package it up in a TAP::Parser::Iterator for the parser to consume. Unless you're writing a new TAP::Parser::SourceHandler, a plugin or subclassing TAP::Parser, you probably won't need to use this module directly.

METHODS

Class Methodsnew ​ my $source = TAP::Parser::Source−>new; Returns a new TAP::Parser::Source object.

Instance Methodsraw ​ my $raw = $source−>raw; ​ $source−>raw( $some_value ); Chaining getter/setter for the raw TAP source. This is a reference, as it may contain large amounts of data (eg: raw TAP). meta ​ my $meta = $source−>meta; ​ $source−>meta({ %some_value }); Chaining getter/setter for meta data about the source. This defaults to an empty hashref. See assemble_meta for more info. has_meta True if the source has meta data. config ​ my $config = $source−>config; ​ $source−>config({ %some_value }); Chaining getter/setter for the source's configuration, if any has been provided by the user. How it's used is up to you. This defaults to an empty hashref. See config_for for more info. merge ​ my $merge = $source−>merge; ​ $source−>config( $bool ); Chaining getter/setter for the flag that dictates whether STDOUT and STDERR should be merged (where appropriate). Defaults to undef. switches ​ my $switches = $source−>switches; ​ $source−>config([ @switches ]); Chaining getter/setter for the list of command-line switches that should be passed to the source (where appropriate). Defaults to undef. test_args ​ my $test_args = $source−>test_args; ​ $source−>config([ @test_args ]); Chaining getter/setter for the list of command-line arguments that should be passed to the source (where appropriate). Defaults to undef. assemble_meta ​ my $meta = $source−>assemble_meta; Gathers meta data about the raw source, stashes it in meta and returns it as a hashref. This is done so that the TAP::Parser::SourceHandlers don't have to repeat common checks. Currently this includes: ​ is_scalar => $bool, ​ is_hash => $bool, ​ is_array => $bool, ​ ​ # for scalars: ​ length => $n ​ has_newlines => $bool ​ ​ # only done if the scalar looks like a filename ​ is_file => $bool, ​ is_dir => $bool, ​ is_symlink => $bool, ​ file => { ​ # only done if the scalar looks like a filename ​ basename => $string, # including ext ​ dir => $string, ​ ext => $string, ​ lc_ext => $string, ​ # system checks ​ exists => $bool, ​ stat => [ ... ], # perldoc −f stat ​ empty => $bool, ​ size => $n, ​ text => $bool, ​ binary => $bool, ​ read => $bool, ​ write => $bool, ​ execute => $bool, ​ setuid => $bool, ​ setgid => $bool, ​ sticky => $bool, ​ is_file => $bool, ​ is_dir => $bool, ​ is_symlink => $bool, ​ # only done if the file's a symlink ​ lstat => [ ... ], # perldoc −f lstat ​ # only done if the file's a readable text file ​ shebang => $first_line, ​ } ​ ​ # for arrays: ​ size => $n, shebang Get the shebang line for a script file. ​ my $shebang = TAP::Parser::Source−>shebang( $some_script ); May be called as a class method config_for ​ my $config = $source−>config_for( $class ); Returns config for the $class given. Class names may be fully qualified or abbreviated, eg: ​ # these are equivalent ​ $source−>config_for( 'Perl' ); ​ $source−>config_for( 'TAP::Parser::SourceHandler::Perl' ); If a fully qualified $class is given, its abbreviated version is checked first.

AUTHORSSteve Purkis.

SEE ALSOTAP::Object, TAP::Parser, TAP::Parser::IteratorFactory, TAP::Parser::SourceHandler
0
Johanes Gumabo
Data Size   :   20,017 byte
man-TAP::Parser::Source.3pmBuild   :   2024-12-05, 20:55   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   6 / 165,886
Visitor ID   :     :  
Visitor IP   :   18.191.37.129   :  
Visitor Provider   :   AMAZON-02   :  
Provider Position ( lat x lon )   :   39.962500 x -83.006100   :   x
Provider Accuracy Radius ( km )   :   1000   :  
Provider City   :   Columbus   :  
Provider Province   :   Ohio ,   :   ,
Provider Country   :   United States   :  
Provider Continent   :   North America   :  
Visitor Recorder   :   Version   :  
Visitor Recorder   :   Library   :  
Online Linux Manual Page   :   Version   :   Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.05
Online Linux Manual Page   :   Library   :   lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page   :   Library   :   lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base   :   Version   :   Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base   :   Library   :   lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36

Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.

ERROR : Need New Coding :         (parse_manual_page_|249|TAP::Parser::Source.3pm|36/37|el══─{─══.|.el══─{─══. ds -- \|\(em\| )         (htmlprn|149|TAP::Parser::Source.3pm|36/37|.el══─{─══. ds --  —  |.el══─{─══. ds -- \|\(em\| )         (parse_manual_page_|249|TAP::Parser::Source.3pm|43|br══─}─══|'br══─}─══ )         (htmlprn|149|TAP::Parser::Source.3pm|43|'br══─}─══ |'br══─}─══ )