pyrisma 2__py3-none-any.whl

pyrisma/Colors.py

@@ -0,0 +1,162 @@
+from datetime import datetime
+class Colors:
+  def __init__(self) -> None:
+    self.colors = {
+      # Text colors (normal)
+      'black'             : "\033[30m",
+      'red'               : "\033[31m",
+      'green'             : "\033[32m",
+      'yellow'            : "\033[33m",
+      'blue'              : "\033[34m",
+      'magenta'           : "\033[35m",
+      'cyan'              : "\033[36m",
+      'white'             : "\033[37m",
+
+      # Bright text colors
+      'bright_black'      : "\033[90m",
+      'bright_red'        : "\033[91m",
+      'bright_green'      : "\033[92m",
+      'bright_yellow'     : "\033[93m",
+      'bright_blue'       : "\033[94m",
+      'bright_magenta'    : "\033[95m",
+      'bright_cyan'       : "\033[96m",
+      'bright_white'      : "\033[97m",
+
+      # Background colors (normal)
+      'bg_black'          : "\033[40m",
+      'bg_red'            : "\033[41m",
+      'bg_green'          : "\033[42m",
+      'bg_yellow'         : "\033[43m",
+      'bg_blue'           : "\033[44m",
+      'bg_magenta'        : "\033[45m",
+      'bg_cyan'           : "\033[46m",
+      'bg_white'          : "\033[47m",
+
+      # Bright backgrounds
+      'bg_bright_black'   : "\033[100m",
+      'bg_bright_red'     : "\033[101m",
+      'bg_bright_green'   : "\033[102m",
+      'bg_bright_yellow'  : "\033[103m",
+      'bg_bright_blue'    : "\033[104m",
+      'bg_bright_magenta' : "\033[105m",
+      'bg_bright_cyan'    : "\033[106m",
+      'bg_bright_white'   : "\033[107m",
+
+      # Styles
+      'bold'              : "\033[1m",
+      'italic'            : "\033[3m",
+      'underline'         : "\033[4m",
+      'double_underline'  : "\033[21m",
+      'blink'             : "\033[5m",
+      'reverse'           : "\033[7m",
+      'hidden'            : "\033[8m",
+      'strike'            : "\033[9m",
+
+      # Reset
+      'reset'             : "\033[0m",
+      'normal'            : "\033[2m"
+    }
+
+    self.icons = {
+      'void':              '',
+      'info':             f'{chr(10069)}{chr(160)}',
+      'error':            f'{chr(10060)}{chr(160)}',
+      'debug':            f'{chr(9935)}{chr(160)} ',
+      'success':          f'{chr(9989)}{chr(160)}',
+      'warning':          f'{chr(10071)}{chr(160)}',
+      'highlight':        f'{chr(10062)}{chr(160)}',
+    }
+
+  # Métodos utilitários
+  def color(self, name: str) -> str:
+    return self.colors.get(name, self.colors['reset'])
+  
+  def icon(self, name: str) -> str:
+    return self.icons.get(name, '')
+
+  def reset(self) -> str:
+    return self.colors['reset']
+
+ # Sucesso
+  def success(self, msg: str = None, **kwargs) -> None:
+    style: str = 'normal'
+    icon: bool = 'void'
+    time_clock: bool = False
+    
+    icon = kwargs.get('icon', icon)
+    style = kwargs.get('style', style)
+
+    _clock: datetime = f'[{datetime.now().strftime("%Y-%m-%d %H:%M:%S")}] ' if kwargs.get('time_clock') == True else ''
+
+    print(f"{_clock}{self.icons[icon]}{self.colors['bright_green']}{self.colors[style]}{msg}{self.reset()}")
+    return None
+  
+  # Erro
+  def error(self, msg: str = None, **kwargs) -> None:
+    style: str = 'normal'
+    icon: bool = 'void'
+    time_clock: bool = False
+    
+    icon = kwargs.get('icon', icon)
+    style = kwargs.get('style', style)
+
+    _clock: datetime = f'[{datetime.now().strftime("%Y-%m-%d %H:%M:%S")}] ' if kwargs.get('time_clock') == True else ''
+
+    print(f"{_clock}{self.icons[icon]}{self.colors['bright_red']}{self.colors[style]}{msg}{self.reset()}")
+    return None
+
+  # Aviso
+  def warning(self, msg: str = None, **kwargs) -> None:
+    style: str = 'normal'
+    icon: bool = 'void'
+    time_clock: bool = False
+    
+    icon = kwargs.get('icon', icon)
+    style = kwargs.get('style', style)
+
+    _clock: datetime = f'[{datetime.now().strftime("%Y-%m-%d %H:%M:%S")}] ' if kwargs.get('time_clock') == True else ''
+
+    print(f"{_clock}{self.icons[icon]}{self.colors['bright_yellow']}{self.colors[style]}{msg}{self.reset()}")
+    return None
+
+  # Informação
+  def info(self, msg: str, **kwargs) -> None:
+    style: str = 'normal'
+    icon: bool = 'void'
+    time_clock: bool = False
+    
+    icon = kwargs.get('icon', icon)
+    style = kwargs.get('style', style)
+
+    _clock: datetime = f'[{datetime.now().strftime("%Y-%m-%d %H:%M:%S")}] ' if kwargs.get('time_clock') == True else ''
+
+    print(f"{_clock}{self.icons[icon]}{self.colors['blue']}{self.colors[style]}{msg}{self.reset()}")
+    return None
+
+  # Debug
+  def debug(self, msg: str, **kwargs) -> None:
+    style: str = 'normal'
+    icon: bool = 'void'
+    time_clock: bool = False
+    
+    icon = kwargs.get('icon', icon)
+    style = kwargs.get('style', style)
+
+    _clock: datetime = f'[{datetime.now().strftime("%Y-%m-%d %H:%M:%S")}] ' if kwargs.get('time_clock') == True else ''
+
+    print(f"{_clock}{self.icons[icon]}{self.colors['bright_magenta']}{self.colors[style]}{msg}{self.reset()}")
+    return None
+
+  # Importante / Destaque
+  def highlight(self, msg: str, **kwargs) -> None:
+    style: str = 'normal'
+    icon: bool = 'void'
+    time_clock: bool = False
+    
+    icon = kwargs.get('icon', icon)
+    style = kwargs.get('style', style)
+
+    _clock: datetime = f'[{datetime.now().strftime("%Y-%m-%d %H:%M:%S")}] ' if kwargs.get('time_clock') == True else ''
+
+    print(f"{_clock}{self.icons[icon]}{self.colors['bright_white']}{self.colors[style]}{msg}{self.reset()}")
+    return None

