List::Objects::WithUtils - Object interfaces to lists with useful methods
use List::Objects::WithUtils; # Chained array operations: array(qw/ aa Ab bb Bc bc /) ->grep(sub { $_[0] =~ /^b/i }) ->map( sub { uc $_[0] }) ->uniq ->all; # ( 'BB', 'BC' ) # Sample hash operations: my $hash = hash( foo => 'bar', snacks => 'cake' ); $hash->set( foobar => 'baz', pie => 'tasty' ); my $snacks = $hash->get('snacks'); my $slice = $hash->sliced('foo', 'pie'); my @matching = $hash->keys->grep(sub { $_[0] =~ /foo/ })->all; if ( $hash->keys->any_items eq 'snacks' ) { ... }
A small set of roles and classes defining an object-oriented interface to Perl hashes and arrays. Originally derived from Data::Perl.
Some commonly used functions from List::Util, List::MoreUtils, and List::UtilsBy are conveniently provided as methods. Junctions, as provided by Syntax::Keyword::Junction, are also available.
array is imported from List::Objects::WithUtils::Array and creates a new ARRAY-type object. Behavior is defined by List::Objects::WithUtils::Role::Array; look there for documentation on available methods.
hash is imported from List::Objects::WithUtils::Hash; see List::Objects::WithUtils::Role::Hash for documentation.
Why another object-oriented list module?
There are a fair few object-oriented approaches to lists on CPAN, none of which were quite what I needed. Data::Perl comes the closest -- but is primarily targetting MooX::HandlesVia and cannot guarantee a stable API at the time this was written (plus, I don't need the other data types).
This module aims to provide a consistent, natural interface to hashes and arrays exclusively, with convenient access to common tools. The interface is expected to remain stable; methods may be added but are not expected to be removed (or experience incompatible interface changes, barring serious bugs).
List::Objects::WithUtils::Role::Array for documentation on array() methods.
array()
List::Objects::WithUtils::Role::WithJunctions for details regarding using junctions on an array().
List::Objects::WithUtils::Role::Hash for documentation on hash() methods.
hash()
Jon Portnoy <avenj@cobaltirc.org>
Significant portions of this code are derived from Data::Perl by Matthew Phillips (CPAN: MATTP), haarg, and others.
Licensed under the same terms as Perl.
To install List::Objects::WithUtils, copy and paste the appropriate command in to your terminal.
cpanm
cpanm List::Objects::WithUtils
CPAN shell
perl -MCPAN -e shell install List::Objects::WithUtils
For more information on module installation, please visit the detailed CPAN module installation guide.