11.2. Installing Finance::Quote
<<< Prev Chapter 11. Setting Up the Quote Retrieval Next >>>

11.2. Installing Finance::Quote

To determine if the Perl module Finance::Quote is already installed on your system, type perldoc Finance::Quote in a terminal window and check to see if there is any documentation 

$ perldoc Finance::Quote
NAME
    Finance::Quote - Get stock and mutual fund quotes from various exchanges

SYNOPSIS
       [...]

available. If you are now shown documentation, then Finance::Quote is already installed and you can configure periodical quotes update as described in Section 11.3.3, “Updating Prices Automatically with gnucash-cli”. If no documentation is displayed, you will have to continue with this chapter.

The process of installing Finance::Quote depends on the system. For the different supported systems, you can follow the instructions below:

Procedure 11.4. On Linux

  1. Close GnuCash.

  2. Run the gnucash-cli --quotes info command to verify that the program is already in a directory that is entered in the PATH environment variable. [9]

  3. Next, update Finance::Quote with sudo gnc-fq-update.

  4. Run gnucash-cli --quotes info to check Finance::Quote works properly. This command returns the version number of Finance::Quote module currently installed as well as a list of sources available via the Finance::Quote module. It will also inform you if there is a problem with your installation or if it is missing, and may suggest a fix.

Procedure 11.5. On macOS

Note

You must be logged in with a user id that can administer the mac to use this procedure.

  1. Close GnuCash.

  2. Install Xcode [10] if it is not installed. It contains devel tools, which are required by CPAN to build and test the needed Finance::Quote modules.

  3. Open a Finder window, select Applications from the sidebar, double-click Utilities in the file area, then double-click on Terminal to open Terminal

  4. In the Terminal window enter sudo /Applications/Gnucash.app/Contents/Resources/bin/gnc-fq-update. That script asks lots of questions. Accept the default for each.

  5. Type exit or Control+D to terminate the shell followed by Command+Q to quit Terminal.

Procedure 11.6. On Windows

  1. Close GnuCash.

  2. Run Install Online Price Retrieval for GnuCash. This is a small utility that installs Finance::Quote for you.


[9] If you’ve installed GnuCash packages provided by your distribution, gnucash-cli must be on your PATH. The currentness of your distribution can be checked under Finance::Quote- versions.

[10] You can install Xcode from the App Store or install the much smaller Xcode command line tools by running sudo xcode-select --install from a Terminal.app prompt.

<<< Prev Home Next >>>
11.1. Installing Perl Up 11.3. Using gnucash-cli for Testing and Automation.