Add script

.github/workflows/ci.yml

@@ -0,0 +1,76 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  test:
+    name: test ${{ matrix.os }}
+    strategy:
+      matrix:
+        os:
+          - ubuntu-latest
+          - macos-latest
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup asdf
+        uses: asdf-vm/actions/setup@v3
+
+      - name: Fetch latest Scarb version from GitHub releases
+        id: scarb_version
+        shell: pwsh
+        run: |
+          $location = (Invoke-WebRequest -Uri "https://github.com/software-mansion/scarb/releases/latest" -Method Head -MaximumRedirection 0 -SkipHttpErrorCheck -ErrorAction Ignore).Headers.Location
+          $latest_version = ($location -replace '^.*/v','')
+          echo "Latest Scarb version found is $latest_version"
+          echo "LATEST=$latest_version" >> $env:GITHUB_OUTPUT
+
+      - name: Fetch latest Starknet Foundry version from GitHub releases
+        id: snfoundry_version
+        shell: pwsh
+        run: |
+          $location = (Invoke-WebRequest -Uri "https://github.com/foundry-rs/starknet-foundry/releases/latest" -Method Head -MaximumRedirection 0 -SkipHttpErrorCheck -ErrorAction Ignore).Headers.Location
+          $latest_version = ($location -replace '^.*/v','')
+          echo "Latest Starknet Foundry version found is $latest_version"
+          echo "LATEST=$latest_version" >> $env:GITHUB_OUTPUT
+
+      - name: Fetch latest Universal Sierra Compiler version from GitHub releases
+        id: usc_version
+        shell: pwsh
+        run: |
+          $location = (Invoke-WebRequest -Uri "https://github.com/software-mansion/universal-sierra-compiler/releases/latest" -Method Head -MaximumRedirection 0 -SkipHttpErrorCheck -ErrorAction Ignore).Headers.Location
+          $latest_version = ($location -replace '^.*/v','')
+          echo "Latest Universal Sierra Compiler version found is $latest_version"
+          echo "LATEST=$latest_version" >> $env:GITHUB_OUTPUT
+
+      - name: Run starknetup
+        run: ./starknetup.sh
+
+      - name: Check Scarb latest
+        run: scarb --version | grep "scarb ${{ steps.scarb_version.outputs.LATEST }}"
+
+      - name: Check Starknet Foundry latest
+        run: |
+          snforge --version | grep "snforge ${{ steps.snfoundry_version.outputs.LATEST }}"
+          sncast --version | grep "sncast ${{ steps.snfoundry_version.outputs.LATEST }}"
+
+      - name: Check Universal Sierra Compiler latest
+        run: universal-sierra-compiler --version | grep "universal-sierra-compiler ${LATEST}"
+
+  shellcheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - run: shellcheck starknetup.sh
+
+  shfmt:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: mfinelli/setup-shfmt@v3
+      - uses: actions/checkout@v4
+      - run: shfmt --diff starknetup.sh

starknetup.sh

