Merge pull request #242 from ryanfowler/install-script

Add installation script for unix-like systems

Author: ryanfowler

README.md

@@ -19,21 +19,30 @@
 
 ## Installation
 
-You can install `fetch` from the pre-built binaries or compile it from source.
+You can install `fetch` using an installation script, by compiling from source,
+or from pre-built binaries.
 
-### Using Pre-built Binaries
+### Installation Script
 
-Visit the [GitHub releases page](https://github.com/ryanfowler/fetch/releases)
-to download the binary for your operating system.
+For macOS or Linux, download and run the [install.sh](./install.sh) script:
+
+```sh
+curl -fsSL https://raw.githubusercontent.com/ryanfowler/fetch/main/install.sh | bash
+```
 
 ### Building from Source
 
-Ensure you have Go 1.24+ installed, then run:
+Ensure you have Go installed, then run:
 
 ```sh
 go install github.com/ryanfowler/fetch@latest
 ```
 
+### Pre-built Binaries
+
+Visit the [GitHub releases page](https://github.com/ryanfowler/fetch/releases)
+to download the binary for your operating system.
+
 ### Updating
 
 Once installed, you can update the fetch binary in-place by running:

install.sh

@@ -0,0 +1,144 @@
+#!/bin/bash
+set -e
+
+# Installation script for fetch
+# Usage: curl -fsSL https://raw.githubusercontent.com/ryanfowler/fetch/main/install.sh | bash
+
+LATEST_RELEASE_URL="https://api.github.com/repos/ryanfowler/fetch/releases/latest"
+
+RESET=""
+BOLD=""
+DIM=""
+RED=""
+GREEN=""
+YELLOW=""
+
+# Set escape sequences if stderr is a terminal.
+if [ -t 2 ]; then
+  RESET="\033[0m"
+  BOLD="\033[1m"
+  DIM="\033[2m"
+  RED="\033[31m"
+  GREEN="\033[32m"
+  YELLOW="\033[33m"
+fi
+
+# Print info message.
+info() {
+  echo -e "${BOLD}${GREEN}info${RESET}: $1"
+}
+
+# Print warning message.
+warning() {
+  echo -e "${BOLD}${YELLOW}warning${RESET}: $1"
+}
+
+# Print error message.
+error() {
+  echo -e "${BOLD}${RED}error${RESET}: $1"
+}
+
+# Print compile from source message.
+compile_msg() {
+    echo -e "\nTry compiling from source by running: '${DIM}go install github.com/ryanfowler/fetch@latest${RESET}'"
+}
+
+# Determine OS and architecture.
+OS=$(uname -s)
+ARCH=$(uname -m)
+
+case "$OS" in
+  Darwin) OS="darwin" ;;
+  Linux) OS="linux" ;;
+  *) 
+    error "no release artifact found for operating system: $OS"
+    compile_msg
+    exit 1
+    ;;
+esac
+
+case "$ARCH" in
+  x86_64|amd64) ARCH="amd64" ;;
+  aarch64|arm64) ARCH="arm64" ;;
+  *)
+    error "no release artifact found for architecture: $ARCH"
+    compile_msg
+    exit 1
+    ;;
+esac
+
+PLATFORM="${OS}-${ARCH}"
+
+# Fetch the latest release asset
+info "fetching latest release tag"
+
+if ! command -v curl &> /dev/null; then
+  error "curl is required but not installed"
+  exit 1
+fi
+
+HAS_JQ=false
+if command -v jq &> /dev/null; then
+  HAS_JQ=true
+fi
+
+RELEASE_JSON=$(curl -s "$LATEST_RELEASE_URL")
+
+VERSION=""
+if $HAS_JQ; then
+  VERSION=$(echo "$RELEASE_JSON" | jq -r .tag_name)
+else
+  VERSION=$(echo "$RELEASE_JSON" | grep -o '"tag_name": *"[^"]*"' | sed 's/"tag_name": *"//;s/"//')
+fi
+if [ -z "$VERSION" ]; then
+  error "unable to determine the latest version"
+  exit 1
+fi
+
+# Download the artifact.
+DOWNLOAD_URL=""
+if $HAS_JQ; then
+  DOWNLOAD_URL=$(echo "$RELEASE_JSON" | jq -r ".assets.[] | select(.name == \"fetch-v0.7.5-${PLATFORM}.tar.gz\") | .browser_download_url")
+else
+  DOWNLOAD_URL=$(echo "$RELEASE_JSON" | grep -o "\"browser_download_url\": *\"[^\"]*${PLATFORM}[^\"]*\"" | sed 's/"browser_download_url": *"//;s/"//')
+fi
+if [ -z "$DOWNLOAD_URL" ]; then
+  error "no release artifact found for ${OS}/${ARCH}"
+  exit 1
+fi
+
+# Create temporary directory.
+TMP_DIR=$(mktemp -d)
+BINARY_PATH="${TMP_DIR}/fetch"
+
+info "downloading latest version (${VERSION})"
+if ! curl -fsSL "$DOWNLOAD_URL" -o "$BINARY_PATH.tar.gz"; then
+  error "unable to download artifact"
+  exit 1
+fi
+
+tar -xzf "$BINARY_PATH.tar.gz" -C "$TMP_DIR"
+chmod +x "$BINARY_PATH"
+
+# Determine installation directory.
+if [ -w "/usr/local/bin" ]; then
+  # Can write to /usr/local/bin.
+  INSTALL_DIR="/usr/local/bin"
+else
+  # Use home directory.
+  INSTALL_DIR="$HOME/.local/bin"
+  mkdir -p "$INSTALL_DIR"
+fi
+
+mv "$BINARY_PATH" "$INSTALL_DIR/fetch"
+info "fetch successfully installed to '${DIM}${INSTALL_DIR}/fetch${RESET}'"
+
+# Clean up.
+rm -rf "$TMP_DIR"
+
+# Verify installation.
+if ! command -v fetch &> /dev/null; then
+  echo ""
+  warning "you may need to add '${DIM}${INSTALL_DIR}${RESET}' to your PATH"
+fi
+