soup-files 1.0.1__py3-none-any.whl → 1.2.1__py3-none-any.whl

soup_files/__init__.py

@@ -1,3 +1,16 @@
 #!/usr/bin/env python3
 
-from .soup_files import *
+from .version import __version__
+from .progress import ProgressBarAdapter, ProgressBarSimple, ABCProgressBar
+from .files import (
+    File,
+    Directory,
+    JsonData,
+    JsonConvert,
+    InputFiles,
+    LibraryDocs,
+    UserFileSystem,
+    UserAppDir,
+    KERNEL_TYPE,
+)
+

soup_files/{soup_files.py → files.py}

@@ -13,12 +13,13 @@ import platform
 from pathlib import Path
 from hashlib import md5
 
-__version__ = '1.0'
 
 # Windows / Linux / ...
 KERNEL_TYPE = platform.system()
 
+
 class LibraryDocs(Enum):
+
     IMAGE = ['.png', '.jpg', '.jpeg', '.svg']
     PDF = ['.pdf']
     DOCUMENTS = ['.png', '.jpg', '.jpeg', '.svg', '.pdf']
@@ -40,11 +41,11 @@ class LibraryDocs(Enum):
 
 
 class File(object):
-    def __init__(self, filename:str):
+    def __init__(self, filename: str):
         if os.path.isdir(filename):
             raise ValueError(f'{__class__.__name__} File() não pode ser um diretório.')
-        self.filename:str = os.path.abspath(filename)
-        self.__path:Path = Path(self.filename)
+        self.filename: str = os.path.abspath(filename)
+        self.__path: Path = Path(self.filename)
 
     @property
     def path(self) -> Path:
@@ -94,7 +95,7 @@ class File(object):
         except:
             return False
 
