mirror of
https://github.com/marcogll/omarchy_setup.git
synced 2026-01-13 21:35:16 +00:00
70be3f8f14
This is a major refactoring and documentation effort that touches every module in the project. - **Exhaustive In-Code Documentation:** Every module script in the `modules/` directory has been updated with detailed comments. This includes header descriptions, explanations for each function, and justifications for complex logic. This greatly improves the maintainability and readability of the code. - **Code Robustness and Optimization:** Several modules have been refactored to be more robust and efficient. This includes: - Optimizing package installations by grouping them into a single `pacman` command. - Improving dependency checks. - Standardizing the use of helper functions from `common.sh`. - Making network operations more resilient. - **Comprehensive `Readme.md` Update:** The main `Readme.md` has been rewritten to be a complete and professional guide to the project. It now includes: - A clear and detailed description of each module. - Information on what each module installs and how it works. - Instructions for installing the required Nerd Font for `oh-my-posh`. - An updated structure that is easier to navigate.
209 lines
9.7 KiB
Bash
Executable File
209 lines
9.7 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
# ===============================================================
|
|
# zsh-config.sh - Configuración completa de Zsh
|
|
# ===============================================================
|
|
#
|
|
# Este módulo se encarga de transformar la experiencia de la terminal
|
|
# mediante la instalación y configuración de Zsh, Oh My Zsh y Oh My Posh.
|
|
#
|
|
# Funciones principales:
|
|
# - Instala Zsh y un conjunto de herramientas de terminal útiles.
|
|
# - Instala y configura Oh My Posh, incluyendo un tema personalizado.
|
|
# - Instala Oh My Zsh y gestiona sus plugins.
|
|
# - Descarga y aplica un fichero .zshrc preconfigurado.
|
|
# - Cambia el shell por defecto del usuario a Zsh.
|
|
#
|
|
# ===============================================================
|
|
|
|
SCRIPT_DIR_MODULE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
SCRIPT_DIR_ROOT="$(cd "${SCRIPT_DIR_MODULE}/.." && pwd)"
|
|
if [[ -f "${SCRIPT_DIR_MODULE}/common.sh" ]]; then
|
|
source "${SCRIPT_DIR_MODULE}/common.sh"
|
|
else
|
|
echo "Error: common.sh no encontrado."
|
|
exit 1
|
|
fi
|
|
|
|
# Opciones para `curl` que añaden timeouts y reintentos para robustez.
|
|
ZSH_CURL_TIMEOUT_OPTS=(--fail --location --silent --show-error --connect-timeout 10 --max-time 60 --retry 2 --retry-delay 2)
|
|
|
|
# ---------------------------------------------------------------
|
|
# zsh_download_with_timeout(url, destination)
|
|
# ---------------------------------------------------------------
|
|
# Descarga un fichero desde una URL a un destino local usando `curl`
|
|
# con las opciones de timeout y reintentos definidas globalmente.
|
|
#
|
|
# Parámetros:
|
|
# $1 - URL del fichero a descargar.
|
|
# $2 - Ruta de destino donde se guardará el fichero.
|
|
# ---------------------------------------------------------------
|
|
zsh_download_with_timeout() {
|
|
local url="$1"
|
|
local dest="$2"
|
|
if curl "${ZSH_CURL_TIMEOUT_OPTS[@]}" -o "$dest" "$url"; then
|
|
return 0
|
|
fi
|
|
return 1
|
|
}
|
|
|
|
# ---------------------------------------------------------------
|
|
# install_zsh()
|
|
# ---------------------------------------------------------------
|
|
# Función principal que orquesta toda la configuración de Zsh.
|
|
# ---------------------------------------------------------------
|
|
install_zsh() {
|
|
log_step "Configuración Completa de Zsh"
|
|
|
|
# Determina el usuario y el directorio home de destino, manejando el caso de `sudo`.
|
|
local target_user="${SUDO_USER:-$USER}"
|
|
local target_home
|
|
if [[ -n "${SUDO_USER:-}" ]]; then
|
|
target_home="$(getent passwd "$target_user" 2>/dev/null | cut -d: -f6)"
|
|
fi
|
|
target_home="${target_home:-$HOME}"
|
|
|
|
# --- 1. Instalación de Paquetes ---
|
|
log_info "Instalando Zsh y herramientas de terminal..."
|
|
# Paquetes:
|
|
# - zsh y plugins: El shell y sus complementos básicos.
|
|
# - zoxide, fastfetch, yt-dlp: Herramientas que mejoran la productividad
|
|
# y están integradas en el .zshrc personalizado.
|
|
local pkgs=(
|
|
git zsh zsh-completions zsh-syntax-highlighting zsh-autosuggestions
|
|
zoxide fastfetch yt-dlp unrar p7zip lsof
|
|
)
|
|
if ! sudo pacman -S --noconfirm --needed "${pkgs[@]}"; then
|
|
log_warning "Algunos paquetes de Zsh no pudieron instalarse."
|
|
fi
|
|
|
|
# Instala Oh My Posh, con fallback a AUR y luego al script oficial si es necesario.
|
|
if ! command_exists oh-my-posh; then
|
|
log_info "Instalando Oh My Posh..."
|
|
if sudo pacman -S --noconfirm --needed oh-my-posh 2>/dev/null; then
|
|
log_success "Oh My Posh instalado desde los repositorios oficiales."
|
|
elif aur_install_packages "oh-my-posh-bin"; then
|
|
log_success "Oh My Posh instalado desde AUR."
|
|
else
|
|
log_warning "No se pudo instalar Oh My Posh desde pacman ni AUR. Intentando con el script oficial..."
|
|
local omp_installer; omp_installer="$(mktemp)"
|
|
if zsh_download_with_timeout "https://ohmyposh.dev/install.sh" "$omp_installer"; then
|
|
if sudo bash "$omp_installer" -d /usr/local/bin; then
|
|
log_success "Oh My Posh instalado con el script oficial."
|
|
else
|
|
log_error "Falló la instalación de Oh My Posh con el script oficial."; rm -f "$omp_installer"; return 1
|
|
fi; rm -f "$omp_installer"
|
|
else
|
|
log_error "No se pudo descargar el instalador de Oh My Posh."; rm -f "${omp_installer:-}"; return 1
|
|
fi
|
|
fi
|
|
else
|
|
log_info "Oh My Posh ya está instalado."
|
|
fi
|
|
|
|
# --- 2. Instalación de Oh My Zsh ---
|
|
local target_ohmyzsh_dir="${target_home}/.oh-my-zsh"
|
|
if [[ ! -d "$target_ohmyzsh_dir" ]]; then
|
|
log_info "Instalando Oh My Zsh..."
|
|
local omz_installer; omz_installer="$(mktemp)"
|
|
if zsh_download_with_timeout "https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh" "$omz_installer"; then
|
|
# Se ejecuta de forma no interactiva, sin cambiar el shell aún.
|
|
if ! env HOME="$target_home" RUNZSH=no CHSH=no sh "$omz_installer" --unattended --keep-zshrc; then
|
|
log_error "Falló la instalación de Oh My Zsh."; rm -f "$omz_installer"; return 1
|
|
fi; rm -f "$omz_installer"
|
|
else
|
|
log_error "No se pudo descargar el instalador de Oh My Zsh."; rm -f "${omz_installer:-}"; return 1
|
|
fi
|
|
else
|
|
log_info "Oh My Zsh ya está instalado."
|
|
fi
|
|
|
|
# --- 3. Gestión de Plugins de Oh My Zsh ---
|
|
# Asegura que los plugins de autocompletado y resaltado de sintaxis estén clonados.
|
|
ensure_omz_plugin() {
|
|
local name="$1" repo="$2"
|
|
local plugin_path="${target_home}/.oh-my-zsh/custom/plugins/${name}"
|
|
if [[ -d "${plugin_path}/.git" ]]; then
|
|
log_info "Actualizando el plugin de Oh My Zsh: ${name}..."
|
|
git -C "$plugin_path" pull --ff-only >/dev/null 2>&1 || true
|
|
elif [[ ! -d "$plugin_path" ]]; then
|
|
log_info "Clonando el plugin de Oh My Zsh: ${name}..."
|
|
git clone --depth 1 "$repo" "$plugin_path" >/dev/null 2>&1
|
|
fi
|
|
}
|
|
ensure_omz_plugin "zsh-autosuggestions" "https://github.com/zsh-users/zsh-autosuggestions.git"
|
|
ensure_omz_plugin "zsh-syntax-highlighting" "https://github.com/zsh-users/zsh-syntax-highlighting.git"
|
|
|
|
# --- 4. Configuración del .zshrc ---
|
|
log_info "Configurando el fichero .zshrc..."
|
|
local tmp_download="${target_home}/.zshrc.omarchy-tmp"
|
|
local source_file=""
|
|
# Intenta descargar el .zshrc desde el repositorio remoto.
|
|
if zsh_download_with_timeout "${REPO_BASE}/.zshrc" "$tmp_download"; then
|
|
source_file="$tmp_download"
|
|
# Si falla, usa la copia local que viene con el script.
|
|
elif [[ -f "${SCRIPT_DIR_ROOT}/.zshrc" ]]; then
|
|
log_warning "No se pudo descargar .zshrc. Se usará la copia local."
|
|
source_file="${SCRIPT_DIR_ROOT}/.zshrc"
|
|
else
|
|
log_error "No se pudo obtener el fichero .zshrc."; return 1
|
|
fi
|
|
# Crea una copia de seguridad y reemplaza el .zshrc existente.
|
|
backup_file "${target_home}/.zshrc" || { rm -f "$tmp_download"; return 1; }
|
|
if ! cp "$source_file" "${target_home}/.zshrc"; then
|
|
log_error "No se pudo actualizar el fichero .zshrc."; rm -f "$tmp_download"; return 1
|
|
fi
|
|
rm -f "$tmp_download"
|
|
log_success ".zshrc actualizado correctamente."
|
|
|
|
# --- 5. Configuración del Tema de Oh My Posh ---
|
|
log_info "Configurando el tema de Oh My Posh (Catppuccin Frappe)..."
|
|
local posh_themes_dir="${target_home}/.poshthemes"
|
|
local theme_file="$posh_themes_dir/catppuccin_frappe.omp.json"
|
|
mkdir -p "$posh_themes_dir"
|
|
# Descarga el tema y, si falla, usa la copia local.
|
|
if ! zsh_download_with_timeout "https://raw.githubusercontent.com/JanDeDobbeleer/oh-my-posh/main/themes/catppuccin_frappe.omp.json" "$theme_file"; then
|
|
if [[ -f "${SCRIPT_DIR_ROOT}/themes/catppuccin_frappe.omp.json" ]]; then
|
|
cp "${SCRIPT_DIR_ROOT}/themes/catppuccin_frappe.omp.json" "$theme_file"
|
|
log_warning "No se pudo descargar el tema. Se usó la copia local."
|
|
else
|
|
log_error "No se pudo obtener el tema de Oh My Posh."
|
|
fi
|
|
fi
|
|
# Genera el fichero de autocompletado para Zsh.
|
|
if command_exists oh-my-posh; then
|
|
local omp_completion_dir="${target_home}/.local/share/zsh/site-functions"
|
|
mkdir -p "$omp_completion_dir"
|
|
oh-my-posh completion zsh > "${omp_completion_dir}/_oh-my-posh" 2>/dev/null || true
|
|
fi
|
|
log_success "Tema de Oh My Posh configurado."
|
|
|
|
# --- 6. Cambio de Shell por Defecto ---
|
|
local current_shell; current_shell="$(getent passwd "$target_user" 2>/dev/null | cut -d: -f7)"
|
|
if [[ "$(basename "$current_shell")" != "zsh" ]]; then
|
|
log_info "Cambiando el shell por defecto a Zsh para el usuario '$target_user'..."
|
|
if ! sudo chsh -s "$(command -v zsh)" "$target_user"; then
|
|
log_error "No se pudo cambiar el shell automáticamente."
|
|
else
|
|
log_success "Shell cambiado a Zsh. El cambio será efectivo en el próximo inicio de sesión."
|
|
fi
|
|
fi
|
|
|
|
# --- 7. Configuración de .bashrc ---
|
|
# Añade una línea a .bashrc para que las terminales que se abran con Bash
|
|
# ejecuten Zsh automáticamente.
|
|
local bashrc_zsh_loader='if [ -t 1 ]; then exec zsh; fi'
|
|
if [[ -f "${target_home}/.bashrc" ]] && ! grep -q "exec zsh" "${target_home}/.bashrc"; then
|
|
echo -e "\n# Iniciar Zsh automáticamente\n$bashrc_zsh_loader" >> "${target_home}/.bashrc"
|
|
fi
|
|
|
|
# --- 8. Mensaje Final ---
|
|
echo ""
|
|
log_warning "¡ACCIÓN REQUERIDA! Para que los iconos del prompt se vean bien:"
|
|
log_info "1. Instala una 'Nerd Font'. La recomendada es Meslo."
|
|
log_info " Puedes hacerlo con el comando: oh-my-posh font install meslo"
|
|
log_info "2. Configura tu aplicación de terminal para que use la fuente 'MesloLGS NF'."
|
|
log_info "3. Cierra y vuelve a abrir la terminal para aplicar todos los cambios."
|
|
|
|
return 0
|
|
}
|