Add user settings get & update functions (#531)

close #529

Reviewed-on: https://gitea.com/gitea/go-sdk/pulls/531
Reviewed-by: Lunny Xiao <xiaolunwen@gmail.com>
Reviewed-by: Norwin <noerw@noreply.gitea.io>
Co-authored-by: 6543 <6543@obermui.de>
Co-committed-by: 6543 <6543@obermui.de>

gitea/user_settings.go

@@ -0,0 +1,62 @@
+// Copyright 2021 The Gitea Authors. All rights reserved.
+// Use of this source code is governed by a MIT-style
+// license that can be found in the LICENSE file.
+
+package gitea
+
+import (
+	"bytes"
+	"encoding/json"
+)
+
+// UserSettings represents user settings
+type UserSettings struct {
+	FullName      string `json:"full_name"`
+	Website       string `json:"website"`
+	Description   string `json:"description"`
+	Location      string `json:"location"`
+	Language      string `json:"language"`
+	Theme         string `json:"theme"`
+	DiffViewStyle string `json:"diff_view_style"`
+	// Privacy
+	HideEmail    bool `json:"hide_email"`
+	HideActivity bool `json:"hide_activity"`
+}
+
+// UserSettingsOptions represents options to change user settings
+type UserSettingsOptions struct {
+	FullName      *string `json:"full_name,omitempty"`
+	Website       *string `json:"website,omitempty"`
+	Description   *string `json:"description,omitempty"`
+	Location      *string `json:"location,omitempty"`
+	Language      *string `json:"language,omitempty"`
+	Theme         *string `json:"theme,omitempty"`
+	DiffViewStyle *string `json:"diff_view_style,omitempty"`
+	// Privacy
+	HideEmail    *bool `json:"hide_email,omitempty"`
+	HideActivity *bool `json:"hide_activity,omitempty"`
+}
+
+// GetUserSettings returns user settings
+func (c *Client) GetUserSettings() (*UserSettings, *Response, error) {
+	if err := c.checkServerVersionGreaterThanOrEqual(version1_15_0); err != nil {
+		return nil, nil, err
+	}
+	userConfig := new(UserSettings)
+	resp, err := c.getParsedResponse("GET", "/user/settings", nil, nil, userConfig)
+	return userConfig, resp, err
+}
+
+// UpdateUserSettings returns user settings
+func (c *Client) UpdateUserSettings(opt UserSettingsOptions) (*UserSettings, *Response, error) {
+	if err := c.checkServerVersionGreaterThanOrEqual(version1_15_0); err != nil {
+		return nil, nil, err
+	}
+	body, err := json.Marshal(&opt)
+	if err != nil {
+		return nil, nil, err
+	}
+	userConfig := new(UserSettings)
+	resp, err := c.getParsedResponse("PATCH", "/user/settings", jsonHeader, bytes.NewReader(body), userConfig)
+	return userConfig, resp, err
+}

gitea/user_settings_test.go

@@ -0,0 +1,48 @@
+// Copyright 2021 The Gitea Authors. All rights reserved.
+// Use of this source code is governed by a MIT-style
+// license that can be found in the LICENSE file.
+
+package gitea
+
+import (
+	"log"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+)
+
+func TestUserSettings(t *testing.T) {
+	log.Println("== TestUserSettings ==")
+	c := newTestClient()
+
+	userConf, _, err := c.GetUserSettings()
+	assert.NoError(t, err)
+	assert.NotNil(t, userConf)
+	assert.EqualValues(t, UserSettings{
+		Theme:        "gitea",
+		HideEmail:    false,
+		HideActivity: false,
+	}, *userConf)
+
+	userConf, _, err = c.UpdateUserSettings(UserSettingsOptions{
+		FullName:  OptionalString("Admin User on Test"),
+		Language:  OptionalString("de_de"),
+		HideEmail: OptionalBool(true),
+	})
+	assert.NoError(t, err)
+	assert.NotNil(t, userConf)
+	assert.EqualValues(t, UserSettings{
+		FullName:     "Admin User on Test",
+		Theme:        "gitea",
+		Language:     "de_de",
+		HideEmail:    true,
+		HideActivity: false,
+	}, *userConf)
+
+	_, _, err = c.UpdateUserSettings(UserSettingsOptions{
+		FullName:  OptionalString(""),
+		Language:  OptionalString(""),
+		HideEmail: OptionalBool(false),
+	})
+	assert.NoError(t, err)
+}

gitea/user_test.go

@@ -22,7 +22,7 @@ func TestMyUser(t *testing.T) {
 	assert.EqualValues(t, "test01@gitea.io", user.Email)
 	assert.EqualValues(t, "", user.FullName)
 	assert.EqualValues(t, getGiteaURL()+"/user/avatar/test01/-1", user.AvatarURL)
-	assert.Equal(t, true, user.IsAdmin)
+	assert.True(t, user.IsAdmin)
 }
 
 func TestUserApp(t *testing.T) {