libpyles 1.0.9

Pacote para mnipulação de arquivos

libpyles

========================================================

Atraves desse pacote, o usuário poderá fazer a manipulação de arquivos de maneira mais simples e otimizada, além de poder criar, mover, excluir e copiar diretórios. E mais algumas funções extras de conversão de arquivos de texto.

Instalação

Para instalar o pacote, basta executar o comando abaixo:

pip install libpyles

Funções da biblioteca

=======================================================

def criar_arquivo_txt(nome)

def abrir_arquivo_txt(nome)

def escrever_arquivo_txt(nome)

def criar_arquivo_bin(nome)

def abrir_arquivo_bin(nome)

def escrever_arquivo_bin(nome)

def listar_diretorio(diretorio, extensao)

def diretorio_atual()

def criar_diretorio(nome_dir)

def copiar_diretorio_completo(src, dst)

def mover_diretorio_completo(src, dst)

def deletar_arquivo(nome_arquivo)

def deletar_diretorio(nome_diretorio)

def tamanho_diretorio_kb(caminho)

def tamanho_arquivo_kb(caminho, nome_arq)

def palavra_chave(arquivo, palavra)

def contar_palavras_mais_frequentes(nome_arquivo)

def contar_caracteres(arquivo)

def txt_pdf(arquivo, nome_arquivo)

def pdf_to_txt(arquivo, arquivo_txt)

def txt_bin(arquivo, nome_arquivo_bin)

def bin_to_txt(nome_arquivo_bin, nome_arquivo_txt)

=======================================================

Importação

import libpyles

=======================================================

Uso de cada função

=======================================================

Será utilizado uma abreviação para fácil entendimento. Nesse sentido, será utilizado o lp (import libpyles as lp).

lp.criar_arquivo_txt(nome) 



""" 

    A variável 'nome' é apenas o nome do arquivo sem a extensão(.txt) e entre aspas simples, por exemplo 'teste'. 

    Saída: É criado um arquivo .txt se ele não existir no diretório atual, caso contrário, ela apenas lê e exibe o arquivo .txt. Além disso é retornado True ou False para ser utilizado dependendo da ocasião do uso. 

    Exemplo:

        if lp.criar_arquivo_txt('teste') is True:

            print('Arquivo criado!!')

        else:

            print('Arquivo já existente!!')

"""



lp.abrir_arquivo_txt(nome)



"""

    A variável 'nome' é apenas o nome do arquivo sem a extensão(.txt) e entre aspas simples, por exemplo 'teste'.

    Saída: Abrir um arquivo .txt, se ele existir no diretório. Além disso é retornado True ou False para ser utilizado dependendo da ocasião do uso.

    Exemplo:

        if lp.abrir_arquivo_txt('teste') is True:

            print('Arquivo lido!!')

        else:

            print('Arquivo não existe!!')

"""



lp.escrever_arquivo_txt(nome)



"""

    A variável 'nome' é apenas o nome do arquivo sem a extensão(.txt) e entre aspas simples, por exemplo 'teste'.

    Saída: Escrever em um arquivo .txt, se ele existir. Além disso é retornado True ou False para ser utilizado dependendo da ocasião do uso.

    Exemplo:

        if lp.escrever_arquivo_txt('teste') is True:

            print('Arquivo modificado!!')

        else:

            print('Arquivo não existe!!')

"""

lp.criar_arquivo_bin(nome) 



""" 

    A variável 'nome' é apenas o nome do arquivo sem a extensão(.bin) e entre aspas simples, por exemplo 'teste'. 

    Saída: É criado um arquivo .bin se ele não existir no diretório atual, caso contrário, ela apenas lê e exibe o arquivo .bin. Além disso é retornado True ou False para ser utilizado dependendo da ocasião do uso. 

    Exemplo:

        if lp.criar_arquivo_bin('teste') is True:

            print('Arquivo criado!!')

        else:

            print('Arquivo já existente!!')

"""



lp.abrir_arquivo_bin(nome)



