NAME

Biblio::Zotero::DB - helper module to access the Zotero SQLite database

VERSION

version 0.004

SYNOPSIS

  my $db = Biblio::Zotero::DB->new( profile_name => 'abc123.default' );
  $db->schema->resultset('Item')->all;

ATTRIBUTES

schema

A DBIx::Class schema that is connected to the zotero.sqlite file.

This can be cleared using clear_schema.

db_file

A string that contains the filename of the zotero.sqlite file. The default is located in the directory of "profile_directory" attribute.

storage_directory

A string that contains the directory where the Zotero attachments are located. The default is the storage subdirectory of the "profile_directory" directory.

profile_directory

A string that contains the directory where the zotero.sqlite database is located,

  $db->profile_directory( "$ENV{HOME}/.zotero/zotero/abc123.default/zotero/" );

profile_name

A string containing the profile name to use. Setting this will set the "profile_directory" attribute.

  $db->profile_name( 'abc123.default' );
  # corresponds to a profile directory such as
  # <~/.zotero/zotero/abc123.default/zotero/>

METHODS

find_profile_directories()

Returns an arrayref of the possible profile directories that contain a Zotero SQLite database. This can be used as a class method.

see: http://www.zotero.org/support/zotero_data

  Biblio::Zotero::DB->find_profile_directories()
  # returns:
  # [
  #   "$ENV{HOME}/.zotero/zotero/abc123.default/zotero",
  #   "$ENV{HOME}/.zotero/zotero/def567.default/zotero"
  # ]

EXAMPLE

  use Biblio::Zotero::DB;
  use List::UtilsBy qw(min_by);

  # find the most recently modified
  my $newest = min_by { -M } @{Biblio::Zotero::DB->find_profile_directories};
  my $db = Biblio::Zotero::DB->new( profile_directory => $newest  );

  # if there is an issue with the database lock here,
  # see L<Biblio::Zotero::DB::Role::CopyDB>
  $db->schema->resultset('Item')->all;

SEE ALSO

• Biblio::Zotero::DB::Role::CopyDB

AUTHOR

Zakariyya Mughal <zmughal@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Zakariyya Mughal.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

cpanm Biblio::Zotero::DB

perl -MCPAN -e shell
install Biblio::Zotero::DB