semvec/pypi-packages huggingface dataset:
b3cotahist 0.1.9
Biblioteca Python para leitura e fetch do arquivo COTAHIST da B3. Suporta tanto pandas quanto polars como engines.
Requires Python: <4.0,>=3.10

# b3cotahist

Biblioteca Python para leitura e fetch do arquivo COTAHIST da B3.

## Instalação

```bash
pip install b3cotahist
```

## Uso

### Fetch da B3

```python
import datetime
import b3cotahist

# Fetch dos dados do pregão de 01/03/2024

date = datetime.date(2024, 3, 1)

df = b3cotahist.get(date)

# Caso tenha problemas com SSL da b3
df = b3cotahist.get(date, raise_ssl_error=False)

# A B3 também disponibiliza dados consolidados por ano
df = b3cotahist.get_year(2024)
```

### Leitura de arquivos

```python
df = b3cotahist.read_zip(path='COTAHIST_D20240301.ZIP')

df = b3cotahist.read_txt(path='COTAHIST_D20240301.TXT')
```

### Leitura de bytes

```python
# Lendo a partir de bytes
with open('COTAHIST_D20240301.TXT', 'rb') as f:
    dados = f.read()
df = b3cotahist.read_bytes(dados)

# Ou a partir de BytesIO
import io
bytes_io = io.BytesIO(dados)
df = b3cotahist.read_bytes(bytes_io)
```