"""

    A variável 'nome' é apenas o nome do arquivo sem a extensão(.bin) e entre aspas simples, por exemplo 'teste'.

    Saída: Abrir um arquivo .bin, se ele existir no diretório. Além disso é retornado True ou False para ser utilizado dependendo da ocasião do uso.

    Exemplo:

        if lp.abrir_arquivo_bin('teste') is True:

            print('Arquivo lido!!')

        else:

            print('Arquivo não existe!!')

"""



lp.escrever_arquivo_bin(nome)



"""

    A variável 'nome' é apenas o nome do arquivo sem a extensão(.bin) e entre aspas simples, por exemplo 'teste'.

    Saída: Escrever em um arquivo .bin, se ele existir. Além disso é retornado True ou False para ser utilizado dependendo da ocasião do uso.

    Exemplo:

        if lp.escrever_arquivo_bin('teste') is True:

            print('Arquivo modificado!!')

        else:

            print('Arquivo não existe!!')

"""



lp.listar_diretorio(diretorio, extensao)



"""

    diretorio == r'seu caminho do diretorio'

    extensao == '' (caso queira exibir todos os arquivos)

                '.extensao' (caso queira filtrar por extensão, apenas colocar a extensão do arquivo)

    Saída: Lista o caminho de todos os subdiretórios e arquivos existentes em um diretório passado no parâmetro

    Exemplo:

        lp.listar_diretorio(r'C:\Users\nyddo\OneDrive\Área de Trabalho\Faculdade\POOII\libpyles', '')



        '

            C:\Users\nyddo\OneDrive\Área de Trabalho\Faculdade\POOII\libpyles\build\README.md

            C:\Users\nyddo\OneDrive\Área de Trabalho\Faculdade\POOII\libpyles\dist\README.md

            C:\Users\nyddo\OneDrive\Área de Trabalho\Faculdade\POOII\libpyles\libpyles\README.md

            C:\Users\nyddo\OneDrive\Área de Trabalho\Faculdade\POOII\libpyles\libpyles.egg-info\README.md

            C:\Users\nyddo\OneDrive\Área de Trabalho\Faculdade\POOII\libpyles\build\setup.py

            C:\Users\nyddo\OneDrive\Área de Trabalho\Faculdade\POOII\libpyles\dist\setup.py

            C:\Users\nyddo\OneDrive\Área de Trabalho\Faculdade\POOII\libpyles\libpyles\setup.py

            C:\Users\nyddo\OneDrive\Área de Trabalho\Faculdade\POOII\libpyles\libpyles.egg-info\setup.py

            C:\Users\nyddo\OneDrive\Área de Trabalho\Faculdade\POOII\libpyles\build\teste.py

            C:\Users\nyddo\OneDrive\Área de Trabalho\Faculdade\POOII\libpyles\dist\teste.py

            C:\Users\nyddo\OneDrive\Área de Trabalho\Faculdade\POOII\libpyles\libpyles\teste.py

            C:\Users\nyddo\OneDrive\Área de Trabalho\Faculdade\POOII\libpyles\libpyles.egg-info\teste.py

            C:\Users\nyddo\OneDrive\Área de Trabalho\Faculdade\POOII\libpyles\libpyles\__pycache__\libpyles.py

            C:\Users\nyddo\OneDrive\Área de Trabalho\Faculdade\POOII\libpyles\libpyles\__pycache__\__init__.py

        '

"""



lp.diretorio_atual()



"""



    Saída: Lista o caminho do diretório atual.

    Exemplo:

        print(lp.diretorio_atual())

        '

            C:\Users\nyddo\OneDrive\Área de Trabalho\Faculdade\POOII\libpyles

        '



"""



lp.criar_diretorio(nome_dir)



"""



    nome_dir == 'nome do diretorio que queira criar'

    A função cria um novo diretório no diretório atual que se encontra o código.

    Saída: Cria um novo diretório no diretório atual que se encontra o código.

    Exemplo:

        lp.criar_diretorio('teste')



"""



lp.copiar_diretorio_completo(src, dst)



