masukomi/uuid-v4

Raku library to generate a random v4 UUID (Universally Unique IDentifier)

NAME

UUID::V4 - generates a random v4 UUID (Universally Unique IDentifier)

SYNOPSIS

use UUID::V4;

# generate a uuid
my $uuid = uuid-v4(); # 62353163-3235-4165-b337-316436626539

# validate a string against uuid-v4 regexp
my $confirmation = is-uuid-v4($uuid); # True

DESCRIPTION

UUID::V4 generates a random v4 UUID (Universally Unique IDentifier). See the RFC 4122 specification for details.

AUTHOR

masukomi (a.k.a Kay Rhodes) based on Nobuyoshi Nakada's work in Ruby.

COPYRIGHT AND LICENSE

Copyright 2022

This library is free software; you can redistribute it and/or modify it under the MIT license.

WHY

Unfortunately LibUUID requires the uuid dynamic library which wasn't found on my mac, and thus I can't rely on it to "just work" on other people's macs when it's a dependency. This library uses Crypt::Random which doesn't suffer from that problem and should work on all Unix / Linux systems and Windows.

sub uuid-v4

sub uuid-v4() returns Str

Generate a UUID in V4 format.

sub is-uuid-v4

sub is-uuid-v4(
    Str $maybe_uuid
) returns Bool

Test if a string matches the UUID v4 format.