fractal-server 2.0.0a2__tar.gz → 2.0.0a4__tar.gz

{fractal_server-2.0.0a2 → fractal_server-2.0.0a4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fractal-server
-Version: 2.0.0a2
+Version: 2.0.0a4
 Summary: Server component of the Fractal analytics platform
 Home-page: https://github.com/fractal-analytics-platform/fractal-server
 License: BSD-3-Clause
@@ -16,21 +16,21 @@ Classifier: Programming Language :: Python :: 3.12
 Provides-Extra: gunicorn
 Provides-Extra: postgres
 Requires-Dist: aiosqlite (>=0.19.0,<0.20.0)
-Requires-Dist: alembic (>=1.9.1,<2.0.0)
+Requires-Dist: alembic (>=1.13.1,<2.0.0)
 Requires-Dist: asyncpg (>=0.29.0,<0.30.0) ; extra == "postgres"
 Requires-Dist: bcrypt (==4.0.1)
-Requires-Dist: cloudpickle (>=2.2.1,<2.3.0)
+Requires-Dist: cloudpickle (>=3.0.0,<3.1.0)
 Requires-Dist: clusterfutures (>=0.5,<0.6)
-Requires-Dist: fastapi (>=0.109.0,<0.110.0)
+Requires-Dist: fastapi (>=0.110.0,<0.111.0)
 Requires-Dist: fastapi-users[oauth] (>=12.1.0,<13.0.0)
 Requires-Dist: gunicorn (>=21.2.0,<22.0.0) ; extra == "gunicorn"
 Requires-Dist: packaging (>=23.2,<24.0)
 Requires-Dist: psycopg2 (>=2.9.5,<3.0.0) ; extra == "postgres"
 Requires-Dist: pydantic (>=1.10.8,<2)
-Requires-Dist: python-dotenv (>=0.21.0,<0.22.0)
+Requires-Dist: python-dotenv (>=1.0.0,<2.0.0)
 Requires-Dist: sqlalchemy[asyncio] (>=2.0.23,<2.1)
-Requires-Dist: sqlmodel (>=0.0.14,<0.0.15)
-Requires-Dist: uvicorn (>=0.27.0,<0.28.0)
+Requires-Dist: sqlmodel (>=0.0.16,<0.0.17)
+Requires-Dist: uvicorn (>=0.29.0,<0.30.0)
 Project-URL: Changelog, https://github.com/fractal-analytics-platform/fractal-server/blob/main/CHANGELOG.md
 Project-URL: Documentation, https://fractal-analytics-platform.github.io/fractal-server
 Project-URL: Repository, https://github.com/fractal-analytics-platform/fractal-server

fractal_server-2.0.0a4/fractal_server/__init__.py

@@ -0,0 +1 @@
+__VERSION__ = "2.0.0a4"

{fractal_server-2.0.0a2 → fractal_server-2.0.0a4}/fractal_server/app/models/v2/dataset.py

@@ -51,5 +51,5 @@ class DatasetV2(SQLModel, table=True):
     )
 
     @property
-    def image_paths(self) -> list[str]:
-        return [image["path"] for image in self.images]
+    def image_zarr_urls(self) -> list[str]:
+        return [image["zarr_url"] for image in self.images]

{fractal_server-2.0.0a2 → fractal_server-2.0.0a4}/fractal_server/app/routes/admin/v2.py

@@ -12,6 +12,7 @@ from fastapi import HTTPException
 from fastapi import Response
 from fastapi import status
 from fastapi.responses import StreamingResponse
+from pydantic import BaseModel
 from sqlmodel import select
 
 from ....config import get_settings
@@ -27,6 +28,7 @@ from ...models.v2 import ProjectV2
 from ...runner.filenames import WORKFLOW_LOG_FILENAME
 from ...schemas.v2 import JobReadV2
 from ...schemas.v2 import JobUpdateV2
+from ...schemas.v2 import ProjectReadV2
 from ...security import current_active_superuser
 from ..aux._job import _write_shutdown_file
 from ..aux._job import _zip_folder_to_byte_stream
@@ -52,6 +54,35 @@ def _convert_to_db_timestamp(dt: datetime) -> datetime:
     return _dt
 
 
