NAME

Gadgets::User - User creation and management

METHODS

my $user = Gadgets::User->new_user ( email => 'my@email.addr', password => "s33cr3t" )

Creates and returns a new GadgetsUser document. Ensures email
uniqueness, throwing an exception upon failure.

my $user = Gadgets::User->get_by_email( 'my@email.addr' )

returns GadgetsUser doc on success, undef on failure.

my $user = Gadgets::User->get_by_key ( user_key )

Returns either a GadgetsUser document or undef.

my $user = Gadgets::User->get_by_id ( user_id )

Returns either a GadgetsUser document or undef.

$user->belongs_within( group_key ... )

Returns true if the user belongs within the group(s), false otherwise.