---
name: "Forest::Tree::Builder::SimpleTextFile"
section: "3pm"
platform: "linux"
package: "libforest-perl"
version: "0.10-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Forest::Tree::Builder::SimpleTextFile"
---

# Forest::Tree::Builder::SimpleTextFile(3pm)

Parse trees from indented ASCII files

## NAME

Forest::Tree::Builder::SimpleTextFile - Parse trees from indented ASCII files

## SYNOPSIS

```
    use Path::Class;
    my $file = file($path);
    my $builder = Forest::Tree::Builder::SimpleTextFile->new(
        fh => $file->openr,
    );
    my $tree = $builder->tree;
```

## DESCRIPTION

This module replaces Forest::Tree::Reader::SimpleTextFile with a declarative api instead of an imperative one.

## ATTRIBUTES

- fh

  The filehandle to read from.

  Required.

- parser

  A coderef that parses a single line from `"fh"` and returns the node depth and its value.

  Defaults to space indented text. See also "tab\_width".

- tab\_width

  The indentation level for the default parser. Defaults to 4, which means that four spaces equate to one level of nesting.

## BUGS

All complex software has bugs lurking in it, and this module is no exception. If you find a bug please either email me, or add the bug to cpan-RT.

## AUTHOR

Yuval Kogman

## COPYRIGHT AND LICENSE

Copyright 2008-2014 Infinity Interactive, Inc.

\<http://www.iinteractive.com\>

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