-    def update_extension(self, e:str) -> File:
+    def update_extension(self, e: str) -> File:
         """
             Retorna uma instância de File() no mesmo diretório com a nova
         extensão informada.
@@ -113,7 +114,7 @@ class File(object):
     def write_string(self, s:str):
         self.__path.write_text(s)
 
-    def write_list(self, items:List[str]):
+    def write_list(self, items: List[str]):
         # Abrindo o arquivo em modo de escrita
         with open(self.filename, "w", encoding="utf-8") as file:
             for string in items:
@@ -162,8 +163,8 @@ class File(object):
 
 class Directory(object):
     def __init__(self, dirpath:str):
-        self.dirpath:str = os.path.abspath(dirpath)
-        self.path:Path = Path(self.dirpath)
+        self.dirpath: str = os.path.abspath(dirpath)
+        self.path: Path = Path(self.dirpath)
         
     def __eq__(self, value):
         if not isinstance(value, Directory):
@@ -175,8 +176,8 @@ class Directory(object):
         
     def iterpaths(self) -> List[Path]:
         return self.path.rglob('*')
-    
-    def content_files(self) -> List[File]:
+
+    def __content_recursive(self) -> List[File]:
         _paths = self.iterpaths()
         values = []
         for p in _paths:
@@ -187,6 +188,39 @@ class Directory(object):
                     )
                 )
         return values
+
+    def __content_no_recursive(self) -> List[File]:
+        files = os.listdir(self.absolute())
+        values: List[File] = []
+        for f in files:
+            if os.path.isfile(f):
+                values.append(
+                    File(os.path.abspath(f))
+                )
+        return values
+
+    def content_files(self, *, recursive: bool = True) -> List[File]:
+        if recursive:
+            return self.__content_recursive()
+        return self.__content_no_recursive()
+
+    def content_dirs(self, recursive: bool = True) -> List[Directory]:
+        values: List[Directory] = []
+        if recursive:
+            _paths = self.iterpaths()
+            for p in _paths:
+                if p.is_dir():
+                    values.append(
+                        Directory(os.path.abspath(p.absolute()))
+                    )
+        else:
+            _paths = os.listdir(self.absolute())
+            for d in _paths:
+                if os.path.isdir(d):
+                    values.append(
+                        Directory(os.path.abspath(d))
+                    )
+        return values
     
     def basename(self) -> str:
         return os.path.basename(self.absolute())
@@ -225,18 +259,18 @@ class InputFiles(object):
     """
         Obeter uma lista de arquivos/documentos do diretório informado.
     """
-    def __init__(self, d:Directory, *, maxFiles:int=5000):
+    def __init__(self, d: Directory, *, maxFiles: int = 5000):
         if not isinstance(d, Directory):
             raise ValueError(f'{__class__.__name__}\nUse: Directory(), não {type(d)}')
-        self.input_dir:Directory = d
-        self.maxFiles:int = maxFiles
+        self.input_dir: Directory = d
+        self.maxFiles: int = maxFiles
         
-    def get_files_with(self, *, infile:str, sort:bool=True) -> List[File]:
+    def get_files_with(self, *, infile: str, sort: bool = True) -> List[File]:
         """
             Retorna arquivos que contém a ocorrência (infile) no nome absoluto.
         """
-        content_files:List[File] = []
-        count:int = 0
+        content_files: List[File] = []
+        count: int = 0
         paths = self.input_dir.iterpaths()
         for file in paths:
             if not file.is_file():
@@ -250,24 +284,20 @@ class InputFiles(object):
                 break
         return content_files
 
-    def get_files(self, *, file_type:LibraryDocs = LibraryDocs.ALL_DOCUMENTS, sort:bool=True) -> List[File]:
-        """
-            Retorna uma lista de File() de acordo com o tipo de arquivo
-        especificado.
-        - LibraryDocs.ALL_DOCUMENTS => Retorna todos os documentos do diretório.
-        - LibraryDocs.EXCEL         => Retorna arquivos que são planilhas excel.
-        - ...
-        
-        """
-        _paths = self.input_dir.iterpaths()
+    def __get_files_recursive(self, *, file_type: LibraryDocs, sort: bool) -> List[File]:
+        #
+        #
+        _paths: List[Path] = self.input_dir.iterpaths()
         _all_files = []
-        count:int = 0
+        count: int = 0
         if file_type == LibraryDocs.ALL:
             # Todos os tipos de arquivos
             for p in _paths:
                 if not p.is_file():
                     continue
-                _all_files.append(File(p.absolute()))
+                _all_files.append(
+                    File(os.path.abspath(p.absolute()))
+                )
                 count += 1
                 if count >= self.maxFiles:
                     break
@@ -279,14 +309,67 @@ class InputFiles(object):
                 if (p.suffix is None) or (p.suffix == ''):
                     continue
                 if p.suffix in file_type.value:
-                    _all_files.append(File(p.absolute()))
+                    _all_files.append(
+                        File(os.path.abspath(p.absolute()))
+                    )
                     count += 1
                 if count >= self.maxFiles:
                     break
-        if sort == True:
+        if sort:
             _all_files.sort(key=File.absolute)
         return _all_files
 
+    def __get_files_no_recursive(self, *, file_type: LibraryDocs, sort: bool):
+        _paths: List[str] = os.listdir(self.input_dir.absolute())
+        _all_files = []
+        count: int = 0
+        if file_type == LibraryDocs.ALL:
+            # Todos os tipos de arquivos
+            for p in _paths:
+                if os.path.isfile(p):
+                    _all_files.append(
+                        File(os.path.abspath(p))
+                    )
+                    count += 1
+                    if count >= self.maxFiles:
+                        break
+        else:
+            # Arquivos especificados em LibraryDocs
+            for p in _paths:
+                if os.path.isfile(p):
+                    _path_file = Path(p)
+                    if (_path_file.suffix is None) or (_path_file.suffix == ''):
+                        continue
+                    if _path_file.suffix in file_type.value:
+                        _all_files.append(
+                            File(os.path.abspath(_path_file.absolute()))
+                        )
+                        count += 1
+                    if count >= self.maxFiles:
+                        break
+        if sort:
+            _all_files.sort(key=File.absolute)
+        return _all_files
+
+    def get_files(
+                self, *,
+                file_type: LibraryDocs = LibraryDocs.ALL_DOCUMENTS,
+                sort: bool = True,
+                recursive: bool = True
+            ) -> List[File]:
+        """
+            Retorna uma lista de File() de acordo com o tipo de arquivo
+        especificado.
+        - LibraryDocs.ALL_DOCUMENTS => Retorna todos os documentos do diretório.
+        - LibraryDocs.EXCEL         => Retorna arquivos que são planilhas excel.
+        - ...
+        
+        """
+        if recursive:
+            return self.__get_files_recursive(file_type=file_type, sort=sort)
+        else:
+            return self.__get_files_no_recursive(file_type=file_type, sort=sort)
+
 
 class JsonData(object):
     """
@@ -322,8 +405,8 @@ class JsonConvert(object):
     """
         Conversão de um dado JSON em dados python
     """
-    def __init__(self, jsonData:JsonData):
-        self.jsonData:JsonData = jsonData
+    def __init__(self, jsonData: JsonData):
+        self.jsonData: JsonData = jsonData
         
     def to_json_data(self) -> JsonData:
         return self.jsonData

soup_files/progress.py

