From 2dee79226d64d7a60a6e1f00c84bffab32e5fa2a Mon Sep 17 00:00:00 2001 From: Daniil Samoylov Date: Mon, 12 Apr 2021 17:10:23 +1200 Subject: [PATCH] Fix readme --- README.md | 113 ++++++++++++++++-------------------------------------- 1 file changed, 33 insertions(+), 80 deletions(-) diff --git a/README.md b/README.md index 68d5d07..f00c8cb 100644 --- a/README.md +++ b/README.md @@ -1,80 +1,49 @@

- typescript-action status + report-updated-dependencies status

-# Create a JavaScript Action using TypeScript +# Report updated dependencies -Use this template to bootstrap the creation of a TypeScript action.:rocket: +This Github Actions runs on changes to PR requests to detect and report changes made to dependencies. +Dependency lookups, change detections and fetching of release notes are all done by [Renovate Bot](https://github.com/renovatebot/renovate) -This template includes compilation support, tests, a validation workflow, publishing, and versioning guidance. +```yml +name: 'build-test' +on: + pull_request: -If you are new, there's also a simpler introduction. See the [Hello World JavaScript Action](https://github.com/actions/hello-world-javascript-action) - -## Create an action from this template - -Click the `Use this Template` and provide the new repo details for your action - -## Code in Main - -> First, you'll need to have a reasonably modern version of `node` handy. This won't work with versions older than 9, for instance. - -Install the dependencies -```bash -$ npm install -``` - -Build the typescript and package it for distribution -```bash -$ npm run build && npm run package +jobs: + report-updated-dependencies: + runs-on: ubuntu-latest + steps: + - uses: AurorNZ/report-updated-dependencies@v1 ``` -Run the tests :heavy_check_mark: -```bash -$ npm test - - PASS ./index.test.js - ✓ throws invalid number (3ms) - ✓ wait 500 ms (504ms) - ✓ test runs (95ms) - -... +or run conditionally + +```yml +name: 'build-test' +on: # rebuild any PRs and main branch changes + pull_request: + push: + branches: + - main + - 'releases/*' + +jobs: + report-updated-dependencies: + if: ${{ github.event_name == 'pull_request' }} + runs-on: ubuntu-latest + steps: + - uses: AurorNZ/report-updated-dependencies@v1 ``` -## Change action.yml - -The action.yml contains defines the inputs and output for your action. - -Update the action.yml with your name, description, inputs and outputs for your action. - -See the [documentation](https://help.github.com/en/articles/metadata-syntax-for-github-actions) - -## Change the Code - -Most toolkit and CI/CD operations involve async operations so the action is run in an async function. - -```javascript -import * as core from '@actions/core'; -... - -async function run() { - try { - ... - } - catch (error) { - core.setFailed(error.message); - } -} - -run() -``` - -See the [toolkit documentation](https://github.com/actions/toolkit/blob/master/README.md#packages) for the various packages. - ## Publish to a distribution branch -Actions are run from GitHub repos so we will checkin the packed dist folder. +Actions are run from GitHub repos so we will checkin the packed dist folder. Then run [ncc](https://github.com/zeit/ncc) and push the results: + ```bash $ npm run package $ git add dist @@ -84,22 +53,6 @@ $ git push origin releases/v1 Note: We recommend using the `--license` option for ncc, which will create a license file for all of the production node modules used in your project. -Your action is now published! :rocket: +Your action is now published! :rocket: See the [versioning documentation](https://github.com/actions/toolkit/blob/master/docs/action-versioning.md) - -## Validate - -You can now validate the action by referencing `./` in a workflow in your repo (see [test.yml](.github/workflows/test.yml)) - -```yaml -uses: ./ -with: - milliseconds: 1000 -``` - -See the [actions tab](https://github.com/actions/typescript-action/actions) for runs of this action! :rocket: - -## Usage: - -After testing you can [create a v1 tag](https://github.com/actions/toolkit/blob/master/docs/action-versioning.md) to reference the stable and latest V1 action