RepositoryController.java

1
package edu.ucsb.cs156.frontiers.controllers;
2
3
import edu.ucsb.cs156.frontiers.entities.Course;
4
import edu.ucsb.cs156.frontiers.enums.RepositoryCreationOption;
5
import edu.ucsb.cs156.frontiers.enums.RepositoryPermissions;
6
import edu.ucsb.cs156.frontiers.errors.EntityNotFoundException;
7
import edu.ucsb.cs156.frontiers.errors.NoLinkedOrganizationException;
8
import edu.ucsb.cs156.frontiers.jobs.CreateStudentOrStaffRepositoriesJob;
9
import edu.ucsb.cs156.frontiers.jobs.CreateTeamRepositoriesJob;
10
import edu.ucsb.cs156.frontiers.jobs.DeleteRepoJob;
11
import edu.ucsb.cs156.frontiers.repositories.CourseRepository;
12
import edu.ucsb.cs156.frontiers.services.GithubTeamService;
13
import edu.ucsb.cs156.frontiers.services.RepositoryService;
14
import edu.ucsb.cs156.jobs.entities.Job;
15
import edu.ucsb.cs156.jobs.services.JobService;
16
import io.swagger.v3.oas.annotations.tags.Tag;
17
import java.util.Optional;
18
import org.springframework.beans.factory.annotation.Autowired;
19
import org.springframework.http.HttpStatus;
20
import org.springframework.security.access.prepost.PreAuthorize;
21
import org.springframework.web.bind.annotation.DeleteMapping;
22
import org.springframework.web.bind.annotation.PostMapping;
23
import org.springframework.web.bind.annotation.RequestMapping;
24
import org.springframework.web.bind.annotation.RequestParam;
25
import org.springframework.web.bind.annotation.RestController;
26
import org.springframework.web.server.ResponseStatusException;
27
28
@Tag(name = "Repository Controller")
29
@RestController
30
@RequestMapping("/api/repos")
31
public class RepositoryController extends ApiController {
32
33
  @Autowired RepositoryService repositoryService;
34
35
  @Autowired JobService jobService;
36
37
  @Autowired CourseRepository courseRepository;
38
39
  @Autowired GithubTeamService githubTeamService;
40
41
  /**
42
   * Fires a job that creates a repo for every RosterStudent with a linked user with a GitHub
43
   * account.
44
   *
45
   * @param courseId ID of course to create repos for
46
   * @param repoPrefix each repo created will begin with this prefix, followed by a dash and the
47
   *     student's GitHub username
48
   * @param isPrivate determines whether the repository being created is private
49
   * @return the {@link edu.ucsb.cs156.jobs.entities.Job Job} started to create the repos.
50
   */
51
  @PostMapping("/createRepos")
52
  @PreAuthorize("@CourseSecurity.hasManagePermissions(#root, #courseId)")
53
  public Job createRepos(
54
      @RequestParam Long courseId,
55
      @RequestParam String repoPrefix,
56
      @RequestParam Optional<Boolean> isPrivate,
57
      @RequestParam RepositoryPermissions permissions,
58
      @RequestParam(required = false, defaultValue = "STUDENTS_ONLY")
59
          RepositoryCreationOption creationOption) {
60
    Course course =
61
        courseRepository
62
            .findById(courseId)
63 1 1. lambda$createRepos$0 : replaced return value with null for edu/ucsb/cs156/frontiers/controllers/RepositoryController::lambda$createRepos$0 → KILLED
            .orElseThrow(() -> new EntityNotFoundException(Course.class, courseId));
64 2 1. createRepos : negated conditional → KILLED
2. createRepos : negated conditional → KILLED
    if (course.getOrgName() == null || course.getInstallationId() == null) {
65
      throw new NoLinkedOrganizationException(course.getCourseName());
66
    } else {
67
      CreateStudentOrStaffRepositoriesJob job =
68
          CreateStudentOrStaffRepositoriesJob.builder()
69
              .repositoryPrefix(repoPrefix)
70
              .isPrivate(isPrivate.orElse(false))
71
              .repositoryService(repositoryService)
72
              .course(course)
73
              .permissions(permissions)
74
              .creationOption(creationOption)
75
              .build();
76 1 1. createRepos : replaced return value with null for edu/ucsb/cs156/frontiers/controllers/RepositoryController::createRepos → KILLED
      return jobService.runAsJob(job);
77
    }
78
  }
79
80
  /**
81
   * Fires a job that creates team repos shared by all TeamMembers of each Team in a Course .
82
   *
83
   * @param courseId ID of course to create team repos for
84
   * @param repoPrefix each team repo created will begin with this prefix, followed by a dash and
85
   *     the team's name
86
   * @param isPrivate determines whether the repository being created is private
87
   * @return the {@link edu.ucsb.cs156.jobs.entities.Job Job} started to create the repos.
88
   */
89
  @PostMapping("/createTeamRepos")
90
  @PreAuthorize("@CourseSecurity.hasManagePermissions(#root, #courseId)")
91
  public Job createTeamRepos(
92
      @RequestParam Long courseId,
93
      @RequestParam String repoPrefix,
94
      @RequestParam Optional<Boolean> isPrivate,
95
      @RequestParam Optional<String> teamRegex,
96
      @RequestParam RepositoryPermissions permissions) {
97
    Course course =
98
        courseRepository
99
            .findById(courseId)
100 1 1. lambda$createTeamRepos$0 : replaced return value with null for edu/ucsb/cs156/frontiers/controllers/RepositoryController::lambda$createTeamRepos$0 → KILLED
            .orElseThrow(() -> new EntityNotFoundException(Course.class, courseId));
101 2 1. createTeamRepos : negated conditional → KILLED
2. createTeamRepos : negated conditional → KILLED
    if (course.getOrgName() == null || course.getInstallationId() == null) {
102
      throw new NoLinkedOrganizationException(course.getCourseName());
103
    } else {
104
      CreateTeamRepositoriesJob job =
105
          CreateTeamRepositoriesJob.builder()
106
              .repositoryPrefix(repoPrefix)
107
              .isPrivate(isPrivate.orElse(false))
108
              .repositoryService(repositoryService)
109
              .githubTeamService(githubTeamService)
110
              .course(course)
111
              .permissions(permissions)
112
              .teamRegex(teamRegex.orElse(null))
113
              .build();
114 1 1. createTeamRepos : replaced return value with null for edu/ucsb/cs156/frontiers/controllers/RepositoryController::createTeamRepos → KILLED
      return jobService.runAsJob(job);
115
    }
116
  }
117
118
  /**
119
   * Fires a job that deletes every empty repository in the course's GitHub organization whose name
120
   * starts with the given prefix. Repositories that contain commits are never deleted.
121
   *
122
   * @param courseId ID of the course whose organization is searched
123
   * @param prefix only repositories whose names start with this prefix are considered
124
   * @return the {@link edu.ucsb.cs156.jobs.entities.Job Job} started to delete the repos.
125
   */
126
  @DeleteMapping("")
127
  @PreAuthorize("@CourseSecurity.hasManagePermissions(#root, #courseId)")
128
  public Job deleteRepos(@RequestParam Long courseId, @RequestParam String prefix) {
129 1 1. deleteRepos : negated conditional → KILLED
    if (prefix.isBlank()) {
130
      throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "prefix must not be blank");
131
    }
132
    Course course =
133
        courseRepository
134
            .findById(courseId)
135 1 1. lambda$deleteRepos$0 : replaced return value with null for edu/ucsb/cs156/frontiers/controllers/RepositoryController::lambda$deleteRepos$0 → KILLED
            .orElseThrow(() -> new EntityNotFoundException(Course.class, courseId));
136 2 1. deleteRepos : negated conditional → KILLED
2. deleteRepos : negated conditional → KILLED
    if (course.getOrgName() == null || course.getInstallationId() == null) {
137
      throw new NoLinkedOrganizationException(course.getCourseName());
138
    }
139
    DeleteRepoJob job =
140
        DeleteRepoJob.builder()
141
            .courseId(courseId)
142
            .prefix(prefix)
143
            .courseRepository(courseRepository)
144
            .repositoryService(repositoryService)
145
            .build();
146 1 1. deleteRepos : replaced return value with null for edu/ucsb/cs156/frontiers/controllers/RepositoryController::deleteRepos → KILLED
    return jobService.runAsJob(job);
147
  }
