Merge pull request #8 from dargmuesli/example_scheduled-releases

docs(examples): "add scheduled release" example

README.md

@@ -6,15 +6,16 @@ Github Action that gets the latest tag from git
 
 ## Output
 
-This action has only one output, namely, `tag` for the latest tag this action finds. When no tag is found or another 
-error occurs it exits with code `1`.
+This action has only one output, namely, `tag` for the latest tag this action finds.
+When no tag is found or another error occurs it exits with code `1`.
 
 ## Example
 
-The following example works together with the [`WyriHaximus/github-action-next-semvers`](https://github.com/marketplace/actions/next-semvers) 
-and [`WyriHaximus/github-action-create-milestone`](https://github.com/marketplace/actions/create-milestone) actions. 
-Where it provides the previous tag from that action so it can supply a set of versions for the next action, which 
-creates a new milestone. (This snippet has been taken from the automatic code generation of [`wyrihaximus/fake-php-version`](https://github.com/wyrihaximus/php-fake-php-version/).)
+Find more examples in the [examples directory](./examples/).
+
+The following example works together with the [`WyriHaximus/github-action-next-semvers`](https://github.com/marketplace/actions/next-semvers) and [`WyriHaximus/github-action-create-milestone`](https://github.com/marketplace/actions/create-milestone) actions.
+Where it provides the previous tag from that action so it can supply a set of versions for the next action, which creates a new milestone.
+(This snippet has been taken from the automatic code generation of [`wyrihaximus/fake-php-version`](https://github.com/wyrihaximus/php-fake-php-version/).)
 
 ```yaml
 name: Generate

examples/scheduled-release.md

@@ -0,0 +1,65 @@
+# Scheduled Release
+
+This example demonstrates how a release schedule can be limited to only occur if there have been no other releases in the past week.
+
+```yaml
+name: Scheduled Release
+
+on:
+  schedule:
+    - cron:  '0 0 * * 1' # Every Monday at 00:00 AM UTC on the default branch
+
+jobs:
+  analyze-tags:
+    runs-on: ubuntu-latest
+    outputs:
+      previous-tag: ${{ steps.previoustag.outputs.tag }}
+      timestamp-diff: ${{ steps.diff.outputs.timestamp-diff }}
+    steps:
+      - uses: actions/[email protected]
+        with:
+          fetch-depth: 0
+      #▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼#
+      - name: Get previous tag
+        id: previoustag
+        uses: "WyriHaximus/[email protected]"
+      #▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲#
+      - name: Get seconds from previous tag to now
+        id: diff
+        shell: bash
+        env:
+          TIMESTAMP_TAG: ${{ steps.previoustag.outputs.timestamp }}
+        run: |
+          echo "::set-output name=timestamp-diff::$(expr $(printf '%(%s)T') - $TIMESTAMP_TAG)"
+
+  schedule-release:
+    runs-on: ubuntu-latest
+    needs: analyze-tags
+    if: needs.analyze-tags.outputs.timestamp-diff > 604800 # 604800 equal one week.
+    steps:
+      - uses: actions/[email protected]
+        with:
+          token: ${{ secrets.GH_TOKEN }}
+      - name: Get next minor version
+        id: semvers
+        uses: "WyriHaximus/[email protected]"
+        with:
+          version: ${{ needs.analyze-tags.outputs.previous-tag }}
+
+      # Now schedule the release...
+
+      # In the example below, a file is changed
+      # (the scheduled tag is written to an arbitrary property within a package.json file).
+      # The following commit would then trigger a semantic release through a following workflow
+      # (https://github.com/semantic-release/semantic-release)
+
+      - name: manifest Version
+        uses: deef0000dragon1/json-edit-action/@v1
+        env:
+          KEY: scheduleVersion
+          VALUE: ${{ steps.semvers.outputs.patch }}
+          FILE: package.json
+      - uses: stefanzweifel/[email protected]
+        with:
+          commit_message: 'fix(release): schedule release'
+```