@@ -0,0 +1,186 @@
+#!/bin/sh
+# shellcheck shell=dash
+
+set -eu
+
+ASDF_INSTALL_DOCS="https://asdf-vm.com/guide/getting-started.html"
+SCARB_UNINSTALL_DOCS="https://docs.swmansion.com/scarb/download#uninstall"
+STARKNET_FOUNDRY_UNINSTALL_DOCS="PENDING"
+SCRIPT_VERSION="0.1.0"
+
+usage() {
+	cat <<EOF
+The installer for Starknet tools. Installs the latest versions of Scarb, Starknet Foundry and Universal Sierra Compiler using asdf.
+
+Usage: $0 [OPTIONS]
+
+Options:
+  -h, --help      Print help
+  -V, --version   Print script version
+
+EOF
+}
+
+main() {
+	for arg in "$@"; do
+		case "$arg" in
+		-h | --help)
+			usage
+			exit 0
+			;;
+		-V | --version)
+			printf "starknetup %s\n" "$SCRIPT_VERSION"
+			exit 0
+			;;
+		*)
+			err "invalid option '$arg'. For more information, try '--help'."
+			;;
+		esac
+	done
+
+	assert_dependencies
+	assert_not_installed "scarb" $SCARB_UNINSTALL_DOCS
+	install_latest_asdf_plugin "scarb"
+	install_latest_version "scarb"
+	set_global_latest_version "scarb"
+
+	assert_not_installed "starknet-foundry" $STARKNET_FOUNDRY_UNINSTALL_DOCS
+	install_latest_asdf_plugin "starknet-foundry"
+
+	# Reinstall to ensure the latest version of USC is installed
+	uninstall_latest_version "starknet-foundry"
+	install_latest_version "starknet-foundry"
+	set_global_latest_version "starknet-foundry"
+
+	say "Installation complete"
+}
+
+assert_dependencies() {
+	need_cmd curl
+	need_cmd git
+	if ! check_cmd asdf; then
+		install_asdf_interactively
+	fi
+}
+
+assert_not_installed() {
+	local tool="$1"
+	local uninstall_docs_url="$2"
+
+	if ! asdf which "$tool" >/dev/null 2>&1; then
+		if check_cmd "$tool"; then
+			err "$tool is already installed outside of asdf. Please uninstall it and re-run this script. For uninstallation instructions, refer to $uninstall_docs_url."
+		fi
+	fi
+}
+
+install_latest_asdf_plugin() {
+	local plugin="$1"
+	if asdf plugin list | grep -q "$plugin"; then
+		ensure asdf plugin update "$plugin"
+	else
+		ensure asdf plugin add "$plugin"
+	fi
+}
+
+install_latest_version() {
+	local tool="$1"
+	ensure asdf install "$tool" latest
+}
+
+uninstall_latest_version() {
+	local tool="$1"
+	local latest_version
+	latest_version=$(asdf latest "$tool")
+
+	if asdf list "$tool" "^${latest_version}$" >/dev/null 2>&1; then
+		ensure asdf uninstall "$tool" "$latest_version"
+	fi
+}
+
+set_global_latest_version() {
+	local tool="$1"
+	ensure asdf global "$tool" latest
+}
+
+say() {
+	printf "starknetup: %s\n" "$1"
+}
+
+err() {
+	say "$1" >&2
+	exit 1
+}
+
+need_cmd() {
+	if ! check_cmd "$1"; then
+		err "need '$1' (command not found)"
+	fi
+}
+
+check_cmd() {
+	command -v "$1" >/dev/null 2>&1
+}
+
+ensure() {
+	if ! "$@"; then err "command failed: $*"; fi
+}
+
+install_asdf_interactively() {
+	local _profile
+	local _pref_shell
+	local _asdf_path="$HOME/.asdf"
+
+	case ${SHELL:-""} in
+	*/zsh)
+		_profile=$HOME/.zshrc
+		_pref_shell=zsh
+		;;
+	*/ash)
+		_profile=$HOME/.profile
+		_pref_shell=ash
+		;;
+	*/bash)
+		if [ "$(uname)" = "Darwin" ]; then
+			_profile=$HOME/.bash_profile
+		else
+			_profile=$HOME/.bashrc
+		fi
+		_pref_shell=bash
+		;;
+	*)
+		err "asdf-vm is required. Please install it manually and re-run this script. For installation instructions, refer to ${ASDF_INSTALL_DOCS}."
+		;;
+	esac
+
+	if [ -n "$_profile" ]; then
+		if [ ! -f "$_profile" ]; then
+			touch "$_profile"
+		fi
+
+		say "asdf-vm is required. Do you want to install it now? (y/N): "
+		read -r answer
+		case $answer in
+		[Yy]*)
+			say "Installing asdf-vm...\n"
+			git clone https://github.com/asdf-vm/asdf.git "$_asdf_path" --branch v0.14.1
+
+			case $_pref_shell in
+			zsh | bash | ash)
+				echo >>"$_profile" && echo ". ${_asdf_path}/asdf.sh" >>"$_profile"
+				;;
+			esac
+
+			say "asdf-vm has been installed. Run 'source ${_profile}' or start a new terminal session and re-run this script."
+			exit 0
+			;;
+		*)
+			err "asdf-vm is required. Please install it manually and re-run this script. For installation instructions, refer to ${ASDF_INSTALL_DOCS}."
+			;;
+		esac
+	else
+		err "asdf-vm is required. Please install it manually and re-run this script. For installation instructions, refer to ${ASDF_INSTALL_DOCS}."
+	fi
+}
+
+main "$@" || exit 1