Barbie > WWW-Scraper-ISBN-ISBNdb_Driver-0.09 > WWW::Scraper::ISBN::ISBNdb_Driver

Download:
WWW-Scraper-ISBN-ISBNdb_Driver-0.09.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.09   Source   Latest Release: WWW-Scraper-ISBN-ISBNdb_Driver-0.11

NAME ^

WWW::Scraper::ISBN::ISBNdb_Driver - Search driver for the isbndb.com online book catalog

SYNOPSIS ^

  use WWW::Scraper::ISBN;
  my $scraper = new WWW::Scraper::ISBN();
  $scraper->drivers( qw/ ISBNdb / );
  $WWW::Scraper::ISBN::ISBNdb_Driver::ACCESS_KEY = 'xxxx'; # Your isbndb.com access key

  my $isbn = '0596101058';
  my $result = $scraper->search( $isbn );

  if( $result->found ) {
    my $book = $result->book;
    print "ISBN: ",      $book->{isbn},      "\n";
    print "Title: ",     $book->{title},     "\n";
    print "Author: ",    $book->{author},    "\n";
    print "Publisher: ", $book->{publisher}, "\n";
  }

DESCRIPTION ^

This is a WWW::Scraper::ISBN driver that pulls data from http://www.isbndb.com. Consult WWW::Scraper::ISBN for usage details.

METHODS ^

search()

Given an ISBN, will attempt to find the details via the ISBNdb.com API. If a valid result is returned, the following fields are returned via the book hash:

  isbn          (now returns isbn13)
  isbn10        
  isbn13
  ean13         (industry name)
  title
  author
  book_link
  publisher
  pubdate
  binding       (if known)
  pages         (if known)
  weight        (if known) (in grammes)
  width         (if known) (in millimetres)
  height        (if known) (in millimetres)
  depth         (if known) (in millimetres)
  description   (if known)

Deprecated fields, which will be removed in a future version:

  location
  year          # now pubdate
  _source_url   # now book_link

THE ACCESS KEY ^

To use this driver you will need to obtain an access key from isbndb.com. It is free to sign-up to isbndb.com, and once registered, you can request an API key.

To set the access key in the driver, within your application you will need to set the following, after the driver has been loaded, and before you perform a search.

  $WWW::Scraper::ISBN::ISBNdb_Driver::ACCESS_KEY = 'xxxx';

You can also set the key in the ISBNDB_ACCESS_KEY environment variable.

Alternatively, you can create a '.isbndb' configuration file in your home directory, which should only contain the key itself.

Reference material for developers can be found at http://isbndb.com/api/v2/docs.

SEE ALSO ^

WWW::Scraper::ISBN

BUGS ^

Please report any bugs or feature requests to bug-www-scraper-isbn-isbndb_driver at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WWW-Scraper-ISBN-ISBNdb_Driver. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT ^

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

    perldoc WWW::Scraper::ISBN::ISBNdb_Driver

You can also look for information at:

AUTHOR ^

  2006-2013 David J. Iberri, C<< <diberri at cpan.org> >>
  2013      Barbie, E<lt>barbie@cpan.orgE<gt>

COPYRIGHT AND LICENSE ^

  Copyright 2004-2013 by David J. Iberri
  Copyright 2013-2014 by Barbie

  This distribution is free software; you can redistribute it and/or
  modify it under the Artistic Licence v2.
syntax highlighting: