Merge pull request #185 from grafbase/tomhoule-nlvlupvqokrx

protoc-gen-grafbase-subgraph: binary download script and release

Author: tomhoule

cli/protoc-gen-grafbase-subgraph/Makefile.toml

@@ -0,0 +1,41 @@
+[tasks.bump]
+script = '''
+#!/usr/bin/env bash
+set -e
+
+# Get current version from Cargo.toml
+current_version=$(grep '^version = ' Cargo.toml | head -1 | sed 's/version = "\(.*\)"/\1/')
+echo "Current version: $current_version"
+
+# Read new version from user
+read -p "Enter new version (x.y.z): " new_version
+
+# Validate version format
+if ! [[ $new_version =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+    echo "Error: Version must be in format x.y.z"
+    exit 1
+fi
+
+# Update version in Cargo.toml
+if [[ "$OSTYPE" == "darwin"* ]]; then
+    # macOS
+    sed -i '' "s/^version = \".*\"/version = \"$new_version\"/" Cargo.toml
+else
+    # Linux
+    sed -i "s/^version = \".*\"/version = \"$new_version\"/" Cargo.toml
+fi
+
+# Update version in install.sh
+if [[ "$OSTYPE" == "darwin"* ]]; then
+    # macOS
+    sed -i '' "s/^LATEST_VERSION=\".*\"/LATEST_VERSION=\"$new_version\"/" install.sh
+else
+    # Linux
+    sed -i "s/^LATEST_VERSION=\".*\"/LATEST_VERSION=\"$new_version\"/" install.sh
+fi
+
+echo "Version bumped to $new_version"
+echo "Updated files:"
+echo "  - Cargo.toml"
+echo "  - install.sh"
+'''

cli/protoc-gen-grafbase-subgraph/README.md

@@ -4,6 +4,24 @@ This binary crate is a protoc plugin that generates a GraphQL subgraph to be use
 
 ## Installation
 
+### Quick install with script
+
+You can install the latest version using the install script:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/grafbase/extensions/main/cli/protoc-gen-grafbase-subgraph/install.sh | bash
+```
+
+Or download and run manually:
+
+```bash
+curl -O https://raw.githubusercontent.com/grafbase/extensions/main/cli/protoc-gen-grafbase-subgraph/install.sh
+chmod +x install.sh
+./install.sh
+```
+
+### Manual installation
+
 Download the relevant binary from your platform from the [GitHub releases](https://github.com/grafbase/extensions/releases?q=protoc-gen-grafbase-subgraph&expanded=true).
 
 ## Usage with buf
@@ -436,16 +454,22 @@ type Mutation {
 
 ### Releasing
 
-To release a new version of the binary:
+To release a new version:
 
-1. Update the version number in `Cargo.toml`
-2. Create a tag with the format `protoc-gen-grafbase-subgraph-X.Y.Z` (e.g., `protoc-gen-grafbase-subgraph-0.2.0`)
-3. Push the tag to GitHub:
+1. **Bump version**: Run `cargo make bump` to update version in `Cargo.toml` and `install.sh`
+2. **Update changelog**: Edit `CHANGELOG.md` with release notes
+3. **Commit and push**: 
+   ```bash
+   git add Cargo.toml install.sh CHANGELOG.md
+   git commit -m "Bump protoc-gen-grafbase-subgraph to vX.Y.Z"
+   git push origin main
    ```
-   git tag protoc-gen-grafbase-subgraph-X.Y.Z
-   git push origin protoc-gen-grafbase-subgraph-X.Y.Z
-   ```
-4. The GitHub Actions workflow will automatically build the binary for multiple platforms and create a release with the artifacts
+
+The GitHub Actions workflow will automatically:
+- Detect the version change
+- Build binaries for macOS, Windows, Linux (x64/ARM64)
+- Create a GitHub release with tag `protoc-gen-grafbase-subgraph-vX.Y.Z`
+- Upload the binaries as release assets
 
 ## Prior art
 

cli/protoc-gen-grafbase-subgraph/install.sh

@@ -0,0 +1,95 @@
+#!/usr/bin/env bash
+
+set -e
+
+LATEST_VERSION="0.3.0"
+NAME="protoc-gen-grafbase-subgraph"
+
+echo "Installing $NAME v$LATEST_VERSION..."
+
+# Get the operating system and architecture
+OS=$(uname -s | tr '[:upper:]' '[:lower:]')
+ARCH=$(uname -m)
+
+# Map the OS and architecture to the target triple
+case "$OS" in
+    darwin)
+        case "$ARCH" in
+            x86_64)
+                TARGET="x86_64-apple-darwin"
+                ;;
+            arm64)
+                TARGET="aarch64-apple-darwin"
+                ;;
+            *)
+                echo "Error: Unsupported architecture $ARCH on macOS"
+                exit 1
+                ;;
+        esac
+        ;;
+    linux)
+        case "$ARCH" in
+            aarch64|arm64)
+                TARGET="aarch64-unknown-linux-musl"
+                ;;
+            x86_64)
+                TARGET="x86_64-unknown-linux-musl"
+                ;;
+            *)
+                echo "Error: Unsupported architecture $ARCH on Linux"
+                exit 1
+                ;;
+        esac
+        ;;
+    *)
+        echo "Error: Unsupported operating system $OS"
+        exit 1
+        ;;
+esac
+
+# Create the installation directory
+INSTALL_DIR="$HOME/.grafbase/bin"
+mkdir -p "$INSTALL_DIR"
+
+# Download the binary
+URL="https://github.com/grafbase/extensions/releases/download/$NAME-v$LATEST_VERSION/$NAME-$TARGET"
+echo "Downloading from $URL..."
+
+if command -v curl >/dev/null 2>&1; then
+    curl -sSL "$URL" -o "$INSTALL_DIR/$NAME"
+elif command -v wget >/dev/null 2>&1; then
+    wget -q "$URL" -O "$INSTALL_DIR/$NAME"
+else
+    echo "Error: Neither curl nor wget is installed"
+    exit 1
+fi
+
+# Make the binary executable
+chmod +x "$INSTALL_DIR/$NAME"
+
+echo "$NAME has been installed to $INSTALL_DIR/$NAME"
+
+# Check if the installation directory is in PATH
+if [[ ":$PATH:" != *":$INSTALL_DIR:"* ]]; then
+    echo ""
+    echo "Add $INSTALL_DIR to your PATH to use $NAME from anywhere."
+    echo ""
+    
+    # Detect the shell and provide instructions
+    if [ -n "$FISH_VERSION" ]; then
+        echo "For fish shell, add to ~/.config/fish/config.fish:"
+        echo "  fish_add_path $INSTALL_DIR"
+    elif [ -n "$ZSH_VERSION" ]; then
+        echo "For zsh, add to ~/.zshrc:"
+        echo "  export PATH=\"\$PATH:$INSTALL_DIR\""
+    elif [ -n "$BASH_VERSION" ]; then
+        echo "For bash, add to ~/.bashrc or ~/.bash_profile:"
+        echo "  export PATH=\"\$PATH:$INSTALL_DIR\""
+    else
+        echo "Add to your shell configuration file:"
+        echo "  export PATH=\"\$PATH:$INSTALL_DIR\""
+    fi
+fi
+
+echo ""
+echo "Installation complete! You can now use '$NAME'."