puild 0.2.0__tar.gz → 0.2.1__tar.gz

{puild-0.2.0 → puild-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: puild
-Version: 0.2.0
+Version: 0.2.1
 Summary: A lightweight, modern build tool and command runner for Python.
 Requires-Dist: rich>=15.0.0
 Requires-Python: >=3.14
@@ -116,3 +116,29 @@ copy("src/config.json", "build/config.json")
 # Remove files or directories
 rm("build", recursive=True)
 ```
+
+### 7. Logging & File Routing
+
+`puild` uses Python's standard `logging` library (`logging.getLogger("puild")`). You can route logs to a file, rotate files, or customize levels:
+
+```python
+from puild import Command, configure_logging
+
+# Route logs to both console and a log file
+configure_logging(log_file="build.log")
+
+# Or log strictly to a file without console output
+configure_logging(log_file="build.log", console=False)
+
+# Or with log rotation
+configure_logging(log_file="build.log", max_bytes=10_000_000, backup_count=3)
+```
+
+You can also attach standard Python `logging` handlers directly:
+
+```python
+import logging
+
+handler = logging.FileHandler("custom.log")
+logging.getLogger("puild").addHandler(handler)
+```

{puild-0.2.0 → puild-0.2.1}/README.md

@@ -108,3 +108,29 @@ copy("src/config.json", "build/config.json")
 # Remove files or directories
 rm("build", recursive=True)
 ```
+
+### 7. Logging & File Routing
+
+`puild` uses Python's standard `logging` library (`logging.getLogger("puild")`). You can route logs to a file, rotate files, or customize levels:
+
+```python
+from puild import Command, configure_logging
+
+# Route logs to both console and a log file
+configure_logging(log_file="build.log")
+
+# Or log strictly to a file without console output
+configure_logging(log_file="build.log", console=False)
+
+# Or with log rotation
+configure_logging(log_file="build.log", max_bytes=10_000_000, backup_count=3)
+```
+
+You can also attach standard Python `logging` handlers directly:
+
+```python
+import logging
+
+handler = logging.FileHandler("custom.log")
+logging.getLogger("puild").addHandler(handler)
+```

{puild-0.2.0 → puild-0.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "puild"
-version = "0.2.0"
+version = "0.2.1"
 description = "A lightweight, modern build tool and command runner for Python."
 readme = "README.md"
 requires-python = ">=3.14"

{puild-0.2.0 → puild-0.2.1}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "puild"
-version = "0.2.0"
+version = "0.2.1"
 description = "A lightweight, modern build tool and command runner for Python."
 readme = "README.md"
 requires-python = ">=3.14"

{puild-0.2.0 → puild-0.2.1}/src/puild/__init__.py

@@ -1,10 +1,12 @@
 from puild.command import Command, Pipeline, Result, is_dry_run, set_dry_run
 from puild.fs import copy, find_files, mkdir, needs_rebuild, rm
 from puild.logging import (
+    configure_logging,
     get_default_indent,
     is_quiet,
     log_action,
     log_indented,
+    logger,
     set_default_indent,
     set_quiet,
 )
@@ -13,6 +15,7 @@ __all__ = [
     "Command",
     "Pipeline",
     "Result",
+    "configure_logging",
     "copy",
     "find_files",
     "get_default_indent",
@@ -20,6 +23,7 @@ __all__ = [
     "is_quiet",
     "log_action",
     "log_indented",
+    "logger",
     "mkdir",
     "needs_rebuild",
     "rm",

{puild-0.2.0 → puild-0.2.1}/src/puild/command.py

@@ -14,6 +14,7 @@ from puild.logging import (
     get_default_indent,
     log_action,
     log_indented,
+    write_stream_to_file_handlers,
 )
 
 _DRY_RUN = False
@@ -261,6 +262,7 @@ class Command:
                     input=input,
                     stdout=f,
                     stderr=subprocess.PIPE if capture else None,
+                    check=False,
                 )
             stdout_res = empty_out
             stderr_res = res.stderr if capture and res.stderr is not None else empty_out
@@ -274,6 +276,7 @@ class Command:
                 env=merged_env,
                 input=input,
                 capture_output=False,
+                check=False,
             )
             stdout_res = empty_out
             stderr_res = empty_out
@@ -298,6 +301,7 @@ class Command:
                 env=merged_env,
                 input=input,
                 capture_output=True,
+                check=False,
             )
             stdout_res = res.stdout
             stderr_res = res.stderr
@@ -365,9 +369,9 @@ class Command:
         )
 
         if input_data is not None and proc.stdin:
-            if text and isinstance(input_data, str):
-                proc.stdin.write(input_data)
-            elif not text and isinstance(input_data, bytes):
+            if (text and isinstance(input_data, str)) or (
+                not text and isinstance(input_data, bytes)
+            ):
                 proc.stdin.write(input_data)
             proc.stdin.close()
 
@@ -384,8 +388,11 @@ class Command:
                             chunks.append(line)
                         if not line.strip():
                             dest_stream.write(line)
+                            write_stream_to_file_handlers(line)
                         else:
-                            dest_stream.write(f"{indent}{line}")
+                            formatted = f"{indent}{line}"
+                            dest_stream.write(formatted)
+                            write_stream_to_file_handlers(formatted)
                         dest_stream.flush()
                 else:
                     target = getattr(dest_stream, "buffer", dest_stream)
@@ -395,8 +402,11 @@ class Command:
                             chunks.append(line)
                         if not line.strip():
                             target.write(line)
+                            write_stream_to_file_handlers(line.decode("utf-8", errors="replace"))
                         else:
-                            target.write(indent_bytes + line)
+                            formatted_bytes = indent_bytes + line
+                            target.write(formatted_bytes)
+                            write_stream_to_file_handlers(formatted_bytes.decode("utf-8", errors="replace"))
                         target.flush()
             finally:
                 pipe.close()
@@ -526,8 +536,11 @@ class Pipeline:
                             chunks.append(line)
                             if not line.strip():
                                 dest_stream.write(line)
+                                write_stream_to_file_handlers(line)
                             else:
-                                dest_stream.write(f"{effective_indent}{line}")
+                                formatted = f"{effective_indent}{line}"
+                                dest_stream.write(formatted)
+                                write_stream_to_file_handlers(formatted)
                             dest_stream.flush()
                     else:
                         target = getattr(dest_stream, "buffer", dest_stream)
@@ -536,8 +549,11 @@ class Pipeline:
                             chunks.append(line)
                             if not line.strip():
                                 target.write(line)
+                                write_stream_to_file_handlers(line.decode("utf-8", errors="replace"))
                             else:
-                                target.write(indent_bytes + line)
+                                formatted_bytes = indent_bytes + line
+                                target.write(formatted_bytes)
+                                write_stream_to_file_handlers(formatted_bytes.decode("utf-8", errors="replace"))
                             target.flush()
                 finally:
                     pipe.close()
@@ -553,9 +569,9 @@ class Pipeline:
 
             if input is not None and processes[0].stdin:
                 try:
-                    if text and isinstance(input, str):
-                        processes[0].stdin.write(input)
-                    elif not text and isinstance(input, bytes):
+                    if (text and isinstance(input, str)) or (
+                        not text and isinstance(input, bytes)
+                    ):
                         processes[0].stdin.write(input)
                     processes[0].stdin.close()
                 except BrokenPipeError:
@@ -574,9 +590,9 @@ class Pipeline:
                 )
                 if len(processes) > 1 and processes[0].stdin:
                     try:
-                        if text and isinstance(input, str):
-                            processes[0].stdin.write(input)
-                        elif not text and isinstance(input, bytes):
+                        if (text and isinstance(input, str)) or (
+                            not text and isinstance(input, bytes)
+                        ):
                             processes[0].stdin.write(input)
                         processes[0].stdin.close()
                     except BrokenPipeError:

puild-0.2.1/src/puild/logging.py

@@ -0,0 +1,211 @@
+from __future__ import annotations
+
+import contextlib
+import logging
+import re
+import sys
+from logging.handlers import RotatingFileHandler
+from pathlib import Path
+from typing import Any, Literal
+
+from rich import print as rich_print
+from rich.markup import escape
+
+ActionColor = Literal["red", "green", "yellow", "blue", "magenta", "cyan", "white"]
+
+_QUIET = False
+_DEFAULT_INDENT = "              "
+_ANSI_RE = re.compile(r"\x1B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])")
+
+
+def strip_ansi(text: str) -> str:
+    """Remove ANSI escape sequences from text."""
+    return _ANSI_RE.sub("", text)
+
+
+def set_quiet(quiet: bool) -> None:
+    """Set global quiet mode for logging."""
+    global _QUIET
+    _QUIET = quiet
+
+
+def is_quiet() -> bool:
+    """Check if quiet mode is enabled."""
+    return _QUIET
+
+
+def set_default_indent(indent: str) -> None:
+    """Set global default indentation string for command outputs."""
+    global _DEFAULT_INDENT
+    _DEFAULT_INDENT = indent
+
+
+def get_default_indent() -> str:
+    """Get the global default indentation string."""
+    return _DEFAULT_INDENT
+
+
+class ConsoleActionHandler(logging.Handler):
+    """Handler that formats action logs to the terminal using rich."""
+
+    def emit(self, record: logging.LogRecord) -> None:
+        if _QUIET:
+            return
+        try:
+            action = getattr(record, "action", None)
+            color = getattr(record, "color", "white")
+            msg = record.getMessage()
+
+            if action:
+                prefix = f"[bold {color}]{action:>10}[/bold {color}]: "
+                lines = msg.splitlines()
+                if not lines:
+                    rich_print(prefix.rstrip())
+                    return
+                rich_print(f"{prefix}{escape(lines[0])}")
+                indent_pad = " " * 12
+                for line in lines[1:]:
+                    rich_print(f"{indent_pad}{escape(line)}")
+            else:
+                # Direct message or indented block
+                if "\x1b" in msg:
+                    sys.stdout.write(msg + "\n")
+                    sys.stdout.flush()
+                else:
+                    for line in msg.splitlines():
+                        if not line.strip():
+                            sys.stdout.write("\n")
+                        else:
+                            sys.stdout.write(f"{line}\n")
+                    sys.stdout.flush()
+        except Exception:  # noqa: BLE001
+            self.handleError(record)
+
+
+class FileActionFormatter(logging.Formatter):
+    """Formats log records for file output without ANSI codes or markup."""
+
+    def format(self, record: logging.LogRecord) -> str:
+        action = getattr(record, "action", None)
+        raw_msg = record.getMessage()
+        clean_msg = strip_ansi(raw_msg)
+        asctime = self.formatTime(record, self.datefmt or "%Y-%m-%d %H:%M:%S")
+
+        if action:
+            lines = clean_msg.splitlines()
+            if not lines:
+                return f"{asctime} [{record.levelname:<5}] {action:>10}:"
+            first_line = f"{asctime} [{record.levelname:<5}] {action:>10}: {lines[0]}"
+            if len(lines) == 1:
+                return first_line
+            indent_pad = " " * 12
+            rest = [f"{asctime} [{record.levelname:<5}] {indent_pad}{line}" for line in lines[1:]]
+            return "\n".join([first_line, *rest])
+        else:
+            lines = clean_msg.splitlines()
+            if not lines:
+                return ""
+            return "\n".join([f"{asctime} [{record.levelname:<5}] {line}" for line in lines])
+
+
+# Core package logger
+logger = logging.getLogger("puild")
+logger.setLevel(logging.INFO)
+# Attach default console handler
+_default_console_handler = ConsoleActionHandler()
+logger.addHandler(_default_console_handler)
+
+
+def configure_logging(
+    log_file: str | Path | None = None,
+    level: int | str = logging.INFO,
+    console: bool = True,
+    file_mode: str = "a",
+    max_bytes: int = 0,
+    backup_count: int = 0,
+    datefmt: str = "%Y-%m-%d %H:%M:%S",
+) -> logging.Logger:
+    """Configure puild logger to console and an optional file destination."""
+    if isinstance(level, str):
+        level = getattr(logging, level.upper(), logging.INFO)
+    logger.setLevel(level)
+
+    # Clean and close existing handlers
+    for h in logger.handlers:
+        h.close()
+    logger.handlers.clear()
+
+    if console:
+        c_handler = ConsoleActionHandler()
+        c_handler.setLevel(level)
+        logger.addHandler(c_handler)
+
+    if log_file:
+        p = Path(log_file)
+        p.parent.mkdir(parents=True, exist_ok=True)
+        if max_bytes > 0:
+            f_handler = RotatingFileHandler(
+                p, maxBytes=max_bytes, backupCount=backup_count, encoding="utf-8"
+            )
+        else:
+            f_handler = logging.FileHandler(p, mode=file_mode, encoding="utf-8")
+        f_handler.setLevel(level)
+        f_handler.setFormatter(FileActionFormatter(datefmt=datefmt))
+        logger.addHandler(f_handler)
+
+    return logger
+
+
+def log_action(
+    action_name: str,
+    action_message: str,
+    action_color: ActionColor = "white",
+    level: int = logging.INFO,
+) -> None:
+    """Log an action using the standard puild logger."""
+    if action_name in ("Failed", "Error"):
+        level = logging.ERROR
+    logger.log(
+        level,
+        action_message,
+        extra={"action": action_name, "color": action_color},
+    )
+
+
+def log_indented(
+    message: str,
+    indent: str | None = None,
+    stream: Any = sys.stdout,
+    level: int = logging.INFO,
+) -> None:
+    """Log multiline text with each line indented."""
+    if not message:
+        return
+    eff_indent = _DEFAULT_INDENT if indent is None else indent
+    if stream is not sys.stdout:
+        for line in message.splitlines():
+            if not line.strip():
+                stream.write("\n")
+            else:
+                stream.write(f"{eff_indent}{line}\n")
+        stream.flush()
+        return
+
+    lines: list[str] = []
+    for line in message.splitlines():
+        if not line.strip():
+            lines.append("")
+        else:
+            lines.append(f"{eff_indent}{line}")
+    formatted = "\n".join(lines)
+    logger.log(level, formatted, extra={"is_indented": True})
+
+
+def write_stream_to_file_handlers(text: str) -> None:
+    """Write streaming command line output directly to registered FileHandlers."""
+    clean = strip_ansi(text)
+    for h in logger.handlers:
+        if isinstance(h, logging.FileHandler) and h.stream is not None:
+            with contextlib.suppress(OSError):
+                h.stream.write(clean)
+                h.stream.flush()

