Metadata-Version: 2.1
Name: basedosdados
Version: 1.6.9
Summary: Organizar e facilitar o acesso a dados brasileiros através de tabelas públicas no BigQuery.
Home-page: https://github.com/base-dos-dados/bases
License: MIT
Author: Joao Carabetta
Author-email: joao.carabetta@gmail.com
Requires-Python: >=3.7.1,<3.11
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: Jinja2 (==3.0.3)
Requires-Dist: ckanapi (==4.6)
Requires-Dist: click (==8.0.3)
Requires-Dist: google-cloud-bigquery (==2.30.1)
Requires-Dist: google-cloud-bigquery-storage (==1.1.0)
Requires-Dist: google-cloud-storage (==1.42.3)
Requires-Dist: importlib-metadata (>=4.11.3,<5.0.0)
Requires-Dist: loguru (>=0.6.0,<0.7.0)
Requires-Dist: pandas (>=1.3.5,<2.0.0)
Requires-Dist: pandas-gbq (>=0.17.4,<0.18.0)
Requires-Dist: pandavro (>=1.6.0,<2.0.0)
Requires-Dist: pyaml (==20.4.0)
Requires-Dist: pyarrow (==6.0.0)
Requires-Dist: ruamel.yaml (==0.17.10)
Requires-Dist: toml (>=0.10.2,<0.11.0)
Requires-Dist: tomlkit (==0.7.0)
Requires-Dist: tqdm (==4.50.2)
Project-URL: Repository, https://github.com/base-dos-dados/bases
Description-Content-Type: text/markdown

# Python Package

## Desenvolvimento Linux e Mac: 

Clone o repositório principal:

```sh
git clone https://github.com/basedosdados/mais.git
```
Entre na pasta local do repositório usando `cd mais/` e suba o ambiente localmente:

```sh
make create-env
. .mais/bin/activate
cd python-package/
python setup.py develop
```

### Desenvolva uma nova feature

1. Abra uma branch com o nome issue-<X>
2. Faça as modificações necessárias
3. Suba o Pull Request apontando para a branch `python-next-minor` ou `python-next-patch`. 
    Sendo, minor e patch referentes ao bump da versão: v1.5.7 --> v\<major>.\<minor>.\<patch>.
4. O nome do PR deve seguir o padrão
    `[infra] <titulo explicativo>`


### O que uma modificação precisa ter

  
- Resolver o problema
- Lista de modificações efetuadas
    1. Mudei a função X para fazer Y
    2. Troquei o nome da variavel Z
- Referência aos issues atendidos
- Documentação e Docstrings
- Testes
  

## Versionamento

**Para publicar uma nova versão do pacote é preciso seguir os seguintes passos:**

1. Fazer o pull da branch:

    ```bash
    git pull origin [python-version]
    ```
  
    Onde `[python-version]` é a branch da nova versão do pacote.

2. Se necessario adicionar novas dependências:
    ```bash
      poetry add <package-name>
    ```

3. Gerar novo `requirements-dev.txt` 

    ```bash
    poetry export -f requirements.txt --output requirements-dev.txt --without-hashes
    ```

4. Editar `pyproject.toml`:

    O arquivo `pyproject.toml` contém, entre outras informações, a versão do pacote em python da **BD**. Segue excerto do arquivo:

    ```toml
    description = "Organizar e facilitar o acesso a dados brasileiros através de tabelas públicas no BigQuery."
    homepage = "https://github.com/base-dos-dados/bases"
    license = "MIT"
    name = "basedosdados"
    packages = [
      {include = "basedosdados"},
    ]
    readme = "README.md"
    repository = "https://github.com/base-dos-dados/bases"
    version = "1.6.1-beta.2"
    ```
    
    O campo `version` deve ser alterado para o número da versão sendo lançada.

5. Push para branch:

    ```bash
    git push origin [python-version]
    ```

6. Publicação do pacote no PyPI (exige usuário e senha):

    Para publicar o pacote no PyPI, use:
    
    ```bash
    poetry version [python-version]
    poetry publish --build
    ```

7. Faz merge da branch para a master
8. Faz release usando a UI do GitHub
9. Atualizar versão do pacote usada internamente




