Metadata-Version: 1.1
Name: pybovespa
Version: 0.1.2
Summary: pybovespa is a basic library to get Bovespa stock values.
Home-page: http://gitorious.org/unix-stuff/pybovespa
Author: Beraldo Leal
Author-email: beraldo@beraloleal.com
License: MIT
Description: =========
        pybovespa
        =========
        
        The BM&FBOVESPA (in full, Bolsa de Valores, Mercadorias & Futuros de São Paulo) is a stock exchange located at São Paulo, Brazil.
        
        pybovespa is a basic and simple library to get official BM&FBOVESPA stock values.
        
        ======================
        Installing or updating
        ======================
        
        Just run::
        
            # pip install -U pybovespa
        
        ================================
        Show-me an example, I need code!
        ================================
        
        15-minute delayed info
        ----------------------
        
        When you make a request, 15-minute-old information is retrieved. You can check the date and time with ``stock.time``. Example::
        
            #!/usr/bin/env python3
        
            from pybovespa.bovespa import *
            from pybovespa.stock import *
        
            bovespa = Bovespa()
            stock = bovespa.query("PETR3")
            print(stock.cod, stock.name, stock.last)
        
        The output should be something like this::
        
            PETR3 PETROBRAS ON 24,24
        
        It is possible to make only one request for many stocks::
        
            stocks = bovespa.query("PETR4", "VALE5", "OGXP3")
            for stock in stocks.values():
                print(stock.cod, stock.last)
        
            stock_vale = stocks["VALE5"]
        
        Historical stock data
        ---------------------
        
        Unfortunately, BM&FBovespa does not allow the distribution of their data. However, it is very simple to download them using this library::
        
            bovespa = Bovespa()
            bovespa.download(dst="/tmp/hist", year="2012", overwrite=True)
        
        To download data of all available years::
        
            bovespa.download_all(dst="/tmp/hist", overwrite=True)
        
Platform: Posix; MacOS X;
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Internet
Classifier: Programming Language :: Python :: 3.2
