mirror of
https://github.com/rlespinasse/shortify-git-revision.git
synced 2026-05-17 18:25:31 +00:00
56 lines
1.3 KiB
Markdown
56 lines
1.3 KiB
Markdown
# Shortify git revision
|
|
|
|
> Github Action to shortify a git revision
|
|
|
|
Produce short revision environment variable based on the input one.
|
|
|
|
If a revision is a bad revision, this action will produce an error message and fail depending on `continue-on-error` input value.
|
|
`<NAME>`, and `<NAME>_SHORT` environment variable will only be available if the revision is not empty and valid.
|
|
|
|
## Usage
|
|
|
|
- Shortify an environment variable
|
|
|
|
```yaml
|
|
- uses: rlespinasse/shortify-git-revision@v1.x
|
|
with:
|
|
name: GITHUB_SHA
|
|
```
|
|
|
|
Will make available
|
|
|
|
- `GITHUB_SHA_SHORT`
|
|
|
|
- Shortify any revision
|
|
|
|
```yaml
|
|
- uses: rlespinasse/slugify-value@v1.x
|
|
with:
|
|
name: SOME_REVISION
|
|
revision: 88428f56bd9d2751c47106bedfd148162dfa50b8
|
|
```
|
|
|
|
Will make available
|
|
|
|
- `SOME_REVISION`
|
|
- `SOME_REVISION_SHORT`
|
|
|
|
## Inputs
|
|
|
|
### `name`
|
|
|
|
If used with `revision` input, it's the name of the environment variable containing the revision to shortify.
|
|
Otherwise, the `name` input will be used (in upper case) to define a environment variable containing the `revision` input value.
|
|
|
|
### `revision`
|
|
|
|
The revision to shortify into an environment variable named `<NAME>_SHORT`.
|
|
|
|
This input is _Optional_.
|
|
|
|
### `continue-on-error`
|
|
|
|
If the input is set to `true`, this action will not fail on a bad revision
|
|
|
|
The default value is `false`.
|