File Coverage

lib/Tie/Hash/Random.pm

Criterion	Covered	Total	%
statement	30	32	93.7
branch	2	2	100.0
condition			n/a
subroutine	9	10	90.0
pod			n/a
total	41	44	93.1

=head1 NAME

Tie::Hash::Random - Generates random for different fetched keys

=head1 SYNOPSIS

  use Tie::Hash::Random;

  my %hash;
  tie %hash, 'Tie::Hash::Random';

  my $a_random_number           = $hash{foo};
  my $an_other_random_number    = $hash{bar};

  $a_random_number == $hash{foo}; ## True

  ## Set a seed
  tie %hash, 'Tie::Hash::Random', { set=> 'alpha', min=>5, max=>5 }};

=head1 DESCRIPTION

Tie::Hash::Random generates a random number each time a different key is fetched.

The actual random data is generated using Data::Random rand_chars function. The default arguments are
                ( set => 'all', min => 5, max => 8 )
which can be modifed using tie parameters as shown in the SYNOPSIS.

=cut

package Tie::Hash::Random;

use 5.006;
use strict;
use warnings;
use vars qw($VERSION @ISA);
use Tie::Hash;
use Data::Random qw(:all);

$VERSION = '1.02';
@ISA = qw(Tie::Hash);


sub TIEHASH  {
    my $storage = bless {}, shift;

    my $args = shift;

    $storage->{__rand_config} = { set => 'numeric', min => 5, max => 8 };

    foreach (keys %$args) {
        $storage->{__rand_config}->{$_} = $args->{$_};
    }

    return $storage;
}


=head2 STORE

Stores data

=cut

sub STORE {
  my ($self, $key, $val) = @_;
  $self->{$key} = $val;
}

=head2 FETCH

Fetchs

=cut

sub FETCH {
  my ($self, $key) = @_;

  $self->{$key} = join '', rand_chars( %{$self->{__rand_config}} ) if ! exists $self->{$key};

  return $self->{$key};
}


=head2 FIRSTKEY


=cut

sub FIRSTKEY {
  my ($self) = @_;
  return 1;
}


1;
__END__