148
}

Mutations

63

1.1
Location : lambda$createRepos$0
Killed by : edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests.[engine:junit-jupiter]/[class:edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests]/[method:notFound()]
replaced return value with null for edu/ucsb/cs156/frontiers/controllers/RepositoryController::lambda$createRepos$0 → KILLED

64

1.1
Location : createRepos
Killed by : edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests.[engine:junit-jupiter]/[class:edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests]/[method:job_actually_fires()]
negated conditional → KILLED

2.2
Location : createRepos
Killed by : edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests.[engine:junit-jupiter]/[class:edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests]/[method:just_no_install_id()]
negated conditional → KILLED

76

1.1
Location : createRepos
Killed by : edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests.[engine:junit-jupiter]/[class:edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests]/[method:job_actually_fires()]
replaced return value with null for edu/ucsb/cs156/frontiers/controllers/RepositoryController::createRepos → KILLED

100

1.1
Location : lambda$createTeamRepos$0
Killed by : edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests.[engine:junit-jupiter]/[class:edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests]/[method:team_repo_job_notFound()]
replaced return value with null for edu/ucsb/cs156/frontiers/controllers/RepositoryController::lambda$createTeamRepos$0 → KILLED

101

1.1
Location : createTeamRepos
Killed by : edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests.[engine:junit-jupiter]/[class:edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests]/[method:team_repo_job_actually_fires()]
negated conditional → KILLED

