libpyles 1.0.9
Pacote para mnipulação de arquivos
Keywords: python,files,Pyl3s,Pyl3sLib, libpyles


# 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:
<pre><code>pip install libpyles</code></pre>

## Funções da biblioteca

=======================================================

### def criar_arquivo_txt(nome)<br>
### def abrir_arquivo_txt(nome)<br>
### def escrever_arquivo_txt(nome)<br>
### def criar_arquivo_bin(nome)<br>
### def abrir_arquivo_bin(nome)<br>
### def escrever_arquivo_bin(nome)<br>
### def listar_diretorio(diretorio, extensao)<br>
### def diretorio_atual()<br>
### def criar_diretorio(nome_dir)<br>
### def copiar_diretorio_completo(src, dst)<br>
### def mover_diretorio_completo(src, dst)<br>
### def deletar_arquivo(nome_arquivo)<br>
### def deletar_diretorio(nome_diretorio)<br>
### def tamanho_diretorio_kb(caminho)<br>
### def tamanho_arquivo_kb(caminho, nome_arq)<br>
### def palavra_chave(arquivo, palavra)<br>
### def contar_palavras_mais_frequentes(nome_arquivo)<br>
### def contar_caracteres(arquivo)<br>
### def txt_pdf(arquivo, nome_arquivo)<br>
### def pdf_to_txt(arquivo, arquivo_txt)<br>
### def txt_bin(arquivo, nome_arquivo_bin)<br>
### def bin_to_txt(nome_arquivo_bin, nome_arquivo_txt)<br>

=======================================================

## Importação

<pre><code>import libpyles</code></pre>

=======================================================

## Uso de cada função

=======================================================

>Será utilizado uma abreviação para fácil entendimento. Nesse sentido, será utilizado o __lp__ (import libpyles as lp).

<pre><code>

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')
"""

</code></pre>