[GNC] Workaround for Finance::Quote 1.62 Installation Problem (Windows)

[Geoff]

Folks

I am documenting this workaround for a problem encountered installing 
Finance::Quote.  I have only tested this on Windows, but it should also 
work on other operating systems.

When I ran the GnuCash powershell script "gnc-fq-update.ps1" to install 
Finance::Quote, it ran for quite a long time (approximately 1/2 an hour, 
and this is to be expected) and failed at the end with:

========================================================================
Building and testing Spreadsheet-XLSX-0.18 ... OK
Successfully installed Spreadsheet-XLSX-0.18
! Installing the dependencies failed: Module 'Test::Kwalitee' is not 
installed, Module 'Module::CPANTS::Analyse' is not installed
! Bailing out the installation for Finance-Quote-1.62.
29 distributions installed
========================================================================

To rectify this, open up a Command prompt and run the following three 
commands:

cpanm install Module::CPANTS::Analyse --force
cpanm install Test::Kwalitee
cpanm install Finance::Quote

The output should look something like this:

========================================================================
 >cpanm install Module::CPANTS::Analyse --force
--> Working on install
Fetching 
http://www.cpan.org/authors/id/D/DA/DAGOLDEN/install-0.01.tar.gz ... OK
Configuring install-0.01 ... OK
Building and testing install-0.01 ... OK
Successfully reinstalled install-0.01
--> Working on Module::CPANTS::Analyse
Fetching 
http://www.cpan.org/authors/id/I/IS/ISHIGAKI/Module-CPANTS-Analyse-1.02.tar.gz 
... OK
Configuring Module-CPANTS-Analyse-1.02 ... OK
Building and testing Module-CPANTS-Analyse-1.02 ... FAIL
! Testing Module-CPANTS-Analyse-1.02 failed but installing it anyway.
Successfully installed Module-CPANTS-Analyse-1.02
2 distributions installed

 >cpanm install Test::Kwalitee
install is up to date. (0.01)
--> Working on Test::Kwalitee
Fetching 
http://www.cpan.org/authors/id/E/ET/ETHER/Test-Kwalitee-1.28.tar.gz ... OK
Configuring Test-Kwalitee-1.28 ... OK
Building and testing Test-Kwalitee-1.28 ... OK
Successfully installed Test-Kwalitee-1.28
1 distribution installed

 >cpanm install Finance::Quote
install is up to date. (0.01)
--> Working on Finance::Quote
Fetching 
http://www.cpan.org/authors/id/B/BP/BPSCHUCK/Finance-Quote-1.62.tar.gz 
... OK
Configuring Finance-Quote-1.62 ... OK
Building and testing Finance-Quote-1.62 ... OK
Successfully installed Finance-Quote-1.62
1 distribution installed
========================================================================


So what does all this gobbledygook actually mean?
GnuCash uses a piece of open source software called "Finance::Quote" to 
get exchange rates and stock/share/security prices.  This software is 
written in a programming language called "perl", and is maintained by a 
separate group of developers unrelated to the GnuCash team.  Such 
anonymous cooperation is what makes the open source software world so 
powerful.  Anyway, one of the software modules that Finance::Quote 
depends upon (Module::CPANTS::Analyse) failed its self tests when it was 
installed.  This workaround (using the perl "cpanm" command) forces it 
to ignore the self tests and install itself anyway.  Doing this then 
enables all the rest of the Finance::Quote dependencies to be installed 
successfully, which in turn means that you can use GnuCash to get 
exchange rates and stock/share/security prices.


Geoff
=====