Skip to content
file-text

GitHub Action

Patch files

v1.0.5 Latest version

Patch files

file-text

Patch files

A simple action to patch JSON files

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Patch files

uses: onlyutkarsh/[email protected]

Learn more about this action in onlyutkarsh/patch-files-action

Choose a version

Patch files

A simple action to patch JSON files.

Only JSON files are supported at the moment. Support for other file types is planned in the later versions.

Inputs

  • files

    Glob expression. See example action YAML below. Required.

  • patch-syntax

    Use the operation syntax => value syntax to patch the JSON file. Required.

    Supported Operations:

    • + add. Example: + /version => "1.0.0"
    • - remove. Example: - /version Note: No value is passed.
    • = replace. Example: = /version => "1.0.1"

    Example:

    Input JSON:

    {
        "version": "1.0.0",
        "keywords": [],
        "bugs": {
            "url": "http://www.dummy.com"
        }
    }

    Patch Syntax:

    patch-syntax: |
          = /version => "1.0.1"
          + /author => "John Smith"
          = /bugs/url => "https://www.mydomain.com"

    Output JSON:

    {
        "version": "1.0.1",
        "keywords": [],
        "author": "John Smith",
        "bugs": {
            "url": "https://www.mydomain.com"
        }
    }
  • output-patched-file

    If true, the patched content is printed in the logs. Optional. Default is true.

  • fail-if-no-files-patched

    If true, fails the build, if no files are patched. Optional. Default is false.

  • fail-if-error

    If true, failes the build when an error occurrs. Optional. Default is false

Sample action

name: "test action"
on:
  pull_request:
  push:
    branches:
      - master
      - 'feature/*'

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v1

    - name: Patch files
      uses: onlyutkarsh/[email protected]
      env:
        name: utkarsh
      with:
        files: |
          testfiles/**/*.json
        patch-syntax: |
          = /version => "1.0.1"
          + /author => "${{ env.name }}"
          = /bugs/url => "https://www.google.com"
          + /buildId => "${{ github.run_number }}"

Acknowledgment