2.2
Location : createTeamRepos
Killed by : edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests.[engine:junit-jupiter]/[class:edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests]/[method:team_repo_job_just_no_install_id()]
negated conditional → KILLED

114

1.1
Location : createTeamRepos
Killed by : edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests.[engine:junit-jupiter]/[class:edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests]/[method:team_repo_job_actually_fires()]
replaced return value with null for edu/ucsb/cs156/frontiers/controllers/RepositoryController::createTeamRepos → KILLED

129

1.1
Location : deleteRepos
Killed by : edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests.[engine:junit-jupiter]/[class:edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests]/[method:delete_repos_rejects_blank_prefix()]
negated conditional → KILLED

135

1.1
Location : lambda$deleteRepos$0
Killed by : edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests.[engine:junit-jupiter]/[class:edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests]/[method:delete_repos_course_not_found()]
replaced return value with null for edu/ucsb/cs156/frontiers/controllers/RepositoryController::lambda$deleteRepos$0 → KILLED

136

1.1
Location : deleteRepos
Killed by : edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests.[engine:junit-jupiter]/[class:edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests]/[method:delete_repos_just_no_install_id()]
negated conditional → KILLED

2.2
Location : deleteRepos
Killed by : edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests.[engine:junit-jupiter]/[class:edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests]/[method:delete_repos_job_actually_fires()]
negated conditional → KILLED

146

1.1
Location : deleteRepos
Killed by : edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests.[engine:junit-jupiter]/[class:edu.ucsb.cs156.frontiers.controllers.RepositoryControllerTests]/[method:delete_repos_job_actually_fires()]
replaced return value with null for edu/ucsb/cs156/frontiers/controllers/RepositoryController::deleteRepos → KILLED

Active mutators

Tests examined


Report generated by PIT 1.30.0 support