NAME

Data::Walk::More - Traverse Perl data structures, with more information during traversing

VERSION

This document describes version 0.002 of Data::Walk::More (from Perl distribution Data-Walk-More), released on 2022-07-21.

SYNOPSIS

 use Data::Walk::More; # exports walk() and walkdepth()

 walk \&wanted, @items_to_walk;
 walkdepth \&wanted, @items_to_walk;

 # full options
 walk {
     wanted => \&wanted,
     # follow => 0,         # whether to follow circular refs, default is 0.
     # bydepth => 0,        # whether to descend into subnodes first. default is 0.
     # sortkeys => 1,       # whether to visit hash values in key order. default is 1.
     # recurseobjects => 1, # whether to recurse into objects. default is 1.
 }, @items_to_walk;

DESCRIPTION

This module is like Data::Walk, but there are a few differences, a few more options, and the callback gets more information.

VARIABLES

The following variables are available for the callback. Unless specified otherwise, do not modify these during traversing.

$Data::Walk::More::depth

Integer, starts at 0.

@Data::Walk::More::containers

$Data::Walk::More::container

@Data::Walk::More::indexes

$Data::Walk::More::index

$Data::Walk::More::prune

Can be set to true to prevent Data::Walk::More to descend into hash or array. Ineffective when you use "bydepth" option, since Data::Walk::More will have already descended into hash or array before the callback can prune it.

DIFFERENCES BETWEEN DATA::WALK::MORE (DWM) WITH DATA::WALK (DW)

DWM also provides the full path (containers from the top level, in @containers and <@indexes>) instead of just the immediate container in $container and $index.

When traversing hash, $index package variable in DWM refers to hash key, not a number, which is more useful in my opinion.

You can prune (avoid descending) by setting $prune.

FUNCTIONS

walk

Options:

wanted

bydepth

follow

sortkeys

recurseobjects

walkdepth

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/Data-Walk-More.

SOURCE

Source repository is at https://github.com/perlancar/perl-Data-Walk-More.

SEE ALSO

Data::Walk

AUTHOR

perlancar <perlancar@cpan.org>

CONTRIBUTING

To contribute, you can send patches by email/via RT, or send pull requests on GitHub.

Most of the time, you don't need to build the distribution yourself. You can simply modify the code, then test via:

 % prove -l

If you want to build the distribution (e.g. to try to install it locally on your system), you can install Dist::Zilla, Dist::Zilla::PluginBundle::Author::PERLANCAR, and sometimes one or two other Dist::Zilla plugin and/or Pod::Weaver::Plugin. Any additional steps required beyond that are considered a bug and can be reported to me.

COPYRIGHT AND LICENSE

This software is copyright (c) 2022, 2020 by perlancar <perlancar@cpan.org>.

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

BUGS

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=Data-Walk-More

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

cpanm Data::Walk::More

perl -MCPAN -e shell
install Data::Walk::More