README
1UUID-Tiny Version 1.04
2
3This is a Pure Perl module for the creation of UUIDs:
4
5- version 1 time based (with random multicast MAC address)
6- version 3 MD5 based
7- version 4 random number based
8- version 5 SHA-1 based
9
10The module uses a functional interface and creates binary (network byte order)
11or string representations. Version 3 and 5 UUIDs can be created from file
12content instead of "names" (strings).
13
14Be aware that, because of being a Pure Perl implementation, there are
15performance limits and the randomness of multicast MAC addresses and the
16version 4 numbers are not perfect. If you can afford module compilation and
17installation, you should look at Data::UUID instead!
18
19
20INSTALLATION
21
22To install this module, run the following commands:
23
24 perl Makefile.PL
25 make
26 make test
27 make install
28
29
30DEPENDENCIES
31
32Should run from Perl 5.8 up and uses this modules (mostly Perl 5.8 core):
33
34 Carp
35 Digest::MD5
36 Digest::SHA1 (or Digest::SHA or Digest::SHA::PurePerl)
37 MIME::Base64
38 Time::HiRes
39 POSIX
40
41
42SUPPORT AND DOCUMENTATION
43
44After installing, you can find documentation for this module with the
45perldoc command.
46
47 perldoc UUID::Tiny
48
49You can also look for information at:
50
51 RT, CPAN's request tracker
52 http://rt.cpan.org/NoAuth/Bugs.html?Dist=UUID-Tiny
53
54 AnnoCPAN, Annotated CPAN documentation
55 http://annocpan.org/dist/UUID-Tiny
56
57 CPAN Ratings
58 http://cpanratings.perl.org/d/UUID-Tiny
59
60 Search CPAN
61 http://search.cpan.org/dist/UUID-Tiny/
62
63
64COPYRIGHT AND LICENCE
65
66Copyright (C) 2009, 2010, 2013 Christian Augustin
67
68This program is free software; you can redistribute it and/or modify it
69under the same terms as Perl itself.
70
71