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

tasktree/substitution.py

@@ -256,7 +256,7 @@ def substitute_dependency_args(
     Example:
     >>> substitute_dependency_args("{{ arg.mode }}", "build", {"mode": "debug"})
     'debug'
-    @athena: 3d07a1b4e6bc
+    @athena: 4ffd5664e3ec
     """
     # Check for disallowed placeholder types in dependency args
     # Only {{ arg.* }} is allowed, not {{ var.* }}, {{ env.* }}, or {{ tt.* }}
@@ -361,7 +361,7 @@ def substitute_dependency_outputs(
     ...     {"build": build_task}
     ... )
     'Deploy dist/app.js'
-    @athena: 1e537c8d579c
+    @athena: 3fbf79c15ee9
     """
 
     def replacer(match: re.Match) -> str:

tasktree/types.py

@@ -122,7 +122,7 @@ class IPv6Type(click.ParamType):
 class DateTimeType(click.ParamType):
     """
     Validates datetime in format YYYY-MM-DDTHH:MM:SS.
-    @athena: c3bafa3e22e3
+    @athena: 0b935a25fb23
     """
 
     name = "datetime"
@@ -131,7 +131,7 @@ class DateTimeType(click.ParamType):
         self, value: Any, param: Optional[click.Parameter], ctx: Optional[click.Context]
     ) -> str:
         """
-        @athena: 13fa66adfe94
+        @athena: 9c7bb2d672cc
         """
         if isinstance(value, str):
             try:
@@ -180,7 +180,7 @@ def get_click_type(
 
     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.22.dist-info → tasktree-0.0.23.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tasktree
-Version: 0.0.22
+Version: 0.0.23
 Summary: A task automation tool with incremental execution
 Requires-Python: >=3.11
 Requires-Dist: click>=8.1.0
@@ -251,6 +251,7 @@ 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
@@ -877,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:
@@ -1619,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
@@ -1647,8 +1657,6 @@ tt --init
 ```bash
 # Remove state file (reset task cache)
 tt --clean
-tt --clean-state
-tt --reset
 ```
 
 ### Common Workflows
@@ -1667,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
@@ -1678,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.22.dist-info/RECORD

@@ -1,14 +0,0 @@
-tasktree/__init__.py,sha256=ZfI6vy-TxinN7eK0_XjfHUFq83pFV1XiHFrai_SHNqw,1251
-tasktree/cli.py,sha256=588ngMB27T6FqUp5LIJ_x_UNoPRlMv39b1_U0a88tfE,23577
-tasktree/docker.py,sha256=DAvdr6kZqkhx8J9fhsz26Z41hFPreANC60vdunvPX00,15050
-tasktree/executor.py,sha256=UF2H-qCgkJ5E2QoYt3To3a-ypwTIYJT9oyWRcBw2CzQ,46800
-tasktree/graph.py,sha256=Ya4ATQidj0rlHxvvbWF0Xx2J18MTpz2XPAHTcJXFcBg,23637
-tasktree/hasher.py,sha256=fvs7vNBrHdAA6pX-ZLhNnWLtd5qdxjAVFJC8SDF-DhQ,6730
-tasktree/parser.py,sha256=OUuME_ZqITAMQEL90w-yJFLKoEquF_IIa-By8MifMvI,101074
-tasktree/state.py,sha256=R4ZXgfs_rwrOH9nEb4mOjuHa7gAVqi7QPVCi0CouNQA,3961
-tasktree/substitution.py,sha256=hwox1m9r8p5b0Fcln12C63GexJHc5ZMUoqOrpqQLuPk,18663
-tasktree/types.py,sha256=nCiPrxg3r3ZX4CoZ6L5FrkJO9mgz_lFsZ-98X8tYgns,5015
-tasktree-0.0.22.dist-info/METADATA,sha256=fuvZWDbtlwfbQNOP_TMCDRSDGKdZYUTeROo3eqVcJ6o,54519
-tasktree-0.0.22.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-tasktree-0.0.22.dist-info/entry_points.txt,sha256=lQINlvRYnimvteBbnhH84A9clTg8NnpEjCWqWkqg8KE,40
-tasktree-0.0.22.dist-info/RECORD,,