nvlogger 0.1.0__py3-none-any.whl

nvlogger/__init__.py

@@ -0,0 +1,43 @@
+"""
+nvlogger - Logging bonito e zero configuração para Python.
+
+A modern, minimalist logging library that makes terminal output
+beautiful using the rich library.
+
+Example:
+    >>> from nvlogger import setup, log, success, info, warning, error, debug
+    >>> setup()
+    >>> log("Normal message")
+    >>> success("Operation completed!")
+    >>> info("Starting download...")
+    >>> warning("Large file detected")
+    >>> error("Connection failed", exc_info=True)
+    >>> debug("Debug info")
+    >>>
+    >>> # Using sections
+    >>> with log.section("Processing"):
+    ...     log("Working...")
+    ...     success("Done!")
+"""
+
+from __future__ import annotations
+
+from .__version__ import __version__
+from .setup import setup
+from .core import log, success, info, warning, error, debug
+from .context import section
+
+# Attach section method to log function for log.section() syntax
+log.section = section  # type: ignore[attr-defined]
+
+__all__ = [
+    "__version__",
+    "setup",
+    "log",
+    "success",
+    "info",
+    "warning",
+    "error",
+    "debug",
+    "section",
+]

nvlogger/__version__.py

@@ -0,0 +1,3 @@
+"""nvlogger version information."""
+
+__version__ = "0.1.0"

nvlogger/context.py

@@ -0,0 +1,52 @@
+"""
+nvlogger context manager module.
+
+Provides the Section context manager for grouping log messages.
+"""
+
+from __future__ import annotations
+
+from contextlib import contextmanager
+from typing import Generator
+
+from rich.panel import Panel
+
+from .setup import get_console
+
+
+@contextmanager
+def section(title: str) -> Generator[None, None, None]:
+    """
+    Context manager for creating a visual section in logs.
+    
+    Creates a panel-like section with a title, visually grouping
+    all log messages within the context.
+    
+    Args:
+        title: The title of the section.
+    
+    Yields:
+        None
+    
+    Example:
+        >>> from nvlogger import log, success
+        >>> with log.section("Processing"):
+        ...     log("Loading data...")
+        ...     success("Done!")
+    """
+    console = get_console()
+    
+    # Print section header
+    console.print()
+    console.print(
+        f"[bold cyan]┌─[/bold cyan] [bold white]{title}[/bold white]",
+    )
+    console.print("[bold cyan]│[/bold cyan]")
+    
+    try:
+        yield
+    finally:
+        # Print section footer
+        console.print("[bold cyan]│[/bold cyan]")
+        console.print("[bold cyan]└────────────────────[/bold cyan]")
+        console.print()

nvlogger/core.py

