Function _resolve_server_process_stdio

libs/arcade-cli/arcade_cli/deploy.py:414–437

Choose stdout/stderr targets for the temporary validation server process. ``arcade deploy`` starts a short-lived child server to validate the entrypoint before uploading. The child's stdout/stderr must be handled carefully: * **Normal mode** (``debug=False``): the CLI doesn't disp

(debug: bool)

    byte_stream = io.BytesIO()
    with tarfile.open(fileobj=byte_stream, mode="w:gz") as tar:
        tar.add(package_dir, arcname=package_dir.name, filter=exclude_filter)

    # Get bytes and encode to base64
    byte_stream.seek(0)
    package_bytes = byte_stream.read()
    package_bytes_b64 = base64.b64encode(package_bytes).decode("utf-8")

    return package_bytes_b64


def _resolve_server_process_stdio(debug: bool) -> tuple[int | None, int | None]:
    """Choose stdout/stderr targets for the temporary validation server process.

    ``arcade deploy`` starts a short-lived child server to validate the
    entrypoint before uploading.  The child's stdout/stderr must be handled
    carefully:

    * **Normal mode** (``debug=False``): the CLI doesn't display child output,
      so both streams are sent to ``subprocess.DEVNULL``.  This prevents a
      chatty child from filling the OS pipe buffer and blocking — which
      manifests as intermittent health-check timeouts, especially on Windows
      where the default pipe buffer is only 4 KiB.
    * **Debug mode** (``debug=True``): both streams are inherited from the
      parent process (``None``), so the user sees live startup logs in their
      terminal for troubleshooting.

    Returns: