@bensandee/forgejo-cli 0.9.0 → 0.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +24 -23
- package/dist/bin.mjs +31 -7374
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -39,29 +39,30 @@ run should get every variable from its environment and leave `BST_ENV_FILE` unse
|
|
|
39
39
|
Run `bst-fj --help` for the list and `bst-fj <command> --help` for each command's flags. Every
|
|
40
40
|
command takes `--json`, which prints exactly one JSON document, failures included.
|
|
41
41
|
|
|
42
|
-
| Command | What it does
|
|
43
|
-
| ------------------- |
|
|
44
|
-
| `labels` | `list` a repository's labels, or `sync` one named set from a `--file` (creates and updates, never deletes)
|
|
45
|
-
| `secrets` | `set`, `list` or `delete` Forgejo Actions secrets
|
|
46
|
-
| `webhooks` | List webhooks across an instance (system, user, org and repo)
|
|
47
|
-
| `release:create` | Create a release for a tag the forge already has; refuses a tag the forge lacks unless given `--target`
|
|
48
|
-
| `pr:checks` | Read a pull request's CI verdict, optionally `--wait` for it to settle
|
|
49
|
-
| `pr:list` | List a repository's pull requests
|
|
50
|
-
| `commit:status` | Read the status checks for a commit SHA, branch, tag or git ref
|
|
51
|
-
| `issue:*` | `view`, `list`, `comment`, `create`, `update`, `download`, `label`, `unlabel`, `set-labels`, `close`, `reopen`
|
|
52
|
-
| `pr:create` | Push the current branch and open a pull request, deriving the title and body when none is given; reports no closed-issue claims, which `bst pr:create` does
|
|
53
|
-
| `pr:update` | Push the current branch and update its open pull request
|
|
54
|
-
| `branch:list` | List a repository's branches
|
|
55
|
-
| `branch:delete` | Delete a branch through the API; reports the forge's reason when it refuses
|
|
56
|
-
| `pr:files` | List the files a pull request changes
|
|
57
|
-
| `pr:merge` | Merge an open, non-draft, mergeable PR pinned to the head it read; refuses closed, draft, conflicted, unconfirmed or non-green checks (zero statuses included) unless `--ignore-checks`; `--delete-branch` is opt-in
|
|
58
|
-
| `pr:ready` | Mark a draft pull request ready, dropping one `WIP:` prefix or taking `--title`, and confirm the forge no longer reports a draft
|
|
59
|
-
| `pr:close` | Close an open pull request, optionally posting `--comment`/`--comment-file` first; reports an already-closed or merged PR without writing; refuses an issue
|
|
60
|
-
| `pr:reopen` | Reopen a closed pull request and confirm the forge reports it open; reports an already-open PR without writing; refuses a merged PR and an issue
|
|
61
|
-
| `pr:retarget` | Repoint an open pull request at a new base branch, confirm the forge took it, and report its mergeability as advice
|
|
62
|
-
| `workflow:dispatch` | Dispatch a workflow with `--workflow`, `--ref` and repeatable `--input`; takes `--repo owner/repo`, not a URL
|
|
63
|
-
| `ci:runs` | List a repository's workflow runs with their jobs, filtered by workflow, ref, pull request, head SHA or status
|
|
64
|
-
| `ci:
|
|
42
|
+
| Command | What it does |
|
|
43
|
+
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
44
|
+
| `labels` | `list` a repository's labels, or `sync` one named set from a `--file` (creates and updates, never deletes) |
|
|
45
|
+
| `secrets` | `set`, `list` or `delete` Forgejo Actions secrets |
|
|
46
|
+
| `webhooks` | List webhooks across an instance (system, user, org and repo) |
|
|
47
|
+
| `release:create` | Create a release for a tag the forge already has; refuses a tag the forge lacks unless given `--target` |
|
|
48
|
+
| `pr:checks` | Read a pull request's CI verdict, optionally `--wait` for it to settle |
|
|
49
|
+
| `pr:list` | List a repository's pull requests |
|
|
50
|
+
| `commit:status` | Read the status checks for a commit SHA, branch, tag or git ref |
|
|
51
|
+
| `issue:*` | `view`, `list`, `comment`, `create`, `update`, `download`, `label`, `unlabel`, `set-labels`, `close`, `reopen` |
|
|
52
|
+
| `pr:create` | Push the current branch and open a pull request, deriving the title and body when none is given; reports no closed-issue claims, which `bst pr:create` does |
|
|
53
|
+
| `pr:update` | Push the current branch and update its open pull request |
|
|
54
|
+
| `branch:list` | List a repository's branches |
|
|
55
|
+
| `branch:delete` | Delete a branch through the API; reports the forge's reason when it refuses |
|
|
56
|
+
| `pr:files` | List the files a pull request changes |
|
|
57
|
+
| `pr:merge` | Merge an open, non-draft, mergeable PR pinned to the head it read; refuses closed, draft, conflicted, unconfirmed or non-green checks (zero statuses included) unless `--ignore-checks`; `--delete-branch` is opt-in |
|
|
58
|
+
| `pr:ready` | Mark a draft pull request ready, dropping one `WIP:` prefix or taking `--title`, and confirm the forge no longer reports a draft; the number defaults to the current branch's open pull request |
|
|
59
|
+
| `pr:close` | Close an open pull request, optionally posting `--comment`/`--comment-file` first; reports an already-closed or merged PR without writing; refuses an issue |
|
|
60
|
+
| `pr:reopen` | Reopen a closed pull request and confirm the forge reports it open; reports an already-open PR without writing; refuses a merged PR and an issue; the number defaults to the current branch's closed, unmerged pull request |
|
|
61
|
+
| `pr:retarget` | Repoint an open pull request at a new base branch, confirm the forge took it, and report its mergeability as advice; the number defaults to the current branch's open pull request |
|
|
62
|
+
| `workflow:dispatch` | Dispatch a workflow with `--workflow`, `--ref` and repeatable `--input`; takes `--repo owner/repo`, not a URL |
|
|
63
|
+
| `ci:runs` | List a repository's workflow runs with their jobs, filtered by workflow, ref, pull request, head SHA or status |
|
|
64
|
+
| `ci:rerun` | Rerun a finished workflow run, or one job and the jobs that depend on it (Forgejo 17 or later); Forgejo reports no id for the new attempt |
|
|
65
|
+
| `ci:log` | Print one workflow job's whole log, or with `--grep` only the lines whose text matches; on Forgejo 17 it shows the job's step table and `--step` reads one step |
|
|
65
66
|
|
|
66
67
|
Zero posted statuses reads as `no-status`, never as green. Every command is Forgejo-only: on
|
|
67
68
|
GitHub, use `gh`. The `issue:*`, `pr:create`, `pr:update`, `pr:ready`, `pr:reopen` and `pr:retarget`
|