@@ -0,0 +1,248 @@
+"""
+nvlogger core logging functions.
+
+This module provides the main logging functions: log, success, info,
+warning, error, and debug with beautiful colored output.
+"""
+
+from __future__ import annotations
+
+import sys
+import traceback
+from datetime import datetime
+from typing import Any, Optional
+
+from rich.text import Text
+
+from .setup import get_console, get_start_time, get_log_level
+
+
+# Log level constants
+LEVEL_DEBUG = 0
+LEVEL_INFO = 1
+LEVEL_WARNING = 2
+LEVEL_ERROR = 3
+
+# Style configuration for each log level
+STYLES = {
+    "log": {
+        "emoji": "📝",
+        "color": "white",
+        "level": LEVEL_INFO,
+    },
+    "success": {
+        "emoji": "✅",
+        "color": "green",
+        "level": LEVEL_INFO,
+    },
+    "info": {
+        "emoji": "ℹ️",
+        "color": "blue",
+        "level": LEVEL_INFO,
+    },
+    "warning": {
+        "emoji": "⚠️",
+        "color": "yellow",
+        "level": LEVEL_WARNING,
+    },
+    "error": {
+        "emoji": "❌",
+        "color": "red",
+        "level": LEVEL_ERROR,
+    },
+    "debug": {
+        "emoji": "🔍",
+        "color": "dim",
+        "level": LEVEL_DEBUG,
+    },
+}
+
+
+def _format_relative_time(start_time: datetime) -> str:
+    """
+    Format the elapsed time since start as a relative string.
+    
+    Args:
+        start_time: The reference start time.
+    
+    Returns:
+        A human-readable relative time string in Portuguese.
+    """
+    delta = datetime.now() - start_time
+    seconds = int(delta.total_seconds())
+    
+    if seconds < 1:
+        return "agora"
+    elif seconds < 60:
+        return f"há {seconds}s"
+    elif seconds < 3600:
+        minutes = seconds // 60
+        return f"há {minutes}min"
+    else:
+        hours = seconds // 3600
+        return f"há {hours}h"
+
+
+def _format_kwargs(kwargs: dict[str, Any]) -> str:
+    """
+    Format extra keyword arguments for display.
+    
+    Args:
+        kwargs: Dictionary of extra parameters.
+    
+    Returns:
+        Formatted string of key=value pairs.
+    """
+    if not kwargs:
+        return ""
+    
+    parts = [f"[dim]{k}=[/dim][italic]{v}[/italic]" for k, v in kwargs.items()]
+    return " " + " ".join(parts)
+
+
+def _log_message(
+    message: str,
+    style_name: str,
+    exc_info: bool = False,
+    **kwargs: Any,
+) -> None:
+    """
+    Internal function to log a message with the specified style.
+    
+    Args:
+        message: The message to log.
+        style_name: The style key (log, success, info, etc.).
+        exc_info: If True, include exception traceback.
+        **kwargs: Extra parameters to display.
+    """
+    style = STYLES[style_name]
+    
+    # Check log level
+    if style["level"] < get_log_level():
+        return
+    
+    console = get_console()
+    start_time = get_start_time()
+    
+    # Format timestamp
+    timestamp = _format_relative_time(start_time)
+    
+    # Format extra kwargs
+    extras = _format_kwargs(kwargs)
+    
+    # Build the output
+    emoji = style["emoji"]
+    color = style["color"]
+    
+    output = (
+        f"[dim]{timestamp:>8}[/dim] "
+        f"{emoji} "
+        f"[{color}]{message}[/{color}]"
+        f"{extras}"
+    )
+    
+    console.print(output)
+    
+    # Handle exception info
+    if exc_info:
+        exc_type, exc_value, exc_tb = sys.exc_info()
+        if exc_type is not None:
+            tb_lines = traceback.format_exception(exc_type, exc_value, exc_tb)
+            console.print()
+            console.print("[red]" + "".join(tb_lines) + "[/red]")
+
+
+def log(message: str, **kwargs: Any) -> None:
+    """
+    Log a generic message.
+    
+    Args:
+        message: The message to log.
+        **kwargs: Extra parameters to display (e.g., user="joao").
+    
+    Example:
+        >>> log("Processing started")
+        >>> log("User action", user="joao", action="login")
+    """
+    _log_message(message, "log", **kwargs)
+
+
+def success(message: str, **kwargs: Any) -> None:
+    """
+    Log a success message (green with ✅ emoji).
+    
+    Args:
+        message: The success message.
+        **kwargs: Extra parameters to display.
+    
+    Example:
+        >>> success("Operation completed successfully!")
+        >>> success("File saved", filename="data.json")
+    """
+    _log_message(message, "success", **kwargs)
+
+
+def info(message: str, **kwargs: Any) -> None:
+    """
+    Log an informational message (blue with ℹ️ emoji).
+    
+    Args:
+        message: The info message.
+        **kwargs: Extra parameters to display.
+    
+    Example:
+        >>> info("Starting download...")
+        >>> info("Connecting to server", host="localhost")
+    """
+    _log_message(message, "info", **kwargs)
+
+
+def warning(message: str, **kwargs: Any) -> None:
+    """
+    Log a warning message (yellow with ⚠️ emoji).
+    
+    Args:
+        message: The warning message.
+        **kwargs: Extra parameters to display.
+    
+    Example:
+        >>> warning("Large file detected")
+        >>> warning("Slow response", latency_ms=500)
+    """
+    _log_message(message, "warning", **kwargs)
+
+
+def error(message: str, exc_info: bool = False, **kwargs: Any) -> None:
+    """
+    Log an error message (red with ❌ emoji).
+    
+    Args:
+        message: The error message.
+        exc_info: If True, include the current exception traceback.
+        **kwargs: Extra parameters to display.
+    
+    Example:
+        >>> error("Connection failed")
+        >>> try:
+        ...     risky_operation()
+        ... except Exception:
+        ...     error("Operation failed", exc_info=True)
+    """
+    _log_message(message, "error", exc_info=exc_info, **kwargs)
+
+
+def debug(message: str, **kwargs: Any) -> None:
+    """
+    Log a debug message (gray with 🔍 emoji).
+    
+    Only displayed when log level is DEBUG.
+    
+    Args:
+        message: The debug message.
+        **kwargs: Extra parameters to display.
+    
+    Example:
+        >>> debug("Variable state", x=42, y=3.14)
+        >>> debug(f"Intermediate value: {result:.2f}")
+    """
+    _log_message(message, "debug", **kwargs)

