README.md
1
2## Finance::YahooQuote [](https://travis-ci.org/eddelbuettel/finance-yahooquote) [](http://www.gnu.org/licenses/gpl-2.0.html)
3
4Finance::YahooQuote is a Perl 5 module that will pull one or more stock quotes from
5[Yahoo! Finance](http://finance.yahoo.com). It was written by
6[Dj Padzensky](https://www.padz.net/wp/), and is now maintained by
7[Dirk Eddelbuettel](http://dirk.eddelbuettel.com). See the files
8CHANGES.old for DJ's log of changes, and ChangeLog for changes since Dirk took over.
9
10### Yahoo! Status
11
12*Important Note:* As of November 2017, Yahoo! no longer support this interface, so
13the module ceases to be of any use or value. An epic 20-year run has come to
14an end. Consider this repo to be of historic value only.
15
16### CPAN
17
18The package is also available from [CPAN](http://www.cpan.org) via
19[this page](http://search.cpan.org/~edd/Finance-YahooQuote/YahooQuote.pm).
20
21### Source Installation
22
23Once the archive has been unpacked, the following steps are needed
24to build and install the module (to be done in the directory which
25contains the Makefile.PL)
26
27```{.sh}
28perl Makefile.PL
29make
30```
31
32A few simple tests are provided. Please note that the second test
33may fail if your internet connection is down, requires a proxy or if
34Yahoo! is down. That said,
35
36```{.sh}
37make test
38```
39
40can be used to test the integrity of the module prior to installation.
41
42If the build and test succeed, install it with the following command:
43
44```{.sh}
45make install
46```
47
48An example script is installed as `yahooquote`. Two more example scripts
49are include to help examine available services at different Yahoo! servers,
50and to examine the possible mapping between stock symbols for a given
51company.
52
53### Binary Installation
54
55For [Debian](http://www.debian.org) and derivatives such as [Ubuntu](http://www.ubuntu.com),
56a package is available via
57
58```{.sh}
59sudo apt-get install libfinance-yahooquote-perl
60```
61
62For Windows users, ActiveState does maintain a pre-build package that can be
63installed with their ppm tool
64
65### Status
66
67The package is in maintenance mode. Bugs are being fixed, but additions of new functionality
68are unlikely.
69
70### License
71
72GPL (>= 2)
73
74### Authors
75
76DJ Padzensky and Dirk Eddelbuettel
77
78### Maintainer
79
80Dirk Eddelbuettel
81
){kind=link}
){kind=link}