NAME

Business::UTV - Module for retrieiving UTV internet account information

SYNOPSIS

 use Business::UTV;
 my $utv = Business::UTV->login( $id , $password , { "name" => "me" } );
 my $usage = $utv->usage();
 print "Upload = " . $usage->{"upload"} . "MB\n";

DESCRIPTION

This module enables you to access your UTV account information using perl.

Currently the only supported data is your current monthly upload/download usage and call data from your latest phone bill.

This module provides the following methods

login

 $utv = Business::UTV->login( $id , $password , { "name" => $name }

The constructor takes your utv id , password and a hash reference and logs into the utv website. Login is verified be checking the name of the account holder is correctly returned.

On failure undef is returned and an error message stored in $Business::UTV::errstr

usage

 my $usage = $utv->usage();
 print "Upload - " . $usage->{"upload"} . "\n";
 print "Download - " . $usage->{"download"} . "\n";

This method retrieves the accounts current upload and download in megabytes as a hash reference.

On failure undef is returned and an error message is stored in $Business::UTV::errstr

current_statement

 my ( $total , $calls ) = $utv->current_statement();

This method returns the total of the latest bill and details of any phone calls.

Calls are returned as an array reference with each call a hash ref with the following fields

 date
 time
 phone_number
 type
 length
 cost

On failure undef is returned and an error message is stored in $Business::UTV::errstr

LIMITATIONS

By definition I am limited to my own account when writting this module. If some features do not work as expected or at all contact me and I'll do my best to add support for different account configurations.

WARNING

This warning is (mostly) from Simon Cozens' Finance::Bank::LloydsTSB, and seems almost as apt here.

This is code for pretending to be you online, and that could mean your money, and that means BE CAREFUL. You are encouraged, nay, expected, to audit the source of this module yourself to reassure yourself that I am not doing anything untoward with your account data. This software is useful to me, but is provided under NO GUARANTEE, explicit or implied.

SEE ALSO

utv_usage_applet.pl utv_usage_tray.pl