blib/lib/Crypt/PRNG/RC4.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/Fortuna.pm ↑ Summary blib/lib/Crypt/PRNG/Sober128.pm »
1 package Crypt::PRNG::RC4;
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('RC4', @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::RC4->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::RC4 - Legacy RC4-based PRNG wrapper
45  
46 =head1 SYNOPSIS
47  
48 ### Functional interface:
49 use Crypt::PRNG::RC4 qw(random_bytes random_bytes_hex random_bytes_b64 random_bytes_b64u random_string random_string_from rand irand);
50  
51 my $octets = random_bytes(45);
52 my $hex_string = random_bytes_hex(45);
53 my $base64_string = random_bytes_b64(45);
54 my $base64url_string = random_bytes_b64u(45);
55 my $alphanumeric_string = random_string(30);
56 my $string = random_string_from('ACGT', 64);
57 my $floating_point_number_0_to_1 = rand;
58 my $floating_point_number_0_to_88 = rand(88);
59 my $unsigned_32bit_int = irand;
60  
61 ### OO interface:
62 use Crypt::PRNG::RC4;
63  
64 my $prng = Crypt::PRNG::RC4->new;
65 my $seeded_prng = Crypt::PRNG::RC4->new("some data used for seeding PRNG");
66  
67 my $octets = $prng->bytes(45);
68 my $hex_string = $prng->bytes_hex(45);
69 my $base64_string = $prng->bytes_b64(45);
70 my $base64url_string = $prng->bytes_b64u(45);
71 my $alphanumeric_string = $prng->string(30);
72 my $string = $prng->string_from('ACGT', 64);
73 my $floating_point_number_0_to_1 = $prng->double;
74 my $floating_point_number_0_to_88 = $prng->double(88);
75 my $unsigned_32bit_int = $prng->int32;
76  
77 =head1 DESCRIPTION
78  
79 Provides an interface to the RC4-based pseudo-random number generator.
80  
81 This is a thin wrapper around L<Crypt::PRNG> with the algorithm fixed to RC4.
82 All functions and methods accept the same arguments and return the same values
83 as the corresponding L<Crypt::PRNG> entries.
84  
85 RC4 is provided for compatibility with legacy code only and is not recommended
86 for new designs.
87  
88 =head1 EXPORT
89  
90 Nothing is exported by default.
91  
92 You can export selected functions:
93  
94 use Crypt::PRNG::RC4 qw(random_bytes random_string);
95  
96 Or all of them at once:
97  
98 use Crypt::PRNG::RC4 ':all';
99  
100 =head1 FUNCTIONS
101  
102 All functions below behave exactly like the corresponding L<Crypt::PRNG>
103 functions, but use a hidden C<Crypt::PRNG::RC4> object internally.
104  
105 =head2 random_bytes
106  
107 See L<Crypt::PRNG/random_bytes>.
108  
109 =head2 random_bytes_hex
110  
111 See L<Crypt::PRNG/random_bytes_hex>.
112  
113 =head2 random_bytes_b64
114  
115 See L<Crypt::PRNG/random_bytes_b64>.
116  
117 =head2 random_bytes_b64u
118  
119 See L<Crypt::PRNG/random_bytes_b64u>.
120  
121 =head2 random_string
122  
123 See L<Crypt::PRNG/random_string>.
124  
125 =head2 random_string_from
126  
127 See L<Crypt::PRNG/random_string_from>.
128  
129 =head2 rand
130  
131 See L<Crypt::PRNG/rand>.
132  
133 =head2 irand
134  
135 See L<Crypt::PRNG/irand>.
136  
137 =head1 METHODS
138  
139 Unless noted otherwise, assume C<$prng> is an existing C<Crypt::PRNG::RC4>
140 object created via C<new>.
141  
142 =head2 new
143  
144 my $prng = Crypt::PRNG::RC4->new;
145 my $seeded_prng = Crypt::PRNG::RC4->new($seed);
146  
147 Creates a PRNG object using the RC4 algorithm. If C<$seed> is omitted, the
148 object is automatically seeded by the underlying L<Crypt::PRNG> logic. If
149 C<$seed> is provided it must be at least 5 bytes long; empty or shorter seeds
150 fail during initialization.
151  
152 =head2 bytes
153  
154 See L<Crypt::PRNG/bytes>.
155  
156 =head2 bytes_hex
157  
158 See L<Crypt::PRNG/bytes_hex>.
159  
160 =head2 bytes_b64
161  
162 See L<Crypt::PRNG/bytes_b64>.
163  
164 =head2 bytes_b64u
165  
166 See L<Crypt::PRNG/bytes_b64u>.
167  
168 =head2 string
169  
170 See L<Crypt::PRNG/string>.
171  
172 =head2 string_from
173  
174 See L<Crypt::PRNG/string_from>.
175  
176 =head2 double
177  
178 See L<Crypt::PRNG/double>.
179  
180 =head2 int32
181  
182 See L<Crypt::PRNG/int32>.
183  
184 =head1 SEE ALSO
185  
186 =over
187  
188 =item * L<Crypt::PRNG>
189  
190 =item * L<https://en.wikipedia.org/wiki/RC4_cipher>
191  
192 =back
193  
194 =cut
« blib/lib/Crypt/PRNG/Fortuna.pm ↑ Summary blib/lib/Crypt/PRNG/Sober128.pm »