RepositoryController.java

package edu.ucsb.cs156.frontiers.controllers;

import com.fasterxml.jackson.databind.ObjectMapper;

import edu.ucsb.cs156.frontiers.entities.Course;

import edu.ucsb.cs156.frontiers.entities.Job;

import edu.ucsb.cs156.frontiers.enums.RepositoryCreationOption;

import edu.ucsb.cs156.frontiers.enums.RepositoryPermissions;

import edu.ucsb.cs156.frontiers.errors.EntityNotFoundException;

import edu.ucsb.cs156.frontiers.errors.NoLinkedOrganizationException;

import edu.ucsb.cs156.frontiers.jobs.CreateStudentOrStaffRepositoriesJob;

import edu.ucsb.cs156.frontiers.jobs.CreateTeamRepositoriesJob;

import edu.ucsb.cs156.frontiers.jobs.DeleteRepoJob;

import edu.ucsb.cs156.frontiers.repositories.CourseRepository;

import edu.ucsb.cs156.frontiers.services.GithubTeamService;

import edu.ucsb.cs156.frontiers.services.JwtService;

import edu.ucsb.cs156.frontiers.services.RepositoryService;

import edu.ucsb.cs156.frontiers.services.jobs.JobService;

import io.swagger.v3.oas.annotations.tags.Tag;

import java.util.Optional;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.security.access.prepost.PreAuthorize;

import org.springframework.web.bind.annotation.DeleteMapping;

import org.springframework.web.bind.annotation.PostMapping;

import org.springframework.web.bind.annotation.RequestMapping;

import org.springframework.web.bind.annotation.RequestParam;

import org.springframework.web.bind.annotation.RestController;

import org.springframework.web.client.RestTemplate;

@Tag(name = "Repository Controller")

@RestController

@RequestMapping("/api/repos")

  @Autowired RepositoryService repositoryService;

  @Autowired JobService jobService;

  @Autowired CourseRepository courseRepository;

  @Autowired GithubTeamService githubTeamService;

  @Autowired JwtService jwtService;

  @Autowired ObjectMapper mapper;

  /**

   * Fires a job that creates a repo for every RosterStudent with a linked user with a GitHub

   * account.

   *

   * @param courseId ID of course to create repos for

   * @param repoPrefix each repo created will begin with this prefix, followed by a dash and the

   *     student's GitHub username

   * @param isPrivate determines whether the repository being created is private

   * @return the {@link edu.ucsb.cs156.frontiers.entities.Job Job} started to create the repos.

   */

  @PostMapping("/createRepos")

  @PreAuthorize("@CourseSecurity.hasManagePermissions(#root, #courseId)")

  public Job createRepos(

      @RequestParam Long courseId,

      @RequestParam String repoPrefix,

      @RequestParam Optional<Boolean> isPrivate,

      @RequestParam RepositoryPermissions permissions,

      @RequestParam(required = false, defaultValue = "STUDENTS_ONLY")

          RepositoryCreationOption creationOption) {

        courseRepository

    } else {

      CreateStudentOrStaffRepositoriesJob job =

    }

  }

  /**

   * Fires a job that creates team repos shared by all TeamMembers of each Team in a Course .

   *

   * @param courseId ID of course to create team repos for

   * @param repoPrefix each team repo created will begin with this prefix, followed by a dash and

   *     the team's name

   * @param isPrivate determines whether the repository being created is private

   * @return the {@link edu.ucsb.cs156.frontiers.entities.Job Job} started to create the repos.

   */

  @PostMapping("/createTeamRepos")

  @PreAuthorize("@CourseSecurity.hasManagePermissions(#root, #courseId)")

  public Job createTeamRepos(

      @RequestParam Long courseId,

      @RequestParam String repoPrefix,

      @RequestParam Optional<Boolean> isPrivate,

      @RequestParam RepositoryPermissions permissions,

      @RequestParam Optional<String> teamRegex) {

        courseRepository

    } else {

      CreateTeamRepositoriesJob job =

    }

  }

  /**

   * Fires a job that bulk deletes empty repos matching a specific prefix in the course's attached

   * organization.

   *

   * @param courseId ID of the course

   * @param prefix the prefix of the repositories to delete

   * @return the {@link edu.ucsb.cs156.frontiers.entities.Job Job} started to delete the repos.

   */

  @DeleteMapping("")

  @PreAuthorize("@CourseSecurity.hasManagePermissions(#root, #courseId)")

  public Job deleteRepos(@RequestParam Long courseId, @RequestParam String prefix) {

        courseRepository

    } else {

      DeleteRepoJob job =

    }

  }

}

Mutations