Koha/C4/Installer/PerlDependencies.pm
Magnus Enger 290341d8db Bug 11401: Add support for Norwegian national library card
This patch makes it possible to sync patron data between Koha and the
Norwegian national patron database, in both directions.

In order to use this, the following information is necessary:
- a username/password from the Norwegian national database of libraries
  ("Base Bibliotek"), available to all Norwegian libraries
- a special key in order to decrypt and encrypt PIN-codes/passwords,
  which is only available to Norwegian library system vendors
- a norwegian library vendor username/password

See http://www.lanekortet.no/ for more information (in Norwegian).

While this is of course an implementation of a specific synchronization scheme
for borrower data, attempts have been made to prepare the ground for other sync
schemes that might be implemented later. Especially the structure of the new
borrower_sync table might be reviewed with an eye to how it might fit other
schemes.

To test:

Since the password and cryptographic key needed to use this functionality
is only available to Norwegian library system vendors, only regression testing
can be done on the submitted code. Suggested things to check:

- Apply the patch and make sure the database update is done. This should add
  the new "borrower_sync" table and five new systmpreferences under the
  "Patrons" > "Norwegian patron database" category:
  - NorwegianPatronDBEnable
  - NorwegianPatronDBEndpoint
  - NorwegianPatronDBUsername
  - NorwegianPatronDBPassword
  - NorwegianPatronDBSearchNLAfterLocalHit
- Check that patrons can be created, edited and deleted as usual, when
  NorwegianPatronDBEnable is set to "Disable"
- Check that the new tests in t/NorwegianPatronDB.pm run ok, e.g. on a
  gitified setup:
  $ sudo koha-shell -c "PERL5LIB=/path/to/kohaclone prove -v t/NorwegianPatronDB.t" instancename
- Check that all the other tests still run ok
- Check that the POD in the new files itroduced by this patch looks ok:
  - Koha/NorwegianPatronDB.pm
  - members/nl-search.pl
  - misc/cronjobs/nl-sync-from-koha.pl
  - misc/cronjobs/nl-sync-to-koha.pl
  - t/NorwegianPatronDB.t

Sponsored-by: Oslo Public Library

Update 2014-09-18:
- Rebase on master
- Split out changes to Koha::Schema
- Incorporate new way of authenticating with NL

Update 2014-10-21:
- Rebase on master
- Use Module::Load to load Koha::NorwegianPatronDB in non-NL-specific
  scripts and modules
- Fix the version number of Digest::SHA
- Fix a missing semicolon in kohastructure.sql

Signed-off-by: Chris Cormack <chrisc@catalyst.net.nz>

Signed-off-by: Katrin Fischer <katrin.fischer.83@web.de>
Signed-off-by: Tomas Cohen Arazi <tomascohen@gmail.com>
2014-11-14 09:42:23 -03:00

789 lines
19 KiB
Perl

