NAME

       EBook::Tools::BISG - Class for downloading information from the Book Industry Study Group webpages

SYNOPSIS

        use EBook::Tools::BISG;
        my $bisg = EBook::Tools::BISG->new();
        $bisg->download_bisac;
        $bisg->save_bisac;
        say $bisg->bisac('fic000000');
        %bisac_codes = $bisg->bisac();

DEPENDENCIES

       •   "DBI"

           This will also require a DBD of your choice.  The default is to use a local SQLite store.

       •   "LWP"

       •   "Mojo::DOM"

CONSTRUCTOR

   "new(%args)"
       Instantiates a new Ebook::Tools::BISG object.

       Arguments

       •   "baseurl"

           The base url of the bisg.org website or mirror to use.

       •   "dsn"

           The  Perl::DBI  Data  Source  Name.  Defaults to a sqlite store named bisac.sqlite in the user config
           directory.

ACCESSOR METHODS

   "bisac($code)"
       Returns either the name matching a particular code (case-insensitive), or the hash of all BISAC codes and
       references with the keys in lower-case if no argument is provided.

   "find($regexp)"
       Returns a list of all BISAC values (names) where either the key or the value for  that  entry  matches  a
       case-insensitive  regular  expression.   If  no argument is specified, or it is just '.', then the entire
       list is returned.

MODIFIER METHODS

   "download_bisac()"
       Downloads the BISAC codes from the BISG website and converts  them  into  a  hash.   Codes  and  obsolete
       entries are lowercased and made the keys, the values will be the official names they map to.

   "load_bisac()"
       Load the BISAC codes from the specified database into the hash.  This is called automatically by new().

       If  the  load  fails,  nothing will happen (silently!), so the only way to tell is to check to see if you
       have a populated hash afterwards.

   "save_bisac()"
       Save the BISAC codes in  the  hash  to  the  database.   This  will  destroy  any  existing  table  named
       bisac_codes.

       Croaks on failure.

perl v5.24.1                                       2017-05-22                            EBook::Tools::BISG(3pm)