tasktree 0.0.21__py3-none-any.whl → 0.0.23__py3-none-any.whl

tasktree/types.py

@@ -3,7 +3,6 @@
 import re
 from datetime import datetime
 from ipaddress import IPv4Address, IPv6Address, ip_address
-from pathlib import Path
 from typing import Any, Optional
 
 import click
@@ -22,7 +21,9 @@ class HostnameType(click.ParamType):
         r"^(?=.{1,253}$)(?!-)[A-Za-z0-9-]{1,63}(?<!-)(\.[A-Za-z0-9-]{1,63})*\.?$"
     )
 
-    def convert(self, value: Any, param: Optional[click.Parameter], ctx: Optional[click.Context]) -> str:
+    def convert(
+        self, value: Any, param: Optional[click.Parameter], ctx: Optional[click.Context]
+    ) -> str:
         """
         @athena: 8d921e52bcf2
         """
@@ -41,11 +42,11 @@ class EmailType(click.ParamType):
     name = "email"
 
     # Basic email validation (RFC 5322 simplified)
-    EMAIL_PATTERN = re.compile(
-        r"^[a-zA-Z0-9_.+-]+@[a-zA-Z0-9-]+\.[a-zA-Z0-9-.]+$"
-    )
+    EMAIL_PATTERN = re.compile(r"^[a-zA-Z0-9_.+-]+@[a-zA-Z0-9-]+\.[a-zA-Z0-9-.]+$")
 
-    def convert(self, value: Any, param: Optional[click.Parameter], ctx: Optional[click.Context]) -> str:
+    def convert(
+        self, value: Any, param: Optional[click.Parameter], ctx: Optional[click.Context]
+    ) -> str:
         """
         @athena: 25046aeb6e6f
         """
@@ -63,7 +64,9 @@ class IPType(click.ParamType):
 
     name = "ip"
 
-    def convert(self, value: Any, param: Optional[click.Parameter], ctx: Optional[click.Context]) -> str:
+    def convert(
+        self, value: Any, param: Optional[click.Parameter], ctx: Optional[click.Context]
+    ) -> str:
         """
         @athena: d57618e5ad89
         """
@@ -82,7 +85,9 @@ class IPv4Type(click.ParamType):
 
     name = "ipv4"
 
-    def convert(self, value: Any, param: Optional[click.Parameter], ctx: Optional[click.Context]) -> str:
+    def convert(
+        self, value: Any, param: Optional[click.Parameter], ctx: Optional[click.Context]
+    ) -> str:
         """
         @athena: 7ed2d17d1f1a
         """
@@ -101,7 +106,9 @@ class IPv6Type(click.ParamType):
 
     name = "ipv6"
 
-    def convert(self, value: Any, param: Optional[click.Parameter], ctx: Optional[click.Context]) -> str:
+    def convert(
+        self, value: Any, param: Optional[click.Parameter], ctx: Optional[click.Context]
+    ) -> str:
         """
         @athena: 4b101e4d54cf
         """
@@ -115,14 +122,16 @@ class IPv6Type(click.ParamType):
 class DateTimeType(click.ParamType):
     """
     Validates datetime in format YYYY-MM-DDTHH:MM:SS.
-    @athena: c3bafa3e22e3
+    @athena: 0b935a25fb23
     """
 
     name = "datetime"
 
-    def convert(self, value: Any, param: Optional[click.Parameter], ctx: Optional[click.Context]) -> str:
+    def convert(
+        self, value: Any, param: Optional[click.Parameter], ctx: Optional[click.Context]
+    ) -> str:
         """
-        @athena: 13fa66adfe94
+        @athena: 9c7bb2d672cc
         """
         if isinstance(value, str):
             try:
@@ -130,7 +139,11 @@ class DateTimeType(click.ParamType):
                 return value
             except ValueError:
                 pass
