gonextcloud/README.md

# [WIP] Nextcloud Go API Client

A simple Client for Nextcloud's API in Go.

## TODO
- [Auth](#authentication)
  - ~~login~~
  - ~~logout~~
- [Users](#users)
  - ~~search~~
  - ~~list~~
  - ~~get infos~~
  - ~~create~~
  - ~~update~~
  - ~~delete~~
  - ~~enable~~
  - ~~disable~~
  - ~~get groups~~
  - ~~add to group~~
  - ~~remove from group~~
  - ~~get subadmin group~~
  - ~~promote subadmin~~
  - ~~demote subadmin~~
  - ~~send welcome mail~~ 
- [Groups](#groups)
  - ~~create~~
  - ~~delete~~
  - ~~get members~~
  - ~~get subadmins~~
- [Apps](#apps)
  - list
  - get infos
  - enable
  - disable

# client
--
```go
    import "github.com/partitio/gonextcloud/client"
```


## Usage
```go
package main

import (
	"fmt"
	"github.com/partitio/gonextcloud/client"
)

func main() {
	url := "https://www.mynextcloud.com"
	username := "admin"
	password := "password"
	c, err := client.NewClient(url)
	if err != nil {
		panic(err)
	}
	if err := c.Login(username, password); err != nil {
		panic(err)
	}
	defer c.Logout()
}
```

#### func  NewClient

```go
func NewClient(hostname string) (*Client, error)
```

## Authentication
#### func (*Client) Login

```go
func (c *Client) Login(username string, password string) error
```

#### func (*Client) Logout
```go
func (c *Client) Logout() error
```
## Users
#### func (*Client) User

```go
func (c *Client) User(name string) (*types.User, error)
```

#### func (*Client) UserCreate

```go
func (c *Client) UserCreate(username string, password string) error
```

#### func (*Client) UserDelete

```go
func (c *Client) UserDelete(name string) error
```

#### func (*Client) UserDisable

```go
func (c *Client) UserDisable(name string) error
```

#### func (*Client) UserEnable

```go
func (c *Client) UserEnable(name string) error
```

#### func (*Client) UserGroupAdd

```go
func (c *Client) UserGroupAdd(name string, group string) error
```

#### func (*Client) UserGroupDemote

```go
func (c *Client) UserGroupDemote(name string, group string) error
```

#### func (*Client) UserGroupList

```go
func (c *Client) UserGroupList(name string) ([]string, error)
```

#### func (*Client) UserGroupPromote

```go
func (c *Client) UserGroupPromote(name string, group string) error
```

#### func (*Client) UserGroupRemove

```go
func (c *Client) UserGroupRemove(name string, group string) error
```

#### func (*Client) UserGroupSubAdminList

```go
func (c *Client) UserGroupSubAdminList(name string) ([]string, error)
```

#### func (*Client) UserList

```go
func (c *Client) UserList() ([]string, error)
```

#### func (*Client) UserSearch

```go
func (c *Client) UserSearch(search string) ([]string, error)
```

#### func (*Client) UserSendWelcomeEmail

```go
func (c *Client) UserSendWelcomeEmail(name string) error
```

#### func (*Client) UserUpdateAddress

```go
func (c *Client) UserUpdateAddress(name string, address string) error
```

#### func (*Client) UserUpdateDisplayName

```go
func (c *Client) UserUpdateDisplayName(name string, displayName string) error
```

#### func (*Client) UserUpdateEmail

```go
func (c *Client) UserUpdateEmail(name string, email string) error
```

#### func (*Client) UserUpdatePassword

```go
func (c *Client) UserUpdatePassword(name string, password string) error
```

#### func (*Client) UserUpdatePhone

```go
func (c *Client) UserUpdatePhone(name string, phone string) error
```

#### func (*Client) UserUpdateQuota

```go
func (c *Client) UserUpdateQuota(name string, quota string) error
```

#### func (*Client) UserUpdateTwitter

```go
func (c *Client) UserUpdateTwitter(name string, twitter string) error
```

#### func (*Client) UserUpdateWebSite

## Groups

```go
func (c *Client) UserUpdateWebSite(name string, website string) error
```
#### func (*Client) GroupCreate

```go
func (c *Client) GroupCreate(name string) error
```

#### func (*Client) GroupDelete

```go
func (c *Client) GroupDelete(name string) error
```

#### func (*Client) GroupList

```go
func (c *Client) GroupList() ([]string, error)
```

#### func (*Client) GroupSearch

```go
func (c *Client) GroupSearch(search string) ([]string, error)
```

#### func (*Client) GroupSubAdminList

```go
func (c *Client) GroupSubAdminList(name string) ([]string, error)
```

#### func (*Client) GroupUsers

```go
func (c *Client) GroupUsers(name string) ([]string, error)
```