cook-build 0.6.2__py3-none-any.whl → 0.6.3__py3-none-any.whl

cook/contexts.py

@@ -33,7 +33,8 @@ Custom contexts can be implemented by inheriting from :class:`.Context` and impl
 from __future__ import annotations
 from pathlib import Path
 from types import ModuleType
-from typing import Callable, TYPE_CHECKING
+from typing import Callable, TYPE_CHECKING, TypeVar
+import warnings
 from . import actions
 from . import manager as manager_
 from . import task as task_
@@ -44,6 +45,8 @@ if TYPE_CHECKING:
     from .manager import Manager
     from .task import Task
 
+ContextT = TypeVar("ContextT", bound="Context")
+
 
 class Context:
     """
@@ -56,7 +59,7 @@ class Context:
     def __init__(self, manager: "Manager | None" = None) -> None:
         self.manager = manager or manager_.Manager.get_instance()
 
-    def __enter__(self) -> Context:
+    def __enter__(self: ContextT) -> ContextT:
         self.manager.contexts.append(self)
         return self
 
@@ -214,10 +217,21 @@ class normalize_dependencies(Context):
         task_dependencies = task.task_dependencies
         for dependency in task.dependencies:
             if isinstance(dependency, (task_.Task, create_group)):
-                task_dependencies.append(dependency)  # pyright: ignore[reportArgumentType]
+                warnings.warn(
+                    "Passing Task objects to 'dependencies' is deprecated. Use "
+                    "'task_dependencies' instead.",
+                    DeprecationWarning,
+                    stacklevel=4,
+                )
+                task_dependencies.append(dependency)
             else:
                 dependencies.append(dependency)
-        task.dependencies = [Path(x) for x in dependencies]  # pyright: ignore[reportAttributeAccessIssue]
+        # Convert all remaining dependencies (strings) to Path objects.
+        # After normalization, dependencies list contains only Path objects, but the
+        # Task.dependencies attribute is typed as list[PathOrStr | Task] to accept broader
+        # input before normalization. The isinstance checks in controller.py and manager.py
+        # validate this assumption at runtime.
+        task.dependencies = [Path(x) for x in dependencies]  # type: ignore[assignment]
 
         # Unpack group dependencies and look up tasks by name.
         task_dependencies = []

cook/controller.py

@@ -109,6 +109,12 @@ class Controller:
         """
         dependencies = []
         for dependency in task.dependencies:
+            # Dependencies should be Path or str after normalize_dependencies runs.
+            # Tasks should have been moved to task_dependencies.
+            assert isinstance(dependency, (Path, str)), (
+                f"Unexpected dependency type '{type(dependency)}'. Dependencies "
+                "should be 'Path' or 'str' after 'normalize_dependencies'."
+            )
             dependency = Path(dependency).resolve()
             if not dependency.is_file():
                 LOGGER.debug("dependency %s of %s is missing", dependency, task)

cook/manager.py

@@ -96,8 +96,14 @@ class Manager:
                         f"tasks {task} and {other} both have target {path}"
                     )
                 task_by_target[path] = task
-            for path in task.dependencies:
-                path = Path(path).resolve()
+            for dependency in task.dependencies:
+                # Dependencies should be Path or str after normalize_dependencies runs.
+                # Tasks should have been moved to task_dependencies.
+                assert isinstance(dependency, (Path, str)), (
+                    f"Unexpected dependency type '{type(dependency)}'. Dependencies "
+                    "should be 'Path' or 'str' after 'normalize_dependencies'."
+                )
+                path = Path(dependency).resolve()
                 tasks_by_file_dependency.setdefault(path, set()).add(task)
 
         # Build a directed graph of dependencies based on files produced and consumed by tasks.
@@ -132,8 +138,8 @@ def create_task(
     name: str,
     *,
     action: "Action | str | None" = None,
-    targets: list["Path"] | None = None,
-    dependencies: list["Path"] | None = None,
+    targets: list["Path | str"] | None = None,
+    dependencies: list["Path | str | Task"] | None = None,
     task_dependencies: list["Task"] | None = None,
     location: tuple[str, int] | None = None,
 ) -> "Task":

cook/task.py

@@ -19,7 +19,7 @@ class Task:
         self,
         name: str,
         *,
-        dependencies: list["PathOrStr"] | None = None,
+        dependencies: list["PathOrStr | Task"] | None = None,
         targets: list["PathOrStr"] | None = None,
         action: Action | None = None,
         task_dependencies: list[Task] | None = None,

