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

tasktree/state.py

@@ -5,7 +5,7 @@ from __future__ import annotations
 import json
 from dataclasses import dataclass, field
 from pathlib import Path
-from typing import Any
+from typing import Any, Set
 
 
 @dataclass
@@ -43,7 +43,7 @@ class TaskState:
 class StateManager:
     """
     Manages the .tasktree-state file.
-    @athena: 44713c70e04e
+    @athena: 3dd3447bb53b
     """
 
     STATE_FILE = ".tasktree-state"
@@ -64,17 +64,16 @@ class StateManager:
     def load(self) -> None:
         """
         Load state from file if it exists.
-        @athena: 11748af0886c
+        @athena: e0cf9097c590
         """
         if self.state_path.exists():
             try:
                 with open(self.state_path, "r") as f:
                     data = json.load(f)
                     self._state = {
-                        key: TaskState.from_dict(value)
-                        for key, value in data.items()
+                        key: TaskState.from_dict(value) for key, value in data.items()
                     }
-            except (json.JSONDecodeError, KeyError) as e:
+            except (json.JSONDecodeError, KeyError):
                 # If state file is corrupted, start fresh
                 self._state = {}
         self._loaded = True
@@ -116,13 +115,13 @@ class StateManager:
             self.load()
         self._state[cache_key] = state
 
-    def prune(self, valid_task_hashes: set[str]) -> None:
+    def prune(self, valid_task_hashes: Set[str]) -> None:
         """
         Remove state entries for tasks that no longer exist.
 
         Args:
         valid_task_hashes: Set of valid task hashes from current recipe
-        @athena: ce21bb523d49
+        @athena: 2717c6c244d3
         """
         if not self._loaded:
             self.load()

tasktree/substitution.py

@@ -7,30 +7,30 @@ and {{ env.NAME }} placeholders with their corresponding values.
 """
 
 import re
-from random import choice
 from typing import Any
 
-
 # Pattern matches: {{ prefix.name }} with optional whitespace
 # Groups: (1) prefix (var|arg|env|tt), (2) name (identifier)
 PLACEHOLDER_PATTERN = re.compile(
-    r'\{\{\s*(var|arg|env|tt)\.([a-zA-Z_][a-zA-Z0-9_]*)\s*\}\}'
+    r"\{\{\s*(var|arg|env|tt)\.([a-zA-Z_][a-zA-Z0-9_]*)\s*}}"
 )
 
 # Pattern matches: {{ dep.task_name.outputs.output_name }} with optional whitespace
 # Groups: (1) task_name (can include dots for namespacing), (2) output_name (identifier)
 DEP_OUTPUT_PATTERN = re.compile(
-    r'\{\{\s*dep\.([a-zA-Z_][a-zA-Z0-9_.-]*)\.outputs\.([a-zA-Z_][a-zA-Z0-9_]*)\s*\}\}'
+    r"\{\{\s*dep\.([a-zA-Z_][a-zA-Z0-9_.-]*)\.outputs\.([a-zA-Z_][a-zA-Z0-9_]*)\s*}}"
 )
 
 # Pattern matches: {{ self.(inputs|outputs).name }} or {{ self.(inputs|outputs).0 }} with optional whitespace
 # Groups: (1) field (inputs|outputs), (2) name (identifier) or index (numeric)
 SELF_REFERENCE_PATTERN = re.compile(
-    r'\{\{\s*self\.(inputs|outputs)\.([a-zA-Z_][a-zA-Z0-9_]*|[0-9]+)\s*\}\}'
+    r"\{\{\s*self\.(inputs|outputs)\.([a-zA-Z_][a-zA-Z0-9_]*|[0-9]+)\s*}}"
 )
 
 
-def substitute_variables(text: str | dict[str, Any], variables: dict[str, str]) -> str | dict[str, Any]:
+def substitute_variables(
+    text: str | dict[str, Any], variables: dict[str, str]
+) -> str | dict[str, Any]:
     """
     Substitute {{ var.name }} placeholders with variable values.
 
