Merge 51decd1 into 86610bc

selvpcclient/resell/v2/users/doc.go

@@ -2,6 +2,14 @@
 Package users provides the ability to retrieve and manage users through the
 Resell v2 API.
 
+Example of getting a single user referenced by its id
+
+  user, _, err := users.Get(context, resellClient, userID)
+  if err != nil {
+    log.Fatal(err)
+  }
+  fmt.Println(user)
+
 Example of getting all users
 
   allUsers, _, err := users.List(ctx, resellClient)

selvpcclient/resell/v2/users/requests.go

@@ -12,6 +12,29 @@ import (
 
 const resourceURL = "users"
 
+// Get returns a single user by its id.
+func Get(ctx context.Context, client *selvpcclient.ServiceClient, id string) (*User, *selvpcclient.ResponseResult, error) {
+	url := strings.Join([]string{client.Endpoint, resourceURL, id}, "/")
+	responseResult, err := client.DoRequest(ctx, http.MethodGet, url, nil)
+	if err != nil {
+		return nil, nil, err
+	}
+	if responseResult.Err != nil {
+		return nil, responseResult, responseResult.Err
+	}
+
+	// Extract an user from the response body.
+	var result struct {
+		User *User `json:"user"`
+	}
+	err = responseResult.ExtractResult(&result)
+	if err != nil {
+		return nil, responseResult, err
+	}
+
+	return result.User, responseResult, nil
+}
+
 // List gets a list of users in the current domain.
 func List(ctx context.Context, client *selvpcclient.ServiceClient) ([]*User, *selvpcclient.ResponseResult, error) {
 	url := strings.Join([]string{client.Endpoint, resourceURL}, "/")

selvpcclient/resell/v2/users/testing/fixtures.go

@@ -2,6 +2,33 @@ package testing
 
 import "github.com/selectel/go-selvpcclient/selvpcclient/resell/v2/users"
 
+// TestGetUsersResponseRaw represents a raw response from the Get request.
+const TestGetUsersResponseRaw = `
+{
+    "user": {
+        "enabled": false,
+        "id": "c4b7e0581b964c52a1597fe0931eccdf",
+        "name": "User1"
+    }
+}
+`
+
+// TestGetUsersResponse represents the unmarshalled TestGetUsersResponseRaw response.
+var TestGetUsersResponse = &users.User{
+	ID:      "c4b7e0581b964c52a1597fe0931eccdf",
+	Name:    "User1",
+	Enabled: false,
+}
+
+// TestGetUserInvalidResponseRaw represents a raw invalid response with single user.
+const TestGetUserInvalidResponseRaw = `
+{
+    "user": {
+        "id": 999
+    }
+}
+`
+
 // TestListUsersResponseRaw represents a raw response from the List request.
 const TestListUsersResponseRaw = `
 {

selvpcclient/resell/v2/users/testing/requests_test.go

@@ -10,6 +10,111 @@ import (
 	"github.com/selectel/go-selvpcclient/selvpcclient/testutils"
 )
 
+func TestGetUser(t *testing.T) {
+	endpointCalled := false
+
+	testEnv := testutils.SetupTestEnv()
+	defer testEnv.TearDownTestEnv()
+	testEnv.NewTestResellV2Client()
+	testutils.HandleReqWithoutBody(t, &testutils.HandleReqOpts{
+		Mux:         testEnv.Mux,
+		URL:         "/resell/v2/users/4b2e452ed4c940bd87a88499eaf14c4f",
+		RawResponse: TestGetUsersResponseRaw,
+		Method:      http.MethodGet,
+		Status:      http.StatusOK,
+		CallFlag:    &endpointCalled,
+	})
+
+	ctx := context.Background()
+	actualResponse, _, err := users.Get(ctx, testEnv.Client, "4b2e452ed4c940bd87a88499eaf14c4f")
+	if err != nil {
+		t.Fatal(err)
+	}
+	expectedResponse := TestGetUsersResponse
+
+	if !endpointCalled {
+		t.Fatal("endpoint wasn't called")
+	}
+	if !reflect.DeepEqual(actualResponse, expectedResponse) {
+		t.Fatalf("expected %#v, but got %#v", actualResponse, expectedResponse)
+	}
+}
+
+func TestGetUserHTTPError(t *testing.T) {
+	endpointCalled := false
+
+	testEnv := testutils.SetupTestEnv()
+	defer testEnv.TearDownTestEnv()
+	testEnv.NewTestResellV2Client()
+	testutils.HandleReqWithoutBody(t, &testutils.HandleReqOpts{
+		Mux:         testEnv.Mux,
+		URL:         "/resell/v2/users/4b2e452ed4c940bd87a88499eaf14c4f",
+		RawResponse: TestGetUsersResponseRaw,
+		Method:      http.MethodGet,
+		Status:      http.StatusBadGateway,
+		CallFlag:    &endpointCalled,
+	})
+
+	ctx := context.Background()
+	user, httpResponse, err := users.Get(ctx, testEnv.Client, "4b2e452ed4c940bd87a88499eaf14c4f")
+
+	if !endpointCalled {
+		t.Fatal("endpoint wasn't called")
+	}
+	if err == nil {
+		t.Fatal("expected error from the Delete method")
+	}
+	if httpResponse.StatusCode != http.StatusBadGateway {
+		t.Fatalf("expected %d status in the HTTP response, but got %d", http.StatusBadRequest, httpResponse.StatusCode)
+	}
+	if user != nil {
+		t.Fatal("expected no users from the List method")
+	}
+}
+
+func TestGetUserTimeoutError(t *testing.T) {
+	testEnv := testutils.SetupTestEnv()
+	testEnv.Server.Close()
+	defer testEnv.TearDownTestEnv()
+	testEnv.NewTestResellV2Client()
+
+	ctx := context.Background()
+	_, _, err := users.Get(ctx, testEnv.Client, "4b2e452ed4c940bd87a88499eaf14c4f")
+
+	if err == nil {
+		t.Fatal("expected error from the Get method")
+	}
+}
+
+func TestGetUsersUnmarshalError(t *testing.T) {
+	endpointCalled := false
+
+	testEnv := testutils.SetupTestEnv()
+	defer testEnv.TearDownTestEnv()
+	testEnv.NewTestResellV2Client()
+	testutils.HandleReqWithoutBody(t, &testutils.HandleReqOpts{
+		Mux:         testEnv.Mux,
+		URL:         "/resell/v2/users/4b2e452ed4c940bd87a88499eaf14c4f",
+		RawResponse: TestGetUserInvalidResponseRaw,
+		Method:      http.MethodGet,
+		Status:      http.StatusOK,
+		CallFlag:    &endpointCalled,
+	})
+
+	ctx := context.Background()
+	user, _, err := users.Get(ctx, testEnv.Client, "4b2e452ed4c940bd87a88499eaf14c4f")
+
+	if !endpointCalled {
+		t.Fatal("endpoint wasn't called")
+	}
+	if user != nil {
+		t.Fatal("expected no user from the Get method")
+	}
+	if err == nil {
+		t.Fatal("expected error from the Get method")
+	}
+}
+
 func TestListUsers(t *testing.T) {
 	endpointCalled := false