ManipulandoXLSX

Projeto cuja função é recuperar dados de um arquivo txt e criar e inserir os dados recuperados em um arquivo xlsx

Resumo:

Por questões práticas e tecnológicas diversas pessoas, principalmente em ambiente organizacional optam por fazerem relatórios e planilhas digitalizados por computadores para assim acessá-los e apresentá-los de forma mais eficiente.
Assim sendo, a fim de facilitar a vida de um colaborador da área da psicologia que tem a função de fazer um relatório em um arquivo de texto sobre seus pacientes e, após, passar os dados desse relatório em forma de planilha. Desenvolvi um programa que acessa este arquivo na extensão ".txt" e recupera as informações deste arquivo (nome, quantidade de sessões no mês e convênio), calcula o total a receber de cada cliente levando em consideração a quantidade de consultas com o quanto o convênio do respectivo cliente paga.

Tópicos:

🔹 Sobre o projeto

🔹 Funções do script

🔹 Requisitos para rodar o código

🔹 Como rodar o código

Sobre o Projeto:

O programa foi escrito em Python com o auxílio da biblioteca openpyxl, usada para que o Python possa interagir com arquivos gerados pela ferramenta de edição e criação de planilhas Microsoft Excel (arquivos de extensão ".xls" e ".xlsx"). O diretório conta com o script app.py e duas pastas, documentos (onde os documentos de extensão ".txt" ficam) e planilhas (onde o programa app.py salva as planilhas criadas)

Funções do script:

• main():

  Função principal, faz um loop enquanto interage com o usuário para receber o nome do relatório para recuperar os dados e o mês referente à planilha além de chamar as demais funções para criar, inserir os dados e formatar a planilha.

• txt(arq):

  Função que recebe o nome do arquivo de texto inserido pelo usuário; verifica se foi adicionado a extensão, caso não, adiciona a extenção".txt".

• usaDoc(documento):

  Função que recebe o nome do documento; abre o documento; separa os registros; verifica para cada registro, para cada linha do registro se possui algum dos dados necessários, caso a linha tenha a função chamará outra função que garimpa apenas o valor necessário; retorna um dicionário contendo todos dados dos registros.

• precoConvenio(convenio,qtd):

  Função que recebe o nome do convênio do registro e a quantidade de seções; verifica o convênio e retorna o resultado do preço por seção multiplicado pela quantidade.

• pegaQtd(frase):

  Função que recebe a linha onde o valor referente à quantidade se encontra e retorna apenas este valor.

• pegaNome(frase):

  Função que recebe a linha onde o valor referente ao nome se encontra e retorna apenas este valor.

• repetido(lista,nome):

  Função que recebe uma lista de dicionários e um nome; a função irá verificar se o nome pertence a algum dicionário da lista e, caso sim: irá retornar uma lista com o booleano verdadeiro e o índice do dicionário onde está o nome, caso não: será retornado uma lista com falso e o número -1.

• criaPlan(arq,mes):

  Função que recebe o nome do arquivo texto e o mês referente à planilha; cria a planilha; chama as funções que adicionam e estiliza os registros e salva o arquivo com extensão ".xlsx".

• addPessoas

  (pessoas, plan, linhaInicial): Função que recebe uma lista de dicionários que contêm os dados das pessoas, a planilha em que serão inseridos os dados e a linha de onde o programa iniciará a adicionar; adiciona os registros e seus valores na planilha.

• estiliza(planilha,celulas,estilo):

  Função que recebe a planilha que irá modificar, uma lista com as células e um inteiro que indica o tipo de estilo; caso estilo seja igual a 1, a função irá estilizar as células como células de título; caso estilo seja igual a 2, as células serão formatadas como células de valores.

Requisitos para rodar o código:

• Linguagem Python
• Biblioteca openpyxl

Recomendo que use uma versão recente do python para evitar erros. A versão que usei foi a 3.8

Para instalar o Python em seu computador,acesse o link abaixo para abrir o site oficial da linguagem onde pode-se consultar informações sobre a instalação:

https://www.python.org

Para instalar o openpyxl cole o seguinte código na linha de comando do seu computador:

pip install openpyxl

Para mais informações sobre a biblioteca acesse a documentação disponível em:

https://openpyxl.readthedocs.io/

Como rodar o código:

1. Selecione a pasta que deseja baixar o projeto, abra a interface de linha de comando do Git e cole o seguinte código para clonar o projeto:

   git clone https://github.com/KevinFGR/ManipulandoXLSX.git 
   

2. Abra a interface de linha de comando do seu computador na pasta manipulandoxlsx e insira o seguinte comando para executar o programa:

   py app.py
   

3. Interaja com o programa respondendo o mês referente e o nome do arquivo de texto
4. Após o programa informar que a planilha foi criada você pode encontrá la na pasta planilhas