Release: v1.0.1

.github/workflows/publish-docs.yml

@@ -0,0 +1,20 @@
+name: Publish Docs
+
+on:
+  push:
+    branches: [ develop ]
+
+jobs:
+
+  publish-docs:
+    runs-on: ubuntu-latest
+    steps:
+
+    - name: 'Update holobranch: gh-pages'
+      uses: JarvusInnovations/hologit@actions/projector/v1
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        HAB_LICENSE: accept
+      with:
+        holobranch: docs-site
+        commit-to: gh-pages

.github/workflows/publish-holobranches.yml

@@ -0,0 +1,20 @@
+name: Publish Holobranches
+
+on:
+  push:
+    tags: [ 'v1.*' ]
+
+jobs:
+
+  publish-holobranches:
+    runs-on: ubuntu-latest
+    steps:
+
+    - name: 'Update holobranch: emergence/site/v1'
+      uses: JarvusInnovations/hologit@actions/projector/v1
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        HAB_LICENSE: accept
+      with:
+        holobranch: emergence-site
+        commit-to: emergence/site/v1

.github/workflows/release-deploy.yml

@@ -0,0 +1,43 @@
+name: 'Release: Deploy PR'
+
+on:
+  pull_request:
+    branches: [ 'releases/v*' ]
+    types: [ closed ]
+
+jobs:
+  release-deploy:
+
+    if: github.event.pull_request.merged == true # only run on PR merge
+    runs-on: ubuntu-latest
+    steps:
+
+    - name: Configure release
+      run: |
+        PR_TITLE=$(jq -r ".pull_request.title" $GITHUB_EVENT_PATH)
+        PR_BODY=$(jq -r ".pull_request.body" $GITHUB_EVENT_PATH)
+        RELEASE_TAG=$(echo "${PR_TITLE}" | grep -oP "(?<=^Release: )v\d+\.\d+\.\d+(-rc\.\d+)?$")
+
+        if [[ "${RELEASE_TAG}" =~ -rc\.[0-9]+$ ]]; then
+          RELEASE_PRERELEASE=true
+        else
+          RELEASE_PRERELEASE=false
+        fi
+
+        echo "PR_TITLE=${PR_TITLE}" >> $GITHUB_ENV
+        echo "RELEASE_TAG=${RELEASE_TAG}" >> $GITHUB_ENV
+        echo "RELEASE_PRERELEASE=${RELEASE_PRERELEASE}" >> $GITHUB_ENV
+
+        echo 'PR_BODY<<END_OF_PR_BODY' >> $GITHUB_ENV
+        echo "${PR_BODY}" >> $GITHUB_ENV
+        echo 'END_OF_PR_BODY' >> $GITHUB_ENV
+
+    - name: Create release
+      uses: ncipollo/release-action@v1
+      with:
+        token: ${{ secrets.BOT_GITHUB_TOKEN }}
+        commit: '${{ github.sha }}'
+        tag: '${{ env.RELEASE_TAG }}'
+        body: '${{ env.PR_BODY }}'
+        draft: false
+        prerelease: ${{ env.RELEASE_PRERELEASE }}

.github/workflows/release-prepare.yml

