feat: Add ListAcceptedAssignments and GetAssignmentGrades methods to Classroom API (#3732)

Author: jferrl

github/classroom.go

@@ -16,6 +16,18 @@ import (
 // GitHub API docs: https://docs.github.com/rest/classroom/classroom
 type ClassroomService service
 
+// ClassroomUser represents a GitHub user simplified for Classroom.
+type ClassroomUser struct {
+	ID        *int64  `json:"id,omitempty"`
+	Login     *string `json:"login,omitempty"`
+	AvatarURL *string `json:"avatar_url,omitempty"`
+	HTMLURL   *string `json:"html_url,omitempty"`
+}
+
+func (u ClassroomUser) String() string {
+	return Stringify(u)
+}
+
 // Classroom represents a GitHub Classroom.
 type Classroom struct {
 	ID           *int64        `json:"id,omitempty"`
@@ -56,6 +68,41 @@ func (a ClassroomAssignment) String() string {
 	return Stringify(a)
 }
 
+// AcceptedAssignment represents a GitHub Classroom accepted assignment.
+type AcceptedAssignment struct {
+	ID          *int64               `json:"id,omitempty"`
+	Submitted   *bool                `json:"submitted,omitempty"`
+	Passing     *bool                `json:"passing,omitempty"`
+	CommitCount *int                 `json:"commit_count,omitempty"`
+	Grade       *string              `json:"grade,omitempty"`
+	Students    []*ClassroomUser     `json:"students,omitempty"`
+	Repository  *Repository          `json:"repository,omitempty"`
+	Assignment  *ClassroomAssignment `json:"assignment,omitempty"`
+}
+
+func (a AcceptedAssignment) String() string {
+	return Stringify(a)
+}
+
+// AssignmentGrade represents a GitHub Classroom assignment grade.
+type AssignmentGrade struct {
+	AssignmentName        *string    `json:"assignment_name,omitempty"`
+	AssignmentURL         *string    `json:"assignment_url,omitempty"`
+	StarterCodeURL        *string    `json:"starter_code_url,omitempty"`
+	GithubUsername        *string    `json:"github_username,omitempty"`
+	RosterIdentifier      *string    `json:"roster_identifier,omitempty"`
+	StudentRepositoryName *string    `json:"student_repository_name,omitempty"`
+	StudentRepositoryURL  *string    `json:"student_repository_url,omitempty"`
+	SubmissionTimestamp   *Timestamp `json:"submission_timestamp,omitempty"`
+	PointsAwarded         *int       `json:"points_awarded,omitempty"`
+	PointsAvailable       *int       `json:"points_available,omitempty"`
+	GroupName             *string    `json:"group_name,omitempty"`
+}
+
+func (g AssignmentGrade) String() string {
+	return Stringify(g)
+}
+
 // GetAssignment gets a GitHub Classroom assignment. Assignment will only be
 // returned if the current user is an administrator of the GitHub Classroom
 // for the assignment.
@@ -155,3 +202,55 @@ func (s *ClassroomService) ListClassroomAssignments(ctx context.Context, classro
 
 	return assignments, resp, nil
 }
+
+// ListAcceptedAssignments lists accepted assignments for a GitHub Classroom assignment.
+// Accepted assignments will only be returned if the current user is an administrator
+// of the GitHub Classroom for the assignment.
+//
+// GitHub API docs: https://docs.github.com/rest/classroom/classroom#list-accepted-assignments-for-an-assignment
+//
+//meta:operation GET /assignments/{assignment_id}/accepted_assignments
+func (s *ClassroomService) ListAcceptedAssignments(ctx context.Context, assignmentID int64, opts *ListOptions) ([]*AcceptedAssignment, *Response, error) {
+	u := fmt.Sprintf("assignments/%v/accepted_assignments", assignmentID)
+	u, err := addOptions(u, opts)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	req, err := s.client.NewRequest("GET", u, nil)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	var acceptedAssignments []*AcceptedAssignment
+	resp, err := s.client.Do(ctx, req, &acceptedAssignments)
+	if err != nil {
+		return nil, resp, err
+	}
+
+	return acceptedAssignments, resp, nil
+}
+
+// GetAssignmentGrades gets assignment grades for a GitHub Classroom assignment.
+// Grades will only be returned if the current user is an administrator
+// of the GitHub Classroom for the assignment.
+//
+// GitHub API docs: https://docs.github.com/rest/classroom/classroom#get-assignment-grades
+//
+//meta:operation GET /assignments/{assignment_id}/grades
+func (s *ClassroomService) GetAssignmentGrades(ctx context.Context, assignmentID int64) ([]*AssignmentGrade, *Response, error) {
+	u := fmt.Sprintf("assignments/%v/grades", assignmentID)
+
+	req, err := s.client.NewRequest("GET", u, nil)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	var grades []*AssignmentGrade
+	resp, err := s.client.Do(ctx, req, &grades)
+	if err != nil {
+		return nil, resp, err
+	}
+
+	return grades, resp, nil
+}