File Coverage

blib/lib/App/bovespa.pm

Criterion	Covered	Total	%
statement	31	32	96.8
branch	1	2	50.0
condition			n/a
subroutine	7	7	100.0
pod	1	3	33.3
total	40	44	90.9

use strict;
use warnings;
package App::bovespa;

use HTML::TreeBuilder;
use LWP::UserAgent;

# TODO = multiple providers
#my $url = "https://br.financas.yahoo.com/q?s=PETR4.SA";

my $agent_string = "Mozilla/5.0 (Windows NT 6.3; rv:36.0) Gecko/20100101 Firefox/36.0";

sub new {
    my ( $class ) = @_;

    bless {
    }, $class;
}

sub stock {
    my ( $self, $stock ) = @_;

    return $self->yahoo( $stock );

}

sub yahoo {
    my ( $self, $stock ) = @_;

    my $url = "https://br.financas.yahoo.com/q?s=";
    $stock = uc $stock . ".sa";

    my $ua = LWP::UserAgent->new();
    $ua->ssl_opts( verify_hostname => 0 );
    $ua->timeout( 10 );

    my $response = $ua->get( $url . $stock );
    my $raw_html;
    if ( $response->is_success ){
        $raw_html = $response->decoded_content;
    }else{
        die $response->status_line;
    }

    my $tree = HTML::TreeBuilder->new();
    $tree->parse( $raw_html );

    for ( $tree->find_by_attribute('id', "yfs_l84_". lc $stock )){
        return join "", grep { ref $_ ne "SCALAR" } $_->content_list;
    }
}

=head1 NAME

App::bovespa - Simple tool to follow up your stocks at Bovespa Stock Exchange

=head1 VERSION

Version 0.002

=head1 SYNOPSIS

This module is a crawler to get the cotation of the Bovespa Stock Exchange. Now
it gets information one of the main portals.

This module is just for follow up, really, nothing realtime, nothing too serious.
I wrote it to keep my eyes on my own stocks. It is easier run a script that login
on my homebroker agent, with tokens and etc just to see the cotation.

To get a stock cotation is plain simple:

    use App::bovespa;

    my $exchange = App::bovespa->new();
    my $cotation = $exchange->stock( "PETR4" );

Also inside this distribution, comes a small tool called bovespa_report, it has
a wrapper for cotation and a parser for a file with a list of cotations and prices to
compare.

    bovespa_report --help

Will display all options related with the tool

=head1 SUBROUTINES/METHODS

=head2 stock

Receives a stock name and returns it cotation. The name must be four letters and the type digit.
Like "PETR4" or "PETR3"

=head1 AUTHOR

RECSKY, C<< recsky at cpan.org >>

=head1 BUGS

In case of one of providers change it page or something like that, the lib may broke. In this case
contact me at [e-mail]

Or at irc at irc.perl.org

    #sao-paulo.pm

=head1 LICENSE AND COPYRIGHT

Copyright 2015 RECSKY

This program is free software; you can redistribute it and/or modify it
under the terms of the the Artistic License (2.0). You may obtain a
copy of the full license at:

L
=cut

1;