@proggarapsody/bitbottle 1.36.0 → 1.38.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 +35 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -419,6 +419,41 @@ bitbottle --hostname git.example.com code-insights merge-check delete \
|
|
|
419
419
|
Invoking any `code-insights` command against a Bitbucket Cloud host returns
|
|
420
420
|
the typed `host.unsupported` error.
|
|
421
421
|
|
|
422
|
+
### Permissions _(Bitbucket Server / DC only)_
|
|
423
|
+
|
|
424
|
+
Manage user and group permissions for projects and repositories.
|
|
425
|
+
Requires `PROJECT_ADMIN` on the target project.
|
|
426
|
+
|
|
427
|
+
```bash
|
|
428
|
+
# List all grants for a project (users + groups, sorted ADMIN → WRITE → READ)
|
|
429
|
+
bitbottle --hostname git.example.com perms project list MYPROJ
|
|
430
|
+
|
|
431
|
+
# Grant a user PROJECT_WRITE on a project
|
|
432
|
+
bitbottle --hostname git.example.com perms project grant MYPROJ PROJECT_WRITE --user alice
|
|
433
|
+
|
|
434
|
+
# Grant a group PROJECT_READ on a project
|
|
435
|
+
bitbottle --hostname git.example.com perms project grant MYPROJ PROJECT_READ --group "qa team"
|
|
436
|
+
|
|
437
|
+
# Revoke a user's permission on a project
|
|
438
|
+
bitbottle --hostname git.example.com perms project revoke MYPROJ --user bob
|
|
439
|
+
|
|
440
|
+
# List all grants for a repository
|
|
441
|
+
bitbottle --hostname git.example.com perms repo list MYPROJ/my-service
|
|
442
|
+
|
|
443
|
+
# Grant a user REPO_WRITE on a repository
|
|
444
|
+
bitbottle --hostname git.example.com perms repo grant MYPROJ/my-service REPO_WRITE --user carol
|
|
445
|
+
|
|
446
|
+
# Revoke a group's permission on a repository
|
|
447
|
+
bitbottle --hostname git.example.com perms repo revoke MYPROJ/my-service --group "qa team"
|
|
448
|
+
|
|
449
|
+
# Structured output
|
|
450
|
+
bitbottle --hostname git.example.com perms project list MYPROJ --json permission,subject
|
|
451
|
+
bitbottle --hostname git.example.com perms project list MYPROJ --jq '.[] | select(.permission == "PROJECT_ADMIN")'
|
|
452
|
+
```
|
|
453
|
+
|
|
454
|
+
If a grant call would **downgrade** an existing permission (e.g. ADMIN → READ),
|
|
455
|
+
`grant` prompts for confirmation on a TTY. Pass `--force` to skip the prompt.
|
|
456
|
+
|
|
422
457
|
### Commit Comments
|
|
423
458
|
|
|
424
459
|
Add and manage review-style comments on individual commits. Both Bitbucket
|