org_perm: Organization permissions

In rundel/ghclass: Tools for Managing Classes on GitHub

Organization permissions

Description

• org_sitrep() - Provides a situation report on a GitHub organization.

• org_set_repo_permission() - Change the default permission level for org repositories.

org_workflow_permissions() - Obtain the current default workflow permission value for the organization.

org_set_workflow_permissions() - Change the current default workflow permission value for the organization.

Usage

org_sitrep(org)

org_set_repo_permission(
  org,
  repo_permission = c("none", "read", "write", "admin")
)

org_workflow_permissions(org)

org_set_workflow_permissions(org, workflow_permission = c("read", "write"))

Arguments

org	Character. Name of the GitHub organization(s).
repo_permission	Default permission level members have for organization repositories: read - can pull, but not push to or administer this repository. write - can pull and push, but not administer this repository. admin - can pull, push, and administer this repository. none - no permissions granted by default.
workflow_permission	The default workflow permissions granted to the GITHUB_TOKEN when running workflows in the organization. Accepted values:"read" or "write".

Value

org_sitep() invisibly returns the org argument.

org_set_repo_permission() invisibly return a the result of the relevant GitHub API call.

org_workflow_permissions() returns a character vector with value of either "read" or "write".

org_set_workflow_permissions() invisibly return a the result of the relevant GitHub API call.

Examples

## Not run: 
org_sitrep("ghclass-test")

org_set_repo_permission("ghclass-test", "read")

org_workflow_permissions("ghclass-test")

org_set_workflow_permissions("ghclass-test", "write")

org_sitrep("ghclass-test")

# Cleanup
org_set_repo_permission("ghclass-test", "none")
org_set_workflow_permissions("ghclass-test", "read")

## End(Not run)

rundel/ghclass documentation built on Feb. 17, 2025, 7:33 a.m.