TITLE

pqldump - Dump a quotelike thing

SYNOPSIS

 pqldump '"foo$bar"'
 pqldump fubar.pl
 pqldump -help
 pqldump -version

OPTIONS

-encoding

 -encoding utf-8

This option specifies the encoding of the entities to be parsed, and of the output. If unspecified, no encoding is assumed unless the input is a file, in which case the file's encoding is derived from its PPI parse.

-help

This option displays the documentation for this script. The script then exits.

-indent

 -indent 4

This option controls the number of spaces each level of structure is indented.

The default is -indent 2.

-locations

If this Boolean option is true the locations of the tokens will be dumped.

-margin

 -margin 2

This option controls the number of spaces of left margin.

The default is -margin 0.

-perl-version

If asserted, this option causes the minimum Perl version (and the maximum if applicable) to be dumped.

The defualt is -noperl-version.

-ppi

If asserted, this option causes a PPI dump on any interpolations found. PPI must be installed for this to work.

The default is -noppi.

-short

If this option is asserted, leading 'PPIx::QuoteLike::' will be removed from the class names in the output.

The default is -noshort.

-significant

If this option is asserted, only significant tokens are dumped. As of version 0.004, this only has effect in combination with -tokens, since all tokens interior to the string are significant.

The default is -nosignificant.

-tokens

If asserted, an unstructured dump of the tokens found is done.

The default is -notokens.

-variables

If asserted, this option causes the names of variables interpolated by any interpolations found to be dumped. PPI must be installed for this to work.

The default is -novariables.

-version

This option displays the version of this script. The script then exits.

-whitespace

This option is the inverse of -significant, and is added for quasi-compatibility with the Perl::Critic ppidump tool.

The default is (and must be) -whitespace.

DETAILS

This Perl script is a command-line interface to PPIx::QuoteLike::Dumper's dump() method. The arguments can be either literals or files. For files, all literals in the file are dumped.

AUTHOR

Thomas R. Wyant, III wyant at cpan dot org

COPYRIGHT AND LICENSE

Copyright (C) 2016-2021 by Thomas R. Wyant, III

This program is free software; you can redistribute it and/or modify it under the same terms as Perl 5.10.0. For more details, see the full text of the licenses in the directory LICENSES.

This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.

cpanm PPIx::QuoteLike

perl -MCPAN -e shell
install PPIx::QuoteLike