user

Documentation

Index

• Variables
• type Capabilities
• type TalkUser
  • func NewUser(url string, username string, password string, config *TalkUserConfig) (*TalkUser, error)
  • func (t *TalkUser) Capabilities() (*Capabilities, error)
  • func (t *TalkUser) DownloadFile(path string) (data *[]byte, err error)
  • func (t *TalkUser) RequestClient(client request.Client) *request.Client
• type TalkUserConfig

Variables

var (
	// ErrUserIsNil is returned when a funciton is called with an nil user.
	ErrUserIsNil = errors.New("user is nil")
)

Types

type Capabilities

type Capabilities struct {
	AttachmentsFolder      string `ocscapability:"config => attachments => folder"`
	ChatMaxLength          int
	Audio                  bool `ocscapability:"audio"`
	Video                  bool `ocscapability:"video"`
	Chat                   bool `ocscapability:"chat"`
	GuestSignaling         bool `ocscapability:"guest-signaling"`
	EmptyGroupRoom         bool `ocscapability:"empty-group-room"`
	GuestDisplayNames      bool `ocscapability:"guest-display-names"`
	MultiRoomUsers         bool `ocscapability:"multi-room-users"`
	ChatV2                 bool `ocscapability:"chat-v2"`
	Favorites              bool `ocscapability:"favorites"`
	LastRoomActivity       bool `ocscapability:"last-room-activity"`
	NoPing                 bool `ocscapability:"no-ping"`
	SystemMessages         bool `ocscapability:"system-messages"`
	MentionFlag            bool `ocscapability:"mention-flag"`
	InCallFlags            bool `ocscapability:"in-call-flags"`
	InviteByMail           bool `ocscapability:"invite-by-mail"`
	NotificationLevels     bool `ocscapability:"notification-levels"`
	InviteGroupsAndMails   bool `ocscapability:"invite-groups-and-mails"`
	LockedOneToOneRooms    bool `ocscapability:"locked-one-to-one-rooms"`
	ReadOnlyRooms          bool `ocscapability:"read-only-rooms"`
	ChatReadMarker         bool `ocscapability:"chat-read-marker"`
	WebinaryLobby          bool `ocscapability:"webinary-lobby"`
	StartCallFlag          bool `ocscapability:"start-call-flag"`
	ChatReplies            bool `ocscapability:"chat-replies"`
	CirclesSupport         bool `ocscapability:"circles-support"`
	AttachmentsAllowed     bool `ocscapability:"config => attachments => allowed"`
	ConversationsCanCreate bool `ocscapability:"config => conversations => can-create"`
	ForceMute              bool `ocscapability:"force-mute"`
	ConversationV2         bool `ocscapability:"conversation-v2"`
	ChatReferenceID        bool `ocscapability:"chat-reference-id"`
}

Capabilities describes the capabilities that the Nextcloud Talk instance is capable of. Visit https://nextcloud-talk.readthedocs.io/en/latest/capabilities/ for more info.

type TalkUser

type TalkUser struct {
	User         string
	Pass         string
	NextcloudURL string
	Config       *TalkUserConfig
	// contains filtered or unexported fields
}

TalkUser represents a user of Nextcloud Talk

func NewUser

func NewUser(url string, username string, password string, config *TalkUserConfig) (*TalkUser, error)

NewUser returns a TalkUser instance The url should be the full URL of the Nextcloud instance (e.g. https://cloud.mydomain.me)

func (*TalkUser) Capabilities

func (t *TalkUser) Capabilities() (*Capabilities, error)

Capabilities returns an instance of Capabilities that describes what the Nextcloud Talk instance supports

func (*TalkUser) DownloadFile

func (t *TalkUser) DownloadFile(path string) (data *[]byte, err error)

DownloadFile downloads the file at the given path

Meant to be used with rich object string's path.

func (*TalkUser) RequestClient

func (t *TalkUser) RequestClient(client request.Client) *request.Client

RequestClient returns a monaco-io that is preconfigured to make OCS API calls

type TalkUserConfig

type TalkUserConfig struct {
	TLSConfig *tls.Config
}

TalkUserConfig is configuration options for TalkUsers