Package: pyFixedFlatFile
PyFixedFlatFileEm vários ambientes corporativos, empresas trocam dados através de arquivos de textos que obedecem uma determinada estrutura, uma determinada especificação acordada entre elas. Esses arquivos são chamados de arquivosflat filecom conteúdo de tamanho fixo.
A biblioteca então facilita a criação desses arquivos do tipoflat file.Instalaçãopip install pyFixedFlatFileAgora o pyfixedFlatFile possui o módulo cnabs de extratosNo modulo cnabs tem(terá) como ler arquivos de extratos dos principais bancos.
Por enquanto tem os módulos dos bancos itau, bradesco, santander.frompyFixedFlatFile.cnabsimportItauresult=Itau.read('Path_para_arquivo_extrato_itau')print(result)frompyFixedFlatFile.cnabsimportBradescoresult=Bradesco.read('Path_para_arquivo_extrato_bradesco')print(result)frompyFixedFlatFile.cnabsimportSantanderresult=Santander.read('Path_para_arquivo_extrato_bradesco')print(result)Como usar?Como demonstração será usada uma especificação fictícia que definirá como o conteúdo do arquivo deve ser estruturado.
Após essa definição geraremos o um arquivo com dados também fictícios que obedecem a especificação..EspecificaçãoO arquivo vai ser referente a informações de um empresa fictícia chamada MyCompany.
No arquivo cada registro (linha) deve possuir um identificador com tamanho dois(as duas primeiras colunas), afim de identificar quais são os dados que aquele registro possui.O registro que começar com 10, vai ter as seguintes informações:NomeTamanhotipoid2n (Númerico)cnpj14a (Alfa-númerico)inscrição estadual14a (Alfa-númerico)nome administradora34a (Alfa-númerico)valor fixo 21a (Alfa-númerico)data criação8a (Alfa-númerico)O registro que começar com 11, vai ter as informações:NomeTamanhotipoid2n (Númerico)logradouro34a (Alfa-númerico)numero5n (Númerico)bairro15a (Alfa-númerico)O registro que começar com 90, vai ter as seguintes informações:NomeTamanhotipoid2n (Númerico)cnpj14a (Alfa-númerico)total registros12n (Númerico)Agora que foi definido como os dados devem ser representados no arquivo, iremos ver como descrever essa especificação no pyFixedFlatFile e então gerar o nosso arquivoflat file.Usando o pyFixedFlatFile.O código abaixo é como definimos atráves da biblioteca a especificação descrita no sub-seção anterior.frompyFixedFlatFileimportPyFixedFlatFilefromdatetimeimportdatetimebuilder=PyFixedFlatFile()# instânciando um objeto PyFixedFlatFile# Aqui definimos a construção do flat file# registros que começam com 10builder.eq("10")builder.id(2).\cnpj(14,fmt=lambdav:"{:>14}".format(v)).\inscricaoEstadual(14,default='').\nomeAdm(33).\constant('2').\dataCriacao(8,fmt=lambdad:format(d,'%d%m%Y'))# registros que começam com 11builder.eq(11)builder.id(2).\logradouro(34).\numero(5,tp='numeric').\bairro(15)# registros que começam com 90builder.eq("90")builder.id(2).\cnpj(14,fmt=lambdav:"{:>14}".format(v)).\totalReg(12,tp='numeric').\constant('99')Abaixo uma explicação do código acima.Primeiro importamos o PyFixedFlatFile. Importamos também o datetime pois iremos utilizar no exemplo.frompyFixedFlatFileimportPyFixedFlatFilefromdatetimeimportdatetimeEntão instânciamos o objeto responsável por criar a estrutura ou especificação.builder=PyFixedFlatFile()# a quebra de linha default será o '\n'# oubuilder=PyFixedFlatFile(NL='dos')# a quebra de linha será '\r\n'E assim começamos a criar as nossas definições.builder.eq("10")O trecho de código acima informa ao PyFixedFlatFile que se nos dados que forem passados para ele tiver um id igual a 10, é para vincular os dados com as definições logo após o .eqbuilder.eq("10")builder.id(2).\cnpj(14,fmt=lambdav:"{:>14}".format(v)).\inscricaoEstadual(14,default='').\nomeAdm(33).\constant('2').\dataCriacao(8,fmt=lambdad:format(d,'%d%m%Y'))o.id(2)indica que o atributo id deve ter o tamanho 2. primeiro parâmetro  é sempre o tamanho que o atributo deve ter.o.cnpj(14, fmt=lambda v: "{:>14}".format(v)), indica que o cnpj deve ter o tamanho 14 e como segundo parâmetro é passado um função para formatar o cnpj. Essa função será executada pelo builder e aplicada ao campo passado, no caso o cnpj.o.inscricaoEstadual(14, default=''), indica que a inscrição estadual deve ter o tamanho 14 e é passado também o parâmetro nomeado default. Com ele podemos indicar um valor para quando esse atributo for passado uma string vazia.Existem 4 parâmetros nomeados que podemos passar:default, onde definimos um valor padrão para aquele campo caso ele esteja vazio (string vazia).fmt, onde passamos uma função que deve ter sempre um único argumento. Esse argumento será o valor do próprio atributo.tp, que é usado em conjunto com seu valor 'numeric', para indicar que o campo é numérico, pois por default os atributos serão tratados como strings.Na específicação é definido que tem um valor fixo para a posição após o nomeAdm quando o registro começar com o identificador '10'. Esse valor fixo é 2. Para esse tipo de situção foi criado o atributo constant, que na nossa construção fica constant('2').Com isso já definimos a nossa especificação usando a biblioteca.Criando um flat fileAgora precisamos passar os dados para que ela trate e gere o que precisamos.
Suponha que vamos buscar os dados em um banco de dados e montamos uma estruta como abaixo.registros=[{"id":"10","cnpj":"00644422230","inscricaoEstadual":"","nomeAdm":"AnjosCompany","dataCriacao":datetime.now(),},{"id":"11","logradouro":"Av Dario Lopes dos Santos","numero":"2197","bairro":"Jardim Botanico",},{"id":"90","cnpj":"01234567891234","totalReg":23,}]Os ids nos dicionários presentes na lista registros, não são ids objetos vindo dos bancos de dados e sim a indicação de qual bloco da especificação do PyFixedFlatFile vai tratar o dicionário específico.
Assim a lista acima será tratado pelo bloco:builder.eq("10")builder.id(2).\cnpj(14,fmt=lambdav:"{:>14}".format(v)).\inscricaoEstadual(14,default='').\nomeAdm(33).\constant('2').\dataCriacao(8,fmt=lambdad:format(d,'%d%m%Y'))# registros que começam com 11builder.eq(11)builder.id(2).\logradouro(34).\numero(5,tp='numeric').\bairro(15)# registros que começam com 90builder.eq("90")builder.id(2).\cnpj(14,fmt=lambdav:"{:>14}".format(v)).\totalReg(12,tp='numeric').\constant('99')Percebam que as chaves dos dicionários devem ser iguais ao que foi especificado, exceto pelo atributoconstant, que não é passado pelo dicionário, pois o seu parâmetro ('2'), já é o seu valor.Abaixo como passar os dados para a biblioteca:s=builder.generate_all(registros)print(s)withopen("fixed_flat_file.txt","w")asf:f.write(s)O método generate irá retorna uma string formatada de acordo com a específicação representando um registro (uma linha) do arquivo. No exemplo, esse retorno é concatenado na variável s, que será salva em um arquivo .txt, que é ofixed flat file. Com o método generate_all é retornado uma string com todo o conteúdo que deve ser salvo no arquivo .txt.Pronto, com o pyFixedFlatFile nós definimos uma especificação para os dados e também processamos os dados com base nessa
especificação para construir o nosso arquivo.Lendo um flat fileUsando como exemplo o arquivo gerado no item anterior.builder_r=PyFixedFlatFile()# a quebra de linha default será o '\n'builder_r.eq("10")builder_r.id(2).\cnpj(14).\inscricaoEstadual(14).\nomeAdm(33).\constant('2').\dataCriacao(8,fmt=lambdad:datetime.strptime(d,'%d%m%Y'))# registros que começam com 11builder_r.eq(11)builder_r.id(2).\logradouro(34).\numero(5,tp='numeric').\bairro(15)# registros que começam com 90builder_r.eq("90")builder_r.id(2).\cnpj(14).\totalReg(12,tp='numeric').\constant('99')# Passando a path do arquivo a ser lidoresult=builder_r.read("fixed_flat_file.txt")print(result)# or# Criando .csv a partir do arquivobuilder_r.to_csv("fixed_flat_file.txt")MetaAnderson Marques -andersonoanjo18@gmail.comDistribuído sobre lincensa MIT. VejaLICENSE.txtpara mais informções.