+@router_admin_v2.get("/project/", response_model=list[ProjectReadV2])
+async def view_project(
+    id: Optional[int] = None,
+    user_id: Optional[int] = None,
+    user: User = Depends(current_active_superuser),
+    db: AsyncSession = Depends(get_async_db),
+) -> list[ProjectReadV2]:
+    """
+    Query `ProjectV2` table.
+
+    Args:
+        id: If not `None`, select a given `project.id`.
+        user_id: If not `None`, select a given `project.user_id`.
+    """
+
+    stm = select(ProjectV2)
+
+    if id is not None:
+        stm = stm.where(ProjectV2.id == id)
+    if user_id is not None:
+        stm = stm.where(ProjectV2.user_list.any(User.id == user_id))
+
+    res = await db.execute(stm)
+    project_list = res.scalars().all()
+    await db.close()
+
+    return project_list
+
+
 @router_admin_v2.get("/job/", response_model=list[JobReadV2])
 async def view_job(
     id: Optional[int] = None,
@@ -249,13 +280,17 @@ async def download_job_logs(
     )
 
 
+class TaskCompatibility(BaseModel):
+    is_v2_compatible: bool
+
+
 @router_admin_v2.patch(
     "/task-v1/{task_id}/",
     status_code=status.HTTP_200_OK,
 )
 async def flag_task_v1_as_v2_compatible(
     task_id: int,
-    is_v2_compatible: bool,
+    compatibility: TaskCompatibility,
     user: User = Depends(current_active_superuser),
     db: AsyncSession = Depends(get_async_db),
 ) -> Response:
@@ -267,7 +302,7 @@ async def flag_task_v1_as_v2_compatible(
             detail=f"Task {task_id} not found",
         )
 
-    task.is_v2_compatible = is_v2_compatible
+    task.is_v2_compatible = compatibility.is_v2_compatible
     await db.commit()
     await db.close()
 

{fractal_server-2.0.0a2 → fractal_server-2.0.0a4}/fractal_server/app/routes/api/v2/__init__.py

@@ -19,7 +19,7 @@ router_api_v2.include_router(dataset_router_v2, tags=["V2 Dataset"])
 router_api_v2.include_router(job_router_v2, tags=["V2 Job"])
 router_api_v2.include_router(images_routes_v2, tags=["V2 Images"])
 router_api_v2.include_router(project_router_v2, tags=["V2 Project"])
-router_api_v2.include_router(submit_job_router_v2, tags=["V2 Submit Job"])
+router_api_v2.include_router(submit_job_router_v2, tags=["V2 Job"])
 router_api_v2.include_router(task_router_v2, prefix="/task", tags=["V2 Task"])
 router_api_v2.include_router(
     task_collection_router_v2, prefix="/task", tags=["V2 Task Collection"]

{fractal_server-2.0.0a2 → fractal_server-2.0.0a4}/fractal_server/app/routes/api/v2/_aux_functions.py

@@ -8,6 +8,7 @@ from typing import Union
 
 from fastapi import HTTPException
 from fastapi import status
+from sqlalchemy.orm.attributes import flag_modified
 from sqlmodel import select
 from sqlmodel.sql.expression import SelectOfScalar
 
@@ -38,7 +39,6 @@ async def _get_project_check_owner(
         project_id:
         user_id:
         db:
-        version:
 
     Returns:
         The project object
@@ -381,8 +381,8 @@ async def _get_task_check_owner(
 def _get_submitted_jobs_statement() -> SelectOfScalar:
     """
     Returns:
-        A sqlmodel statement that selects all `ApplyWorkflow`s with
-        `ApplyWorkflow.status` equal to `submitted`.
+        A sqlmodel statement that selects all `Job`s with
+        `Job.status` equal to `submitted`.
     """
     stm = select(JobV2).where(JobV2.status == JobStatusTypeV1.SUBMITTED)
     return stm
@@ -405,11 +405,16 @@ async def _workflow_insert_task(
     Insert a new WorkflowTask into Workflow.task_list
 
     Args:
-        task_id: TBD
-        args: TBD
-        meta: TBD
-        order: TBD
-        db: TBD
+        workflow_id:
+        task_id:
+        is_legacy_task:
+        order:
+        meta_parallel:
+        meta_non_parallel:
+        args_non_parallel:
+        args_parallel:
+        input_filters:
+        db:
     """
     db_workflow = await db.get(WorkflowV2, workflow_id)
     if db_workflow is None:
@@ -488,9 +493,9 @@ async def _workflow_insert_task(
         meta_non_parallel=final_meta_non_parallel,
         **input_filters_kwarg,
     )
-    db.add(wf_task)
     db_workflow.task_list.insert(order, wf_task)
     db_workflow.task_list.reorder()  # type: ignore
+    flag_modified(db_workflow, "task_list")
     await db.commit()
     await db.refresh(wf_task)
 

{fractal_server-2.0.0a2 → fractal_server-2.0.0a4}/fractal_server/app/routes/api/v2/dataset.py

@@ -186,7 +186,6 @@ async def delete_dataset(
     jobs = res.scalars().all()
     for job in jobs:
         job.dataset_id = None
-    await db.commit()
 
     # Delete dataset
     await db.delete(dataset)

{fractal_server-2.0.0a2 → fractal_server-2.0.0a4}/fractal_server/app/routes/api/v2/images.py

@@ -35,7 +35,7 @@ class ImagePage(BaseModel):
 
 
 class ImageQuery(BaseModel):
-    path: Optional[str]
+    zarr_url: Optional[str]
     filters: Filters = Field(default_factory=Filters)
 
 
@@ -56,11 +56,11 @@ async def post_new_image(
     )
     dataset = output["dataset"]
 
-    if new_image.path in dataset.image_paths:
+    if new_image.zarr_url in dataset.image_zarr_urls:
         raise HTTPException(
             status_code=status.HTTP_422_UNPROCESSABLE_ENTITY,
             detail=(
-                f"Image with path '{new_image.path}' "
+                f"Image with zarr_url '{new_image.zarr_url}' "
                 f"already in DatasetV2 {dataset_id}",
             ),
         )
@@ -121,9 +121,13 @@ async def query_dataset_images(
 
     if query is not None:
 
-        if query.path is not None:
+        if query.zarr_url is not None:
             image = next(
-                (image for image in images if image["path"] == query.path),
+                (
+                    image
+                    for image in images
+                    if image["zarr_url"] == query.zarr_url
+                ),
                 None,
             )
             if image is None:
@@ -180,7 +184,7 @@ async def query_dataset_images(
 async def delete_dataset_images(
     project_id: int,
     dataset_id: int,
-    path: str,
+    zarr_url: str,
     user: User = Depends(current_active_user),
     db: AsyncSession = Depends(get_async_db),
 ) -> Response:
@@ -191,12 +195,16 @@ async def delete_dataset_images(
     dataset = output["dataset"]
 
     image_to_remove = next(
-        (image for image in dataset.images if image["path"] == path), None
+        (image for image in dataset.images if image["zarr_url"] == zarr_url),
+        None,
     )
     if image_to_remove is None:
         raise HTTPException(
             status_code=status.HTTP_404_NOT_FOUND,
-            detail=f"No image with path '{path}' in DatasetV2 {dataset_id}.",
+            detail=(
+                f"No image with zarr_url '{zarr_url}' in "
+                f"DatasetV2 {dataset_id}."
+            ),
         )
 
     dataset.images.remove(image_to_remove)

{fractal_server-2.0.0a2 → fractal_server-2.0.0a4}/fractal_server/app/routes/api/v2/project.py

@@ -169,7 +169,6 @@ async def delete_project(
             job.workflow_id = None
         # Delete workflow
         await db.delete(wf)
-    await db.commit()
 
     # Dataset
     stm = select(DatasetV2).where(DatasetV2.project_id == project_id)
@@ -185,7 +184,6 @@ async def delete_project(
             job.dataset_id = None
         # Delete dataset
         await db.delete(ds)
-    await db.commit()
 
     # Job
     stm = select(JobV2).where(JobV2.project_id == project_id)
@@ -194,8 +192,6 @@ async def delete_project(
     for job in jobs:
         job.project_id = None
 
-    await db.commit()
-
     await db.delete(project)
     await db.commit()
 

{fractal_server-2.0.0a2 → fractal_server-2.0.0a4}/fractal_server/app/routes/api/v2/submit.py

@@ -148,7 +148,7 @@ async def apply_workflow(
         if len(user.slurm_accounts) > 0:
             job_create.slurm_account = user.slurm_accounts[0]
 
-    # Add new ApplyWorkflow object to DB
+    # Add new Job object to DB
     job = JobV2(
         project_id=project_id,
         dataset_id=dataset_id,
@@ -192,9 +192,8 @@ async def apply_workflow(
         raise HTTPException(
             status_code=status.HTTP_429_TOO_MANY_REQUESTS,
             detail=(
-                f"The endpoint 'POST /api/v2/project/{project_id}/workflow/"
-                f"{workflow_id}/apply/' "
-                "was called several times within an interval of less "
+                f"The endpoint 'POST /api/v2/project/{project_id}/job/submit/'"
+                " was called several times within an interval of less "
                 f"than {settings.FRACTAL_API_SUBMIT_RATE_LIMIT} seconds, using"
                 " the same foreign keys. If it was intentional, please wait "
                 "and try again."

{fractal_server-2.0.0a2 → fractal_server-2.0.0a4}/fractal_server/app/routes/api/v2/workflow.py

@@ -16,7 +16,6 @@ from ....models.v2 import JobV2
 from ....models.v2 import ProjectV2
 from ....models.v2 import TaskV2
 from ....models.v2 import WorkflowV2
-from ....schemas.v1 import WorkflowTaskCreateV1
 from ....schemas.v2 import WorkflowCreateV2
 from ....schemas.v2 import WorkflowExportV2
 from ....schemas.v2 import WorkflowImportV2
@@ -213,7 +212,6 @@ async def delete_workflow(
     jobs = res.scalars().all()
     for job in jobs:
         job.workflow_id = None
-    await db.commit()
 
     # Delete workflow
     await db.delete(workflow)
@@ -341,40 +339,25 @@ async def import_workflow(
     await db.refresh(db_workflow)
 
     # Insert tasks
-    async with db:  # FIXME why?
-
-        for wf_task in workflow.task_list:
-            if wf_task.is_legacy_task is True:
-                # Identify task_id
-                source = wf_task.task_legacy.source
-                task_id = source_to_id_legacy[source]
-                # Prepare new_wf_task
-                new_wf_task = WorkflowTaskCreateV1(
-                    **wf_task.dict(exclude_none=True)
-                )
-                # Insert task
-                await _workflow_insert_task(
-                    **new_wf_task.dict(),
-                    is_legacy_task=True,
-                    workflow_id=db_workflow.id,
-                    task_id=task_id,
-                    db=db,
-                )
-            else:
-                # Identify task_id
-                source = wf_task.task.source
-                task_id = source_to_id[source]
-                # Prepare new_wf_task
-                new_wf_task = WorkflowTaskCreateV2(
-                    **wf_task.dict(exclude_none=True)
-                )
-                # Insert task
-                await _workflow_insert_task(
-                    **new_wf_task.dict(),
-                    workflow_id=db_workflow.id,
-                    task_id=task_id,
-                    db=db,
-                )
+
+    for wf_task in workflow.task_list:
+        if wf_task.is_legacy_task is True:
+            source = wf_task.task_legacy.source
+            task_id = source_to_id_legacy[source]
+        else:
+            source = wf_task.task.source
+            task_id = source_to_id[source]
+
+        new_wf_task = WorkflowTaskCreateV2(
+            **wf_task.dict(exclude_none=True, exclude={"task", "task_legacy"})
+        )
+        # Insert task
+        await _workflow_insert_task(
+            **new_wf_task.dict(),
+            workflow_id=db_workflow.id,
+            task_id=task_id,
+            db=db,
+        )
 
     await db.close()
     return db_workflow

{fractal_server-2.0.0a2 → fractal_server-2.0.0a4}/fractal_server/app/routes/api/v2/workflowtask.py

@@ -91,19 +91,18 @@ async def create_workflowtask(
                 ),
             )
 
-    async with db:
-        workflow_task = await _workflow_insert_task(
-            workflow_id=workflow.id,
-            is_legacy_task=new_task.is_legacy_task,
-            task_id=task_id,
-            order=new_task.order,
-            meta_non_parallel=new_task.meta_non_parallel,
-            meta_parallel=new_task.meta_parallel,
-            args_non_parallel=new_task.args_non_parallel,
-            args_parallel=new_task.args_parallel,
-            input_filters=new_task.input_filters,
-            db=db,
-        )
+    workflow_task = await _workflow_insert_task(
+        workflow_id=workflow.id,
+        is_legacy_task=new_task.is_legacy_task,
+        task_id=task_id,
+        order=new_task.order,
+        meta_non_parallel=new_task.meta_non_parallel,
+        meta_parallel=new_task.meta_parallel,
+        args_non_parallel=new_task.args_non_parallel,
+        args_parallel=new_task.args_parallel,
+        input_filters=new_task.input_filters,
+        db=db,
+    )
 
     await db.close()
 
@@ -212,17 +211,8 @@ async def update_workflowtask(
             if not actual_args:
                 actual_args = None
             setattr(db_wf_task, key, actual_args)
-        elif key == "meta_parallel":
-            current_meta_parallel = deepcopy(db_wf_task.meta_parallel) or {}
-            current_meta_parallel.update(value)
-            setattr(db_wf_task, key, current_meta_parallel)
-        elif key == "meta_non_parallel":
-            current_meta_non_parallel = (
-                deepcopy(db_wf_task.meta_non_parallel) or {}
-            )
-            current_meta_non_parallel.update(value)
-            setattr(db_wf_task, key, current_meta_non_parallel)
-        # FIXME handle `input_filters`
+        elif key in ["meta_parallel", "meta_non_parallel", "input_filters"]:
+            setattr(db_wf_task, key, value)
         else:
             raise HTTPException(
                 status_code=status.HTTP_422_UNPROCESSABLE_ENTITY,

{fractal_server-2.0.0a2 → fractal_server-2.0.0a4}/fractal_server/app/runner/executors/slurm/executor.py

@@ -417,8 +417,6 @@ class FractalSlurmExecutor(SlurmExecutor):
                 A `TaskFiles` object; if `None`, use
                 `self.get_default_task_files()`.
 
-        Returns:
-            An iterator of results.
         """
 
         def _result_or_cancel(fut):

{fractal_server-2.0.0a2 → fractal_server-2.0.0a4}/fractal_server/app/runner/v1/_local/__init__.py

@@ -49,7 +49,8 @@ def _process_workflow(
 
     Schedules the workflow using a `FractalThreadPoolExecutor`.
 
-    Cf. [process_workflow][fractal_server.app.runner._local.process_workflow]
+    Cf.
+    [process_workflow][fractal_server.app.runner.v1._local.process_workflow]
     for the call signature.
     """
 

{fractal_server-2.0.0a2 → fractal_server-2.0.0a4}/fractal_server/app/runner/v1/_slurm/__init__.py

@@ -66,7 +66,8 @@ def _process_workflow(
     workflow working dir and user to impersonate. It then schedules the
     workflow tasks and returns the output dataset metadata.
 
-    Cf. [process_workflow][fractal_server.app.runner._local.process_workflow]
+    Cf.
+    [process_workflow][fractal_server.app.runner.v1._local.process_workflow]
 
     Returns:
         output_dataset_metadata: Metadata of the output dataset
@@ -132,7 +133,8 @@ async def process_workflow(
     """
     Process workflow (SLURM backend public interface)
 
-    Cf. [process_workflow][fractal_server.app.runner._local.process_workflow]
+    Cf.
+    [process_workflow][fractal_server.app.runner.v1._local.process_workflow]
     """
 
     # Set values of first_task_index and last_task_index

{fractal_server-2.0.0a2 → fractal_server-2.0.0a4}/fractal_server/app/runner/v1/_slurm/_submit_setup.py

@@ -12,7 +12,7 @@
 """
 Submodule to define _slurm_submit_setup, which is also the reference
 implementation of `submit_setup_call` in
-[fractal_server.app.runner._common][]).
+[fractal_server.app.runner.v1._common][]).
 """
 from pathlib import Path
 
@@ -38,7 +38,7 @@ def _slurm_submit_setup(
 
     For now, this is the reference implementation for the argument
     `submit_setup_call` of
-    [fractal_server.app.runner._common.execute_tasks][].
+    [fractal_server.app.runner.v1._common.execute_tasks][].
 
     Arguments:
         wftask:

{fractal_server-2.0.0a2 → fractal_server-2.0.0a4}/fractal_server/app/runner/v2/__init__.py

@@ -248,7 +248,7 @@ async def submit_workflow(
             job,
             dataset,
             workflow,
-            logger,
+            logger_name=logger_name,
             failed_wftask=failed_wftask,
         )
         latest_filters = assemble_filters_failed_job(job)
@@ -283,7 +283,7 @@ async def submit_workflow(
             job,
             dataset,
             workflow,
-            logger,
+            logger_name=logger_name,
         )
         latest_filters = assemble_filters_failed_job(job)
         if latest_filters is not None:
@@ -313,7 +313,7 @@ async def submit_workflow(
             job,
             dataset,
             workflow,
-            logger,
+            logger_name=logger_name,
         )
         latest_filters = assemble_filters_failed_job(job)
         if latest_filters is not None:

{fractal_server-2.0.0a2 → fractal_server-2.0.0a4}/fractal_server/app/runner/v2/_local/__init__.py

@@ -45,7 +45,8 @@ def _process_workflow(
 
     Schedules the workflow using a `FractalThreadPoolExecutor`.
 
-    Cf. [process_workflow][fractal_server.app.runner._local.process_workflow]
+    Cf.
+    [process_workflow][fractal_server.app.runner.v2._local.process_workflow]
     for the call signature.
     """
 
@@ -91,21 +92,21 @@ async def process_workflow(
     Args:
         workflow:
             The workflow to be run
-        input_paths:
-            The paths to the input files to pass to the first task of the
-            workflow
-        output_path:
-            The destination path for the last task of the workflow
-        input_metadata:
-            Initial metadata, passed to the first task
-        logger_name:
-            Name of the logger to log information on the run to
+        dataset:
+            Initial dataset.
         workflow_dir:
             Working directory for this run.
         workflow_dir_user:
             Working directory for this run, on the user side. This argument is
             present for compatibility with the standard backend interface, but
             for the `local` backend it cannot be different from `workflow_dir`.
+        first_task_index:
+            Positional index of the first task to execute; if `None`, start
+            from `0`.
+        last_task_index:
+            Positional index of the last task to execute; if `None`, proceed
+            until the last task.
+        logger_name: Logger name
         slurm_user:
             Username to impersonate to run the workflow. This argument is
             present for compatibility with the standard backend interface, but
@@ -123,12 +124,6 @@ async def process_workflow(
             to the backend executor. This argument is present for compatibility
             with the standard backend interface, but is ignored in the `local`
             backend.
-        first_task_index:
-            Positional index of the first task to execute; if `None`, start
-            from `0`.
-        last_task_index:
-            Positional index of the last task to execute; if `None`, proceed
-            until the last task.
 
     Raises:
         TaskExecutionError: wrapper for errors raised during tasks' execution

{fractal_server-2.0.0a2 → fractal_server-2.0.0a4}/fractal_server/app/runner/v2/_slurm/__init__.py

@@ -56,7 +56,8 @@ def _process_workflow(
     workflow working dir and user to impersonate. It then schedules the
     workflow tasks and returns the new dataset attributes
 
-    Cf. [process_workflow][fractal_server.app.runner._local.process_workflow]
+    Cf.
+    [process_workflow][fractal_server.app.runner.v2._local.process_workflow]
 
     Returns:
         new_dataset_attributes:
@@ -112,7 +113,8 @@ async def process_workflow(
     """
     Process workflow (SLURM backend public interface)
 
-    Cf. [process_workflow][fractal_server.app.runner._local.process_workflow]
+    Cf.
+    [process_workflow][fractal_server.app.runner.v2._local.process_workflow]
     """
 
     # Set values of first_task_index and last_task_index

{fractal_server-2.0.0a2 → fractal_server-2.0.0a4}/fractal_server/app/runner/v2/_slurm/_submit_setup.py

@@ -11,8 +11,7 @@
 # Zurich.
 """
 Submodule to define _slurm_submit_setup, which is also the reference
-implementation of `submit_setup_call` in
-[fractal_server.app.runner._common][]).
+implementation of `submit_setup_call`.
 """
 from pathlib import Path
 from typing import Literal
@@ -40,7 +39,7 @@ def _slurm_submit_setup(
 
     For now, this is the reference implementation for the argument
     `submit_setup_call` of
-    [fractal_server.app.runner._common.execute_tasks][].
+    [fractal_server.app.runner.v2.runner][].
 
     Arguments:
         wftask: