NAME

WWW::Geni - Perl extension for Geni.com

SYNOPSIS

        use WWW::Geni;

        my $geni = new WWW::Geni($username, $password, collaborators => 1);

DESCRIPTION

Use this module to manipulate Geni profiles and examine profile conflicts. This module contains four classes: WWW::Geni, WWW::Geni::List, WWW::Geni::Profile, and WWW::Geni::Conflict.

METHODS

WWW::Geni

WWW::Geni->new($username, $password)

Returns a WWW::Geni object or 0 if login credentials were not supplied or login fails. Optional argument "collaborators" specifies whether to retrieve collaborator conflicts or only your own.

$geni->user()

Get username the script is currently logged in as.

$geni->tree_conflicts()

Returns a WWW::Geni::List of WWW::Geni::Conflict objects. Access by using $list->has_next() and $list->next().

        my $list = $geni->tree_conflicts();
        while(my $conflict = $list->next()){
                # do something
        }

WWW::Geni::Conflict

This object should only be created internally by this module. It is used to group profiles that may be duplicates of each other and document the relationships between those profiles.

$conflict->profile()

Returns a WWW::Geni::Profile object describing the focal profile of this conflict.

$conflict->managers()

TODO: Make sure this is accurate

Returns a WWW::Geni::List of WWW::Geni::Profile objects describing the managers involved in this conflict.

$conflict->type()

Returns the type of conflict in the form "parent" or "partner".

$conflict->actor()

Returns a WWW::Geni::Profile describing the last Geni user who acted upon this conflict.

$conflict->fetch_list()

Returns a WWW::Geni::List of WWW::Geni::Profile objects describing, respectively, the spouses, parents, children, and siblings of the conflict's focal profile.

WWW::Geni::Profile

Describes a single Geni profile.

$profile->id()

Get the new-style ID of the profile, which is in the form "profile-0000000000", or if it is not known, the old-style ID, which is in the form "G00000000000000000".

$profile->first_name()

$profile->middle_name()

$profile->last_name()

$profile->maiden_name()

$profile->display_name()

$profile->gender()

$profile->birth_date()

$profile->birth_location()

$profile->death_date()

$profile->death_location()

$profile->locked()

Returns 1 if profile is locked, 0 if profile is not locked.

$profile->big_tree()

Returns 1 if the profile is in the Big Tree, 0 if it is not.

$profile->claimed()

Returns 1 if the profile is claimed, i. e., a living Geni user, 0 if it is not.

$profile->public()

Returns 1 if the profile is public, 0 if it is private.

$profile->creator()

Returns the WWW::Geni::Profile of the profile's creator.

$profile->guid()

Returns the profile's old-style ID in the form "G00000000000000000" if we have it.

$profile->managers()

TODO: Change this to a WWW::Geni::List of WWW::Geni::Profile objects.

Returns an array of profile ids representing the managers of the profile.

WWW::Geni::Family

This class may not ever be used and may be deleted.

WWW::Geni::List

TODO: see if there is any need for an existing iterable type class instead of defining our own, and weigh the benefits of an additional dependency.

A class representing an iterable group of items of the same type.

$list->has_next()

Return 1 if there are items left in the list, 0 if the list is empty.

$list->next()

Delete and return the next object in the list.

$list->add()

Add an item to the end of the list.

$list->count()

Return the number of items remaining in the list.

SEEALSO

GitHub: https://github.com/erinspice/geni-perl

AUTHOR

Erin Spiceland <lt>erin@thespicelands.com<gt> Erin is a software developer and part-time amateur genealogist, as well as a Geni Curator.

COPYRIGHT AND LICENSE

Copyright (C) 2010-2011 by Erin Spiceland

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.10.1 or, at your option, any later version of Perl 5 you may have available.

cpanm WWW::Geni

perl -MCPAN -e shell
install WWW::Geni