nvlogger/setup.py

@@ -0,0 +1,110 @@
+"""
+nvlogger setup and configuration module.
+
+This module provides the setup() function for initializing the logging system.
+"""
+
+from __future__ import annotations
+
+import os
+from datetime import datetime
+from typing import Optional
+
+from rich.console import Console
+
+# Global state
+_console: Optional[Console] = None
+_start_time: Optional[datetime] = None
+_log_level: int = 1  # 0=DEBUG, 1=INFO, 2=WARNING, 3=ERROR
+
+# Log level mapping
+LOG_LEVELS = {
+    "DEBUG": 0,
+    "INFO": 1,
+    "WARNING": 2,
+    "ERROR": 3,
+}
+
+
+def get_console() -> Console:
+    """
+    Get the global Console instance.
+    
+    Returns:
+        Console: The rich Console instance used for output.
+    
+    Raises:
+        RuntimeError: If setup() has not been called.
+    """
+    global _console
+    if _console is None:
+        # Auto-setup if not initialized
+        setup()
+    return _console
+
+
+def get_start_time() -> datetime:
+    """
+    Get the start time for relative timestamps.
+    
+    Returns:
+        datetime: The time when setup() was called.
+    """
+    global _start_time
+    if _start_time is None:
+        _start_time = datetime.now()
+    return _start_time
+
+
+def get_log_level() -> int:
+    """
+    Get the current log level.
+    
+    Returns:
+        int: The current log level (0=DEBUG, 1=INFO, 2=WARNING, 3=ERROR).
+    """
+    return _log_level
+
+
+def setup(
+    level: Optional[str] = None,
+    force_terminal: Optional[bool] = None,
+    no_color: bool = False,
+) -> None:
+    """
+    Configure the nvlogger logging system.
+    
+    This function initializes the Console and sets up the logging level.
+    The log level can be set via the `level` parameter or the NVLOGGER_LEVEL
+    environment variable (DEBUG, INFO, WARNING, ERROR).
+    
+    Args:
+        level: Log level string (DEBUG, INFO, WARNING, ERROR).
+               Defaults to NVLOGGER_LEVEL env var or INFO.
+        force_terminal: Force terminal output even when not a TTY.
+        no_color: Disable colored output.
+    
+    Example:
+        >>> from nvlogger import setup
+        >>> setup()  # Use defaults
+        >>> setup(level="DEBUG")  # Enable debug messages
+    """
+    global _console, _start_time, _log_level
+    
+    # Initialize console
+    _console = Console(
+        force_terminal=force_terminal,
+        no_color=no_color,
+        highlight=False,
+    )
+    
+    # Set start time for relative timestamps
+    _start_time = datetime.now()
+    
+    # Determine log level
+    if level is None:
+        level = os.environ.get("NVLOGGER_LEVEL", "INFO").upper()
+    else:
+        level = level.upper()
+    
+    _log_level = LOG_LEVELS.get(level, 1)

nvlogger-0.1.0.dist-info/METADATA

