I want to read a JSON file and use a property in a string in a Github Actions YAML file. How do I do this?
(I want the version of the package.json
)
-
what part of your workflow do you want to read this file?– smac89May 20, 2020 at 18:21
-
Of course this is limitative, but if what you need is the version, you could use this: github.com/marketplace/actions/ga-project-version– EuberDeveloperAug 18, 2021 at 21:24
-
That literally does this lmao– exoRiftAug 19, 2021 at 23:04
9 Answers
Use the built-in fromJson(value)
(see here: https://docs.github.com/en/actions/learn-github-actions/expressions#fromjson)
Reading a file depends on the shell you're using. Here's an example for sh
:
name: Test linux job
on:
push
jobs:
testJob:
name: Test
runs-on: ubuntu-latest
steps:
- id: set_var
run: |
content=`cat ./path/to/package.json`
# the following lines are only required for multi line json
content="${content//'%'/'%25'}"
content="${content//$'\n'/'%0A'}"
content="${content//$'\r'/'%0D'}"
# end of optional handling for multi line json
echo "::set-output name=packageJson::$content"
- run: |
echo "${{fromJson(steps.set_var.outputs.packageJson).version}}"
Multi line JSON handling as per https://github.com/orgs/community/discussions/26288#discussioncomment-3251220.
GitHub issue about set-env
/ set-output
multi line handling: https://github.com/actions/toolkit/issues/403
-
2How to access the object's property after using fromJson? echo result.property or $result.property or ${ result.property } or ${{ result.property }}?– michaelJul 28, 2021 at 14:11
-
michael's comment was asked as a separate question here: stackoverflow.com/questions/68557487/…– riQQMar 1, 2022 at 12:33
-
Can you provide Powershell alternative for Windows Runner for the multline json and matrix conversion? Mar 24, 2022 at 1:48
-
Since I don't care about preserving newlines, I did something like
cat package.json | tr '\n\r' ' '
although that doesn't solve encoding % signs properly. Mar 25, 2022 at 16:44 -
You can also use
jq
to quickly get json data:cat package.json | jq '.version'
Mar 25, 2022 at 17:07
Use a multi line environment variable:
- run: |
echo 'PACKAGE_JSON<<EOF' >> $GITHUB_ENV
cat ./package.json >> $GITHUB_ENV
echo 'EOF' >> $GITHUB_ENV
- run: |
echo '${{ fromJson(env.PACKAGE_JSON).version }}'
This avoids any need for escaping.
-
Using your code verbatim makes my YAML lint complain:
Implicit keys need to be on a single line
Sep 7, 2022 at 13:57 -
1@Reinsbrain Something did not line out well after copy and pasting. Adding another indentation fixed that error for me.– ChielMar 31 at 13:23
Below is a version of the example from Official GHA Docs that includes two changes:
- Loads json from a file (
./your.json
) - Removes newline characters (Source)
- Uses
fromJson
to parse the output and set a matrix variable.
name: build
on: push
jobs:
job1:
runs-on: ubuntu-latest
outputs:
matrix: ${{ steps.set-matrix.outputs.matrix }}
steps:
- id: set-matrix
run: |
JSON=$(cat ./your.json)
echo "::set-output name=matrix::${JSON//'%'/'%25'}"
job2:
needs: job1
runs-on: ubuntu-latest
strategy:
matrix: ${{fromJson(needs.job1.outputs.matrix)}}
steps:
- run: build
-
If I don't use matrix, how to access to the properties or the object created by fromJson?– michaelJul 28, 2021 at 14:12
-
1
-
@TheJeff This answer may be what you need: stackoverflow.com/a/76393558/7025986– ganjimJun 2 at 21:28
Inspired by answer from @dastrobu which adds key/val to $GITHUB_ENV and using jq
to transform/minify package.json to a single line:
- run: echo "PACKAGE_JSON=$(jq -c . < package.json)" >> $GITHUB_ENV
- run: echo '${{ fromJson(env.PACKAGE_JSON).version }}'
You can easily use the Script
action for this.
- name: "Read JSON"
uses: actions/github-script@v6
id: check-env
with:
result-encoding: string
script: |
try {
const fs = require('fs')
const jsonString = fs.readFileSync('./dir/file.json')
var apps = JSON.parse(jsonString)
} catch(err) {
core.error("Error while reading or parsing the JSON")
core.setFailed(err)
}
on: [push, pull_request]
name: Build
jobs:
build:
name: Example
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
with:
path: './'
- run: |
echo "`jq '.base_config[0].value="Alpha-21"' config.json `" > config.json
echo "`jq '.base_config[1].value="1.2.14"' config.json`" > config.json
echo "`jq '.base_config[2].value="29/12/2020"' config.json `" > config.json
- uses: EndBug/add-and-commit@v6
with:
message: 'Add the version and date'
add: '*.json --force'
cwd: './'
token: ${{ secrets.TOKEN }}
-
3
-
7@Macindows yes according to github.com/actions/virtual-environments/blob/main/images/linux/… (search "jq")– Bjorn LuMar 30, 2021 at 14:39
I once used this to get the value from the json data. Hope this helps
- name: fetch the json value
run: |
githubjson=`cat $GITHUB_EVENT_PATH`
echo $githubjson
number=`echo $(jq -r '.number' <<< "$githubjson")`
PRTitle=`echo $(jq -r '.pull_request.title' <<< "$githubjson")`
PRUrl=`echo $(jq -r '.pull_request.html_url' <<< "$githubjson")`
PRBody=`echo $(jq -r '.pull_request.body' <<< "$githubjson")`
TL;DR
This answer may be helpful to you if you
- have a multi-line JSON file
- are using GitHub-Actions on self-hosted servers
- need to read the JSON file to decide which self-hosted server you want your jobs to be executed on.
- are trying to share contents of a JSON file between multiple jobs.
The code snippet is at the end.
--
I had a somewhat complex scenario where we use several self-hosted GitHub runners. I needed to read from a field in a large configuration JSON file to decide which platform I want the rest of the jobs to be run on.
So the below code starts with a job named configure
, which reads from a config.json
file in the repository and sets it in the output, the next jobs which depend on this can read from the output.
I tried most of the answers in here and in this post and combined the ones that worked, so thanks to all these people for their comments.
jobs:
configure:
runs-on: ubuntu-latest # at first we still don't know which self-hosted server, so we just use ubuntu latest and read the JSON file
outputs: # here we use the outputs from steps, and set outputs for the job `configure`
config: ${{ steps.read-json.outputs.config }}
platform: ${{ steps.get-attribute.outputs.platform }}
steps:
- name: Checkout to repository
uses: actions/checkout@v3
- name: Read JSON file # this puts the whole JSON file in the read-json step output
id: read-json
run: | # to read multi-line JSON file and not bother with escaping
echo "config<<EOF" >> $GITHUB_OUTPUT
cat ./config.json >> $GITHUB_OUTPUT
echo "EOF" >> $GITHUB_OUTPUT
- name: Add platform in output # for simpler use, you can add a single field in the output as well.
id: read-attribute
run: echo "platform=${{fromJson(steps.read-json.outputs.config).platform}}" >> "$GITHUB_OUTPUT"
job2:
needs: configure
runs-on: ${{needs.configure.outputs.platform}}
steps:
- name: Log JSON file
run: echo "${{needs.configure.outputs.config}}"
- name: Log an attribute in JSON file
run: echo "${{fromJson(needs.configure.outputs.config).attribute}}"
With Powershell:
- name: Read json
id: read-json
shell: pwsh
run: |
$json = Get-Content yourfile.json | ConvertFrom-Json
echo "::set-output name=prop::$(echo $json.prop)"
- run: echo ${{ steps.read-json.outputs.prop}}