"""

    src == 'diretório que queira copiar os arquivos'

    dst == 'diretório que queira colar os arquivos'

    Saída: Copia todo o conteúdo (arquivos) de um diretório de origem para um diretório de destino. Além disso é retornado True ou False para ser utilizado dependendo da ocasião do uso.

    Exemplo:

        if lp.copiar_diretorio_completo(r'C:\Users\nyddo\OneDrive\Área de Trabalho\Faculdade\POOII\libpyles', r'C:\Users\nyddo\OneDrive\Área de Trabalho\Faculdade\POOII\teste') is True:

            print('Diretório copiado!!')

        else:

            print('Diretório não existe!!')

"""



lp.mover_diretorio_completo(src, dst)



"""

    src == 'diretório que queira mover os arquivos'

    dst == 'diretório que queira colar os arquivos'

    Saída: Move todo o conteúdo (arquivos) de um diretório de origem para um diretório de destino. Além disso é retornado True ou False para ser utilizado dependendo da ocasião do uso.

    Exemplo:

        if lp.mover_diretorio_completo(r'C:\Users\nyddo\OneDrive\Área de Trabalho\Faculdade\POOII\libpyles', r'C:\Users\nyddo\OneDrive\Área de Trabalho\Faculdade\POOII\teste') is True:

            print('Diretório movido!!')

        else:

            print('Diretório não existe!!')

"""



lp.deletar_arquivo(nome_arquivo)



"""

    nome_arquivo == 'nome do arquivo que queira excluir no diretório atual'

    Saída: True se o arquivo for removido com sucesso, False se o arquivo não for encontrado ou ocorrer um erro durante a remoção.

    Exemplo:

        if lp.deletar_arquivo('teste') is True:

            print('Arquivo deletado com sucesso')

        else:

            print('Arquivo não encontrado')



"""



lp.deletar_diretorio(nome_diretorio)



"""

    nome_diretorio == 'nome do diretorio que queira excluir no diretório atual ou outro diretório'

    Saída: True se o diretório for removido com sucesso, False se o diretório não for encontrado ou ocorrer um erro durante a remoção.

    Exemplo:

        if lp.deletar_diretorio('teste') is True ou lp.deletar_diretorio(r'C:\Users\nyddo\OneDrive\Área de Trabalho\Faculdade\POOII\libpyles') is True:

            print('Arquivo deletado com sucesso')

        else:

            print('Arquivo não encontrado')



"""



lp.tamanho_diretorio_kb(caminho)



"""

    caminho == 'caminho do diretorio que queira saber o tamanho em kb, a quantidade de subdiretórios e arquivos'

    Saída: Tamanho total (em kilobytes) de um diretório, incluindo todos os seus arquivos e subdiretórios.

    Exemplo:

        total_size_kb, total_arq, total_dir = tamanho_diretorio_kb(diretorio_atual())

        print(f"Total: {total_size_kb} KB")

        print(f"Arq: {total_arq}")

        print(f"Dir: {total_dir}")



        '

            Total: 79.0101306674951 KB

            Arq: 45

            Dir: 14

        '

"""



lp.tamanho_arquivo_kb(caminho, nome_arq)



"""

    caminho == 'caminho do diretorio'

    nome_arq == 'nome do arquivo que queira saber o tamanho'

    Saída: Tamanho de um arquivo em kilobytes

    Exemplo:

        print(lp.tamanho_arquivo_kb(diretorio_atual(), 'teste'))

        '

            0.3916015625

        '

"""



lp.palavra_chave(arquivo, palavra)



