pyarialib

Sobre o PyAria

O PyAria é uma biblioteca para python para integração com o ARIA.

Instalação

Para instalar, é possível utilizar o pip, apontando para o nosso repositório nexus:

pip install -i https://nexus.tesouro.gov.br/repository/pypi-private/simple pyarialib

Publicar nova versão no nexus

Para publicar uma nova versão da biblioteca no nexus, basta modificar o número da versão no arquivo setup.py, e rodar os pipelines no CI/CD.

Biblioteca Genérica

A biblioteca genérica do ARIA permite acessar qualquer endpoint que desejar e que esteja cadastrado no ARIA. Para isso, basta instanciar um objeto do tipo Aria:

from pyarialib import Aria
aria = Aria("username", "password")

Após isso, é possível utilizar o método request para fazer uma requisição qualquer.

Por exemplo, para acessar o endpoint «uf» do projeto «corporativo», na versão 1, passando parâmetro QueryString «sg_uf» = «DF», podemos executar:

resposta = aria.request('get', 1, 'corporativo', 'uf', query_string_params={'sg_uf': 'DF'})

Depois, posso pegar os dados da resposta em formato de string ou json, usando:

resposta_dict = resposta.json()
resposta_string = resposta.text()

Assim, obtemos o resultado do endpoint na variável «ufs».

As opções além de query_string_params incluem headers ou o corpo da requisição.

query_string_params = {'sg_uf': 'DF'}
headers = {'Content-Type': 'application/json'}
body = 'body em formato de string;

resposta = aria.request('post', 1, 'corporativo', 'uf', query_string_params=query_string_params, headers=headers, body=body)

Opção de enviar um json em formato de dict;

query_string_params = {'sg_uf': 'DF'}
headers = {'Content-Type': 'application/json'}
json_body = {'campo1': 'valor1', 'campo2': 'valor2'}

resposta = aria.request('post', 1, 'corporativo', 'uf', query_string_params=query_string_params, headers=headers, json_body=json_body)