blib/lib/Crypt/PRNG/Fortuna.pm

filter: Statementstmt 100% 34 / 34 Branchbran 100% 2 / 2 Conditioncond 66.6% 2 / 3 MC/DCmcdc 50.0% 1 / 2 Subroutinesub 100% 14 / 14 Podpod 100% 9 / 9 totaltotal 96.8% 62 / 64 CC 3 SCAR 3.2
CC
3
Cov
97%
__ANON__
3.0
BEGIN
1.0
BEGIN
1.0
CRAP 1.4
« blib/lib/Crypt/PRNG/ChaCha20.pm ↑ Summary blib/lib/Crypt/PRNG/RC4.pm »
1 package Crypt::PRNG::Fortuna;
2  
3 3 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
4 3 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
5 3 our $VERSION = '0.091';
6  
7 3 ▶use base qw(Crypt::PRNG Exporter);
Subroutine BEGIN: called CC=1 SCAR=0.0
8 3 our %EXPORT_TAGS = ( all => [qw(random_bytes random_bytes_hex random_bytes_b64 random_bytes_b64u random_string random_string_from rand irand)] );
9 3 our @EXPORT_OK = ( @{ $EXPORT_TAGS{'all'} } );
10 3 our @EXPORT = qw();
11  
12 3 ▶use CryptX;
Subroutine BEGIN: called CC=1 SCAR=0.0
13  
14 5 ▶sub new {
Subroutine new: called CC=1 SCAR=0.0
Pod documented
15 5 my ($class, @args) = @_;
16 5 my $obj = Crypt::PRNG->new('Fortuna', @args);
17 5 return bless $obj, $class;
18 }
19  
20 {
21 ### stolen from Bytes::Random::Secure
22 3 my $RNG_object = undef;
23 3006 ▶ my $fetch_RNG = sub { # Lazily, instantiate the RNG object, but only once.
Subroutine __ANON__: called CC=3 SCAR=11.1
24 3006 ▶ $RNG_object = Crypt::PRNG::Fortuna->new unless defined $RNG_object && ref($RNG_object) ne 'SCALAR';
Branch: 1 branch
BranchTrueFalseTotal
unless defined $RNG_object and ref $RNG_object ne "SCALAR" 1 3005 3006
Condition66%2/3
defined $RNG_object and ref $RNG_object ne "SCALAR"
!ll&&!rl&&r
103005
MC/DC50%1/2
defined $RNG_object and ref $RNG_object ne "SCALAR"
defined $RNG_object ref $RNG_object ne "SCALAR"
Truth table66%2/3
A and B
A= defined $RNG_objectB= ref $RNG_object ne "SCALAR"
ABresult
0X0
100
111
25 3006 return $RNG_object;
26 3 };
27 2000 ▶ sub rand { return $fetch_RNG->()->double(@_) }
Subroutine rand: called CC=1 SCAR=0.0
Pod documented
28 1000 ▶ sub irand { return $fetch_RNG->()->int32(@_) }
Subroutine irand: called CC=1 SCAR=0.0
Pod documented
29 1 ▶ sub random_bytes { return $fetch_RNG->()->bytes(@_) }
Subroutine random_bytes: called CC=1 SCAR=0.0
Pod documented
30 1 ▶ sub random_bytes_hex { return $fetch_RNG->()->bytes_hex(@_) }
Subroutine random_bytes_hex: called CC=1 SCAR=0.0
Pod documented
31 1 ▶ sub random_bytes_b64 { return $fetch_RNG->()->bytes_b64(@_) }
Subroutine random_bytes_b64: called CC=1 SCAR=0.0
Pod documented
32 1 ▶ sub random_bytes_b64u { return $fetch_RNG->()->bytes_b64u(@_) }
Subroutine random_bytes_b64u: called CC=1 SCAR=0.0
Pod documented
33 1 ▶ sub random_string_from { return $fetch_RNG->()->string_from(@_) }
Subroutine random_string_from: called CC=1 SCAR=0.0
Pod documented
34 1 ▶ sub random_string { return $fetch_RNG->()->string(@_) }
Subroutine random_string: called CC=1 SCAR=0.0
Pod documented
35 }
36  
37  
38 3 1;
39  
40 =pod
41  
42 =head1 NAME
43  
44 Crypt::PRNG::Fortuna - Cryptographically secure PRNG based on Fortuna algorithm
45  
46 =head1 SYNOPSIS
47  
48 ### Functional interface:
49 use Crypt::PRNG::Fortuna qw(random_bytes random_bytes_hex random_bytes_b64 random_bytes_b64u
50 random_string random_string_from rand irand);
51  
52 my $octets = random_bytes(45);
53 my $hex_string = random_bytes_hex(45);
54 my $base64_string = random_bytes_b64(45);
55 my $base64url_string = random_bytes_b64u(45);
56 my $alphanumeric_string = random_string(30);
57 my $string = random_string_from('ACGT', 64);
58 my $floating_point_number_0_to_1 = rand;
59 my $floating_point_number_0_to_88 = rand(88);
60 my $unsigned_32bit_int = irand;
61  
62 ### OO interface:
63 use Crypt::PRNG::Fortuna;
64  
65 my $prng = Crypt::PRNG::Fortuna->new;
66 my $seeded_prng = Crypt::PRNG::Fortuna->new("some data used for seeding PRNG");
67  
68 my $octets = $prng->bytes(45);
69 my $hex_string = $prng->bytes_hex(45);
70 my $base64_string = $prng->bytes_b64(45);
71 my $base64url_string = $prng->bytes_b64u(45);
72 my $alphanumeric_string = $prng->string(30);
73 my $string = $prng->string_from('ACGT', 64);
74 my $floating_point_number_0_to_1 = $prng->double;
75 my $floating_point_number_0_to_88 = $prng->double(88);
76 my $unsigned_32bit_int = $prng->int32;
77  
78 =head1 DESCRIPTION
79  
80 Provides an interface to the Fortuna-based pseudo-random number generator.
81  
82 This is a thin wrapper around L<Crypt::PRNG> with the algorithm fixed to
83 Fortuna. All functions and methods accept the same arguments and return the
84 same values as the corresponding L<Crypt::PRNG> entries.
85  
86 =head1 EXPORT
87  
88 Nothing is exported by default.
89  
90 You can export selected functions:
91  
92 use Crypt::PRNG::Fortuna qw(random_bytes random_string);
93  
94 Or all of them at once:
95  
96 use Crypt::PRNG::Fortuna ':all';
97  
98 =head1 FUNCTIONS
99  
100 All functions below behave exactly like the corresponding L<Crypt::PRNG>
101 functions, but use a hidden C<Crypt::PRNG::Fortuna> object internally.
102  
103 =head2 random_bytes
104  
105 See L<Crypt::PRNG/random_bytes>.
106  
107 =head2 random_bytes_hex
108  
109 See L<Crypt::PRNG/random_bytes_hex>.
110  
111 =head2 random_bytes_b64
112  
113 See L<Crypt::PRNG/random_bytes_b64>.
114  
115 =head2 random_bytes_b64u
116  
117 See L<Crypt::PRNG/random_bytes_b64u>.
118  
119 =head2 random_string
120  
121 See L<Crypt::PRNG/random_string>.
122  
123 =head2 random_string_from
124  
125 See L<Crypt::PRNG/random_string_from>.
126  
127 =head2 rand
128  
129 See L<Crypt::PRNG/rand>.
130  
131 =head2 irand
132  
133 See L<Crypt::PRNG/irand>.
134  
135 =head1 METHODS
136  
137 Unless noted otherwise, assume C<$prng> is an existing
138 C<Crypt::PRNG::Fortuna> object created via C<new>.
139  
140 =head2 new
141  
142 my $prng = Crypt::PRNG::Fortuna->new;
143 my $seeded_prng = Crypt::PRNG::Fortuna->new($seed);
144  
145 Creates a PRNG object using the Fortuna algorithm. If C<$seed> is omitted, the
146 object is automatically seeded by the underlying L<Crypt::PRNG> logic.
147  
148 =head2 bytes
149  
150 See L<Crypt::PRNG/bytes>.
151  
152 =head2 bytes_hex
153  
154 See L<Crypt::PRNG/bytes_hex>.
155  
156 =head2 bytes_b64
157  
158 See L<Crypt::PRNG/bytes_b64>.
159  
160 =head2 bytes_b64u
161  
162 See L<Crypt::PRNG/bytes_b64u>.
163  
164 =head2 string
165  
166 See L<Crypt::PRNG/string>.
167  
168 =head2 string_from
169  
170 See L<Crypt::PRNG/string_from>.
171  
172 =head2 double
173  
174 See L<Crypt::PRNG/double>.
175  
176 =head2 int32
177  
178 See L<Crypt::PRNG/int32>.
179  
180 =head1 SEE ALSO
181  
182 =over
183  
184 =item * L<Crypt::PRNG>
185  
186 =item * L<https://en.wikipedia.org/wiki/Fortuna_%28PRNG%29>
187  
188 =back
189  
190 =cut
« blib/lib/Crypt/PRNG/ChaCha20.pm ↑ Summary blib/lib/Crypt/PRNG/RC4.pm »