WWW::BF2S 0.03

WWW::BF2S is a Perl module that can get Battlefield 2 Player Stats.

SYNOPSIS

use WWW::BF2S;
my $bf2 = Net::BF2S->new;
my $data = $bf2->getStats(45355493,64573414,64318788,64246757,62797217,61091442,64964638,64661842,65431962,58968459);

Fetches Battlefield 2 player stats from BF2S.

You must use the PID (player ID) when requesting stats. If you try to request the player stats by player name, the module will ignore it and move on to the next one in the list. You can get the PID from many sources, including the BF2S.com website.
You can only make THREE requests for data in a SIX hour period.

This is a restriction from the feed provider, not the module. Try to ask for as many PIDs as possible in one request. The module is being written (this part is coming soon) in a way that will try to include a list of "PID Request Candidates" (a list of PIDs that youve asked for before, but you didnt ask for this time around) that will also be requested in that same request, which is meant to update your local player Stat Cache when possible.

Ill provide more documentation later.

getStats

Access this method in an OO way.

my $data = $bf2->getStats(65431962,64246757,64661842);

It will return a hashref that contains data for the PIDs requested. It is in this format:

$data = {
65431962 => {
country => US,
link => http://bf2s.com/player/65431962/,
time => 525400,
deaths => 5332,
nick => Rd54321,
score => 9757,
wins => 222,
losses => 368,
pid => 65431962,
updated => 1148275361,
rank => 6,
kills => 3237
},
64246757 => {
country => US,
link => http://bf2s.com/player/64246757/,
time => 272092,
deaths => 1739,
nick => dustyheynu,
score => 5076,
wins => 76,
losses => 110,
pid => 64246757,
updated => 1148275361,
rank => 5,
kills => 1130
},
64661842 => {
country => US,
link => http://bf2s.com/player/64661842/,
time => 1008165,
deaths => 11902,
nick => READYORNOTHEREICOME,
score => 29062,
wins => 550,
losses => 689,
pid => 64661842,
updated => 1148275361,
rank => 8,
kills => 8757
}
};

It will only fetch data that is at least two hours old. Otherwise, it will serve the data from the stat cache file.

If none of the PIDs need updated (already updated within two hours), it wont send a request at all and only serve from the cache.

If at least one of the PIDs need updated (because its older than two hours or has never been requested), it will request those PIDs that need updated. When the "PID Request Candidates" feature is ready, it will also request, at that same time, a list of "candidates" from your stat cache.