@@ -0,0 +1,108 @@
+#!/usr/bin/env python3
+
+from abc import ABC, abstractmethod
+
+
+class ABCProgressBar(ABC):
+    """
+        Barra de progresso Abstrata
+    """
+
+    def __init__(self):
+        super().__init__()
+        self._num_progress: float = 0
+        self.pbar_real: object = None
+
+    @property
+    def num_progress(self) -> float:
+        return self._num_progress
+
+    @num_progress.setter
+    def num_progress(self, new: float):
+        if isinstance(new, float):
+            self._num_progress = new
+            return
+        try:
+            _prog = float(new)
+        except Exception as e:
+            print(e)
+        else:
+            self._num_progress = _prog
+
+    @abstractmethod
+    def set_percent(self, percent: float):
+        """Seta o progresso com float de porcentagem, ex: '42.8'"""
+        pass
+
+    @abstractmethod
+    def set_text(self, text: str):
+        """Seta um texto indicando a situação atual"""
+        pass
+
+    def start(self):
+        """Inicia a barra de progresso (pode ser vazio dependendo da implementação)"""
+        pass
+
+    def stop(self):
+        """Para a barra de progresso (pode ser vazio dependendo da implementação)"""
+        pass
+
+
+class ProgressBarSimple(ABCProgressBar):
+    """Barra de progresso simples para mostrar no terminal."""
+
+    def __init__(self, simple_pbar=None):
+        super().__init__()
+        self.pbar_real = simple_pbar
+        self._text: str = 'Aguarde!'
+        self.num_progress: float = 0
+
+    def set_percent(self, percent: float):
+        if not isinstance(percent, float):
+            return
+        if len(f'{percent}') > 4:
+            percent = round(float(percent), 2)
+        self.num_progress = percent
+        #print(f'[{self.num_progress}%] {self._text}', end='\r')
+
+    def set_text(self, text: str):
+        self._text = text
+        print(f'[{self.num_progress}%] {self._text}', end='\r')
+
+    def start(self):
+        pass
+
+    def stop(self):
+        pass
+
+
+class ProgressBarAdapter(object):
+    def __init__(self, progress_bar: ABCProgressBar = ProgressBarSimple()):
+        self.pbar_implement: ABCProgressBar = progress_bar
+
+    def get_current_percent(self) -> float:
+        return self.pbar_implement.num_progress
+
+    def update_text(self, text: str = "-"):
+        self.pbar_implement.set_text(text)
+
+    def update_percent(self, percent: float = 0):
+        if not isinstance(percent, float):
+            try:
+                percent = float(percent)
+            except Exception as e:
+                print(f'{__class__.__name__} {e}')
+                percent = 0
+        self.pbar_implement.set_percent(percent)
+
+    def update(self, percent: float, status: str = "-"):
+        self.update_percent(percent)
+        self.update_text(status)
+        #self.pbar_implement.set_text(status)
+
+    def start(self):
+        self.pbar_implement.start()
+
+    def stop(self):
+        self.pbar_implement.stop()
+

soup_files/version.py

@@ -0,0 +1,3 @@
+#!/usr/bin/env python3
+
+__version__ = '1.2.1'

soup_files-1.2.1.dist-info/METADATA

@@ -0,0 +1,10 @@
+Metadata-Version: 2.4
+Name: soup_files
+Version: 1.2.1
+Summary: soup_files
+Author: Bruno Chaves
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# soup_files
+

soup_files-1.2.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+soup_files/__init__.py,sha256=G91WhdwJvUJJLiIDL2XSGSqZNwLoJ7gfLfiYquUkNpk,299
+soup_files/files.py,sha256=QN29DUXrQtqS_wI_KawqUB0XCyjnzH4cgyolaXdkg04,15784
+soup_files/progress.py,sha256=kGPESPQCmoIlgJoy7Y8sF5ZG9tfx6uafXYrcBAPibfY,2903
+soup_files/version.py,sha256=TpmZmL9rNerchvGdpdGh4bPNo516cs6BzzXctjsbRq8,46
+soup_files-1.2.1.dist-info/METADATA,sha256=jqN1cgUQJGoi-kCfi2aU901x6o1af2lIwmr5vti9s54,174
+soup_files-1.2.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+soup_files-1.2.1.dist-info/top_level.txt,sha256=CBSaCdIqL_Rlkr74APmmI0kXkPK9pVf6HTlOPZ-Kk4E,11
+soup_files-1.2.1.dist-info/RECORD,,

{soup_files-1.0.1.dist-info → soup_files-1.2.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (79.0.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

soup_files-1.0.1.dist-info/METADATA

@@ -1,19 +0,0 @@
-Metadata-Version: 2.4
-Name: soup-files
-Version: 1.0.1
-Summary: Leitura e manipulação de arquivos
-Author: Bruno
-License: MIT
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-
-# file-utils
-
-# Uso
-from soup_files import File, Directory
-
-filename:str = 'path/to/file'
-dirpath:str = 'path/to/dir'
-
-f = File(filename)
-d = Directory(dirpath)

soup_files-1.0.1.dist-info/RECORD

@@ -1,6 +0,0 @@
-soup_files/__init__.py,sha256=O9oM7fGDdnzHAhpsxXSqO_SH2yMn2O_6t0n2EyyzOFY,49
-soup_files/soup_files.py,sha256=JhigMvXDorHa_2io-kJSTmX8Z2U7B8MoGV5NOj9mXds,12891
-soup_files-1.0.1.dist-info/METADATA,sha256=ixYhA3xag-tz-mIwO2cegFzOHaFZ08fKR2DN9EoSG-4,352
-soup_files-1.0.1.dist-info/WHEEL,sha256=pxyMxgL8-pra_rKaQ4drOZAegBVuX-G_4nRHjjgWbmo,91
-soup_files-1.0.1.dist-info/top_level.txt,sha256=CBSaCdIqL_Rlkr74APmmI0kXkPK9pVf6HTlOPZ-Kk4E,11
-soup_files-1.0.1.dist-info/RECORD,,