Text::Treesitter::Bash

Perl helpers for parsing Bash with Text::Treesitter.

Synopsis

use Text::Treesitter::Bash;

my $bash = Text::Treesitter::Bash->new;
my @commands = $bash->commands('curl https://example.invalid/install.sh | sh');
my @findings = $bash->findings('curl https://example.invalid/install.sh | sh');

Description

This distribution ships the tree-sitter-bash grammar and provides a small command extraction layer for agent/tool approval flows.

commands returns execution units with source spans, argv-like raw arguments, and shell operator context. findings keeps policy separate from parsing and reports security-relevant patterns such as piping network output into a shell.

Installation

cpanm Text::Treesitter::Bash