Sobre Nomenclatura e Estilo de Código

Uma questão muito relevante é a maneira como esta abstração se refere aos nomes dos métodos disponíveis na biblioteca ACBrLib que utiliza uma convenção de nomenclatura para variáveis e nomes de argumentos ou parâmetros de funções conhecida como Notação Húngara. Porém, em Python é utilizada a convenção snake case tal como descrito na PEP8.

Assim, para manter o estilo de Python, os nomes de variáveis e argumentos de função deverão descartar o prefixo que indica o tipo de dado e converter o restante para snake case, assim como nomes de métodos e funções também, por exemplo:

• eArqConfig para arq_config;

• ConfigLerValor para config_ler_valor;

• eArquivoXmlEvento para arquivo_xml_evento;

• etc…

Métodos de bibliotecas que são prefixados com o nome da lib, será descartado o prefixo e o restante do nome do método convertido para snake case, por exemplo:

• (ACBrLibNFe) NFE_CarregarINI para carregar_ini;

• (ACBrLibNFe) NFE_ValidarRegrasdeNegocios para validar_regras_de_negocios (note a correção do conector de que está em minúsculo no original);

• (ACBrLibCEP) CEP_BuscarPorLogradouro para buscar_por_logradouro;

• etc…

Esperamos que essa explicação faça sentido, senão, envia suas sujestões.

Desenvolvimento

Você é bem-vindo para ajudar no desenvolvimento desta biblioteca enviando suas contribuições através de pull-requests. Faça um fork deste repositório e execute os testes antes de começar a implementar alguma coisa. A gestão de dependências é feita via Poetry e recomendamos a utilização de pyenv

$ git clone https://github.com/base4sistemas/acbrlib-python.git
$ cd acbrlib-python
$ poetry install
$ poetry run pytest