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.