manver-action

Extract version metadata

Contents

• What is this?
• Use
• Inputs
  • branch
  • build
  • manifest
  • property
  • release-branch-prefix
• Outputs
  • build
  • manifest
• Contribute

What is this?

This is a simple action for extracting version metadata.

Use

---
name: ci
on:
  - pull_request
  - push
  - workflow_dispatch
jobs:
  preflight:
    runs-on: ubuntu-latest
    outputs:
      version: ${{ steps.version.outputs.build }}
    steps:
      - id: checkout
        name: Checkout ${{ github.head_ref || github.ref_name }}
        uses: actions/[email protected]
        with:
          persist-credentials: false
          ref: ${{ github.head_ref || github.ref }}
      - id: version
        name: Extract version metadata
        uses: flex-development/[email protected]

Inputs

branch

default: ${{ github.head_ref || github.ref_name }}

The name of the branch to check when generating a build version.

build

default: ${{ github.event.pull_request.head.sha || github.sha }}

Build metadata.

manifest

default: package.json

The path to the manifest file.
Manifest files are expected to be compatible with jq.

property

default: .version

Version property path in manifest file.

release-branch-prefix

default: release/

The prefix used to mark release branches.
Build versions generated from release branches will not have metadata attached.

Outputs

build

Build version (generated from outputs.manifest and inputs.build).

manifest

The value of property in the manifest file.

Contribute

See CONTRIBUTING.md.

This project has a code of conduct. By interacting with this repository, organization, or community you agree to abide by its terms.