Understanding Heredoc File Creation in Bash

Understanding the “Heredoc” File Creation

The command used to create this file is a Heredoc (short for “here document”). It allows you to redirect multiple lines of text into a file directly from the terminal.

Example Usage

cat << 'EOF' > main.py
# This script prints a simple greeting and the current Python version
import sys

def main():
    # Use a formatted string for a clean output
    print("Hello! This file was created using a Heredoc.")
    print(f"Running on Python version: {sys.version}")

if __name__ == "__main__":
    main()
EOF

Breaking Down the Command

• cat << 'EOF' > main.py:
  • cat: Reads the input
  • << 'EOF': Tells the shell to keep reading until it sees the word EOF
    • The single quotes around 'EOF' are important: they tell the shell to treat the text literally, preventing it from accidentally trying to expand shell variables inside your code
  • > main.py: Sends all that text into a new file named main.py

Why Use Heredocs?

Heredocs are perfect for:

• Creating multi-line configuration files
• Writing scripts directly from the terminal
• Embedding code snippets in shell scripts
• Generating files with complex content

The literal quoting (single quotes around the delimiter) is especially useful when writing code that contains variables or special characters you don’t want the shell to interpret.