berrycheck 1.0.5
Fornecer aos usuários uma maneira fácil e acessível de obter cotações atualizadas de várias moedas, incluindo as principais moedas do mundo, para fins de negociação, investimento ou outras finalidades financeiras. Além dos preços de ações das principais empresas brasileiras.
License: MIT License
Keywords: berry check

# Bem vindo ao berrycheck

# Descricao
Pacote python de cotacao de moedas e valores de acoes das principais empresas brasileiras. <br>
Acesse: https://github.com/eduardosousaa/berrycheck

# Objetivos
* Fornecer aos usuarios uma maneira facil e acessivel de obter cotacoes atualizadas de varias moedas, incluindo as principais moedas do mundo, para fins de negociacao, investimento ou outras finalidades financeiras. <br>
* Oferecer um pacote facil de usar e bem documentada que permite aos usuarios integrar facilmente as cotacoes de moedas em seus proprios projetos e aplicativos. <br>
* Permitir que os usuarios calculem rapidamente o valor de uma moeda em relacao a outra com base nas cotacoes mais recentes, facilitando a conversao de moedas para fins de viagens, compras internacionais ou outras necessidades pessoais ou comerciais. <br>
* Fornecer valores de acoes atualizadas das principais empresas brasileiras. <br>
* Permite tambem o calculo de acoes das empresas. <br>

# Funcionalidades
* Obter cotacoes de varias moedas em tempo real. <br>
* Converter valores entre diferentes moedas. <br>
* Obter os valores das acoes de uma lista de empresas. <br>
* Calcular o valor de acoes de uma empresa. <br>

# Como usar
Siga os passos a seguir

## Instale o pacote <br>
```python
    pip install berrycheck
```

## Importar a biblioteca <br>
```python
    from berry_check import BerryCheck
```

## Criar um objeto da classe <br>
```python
    x = BerryCheck()  
```

## Obter cotacao das moedas <br>
```python
    cotacao_dolar = x.obtem_cotacao("USD", "BRL")["cotacao"]
    cotacao_euro = x.obtem_cotacao("EUR", "BRL")["cotacao"]
    cotacao_libra = x.obtem_cotacao("GBP", "BRL")["cotacao"]
    cotacao_bitcoin = x.obtem_cotacao('BTC', 'BRL')["cotacao"]
```

## Obter cotacao, maxima, minima e variacao <br>
```python
    cotacao = x.obtem_cotacao("USD", "BRL")

    print("Cotacao:", cotacao["cotacao"])
    print("Maximo:", cotacao["maximo"])
    print("Minimo:", cotacao["minimo"])
    print("Variacao:", cotacao["variacao"])
```

## Converter moedas <br>
```python
    valor_em_reais = x.converte_moeda('USD', 'BRL', 100)
    valor_em_reais = x.converte_moeda('EUR', 'BRL', 100)
```

# Codigos das moedas <br>
Veja a lista completa de combinacoes em: https://economia.awesomeapi.com.br/xml/available <br>
Veja a lista de nomes das moedas em: https://economia.awesomeapi.com.br/xml/available/uniq <br>

## Obter valores de acoes das empresas <br>
```python
    valores_acoes = x.obter_valores_acoes(["VALE3.SAO", "PETR4.SAO"])
```

## Calcular valor das acoes <br>
```python
    valor_vale = x.calcular_valor_acoes("VALE3.SAO", 1, valores_acoes)
    valor_petro = x.calcular_valor_acoes("PETR4.SAO", 1, valores_acoes)
```

# Lista de empresas brasileiras para procurar acoes 
* Petrobras: PETR4.SAO <br>
* Vale: VALE3.SAO <br>
* ItaÃº Unibanco: ITUB4.SAO <br>
* Bradesco: BBDC4.SAO <br>
* Banco do Brasil: BBAS3.SAO <br>
* Ambev: ABEV3.SAO <br>
* Magazine Luiza: MGLU3.SAO <br>
* Natura: NATU3.SAO <br>
* B3: B3SA3.SAO <br>
* Gerdau: GGBR4.SAO <br>

# Desenvolvedores 
* Carlos Henrique do Vale e Silva - https://github.com/carlosvale03 <br>
* Eduardo de Sousa Gomes Vieira - https://github.com/eduardosousaa <br>