helix 추가

This commit is contained in:
Jerry Chae committed 2026-06-02 11:20:59 +09:00
1 parent c90e467ae4
commit c0058e6719
3 files changed
+439 -2

No files matched your search

+179
View File
@@ -0,0 +1,179 @@
#!/usr/bin/env bash
# shellcheck disable=SC2086
# GitHub Releases에서 최신 Helix 에디터 TUI를 다운로드하고 필수 런타임을 설치합니다.
# Helix: https://github.com/helix-editor/helix
#
# 지원 플랫폼:
# macOS : Apple Silicon (arm64), Intel (x86_64)
# Linux : x86_64, aarch64(arm64)
set -euo pipefail
# ────────────────────────────────────────────
# 상수 정의
# ────────────────────────────────────────────
REPO="helix-editor/helix"
API_URL="https://api.github.com/repos/${REPO}/releases/latest"
INSTALL_DIR="${HOME}/.local/bin"
HELIX_CONFIG_DIR="${HOME}/.config/helix"
# ────────────────────────────────────────────
# 유틸리티 함수 (모두 stderr 출력)
# ────────────────────────────────────────────
info() { echo "[INFO] $*" >&2; }
warn() { echo "[WARN] $*" >&2; }
error() { echo "[ERROR] $*" >&2; exit 1; }
success() { echo "[OK] $*" >&2; }
# ────────────────────────────────────────────
# 필수 명령어 확인
# ────────────────────────────────────────────
for cmd in curl tar xz uname; do
command -v "$cmd" &>/dev/null || error "'$cmd' 명령어가 필요합니다. 먼저 설치해 주세요."
done
# Fallback: jq가 없을 경우 python3를 사용해 JSON 분석
if command -v jq &>/dev/null; then
_json_latest_tag() {
jq -r '.tag_name'
}
else
command -v python3 &>/dev/null || error "'jq' 또는 'python3' 명령어가 설치되어 있어야 합니다."
_json_latest_tag() {
python3 -c "
import sys, json
data = json.load(sys.stdin)
print(data.get('tag_name', ''))
"
}
fi
# ────────────────────────────────────────────
# OS 및 아키텍처 분석
# ────────────────────────────────────────────
# 반환 형식: "아카이브아키텍처명"
detect_platform() {
local os arch
os="$(uname -s)"
arch="$(uname -m)"
case "$os" in
# ── macOS ──────────────────────────────────────────────
Darwin)
case "$arch" in
arm64) echo "aarch64-macos" ;;
x86_64) echo "x86_64-macos" ;;
*) error "지원하지 않는 macOS 아키텍처입니다: $arch" ;;
esac
;;
# ── Linux ──────────────────────────────────────────────
Linux)
case "$arch" in
x86_64|amd64)
echo "x86_64-linux" ;;
aarch64|arm64)
echo "aarch64-linux" ;;
*)
error "지원하지 않는 Linux 아키텍처입니다: $arch" ;;
esac
;;
*)
error "지원하지 않는 운영체제입니다: $os (uname -a: $(uname -a))"
;;
esac
}
# ────────────────────────────────────────────
# 최신 릴리스 태그 가져오기
# ────────────────────────────────────────────
get_latest_release_tag() {
info "GitHub API를 통해 Helix 최신 릴리스 버전을 조회하는 중..."
local release_json tag
release_json="$(curl -fsSL "${API_URL}")" || error "GitHub API 호출에 실패했습니다."
tag="$(echo "$release_json" | _json_latest_tag)"
if [[ -z "$tag" || "$tag" == "null" ]]; then
error "최신 릴리스 태그를 확인하는 데 실패했습니다."
fi
echo "$tag"
}
# ────────────────────────────────────────────
# 메인 설치 로직
# ────────────────────────────────────────────
main() {
local platform_arch
platform_arch="$(detect_platform)"
local tag version
tag="$(get_latest_release_tag)"
version="${tag#v}" # v25.07.1 형태에서 v 접두사 제거
info "설치 환경 감지: $platform_arch ($tag 버전)"
local asset_name="helix-${version}-${platform_arch}"
local archive_name="${asset_name}.tar.xz"
local download_url="https://github.com/helix-editor/helix/releases/download/${tag}/${archive_name}"
# 임시 작업 디렉토리 생성
local tmp_dir
tmp_dir="$(mktemp -d)"
local tmp_archive="${tmp_dir}/${archive_name}"
info "아카이브 다운로드 중: $download_url"
if ! curl -fsSL "$download_url" -o "$tmp_archive"; then
rm -rf "$tmp_dir"
error "바이너리 다운로드에 실패했습니다. URL: $download_url"
fi
info "압축 해제 중..."
tar -xf "$tmp_archive" -C "$tmp_dir"
local extracted_folder="${tmp_dir}/${asset_name}"
if [ -d "${extracted_folder}-source" ]; then
# 간혹 폴더 이름 뒤에 -source가 붙는 예외 방어
extracted_folder="${extracted_folder}-source"
fi
# 1) 바이너리 설치
mkdir -p "$INSTALL_DIR"
local dest_binary="${INSTALL_DIR}/hx"
info "바이너리 배포 중: $dest_binary"
cp "${extracted_folder}/hx" "$dest_binary"
chmod +x "$dest_binary"
# 2) 런타임(runtime) 디렉토리 설치
# 테마, 구문 강조 트리 등을 로드하기 위해 Helix는 runtime 디렉토리가 필수적입니다.
local dest_runtime="${HELIX_CONFIG_DIR}/runtime"
if [ -d "$dest_runtime" ]; then
warn "기존 Helix 런타임 디렉토리가 감지되었습니다: $dest_runtime"
local backup_runtime="${dest_runtime}.bak.$(date +%Y%m%d%H%M%S)"
info "기존 런타임을 백업합니다: $backup_runtime"
mv "$dest_runtime" "$backup_runtime"
fi
mkdir -p "$HELIX_CONFIG_DIR"
info "런타임 디렉토리 배포 중: $dest_runtime"
cp -r "${extracted_folder}/runtime" "$dest_runtime"
# 임시 디렉토리 청소
rm -rf "$tmp_dir"
success "Helix 에디터 ($tag) 설치가 성공적으로 완료되었습니다!"
info "실행 명령어: hx"
info "런타임 경로: $dest_runtime"
# PATH 환경 변수 확인 및 안내
if [[ ":$PATH:" != *":$INSTALL_DIR:"* ]]; then
warn "설치 경로($INSTALL_DIR)가 현재 PATH 환경 변수에 등록되어 있지 않습니다."
warn "사용하시는 쉘 프로필 파일(예: ~/.bashrc 또는 ~/.zshrc)에 아래 설정을 추가해 주세요:"
warn " export PATH=\"\$HOME/.local/bin:\$PATH\""
fi
}
main "$@"