pyrisma/__init__.py

@@ -0,0 +1,5 @@
+from .Colors import Colors
+
+__all__ = ["Colors"]
+
+terminal = Colors()

pyrisma-2.dist-info/METADATA

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: pyrisma
+Version: 2
+Summary: Uma biblioteca para deixar mensagens coloridas e estilosas no terminal.
+Author: Marley
+Author-email: Marley Benicio <marleysbenicio@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/MarleyBenicio/pyrisma
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# 💬 Pyrisma
+
+Uma biblioteca Python para exibir mensagens coloridas e estilizadas no terminal, com ícones, estilos de texto e timestamp opcional.
+
+Ideal para quem quer logs mais visuais, legíveis e com um toque de personalidade.
+
+---
+
+## 🚀 Instalação
+
+```bash
+pip install pyrisma
+```
+
+Requer Python >= 3.9. Sem dependências externas.
+
+---
+
+## 🧠 Uso básico
+
+```python
+from pyrisma import terminal
+
+terminal.info("Sistema iniciado com sucesso!")
+terminal.warning("Atenção: configuração ausente.")
+terminal.error("Erro crítico detectado!")
+terminal.success("Processo concluído com êxito.")
+terminal.debug("Valor da variável x: 42")
+terminal.highlight("Isso merece destaque!")
+```
+
+O objeto `terminal` já vem pronto para uso (é uma instância de `Colors`), mas você também pode instanciar a classe diretamente:
+
+```python
+from pyrisma import Colors
+
+terminal = Colors()
+```
+
+---
+
+## ⚙️ Métodos disponíveis
+
+Todos os métodos de log têm a mesma assinatura:
+
+```python
+terminal.<metodo>(msg: str, **kwargs)
+```
+
+| Método        | Cor aplicada      |
+|---------------|-------------------|
+| `success`     | verde brilhante   |
+| `error`       | vermelho brilhante|
+| `warning`     | amarelo brilhante |
+| `info`        | azul              |
+| `debug`       | magenta brilhante |
+| `highlight`   | branco brilhante  |
+
+### Parâmetros opcionais (`**kwargs`)
+
+| Parâmetro     | Tipo   | Padrão   | Descrição                                                                 |
+|---------------|--------|----------|----------------------------------------------------------------------------|
+| `style`       | `str`  | `'normal'` | Nome do estilo de texto a aplicar (ver tabela de estilos abaixo).       |
+| `icon`        | `str`  | `'void'`   | Nome do ícone a exibir antes da mensagem (ver tabela de ícones abaixo). |
+| `time_clock`  | `bool` | `False`    | Se `True`, adiciona um timestamp `[YYYY-MM-DD HH:MM:SS]` antes da mensagem. |
+
+Exemplo usando todos os parâmetros:
+
+```python
+terminal.success(
+    "Backup concluído",
+    style="bold",
+    icon="success",
+    time_clock=True,
+)
+# [2026-09-11 10:30:00] ✅ Backup concluído
+```
+
+---
+
+## 🎨 Estilos disponíveis (`style`)
+
+```
+normal, bold, italic, underline, double_underline,
+blink, reverse, hidden, strike, reset
+```
+
+## 🔣 Ícones disponíveis (`icon`)
+
+```
+void, info, error, debug, success, warning, highlight
+```
+
+---
+
+## 🧰 Métodos utilitários
+
+Além dos métodos de log, a classe `Colors` expõe utilitários para montar suas próprias mensagens formatadas:
+
+```python
+from pyrisma import Colors
+
+c = Colors()
+
+c.color("red")      # retorna o código ANSI da cor "red"
+c.icon("warning")    # retorna o ícone associado a "warning"
+c.reset()            # retorna o código ANSI de reset ("\033[0m")
+```
+
+Cores de texto disponíveis em `color()`:
+
+```
+black, red, green, yellow, blue, magenta, cyan, white,
+bright_black, bright_red, bright_green, bright_yellow,
+bright_blue, bright_magenta, bright_cyan, bright_white,
+bg_black, bg_red, bg_green, bg_yellow, bg_blue, bg_magenta,
+bg_cyan, bg_white, bg_bright_black, bg_bright_red,
+bg_bright_green, bg_bright_yellow, bg_bright_blue,
+bg_bright_magenta, bg_bright_cyan, bg_bright_white
+```
+
+---
+
+## ⚙️ Funcionalidades
+
+- Mensagens com cores e ícones contextuais.
+- Suporte a diferentes níveis de log (`success`, `error`, `warning`, `info`, `debug`, `highlight`).
+- Estilos de texto (negrito, itálico, sublinhado, etc).
+- Timestamp opcional em cada mensagem.
+- Acesso direto a cores e ícones para composições personalizadas.
+- Sem dependências externas.
+
+---
+
+## 📄 Licença
+
+Distribuído sob a licença MIT. Veja o arquivo [LICENSE](LICENSE) para mais informações.
+
+---
+
+## 👤 Autor
+
+**Marley Benicio**
+Desenvolvedor de Software
+
+📧 marleysbenicio@gmail.com
+🔗 [GitHub](https://github.com/MarleyBenicio/pyrisma)

pyrisma-2.dist-info/RECORD

@@ -0,0 +1,7 @@
+pyrisma/Colors.py,sha256=SLNYsHqpNxDoyDTDWmm8sKBE_Kk7DY5DEOqGD5Owep0,5386
+pyrisma/__init__.py,sha256=ZUbebDYKs77jFezutNpibtULPPylSLZLc--d7-bLcG0,69
+pyrisma-2.dist-info/licenses/LICENSE,sha256=dhp3IdrOnCI8ah90zPQHS3AoD57ko0jk4InuvRkk-0g,1119
+pyrisma-2.dist-info/METADATA,sha256=K27UP107jCRCIG_cuv4__MeiLhgAi6zntz8N6-C_zjE,4267
+pyrisma-2.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+pyrisma-2.dist-info/top_level.txt,sha256=aNMtiLFuIw2Um3g9epGU1PqC5AREnzEHulaktEfNcPE,8
+pyrisma-2.dist-info/RECORD,,

pyrisma-2.dist-info/WHEEL

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

pyrisma-2.dist-info/licenses/LICENSE

@@ -0,0 +1,27 @@
+
+---
+
+## 📜 `LICENSE` (Licença MIT)
+
+```text
+MIT License
+
+Copyright (c) 2025 Marley
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the “Software”), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyrisma-2.dist-info/top_level.txt

@@ -0,0 +1 @@
+pyrisma