stepup 2.2.2__tar.gz → 3.0.0__tar.gz

stepup-3.0.0/.github/requirements-old.txt

@@ -0,0 +1,7 @@
+# Ensure changes to these dependencies are reflected in pyproject.toml
+asyncinotify==4.0.9
+attrs==22.1.0
+parse==1.19.1
+path==16.14.0
+rich==13.0.0
+pyyaml==6.0

stepup-3.0.0/.gitignore

@@ -0,0 +1,29 @@
+# Local dev environment
+.envrc
+.idea
+.local
+tmp
+site/
+venv/
+.venv/
+.ruff_cache
+.pytest_cache
+notes.md
+
+# Python and packaging
+__pycache__
+*.egg-info
+dist
+build
+_version.py
+
+# StepUp Core specifics
+docs/.stepup
+
+# Temporary files
+*.swp
+
+# NodeJS (for markdownlint)
+node_modules/
+package-lock.json
+package.json

stepup-3.0.0/.markdownlint-cli2.jsonc

@@ -0,0 +1,15 @@
+{
+  "config": {
+    "MD013": {
+      "line_length": 100,
+      "heading_line_length": 100,
+      "code_block_line_length": 100
+    },
+    "MD007": { "indent": 4 },
+    "MD033": {
+      "allowed_elements": ["script"]
+    },
+    "MD046": false,
+    "MD052": false
+  }
+}

stepup-3.0.0/.pre-commit-config.yaml

@@ -0,0 +1,41 @@
+repos:
+- repo: https://github.com/pre-commit/pre-commit-hooks
+  rev: v5.0.0
+  hooks:
+    - id: check-added-large-files
+    - id: check-ast
+    - id: check-case-conflict
+    - id: check-executables-have-shebangs
+    - id: check-json
+    - id: check-merge-conflict
+    - id: check-symlinks
+    - id: check-toml
+    - id: check-vcs-permalinks
+    - id: debug-statements
+    - id: detect-private-key
+    - id: destroyed-symlinks
+    - id: end-of-file-fixer
+    - id: fix-byte-order-marker
+    - id: mixed-line-ending
+    - id: pretty-format-json
+      args: ["--autofix", "--no-sort-keys"]
+    - id: trailing-whitespace
+- repo: https://github.com/Lucas-C/pre-commit-hooks
+  rev: v1.5.5
+  hooks:
+    - id: remove-crlf
+- repo: https://github.com/astral-sh/ruff-pre-commit
+  rev: v0.8.4
+  hooks:
+    - id: ruff-format
+    - id: ruff
+      args: ["--fix", "--show-fixes"]
+- repo: https://github.com/DavidAnson/markdownlint-cli2
+  rev: v0.17.2
+  hooks:
+  - id: markdownlint-cli2
+    require_serial: true
+- repo: https://github.com/python-jsonschema/check-jsonschema
+  rev: 0.30.0
+  hooks:
+    - id: check-github-workflows

