This content originally appeared on DEV Community and was authored by Jonah Lawrence

My Workflow

Readme Download Button Action is a new workflow that allows you to keep a direct download link of the latest version of your repo in your README file.

Example download button generated by the workflow:

The steps for setting up the workflow are explained in detail on the GitHub repository.

Getting started

name: "Download Button Action"
on:
  release:
    types:
      - published
  workflow_dispatch:
jobs:
  release:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Get latest release
        id: get-latest-release
        uses: InsonusK/get-latest-release@v1.0.1
        with:
          myToken: ${{ github.token }}
          view_top: 1
      - name: Readme Download Button Action
        env:
          GITHUB_USER: "DenverCoder1"
          REPO: "readme-download-button-action"
          FORMAT: "zip"
          VERSION: "${{ steps.get-latest-release.outputs.tag_name }}"
          COLOR: "blue"
          BEGIN_TAG: "<!-- BEGIN LATEST DOWNLOAD BUTTON -->"
          END_TAG: "<!-- END LATEST DOWNLOAD BUTTON -->"
        run: |
          UPDATE=$(cat README.md | perl -0777 -pe 's#(${{ env.BEGIN_TAG }})(?:.|\n)*?(${{ env.END_TAG }})#${1}\n[![Download ${{ env.FORMAT }}](https://custom-icon-badges.herokuapp.com/badge/-Download-${{ env.COLOR }}?style=for-the-badge&logo=download&logoColor=white "Download ${{ env.FORMAT }}")](https://github.com/${{ env.GITHUB_USER }}/${{ env.REPO }}/archive/${{ env.VERSION }}.${{ env.FORMAT }})\n${2}#g')
          echo "${UPDATE}" > README.md
      - uses: EndBug/add-and-commit@v7
        with:
          message: "docs(readme): Bump download button version to ${{ steps.get-latest-release.outputs.tag_name }}"
          default_author: github_actions
          branch: main

Submission Category:

Maintainer Must-Haves

Yaml File or Link to Code

DenverCoder1 / readme-download-button-action

GitHub Action workflow configuration for keeping a direct download link to the latest version on your repo's readme

Readme Download Button Action

GitHub Action workflow configuration for keeping a direct download link of the latest version in your README.md file.

Example

With a single click of the button below, a zip of this repository will start downloading.

The URL this button leads to is automatically updated on each release by this workflow.

Basic Usage

This workflow consists mainly of four parts:

Checkout the latest version of the repo with actions/checkout
Get the latest release with InsonusK/get-latest-release
Insert a download button for the latest version in the readme using a custom shell script
Update the readme with EndBug/add-and-commit

Step 1

Add the following snippet within your README.md file anywhere you want the button to appear:

<!-- BEGIN LATEST DOWNLOAD BUTTON -->
<!-- END LATEST DOWNLOAD BUTTON -->

Step 2

Create a workflow by placing the following in a .yml file in your .github/workflows/ directory:

name: "Download

…

View on GitHub

Background

This project was created due to the fact that many users may come to a repository to download a project but are not familiar enough with the site to navigate the repository and find a proper download link.

This workflow aims to simplify the process, by putting a download button front and center in the Readme so it can't be missed.

Having a download button on the Readme allows visiting users to quickly download your source code with just a single click!

Why does this require a workflow?

In order to make the process a single click away, a direct download link must be included.

For example, a link to download the source code of version 1.0.1 of readme-download-button-action will look like this: https://github.com/DenverCoder1/readme-download-button-action/archive/1.0.1.zip.

Notice that the url contains 1.0.1, the version. This number changes with every new version released, so in order to keep the download button up-to-date, we will have to update the readme to change the link.

That's where this workflow comes in. With just a few seconds of one-time configuration, your button will be generated and automatically kept up to date whenever you make a new release.

Making of this workflow

First, we need to set the trigger event. A good choice here is when we publish a release. Additionally workflow_dispatch: is added so that it can be manually triggered from the Actions tab in case you want to re-run it without creating a new release.

on:
  release:
    types:
      - published
  workflow_dispatch:

Next, we create some steps:

Checkout

In order to be able to read and overwrite the files in the repo such as the readme, we will need to first checkout the repository.

- uses: actions/checkout@v2

Get Latest Release

The following workflow by InsonusK allows us to get info on the latest release. We can access the tag name later using ${{ steps.get-latest-release.outputs.tag_name }}

- name: Get latest release
  id: get-latest-release
  uses: InsonusK/get-latest-release@v1.0.1
  with:
    myToken: ${{ github.token }}
    view_top: 1

The custom shell script

The actual replacement of the button is done with a shell step:

- name: Readme Download Button Action
  env:
    GITHUB_USER: "DenverCoder1"
    REPO: "readme-download-button-action"
    FORMAT: "zip"
    VERSION: "${{ steps.get-latest-release.outputs.tag_name }}"
    COLOR: "blue"
    BEGIN_TAG: "<!-- BEGIN LATEST DOWNLOAD BUTTON -->"
    END_TAG: "<!-- END LATEST DOWNLOAD BUTTON -->"
  run: |
    UPDATE=$(cat README.md | perl -0777 -pe 's#(${{ env.BEGIN_TAG }})(?:.|\n)*?(${{ env.END_TAG }})#${1}\n[![Download ${{ env.FORMAT }}](https://custom-icon-badges.herokuapp.com/badge/-Download-${{ env.COLOR }}?style=for-the-badge&logo=download&logoColor=white "Download ${{ env.FORMAT }}")](https://github.com/${{ env.GITHUB_USER }}/${{ env.REPO }}/archive/${{ env.VERSION }}.${{ env.FORMAT }})\n${2}#g')
    echo "${UPDATE}" > README.md

perl is used here to make a multiline replacement using regular expressions. At first I was going to try sed but it deals with lines one at a time, so it's much more complicated when dealing with multiline matches.

An env section also appears to make configuring the download button as simple as possible.

Add and commit

Finally we can use EndBug's add-and-commit to make the change persist!

- uses: EndBug/add-and-commit@v7
  with:
    message: "docs(readme): Bump download button version to ${{ steps.get-latest-release.outputs.tag_name }}"
    default_author: github_actions
    branch: main

Additional Resources / Info

This action works great in combination with several open-source workflows:

InsonusK/get-latest-release - Determine the tag for the latest release
EndBug/add-and-commit - Commit your changes
tvdias/github-tagger - Create new tags to push to
fregante/release-with-changelog - generate changelogs for your releases

This content originally appeared on DEV Community and was authored by Jonah Lawrence

Print Share Comment Cite Upload Translate Updates

APA

Jonah Lawrence | Sciencx (2021-12-06T01:37:41+00:00) GitHub Action for Updating Your Readme with a Download Button. Retrieved from https://www.scien.cx/2021/12/06/github-action-for-updating-your-readme-with-a-download-button/

MLA

" » GitHub Action for Updating Your Readme with a Download Button." Jonah Lawrence | Sciencx - Monday December 6, 2021, https://www.scien.cx/2021/12/06/github-action-for-updating-your-readme-with-a-download-button/

HARVARD

Jonah Lawrence | Sciencx Monday December 6, 2021 » GitHub Action for Updating Your Readme with a Download Button., viewed ,<https://www.scien.cx/2021/12/06/github-action-for-updating-your-readme-with-a-download-button/>

VANCOUVER

Jonah Lawrence | Sciencx - » GitHub Action for Updating Your Readme with a Download Button. [Internet]. [Accessed ]. Available from: https://www.scien.cx/2021/12/06/github-action-for-updating-your-readme-with-a-download-button/

CHICAGO

" » GitHub Action for Updating Your Readme with a Download Button." Jonah Lawrence | Sciencx - Accessed . https://www.scien.cx/2021/12/06/github-action-for-updating-your-readme-with-a-download-button/

IEEE

" » GitHub Action for Updating Your Readme with a Download Button." Jonah Lawrence | Sciencx [Online]. Available: https://www.scien.cx/2021/12/06/github-action-for-updating-your-readme-with-a-download-button/. [Accessed: ]

rf:citation

» GitHub Action for Updating Your Readme with a Download Button | Jonah Lawrence | Sciencx | https://www.scien.cx/2021/12/06/github-action-for-updating-your-readme-with-a-download-button/ |

Please log in to upload a file.

There are no updates yet.
Click the Upload button above to add an update.

You must be logged in to translate posts. Please log in or register.