Create User Service Handler and SDK (#106)

* Create user handler stuff.

* Fixing Not Found errors from DB.

* Fixing param names.

* Update the proto's go package generation.

* Generate the user resource.

* Adding SDK methods for users.

* Fix the base type of Users and add tests.

* Connect user service to the controller handler.

* Attach the default org to the Test Controller's client.

* Take into account the provided request paths when the client builds the org/project path prefix.

* Adding comments to the API.

* rename repo function to repoFn.

* Fix typo in update mask errors.

* Clean up tests.

* Remove special checks for request url content in the api client and fix CORS test.

api/users/user.gen.go

@@ -0,0 +1,53 @@
+// Code generated by "make api"; DO NOT EDIT.
+package users
+
+import (
+	"encoding/json"
+	"time"
+
+	"github.com/fatih/structs"
+
+	"github.com/hashicorp/watchtower/api"
+	"github.com/hashicorp/watchtower/api/internal/strutil"
+)
+
+type User struct {
+	Client *api.Client `json:"-"`
+
+	defaultFields []string
+
+	// The ID of the Project
+	// Output only.
+	Id string `json:"id,omitempty"`
+	// Optional name for identification purposes
+	Name *string `json:"name,omitempty"`
+	// Optional user-set descripton for identification purposes
+	Description *string `json:"description,omitempty"`
+	// The time this resource was created
+	// Output only.
+	CreatedTime time.Time `json:"created_time,omitempty"`
+	// The time this resource was last updated.
+	// Output only.
+	UpdatedTime time.Time `json:"updated_time,omitempty"`
+	// Whether the resource is disabled
+	Disabled *bool `json:"disabled,omitempty"`
+}
+
+func (s *User) SetDefault(key string) {
+	s.defaultFields = strutil.AppendIfMissing(s.defaultFields, key)
+}
+
+func (s *User) UnsetDefault(key string) {
+	s.defaultFields = strutil.StrListDelete(s.defaultFields, key)
+}
+
+func (s User) MarshalJSON() ([]byte, error) {
+	m := structs.Map(s)
+	if m == nil {
+		m = make(map[string]interface{})
+	}
+	for _, k := range s.defaultFields {
+		m[k] = nil
+	}
+	return json.Marshal(m)
+}

api/users/user_test.go

@@ -0,0 +1,98 @@
+package users_test
+
+import (
+	"net/http"
+	"testing"
+
+	"github.com/hashicorp/watchtower/api"
+	"github.com/hashicorp/watchtower/api/scopes"
+	"github.com/hashicorp/watchtower/api/users"
+	"github.com/hashicorp/watchtower/internal/iam"
+	"github.com/hashicorp/watchtower/internal/servers/controller"
+	"github.com/stretchr/testify/assert"
+)
+
+func TestUser_Crud(t *testing.T) {
+	tc := controller.NewTestController(t, nil)
+	defer tc.Shutdown()
+
+	client := tc.Client()
+	org := &scopes.Organization{
+		Client: client,
+	}
+
+	checkUser := func(step string, u *users.User, apiErr *api.Error, err error, wantedName string) {
+		assert := assert.New(t)
+		assert.NoError(err, step)
+		if !assert.Nil(apiErr, step) && apiErr.Message != nil {
+			t.Errorf("ApiError message: %q", *apiErr.Message)
+		}
+		assert.NotNil(u, "returned project", step)
+		gotName := ""
+		if u.Name != nil {
+			gotName = *u.Name
+		}
+		assert.Equal(wantedName, gotName, step)
+	}
+
+	u, apiErr, err := org.CreateUser(tc.Context(), &users.User{Name: api.String("foo")})
+	checkUser("create", u, apiErr, err, "foo")
+
+	u, apiErr, err = org.ReadUser(tc.Context(), &users.User{Id: u.Id})
+	checkUser("read", u, apiErr, err, "foo")
+
+	u = &users.User{Id: u.Id}
+	u.Name = api.String("bar")
+	u, apiErr, err = org.UpdateUser(tc.Context(), u)
+	checkUser("update", u, apiErr, err, "bar")
+
+	u = &users.User{Id: u.Id}
+	u.SetDefault("name")
+	u, apiErr, err = org.UpdateUser(tc.Context(), u)
+	checkUser("update", u, apiErr, err, "")
+
+	existed, apiErr, err := org.DeleteUser(tc.Context(), u)
+	assert.NoError(t, err)
+	assert.True(t, existed, "Expected existing user when deleted, but it wasn't.")
+
+	existed, apiErr, err = org.DeleteUser(tc.Context(), u)
+	assert.NoError(t, err)
+	assert.False(t, existed, "Expected user to not exist when deleted, but it did.")
+}
+
+func TestUser_Errors(t *testing.T) {
+	assert := assert.New(t)
+	tc := controller.NewTestController(t, nil)
+	defer tc.Shutdown()
+	ctx := tc.Context()
+
+	client := tc.Client()
+	org := &scopes.Organization{
+		Client: client,
+	}
+
+	u, apiErr, err := org.CreateUser(ctx, &users.User{Name: api.String("first")})
+	assert.NoError(err)
+	assert.Nil(apiErr)
+	assert.NotNil(u)
+
+	// Create another resource with the same name.
+	_, apiErr, err = org.CreateUser(ctx, &users.User{Name: api.String("first")})
+	assert.NoError(err)
+	assert.NotNil(apiErr)
+
+	_, apiErr, err = org.ReadUser(ctx, &users.User{Id: iam.UserPrefix + "_doesntexis"})
+	assert.NoError(err)
+	assert.NotNil(apiErr)
+	assert.EqualValues(*apiErr.Status, http.StatusNotFound)
+
+	_, apiErr, err = org.ReadUser(ctx, &users.User{Id: "invalid id"})
+	assert.NoError(err)
+	assert.NotNil(apiErr)
+	assert.EqualValues(*apiErr.Status, http.StatusBadRequest)
+
+	_, apiErr, err = org.UpdateUser(ctx, &users.User{Id: u.Id})
+	assert.NoError(err)
+	assert.NotNil(apiErr)
+	assert.EqualValues(*apiErr.Status, http.StatusBadRequest)
+}