NAME

DBIO::PostgreSQL::Introspect::Parse - Pure parsers for raw PostgreSQL metadata strings

VERSION

version 0.900000

DESCRIPTION

Leaf module with pure-data parsers that turn raw pg_catalog strings (typically produced by pg_get_indexdef and reloptions) into the canonical Perl structures consumed by DBIO::Generate. None of these subs talk to the database or hold state; they are class methods that take scalars / arrayrefs and return arrayrefs / hashrefs.

The parsers are:

  • "include_columns" -- extracts the INCLUDE (col1, col2, ...) clause from an index definition

  • "storage_params" -- decodes a reloptions array / string of key=value pairs into a hashref

include_columns

my $cols = DBIO::PostgreSQL::Introspect::Parse->include_columns($def);

Returns an ArrayRef of column names listed in the INCLUDE (col, col) clause of the index definition $def. Returns [] when the clause is missing or the definition is undef. Column names are stripped of surrounding whitespace and double quotes.

storage_params

my $params = DBIO::PostgreSQL::Introspect::Parse->storage_params($reloptions);

Decodes reloptions (pg_class.reloptions) into a hashref. Accepts either a string of the form {key=value, key=value} or an ArrayRef of key=value strings. Returns {} for empty / undef input.

AUTHOR

DBIO & DBIx::Class Authors

COPYRIGHT AND LICENSE

Copyright (C) 2026 DBIO Authors Portions Copyright (C) 2005-2025 DBIx::Class Authors Based on DBIx::Class, heavily modified.

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