feat: GET /challenge?challenge_id=xxxd

api/pwengine.proto

@@ -93,6 +93,7 @@ service Engine {
   rpc GetUserSession(Void) returns (UserSessionOutput) { option (google.api.http) = {get: "/user-session"}; };
   rpc SetPreferences(SetPreferencesInput) returns (Void) { option (google.api.http) = {post: "/preferences"; body: "*"}; };
   rpc ListChallenges(Void) returns (ListChallengesOutput) { option (google.api.http) = {get: "/challenges"}; };
+  rpc GetChallenge(GetChallengeInput) returns (GetChallengeOutput) { option (google.api.http) = {get: "/challenge"}; };
   rpc ListTeams(Void) returns (ListTeamsOutput) { option (google.api.http) = {get: "/teams"}; };
   rpc ListTournamentTeams(ListTournamentTeamsInput) returns (ListTournamentTeamsOutput) { option (google.api.http) = {get: "/tournament/teams"}; };
   rpc GetTournamentTeam(GetTournamentTeamInput) returns (GetTournamentTeamOutput) { option (google.api.http) = {get: "/tournament/team"}; };
@@ -113,7 +114,6 @@ message Void {
   };
 }
 
-
 message GetTournamentTeamInput {
   int64 tournament_team_id = 1 [(gogoproto.customname) = "TournamentTeamID"];
 }
@@ -122,6 +122,14 @@ message GetTournamentTeamOutput {
   pathwar.db.TournamentTeam item = 1;
 }
 
+message GetChallengeInput {
+  int64 challenge_id = 1 [(gogoproto.customname) = "ChallengeID"];
+}
+
+message GetChallengeOutput {
+  pathwar.db.Challenge item = 1;
+}
+
 message ListTournamentTeamsInput {
   int64 tournament_id = 1 [(gogoproto.customname) = "TournamentID"];
 }

go/pkg/pwengine/api_pub_getchallenge.go

@@ -0,0 +1,36 @@
+package pwengine
+
+import (
+	"context"
+	"fmt"
+
+	"pathwar.land/go/pkg/pwdb"
+)
+
+func (e *engine) GetChallenge(ctx context.Context, in *GetChallengeInput) (*GetChallengeOutput, error) {
+	{ // validation
+		if in.ChallengeID == 0 {
+			return nil, ErrMissingArgument
+		}
+	}
+
+	var item pwdb.Challenge
+	err := e.db.
+		Set("gorm:auto_preload", true).
+		Where(pwdb.Challenge{ID: in.ChallengeID}).
+		First(&item).
+		Error
+
+	switch {
+	case err != nil && pwdb.IsRecordNotFoundError(err):
+		return nil, ErrInvalidArgument // FIXME: wrap original error
+	case err != nil:
+		return nil, fmt.Errorf("query challenge: %w", err)
+	}
+
+	ret := GetChallengeOutput{
+		Item: &item,
+	}
+
+	return &ret, nil
+}

go/pkg/pwengine/api_pub_getchallenge_test.go

@@ -0,0 +1,74 @@
+package pwengine
+
+import (
+	"context"
+	"errors"
+	"testing"
+
+	"pathwar.land/go/internal/testutil"
+)
+
+func TestEngine_GetChallenge(t *testing.T) {
+	engine, cleanup := TestingEngine(t, Opts{Logger: testutil.Logger(t)})
+	defer cleanup()
+	ctx := testingSetContextToken(context.Background(), t)
+
+	// FIXME: check for permissions
+
+	challenges := map[string]int64{}
+	for _, challenge := range testingChallenges(t, engine).Items {
+		challenges[challenge.Name] = challenge.ID
+	}
+
+	var tests = []struct {
+		name                  string
+		input                 *GetChallengeInput
+		expectedErr           error
+		expectedChallengeName string
+		expectedAuthor        string
+	}{
+		{
+			"empty",
+			&GetChallengeInput{},
+			ErrMissingArgument,
+			"",
+			"",
+		}, {
+			"unknown-tournament-id",
+			&GetChallengeInput{ChallengeID: -42}, // -42 should not exists
+			ErrInvalidArgument,
+			"",
+			"",
+		}, {
+			"Staff",
+			&GetChallengeInput{ChallengeID: challenges["Hello World (test)"]},
+			nil,
+			"Hello World (test)",
+			"m1ch3l",
+		},
+	}
+
+	for _, test := range tests {
+		t.Run(test.name, func(t *testing.T) {
+			ret, err := engine.GetChallenge(ctx, test.input)
+			if !errors.Is(err, test.expectedErr) {
+				t.Fatalf("Expected %#v, got %#v.", test.expectedErr, err)
+			}
+			if err != nil {
+				return
+			}
+
+			// FIXME: check for ChallengeVersions and ChallengeInstances
+
+			if ret.Item.ID != test.input.ChallengeID {
+				t.Fatalf("Expected %q, got %q.", test.input.ChallengeID, ret.Item.ID)
+			}
+			if ret.Item.Name != test.expectedChallengeName {
+				t.Fatalf("Expected %q, got %q.", test.expectedChallengeName, ret.Item.Name)
+			}
+			if ret.Item.Author != test.expectedAuthor {
+				t.Fatalf("Expected %q, got %q.", test.expectedAuthor, ret.Item.Author)
+			}
+		})
+	}
+}