RepositoryController.java

package edu.ucsb.cs156.frontiers.controllers;

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.RepositoryService;

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

import io.swagger.v3.oas.annotations.Operation;

import io.swagger.v3.oas.annotations.Parameter;

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;

@Tag(name = "Repository Controller")

@RestController

@RequestMapping("/api/repos")

  @Autowired RepositoryService repositoryService;

  @Autowired JobService jobService;

  @Autowired CourseRepository courseRepository;

  @Autowired GithubTeamService githubTeamService;

  /**

   * 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

   * @param teamRegex optional regular expression that will only create repos for team names that

   *     match this expression if omitted, repos will be created for every team

   * @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(required = false) String teamRegex) {

        courseRepository

    } else {

      CreateTeamRepositoriesJob job =

    }

  }

  @Operation(summary = "Delete empty repos matching a prefix for a specific course")

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

  @DeleteMapping("") // Maps to /api/repos

  public Job launchDeleteRepoJob(

      @Parameter(name = "courseId") @RequestParam Long courseId,

      @Parameter(name = "prefix") @RequestParam String prefix) {

        courseRepository

    }

    DeleteRepoJob job =

  }

}

Mutations