Python Heredoc

Python Heredoc Pattern

When you need to run Python code via Bash, never use python -c "..." for anything beyond trivial one-liners. Shell quoting breaks with f-strings, apostrophes, nested quotes, and escape sequences.

Use heredoc syntax instead

uv run python << 'PYTHON_CODE'
import json

data = {"name": "it's working", "value": f"{1 + 2}"}
print(json.dumps(data, indent=2))
PYTHON_CODE

The single quotes around 'PYTHON_CODE' prevent shell variable expansion, so $variables and backticks are treated as literal Python code.

With dependencies

uv run --with requests python << 'PYTHON_CODE'
import requests

resp = requests.get("https://api.example.com/data")
print(resp.json())
PYTHON_CODE