-        self.fail(f"{value!r} is not a valid datetime (expected YYYY-MM-DDTHH:MM:SS format)", param, ctx)
+        self.fail(
+            f"{value!r} is not a valid datetime (expected YYYY-MM-DDTHH:MM:SS format)",
+            param,
+            ctx,
+        )
 
 
 # Type registry for dynamic parameter creation
@@ -149,7 +162,11 @@ TYPE_MAPPING = {
 }
 
 
-def get_click_type(type_name: str, min_val: int | float | None = None, max_val: int | float | None = None) -> click.ParamType:
+def get_click_type(
+    type_name: str,
+    min_val: int | float | None = None,
+    max_val: int | float | None = None,
+) -> click.ParamType:
     """
     Get Click parameter type by name with optional range constraints.
 
@@ -163,7 +180,7 @@ def get_click_type(type_name: str, min_val: int | float | None = None, max_val:
 
     Raises:
     ValueError: If type_name is not recognized
-    @athena: d0912868676f
+    @athena: 523ff9c66303
     """
     if type_name not in TYPE_MAPPING:
         raise ValueError(f"Unknown type: {type_name}")

{tasktree-0.0.21.dist-info → tasktree-0.0.23.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tasktree
-Version: 0.0.21
+Version: 0.0.23
 Summary: A task automation tool with incremental execution
 Requires-Python: >=3.11
 Requires-Dist: click>=8.1.0
@@ -10,7 +10,9 @@ Requires-Dist: pyyaml>=6.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: typer>=0.9.0
 Provides-Extra: dev
+Requires-Dist: black>=26.1.0; extra == 'dev'
 Requires-Dist: pytest>=9.0.2; extra == 'dev'
+Requires-Dist: ruff>=0.14.14; extra == 'dev'
 Description-Content-Type: text/markdown
 
 # Task Tree (tt)
@@ -249,26 +251,26 @@ tasks:
     working_dir: subproject/               # Execution directory (default: project root)
     env: bash-strict                       # Execution environment (optional)
     private: false                         # Hide from --list output (default: false)
+    task_output: all                       # Control task output: all, out, err, on-err, none (default: all)
     args:                                   # Task parameters
       - param1                              # Simple argument
       - param2: { type: path, default: "." }  # With type and default
     cmd: go build -o dist/binary           # Command to execute
 ```
 
+**Task name constraints:**
+- Task names cannot contain dots (`.`) - they are reserved for namespacing imported tasks
+- Example: `build.release` is invalid as a task name, but valid as a reference to task `release` in namespace `build`
+
 ### Commands
 
-**Single-line commands** are executed directly via the configured shell:
+All commands are executed by writing them to temporary script files. This provides consistent behavior and better shell syntax support:
 
 ```yaml
 tasks:
   build:
     cmd: cargo build --release
-```
-
-**Multi-line commands** are written to temporary script files for proper execution:
 
-```yaml
-tasks:
   deploy:
     cmd: |
       mkdir -p dist
@@ -276,7 +278,7 @@ tasks:
       rsync -av dist/ server:/opt/app/
 ```
 
-Multi-line commands preserve shell syntax (line continuations, heredocs, etc.) and support shebangs on Unix/macOS.
+Commands preserve shell syntax (line continuations, heredocs, etc.) and support shebangs on Unix/macOS.
 
 Or use folded blocks for long single-line commands:
 
@@ -292,7 +294,7 @@ tasks:
 
 ### Execution Environments
 
-Configure custom shell environments for task execution:
+Configure custom shell environments for task execution. Use the `preamble` field to add initialization code to all commands:
 
 ```yaml
 environments:
@@ -300,17 +302,14 @@ environments:
 
   bash-strict:
     shell: bash
-    args: ['-c']              # For single-line: bash -c "command"
-    preamble: |               # For multi-line: prepended to script
+    preamble: |               # Prepended to all commands
       set -euo pipefail
 
   python:
     shell: python
-    args: ['-c']
 
   powershell:
     shell: powershell
-    args: ['-ExecutionPolicy', 'Bypass', '-Command']
     preamble: |
       $ErrorActionPreference = 'Stop'
 
@@ -339,8 +338,8 @@ tasks:
 4. Platform default (bash on Unix, cmd on Windows)
 
 **Platform defaults** when no environments are configured:
-- **Unix/macOS**: bash with `-c` args
-- **Windows**: cmd with `/c` args
+- **Unix/macOS**: bash
+- **Windows**: cmd
 
 ### Docker Environments
 
@@ -879,7 +878,8 @@ tasks:
     inputs: [src/app-{{ var.version }}.c]
     outputs: [build/app-{{ var.version }}.o]
     cmd: gcc src/app-{{ var.version }}.c -o build/app-{{ var.version }}.o
-
+```
+```yaml
 # With self-references - DRY
 tasks:
   build:
@@ -1621,6 +1621,14 @@ tt -o deploy
 # Override environment for all tasks
 tt --env python analyze
 tt -e powershell build
+
+# Control task subprocess output display
+tt --task-output all build     # Show both stdout and stderr (default)
+tt --task-output out test      # Show only stdout
+tt --task-output err deploy    # Show only stderr
+tt --task-output on-err ci     # Show stderr only if task fails
+tt --task-output none build    # Suppress all task output
+tt -O none build               # Short form
 ```
 
 ### Information Commands
@@ -1649,8 +1657,6 @@ tt --init
 ```bash
 # Remove state file (reset task cache)
 tt --clean
-tt --clean-state
-tt --reset
 ```
 
 ### Common Workflows
@@ -1669,6 +1675,194 @@ tt --env python test
 tt --force deploy production
 ```
 
+### Logging Control
+
+Task Tree provides fine-grained control over diagnostic logging verbosity through the `--log-level` flag. This allows you to adjust the amount of information displayed about task execution, from minimal error-only output to detailed trace logging.
+
+**Log Levels:**
+
+```bash
+# Show only fatal errors (malformed task files, missing dependencies)
+tt --log-level fatal build
+
+# Show fatal errors and task execution failures
+tt --log-level error build
+
+# Show errors and warnings (deprecated features, configuration issues)
+tt --log-level warn build
+
+# Show normal execution progress (default)
+tt --log-level info build
+tt build  # Same as above
+
+# Show detailed diagnostics (variable values, resolved paths, environment details)
+tt --log-level debug build
+
+# Show fine-grained execution tracing
+tt --log-level trace build
+```
+
+**Short Form:**
+
+```bash
+tt -L debug build
+tt -L trace test
+```
+
+**Case Insensitive:**
+
+```bash
+tt --log-level INFO build    # Works
+tt --log-level Debug test    # Works
+tt --log-level TRACE deploy  # Works
+```
+
+**Common Use Cases:**
+
+**Debugging Workflows:**
+```bash
+# See variable substitution and resolved paths
+tt --log-level debug deploy production
+
+# See detailed execution steps and internal state
+tt --log-level trace build
+```
+
+**CI/CD Environments:**
+```bash
+# Suppress progress messages, show only errors
+tt --log-level error build test package
+
+# Minimal output for clean build logs
+tt --log-level warn ci
+```
+
+**Normal Development:**
+```bash
+# Default level shows normal execution progress
+tt build test
+```
+
+**Understanding Log Levels:**
+
+- **FATAL** (least verbose): Only unrecoverable errors that prevent execution
+- **ERROR**: Fatal errors plus individual task failures
+- **WARN**: Errors plus warnings about deprecated features or configuration issues
+- **INFO** (default): Normal execution progress messages
+- **DEBUG**: Info plus variable values, resolved paths, environment configuration
+- **TRACE** (most verbose): Debug plus fine-grained execution tracing
+
+Log levels are hierarchical - setting a higher verbosity level (e.g., DEBUG) includes all messages from lower levels (FATAL, ERROR, WARN, INFO).
+
+**Note:** The `--log-level` flag controls Task Tree's own diagnostic messages. It does not affect the output of task commands themselves - use `--task-output` to control task subprocess output (see below).
+
+### Task Output Control
+
+Task Tree provides fine-grained control over task subprocess output through the `--task-output` flag. This allows you to control whether tasks display their stdout, stderr, both, or neither, independent of Task Tree's own diagnostic logging.
+
+**Output Modes:**
+
+```bash
+# Show both stdout and stderr (default)
+tt --task-output all build
+tt -O all build
+tt build  # Same as above
+
+# Show only stdout, suppress stderr
+tt --task-output out build
+tt -O out test
+
+# Show only stderr, suppress stdout
+tt --task-output err build
+tt -O err deploy
+
+# Show stderr only if the task fails (stdout always suppressed)
+tt --task-output on-err build
+tt -O on-err ci
+
+# Suppress all task output
+tt --task-output none build
+tt -O none build
+```
+
+**Case Insensitive:**
+
+```bash
+tt --task-output ALL build    # Works
+tt --task-output Out test     # Works
+tt --task-output ON-ERR ci    # Works
+```
+
+**Common Use Cases:**
+
+**CI/CD Environments:**
+```bash
+# Suppress task output, show only tasktree diagnostics
+tt --log-level info --task-output none build test
+
+# Show errors only if they occur
+tt --log-level error --task-output on-err ci
+```
+
+**Debugging:**
+```bash
+# Show only stderr to focus on warnings/errors
+tt --task-output err build
+
+# Show everything for full visibility
+tt --log-level debug --task-output all build
+```
+
+**Clean Build Logs:**
+```bash
+# Suppress noisy build output, show only tasktree progress
+tt --task-output none build package deploy
+```
+
+**Task-Level Configuration:**
+
+Tasks can specify their own default output behavior in the recipe file:
+
+```yaml
+tasks:
+  # Noisy task - suppress output by default
+  install-deps:
+    task_output: none
+    cmd: npm install
+
+  # Let pytest manage its own output - it's already good at that
+  test:
+    cmd: pytest tests/
+
+  # Don't clutter CI logs with loads of output, unless something goes wrong
+  build:
+    task_output: on-err
+    cmd: cargo build --release
+```
+
+**Understanding Output Modes:**
+
+| Mode | Stdout | Stderr | Notes |
+|------|--------|--------|-------|
+| `all` | ✓ | ✓ | Default behavior, shows everything |
+| `out` | ✓ | ✗ | Good for capturing command results |
+| `err` | ✗ | ✓ | Focus on warnings and errors |
+| `on-err` | ✗ | ✓ (on failure) | Stderr buffered, shown only if task fails |
+| `none` | ✗ | ✗ | Silent execution, useful for noisy tasks |
+
+**Override Behavior:**
+
+- Command-line `--task-output` overrides task-level `task_output` settings for all tasks
+- Task-level `task_output` applies only if no command-line flag is provided
+- Default behavior is `all` if neither is specified
+
+**Important Notes:**
+
+- Task output control is independent of `--log-level` - you can suppress task output while still seeing tasktree diagnostics
+- The `on-err` mode buffers stderr in memory and only displays it if the task fails
+- Output suppression does not affect the task's execution - files are still created, commands still run
+- Task exit codes are always checked regardless of output mode
+
 ## Example: Full Build Pipeline
 
 ```yaml
@@ -1680,6 +1874,7 @@ tasks:
   compile:
     desc: Build application binaries
     outputs: [target/release/app]
+    task_output: "on-err" # We only care about seeing this if it fails.
     cmd: cargo build --release
 
   test-unit:

tasktree-0.0.23.dist-info/RECORD

@@ -0,0 +1,17 @@
+tasktree/__init__.py,sha256=I5ICzU0vQn0Nal-P9IMdtOzKr_henQRlCBf-66j6yak,1251
+tasktree/cli.py,sha256=_jfaGLTLoFIl_LsjYgaHhIStd4JkC4UzFf0gDTUTGbA,24694
+tasktree/console_logger.py,sha256=k8A23zfX0Jp3rjs0VIDIOCmksVehtnhC8HKH0o8ybFQ,2175
+tasktree/docker.py,sha256=r9rejuxpYdHcXbLPLEwUJ1_KTyTRr29wIMnk6dtF1Ko,15363
+tasktree/executor.py,sha256=dDOTKB0VCcgNcZVOyeQlnA-XvqDbeBhs7qr_1mfLq7E,51488
+tasktree/graph.py,sha256=EQUEwJ3WW6tNH0_DSGM3OCwobwWJ73ok_Ih6KiraZEo,23637
+tasktree/hasher.py,sha256=Tq16Hh8lnIDkLHkQr-COz-BRqAOzZ_cEA8YQTYHP5bc,6722
+tasktree/logging.py,sha256=CQi7MMCgWxgnVW0xW_qw4zZF3LzNyobkzVCOyXVxqKw,3154
+tasktree/parser.py,sha256=8gx3TbtcLLMnMELoz6plgq8TNgvvYrmONbTpM3sX5eM,101232
+tasktree/process_runner.py,sha256=lDaU2rWUDcmF--QTV1GmNKe7cdT8Hi1uT4fziUUU3iM,13358
+tasktree/state.py,sha256=R4ZXgfs_rwrOH9nEb4mOjuHa7gAVqi7QPVCi0CouNQA,3961
+tasktree/substitution.py,sha256=W1aOYSGDtpd3R4j5Mhgh69vxPSYG6BijPeyPqMSQY7I,18663
+tasktree/types.py,sha256=34-Y2Jn6c6FHem94PCqkNPzqthn-1-QX55smvjWRE_o,5015
+tasktree-0.0.23.dist-info/METADATA,sha256=LSIKyFHsx1hvHRSr7kfppfiYHEvWmt9ybce2s-Dp5V8,60438
+tasktree-0.0.23.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+tasktree-0.0.23.dist-info/entry_points.txt,sha256=lQINlvRYnimvteBbnhH84A9clTg8NnpEjCWqWkqg8KE,40
+tasktree-0.0.23.dist-info/RECORD,,

tasktree-0.0.21.dist-info/RECORD

@@ -1,14 +0,0 @@
-tasktree/__init__.py,sha256=ZfI6vy-TxinN7eK0_XjfHUFq83pFV1XiHFrai_SHNqw,1251
-tasktree/cli.py,sha256=pyXMUENz1ldl8z9SPXBZ1zhOHzmvIRUGu2y5VwRUdgo,22960
-tasktree/docker.py,sha256=EeIUqptvDqSXbjWKXwWGhA4hWvsBjOk0Z-3cS3cqEOM,14857
-tasktree/executor.py,sha256=x0K-TIVRmiKuUlur1UTOpB2xOJOE_Cv3-3MlE7xUNEk,47271
-tasktree/graph.py,sha256=BjpLaa7EE2vmOcUlqhvp1KK7yT5VbXHQCbxljOhF84k,23603
-tasktree/hasher.py,sha256=UM-2dqRE-rspQUbhA-noGHc80-Hu-QaxCTPRb_UzPto,6661
-tasktree/parser.py,sha256=sXgotDdDQiNSmo7FaESFQ4j1OytaheyplJSdFrFXTYk,99286
-tasktree/state.py,sha256=0fxKbMNYbo-dCpCTTnKTmJhGRy72G5kLnh99FScMLGU,3985
-tasktree/substitution.py,sha256=2ubFn6jIX5qmtzyWSCxTut-_Cn0zew8KnwxMqDIPq1o,18545
-tasktree/types.py,sha256=2uHdUncfyfw4jNWbQTBUirew-frmTjuk1ZYNd15cyQQ,4908
-tasktree-0.0.21.dist-info/METADATA,sha256=nyjDhb1hdQMEiLx0t_qqonqPoyFZVMCrIg7xFIKxMs8,54353
-tasktree-0.0.21.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-tasktree-0.0.21.dist-info/entry_points.txt,sha256=lQINlvRYnimvteBbnhH84A9clTg8NnpEjCWqWkqg8KE,40
-tasktree-0.0.21.dist-info/RECORD,,