@@ -0,0 +1,169 @@
+Metadata-Version: 2.4
+Name: nvlogger
+Version: 0.1.0
+Summary: Logging bonito e zero configuração para Python
+Author-email: NullVoid  <joaovictorsoares1703@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/NullVoidDev/richlog
+Project-URL: Repository, https://github.com/NullVoidDev/richlog
+Project-URL: Documentation, https://github.com/NullVoidDev/richlog#readme
+Keywords: logging,terminal,rich,colorful,beautiful
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Logging
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: rich>=13.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+
+# 🌈 nvlogger
+
+[![PyPI version](https://img.shields.io/pypi/v/nvlogger.svg)](https://pypi.org/project/nvlogger/)
+[![Python versions](https://img.shields.io/pypi/pyversions/nvlogger.svg)](https://pypi.org/project/nvlogger/)
+[![License](https://img.shields.io/pypi/l/nvlogger.svg)](https://github.com/NullVoidDev/nvlogger/blob/main/LICENSE)
+
+> **Logging bonito e zero configuração para Python** ✨
+
+Transforme seu terminal em uma experiência visual agradável. `nvlogger` substitui `print()` e logging básico com mensagens coloridas, emojis e formatação elegante — tudo com zero configuração.
+
+## 📦 Instalação
+
+```bash
+pip install nvlogger
+```
+
+## 🚀 Uso Rápido
+
+```python
+from nvlogger import setup, log, success, info, warning, error, debug
+
+setup()  # Configura tudo automaticamente
+
+log("Mensagem normal")
+success("Operação concluída com sucesso!")
+info("Iniciando download...")
+warning("Atenção: arquivo grande detectado")
+error("Falha na conexão com a API")
+debug("Valor intermediário: 42.50")
+```
+
+**Saída:**
+
+```
+   agora 📝 Mensagem normal
+   agora ✅ Operação concluída com sucesso!
+   agora ℹ️  Iniciando download...
+   agora ⚠️  Atenção: arquivo grande detectado
+   agora ❌ Falha na conexão com a API
+   agora 🔍 Valor intermediário: 42.50
+```
+
+## 📋 Funcionalidades
+
+### 🎨 Cores e Emojis Automáticos
+
+| Função    | Emoji | Cor      |
+|-----------|-------|----------|
+| `log()`     | 📝    | Branco   |
+| `success()` | ✅    | Verde    |
+| `info()`    | ℹ️     | Azul     |
+| `warning()` | ⚠️     | Amarelo  |
+| `error()`   | ❌    | Vermelho |
+| `debug()`   | 🔍    | Cinza    |
+
+### ⏱️ Timestamp Relativo
+
+Cada mensagem mostra um timestamp relativo: `agora`, `há 2s`, `há 1min`, etc.
+
+### 📦 Variáveis Extras
+
+Adicione contexto às suas mensagens:
+
+```python
+log("Login realizado", user="joao", ip="192.168.1.1")
+# agora 📝 Login realizado user=joao ip=192.168.1.1
+```
+
+### 🔴 Exceções Formatadas
+
+Capture e exiba exceções de forma elegante:
+
+```python
+try:
+    resultado = 1 / 0
+except ZeroDivisionError:
+    error("Erro no cálculo", exc_info=True)
+```
+
+### 📦 Seções
+
+Agrupe logs relacionados visualmente:
+
+```python
+with log.section("Processamento de imagens"):
+    log("Carregando imagens...")
+    info("Processando 100 arquivos")
+    success("Concluído!")
+```
+
+**Saída:**
+
+```
+┌─ Processamento de imagens
+│
+   agora 📝 Carregando imagens...
+   agora ℹ️  Processando 100 arquivos
+   agora ✅ Concluído!
+│
+└────────────────────
+```
+
+## ⚙️ Configuração
+
+### Nível de Log
+
+Controle quais mensagens são exibidas via variável de ambiente:
+
+```bash
+# Mostra apenas WARNING e ERROR
+set NVLOGGER_LEVEL=WARNING
+
+# Mostra tudo incluindo DEBUG
+set NVLOGGER_LEVEL=DEBUG
+```
+
+Ou configure diretamente:
+
+```python
+setup(level="DEBUG")
+```
+
+### Opções de setup()
+
+```python
+setup(
+    level="INFO",           # Nível de log (DEBUG, INFO, WARNING, ERROR)
+    force_terminal=True,    # Força saída de terminal (útil em pipes)
+    no_color=False,         # Desabilita cores
+)
+```
+
+## 📄 Licença
+
+MIT License - use à vontade! 🎉
+
+---
+
+Feito com ❤️ usando [rich](https://github.com/Textualize/rich)

nvlogger-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+nvlogger/__init__.py,sha256=koVIEbZabre23qx4zUoM1-r7bk3Nkj6tVMB7fim_tCM,1118
+nvlogger/__version__.py,sha256=N3KNGNLBjJ32dlG26XXZq_OBpBHTc3jV9SOwTJCtbYU,62
+nvlogger/context.py,sha256=oxU0HbTbh7GlNRTXeiWahTMrvYmGOY8eWqmPxgjBSvk,1338
+nvlogger/core.py,sha256=iK0GeUWQ1X5bCppuBgqbTfpk0n0p7J-2hIU-QTcqO9A,6248
+nvlogger/setup.py,sha256=OdwQQ3w4eJ8DOYfE9BUsxIqnHM-CDQbyASisY65EJYE,2736
+nvlogger-0.1.0.dist-info/METADATA,sha256=Twq4hEE81MjUlRhqju5f425QPxKX2AHe5Hb_F31dZM0,4697
+nvlogger-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+nvlogger-0.1.0.dist-info/top_level.txt,sha256=2rdGq6uSU7PXWV2-5HxH1YN_sQPET1EzXk1RUUeXqMY,9
+nvlogger-0.1.0.dist-info/RECORD,,

nvlogger-0.1.0.dist-info/WHEEL

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

nvlogger-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+nvlogger