Prepare for v0.1.0 release

chaitan94 · claude · chaitan94 · commit d22a0066d659 · 2025-07-30T23:54:44.000+05:30
- Add automated release workflow with cross-platform binary builds - Update README with comprehensive installation instructions - Add CHANGELOG.md following Keep a Changelog format - Configure GitHub releases with automatic changelog generation 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -0,0 +1,124 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        include:
+          - goos: linux
+            goarch: amd64
+          - goos: linux
+            goarch: arm64
+          - goos: darwin
+            goarch: amd64
+          - goos: darwin
+            goarch: arm64
+          - goos: windows
+            goarch: amd64
+            ext: .exe
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: "1.22"
+
+      - name: Get version
+        id: version
+        run: echo "VERSION=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT
+
+      - name: Build binary
+        env:
+          GOOS: ${{ matrix.goos }}
+          GOARCH: ${{ matrix.goarch }}
+          CGO_ENABLED: 0
+        run: |
+          BINARY_NAME="aws-sso-util-${{ matrix.goos }}-${{ matrix.goarch }}${{ matrix.ext }}"
+          go build -ldflags "-X main.version=${{ steps.version.outputs.VERSION }}" -o $BINARY_NAME ./cmd/aws-sso-util
+
+          # Create archive
+          if [ "${{ matrix.goos }}" = "windows" ]; then
+            zip "${BINARY_NAME%.exe}.zip" $BINARY_NAME
+            echo "ASSET=${BINARY_NAME%.exe}.zip" >> $GITHUB_ENV
+          else
+            tar -czf "${BINARY_NAME}.tar.gz" $BINARY_NAME
+            echo "ASSET=${BINARY_NAME}.tar.gz" >> $GITHUB_ENV
+          fi
+
+      - name: Upload Release Asset
+        uses: actions/upload-artifact@v3
+        with:
+          name: ${{ env.ASSET }}
+          path: ${{ env.ASSET }}
+
+  release:
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Download all artifacts
+        uses: actions/download-artifact@v3
+        with:
+          path: artifacts
+
+      - name: Generate changelog
+        id: changelog
+        run: |
+          if [ $(git tag --list | wc -l) -eq 1 ]; then
+            # First release
+            echo "CHANGELOG=Initial release of aws-sso-lib-go" >> $GITHUB_OUTPUT
+          else
+            # Get previous tag
+            PREV_TAG=$(git tag --sort=-version:refname | sed -n '2p')
+            echo "CHANGELOG<<EOF" >> $GITHUB_OUTPUT
+            git log --pretty=format:"- %s" ${PREV_TAG}..HEAD >> $GITHUB_OUTPUT
+            echo "" >> $GITHUB_OUTPUT
+            echo "EOF" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v1
+        with:
+          tag_name: ${{ github.ref_name }}
+          name: Release ${{ github.ref_name }}
+          body: |
+            ## Changes
+
+            ${{ steps.changelog.outputs.CHANGELOG }}
+
+            ## Installation
+
+            ### Go Install
+            ```bash
+            go install github.com/adonmo/aws-sso-lib-go/cmd/aws-sso-util@${{ github.ref_name }}
+            ```
+
+            ### Download Binary
+            Download the appropriate binary for your platform from the assets below.
+
+            ### Library Usage
+            ```bash
+            go get github.com/adonmo/aws-sso-lib-go@${{ github.ref_name }}
+            ```
+
+            ## Checksums
+
+            All binaries are built with Go ${{ env.GO_VERSION }} and include checksums for verification.
+          files: |
+            artifacts/**/*
+          draft: false
+          prerelease: false
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -0,0 +1,51 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2024-07-30
+
+### Added
+- Initial release of aws-sso-lib-go
+- Core library (`awsssolib`) for programmatic AWS SSO access
+- Full-featured CLI tool (`aws-sso-util`) with comprehensive command set
+- Interactive browser-based SSO authentication
+- Token and credential caching (file and memory backends)
+- AWS CLI profile management and bulk population
+- Cross-platform support (Linux, macOS, Windows)
+
+#### Library Features
+- `GetAWSConfig`: Get AWS SDK v2 config for specific account/role
+- `Login`/`Logout`: Interactive SSO authentication with browser support
+- `ListAvailableAccounts`/`ListAvailableRoles`: Discover available resources
+- Configuration management for AWS profiles
+- Comprehensive caching system for tokens and credentials
+
+#### CLI Commands
+- `login`/`logout`: Manage SSO sessions
+- `roles`: List available accounts and roles
+- `configure profile`: Configure individual AWS CLI profiles
+- `configure populate`: Bulk create profiles for all available access
+- `run-as`: Execute commands with specific credentials
+- `check`: Diagnose SSO configuration and access issues
+- `credential-process`: AWS CLI credential process integration
+
+#### Development
+- Comprehensive unit tests
+- CI/CD pipeline with GitHub Actions
+- Cross-platform binary builds
+- Example usage code
+- Complete documentation
+
+### Technical Details
+- Built with Go 1.21+
+- Uses AWS SDK for Go v2
+- Cobra CLI framework
+- Compatible with existing AWS SSO workflows
+
+[Unreleased]: https://github.com/adonmo/aws-sso-lib-go/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/adonmo/aws-sso-lib-go/releases/tag/v0.1.0
diff --git a/README.md b/README.md
@@ -23,24 +23,42 @@ This project is inspired by the Python [aws-sso-util](https://github.com/benkeho
 
 ## Installation
 
-### Library
+### CLI Tool
 
+#### Go Install (Recommended)
 ```bash
-go get github.com/adonmo/aws-sso-lib-go
+go install github.com/adonmo/aws-sso-lib-go/cmd/aws-sso-util@latest
 ```
 
-### CLI Tool
+#### Download Pre-built Binaries
+Download the latest release from [GitHub Releases](https://github.com/adonmo/aws-sso-lib-go/releases):
 
 ```bash
-go install github.com/adonmo/aws-sso-lib-go/cmd/aws-sso-util@latest
-```
+# Linux (x64)
+curl -L https://github.com/adonmo/aws-sso-lib-go/releases/latest/download/aws-sso-util-linux-amd64.tar.gz | tar xz
 
-Or build from source:
+# macOS (Intel)
+curl -L https://github.com/adonmo/aws-sso-lib-go/releases/latest/download/aws-sso-util-darwin-amd64.tar.gz | tar xz
 
+# macOS (Apple Silicon)
+curl -L https://github.com/adonmo/aws-sso-lib-go/releases/latest/download/aws-sso-util-darwin-arm64.tar.gz | tar xz
+
+# Windows
+# Download aws-sso-util-windows-amd64.zip from releases page
+```
+
+#### Build from Source
 ```bash
 git clone https://github.com/adonmo/aws-sso-lib-go.git
 cd aws-sso-lib-go
-go build -o aws-sso-util ./cmd/aws-sso-util
+make build
+# Binary will be in ./dist/aws-sso-util
+```
+
+### Library
+
+```bash
+go get github.com/adonmo/aws-sso-lib-go
 ```
 
 ## Library Usage
