{
    "content": [
        {
            "type": "text",
            "text": "# TAP::Parser::SourceHandler::File (info)\n\n## NAME\n\nTAP::Parser::SourceHandler::File - Stream TAP from a text file.\n\n## SYNOPSIS\n\nuse TAP::Parser::Source;\nuse TAP::Parser::SourceHandler::File;\nmy $source = TAP::Parser::Source->new->raw( \\'file.tap' );\n$source->assemblemeta;\nmy $class = 'TAP::Parser::SourceHandler::File';\nmy $vote  = $class->canhandle( $source );\nmy $iter  = $class->makeiterator( $source );\n\n## DESCRIPTION\n\nThis is a raw TAP stored in a file TAP::Parser::SourceHandler - it has\n2 jobs:\n\n## Sections\n\n- **NAME**\n- **VERSION**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **METHODS**\n- **CONFIGURATION**\n- **SUBCLASSING**\n- **SEE ALSO**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "TAP::Parser::SourceHandler::File",
        "section": "",
        "mode": "info",
        "summary": "TAP::Parser::SourceHandler::File - Stream TAP from a text file.",
        "synopsis": "use TAP::Parser::Source;\nuse TAP::Parser::SourceHandler::File;\nmy $source = TAP::Parser::Source->new->raw( \\'file.tap' );\n$source->assemblemeta;\nmy $class = 'TAP::Parser::SourceHandler::File';\nmy $vote  = $class->canhandle( $source );\nmy $iter  = $class->makeiterator( $source );",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [],
        "examples": [],
        "see_also": [
            {
                "name": "File",
                "section": "3perl",
                "url": "https://www.chedong.com/phpMan.php/man/File/3perl/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "VERSION",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 10,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 12,
                "subsections": []
            },
            {
                "name": "METHODS",
                "lines": 23,
                "subsections": []
            },
            {
                "name": "CONFIGURATION",
                "lines": 4,
                "subsections": []
            },
            {
                "name": "SUBCLASSING",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 6,
                "subsections": []
            }
        ],
        "sections": {
            "NAME": {
                "content": "TAP::Parser::SourceHandler::File - Stream TAP from a text file.\n",
                "subsections": []
            },
            "VERSION": {
                "content": "Version 3.43\n",
                "subsections": []
            },
            "SYNOPSIS": {
                "content": "use TAP::Parser::Source;\nuse TAP::Parser::SourceHandler::File;\n\nmy $source = TAP::Parser::Source->new->raw( \\'file.tap' );\n$source->assemblemeta;\n\nmy $class = 'TAP::Parser::SourceHandler::File';\nmy $vote  = $class->canhandle( $source );\nmy $iter  = $class->makeiterator( $source );\n",
                "subsections": []
            },
            "DESCRIPTION": {
                "content": "This is a raw TAP stored in a file TAP::Parser::SourceHandler - it has\n2 jobs:\n\n1. Figure out if the raw source it's given is a file containing raw TAP\noutput.  See TAP::Parser::IteratorFactory for more details.\n\n2. Takes raw TAP from the text file given, and converts into an\niterator.\n\nUnless you're writing a plugin or subclassing TAP::Parser, you probably\nwon't need to use this module directly.\n",
                "subsections": []
            },
            "METHODS": {
                "content": "Class Methods\n\"canhandle\"\n\nmy $vote = $class->canhandle( $source );\n\nOnly votes if $source looks like a regular file.  Casts the following\nvotes:\n\n0.9 if it's a .tap file\n0.9 if it has an extension matching any given in user config.\n\n\"makeiterator\"\n\nmy $iterator = $class->makeiterator( $source );\n\nReturns a new TAP::Parser::Iterator::Stream for the source.  \"croak\"s\non error.\n\n\"iteratorclass\"\n\nThe class of iterator to use, override if you're sub-classing.\nDefaults to TAP::Parser::Iterator::Stream.\n",
                "subsections": []
            },
            "CONFIGURATION": {
                "content": "{\nextensions => [ @caseinsensitiveextstomatch ]\n}\n",
                "subsections": []
            },
            "SUBCLASSING": {
                "content": "Please see \"SUBCLASSING\" in TAP::Parser for a subclassing overview.\n",
                "subsections": []
            },
            "SEE ALSO": {
                "content": "TAP::Object, TAP::Parser, TAP::Parser::SourceHandler,\nTAP::Parser::SourceHandler::Executable,\nTAP::Parser::SourceHandler::Perl, TAP::Parser::SourceHandler::Handle,\nTAP::Parser::SourceHandler::RawTAP\n\nperl v5.34.0                      2026-TAP::Parser::SourceHandler::File(3perl)",
                "subsections": []
            }
        }
    }
}