puild-0.2.0/src/puild/logging.py

@@ -1,71 +0,0 @@
-from __future__ import annotations
-
-import sys
-from typing import Any, Literal
-from rich import print as rich_print
-from rich.markup import escape
-
-ActionColor = Literal["red", "green", "yellow", "blue", "magenta", "cyan", "white"]
-
-_QUIET = False
-_DEFAULT_INDENT = "    "
-
-
-def set_quiet(quiet: bool) -> None:
-    """Set global quiet mode for logging."""
-    global _QUIET
-    _QUIET = quiet
-
-
-def is_quiet() -> bool:
-    """Check if quiet mode is enabled."""
-    return _QUIET
-
-
-def set_default_indent(indent: str) -> None:
-    """Set global default indentation string for command outputs."""
-    global _DEFAULT_INDENT
-    _DEFAULT_INDENT = indent
-
-
-def get_default_indent() -> str:
-    """Get the global default indentation string."""
-    return _DEFAULT_INDENT
-
-
-def log_action(
-    action_name: str,
-    action_message: str,
-    action_color: ActionColor = "white",
-) -> None:
-    """Print a formatted action log line if quiet mode is not enabled."""
-    if _QUIET:
-        return
-    prefix = f"[bold {action_color}]{action_name:>10}[/bold {action_color}]: "
-    lines = action_message.splitlines()
-    if not lines:
-        rich_print(prefix.rstrip())
-        return
-
-    rich_print(f"{prefix}{escape(lines[0])}")
-    # Indent subsequent lines of a multiline action message to align after the prefix
-    indent_pad = " " * 12
-    for line in lines[1:]:
-        rich_print(f"{indent_pad}{escape(line)}")
-
-
-def log_indented(
-    message: str,
-    indent: str | None = None,
-    stream: Any = sys.stdout,
-) -> None:
-    """Print multiline text with each line indented."""
-    if _QUIET or not message:
-        return
-    eff_indent = _DEFAULT_INDENT if indent is None else indent
-    for line in message.splitlines():
-        if not line.strip():
-            stream.write("\n")
-        else:
-            stream.write(f"{eff_indent}{line}\n")
-    stream.flush()