Arquivos e Pastas

Operações no sistema de arquivos (pathlib, shutil)

Ler Arquivo de Texto

files.read_text

Lê conteúdo de arquivo (.txt, .csv, .json, etc.)

Como usar

Lê o conteúdo de um arquivo de texto e guarda numa variável. Se aparecerem caracteres estranhos nos acentos, troque a codificação para cp1252 ou latin-1 (comum em arquivos gerados por sistemas antigos).

Exemplo: Leia C:\Robos\entrada\retorno.txt em {conteudo} com codificação cp1252.

Campos

Campo	Tipo	Padrão	Detalhes
Arquivo *	Arquivo
Codificação	Opção	`utf-8`	Opções: utf-8, utf-8-sig, latin-1, cp1252
Salvar resultado na variável *	Variável de saída	`content`

Resultado: guardado na variável content (Texto).

Escrever Arquivo de Texto

files.write_text

Escreve/sobrescreve conteúdo em arquivo

Como usar

Grava o conteúdo num arquivo de texto, criando as pastas que faltarem e substituindo o arquivo se existir.

Exemplo: Grave {relatorio} em C:\Robos\saida\resumo_{data}.txt.

Campos

Campo	Tipo	Padrão	Detalhes
Arquivo *	Arquivo
Conteúdo *	Texto (várias linhas)
Codificação	Opção	`utf-8`	Opções: utf-8, utf-8-sig, latin-1, cp1252

Acrescentar ao Arquivo

files.append_file

Adiciona conteúdo ao final do arquivo

Como usar

Acrescenta o conteúdo ao fim do arquivo (cria se não existir). Bom para logs próprios e arquivos de controle.

Exemplo: Acrescente "{numero};{status}\n" em C:\Robos\controle.csv a cada pedido.

Campos

Campo	Tipo	Padrão	Detalhes
Arquivo *	Arquivo
Conteúdo *	Texto (várias linhas)
Codificação	Opção	`utf-8`	Opções: utf-8, utf-8-sig, latin-1, cp1252

Copiar Arquivo

files.copy_file

Copia arquivo para outro local

Como usar

Copia um arquivo para outra pasta ou outro nome. Por padrão não substitui um arquivo existente no destino.

Exemplo: Copie {arquivo_baixado} para \\servidor\backup\pedidos.

Campos

Campo	Tipo	Padrão
Arquivo de origem *	Arquivo
Destino *	Arquivo
Sobrescrever se existir	Sim/Não	`Não`

Mover Arquivo

files.move_file

Move/renomeia arquivo

Como usar

Move ou renomeia um arquivo. Use para tirar arquivos já processados da pasta de entrada.

Exemplo: Mova {arquivo} para C:\Robos\processados depois de importar.

Campos

Campo	Tipo	Padrão
Arquivo de origem *	Arquivo
Destino *	Arquivo
Sobrescrever se existir	Sim/Não	`Não`

Deletar Arquivo

files.delete_file

Remove arquivo

Como usar

Apaga um arquivo. Por padrão não dá erro se ele não existir.

Exemplo: Apague o arquivo temporário {arquivo_temp} ao final.

Campos

Campo	Tipo	Padrão	Detalhes
Arquivo *	Arquivo

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Ignorar se não existir	Sim/Não	`Sim`

Arquivo Existe

files.file_exists

Verifica se arquivo existe (retorna booleano)

Como usar

Verifica se o arquivo existe e guarda verdadeiro ou falso, para decidir com um Se.

Exemplo: Se o arquivo do dia não existir, envie um aviso e pare a execução.

Campos

Campo	Tipo	Padrão	Detalhes
Arquivo *	Arquivo
Salvar resultado na variável *	Variável de saída	`exists`

Resultado: guardado na variável exists (Booleano).

Criar Pasta

files.create_directory

Cria diretório (com subdirs se necessário)

Como usar

Cria uma pasta, junto com as pastas intermediárias que faltarem. Não dá erro se já existir.

Exemplo: Crie C:\Robos\saida\{ano}\{mes} antes de salvar os relatórios.

Campos

Campo	Tipo	Padrão	Detalhes
Pasta *	Pasta

Listar Arquivos

files.list_files

Lista arquivos de um diretório (com filtro por extensão)

Como usar

Lista os arquivos de uma pasta que casam com o padrão (como *.pdf ou NF_*.xml), com subpastas se marcado, e guarda a lista de caminhos.

Exemplo: Liste *.xlsx em C:\Robos\entrada em {arquivos} e processe cada um com Para Cada.

Campos

Campo	Tipo	Padrão
Pasta *	Pasta
Padrão	Texto	`.`
Incluir subpastas	Sim/Não	`Não`
Salvar resultado na variável *	Variável de saída	`files`

