1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
|
#!/usr/bin/perl -w
#
# Copyright (C) 1998, Dj Padzensky <djpadz@padz.net>
# Copyright (C) 1998, 1999 Linas Vepstas <linas@linas.org>
# Copyright (C) 2000, Yannick LE NY <y-le-ny@ifrance.com>
# Copyright (C) 2000, Paul Fenwick <pjf@Acpan.org>
# Copyright (C) 2000, Brent Neal <brentn@users.sourceforge.net>
# Copyright (C) 2001, Rob Sessink <rob_ses@users.sourceforge.net>
# Copyright (C) 2004, Frank Mori Hess <fmhess@users.sourceforge.net>
# Trent Piepho <xyzzy@spekeasy.org>
#
# This program 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.
#
# This program 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.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
# 02111-1307, USA
#
#
# This code is derived from version 0.9 of the AEX.pm module.
require 5.005;
use strict;
package Finance::Quote::TSP;
use vars qw($VERSION $TSP_URL $TSP_MAIN_URL %TSP_FUND_COLUMNS %TSP_FUND_NAMES);
use LWP::UserAgent;
use HTTP::Request::Common;
use HTML::TableExtract;
$VERSION = '0.2';
# URLs of where to obtain information
$TSP_URL = 'http://www.tsp.gov/rates/share-prices.html';
$TSP_MAIN_URL=("http://www.tsp.gov");
%TSP_FUND_COLUMNS = (
TSPL2040FUND => "L 2040",
TSPL2030FUND => "L 2030",
TSPL2020FUND => "L 2020",
TSPL2010FUND => "L 2010",
TSPLINCOMEFUND => "L INCOME",
TSPGFUND => "G FUND",
TSPFFUND => "F FUND",
TSPCFUND => "C FUND",
TSPSFUND => "S FUND",
TSPIFUND => "I FUND" );
%TSP_FUND_NAMES = (
TSPL2040 => 'Lifecycle 2040 Fund',
TSPL2030 => 'Lifecycle 2030 Fund',
TSPL2020 => 'Lifecycle 2020 Fund',
TSPL2010 => 'Lifecycle 2010 Fund',
TSPLINCOME => 'Lifecycle Income Fund',
TSPGFUND => 'Government Securities Investment Fund',
TSPFFUND => 'Fixed Income Index Investment Fund',
TSPCFUND => 'Common Stock Index Investment Fund',
TSPSFUND => 'Small Capitalization Stock Index Investment Fund',
TSPIFUND => 'International Stock Index Investment Fund' );
sub methods { return (tsp => \&tsp) }
{
my @labels = qw/name nav date isodate currency method/;
sub labels { return (tsp => \@labels); }
}
# ==============================================================================
sub tsp {
my $quoter = shift;
my @symbols = @_;
# Make sure symbols are requested
##CAN exit more gracefully - add later##
return unless @symbols;
# Local Variables
my(%info, %fundrows);
my($ua, $reply, $row, $te);
$ua = $quoter->user_agent;
$reply = $ua->request(GET $TSP_URL);
return unless ($reply->is_success);
$te = new HTML::TableExtract( headers =>
["Date", values %TSP_FUND_COLUMNS] );
$te->parse($reply->content);
# First row is newest data, older data follows, maybe there
# should be some way to get it?
$row = ($te->rows())[0];
# Make a hash that maps the order the columns are in
for(my $i=1; my $key = each %TSP_FUND_COLUMNS ; $i++) {
$fundrows{$key} = $i;
}
foreach (@symbols) {
# Ignore case when looking up the data. Preserve case
# when storing the symbol name in the info array.
my $tmp = uc $_;
$tmp = uc sprintf("TSP%sfund", substr($tmp,0,1))
if (index("GFCSI", substr($tmp,0,1)) >= 0);
if (index("LINCOME", substr($tmp,0,7)) >= 0)
{
$tmp = uc sprintf("TSP%sfund", substr($tmp,0,7));
} elsif (index("L", substr($tmp,0,1)) >= 0) {
$tmp = uc sprintf("TSP%sfund", substr($tmp,0,5));
}
if(exists $fundrows{$tmp}) {
$info{$_, 'success'} = 1;
$info{$_, 'method'} = 'tsp';
$info{$_, 'currency'} = 'USD';
$info{$_, 'source'} = $TSP_MAIN_URL;
$info{$_, 'symbol'} = $_;
$info{$_, 'name'} = $TSP_FUND_NAMES{$tmp};
$info{$_, 'nav'} = $info{$_, 'last'} = $$row[$fundrows{$tmp}];
$quoter->store_date(\%info, $_, {usdate => $$row[0]});
} else {
$info{$_, 'success'} = 0;
$info{$_, 'errormsg'} = "Fund name unknown";
}
}
return %info if wantarray;
return \%info;
}
1;
=head1 NAME
Finance::Quote::TSP Obtain fund prices for US Federal Government Thrift Savings Plan
=head1 SYNOPSIS
use Finance::Quote;
$q = Finance::Quote->new;
%info = Finance::Quote->fetch("tsp","c"); #get value of C "Common Stock Index Investment" Fund
=head1 DESCRIPTION
This module fetches fund information from the "Thrift Savings Plan"
homepage http://www.tsp.gov.
=head1 LABELS RETURNED
The following labels may be returned by Finance::Quote::TSP :
name nav date currency method
=head1 SEE ALSO
Thrift Savings Plan, http://www.tsp.gov
=cut
|
