Dotfiles update 2025-12-25 15:45
This commit is contained in:
Aaron D. Lee
300
bin/dotfiles-profile.sh
Executable file
300
bin/dotfiles-profile.sh
Executable file
@@ -0,0 +1,300 @@
|
||||
#!/usr/bin/env bash
|
||||
# ============================================================================
|
||||
# Dotfiles Startup Profiler
|
||||
# ============================================================================
|
||||
# Measures and analyzes shell startup time to identify slow components.
|
||||
#
|
||||
# Usage:
|
||||
# dotfiles-profile.sh # Quick profile
|
||||
# dotfiles-profile.sh --detailed # Detailed zprof output
|
||||
# dotfiles-profile.sh --benchmark # Multiple runs with hyperfine
|
||||
# dotfiles-profile.sh --compare # Compare with minimal shell
|
||||
# ============================================================================
|
||||
|
||||
set -e
|
||||
|
||||
# Source bootstrap
|
||||
source "${DOTFILES_HOME:-$HOME/.dotfiles}/zsh/lib/bootstrap.zsh" 2>/dev/null || {
|
||||
DF_GREEN=$'\033[0;32m' DF_YELLOW=$'\033[1;33m' DF_RED=$'\033[0;31m'
|
||||
DF_CYAN=$'\033[0;36m' DF_BLUE=$'\033[0;34m' DF_NC=$'\033[0m'
|
||||
DF_DIM=$'\033[2m'
|
||||
df_print_header() { echo "=== $1 ==="; }
|
||||
df_print_success() { echo -e "${DF_GREEN}✓${DF_NC} $1"; }
|
||||
df_print_warning() { echo -e "${DF_YELLOW}⚠${DF_NC} $1"; }
|
||||
df_print_step() { echo -e "${DF_BLUE}==>${DF_NC} $1"; }
|
||||
df_print_section() { echo -e "${DF_CYAN}$1:${DF_NC}"; }
|
||||
df_print_indent() { echo " $1"; }
|
||||
}
|
||||
|
||||
# ============================================================================
|
||||
# Configuration
|
||||
# ============================================================================
|
||||
|
||||
PROFILE_RUNS=5
|
||||
SLOW_THRESHOLD_MS=200
|
||||
VERY_SLOW_THRESHOLD_MS=500
|
||||
|
||||
# ============================================================================
|
||||
# Profiling Functions
|
||||
# ============================================================================
|
||||
|
||||
# Quick timing measurement
|
||||
quick_profile() {
|
||||
df_print_section "Quick Startup Timing"
|
||||
echo ""
|
||||
|
||||
local times=()
|
||||
for i in $(seq 1 $PROFILE_RUNS); do
|
||||
local start=$(date +%s%3N)
|
||||
zsh -i -c 'exit' 2>/dev/null
|
||||
local end=$(date +%s%3N)
|
||||
local duration=$((end - start))
|
||||
times+=($duration)
|
||||
printf " Run %d: ${DF_CYAN}%dms${DF_NC}\n" "$i" "$duration"
|
||||
done
|
||||
|
||||
# Calculate average
|
||||
local sum=0
|
||||
for t in "${times[@]}"; do
|
||||
sum=$((sum + t))
|
||||
done
|
||||
local avg=$((sum / PROFILE_RUNS))
|
||||
|
||||
echo ""
|
||||
df_print_section "Results"
|
||||
|
||||
if (( avg < SLOW_THRESHOLD_MS )); then
|
||||
df_print_indent "Average: ${DF_GREEN}${avg}ms${DF_NC} (excellent)"
|
||||
elif (( avg < VERY_SLOW_THRESHOLD_MS )); then
|
||||
df_print_indent "Average: ${DF_YELLOW}${avg}ms${DF_NC} (acceptable)"
|
||||
else
|
||||
df_print_indent "Average: ${DF_RED}${avg}ms${DF_NC} (slow - optimization recommended)"
|
||||
fi
|
||||
}
|
||||
|
||||
# Detailed zprof analysis
|
||||
detailed_profile() {
|
||||
df_print_section "Detailed Function Profiling (zprof)"
|
||||
echo ""
|
||||
|
||||
# Create temporary profile script
|
||||
local tmp_zshrc=$(mktemp)
|
||||
cat > "$tmp_zshrc" << 'EOF'
|
||||
zmodload zsh/zprof
|
||||
source ~/.zshrc
|
||||
zprof
|
||||
EOF
|
||||
|
||||
ZDOTDIR=$(dirname "$tmp_zshrc") zsh -i -c "source $tmp_zshrc; exit" 2>/dev/null | head -40
|
||||
|
||||
rm -f "$tmp_zshrc"
|
||||
|
||||
echo ""
|
||||
df_print_info "Top 40 functions shown. Run with ZDOTDIR override for full output."
|
||||
}
|
||||
|
||||
# Benchmark with hyperfine
|
||||
benchmark_profile() {
|
||||
if ! command -v hyperfine &>/dev/null; then
|
||||
df_print_warning "hyperfine not installed"
|
||||
df_print_info "Install: sudo pacman -S hyperfine"
|
||||
df_print_info "Falling back to quick profile..."
|
||||
echo ""
|
||||
quick_profile
|
||||
return
|
||||
fi
|
||||
|
||||
df_print_section "Benchmark (hyperfine)"
|
||||
echo ""
|
||||
|
||||
hyperfine --warmup 3 --min-runs 10 \
|
||||
--export-markdown /tmp/zsh-bench.md \
|
||||
'zsh -i -c exit' \
|
||||
2>&1
|
||||
|
||||
echo ""
|
||||
df_print_success "Results saved to /tmp/zsh-bench.md"
|
||||
}
|
||||
|
||||
# Compare with minimal shell
|
||||
compare_profile() {
|
||||
df_print_section "Comparison: Full vs Minimal Shell"
|
||||
echo ""
|
||||
|
||||
df_print_step "Full shell (with dotfiles):"
|
||||
local full_start=$(date +%s%3N)
|
||||
zsh -i -c 'exit' 2>/dev/null
|
||||
local full_end=$(date +%s%3N)
|
||||
local full_time=$((full_end - full_start))
|
||||
df_print_indent "${full_time}ms"
|
||||
|
||||
df_print_step "Minimal shell (no rc files):"
|
||||
local min_start=$(date +%s%3N)
|
||||
zsh --no-rcs -i -c 'exit' 2>/dev/null
|
||||
local min_end=$(date +%s%3N)
|
||||
local min_time=$((min_end - min_start))
|
||||
df_print_indent "${min_time}ms"
|
||||
|
||||
local overhead=$((full_time - min_time))
|
||||
local overhead_pct=$((overhead * 100 / (min_time + 1)))
|
||||
|
||||
echo ""
|
||||
df_print_section "Analysis"
|
||||
df_print_indent "Shell baseline: ${min_time}ms"
|
||||
df_print_indent "Dotfiles overhead: ${overhead}ms (+${overhead_pct}%)"
|
||||
|
||||
if (( overhead > VERY_SLOW_THRESHOLD_MS )); then
|
||||
echo ""
|
||||
df_print_warning "High overhead detected. Consider:"
|
||||
df_print_indent "• Lazy-loading heavy plugins (nvm, kubectl, etc.)"
|
||||
df_print_indent "• Compiling zsh files: dfcompile"
|
||||
df_print_indent "• Reducing oh-my-zsh plugins"
|
||||
df_print_indent "• Using zsh-defer for non-critical loads"
|
||||
fi
|
||||
}
|
||||
|
||||
# Identify slow components
|
||||
analyze_components() {
|
||||
df_print_section "Component Analysis"
|
||||
echo ""
|
||||
|
||||
local components=(
|
||||
"oh-my-zsh:source \$ZSH/oh-my-zsh.sh"
|
||||
"autosuggestions:source */zsh-autosuggestions.zsh"
|
||||
"syntax-highlight:source */zsh-syntax-highlighting.zsh"
|
||||
"fzf:source */fzf/*.zsh"
|
||||
"nvm:source \$NVM_DIR/nvm.sh"
|
||||
"dotfiles-funcs:source */functions/*.zsh"
|
||||
)
|
||||
|
||||
for comp in "${components[@]}"; do
|
||||
local name="${comp%%:*}"
|
||||
local pattern="${comp#*:}"
|
||||
|
||||
# Time loading this component
|
||||
local start=$(date +%s%3N)
|
||||
zsh -i -c "
|
||||
# Disable the component by commenting it out temporarily
|
||||
# This is a simplified check
|
||||
" 2>/dev/null
|
||||
local end=$(date +%s%3N)
|
||||
|
||||
printf " %-20s: checking...\n" "$name"
|
||||
done
|
||||
|
||||
echo ""
|
||||
df_print_info "For detailed component timing, use: --detailed"
|
||||
}
|
||||
|
||||
# Show optimization tips
|
||||
show_tips() {
|
||||
df_print_section "Optimization Tips"
|
||||
echo ""
|
||||
|
||||
cat << 'EOF'
|
||||
1. COMPILE ZSH FILES
|
||||
Run: dfcompile
|
||||
Compiles .zsh files to .zwc bytecode for faster parsing.
|
||||
|
||||
2. LAZY-LOAD HEAVY TOOLS
|
||||
nvm, pyenv, rbenv, kubectl - only load when first used.
|
||||
Example in .zshrc:
|
||||
kubectl() { unfunction kubectl; source <(command kubectl completion zsh); kubectl "$@"; }
|
||||
|
||||
3. REDUCE OH-MY-ZSH PLUGINS
|
||||
Each plugin adds startup time. Only enable what you use.
|
||||
Heavy plugins: nvm, kubectl, docker-compose, thefuck
|
||||
|
||||
4. USE ZSH-DEFER
|
||||
Defer non-critical loading until after first prompt:
|
||||
zsh-defer source ~/.dotfiles/zsh/functions/heavy-stuff.zsh
|
||||
|
||||
5. PROFILE REGULARLY
|
||||
Run this script after changes to track impact.
|
||||
|
||||
6. CHECK FOR SLOW COMPLETIONS
|
||||
Completion initialization can be slow:
|
||||
autoload -Uz compinit
|
||||
if [[ -n ~/.zcompdump(#qN.mh+24) ]]; then
|
||||
compinit
|
||||
else
|
||||
compinit -C # Skip security check (faster)
|
||||
fi
|
||||
|
||||
EOF
|
||||
}
|
||||
|
||||
# ============================================================================
|
||||
# Help
|
||||
# ============================================================================
|
||||
|
||||
show_help() {
|
||||
cat << 'EOF'
|
||||
Dotfiles Startup Profiler
|
||||
|
||||
Usage: dotfiles-profile.sh [OPTIONS]
|
||||
|
||||
Options:
|
||||
(none) Quick profile (5 runs, average time)
|
||||
--detailed Detailed zprof function-level profiling
|
||||
--benchmark Benchmark with hyperfine (if installed)
|
||||
--compare Compare full shell vs minimal shell
|
||||
--tips Show optimization tips
|
||||
--all Run all profiling methods
|
||||
--help Show this help
|
||||
|
||||
Thresholds:
|
||||
< 200ms Excellent (green)
|
||||
200-500ms Acceptable (yellow)
|
||||
> 500ms Slow (red) - optimization recommended
|
||||
|
||||
Examples:
|
||||
dotfiles-profile.sh # Quick timing
|
||||
dotfiles-profile.sh --detailed # See which functions are slow
|
||||
dotfiles-profile.sh --compare # See dotfiles overhead
|
||||
dotfiles-profile.sh --all # Full analysis
|
||||
|
||||
EOF
|
||||
}
|
||||
|
||||
# ============================================================================
|
||||
# Main
|
||||
# ============================================================================
|
||||
|
||||
main() {
|
||||
df_print_header "dotfiles-profile"
|
||||
|
||||
case "${1:-}" in
|
||||
--detailed|-d)
|
||||
detailed_profile
|
||||
;;
|
||||
--benchmark|-b)
|
||||
benchmark_profile
|
||||
;;
|
||||
--compare|-c)
|
||||
compare_profile
|
||||
;;
|
||||
--tips|-t)
|
||||
show_tips
|
||||
;;
|
||||
--all|-a)
|
||||
quick_profile
|
||||
echo ""
|
||||
compare_profile
|
||||
echo ""
|
||||
detailed_profile
|
||||
echo ""
|
||||
show_tips
|
||||
;;
|
||||
--help|-h)
|
||||
show_help
|
||||
;;
|
||||
*)
|
||||
quick_profile
|
||||
echo ""
|
||||
df_print_info "For more analysis: $0 --all"
|
||||
;;
|
||||
esac
|
||||
}
|
||||
|
||||
main "$@"
|
||||
Reference in New Issue
Block a user