@@ -52,13 +52,18 @@ def substitute_variables(text: str | dict[str, Any], variables: dict[str, str])
 
         for arg_name in text.keys():
             # Pull out and substitute the individual fields of an argument one at a time
-            for field in  [ "default", "min", "max" ]:
+            for field in ["default", "min", "max"]:
                 if field in text[arg_name]:
-                    text[arg_name][field] = substitute_variables(text[arg_name][field], variables)
+                    text[arg_name][field] = substitute_variables(
+                        text[arg_name][field], variables
+                    )
 
             # choices is a list of things
             if "choices" in text[arg_name]:
-                text[arg_name]["choices"] = [substitute_variables(c, variables) for c in text[arg_name]["choices"]]
+                text[arg_name]["choices"] = [
+                    substitute_variables(c, variables)
+                    for c in text[arg_name]["choices"]
+                ]
 
             return text
         else:
@@ -88,7 +93,9 @@ def substitute_variables(text: str | dict[str, Any], variables: dict[str, str])
         return PLACEHOLDER_PATTERN.sub(replace_match, text)
 
 
-def substitute_arguments(text: str, args: dict[str, Any], exported_args: set[str] | None = None) -> str:
+def substitute_arguments(
+    text: str, args: dict[str, Any], exported_args: set[str] | None = None
+) -> str:
     """
     Substitute {{ arg.name }} placeholders with argument values.
 
@@ -172,9 +179,7 @@ def substitute_environment(text: str) -> str:
 
         value = os.environ.get(name)
         if value is None:
-            raise ValueError(
-                f"Environment variable '{name}' is not set"
-            )
+            raise ValueError(f"Environment variable '{name}' is not set")
 
         return value
 
@@ -203,6 +208,7 @@ def substitute_builtin_variables(text: str, builtin_vars: dict[str, str]) -> str
     'Root: /home/user/project'
     @athena: 716250e3a71f
     """
+
     def replace_match(match: re.Match) -> str:
         prefix = match.group(1)
         name = match.group(2)
@@ -226,7 +232,7 @@ def substitute_dependency_args(
     template_value: str,
     parent_task_name: str,
     parent_args: dict[str, Any],
-    exported_args: set[str] | None = None
+    exported_args: set[str] | None = None,
 ) -> str:
     """
     Substitute {{ arg.* }} templates in dependency argument values.
@@ -357,6 +363,7 @@ def substitute_dependency_outputs(
     'Deploy dist/app.js'
     @athena: 1e537c8d579c
     """
+
     def replacer(match: re.Match) -> str:
         dep_task_name = match.group(1)
         output_name = match.group(2)
@@ -383,7 +390,11 @@ def substitute_dependency_outputs(
         # Look up the named output
         if output_name not in dep_task._output_map:
             available = list(dep_task._output_map.keys())
-            available_msg = ", ".join(available) if available else "(none - all outputs are anonymous)"
+            available_msg = (
+                ", ".join(available)
+                if available
+                else "(none - all outputs are anonymous)"
+            )
             raise ValueError(
                 f"Task '{current_task_name}' references output '{output_name}' "
                 f"from task '{dep_task_name}', but '{dep_task_name}' has no output named '{output_name}'.\n"
@@ -447,6 +458,7 @@ def substitute_self_references(
     'cp *.txt out/result.txt'
     @athena: 9d997ff08eef
     """
+
     def replacer(match: re.Match) -> str:
         field = match.group(1)  # "inputs" or "outputs"
         identifier = match.group(2)  # name or numeric index

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
         """
@@ -120,7 +127,9 @@ class DateTimeType(click.ParamType):
 
     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
         """
@@ -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.
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tasktree
-Version: 0.0.21
+Version: 0.0.22
 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)
@@ -255,20 +257,19 @@ tasks:
     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 +277,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 +293,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 +301,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 +337,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
 

tasktree-0.0.22.dist-info/RECORD

@@ -0,0 +1,14 @@
+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,,

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,,