Metadata-Version: 2.4
Name: pyFBDS
Version: 0.1.7
Summary: Pacote e scripts para obter dados espaciais da Fundação Brasileira para o Desenvolvimento Sustentável (FBDS)
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.32.5
Requires-Dist: requests-cache>=1.2.1
Requires-Dist: tqdm>=4.67.1
Requires-Dist: lxml>=6.0.0
Requires-Dist: ipywidgets>=8.1.8
Requires-Dist: aiohttp>=3.13.2
Requires-Dist: nest-asyncio>=1.6.0
Requires-Dist: pandas>=2.3.3
Requires-Dist: selenium>=4.38.0
Dynamic: license-file

# pyFBDS

[![Repo](https://img.shields.io/badge/GitHub-repo-blue?logo=github&logoColor=f5f5f5)](https://github.com/open-geodata/pyFBDS)
[![PyPI - Version](https://img.shields.io/pypi/v/pyFBDS?logo=pypi&label=PyPI&color=blue)](https://pypi.org/project/pyFBDS/)<br>
[![Read the Docs](https://img.shields.io/readthedocs/pyfbds/latest?logo=ReadTheDocs&label=Read%20The%20Docs)](https://pyfbds.readthedocs.io/)
[![Publish Python to PyPI](https://github.com/open-geodata/pyFBDS/actions/workflows/publish-to-pypi-uv.yml/badge.svg)](https://github.com/open-geodata/pyFBDS/actions/workflows/publish-to-pypi-uv.yml)

Pacote e _scripts_ para obter dados espaciais do [**repositório público de mapas e _shapefiles_ para _download_**](https://geo.fbds.org.br/) disponibilizados pela [Fundação Brasileira para o Desenvolvimento Sustentável (FBDS)](https://www.fbds.org.br). Veja mais na documentação:

> [https://pyFBDS.readthedocs.io/](https://pyFBDS.readthedocs.io/)

<br>

![qgis](docs/assets/imgs/qgis.png)

<br>

---

## Como Instalar?

```shell
pip3 install pyFBDS
```

<br>

---

## Como Usar?

Abaixo alguns usos simples do pacote.

```shell
# Importa pacote
import pyFBDS

# Instancia Objeto
fbds = pyFBDS.Repo(
    output_path='.',
    temp_path='.',
    log_path='.',
)

# Faz Download dos Dados para output_path
fbds.download_data(municipio='SANTOS', estado='SP')

# Lê dados espaciais em formato geodataframe
fbds.read_data(municipio='SANTOS', estado='SP')
```

<br>

---

## _TODO_

1. ~~Definir funções de fazer o _download_ dos arquivos, a partir da lista.~~
2. ~~Realizar o agendamento para obter a lista.~~
3. ~~Ajustar a pasta de _download_. Atualmente vai para a pasta padrão. Movi manualmente!~~
4. Ajustar os tipos de arquivos (Pontos, Polylines, Polygons), visto que na lista de arquivos surgiu uma feição curiosa:
   1. _RIOS_DUPLOS.shp_
   2. _RIOS*DUPLOS*.shp_
   3. _RIOS_DUPLOS_POL.shp_
