{geocodebr} em Python

[rafapereirabr]

Hoje a gente teve uma conversa muito boa eu e @kimjoaoun com a proposta de criar o {geocodebr} em Python. Listo abaixo alguns principios que concordamos deveriam nortear o desenvolvimento das versões em R e em Python de maneira coordenada.

Pincipios gerais

• As versões em R e em Python devem ser identicas em termos de interface para os usuários (nome das funções, parâmetros, documentação etc)
• O funcionamento das funções deve ser consistente em ambas linguagens. Isto significar que as funções devem receber os mesmos tipos de input e garantir que o output também é idêntico nos dois pacotes .
• a documentação dos pacotes será principalmente em português para aumentar adesão de usuários Brasilieiros, incluindo órgãos governamentais

Pontos a se resolver

O @kimjoaoun ja fez uma versão preliminar em Python. Listo abaixo algumas questões que precisariam ser resolvidas na versão em Python para termos um release. Quando chegarmos num acordo sobre a lista de pontos abaixo, daí podemos criar um issue para cada ponto.

1. Padronização de enderecos de input deve serguir o mesmo processo que se faz no R e na padronização do CNEFE para garantir consistência entra linguas e melhores resultados
   • Ecaminhamento ideal: criar um pacote {endereçobr} para Python.
2. Formato de input: a versão R atualmente aceita somente campos separados e a verão em Python aceita somente endereço completo como uma string unica.
   • Encaminhamento: implementar no Python o input com campos em colunas separadas.
   • Numa versão futura, poderiamos permitir o usuario passar uma string só, e dar um warning alertando que isso pode prejudicar performance.
3. Disponibilizar dentro do pacote de Python os mesmos sample data sets utilizados para testes e exemplos
4. Implementar no pacote de Python os mesmos testes unitários implementados na versão R
5. Resultados identicos entre pacotes. Seria possivel criar um Gtihub actions que roda o geocode utilizando os dois pacotes em R e em Python e checa se os resultados são identicos.

[kimjoaoun]

@rafapereirabr precisei de um tempo para me ajustar aqui, mas ainda nessa semana devo começar a tocar essa issue.

[rafapereirabr]

obrigado pela atualizacao, @kimjoaoun ! Como a gente tinha falado, um primeiro para versao python seria termos o {enderecobr} para a padronizacao de enderecos. Um colega da equipe fez uma 1a versao e abriu um pull request. Voce pode dar uma olhada?

[luanrjjj]

Opa, tem alguém trabalhando na migração do geocodebr pra Python? Vi que o endereçobr já está com o PR aberto. Aqui iremos precisar do geocodebr em python, posso ajudar nessa migração.

[rafapereirabr]

Oi Alfredo. Estamos planejando uma versão em python mas isso deve demorar um pouco. Enquanto isso, você pode por favor testar a versão que está no PR ?Rafael H M Pereira -------- Original message --------From: Alfred Freitas ***@***.***> Date: 9/18/25 13:25 (GMT-03:00) To: ipeaGIT/geocodebr ***@***.***> Cc: Rafael H M Pereira ***@***.***>, Mention ***@***.***> Subject: Re: [ipeaGIT/geocodebr] {geocodebr} em Python (Issue #54) luanrjjj left a comment (ipeaGIT/geocodebr#54) Opa, tem alguém trabalhando na migração do geocodebr pra Python? Vi que o endereçobr já está com o PR aberto. Aqui iremos precisar do geocodebr em python, posso ajudar nessa migração. —Reply to this email directly, view it on GitHub, or unsubscribe.You are receiving this because you were mentioned.Message ID: ***@***.***>

[luanrjjj]

Na verdade já estava fazendo de maneira não formal. Porque o endereçobr vai se tornar bastante crucial em vários cenários da parte de engenharia de dados aqui no órgão. Portanto, posso fazer formalmente sim. Darei o retorno lá no PR.

[rafapereirabr]

Ótimo! Fico aguardando um retorno então! Você tem como comparar o output da versão em R e em Python ? Por curiosidade,  qual o órgão?Rafael H M Pereira -------- Original message --------From: Alfred Freitas ***@***.***> Date: 9/18/25 20:51 (GMT-03:00) To: ipeaGIT/geocodebr ***@***.***> Cc: Rafael H M Pereira ***@***.***>, Mention ***@***.***> Subject: Re: [ipeaGIT/geocodebr] {geocodebr} em Python (Issue #54) luanrjjj left a comment (ipeaGIT/geocodebr#54) Na verdade já estava fazendo de maneira não formal. Porque o endereçobr vai se tornar bastante crucial em vários cenários da parte de engenharia de dados aqui no órgão. Porém, posso fazer formalmente sim. Darei o retorno lá no PR. —Reply to this email directly, view it on GitHub, or unsubscribe.You are receiving this because you were mentioned.Message ID: ***@***.***>

[luanrjjj]

Comparo sim. Te adicionei no Linkedin, ai posso te informar o órgão por lá, porque ainda não é um processo formal. internamente. a exposição no Github. Mas você já trabalhou com o pessoal daqui, e tenho divulgado o projeto com outras equipes.

[rafapereirabr]

No momento, o road plan aqui é:

1. Implementar uma versão em Rust do pacote {enderecobr}, que é um dos pilares do {geocodebr}. Isso vai permitir uma base comum para tornar o {enderecobr} em R muito mais eficiente, e vai permitir tambem o proximo item, que é
2. Construir {enderecobr} em Python de forma a garantir que os resultados do {enderecobr} sao consistentes entre R e Python
3. Após termos o {enderecobr} em Python , será possível construir uma versão do {geocodebr} em Python que possuem resultados consistentes com o R

[rafapereirabr]

Atualizando o road plan:

• Agora temos uma versao do {enderecobr} em Rust e em Python
• A versao do {geocodebr} v0.6.0 ja utiliza o {enderecobr} construido em Rust.
• Proximo passos, o @gabriel-almeida vai construir uma 1a versao de testes do {geocodebr} em Python.

A expectativa que é que o processo de construcao da versao em Python ajude a gente a otimizar o workflow do pacote e os codigos das queries para ter mais ganhos de eficiencia no pacote.