repo_user: GitHub Repository tools - user functions

In ghclass: Tools for Managing Classes on GitHub

GitHub Repository tools - user functions

Description

• repo_add_user() - Add a user to a repository

• repo_remove_user() - Remove a user from a repository

• repo_add_team() - Add a team to a repository

• repo_remove_team() - Remove a team from a repository

• repo_user_permission() - Change a collaborator's permissions for a repository

• repo_team_permission() - Change a team's permissions for a repository

• repo_collaborators() - Returns a data frame of repos, their collaborators, and their permissions.

• repo_contributors() - Returns a data frame containing details on repository contributor(s).

Usage

repo_add_team(
  repo,
  team,
  permission = c("push", "pull", "admin", "maintain", "triage"),
  team_type = c("name", "slug")
)

repo_team_permission(
  repo,
  team,
  permission = c("push", "pull", "admin", "maintain", "triage"),
  team_type = c("name", "slug")
)

repo_add_user(
  repo,
  user,
  permission = c("push", "pull", "admin", "maintain", "triage")
)

repo_user_permission(
  repo,
  user,
  permission = c("push", "pull", "admin", "maintain", "triage")
)

repo_collaborators(repo, include_admins = TRUE)

repo_contributors(repo)

repo_remove_team(repo, team, team_type = c("name", "slug"))

repo_remove_user(repo, user)

Arguments

repo	Character. Address of repository in owner/repo format.
team	Character. Slug or name of team to add.
permission	Character. Permission to be granted to a user or team for repo, defaults to "push".
team_type	Character. Either "slug" if the team names are slugs or "name" if full team names are provided.
user	Character. One or more GitHub usernames.
include_admins	Logical. If FALSE, user names of users with Admin rights are not included, defaults to TRUE.

Details

Permissions can be set to any of the following:

• "pull" - can pull, but not push to or administer this repository.

• "push" - can pull and push, but not administer this repository.

• "admin" - can pull, push and administer this repository.

• "maintain" - Recommended for project managers who need to manage the repository without access to sensitive or destructive actions.

• "triage" - Recommended for contributors who need to proactively manage issues and pull requests without write access.

Value

repo_collaborators() and repo_contributoes return a tibble.

All other functions invisibly return a list containing the results of the relevant GitHub API calls.

Examples

## Not run: 
repo = repo_create("ghclass-test", "hw1")

team_create("ghclass-test", "team_awesome")

repo_add_user(repo, "rundel")

repo_add_team(repo, "team_awesome")

repo_remove_team(repo, "team_awesome")

repo_collaborators(repo)

repo_contributors(repo)
repo_contributors("rundel/ghclass")

# Cleanup
repo_delete(repo, prompt=FALSE)

## End(Not run)

ghclass documentation built on May 29, 2024, 8:44 a.m.