{cook_build-0.6.2.dist-info → cook_build-0.6.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cook-build
-Version: 0.6.2
+Version: 0.6.3
 Summary: A task-centric build system with simple declarative recipes specified in Python
 Author: Till Hoffmann
 License: BSD-3-Clause

cook_build-0.6.3.dist-info/RECORD

@@ -0,0 +1,14 @@
+cook/__init__.py,sha256=uNRvyxT6-XuoAMdDujWYa_4ZW0ppAiom6tsxMovZ-A0,180
+cook/__main__.py,sha256=jcXYDWbMkRU24ZrrAZGrsT2wQ7nhimpigrPjfrMsRtk,12925
+cook/actions.py,sha256=erjjDKC45kQpv_Qb2V3OCGvrrphka4Ytj78RPEvs8Uc,6718
+cook/contexts.py,sha256=e3bddOaR8OLhPh38-U5b-u9D83NXlbQU0Hn7UvYaITI,10717
+cook/controller.py,sha256=z20sKMzCG-wJziMIn3XeDmmvu7IUogx-iDI4sGSrwzs,16132
+cook/manager.py,sha256=FAy8CKIMOx5liYNnaDTgnC5YZm1aqWy3pCIGiP8Hv2w,6118
+cook/task.py,sha256=ioPuQ8jp09BY9VhKn2cC6Q8G17W-1e4q4kj2GD4Zs8k,1388
+cook/util.py,sha256=hpMxxHnmJRfCUUAzkwMQU4kF_JAcEBFVpvPsHxOOY2U,2681
+cook_build-0.6.3.dist-info/licenses/LICENSE,sha256=3Nuj_WTTcz7JDg4-9EzNf6vHlKRWpdLUccg-pvoZ3WE,1500
+cook_build-0.6.3.dist-info/METADATA,sha256=RMt42OtLjrg1Z4iUvFvD1oRv2TMj-_mpQM_kD9LczMk,4586
+cook_build-0.6.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+cook_build-0.6.3.dist-info/entry_points.txt,sha256=5UP0ZmmxSNKevTVISUJxmdXEQsKrI4n54OQYkjrdX2c,48
+cook_build-0.6.3.dist-info/top_level.txt,sha256=ewNQIn2oRSYV98vAsUnw88u2Q8XHKhAz70ed2PEdR2c,5
+cook_build-0.6.3.dist-info/RECORD,,

cook_build-0.6.2.dist-info/RECORD

@@ -1,14 +0,0 @@
-cook/__init__.py,sha256=uNRvyxT6-XuoAMdDujWYa_4ZW0ppAiom6tsxMovZ-A0,180
-cook/__main__.py,sha256=jcXYDWbMkRU24ZrrAZGrsT2wQ7nhimpigrPjfrMsRtk,12925
-cook/actions.py,sha256=erjjDKC45kQpv_Qb2V3OCGvrrphka4Ytj78RPEvs8Uc,6718
-cook/contexts.py,sha256=Gw2zfiyVFaJ5p2vAFrFJEQ4f521GznueM2Y2ddiG3iE,10047
-cook/controller.py,sha256=BYsYxPqEWDwYLAG7-cHzzTuqIvFunGGSge1XAbDk9xs,15753
-cook/manager.py,sha256=vt-PoZ8IOmPIGbe9xeqUrZ4VJf2Gj5KucwjQzc5YUZ4,5684
-cook/task.py,sha256=0OGzVKKezo8x6nX80OpLnGsqCG8mIE7oUaBgSqv3m0M,1381
-cook/util.py,sha256=hpMxxHnmJRfCUUAzkwMQU4kF_JAcEBFVpvPsHxOOY2U,2681
-cook_build-0.6.2.dist-info/licenses/LICENSE,sha256=3Nuj_WTTcz7JDg4-9EzNf6vHlKRWpdLUccg-pvoZ3WE,1500
-cook_build-0.6.2.dist-info/METADATA,sha256=0H6_FzoAJ-Qi2zM4TnHsQO99iiD0msxHdKRiN0M9nVw,4586
-cook_build-0.6.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-cook_build-0.6.2.dist-info/entry_points.txt,sha256=5UP0ZmmxSNKevTVISUJxmdXEQsKrI4n54OQYkjrdX2c,48
-cook_build-0.6.2.dist-info/top_level.txt,sha256=ewNQIn2oRSYV98vAsUnw88u2Q8XHKhAz70ed2PEdR2c,5
-cook_build-0.6.2.dist-info/RECORD,,