dump_project.sh

#!/bin/bash

# dump_project.sh – project source dump utility
#
# Usage:
#   ./dump_project.sh                      # dump entire project source tree
#   ./dump_project.sh src                  # dump only src/
#   ./dump_project.sh include              # dump only include/
#   ./dump_project.sh src/app              # dump only src/app/
#   ./dump_project.sh src/http include/http  # dump multiple subtrees
#   ./dump_project.sh --help               # show this help
#
# Vendored / generated paths are always excluded:
#   build/  .git/  include/httplib/  cxxopts.hpp  httplib.h  json.hpp

set -euo pipefail

OUT="project_dump.txt"

# ── help ──────────────────────────────────────────────────────────────────────
if [[ "${1:-}" == "--help" || "${1:-}" == "-h" ]]; then
    sed -n '3,14p' "$0" | sed 's/^# \{0,1\}//'
    exit 0
fi

# ── extension filter ──────────────────────────────────────────────────────────
INCLUDE_EXT=("*.cpp" "*.hpp" "*.h" "*.c" "*.js" "*.html" "Makefile")

FIND_EXPR=()
for ext in "${INCLUDE_EXT[@]}"; do
    FIND_EXPR+=( -name "$ext" -o )
done
unset 'FIND_EXPR[${#FIND_EXPR[@]}-1]'

# ── path validation ───────────────────────────────────────────────────────────
SEARCH_ROOTS=()
if [[ $# -eq 0 ]]; then
    SEARCH_ROOTS=(".")
else
    for arg in "$@"; do
        # Normalize: strip trailing slash so -path pruning stays consistent
        arg="${arg%/}"
            if [[ ! -e "$arg" ]]; then
                echo "Error: path does not exist: '$arg'" >&2
                exit 1
            fi
        SEARCH_ROOTS+=("$arg")
    done
fi

# ── build output ──────────────────────────────────────────────────────────────
: > "$OUT"

echo "=== PROJECT DUMP ===" >> "$OUT"
echo "DATE: $(date)" >> "$OUT"
echo "" >> "$OUT"

# ── collect & dump files ─────────────────────────────────────────────────────
find "${SEARCH_ROOTS[@]}" \
    -type d \( \
        -name build -o \
        -name .git -o \
        -name third_party \
    \) -prune -o \
    -type f \( "${FIND_EXPR[@]}" \) \
    -print0 \
| sort -z \
| while IFS= read -r -d '' file; do
    echo "===== FILE: $file =====" >> "$OUT"
    cat "$file" >> "$OUT"
    printf "\n\n" >> "$OUT"
done

echo "Dump created: $OUT"