table-stream 0.1.6__tar.gz → 0.1.7__tar.gz

{table_stream-0.1.6 → table_stream-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: table_stream
-Version: 0.1.6
+Version: 0.1.7
 Summary: Tipos de dados e implementações para o uso em tabelas.
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown

{table_stream-0.1.6 → table_stream-0.1.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "table_stream"
-version = "0.1.6"
+version = "0.1.7"
 description = "Tipos de dados e implementações para o uso em tabelas."
 readme = "README.md"
 requires-python = ">=3.12"

table_stream-0.1.7/table_stream/__init__.py

@@ -0,0 +1,50 @@
+from .hash_map import (
+    HashMap, hashMapName, HashMapDataFrame, HashMapDict, ArrayList, 
+    K, T, BaseObjetct
+)
+
+from .notifier import ResultNotifier, Notifier, Listener
+
+from .thread import (
+    ControllerThread, ThreadStateValue, exceptionValue, stateName,
+    EventState, InvalidStateTransition,
+)
+
+from .sheet import (
+    SheetLoader, InterfaceSheetLoad, ParserData, CsvOptions, SplitData,
+    csvEncoding, csvSeparator, OptionsIOSheet, SaveData,
+    FactorySaveData, FactorySheetLoader, SheetType,
+)
+
+from .sysfiles import (
+    File, Directory, ContentFiles, JsonConvert, JsonData,
+    EnumDocuments, ExtensionDocuments, UserFileSystem, PathElement,
+    create_table_from_file, load_file_hash, HeaderMetaData, create_void_table_files, 
+    hashFile
+)
+
+from .state import (
+    StateValue, EventState, ErrorState, FinshState, InvalidStateTransition
+)
+
+from .table import (
+    TableMap,
+    ColumnV,
+    RowH,
+    TableEmptyError,
+    EmptyRowError,
+    ColumnNotFoundError,
+    HeaderNotFoundError,
+    HeadersSizeNotIqualError,
+    concat_tables,
+    RowNotExistError,
+    TableData,
+    ListTablesEmptyError,
+)
+
+from .erros import (
+    ColumnNotFoudError, ColumnNotIqualSizeError,
+    SizeTableError, EmptyRowError, RowNotExistError, TableEmptyError,
+    ListTablesEmptyError, LoadWorkbookError, NotImplementedModuleError,
+    HeaderNotFoundError, HeadersSizeNotIqualError
+)

{table_stream-0.1.6 → table_stream-0.1.7}/table_stream/erros.py

@@ -19,17 +19,18 @@ class ValueNotifyNullError(CoreException):
 
     def __init__(self, message: str = 'Notificação nula...') -> None:
         super().__init__(message)
-        
-        
+
+
 class UnsuportedSheetError(CoreException):
 
     def __init__(self, message: str = 'Planilha inválida...') -> None:
         super().__init__(message)
-        
-        
-#============================================================#
+
+
+# ============================================================#
 # Erros relacionados a HashMap
-#============================================================#
+# ============================================================#
+
 class InvalidHashMapTableError(CoreException):
 
     def __init__(self, message: str = 'HashMap inválido') -> None:
@@ -48,9 +49,9 @@ class SizeTableError(InvalidHashMapTableError):
         super().__init__(message)
 
 
-#============================================================#
+# ============================================================#
 # Erros relacionados a planilhas
-#============================================================#
+# ============================================================#
 class UndefinedSheetIndex(CoreException):
 
     def __init__(self, message: str = 'SheetIndexNames não foi definido') -> None:
@@ -62,18 +63,18 @@ class LoadWorkbookError(CoreException):
     def __init__(self, message: str = 'Erro ao tentar ler Workbook') -> None:
         super().__init__(message)
 
-#============================================================#
+# ============================================================#
 # Erros relacionados a arquivos/bytes de imagem (.png, .jpg, ...)
-#============================================================#
+# ============================================================#
 class InvalidSourceImageError(CoreException):
 
     def __init__(self, message: str = 'Erro, use bytes de imagem') -> None:
         super().__init__(message)
 
 
-#============================================================#
+# ============================================================#
 # Erros relacionados a módulos
-#============================================================#
+# ============================================================#
 class NotImplementedModuleError(CoreException):
 
     def __init__(self, message: str = 'Erro, módulo não implementado') -> None:
@@ -97,6 +98,59 @@ class NotImplementedInvertColor(NotImplementedError):
     def __init__(self, message: str = 'Adaptador InvertColor não implementado...') -> None:
         super().__init__(message)
 
+# ============================================================#
+# Erros relacionados a tabelas
+# ============================================================#
+
+
+class ColumnNotFoudError(ValueError):
+    
+    def __init__(self, *args: object) -> None:
+        super().__init__(*args)
+
+class ColumnNotIqualSizeError(ValueError):
+
+    def __init__(self, *args: object) -> None:
+        super().__init__(*args)
+
+
+class EmptyRowError(Exception):
+
+    def __init__(self, *args: object) -> None:
+        super().__init__(*args)
+
+
+class TableEmptyError(Exception):
+
+    def __init__(self, *args: object) -> None:
+        super().__init__(*args)
+
+
+class HeaderNotFoundError(Exception):
+
+    def __init__(self, *args: object) -> None:
+        super().__init__(*args)
+
+
+class HeadersSizeNotIqualError(Exception):
+
+    def __init__(self, *args: object) -> None:
+        super().__init__(*args)
+
+
+class ListTablesEmptyError(ValueError):
+
+    def __init__(self, *args: object) -> None:
+        super().__init__(*args)
+
+
+class ColumnNotFoundError(ValueError):
+
+    def __init__(self, *args: object) -> None:
+        super().__init__(*args)
 
 
+class RowNotExistError(ValueError):
 
+    def __init__(self, *args: object) -> None:
+        super().__init__(*args)

{table_stream-0.1.6 → table_stream-0.1.7}/table_stream/hash_map.py

@@ -1,6 +1,9 @@
 from __future__ import annotations
-from abc import abstractmethod, ABCMeta
-from typing import Any, Callable, TypeVar, Union, Literal
+from abc import abstractmethod, ABC
+from typing import Any, Callable, TypeVar, Union, Literal, TypeAlias
+
+from table_stream.erros import ColumnNotIqualSizeError
+
 import json
 from pandas import DataFrame
 
@@ -10,49 +13,92 @@ K = TypeVar('K')
 hashMapName = Literal['DATAFRAME', 'DICT']
 
 
-class ArrayList[T](list):
+class BaseObjetct(object):
+    
+    def __init__(self) -> None:
+        pass
+
+    def __repr__(self) -> str:
+        return f"{__class__.__name__}()"
     
+    def hash(self) -> int:
+        return self.__hash__()
+
+
+class ArrayList[T](list):
+
     def __init__(self, items: list[T] | None = None):
         if items is None:
             items = list()
         super().__init__(items)
-        
+
+    def diff(self, values: ArrayList[T]) -> ArrayList[T]:
+        final = ArrayList[T]()
+
+        for v in values:
+            if not values.contains(v):
+                final.add(v)
+        return final
+
+    def append(self, item: T) -> None:
+        return super().append(item)
+
+    def add(self, v: T) -> None:
+        self.append(v)
+
     def set_items(self, items: list[T]):
         self.clear()
         super().__init__(items)
-        
+
     def for_each(self, func: Callable[[T], Any | None]) -> None:
         for x in self: func(x)
-    
+
     def apply_command(self, func: Callable[[T], Any]) -> ArrayList[Any]:
+        """
+            Retorna uma nova lista, cada elemento da nova lista será o retorno
+        da função func: Callable[[T], Any]
+        """
         return ArrayList([func(x) for x in self])
-    
+
     def size(self) -> int:
         return len(self)
-        
+
     def empty(self) -> bool:
         return self.size() == 0
-        
+
     def get_first(self) -> T:
         return self[0]
 
     def get_last(self) -> T:
         return self[-1]
-    
+
+    def get_element_at(self, idx: int) -> T:
+        return self[idx]
+
+    def replace(self, idx: int, new: T) -> None:
+        self[idx] = new
+
     def hash(self) -> int:
         return hash(tuple(self))
-    
+
     def contains(self, _o: T) -> bool:
         for i in self:
             if i == _o:
                 return True
         return False
-    
 
-#========================================================#
+    @classmethod
+    def from_string(cls, value: str, separator: str = " ") -> ArrayList[str]:
+        return cls(value.split(separator))
+
+
+# ========================================================#
 # Base para HashMap().
-#========================================================#
-class HashMap[K, T](metaclass=ABCMeta):
+# ========================================================#
+class HashMap[K, T](ABC):
+    
+    def __init__(self) -> None:
+        super().__init__()
     
     def __repr__(self) -> str:
         return f"<HashMap()> {self.header()}"
@@ -65,6 +111,9 @@ class HashMap[K, T](metaclass=ABCMeta):
     def size_header(self) -> int:
         pass
     
+    def is_empty(self) -> bool:
+        return self.header().empty()
+    
     @abstractmethod
     def __getitem__(self, key: K) -> T:
         pass
@@ -144,33 +193,42 @@ class HashMap[K, T](metaclass=ABCMeta):
             Converte o HashMap() para uma representação no formato dict() python.
         """
         pass
+    
+    @abstractmethod
+    def to_data_frame(self) -> DataFrame:
+        pass
 
     @classmethod
     def from_json(cls, data: str) -> HashMap:
-        pass
+        raise NotImplementedError()
 
     @classmethod
-    def from_map(cls, data: Any) -> HashMap:
-        pass
+    def from_map(cls, data: dict) -> HashMap:
+        raise NotImplementedError()
 
 
 class HashMapDict[K, T](HashMap):
-
+    
     def __init__(self, _mapping: dict[K, T] | None = None) -> None:
         super().__init__()
         if _mapping is None:
             _mapping = dict()
+            
         self._mapping: dict[K, T] = _mapping
 
     def __repr__(self) -> str:
         return f"<{__class__.__name__}()>\n{self.get_real_hash_map()}"
 
+    @property
+    def map(self) -> dict[K, T]:
+        return self.get_real_hash_map()
+
     def size_values(self) -> int:
         return len(self._mapping.values())
 
     def size_header(self) -> int:
         return self.header().size()
-
+    
     def __getitem__(self, key: K) -> T:
         return self._mapping[key]
 
@@ -229,14 +287,18 @@ class HashMapDict[K, T](HashMap):
         for i in self.header():
             final[str(i)] = str(self.get_value(i))
         return final
+    
+    def to_data_frame(self) -> DataFrame:
+        return DataFrame(dict(self._mapping))
 
 
 class HashMapDataFrame[K, Series](HashMap):
 
-    def __init__(self, df: DataFrame=None) -> None:
+    def __init__(self, df: DataFrame | None = None) -> None:
         super().__init__()
         if df is None:
             df = DataFrame()
+            
         self._df: DataFrame = df
 
     def size_values(self) -> int:
@@ -273,7 +335,7 @@ class HashMapDataFrame[K, Series](HashMap):
         return self._df[self.header().get_last()]
 
     def set_last(self, value: T) -> None:
-        raise NotImplementedError
+        self._df[self.header().get_last()] = value
 
     def set_value(self, key: K, value: Series) -> None:
         self._df[key] = value
@@ -304,4 +366,7 @@ class HashMapDataFrame[K, Series](HashMap):
         return self._df.astype(str).to_json(orient="columns", force_ascii=False, indent=4)
 
     def to_map_str(self) -> dict[str, Any]:
-        return self._df.astype('str').to_dict()
+        return self._df.astype(str).to_dict()
+    
+    def to_data_frame(self) -> DataFrame:
+        return self._df.copy()

table_stream-0.1.7/table_stream/notifier.py

@@ -0,0 +1,146 @@
+# notifier.py
+from __future__ import annotations
+from abc import ABC, abstractmethod, ABCMeta
+from typing import Any, Callable, Optional, Type, TypeVar, cast
+
+
+VALUE = TypeVar("VALUE")
+NOTIFIER = TypeVar('NOTIFIER', bound="Notifier")
+
+
+# ============================================================
+# CHANGE NOTIFIER
+# ============================================================
+class Notifier[VALUE]:
+
+    def __init__(self) -> None:
+        #super().__init__()
+        self._listeners: list[Callable[[], None]] = []
+        
+    def contains_listener(self, listener: Callable[[], None]) -> bool:
+        return listener in self._listeners
+
+    def add_listener(self, listener: Listener) -> None:
+        if listener not in self._listeners:
+            self._listeners.append(listener.receiver_notifier)
+
+    def remove_listener(self, listener: Callable[[], None]) -> None:
+        if listener in self._listeners:
+            self._listeners.remove(listener)
+
+    def notify_listeners(self) -> None:
+        for listener in self._listeners: #.copy():
+            listener()
+            
+
+class ResultNotifier[VALUE](Notifier):
+
+    def __init__(self, value: VALUE) -> None:
+        super().__init__()
+        self._result: VALUE = value
+        
+    def get_result(self) -> VALUE:
+        return self._result
+    
+    def set_result(self, v: VALUE) -> None:
+        self._result = v
+        self.notify_listeners()
+
+    @property
+    def result(self) -> VALUE:
+        return self._result
+
+    @result.setter
+    def result(self, value: VALUE) -> None:
+        self._result = value
+        self.notify_listeners()
+        
+        
+class ProgressOperation(ResultNotifier[float]):
+    
+    def __init__(self, value: float = 0.0) -> None:
+        super().__init__(value)
+        self.initial_value: int = 0
+        self.final_value: int = 0
+        self.running: bool = False
+        self.current_text: str = None
+        
+    def reset(self):
+        self.initial_value = 0
+        self.final_value = 0
+        self.running = False
+        self.current_text = None
+        
+    def add_progress(self) -> None:
+        if not self.running:
+            raise RuntimeError("A execução está parada -> running = False")
+        
+        self.initial_value += 1
+        self.calcule_percent()
+        
+    def calcule_percent(self):
+        if self.final_value <= 0:
+            raise ValueError()
+        if self.initial_value > self.final_value:
+            raise ValueError(f"{__class__.__name__} o Valor final é maior que o valor inicial")
+        
+        percent: float = round((self.initial_value / self.final_value) * 100, 2)
+        self.set_result(percent)
+        
+    def init_operation(self, total: int):
+        self.reset()
+        self.final_value = total 
+        self.running = True
+        
+        
+class Listener[NOTIFIER](ABC):
+    """
+        Consumer(): observa um ChangeNotifier registrado no Provider() e
+    permite que o Widget/Element associado seja notificado (via
+    receiver_notifier) sempre que o estado observado mudar.
+    """
+
+    def __init__(self) -> None:
+        super().__init__()
+        self.func_read_notifier: Callable[[type[NOTIFIER]], NOTIFIER] = self._read_notifier
+    
+        # Notifiers já observados por este Consumer (evita registrar o
+        # mesmo listener duas vezes a cada build(), e permite unwatch_all()).
+        self._watched: dict[type[NOTIFIER], NOTIFIER] = dict()
+        self.type_notifier: type[NOTIFIER] = None
+        
+    def _read_notifier(self, type_notifier: type[NOTIFIER]) -> NOTIFIER:
+        return self._watched[type_notifier]
+    
+    def read(self) -> NOTIFIER:
+        return self.func_read_notifier(self.type_notifier)
+
+    def watch(self, notifier: NOTIFIER) -> NOTIFIER:
+        self.type_notifier = type(notifier)
+        state: Notifier = cast(Notifier, notifier)
+        
+        if self.type_notifier not in self._watched:
+            state.add_listener(self)
+            self._watched[self.type_notifier] = notifier
+        return notifier
+
+    def unwatch_all(self) -> None:
+        """
+            Remove este Consumer de todos os notifiers observados.
+        Deve ser chamado no dispose() do Element associado, para evitar
+        que um notifier segure referência viva de um widget já destruído.
+        """
+        notifier: Notifier
+        for notifier in self._watched.values():
+            notifier.remove_listener(self.receiver_notifier)
+        self._watched.clear()
+
+    @abstractmethod
+    def receiver_notifier(self) -> None:
+        """
+            Callback chamado pelo ChangeNotifier observado. Subclasses
+        (ex: um ConsumerElement) devem sobrescrever isto para disparar
+        o rebuild do widget associado.
+        """
+        pass
+         

table_stream-0.1.7/table_stream/pattner/__init__.py

@@ -0,0 +1,3 @@
+from .adapter import (
+    IMPLEMENTATION, ADAPTATIVE, ObjectAdapter
+)

{table_stream-0.1.6 → table_stream-0.1.7}/table_stream/pattner/adapter.py

@@ -1,7 +1,6 @@
 from __future__ import annotations
-from abc import ABC, abstractmethod, ABCMeta
-from typing import Any, TypeVar
-from table_stream.hash_map import ArrayList
+from abc import abstractmethod, ABCMeta
+from typing import TypeVar
 
 
 ADAPTATIVE = TypeVar('ADAPTATIVE')