NAME

Genealogy::ChroniclingAmerica - Find URLs for a given person on the Library of Congress Newspaper Records

VERSION

Version 0.03

SYNOPSIS

use HTTP::Cache::Transparent;  # be nice
use Genealogy::ChroniclingAmerica;

HTTP::Cache::Transparent::init({
    BasePath => '/tmp/cache'
});
my $loc = Genealogy::ChroniclingAmerica->new({
    firstname => 'John',
    lastname => 'Smith',
    state => 'Indiana',
    date_of_death => 1862
});

while(my $url = $loc->get_next_entry()) {
    print "$url\n";
}

SUBROUTINES/METHODS

new

Creates a Genealogy::ChroniclingAmerica object.

It takes three mandatory arguments state, firstname and lastname. State must be the full name, not an abbreviation.

There are four optional arguments: middlename, date_of_birth, date_of_death, ua and host: host is the domain of the site to search, the default is chroniclingamerica.loc.gov. ua is a pointer to an object that understands get and env_proxy messages, such as LWP::UserAgent::Throttled.

get_next_entry

Returns the next match as a URL.

AUTHOR

Nigel Horne, <njh at bandsman.co.uk>

BUGS

If a middle name is given and no match is found, it should search again without the middle name.

Please report any bugs or feature requests to bug-genealogy-chroniclingamerica at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Genealogy-ChroniclingAmerica. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SEE ALSO

https://github.com/nigelhorne/gedcom https://chroniclingamerica.loc.gov

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Genealogy::ChroniclingAmerica

You can also look for information at:

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=Genealogy-ChroniclingAmerica

• CPAN Ratings

  http://cpanratings.perl.org/d/Genealogy-ChroniclingAmerica

• Search CPAN

  https://metacpan.org/release/Genealogy-ChroniclingAmerica

LICENSE AND COPYRIGHT

Copyright 2018,2019 Nigel Horne.

This program is released under the following licence: GPL2