stepup-3.0.0/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: stepup
+Version: 3.0.0
+Summary: StepUp Core provides the basic framework for the StepUp build tool
+Author-email: Toon Verstraelen <toon.verstraelen@ugent.be>
+Project-URL: Documentation, https://reproducible-reporting.github.io/stepup-core/
+Project-URL: Issues, https://github.com/reproducible-reporting/stepup-core/issues
+Project-URL: Source, https://github.com/reproducible-reporting/stepup-core/
+Project-URL: Changelog, https://reproducible-reporting.github.io/stepup-core/changelog/
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+Classifier: Natural Language :: English
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: asyncinotify>=4.0.9
+Requires-Dist: attrs>=22.1.0
+Requires-Dist: jinja2>=3.1.6
+Requires-Dist: parse>=1.19.1
+Requires-Dist: path>=16.14.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: dev
+Requires-Dist: psutil; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.24; extra == "dev"
+Requires-Dist: pytest-xdist; extra == "dev"
+Requires-Dist: mike; extra == "dev"
+Requires-Dist: mkdocs; extra == "dev"
+Requires-Dist: mkdocstrings[python]; extra == "dev"
+Requires-Dist: mkdocs-macros-plugin; extra == "dev"
+Requires-Dist: mkdocs-material; extra == "dev"
+Requires-Dist: numpy; extra == "dev"
+Requires-Dist: matplotlib; extra == "dev"
+Dynamic: license-file
+
+<!-- markdownlint-disable line-length -->
+
+# StepUp Core
+
+[![release](https://github.com/reproducible-reporting/stepup-core/actions/workflows/release.yaml/badge.svg)](https://github.com/reproducible-reporting/stepup-core/actions/workflows/release.yaml)
+[![pytest](https://github.com/reproducible-reporting/stepup-core/actions/workflows/pytest.yaml/badge.svg)](https://github.com/reproducible-reporting/stepup-core/actions/workflows/pytest.yaml)
+[![mkdocs](https://github.com/reproducible-reporting/stepup-core/actions/workflows/mkdocs.yaml/badge.svg)](https://github.com/reproducible-reporting/stepup-core/actions/workflows/mkdocs.yaml)
+[![PyPI Version](https://img.shields.io/pypi/v/stepup)](https://pypi.org/project/stepup/)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/stepup)
+![GPL-3 License](https://img.shields.io/github/license/reproducible-reporting/stepup-core)
+[![CodeFactor](https://www.codefactor.io/repository/github/reproducible-reporting/stepup-core/badge)](https://www.codefactor.io/repository/github/reproducible-reporting/stepup-core)
+[![DeepSource](https://app.deepsource.com/gh/reproducible-reporting/stepup-core.svg/?label=active+issues&show_trend=true&token=d3ZpZMlD6DRcnEZUOvYwGyPs)](https://app.deepsource.com/gh/reproducible-reporting/stepup-core/)
+
+StepUp is a simple, powerful and universal build tool.
+StepUp Core provides the basic framework for StepUp, without any domain-specific features.
+
+For more information, consult the
+[documentation](http://reproducible-reporting.github.io/stepup-core).

stepup-3.0.0/asciinema/.gitignore

@@ -0,0 +1,2 @@
+*.cast
+!*-markers.cast

stepup-3.0.0/asciinema/README.md

@@ -0,0 +1,87 @@
+# Asciinema Recordings for StepUp
+
+This directory contains autocast inputs for automated Asciinema recordings of the StepUp demos.
+They allow for an easy reproduction and update of the recordings.
+
+Note that Asciinema version 2.x is required for the recordings to work.
+
+## Installation of requirements
+
+1. Install [autocast](https://github.com/k9withabone/autocast)
+
+    ```bash
+    cargo install autocast
+    ```
+
+    Ensure that the `~/.cargo/bin` directory is in your `PATH`.
+
+2. Install [Asciinema](https://asciinema.org/)
+
+    ```bash
+    sudo dnf install asciinema
+    ```
+
+## Recording of the template repository
+
+Create the recording with the following command:
+
+```bash
+./template-runall.sh
+```
+
+Set the thumbnail frame to 5 seconds.
+
+Description for Asciinema recording:
+
+```markdown
+- First, StepUp is started with 4 workers
+  to complete the steps in the RepRep publication template from scratch.
+- After the build has completed, the file `generate.py` is modified,
+  whose output is used in a matplotlib plot created by `plot.py`,
+  whose output is included in a LaTeX document, etc.
+- Stepup sees the changes.
+  As soon as the user presses `r`,
+  StepUp executes the necessary steps to rebuild all artifacts
+  that are (indirectly) affected by the change in `generate.py`.
+- Finally, the user presses `q` to exit StepUp.
+
+See [StepUp RepRep documentation](https://reproducible-reporting.github.io/stepup-reprep/) for more details.
+
+(This recording was created with StepUp Core 3.0.0 and StepUp RepRep 3.0.0)
+```
+
+## Recording of the documentation examples
+
+Create the recording with the following command:
+
+```bash
+./template-runall.sh
+```
+
+Set the thumbnail frame to 5 seconds.
+
+Description for Asciinema:
+
+```markdown
+This a simple example use case to give a quick visual impression of the terminal user interface of StepUp.
+
+See [StepUp Core documentation](https://reproducible-reporting.github.io/stepup-core/) for more details.
+```
+
+## Recording for the interactive tutorial
+
+Create the recording with the following command:
+
+```bash
+./interactive-runall.sh
+```
+
+Set the thumbnail frame to 10 seconds.
+
+Description for Asciinema:
+
+```markdown
+This a simple demonstration of the interactive use of StepUp.
+
+See StepUp Core tutorial [getting_started/interactive_usage/](https://reproducible-reporting.github.io/stepup-core/getting_started/interactive_usage/)
+```

stepup-3.0.0/asciinema/docs-autocast.yaml

@@ -0,0 +1,13 @@
+settings:
+  title: StepUp RepRep 3 Demonstration on the tutorial examples
+  width: 80
+  height: 24
+  shell:
+    program: /usr/bin/sh
+    prompt: "$ "
+    line_split: ' \'
+    quit_command: exit
+
+instructions:
+  - !Command
+    command: stepup boot -n 4

stepup-3.0.0/asciinema/docs-runall.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+
+ASCIINEMA=${PWD}
+DOCS=${PWD}/../docs/
+
+# Go to right location and prepare
+cd $DOCS
+rm -rf .stepup
+
+# Start recording
+autocast ${ASCIINEMA}/docs-autocast.yaml ${ASCIINEMA}/docs.cast --overwrite
+
+cd ${ASCIINEMA}
+
+# Remove trailing prompt
+sed -e :a -e '$d;N;2,3ba' -e 'P;D' -i docs.cast

stepup-3.0.0/asciinema/insert_markers.py

@@ -0,0 +1,29 @@
+#!/usr/bin/env python3
+"""Insert markers into asciinema recordings"""
+
+import argparse
+import json
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Insert markers into asciinema recordings")
+    parser.add_argument("inp_file", help="Input asciinema file")
+    parser.add_argument("marker_file", help="Markers file to insert")
+    parser.add_argument("out_file", help="Output asciinema file")
+    args = parser.parse_args()
+
+    # Load the markers
+    with open(args.marker_file) as fm:
+        markers = [json.loads(line) for line in fm]
+    markers.sort(key=lambda x: x[0])
+
+    with open(args.inp_file) as fi, open(args.out_file, "w") as fo:
+        for line in fi:
+            record = json.loads(line)
+            if len(markers) > 0 and isinstance(record, list) and record[0] > markers[0][0]:
+                print(json.dumps(markers.pop(0)), file=fo)
+            print(line, end="", file=fo)
+
+
+if __name__ == "__main__":
+    main()

stepup-3.0.0/asciinema/interactive-autocast.yaml

@@ -0,0 +1,22 @@
+settings:
+  title: StepUp RepRep 3 Demonstration for the tutorial on interactive use
+  width: 80
+  height: 24
+  shell:
+    program: /usr/bin/sh
+    prompt: "$ "
+    line_split: ' \'
+    quit_command: exit
+
+instructions:
+  - !Interactive
+    command: stepup boot -n 2 -w
+    keys:
+      - 9s
+      - '?'
+      - 5s
+      - r
+      - 9s
+      - r
+      - 3s
+      - q

stepup-3.0.0/asciinema/interactive-markers.cast

@@ -0,0 +1,5 @@
+[7.5, "m", "src/foo.txt is modified"]
+[11.0, "m", "user presses ? = help message"]
+[16.0, "m", "user presses r = run"]
+[22.0, "m", "src/spam.txt is added"]
+[25.5, "m", "user presses r = run"]

stepup-3.0.0/asciinema/interactive-runall.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+
+ASCIINEMA=${PWD}
+TUTORIAL=${PWD}/../docs/getting_started/static_glob/
+
+# Go to right location and prepare
+cd $TUTORIAL
+rm -rf .stepup
+git restore src/
+
+# Change src/foo.txt with 6 second delay
+(sleep 6; echo 'The contents of foo have changed.' > src/foo.txt) &
+
+# Add src/spam.txt with 20 second delay
+(sleep 20; echo 'This is spam!' > src/spam.txt) &
+
+# Start recording
+autocast ${ASCIINEMA}/interactive-autocast.yaml ${ASCIINEMA}/interactive-orig.cast --overwrite
+
+# Undo changes
+git restore src/
+rm src/spam.txt
+
+# Merge with markers
+cd ${ASCIINEMA}
+./insert_markers.py interactive-orig.cast interactive-markers.cast interactive.cast
+
+# Remove trailing prompt
+sed -e :a -e '$d;N;2,3ba' -e 'P;D' -i interactive.cast

stepup-3.0.0/asciinema/template-autocast.yaml

@@ -0,0 +1,18 @@
+settings:
+  title: StepUp RepRep 3 Demonstration on the template repository
+  width: 80
+  height: 24
+  shell:
+    program: /usr/bin/sh
+    prompt: "$ "
+    line_split: ' \'
+    quit_command: exit
+
+instructions:
+  - !Interactive
+    command: stepup boot -n 4 -w
+    keys:
+      - 18s
+      - r
+      - 10s
+      - q

stepup-3.0.0/asciinema/template-markers.cast

@@ -0,0 +1,6 @@
+[10.0, "m", "Build completed"]
+[15.0, "m", "Save new generate.py"]
+[18.0, "m", "User presses ? = help message"]
+[20.0, "m", "User presses r = run"]
+[25.0, "m", "Build completed"]
+[30.0, "m", "User presses q = shutdown"]

stepup-3.0.0/asciinema/template-runall.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+
+ASCIINEMA=${PWD}
+TEMPLATE=${PWD}/../../nobackup/plain-pip/
+
+# Go to right location and prepare
+cd $TEMPLATE
+source .envrc
+cd latest-draft
+rm -rf .stepup
+sed -e 's/x + shift/x - shift/' -i results-example/generate.py
+
+# Change generate.py with 13 second delay
+(sleep 13; sed -e 's/x - shift/x + shift/' -i results-example/generate.py) &
+
+# Start recording
+autocast ${ASCIINEMA}/template-autocast.yaml ${ASCIINEMA}/template-orig.cast --overwrite
+
+# Merge with markers
+cd ${ASCIINEMA}
+./insert_markers.py template-orig.cast template-markers.cast template.cast
+
+# Remove trailing prompt
+sed -e :a -e '$d;N;2,3ba' -e 'P;D' -i template.cast

stepup-3.0.0/docs/advanced_topics/amending_static_inputs/main.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+git clean -qdfX .
+export COLUMNS=80
+unset STEPUP_ROOT
+stepup boot --no-progress -n 1 | sed -f ../../clean_stdout.sed > stdout.txt
+
+# INP: plan.py
+# INP: config.txt

stepup-3.0.0/docs/advanced_topics/amending_static_inputs/stdout.txt

@@ -0,0 +1,12 @@
+  DIRECTOR │ Listening on /tmp/stepup-########/director (StepUp 3.0.0)
+   STARTUP │ (Re)initialized boot script
+  DIRECTOR │ Launched worker 0
+     PHASE │ run
+     START │ runpy ./plan.py
+   SUCCESS │ runpy ./plan.py
+─────────────────────────────── Standard output ────────────────────────────────
+This is a config file.
+────────────────────────────────────────────────────────────────────────────────
+  DIRECTOR │ Trying to delete 0 outdated output(s)
+  DIRECTOR │ Stopping workers
+  DIRECTOR │ See you!

stepup-3.0.0/docs/advanced_topics/amending_static_inputs.md

@@ -0,0 +1,33 @@
+# Amending Static Inputs
+
+Occasionally, it may be convenient to declare a static file and then use it as input in the same script.
+As of StepUp 1.2.0, this is allowed and no longer treated as a cyclic dependency.
+
+## Example
+
+Create the following `plan.py`, which declares a static file, amends it as input,
+and then opens it to print it to the standard output.
+
+```python
+{% include 'advanced_topics/amending_static_inputs/plan.py' %}
+```
+
+Also create a `config.txt` file with some contents.
+
+In more realistic scenarios, `config.txt` may be used to decide which steps to add etc.
+For a more elaborate example, take a look at the
+[`plan.py`](https://github.com/reproducible-reporting/stepup-core/blob/main/docs/plan.py)
+that is used to run all tutorial examples.
+
+Make `plan.py` executable and run it as follows:
+
+```bash
+chmod +x plan.py
+stepup boot -n 1
+```
+
+You should get the following terminal output:
+
+```text
+{% include 'advanced_topics/amending_static_inputs/stdout.txt' %}
+```

stepup-3.0.0/docs/advanced_topics/amending_steps/main.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+git clean -qdfX .
+export COLUMNS=80
+unset STEPUP_ROOT
+stepup boot --no-progress -n 1 | sed -f ../../clean_stdout.sed > stdout.txt
+
+# INP: plan.py
+# INP: step.py

stepup-3.0.0/docs/advanced_topics/amending_steps/plan.py

@@ -0,0 +1,7 @@
+#!/usr/bin/env python3
+from stepup.core.api import runsh, static
+
+static("step.py")
+runsh("./step.py", inp=["step.py", "sources.txt"])
+runsh("echo input.txt > ${out}", out="sources.txt")
+runsh("echo You better read this. > input.txt", out="input.txt", optional=True)

stepup-3.0.0/docs/advanced_topics/amending_steps/stdout.txt

@@ -0,0 +1,26 @@
+  DIRECTOR │ Listening on /tmp/stepup-########/director (StepUp 3.0.0)
+   STARTUP │ (Re)initialized boot script
+  DIRECTOR │ Launched worker 0
+     PHASE │ run
+     START │ runpy ./plan.py
+   SUCCESS │ runpy ./plan.py
+     START │ runsh echo input.txt > sources.txt
+   SUCCESS │ runsh echo input.txt > sources.txt
+     START │ runsh ./step.py
+RESCHEDULE │ runsh ./step.py
+──────────────── Rescheduling due to unavailable amended inputs ────────────────
+Missing inputs and/or required directories:
+input.txt
+────────────────────────────────────────────────────────────────────────────────
+     START │ runsh echo You better read this. > input.txt
+   SUCCESS │ runsh echo You better read this. > input.txt
+     START │ runsh ./step.py
+   SUCCESS │ runsh ./step.py
+─────────────────────────────── Standard output ────────────────────────────────
+Contents of input.txt:
+You better read this.
+────────────────────────────────────────────────────────────────────────────────
+  DIRECTOR │ Trying to delete 0 outdated output(s)
+   WARNING │ Check logs: .stepup/warning.log
+  DIRECTOR │ Stopping workers
+  DIRECTOR │ See you!

stepup-3.0.0/docs/advanced_topics/amending_steps.md

@@ -0,0 +1,97 @@
+# Amending Steps
+
+Every step in StepUp can inform the director process of additional inputs
+or environment variables it uses, or of additional (volatile) outputs it creates.
+However, defining an amended input will fail
+when that file is not yet built nor known as a static file.
+In this case, the step wil exit early
+and will be rescheduled by the director process when the amended input becomes available.
+
+The [`amend()`][stepup.core.api.amend] function implements this feature
+and is convenient in various scenarios:
+
+- This is particularly useful when a step uses input files that refer to other input files.
+  It may happen that some of these other input files still need to be generated by other steps.
+  Once built, the other inputs may again refer to more input files, etc.
+  Such dependencies cannot be discovered in advance,
+  simply because not all inputs are available before running the steps that generate them.
+  (This is a common scenario when writing LaTeX documents of which parts are generated by scripts.)
+
+- Another use case is that some steps may take their default configuration
+  from environment variables if some command-line options are missing.
+  In this case, `amend()` can be used to specify the environment variables used.
+
+- Some steps may produce a list of volatile outputs, some of which are difficult to know upfront.
+  One may specify such volatile outputs with `amend()` after they have been created.
+
+To use `amend()` effectively, use it as early as possible,
+before accessing additional input files or creating unforeseen output files.
+Also, try to amend as many possible step arguments in a single call.
+This will avoid the following problems:
+
+- Trying to read from a file that hasn't been created yet.
+
+- Unintentionally overwriting a file, e.g. a STATIC file that you have written by hand.
+
+- Performing unnecessary work
+  (because a call to amend may mean that the step is interrupted and restarted later).
+  This is particularly important when the step is time-consuming
+  or when it uses `stepup.core.api` functions to extend the workflow.
+
+- Rescheduling a step multiple times.
+
+To the best of our knowledge, there is no equivalent of `amend()` in other build tools.
+Some features in Ninja cover what can be achieved with `amend()`.
+
+## Example
+
+Example source files: [`docs/advanced_topics/amending_steps/`](https://github.com/reproducible-reporting/stepup-core/tree/main/docs/advanced_topics/amending_steps)
+
+This example intentionally creates a simple scenario with an amended input.
+This is a somewhat silly example to illustrate the concept.
+You may achieve the same result without amending,
+because you have full control over all scripts in the example.
+
+Create the following `plan.py`,
+where the first step is a script that will discover it needs an additional input.
+
+```python
+{% include 'advanced_topics/amending_steps/plan.py' %}
+```
+
+In addition, create a file `input.txt`
+with some arbitrary contents and the following `step.py` script:
+
+```python
+{% include 'advanced_topics/amending_steps/step.py' %}
+```
+
+Make the scripts executable and fire up StepUp to see how it deals with the amended input:
+
+```bash
+chmod +x step.py plan.py
+stepup boot -n 1
+```
+
+You should get the following terminal output:
+
+```text
+{% include 'advanced_topics/amending_steps/stdout.txt' %}
+```
+
+The output shows that `./step.py` first stops early due to the missing file `input.txt`.
+Once this required input becomes clear,
+StepUp schedules the optional step to generate the requested input.
+Later, StepUp runs `./step.py` again.
+
+## Try the Following
+
+- Run StepUp again without making any changes.
+  As expected, all steps are skipped.
+  The `.stepup/graph.db` file also stores the amended information,
+  so these don't need to be rediscovered later.
+
+- Modify the `plan.py` file to include a second amended input, for example, `other.txt`.
+  Run StepUp with these changes.
+  Because `sources.txt` contains a new file, StepUp will try re-running
+  `./step.py`, which will amend new inputs that require the step to be rescheduled again.

stepup-3.0.0/docs/advanced_topics/blocked_steps/main.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+git clean -qdfX .
+export COLUMNS=80
+unset STEPUP_ROOT
+stepup boot --no-progress -n 1 | sed -f ../../clean_stdout.sed > stdout.txt
+
+# INP: plan.py

stepup-3.0.0/docs/advanced_topics/blocked_steps/plan.py

@@ -0,0 +1,6 @@
+#!/usr/bin/env python3
+from stepup.core.api import copy, runsh
+
+runsh("echo hello > ${out}", out="a.txt")
+copy("a.txt", "b.txt", block=True)
+copy("b.txt", "c.txt")

stepup-3.0.0/docs/advanced_topics/blocked_steps/stdout.txt

@@ -0,0 +1,16 @@
+  DIRECTOR │ Listening on /tmp/stepup-########/director (StepUp 3.0.0)
+   STARTUP │ (Re)initialized boot script
+  DIRECTOR │ Launched worker 0
+     PHASE │ run
+     START │ runpy ./plan.py
+   SUCCESS │ runpy ./plan.py
+     START │ runsh echo hello > a.txt
+   SUCCESS │ runsh echo hello > a.txt
+   WARNING │ 2 step(s) remained pending due to blocked steps
+──────────────────────────────── Blocked steps ─────────────────────────────────
+step:copy a.txt b.txt
+────────────────────────────────────────────────────────────────────────────────
+   WARNING │ Skipping file cleanup due to incomplete build
+   WARNING │ Check logs: .stepup/warning.log
+  DIRECTOR │ Stopping workers
+  DIRECTOR │ See you!