Skip to content

Commit 45c79b8

Browse files
committed
docs: add README
1 parent 2d03691 commit 45c79b8

File tree

1 file changed

+37
-0
lines changed

1 file changed

+37
-0
lines changed

README.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
# label-sync
2+
An action that allows you to sync labels from a repository or a config file.
3+
4+
### Example workflow:
5+
6+
```yaml
7+
name: Sync labels
8+
on:
9+
# You can run this with every type of event, but it's better to run it only when you actually need it.
10+
workflow_dispatch:
11+
12+
jobs:
13+
labels:
14+
runs-on: ubuntu-latest
15+
16+
steps:
17+
- uses: EndBug/label-sync@v1
18+
with:
19+
# This is needed in order to edit the labels
20+
token: ${{ secrets.GITHUB_TOKEN }}
21+
22+
# If you want to use a config file, you can put its path here
23+
config-file: .github/labels.yml
24+
25+
# If you want to use a source repo, you can put is name here (only the owner/repo format is accepted)
26+
source-repo: owner/repo
27+
# If you're using a private source repo, you'll need to add a custom token for the action to read it
28+
source-repo-token: ${{ secrets.YOUR_OWN_SECRET }}
29+
30+
# If you want to delete any additional label, set this to true
31+
delete-other-labels: false
32+
33+
#If you want the action just to show you the preview of the changes, without actually editing the labels, set this to tru
34+
dry-run: true
35+
```
36+
37+
This is only a sample workflow to illustrate all the options: if you want to see an actual workflow you can check the one in this repo [here](.github/workflows/labels.yml).

0 commit comments

Comments
 (0)