Package edu.ucsb.cs156.frontiers.services

Class RepositoryService

java.lang.Object

edu.ucsb.cs156.frontiers.services.RepositoryService

@Service
public class RepositoryService
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	RepositoryService.GithubRepository

Constructor Summary

Constructors

Constructor	Description
RepositoryService(JwtService jwtService, GithubTeamService githubTeamService, TeamRepository teamRepository, org.springframework.boot.web.client.RestTemplateBuilder restTemplateBuilder, com.fasterxml.jackson.databind.ObjectMapper mapper)

Method Summary

Modifier and Type	Method	Description
void	createStaffRepository(Course course, CourseStaff staff, String repoPrefix, Boolean isPrivate, RepositoryPermissions permissions)	Creates a single staff repository if it doesn't already exist, and provisions access to the repository by that staff member
void	createStudentRepository(Course course, RosterStudent student, String repoPrefix, Boolean isPrivate, RepositoryPermissions permissions)	Creates a single student repository if it doesn't already exist, and provisions access to the repository by that student
void	createTeamRepository(Course course, Team team, String repoPrefix, Boolean isPrivate, RepositoryPermissions permissions, Integer orgId)	Creates a GitHub repository for a team (student or staff), given only their team name.
boolean	deleteRepositoryIfEmpty(Course course, String repositoryName)	Deletes a repository only when it is empty.
List<RepositoryService.GithubRepository>	getRepositoriesMatchingPrefix(Course course, String prefix)	Lists repositories in the course GitHub organization whose names start with the provided prefix.
boolean	isRepositoryEmpty(Course course, String repositoryName)	Returns true when the repository has no commits.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

RepositoryService

public RepositoryService(JwtService jwtService,
 GithubTeamService githubTeamService,
 TeamRepository teamRepository,
 org.springframework.boot.web.client.RestTemplateBuilder restTemplateBuilder,
 com.fasterxml.jackson.databind.ObjectMapper mapper)

Method Details

createStudentRepository

public void createStudentRepository(Course course,
 RosterStudent student,
 String repoPrefix,
 Boolean isPrivate,
 RepositoryPermissions permissions)
                             throws NoSuchAlgorithmException,
InvalidKeySpecException,
com.fasterxml.jackson.core.JsonProcessingException

Creates a single student repository if it doesn't already exist, and provisions access to the repository by that student

Parameters:

course - The Course in question

student - RosterStudent of the student the repository should be created for

repoPrefix - Name of the project or assignment. Used to title the repository, in the format repoPrefix-githubLogin

isPrivate - Whether the repository is private or not

Throws:

NoSuchAlgorithmException

InvalidKeySpecException

com.fasterxml.jackson.core.JsonProcessingException

createStaffRepository

public void createStaffRepository(Course course,
 CourseStaff staff,
 String repoPrefix,
 Boolean isPrivate,
 RepositoryPermissions permissions)
                           throws NoSuchAlgorithmException,
InvalidKeySpecException,
com.fasterxml.jackson.core.JsonProcessingException

Creates a single staff repository if it doesn't already exist, and provisions access to the repository by that staff member

Parameters:

course - The Course in question

staff - CourseStaff of the staff the repository should be created for

repoPrefix - Name of the project or assignment. Used to title the repository, in the format repoPrefix-githubLogin

isPrivate - Whether the repository is private or not

Throws:

NoSuchAlgorithmException

InvalidKeySpecException

com.fasterxml.jackson.core.JsonProcessingException

getRepositoriesMatchingPrefix

public List<RepositoryService.GithubRepository> getRepositoriesMatchingPrefix(Course course,
 String prefix)
                                                                       throws NoSuchAlgorithmException,
InvalidKeySpecException,
com.fasterxml.jackson.core.JsonProcessingException

Lists repositories in the course GitHub organization whose names start with the provided prefix.

Throws:

NoSuchAlgorithmException

InvalidKeySpecException

com.fasterxml.jackson.core.JsonProcessingException

isRepositoryEmpty

public boolean isRepositoryEmpty(Course course,
 String repositoryName)
                          throws NoSuchAlgorithmException,
InvalidKeySpecException,
com.fasterxml.jackson.core.JsonProcessingException

Returns true when the repository has no commits.

Throws:

NoSuchAlgorithmException

InvalidKeySpecException

com.fasterxml.jackson.core.JsonProcessingException

deleteRepositoryIfEmpty

public boolean deleteRepositoryIfEmpty(Course course,
 String repositoryName)
                                throws NoSuchAlgorithmException,
InvalidKeySpecException,
com.fasterxml.jackson.core.JsonProcessingException

Deletes a repository only when it is empty. Returns true when a delete request was sent.

Throws:

NoSuchAlgorithmException

InvalidKeySpecException

com.fasterxml.jackson.core.JsonProcessingException

createTeamRepository

public void createTeamRepository(Course course,
 Team team,
 String repoPrefix,
 Boolean isPrivate,
 RepositoryPermissions permissions,
 Integer orgId)
                          throws NoSuchAlgorithmException,
InvalidKeySpecException,
com.fasterxml.jackson.core.JsonProcessingException

Creates a GitHub repository for a team (student or staff), given only their team name.

• Checks whether the repository already exists.
• If not, creates a new repository under the course's organization.
• Adds all team members as collaborators with the given permission level.

Parameters:

course - the course whose organization the repo belongs to

team - the team for which the repo is being created

repoPrefix - prefix for the repository name (repoPrefix-teamSlug)

isPrivate - whether the created repository should be private

permissions - collaborator permissions to grant the user

orgId - GitHub organization ID used for team-based repo provisioning

Throws:

NoSuchAlgorithmException - if signing fails

InvalidKeySpecException - if signing fails

com.fasterxml.jackson.core.JsonProcessingException - if JSON serialization fails