https://github.com/nigelhorne/genealogy-chroniclingamerica

Find URLs for a given person in the Library of Congress Newspaper Records
https://github.com/nigelhorne/genealogy-chroniclingamerica

family-tree genealogy library-of-congress perl

Last synced: about 1 month ago
JSON representation

Find URLs for a given person in the Library of Congress Newspaper Records

• Host: GitHub
• URL: https://github.com/nigelhorne/genealogy-chroniclingamerica
• Owner: nigelhorne
• License: gpl-2.0
• Created: 2018-09-18T20:34:38.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-11-07T20:25:44.000Z (2 months ago)
• Last Synced: 2024-11-07T20:39:14.036Z (2 months ago)
• Topics: family-tree, genealogy, library-of-congress, perl
• Language: Perl
• Homepage:
• Size: 50.8 KB
• Stars: 2
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: Changes

Awesome Lists containing this project

README

        
# NAME

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

# VERSION

Version 0.04

# 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](https://metacpan.org/pod/LWP%3A%3AUserAgent%3A%3AThrottled).

## get\_next\_entry

Returns the next match as a URL.

# AUTHOR

Nigel Horne, ``

# 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](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://github.com/nigelhorne/gedcom)

[https://chroniclingamerica.loc.gov](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](http://rt.cpan.org/NoAuth/Bugs.html?Dist=Genealogy-ChroniclingAmerica)

- Search CPAN

    [https://metacpan.org/release/Genealogy-ChroniclingAmerica](https://metacpan.org/release/Genealogy-ChroniclingAmerica)

# LICENSE AND COPYRIGHT

Copyright 2018-2024 Nigel Horne.

This program is released under the following licence: GPL2