@@ -0,0 +1,114 @@
+name: 'Release: Prepare PR'
+
+on:
+  push:
+    branches: [ develop ]
+
+env:
+  GITHUB_USERNAME: codeforphilly-bot
+  GITHUB_TOKEN: ${{ secrets.BOT_GITHUB_TOKEN }}
+  RELEASE_BRANCH: releases/v1
+
+jobs:
+  release-prepare:
+
+    runs-on: ubuntu-latest
+    steps:
+
+    - uses: actions/checkout@v2
+      with:
+        fetch-depth: 0
+
+    # - uses: mxschmitt/action-tmate@v3
+
+    - name: Create/update pull request
+      run: |
+        # get latest release tag
+        latest_release=$(git describe --tags --abbrev=0 "origin/${RELEASE_BRANCH}")
+        latest_release_bumped=$(echo $latest_release | awk -F. -v OFS=. '{$NF++;print}')
+
+
+        # create or update PR
+        pr_body="$(cat <<EOF
+        Release: ${latest_release_bumped}
+
+        ## Improvements
+
+        ## Technical
+
+        EOF
+        )"
+
+        pr_number=$(hub pr list -h develop -f '%I')
+
+        if [ -n "${pr_number}" ]; then
+          echo "Updating PR #${pr_number}"
+          existing_comment_id=$(hub api "/repos/${GITHUB_REPOSITORY}/issues/${pr_number}/comments" | jq '.[] | select(.user.login=="${GITHUB_USERNAME}") | .id')
+        else
+          echo "Opening PR"
+          hub pull-request -b "${RELEASE_BRANCH}" -h develop -F <(echo "${pr_body}") > /tmp/pr.json
+          pr_number=$(hub pr list -h develop -f '%I')
+          echo "Opened PR #${pr_number}"
+        fi
+
+
+        # build changelog
+        commits=$(
+          git log \
+            --first-parent \
+            --reverse \
+            --format="%H" \
+            "origin/${RELEASE_BRANCH}..develop"
+        )
+
+        changelog=()
+
+        while read -r commit; do
+          subject="$(git show -s --format=%s "${commit}")"
+          line=""
+
+          if [[ "${subject}" =~ Merge\ pull\ request\ \#([0-9]+) ]]; then
+            line="$(hub pr show -f '%t [%i] @%au' "${BASH_REMATCH[1]}" || true)"
+          fi
+
+          if [ -z "${line}" ]; then
+            author="$(hub api "/repos/${GITHUB_REPOSITORY}/commits/${commit}" -H Accept:application/vnd.github.v3+json | jq -r '.author.login')"
+            if [ -n "${author}" ]; then
+              author="@${author}"
+            else
+              author="$(git show -s --format=%ae "${commit}")"
+            fi
+
+            line="${subject} ${author}"
+          fi
+
+          # move ticket number prefix into to existing square brackets at end
+          line="$(echo "${line}" | perl -pe 's/^([A-Z]+-[0-9]+):?\s*(.*?)\s*\[([^]]+)\]\s*(\S+)$/\2 [\3, \1] \4/')"
+
+          # move ticket number prefix into to new square brackets at end
+          line="$(echo "${line}" | perl -pe 's/^([A-Z]+-[0-9]+):?\s*(.*?)\s*(\S+)$/\2 [\1] \3/')"
+
+          # combine doubled square brackets at the end
+          line="$(echo "${line}" | perl -pe 's/^\s*(.*?)\s*\[([A-Z]+-[0-9]+)\]\s*\[([^]]+)\]\s*(\S+)$/\1 [\3, \2] \4/')"
+
+          changelog+=("- ${line}")
+        done <<< "${commits}"
+
+
+        # create or update comment
+        comment_body="$(cat <<EOF
+        ## Changelog
+
+        \`\`\`markdown
+        $(IFS=$'\n'; echo "${changelog[*]}")
+        \`\`\`
+        EOF
+        )"
+
+        if [ -n "${existing_comment_id}" ]; then
+          echo "Updating comment #${existing_comment_id}"
+          hub api "/repos/${GITHUB_REPOSITORY}/issues/comments/${existing_comment_id}" -f body="${comment_body}"
+        else
+          echo "Creating comment"
+          hub api "/repos/${GITHUB_REPOSITORY}/issues/${pr_number}/comments" -f body="${comment_body}"
+        fi

.github/workflows/release-validate.yml

@@ -0,0 +1,34 @@
+name: 'Release: Validate PR'
+
+on:
+  pull_request:
+    branches: [ 'releases/v*' ]
+    types: [ opened, edited, reopened, synchronize ]
+
+env:
+  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+jobs:
+  release-validate:
+
+    runs-on: ubuntu-latest
+    steps:
+
+    - name: Validate PR title
+      run: |
+        PR_TITLE=$(jq -r ".pull_request.title" $GITHUB_EVENT_PATH)
+
+        # check title format and extract tag
+        if [[ "${PR_TITLE}" =~ ^Release:\ v[0-9]+\.[0-9]+\.[0-9]+(-rc\.[0-9]+)?$ ]]; then
+            RELEASE_TAG="${PR_TITLE:9}"
+            echo "RELEASE_TAG=${RELEASE_TAG}" >> $GITHUB_ENV
+        else
+            echo 'PR title must match format "Release: vX.Y.Z(-rc.#)?"'
+            exit 1
+        fi
+
+        # check that tag doesn't exist
+        if git ls-remote --exit-code "https://${GITHUB_ACTOR}:${GITHUB_TOKEN}@github.com/${GITHUB_REPOSITORY}" "refs/tags/${RELEASE_TAG}"; then
+            echo "The PR title's version exists already"
+            exit 1
+        fi

.holo/branches/docs-site/_codeforphilly.toml

@@ -0,0 +1,5 @@
+[holomapping]
+files = [
+    "docs/**",
+    "mkdocs.*.yml"
+]

.holo/branches/docs-site/_laddr.toml

@@ -0,0 +1,4 @@
+[holomapping]
+holosource="=>docs-skeleton"
+files = "**"
+before = "*"

.holo/branches/emergence-site/_codeforphilly.toml

@@ -1,3 +1,16 @@
 [holomapping]
-files = "*/**"
+files = [
+    "*/**",
+
+    # exclude CI and developer assets
+    "!.github/",
+    "!.vscode/",
+    "!cypress/",
+    "!docs/",
+    "!fixtures/",
+    "!habitat/",
+    "!helm-chart/",
+    "!php-config/Git.config.d/",
+    "!script/",
+]
 after = "*"

.holo/branches/emergence-site/_laddr.toml

@@ -1,3 +1,4 @@
 [holomapping]
-files = "*/**"
+holosource="=>emergence-skeleton"
+files = "**"
 before = "*"

.holo/sources/laddr.toml

@@ -1,3 +1,3 @@
 [holosource]
 url = "https://github.com/CodeForPhilly/laddr"
-ref = "refs/heads/emergence/skeleton/v3"
+ref = "refs/tags/v3.0.1"

.studiorc

@@ -1,3 +1,20 @@
 #!/bin/bash
-hab pkg install emergence/studio
+
+# install dependent studios
+hab pkg install emergence/studio jarvus/mkdocs-studio
+
+# disable studios printing their own help
+export STUDIO_NOHELP="yes"
+
 source "$(hab pkg path emergence/studio)/studio.sh"
+
+export DOCS_HOLOBRANCH="docs-site"
+source "$(hab pkg path jarvus/mkdocs-studio)/studio.sh"
+
+
+## final init and output
+studio-help
+
+
+# final blank line
+echo

mkdocs.repo.yml

@@ -0,0 +1,6 @@
+repo_url: https://github.com/CodeForPhilly/codeforphilly
+
+extra:
+  repository:
+    name: laddr
+    url: git@github.com:CodeForPhilly/codeforphilly.git

mkdocs.site.yml

@@ -0,0 +1,7 @@
+site_name: CodeForPhilly.org Docs
+site_url: https://codeforphilly.github.io/codeforphilly
+
+theme:
+  palette:
+    primary: "red"
+    accent: "blue"

mkdocs.studio.yml

@@ -0,0 +1,6 @@
+extra:
+  studio:
+    name: codeforphilly-studio
+    web_port: 9080
+    docs_port: 9088
+    mysql_port: 9086

php-config/Git.config.d/codeforphilly.php

@@ -11,7 +11,8 @@
         'newsletters',
         'php-classes',
         'php-config/Git.config.d',
+        'php-config/Laddr',
         'php-config/Laddr.config.d',
         'site-root'
     ]
-];
+];