package C4::Installer::PerlDependencies;
use warnings;
use strict;
our $PERL_DEPS = {
'XML::LibXSLT' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.59'
},
'Text::CSV::Encoded' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.09'
},
'Storable' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '2.20'
},
'PDF::API2' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '2'
},
'Text::CSV_XS' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.32'
},
'Schedule::At' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.06'
},
'MIME::Lite' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '3'
},
'GD' => {
'usage' => 'Patron Images Feature',
'required' => '0',
'min_ver' => '2.39'
},
'List::MoreUtils' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.21'
},
'DBI' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.53'
},
'DBIx::Class::Schema::Loader' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.07039'
},
'Net::Z3950::ZOOM' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.16'
},
'Biblio::EndnoteStyle' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.05'
},
'Date::Calc' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '5.4'
},
'Mail::Sendmail' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.79'
},
'DBD::mysql' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '4.004'
},
'XML::LibXML' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.59'
},
'Email::Date' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.103'
},
'HTML::Scrubber' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.08'
},
'XML::Dumper' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.81'
},
'URI::Escape' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.36'
},
'Unicode::Normalize' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.32'
},
'Text::Wrap' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '2005.082401'
},
'Test' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.25'
},
'Locale::PO' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.17'
},
'LWP::Simple' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.41'
},
'DBD::SQLite2' => {
'usage' => 'Offline Circulation Feature',
'required' => '0',
'min_ver' => '0.33'
},
'SMS::Send' => {
'usage' => 'SMS Messaging Feature',
'required' => '0',
'min_ver' => '0.05'
},
'XML::SAX::ParserFactory' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.01'
},
'Test::Harness' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '2.56'
},
'PDF::API2::Util' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '2'
},
'Class::Accessor' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.3'
},
'HTTP::OAI' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '3.2'
},
'LWP::UserAgent' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '2.033'
},
'MIME::Base64' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '3.07'
},
'Algorithm::CheckDigits' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.5'
},
'Net::LDAP' => {
'usage' => 'LDAP Interface Feature',
'required' => '0',
'min_ver' => '0.33'
},
'PDF::Reuse' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.33'
},
'Text::PDF' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.29',
# We don't use this directly, but it's not a required dependency for
# PDF::Reuse however we need it via that or tests fail.
},
'Font::TTF' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.45',
# Also needed for our use of PDF::Reuse
},
'DateTime' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.58'
},
'DateTime::TimeZone' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.20'
},
'DateTime::Format::DateParse' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.04'
},
'DateTime::Format::MySQL' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.04'
},
'DateTime::Set' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.28'
},
'DateTime::Event::ICal' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.08'
},
'Readonly' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.03'
},
'Readonly::XS' => {
'usage' => 'Core',
'required' => '0',
'min_ver' => '1.02'
},
'Graphics::Magick' => {
'usage' => 'Patron Card Creator Feature',
'required' => '0',
'min_ver' => '1.3.05'
},
'MARC::Charset' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.98'
},
'Memoize::Memcached' => {
'usage' => 'Memcached Feature (Experimental)',
'required' => '0',
'min_ver' => '0.03'
},
'Cache::Memcached::Fast' => {
'usage' => 'Caching',
'required' => '0',
'min_ver' => '0.17'
},
'Cache::FastMmap' => {
'usage' => 'Caching',
'required' => '0',
'min_ver' => '1.34'
},
'Cache::Memory' => {
'usage' => 'Caching',
'required' => '0',
'min_ver' => '2.04'
},
'Net::LDAP::Filter' => {
'usage' => 'LDAP Interface Feature',
'required' => '0',
'min_ver' => '0.14'
},
'Text::CSV' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.01'
},
'PDF::Table' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.9.3'
},
'CGI' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '3.15'
},
'Class::Factory::Util' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.6'
},
'List::Util' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.18'
},
'Lingua::Stem::Snowball' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.952'
},
'Time::localtime' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.02'
},
'Digest::SHA' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '5.43'
},
'MARC::Crosswalk::DublinCore' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.02'
},
'CGI::Session::Serialize::yaml' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '4.2'
},
'CGI::Carp' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.29'
},
'Getopt::Long' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '2.35'
},
'Term::ANSIColor' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.1'
},
'Getopt::Std' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.05'
},
'Data::Dumper' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '2.121'
},
'Lingua::Stem' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.82'
},
'MIME::QuotedPrint' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '3.07'
},
'IPC::Cmd' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.46'
},
'HTTP::Cookies' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.39'
},
'HTTP::Request::Common' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.26'
},
'PDF::Reuse::Barcode' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.05'
},
'Test::More' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.8'
},
'GD::Barcode::UPCE' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.1'
},
'Text::Iconv' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.7'
},
'File::Temp' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.16'
},
'Date::Manip' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '5.44'
},
'Locale::Language' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '2.07'
},
'PDF::API2::Simple' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1'
},
'XML::RSS' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.31'
},
'XML::Simple' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '2.14'
},
'PDF::API2::Page' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '2'
},
'CGI::Session' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '4.2'
},
'CGI::Session::Driver::memcached' => {
'usage' => 'Memcached Feature (Experimental)',
'required' => '0',
'min_ver' => '0.04',
},
'POSIX' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.09'
},
'Digest::MD5' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '2.36'
},
'Authen::CAS::Client' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.05'
},
'Data::ICal' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.13'
},
'MARC::Record' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '2.0.6'
},
'Locale::Currency::Format' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.28'
},
'Number::Format' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.52'
},
'YAML::Syck' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.71'
},
'Time::HiRes' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.86'
},
'MARC::File::XML' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.0.1'
},
'XML::SAX::Writer' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.44'
},
'JSON' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '2.07'
},
'YAML' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.71'
},
'UNIVERSAL::require' => {
'usage' => 'SipServer',
'required' => '0',
'min_ver' => '0.13',
},
'Net::Server' => {
'usage' => 'SipServer',
'required' => '0',
'min_ver' => '0.97',
},
'Business::ISBN' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '2.05',
},
'Template' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '2.22',
},
'Gravatar::URL' => {
'usage' => 'Photos in OPAC reviews',
'required' => '0',
'min_ver' => '1.03',
},
'Modern::Perl' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.03',
},
'DateTime::Format::ICal' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.09',
},
'Template::Plugin::HtmlToText' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.03',
},
'Template::Plugin::JSON::Escape' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.02',
},
'DBD::Mock' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.39'
},
'Test::MockObject' => {
'usage' => 'Core',
'required' => '0',
'min_ver' => '1.09',
},
'Test::MockModule' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.05',
},
'Test::Warn' => {
'usage' => 'Core',
'required' => '0',
'min_ver' => '0.21',
},
'Test::Strict' => {
'usage' => 'Core',
'required' => '0',
'min_ver' => '0.14',
},
'Test::Deep' => {
'usage' => 'Core',
'required' => '0',
'min_ver' => '0.106',
},
'Test::YAML::Valid' => {
'usage' => 'Core',
'required' => '0',
'min_ver' => '0.04',
},
'Text::Unaccent' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.08',
},
'HTML::FormatText' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.23',
},
'AnyEvent' => {
'usage' => 'Command line scripts',
'required' => '0',
'min_ver' => '5.0',
},
'AnyEvent::HTTP' => {
'usage' => 'Command line scripts',
'required' => '0',
'min_ver' => '2.13',
},
'String::Random' => {
'usage' => 'OpacSelfRegistration',
'required' => '1',
'min_ver' => '0.22',
},
'File::Temp' => {
'usage' => 'Plugins',
'required' => '0',
'min_ver' => '0.22',
},
'File::Copy' => {
'usage' => 'Plugins',
'required' => '0',
'min_ver' => '2.08',
},
'File::Path' => {
'usage' => 'Plugins',
'required' => '0',
'min_ver' => '2.07',
},
'Archive::Extract' => {
'usage' => 'Plugins',
'required' => '0',
'min_ver' => '0.60',
},
'Archive::Zip' => {
'usage' => 'Plugins',
'required' => '0',
'min_ver' => '1.30',
},
'Module::Load::Conditional' => {
'usage' => 'Plugins',
'required' => '0',
'min_ver' => '0.38',
},
'Module::Bundled::Files' => {
'usage' => 'Plugins',
'required' => '0',
'min_ver' => '0.03',
},
'Module::Pluggable' => {
'usage' => 'Plugins',
'required' => '0',
'min_ver' => '3.9',
},
'File::Slurp' => {
'usage' => 'Command line scripts',
'required' => '0',
'min_ver' => '9999.13',
},
'Test::WWW::Mechanize' => {
'usage' => 'Testing suite',
'required' => '0',
'min_ver' => '1.44',
},
'Library::CallNumber::LC' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.22',
},
'Crypt::Eksblowfish::Bcrypt' => {
'usage' => 'Password storage',
'required' => '1',
'min_ver' => '0.008',
},
'HTTPD::Bench::ApacheBench' => {
'usage' => 'Load testing',
'required' => '0',
'min_ver' => '0.73',
},
'Email::Valid' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.190',
},
'OpenOffice::OODoc' => {
usage => 'Export',
required => 1,
min_ver => '2.125',
},
'Locale::Maketext' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '1.19',
},
'Locale::Maketext::Lexicon' => {
'usage' => 'Core',
'required' => '1',
'min_ver' => '0.91',
},
'LWP::Protocol::https' => {
'usage' => 'OverDrive integration',
'required' => '0',
'min_ver' => '5.836',
},
'Test::DBIx::Class' => {
'usage' => 'Testing modules utilising DBIx::Class',
'required' => '0',
'min_ver' => '0.42',
},
'Text::Bidi' => {
'usage' => 'Label batch PDF',
'required' => '1',
'min_ver' => '0.03',
},
'SOAP::Lite' => {
'usage' => 'Norwegian national library card',
'required' => '0',
'min_ver' => '0.712',
},
'Crypt::GCrypt' => {
'usage' => 'Norwegian national library card',
'required' => '0',
'min_ver' => '1.24',
},
'Convert::BaseN' => {
'usage' => 'Norwegian national library card',
'required' => '0',
'min_ver' => '0.01',
},
'Digest::SHA' => {
'usage' => 'Norwegian national library card',
'required' => '0',
'min_ver' => '5.61',
},
};
1;
__END__
=head1 NAME
C4::Installer::PerlDependencies
=head1 ABSTRACT
A module for cataloging Koha Perl dependencies.
=head1 SYNOPSIS
This module's sole purpose for existence is to provide a single location to catalog all Koha Perl dependencies. New dependencies should be added to the
end of the outer hash and follow the key/value pattern used in the other dependencies.
=head2 Debian
If you change the list of dependencies, and you use Debian, please also
run the debian/update-control script and commit the modified version of
debian/control into git as well. If you're not running Debian, don't
worry about it.
=head1 AUTHOR
Chris Nighswonger <cnighswonger AT foundations DOT edu>
=head1 COPYRIGHT
Copyright 2010 Foundations Bible College.
=head1 LICENSE
This file is part of Koha.
Koha is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later version.
You should have received a copy of the GNU General Public License along with Koha; if not, write to the Free Software Foundation, Inc., 51 Franklin Street,
Fifth Floor, Boston, MA 02110-1301 USA.
=head1 DISCLAIMER OF WARRANTY
Koha is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
=cut