Resultado: guardado na variável files (Lista).

Obter Info do Arquivo

files.file_info

Retorna tamanho, data de criação, modificação

Como usar

Guarda informações do arquivo: tamanho, datas de criação e modificação, nome e extensão.

Exemplo: Se {file_info.size} for 0, trate o arquivo como vazio e pule.

Campos

Campo	Tipo	Padrão	Detalhes
Arquivo *	Arquivo
Salvar resultado na variável *	Variável de saída	`file_info`

Resultado: guardado na variável file_info (Dicionário).

Compactar Arquivos

files.zip_files

Cria arquivo ZIP

Como usar

Compacta arquivos e pastas num arquivo ZIP.

Exemplo: Compacte a pasta C:\Robos\saida\{data} em relatorios_{data}.zip para enviar por e-mail.

Campos

Campo	Tipo	Padrão	Detalhes
Arquivos ou pastas *	Lista
Arquivo ZIP *	Arquivo

Descompactar Arquivos

files.unzip_files

Extrai arquivo ZIP

Como usar

Extrai um ZIP para a pasta indicada e guarda a lista de arquivos extraídos.

Exemplo: Descompacte o anexo {zip_baixado} em C:\Robos\entrada e processe {extracted_files}.

Campos

Campo	Tipo	Padrão
Arquivo ZIP *	Arquivo
Extrair para *	Pasta
Salvar arquivos extraídos na variável *	Variável de saída	`extracted_files`

Resultado: guardado na variável extracted_files (Lista).

Ler CSV

files.read_csv

Lê CSV para lista de dicionários ou DataFrame

Como usar

Lê um CSV como tabela de dados (DataFrame) ou lista de dicionários. O padrão é ponto e vírgula, comum no Brasil; troque para vírgula se for o caso.

Exemplo: Leia extrato.csv com delimitador ; em {df} e filtre os lançamentos do dia.

Campos

Campo	Tipo	Padrão	Detalhes
Arquivo CSV *	Arquivo
Delimitador	Texto	`;`
Codificação	Opção	`utf-8`	Opções: utf-8, utf-8-sig, latin-1, cp1252
Retornar como DataFrame	Sim/Não	`Sim`
Salvar resultado na variável *	Variável de saída	`data`

Resultado: guardado na variável data (Qualquer).

Escrever CSV

files.write_csv

Escreve dados em formato CSV

Como usar

Grava uma lista ou tabela de dados (DataFrame) em CSV, com o delimitador e a codificação escolhidos.

Exemplo: Grave {df_saida} em retorno.csv com ; e utf-8 para o sistema contábil importar.

Campos

Campo	Tipo	Padrão	Detalhes
Dados (lista ou DataFrame) *	Variável	`data`
Arquivo CSV *	Arquivo
Delimitador	Texto	`;`
Codificação	Opção	`utf-8`	Opções: utf-8, utf-8-sig, latin-1, cp1252

Ler JSON

files.read_json

Lê e parseia arquivo JSON

Como usar

Lê um arquivo JSON e guarda como dicionário ou lista, para acessar campos como {data.cliente.nome}.

Exemplo: Leia config.json em {config} e use {config.pasta_saida}.

Campos

Campo	Tipo	Padrão	Detalhes
Arquivo JSON *	Arquivo
Salvar resultado na variável *	Variável de saída	`data`

Resultado: guardado na variável data (Dicionário).

Escrever JSON

files.write_json

Escreve dados como JSON

Como usar

Grava dados (dicionário ou lista) num arquivo JSON, com a indentação escolhida.

Exemplo: Grave {resultado} em C:\Robos\saida\resultado.json.

Campos

Campo	Tipo	Padrão
Dados *	Variável	`data`
Arquivo JSON *	Arquivo
Indentação	Número	`2`

Monitorar Pasta

files.watch_directory

Monitora pasta por alterações (criação, modificação)

Como usar

Espera um arquivo ser criado ou alterado numa pasta (que case com o padrão) e guarda o caminho dele. Útil para robôs que reagem à chegada de arquivos.

Exemplo: Aguarde até 600 s um *.xml novo em C:\Entrada\NFe e processe {file}.

Campos

Campo	Tipo	Padrão	Detalhes
Pasta *	Pasta
Padrão	Texto	`.`
Aguardar	Opção	`Arquivo novo`	Opções: Arquivo novo, Arquivo alterado, Qualquer alteração
Tempo limite	Número	`300 s`
Salvar caminho do arquivo na variável *	Variável de saída	`file`

Resultado: guardado na variável file (Caminho de arquivo).