"""

    arquivo == 'arquivo que queira encontrar a palavra'

    palavra == 'palavra-chave que queira buscar no arquivo .txt'

    Saída: Uma tupla contendo duas informações:

            - Uma lista de tuplas, onde cada tupla contém o número da linha e o conteúdo da linha onde a palavra-chave foi encontrada.

            - O número total de ocorrências da palavra-chave no arquivo.

    Exemplo:

        print(lp.palavra_chave('teste.txt', 'teste'))

        '

            ([(1, 'teste'), (2, 'teste'), (3, 'teste'), (4, 'teste'), (5, 'teste'), (6, 'teste'), (7, 'teste'), (8, 'teste'), (9, 'teste'), (10, 'teste'), (11, 'teste'), (12, 'teste'), (13, 'teste'), (14, 'teste'), (15, 'teste'), (16, 'teste'), (17, 'teste'), (18, 'teste'), (19, 'teste'), (20, 'testeteste'), (21, 'teste'), (22, 'teste'), (23, 'teste'), (24, 'teste'), (25, 'teste'), (26, 'teste'), (27, 'teste'), (28, 'teste'), (29, 'testeteste'), (30, 'teste'), (31, 'teste'), (32, 'teste'), (33, 'teste'), (34, 'teste'), (35, 'teste'), (36, 'teste'), (37, 'teste'), (38, 'testeteste'), (39, 'teste'), (40, 'teste'), (41, 'teste'), (42, 'teste'), (43, 'teste'), (44, 'teste'), (45, 'teste'), (46, 'teste'), (47, 'testeteste'), (48, 'teste'), (49, 'teste'), (50, 'teste'), (51, 'teste'), (52, 'teste'), (53, 'teste'), (54, 'teste'), (55, 'teste'), (56, 'teste')], 56)

        '



"""



lp.contar_palavras_mais_frequentes(nome_arquivo)



"""

    nome_arquivo == 'arquivo que queira encontrar as palavras mais frequentes'

    Saída: Uma lista contendo tuplas representando as 10 palavras mais frequentes no arquivo, juntamente com suas contagens.

    Exemplo:

        palavras_mais_frequentes = contar_palavras_mais_frequentes('teste.txt')

        print("As 10 palavras mais frequentes:")

        for palavra, frequencia in palavras_mais_frequentes:

        print(f"{palavra}: {frequencia}")

        '

            tricolor: 7

            amado: 7

            clube: 7

            és: 6

            oh: 6

            bem: 6

            as: 6

            tuas: 6

            glórias: 6

            vêm: 6

        '

"""



lp.contar_caracteres(arquivo)



"""

    arquivo == 'arquivo que queira contar os caracteres'

    Saída: O número total de caracteres no arquivo.

    Exemplo:

        print(lp.contar_caracteres('teste.txt'))

        '

            355

    	'



"""



lp.txt_pdf(arquivo, nome_arquivo)



"""

    arquivo == 'arquivo .txt que queira converter em pdf'

    nome_arquivo == 'nome do arquivo de saida'

    Saída: Cria um arquivo PDF a partir do arquivo de texto fornecido.

    Exemplo:

        lp.txt_pdf('teste.txt', 'testepdf')



"""



lp.pdf_to_txt(arquivo, arquivo_txt)



"""

    arquivo == 'arquivo .pdf que queira converter em txt'

    arquivo_txt == 'nome do arquivo de saida'

    Saída: Cria um arquivo de texto contendo o texto extraído do arquivo PDF

    Exemplo:

        lp.pdf_to_txt('teste.pdf', 'testetxt')

"""



lp.txt_bin(arquivo, nome_arquivo_bin)



"""

    arquivo == 'arquivo .txt que queira converter em bin'

    nome_arquivo_bin == 'nome do arquivo de saida'

    Saída: True se o arquivo de texto existe e a conversão foi bem-sucedida, False caso contrário.

    Exemplo: 

        if lp.txt_bin('teste.txt', 'teste') is True:

            print('Arquivo transformado')

        else:

            print('Algo deu errado')

"""



lp.bin_to_txt(nome_arquivo_bin, nome_arquivo_txt)



"""

    nome_arquivo_bin == 'arquivo .bin que queira converter em txt'

    nome_arquivo_txt == 'nome do arquivo de saida'

    Saída: True se o arquivo binário existe e a conversão foi bem-sucedida, False caso contrário.

    Exemplo:

        if lp.bin_to_txt('teste.bin', 'teste') is True:

            print('Arquivo transformado')

        else:

            print('Algo deu errado')

"""