create deploy script and example project

Author: soerenkoehler

.github/workflows/bash-util-github-release.yml

@@ -0,0 +1,24 @@
+name: bash-util-github-release
+
+on:
+  push
+
+jobs:
+  build-and-release:
+    name: build and release
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: checkout
+        uses: actions/[email protected]
+
+      - name: "build: create some release artifacts"
+        run: |
+          mkdir ./dist
+          printf "dummy" >./dist/file1.zip
+          printf "dummy" >./dist/file2.exe
+
+      - name: "deploy: create release and upload artifacts"
+        run: ./github-release.sh
+        env:
+          GH_TOKEN: ${{ github.token }}

.gitignore

@@ -1,2 +1,23 @@
-# rs-util-github-release
-A tool for creating Github releases with artifacts.
+# bash-util-github-release
+
+## What
+
+An example project for creating Github releases with artifacts.
+
+## How
+
+1.  Create a Github workflow that produces release assets in the dir `./dist`.
+2.  Copy `github-release.sh` and run it as in the deploy-step of the example
+    workflow.
+3.  Trigger the workflow:
+
+    *   **Pushing to a branch:**  
+        The script will create (or replace) a _nightly_ release.
+
+    *   **Create a tag _tag name_ in git and push it to Github:**  
+        The script will create the respective _tag name_ release in Github.
+
+    *   **Creating a release in Github:**  
+        The script will reuse the release created in Github.
+
+    In all cases the script uploads the asset files to the release.

README.md

@@ -0,0 +1,8 @@
+{
+    "folders": [
+        {
+            "path": "."
+        }
+    ],
+    "settings": {}
+}

bash-util-github-release.code-workspace

@@ -0,0 +1,77 @@
+#!/bin/bash
+
+fetch_tags() {
+    git fetch --all --force --tags --prune-tags --prune
+}
+
+create_release_nightly() {
+    printf "create/replace release 'nightly' on branch %s\n" $GITHUB_REF_NAME
+
+    fetch_tags
+
+    RELEASE=nightly
+    gh release delete \
+        --cleanup-tag \
+        --yes \
+        $RELEASE \
+        2>/dev/null || true
+
+    # Workaround for https://github.com/cli/cli/issues/8458
+    printf "waiting for tag to be deleted\n"
+    while fetch_tags; git tag -l | grep $RELEASE; do
+        sleep 10;
+        printf "still waiting...\n"
+    done
+
+    fetch_tags
+
+    gh release create \
+        --title "Nightly" \
+        --notes "$(date +'%Y-%m-%d %H:%M:%S')" \
+        --target $GITHUB_REF \
+        --latest=false \
+        $RELEASE
+
+    fetch_tags
+}
+
+create_release_prod() {
+    EXISTING=$(gh release list \
+        --json tagName \
+        --jq "[.[] | select(.tagName == \"$RELEASE\").tagName][0]")
+
+    if [[ -z $EXISTING ]]; then
+        printf "create new release '%s'\n" $RELEASE
+        gh release create \
+            --title $RELEASE \
+            --notes "$(date +'%Y-%m-%d %H:%M:%S')" \
+            --verify-tag \
+            $RELEASE
+    else
+        printf "use existing release '%s'\n" $RELEASE
+    fi
+}
+
+upload_artifacts() {
+    printf "uploading artifacts to '%s'\n" $RELEASE
+
+    gh release upload --clobber $RELEASE $DISTDIR/*
+}
+
+DISTDIR="./dist"
+
+printf "verify github auth status:\n%s\n\n" "$(gh auth status)"
+
+if [[ $GITHUB_REF_TYPE == 'tag' ]]; then
+    RELEASE=$GITHUB_REF_NAME
+    create_release_prod
+elif [[ $GITHUB_REF_TYPE == 'branch' ]]; then
+    RELEASE="nightly"
+    create_release_nightly
+fi
+
+if [[ -e $DISTDIR ]]; then
+    upload_artifacts
+else
+    printf "no artifacts to upload\n"
+fi