Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/oliversalzburg/action-label-manager

Manage labels on GitHub repositories easily
https://github.com/oliversalzburg/action-label-manager

github github-actions labels

Last synced: 3 months ago
JSON representation

Manage labels on GitHub repositories easily

Awesome Lists containing this project

README

        

# Label Manager Action

[![Pre-Release](https://github.com/oliversalzburg/action-label-manager/actions/workflows/pre-release.yml/badge.svg)](https://github.com/oliversalzburg/action-label-manager/actions/workflows/pre-release.yml)

Maintain the labels on your GitHub repository through a file _in_ your repository.

## Usage

1. Create `.github/labels.yml` in your repository, and define some labels.

```yml
labels:
metadata:
color: "EEEEEE"
description: Relates to package metadata
```

1. Call the action in a workflow.

```yml
name: Manage Labels

on:
push:
branches:
- main
paths:
- .github/labels.yml
workflow_dispatch:

concurrency: manage-labels

jobs:
manage-labels:
permissions:
contents: read
issues: write
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: oliversalzburg/[email protected]
with:
repo_token: ${{ secrets.GITHUB_TOKEN }}
```

## Inputs

| INPUT | TYPE | REQUIRED | DEFAULT | DESCRIPTION |
| -------------------------------------------------------------- | ------ | -------- | ------- | --------------------------------------------------------------------------------------------- |
| [force](#input_force) | string | false | | If set to `true`, will
remove labels that are no
longer defined in the configuration. |
| [repo_token](#input_repo_token) | string | true | | Needs `secrets.GITHUB_TOKEN` to talk to
the API. |

## Release Process

```shell
npm version patch --message "chore: Version bump %s"
```