icqbot

package module
v0.0.0-...-027d1ef Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Aug 24, 2020 License: MIT Imports: 17 Imported by: 0

README

Golang interface for Mail.ru Instant Messengers bot API

CircleCI go.dev reference

  • Brand new Bot API!

  • Zero-configuration library

  • Simple and clear interface

API specification:

ICQ New
Myteam
Agent Mail.ru

Install

go get github.com/mail-ru-im/bot-golang

Usage

Create your own bot by sending the /newbot command to Metabot and follow the instructions.

Note a bot can only reply after the user has added it to his contacts list, or if the user was the first to start a dialogue.

Create your bot
package main

import "github.com/mail-ru-im/bot-golang"

func main() {
    bot, err := icqbot.NewBot(BOT_TOKEN)
    if err != nil {
        log.Println("wrong token")
    }

    message := bot.NewTextMessage("awesomechat@agent.chat", "text")
    message.Send()
}
Send and edit messages

You can create, edit and reply to messages like a piece of cake.

message := bot.NewTextMessage("awesomechat@agent.chat", "text")
message.Send()

fmt.Println(message.MsgID)

message.Text = "new text"

message.Edit()
// AWESOME!

message.Reply("hey, what did you write before???")
// SO HOT!
Subscribe events

Get all updates from the channel. Use context for cancellation.

ctx, finish := context.WithCancel(context.Background())
updates := bot.GetUpdatesChannel(ctx)
for update := range updates {
	// your awesome logic here
}
Passing options

You don't need this. But if you do, you can override bot's API URL:

bot := icqbot.NewBot(BOT_TOKEN, icqbot.BotApiURL("https://agent.mail.ru/bot/v1"))

And debug all api requests and responses:

bot := icqbot.NewBot(BOT_TOKEN, icqbot.BotDebug(true))

Documentation

Index

Constants

View Source 
const (
	NEW_MESSAGE       EventType = "newMessage"
	EDITED_MESSAGE    EventType = "editedMessage"
	DELETED_MESSAGE   EventType = "deletedMessage"
	PINNED_MESSAGE    EventType = "pinnedMessage"
	UNPINNED_MESSAGE  EventType = "unpinnedMessage"
	NEW_CHAT_MEMBERS  EventType = "newChatMembers"
	LEFT_CHAT_MEMBERS EventType = "leftChatMembers"
	CALLBACK_QUERY    EventType = "callbackQuery"

	STICKER PartType = "sticker"
	MENTION PartType = "mention"
	VOICE   PartType = "voice"
	FILE    PartType = "file"
	FORWARD PartType = "forward"
	REPLY   PartType = "reply"
)

Variables

This section is empty.

Functions

This section is empty.

Types

type AdminsListResponse 

type AdminsListResponse struct {
	List []ChatMember `json:"admins"`
}

func (AdminsListResponse) MarshalEasyJSON 

func (v AdminsListResponse) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (AdminsListResponse) MarshalJSON 

func (v AdminsListResponse) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*AdminsListResponse) UnmarshalEasyJSON 

func (v *AdminsListResponse) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*AdminsListResponse) UnmarshalJSON 

func (v *AdminsListResponse) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type Bot 

type Bot struct {
	Info *BotInfo
	// contains filtered or unexported fields
}

Bot is the main structure for interaction with API. All fields are private, you can configure bot using config arguments in NewBot func.

func NewBot 

func NewBot(token string, opts ...BotOption) (*Bot, error)

NewBot returns new bot object. All communications with bot API must go through Bot struct. In general you don't need to configure this bot, therefore all options are optional arguments.

func (*Bot) BlockChatUser 

func (b *Bot) BlockChatUser(chatID, userID string, deleteLastMessages bool) error

BlockChatUser blocks user and removes him from chat. If deleteLastMessages is true, the messages written recently will be deleted

func (*Bot) EditMessage 

func (b *Bot) EditMessage(message *Message) error

EditMessage edit a message passed as an argument.

func (*Bot) GetChatAdmins 

func (b *Bot) GetChatAdmins(chatID string) ([]ChatMember, error)

GetChatAdmins returns chat admins list with fields: userID, creator flag

func (*Bot) GetChatBlockedUsers 

func (b *Bot) GetChatBlockedUsers(chatID string) ([]User, error)

GetChatBlockedUsers returns chat blocked users list: userID

func (*Bot) GetChatInfo 

func (b *Bot) GetChatInfo(chatID string) (*Chat, error)

GetChatInfo returns information about chat: id, type, title, public, group, inviteLink, admins

func (*Bot) GetChatMembers 

func (b *Bot) GetChatMembers(chatID string) ([]ChatMember, error)

GetChatMem returns chat members list with fields: userID, creator flag, admin flag

func (*Bot) GetChatPendingUsers 

func (b *Bot) GetChatPendingUsers(chatID string) ([]User, error)

GetChatPendingUsers returns chat join pending users list: userID

func (*Bot) GetFileInfo 

func (b *Bot) GetFileInfo(fileID string) (*File, error)

GetFileInfo returns information about file: id, type, size, filename, url

func (*Bot) GetInfo 

func (b *Bot) GetInfo() (*BotInfo, error)

GetInfo returns information about bot: id, name, about, avatar

func (*Bot) GetUpdatesChannel 

func (b *Bot) GetUpdatesChannel(ctx context.Context) <-chan Event

GetUpdatesChannel returns a channel, which will be filled with events. You can pass cancellable context there and stop receiving events. The channel will be closed after context cancellation.

func (*Bot) NewButtonResponse 

func (b *Bot) NewButtonResponse(queryID, url, text string, showAlert bool) *ButtonResponse

NewButtonResponse returns new ButtonResponse

func (*Bot) NewChat 

func (b *Bot) NewChat(id string) *Chat

func (*Bot) NewFileMessage 

func (b *Bot) NewFileMessage(chatID string, file FileReader) *Message

NewFileMessage returns new file message

func (*Bot) NewFileMessageByFileID 

func (b *Bot) NewFileMessageByFileID(chatID, fileID string) *Message

NewFileMessageByFileID returns new message with previously uploaded file id

func (*Bot) NewInlineKeyboardMessage 

func (b *Bot) NewInlineKeyboardMessage(chatID, text string, keyboard [][]Button) *Message

NewInlineKeyboardMessage returns new text message with inline keyboard

func (*Bot) NewMessage 

func (b *Bot) NewMessage(chatID string) *Message

NewMessage returns new message

func (*Bot) NewMessageFromPart 

func (b *Bot) NewMessageFromPart(message PartMessage) *Message

NewMessageFromPart returns new message based on part message

func (*Bot) NewTextMessage 

func (b *Bot) NewTextMessage(chatID, text string) *Message

NewTextMessage returns new text message

func (*Bot) NewVoiceMessage 

func (b *Bot) NewVoiceMessage(chatID string, file FileReader) *Message

NewVoiceMessage returns new voice message

func (*Bot) NewVoiceMessageByFileID 

func (b *Bot) NewVoiceMessageByFileID(chatID, fileID string) *Message

NewVoiceMessageByFileID returns new message with previously uploaded voice file id

func (*Bot) ResolveChatJoinRequests 

func (b *Bot) ResolveChatJoinRequests(chatID, userID string, accept, everyone bool) error

ResolveChatJoinRequests sends a decision to accept/decline user join to chat

func (*Bot) SendChatActions 

func (b *Bot) SendChatActions(chatID string, actions ...ChatAction) error

SendChatActions sends an actions like "typing, looking"

func (*Bot) SendMessage 

func (b *Bot) SendMessage(message *Message) error

SendMessage sends a message, passed as an argument. This method fills the argument with ID of sent message and returns an error if any.

func (*Bot) SetChatAbout 

func (b *Bot) SetChatAbout(chatID, about string) error

SetChatAbout changes chat about

func (*Bot) SetChatRules 

func (b *Bot) SetChatRules(chatID, rules string) error

SetChatRules changes chat rules

func (*Bot) SetChatTitle 

func (b *Bot) SetChatTitle(chatID, title string) error

SetChatTitle changes chat title

func (*Bot) UnblockChatUser 

func (b *Bot) UnblockChatUser(chatID, userID string) error

UnblockChatUser unblocks user in chat

type BotApiURL 

type BotApiURL string

func (BotApiURL) Type 

func (o BotApiURL) Type() string

func (BotApiURL) Value 

func (o BotApiURL) Value() interface{}

type BotDebug 

type BotDebug bool

func (BotDebug) Type 

func (o BotDebug) Type() string

func (BotDebug) Value 

func (o BotDebug) Value() interface{}

type BotInfo 

type BotInfo struct {
	User

	// Nickname of the bot
	Nick string `json:"nick"`

	// Name of the bot
	FirstName string `json:"firstName"`

	// Information about the box
	About string `json:"about"`

	// A slice of avatars
	Photo []Photo `json:"photo"`
}

func (BotInfo) MarshalEasyJSON 

func (v BotInfo) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (BotInfo) MarshalJSON 

func (v BotInfo) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*BotInfo) UnmarshalEasyJSON 

func (v *BotInfo) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*BotInfo) UnmarshalJSON 

func (v *BotInfo) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type BotOption 

type BotOption interface {
	Type() string
	Value() interface{}
}

type Button 

type Button struct {
	// Button text
	Text string `json:"text"`

	// URL to be opened
	// You can't use it with CallbackData
	URL string `json:"url,omitempty"`

	// Data that identify the button
	// You can't use it with URL
	CallbackData string `json:"callbackData,omitempty"`
}

Button represents a button in inline keyboard

func NewCallbackButton 

func NewCallbackButton(text string, callbackData string) Button

NewCallbackButton returns new button with CallbackData field

func NewURLButton 

func NewURLButton(text string, url string) Button

NewURLButton returns new button with URL field

func (Button) MarshalEasyJSON 

func (v Button) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (Button) MarshalJSON 

func (v Button) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*Button) UnmarshalEasyJSON 

func (v *Button) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*Button) UnmarshalJSON 

func (v *Button) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type ButtonResponse 

type ButtonResponse struct {

	// Id of the query
	QueryID string `json:"queryId"`

	// Text of the response message
	Text string `json:"text"`

	// Display alert?
	ShowAlert bool `json:"showAlert"`

	// URL to be opened
	URL string `json:"url"`

	// CallbackData of the query (id of the pressed button).
	CallbackData string `json:"callbackData"`
	// contains filtered or unexported fields
}

ButtonResponse represents a data that is returned when a button is clicked

func (ButtonResponse) MarshalEasyJSON 

func (v ButtonResponse) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (ButtonResponse) MarshalJSON 

func (v ButtonResponse) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*ButtonResponse) Send 

func (cl *ButtonResponse) Send() error

Send method sends your response message. Make sure you have QueryID in your ButtonResponse.

func (*ButtonResponse) UnmarshalEasyJSON 

func (v *ButtonResponse) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*ButtonResponse) UnmarshalJSON 

func (v *ButtonResponse) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type Chat 

type Chat struct {

	// Id of the chat
	ID string `json:"chatId"`

	// Type of the chat: channel, group or private
	Type ChatType `json:"type"`

	// First name of the user
	FirstName string `json:"firstName"`

	// Last name of the user
	LastName string `json:"lastName"`

	// Nick of the user
	Nick string `json:"nick"`

	// User about or group/channel description
	About string `json:"about"`

	// Rules of the group/channel
	Rules string `json:"rules"`

	// Title of the chat
	Title string `json:"title"`

	// Flag that indicates that requested chat is the bot
	IsBot bool `json:"isBot"`

	// Is this chat public?
	Public bool `json:"public"`

	// Is this chat has join moderation?
	JoinModeration bool `json:"joinModeration"`

	// You can send this link to all your friends
	InviteLink string `json:"inviteLink"`
	// contains filtered or unexported fields
}

func (*Chat) BlockUser 

func (c *Chat) BlockUser(userID string, deleteLastMessages bool) error

Block user and remove him from chat. If deleteLastMessages is true, the messages written recently will be deleted

func (*Chat) GetAdmins 

func (c *Chat) GetAdmins() ([]ChatMember, error)

Get chat administrators list

func (*Chat) GetBlockedUsers 

func (c *Chat) GetBlockedUsers() ([]User, error)

Get chat blocked users list

func (*Chat) GetMembers 

func (c *Chat) GetMembers() ([]ChatMember, error)

Get chat members list

func (*Chat) GetPendingUsers 

func (c *Chat) GetPendingUsers() ([]User, error)

Get chat join pending users list

func (Chat) MarshalEasyJSON 

func (v Chat) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (Chat) MarshalJSON 

func (v Chat) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*Chat) ResolveAllJoinRequests 

func (c *Chat) ResolveAllJoinRequests(accept bool) error

ResolveAllJoinRequest resolve all chat join requests

func (*Chat) ResolveJoinRequest 

func (c *Chat) ResolveJoinRequest(userID string, accept bool) error

ResolveJoinRequest resolve specific user chat join request

func (*Chat) SendActions 

func (c *Chat) SendActions(actions ...ChatAction) error

Send bot actions to the chat

You can call this method every time you change the current actions, or every 10 seconds if the actions have not changed. After sending a request without active action, you should not re-notify of their absence.

func (*Chat) SetAbout 

func (c *Chat) SetAbout(about string) error

SetAbout changes chat about

func (*Chat) SetRules 

func (c *Chat) SetRules(rules string) error

SetRules changes chat rules

func (*Chat) SetTitle 

func (c *Chat) SetTitle(title string) error

SetTitle changes chat title

func (*Chat) UnblockUser 

func (c *Chat) UnblockUser(userID string) error

Unblock user in chat (but not add him back)

func (*Chat) UnmarshalEasyJSON 

func (v *Chat) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*Chat) UnmarshalJSON 

func (v *Chat) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type ChatAction 

type ChatAction = string
const (
	TypingAction  ChatAction = "typing"
	LookingAction ChatAction = "looking"
)

type ChatMember 

type ChatMember struct {
	User
	Creator bool `json:"creator"`
	Admin   bool `json:"admin"`
}

func (ChatMember) MarshalEasyJSON 

func (v ChatMember) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (ChatMember) MarshalJSON 

func (v ChatMember) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*ChatMember) UnmarshalEasyJSON 

func (v *ChatMember) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*ChatMember) UnmarshalJSON 

func (v *ChatMember) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type ChatType 

type ChatType = string
const (
	Private ChatType = "private"
	Group   ChatType = "group"
	Channel ChatType = "channel"
)

type Client 

type Client struct {
	// contains filtered or unexported fields
}

func NewClient 

func NewClient(baseURL string, token string, logger *logrus.Logger) *Client

func (*Client) BlockChatUser 

func (c *Client) BlockChatUser(chatID, userID string, deleteLastMessages bool) error

func (*Client) DeleteMessage 

func (c *Client) DeleteMessage(message *Message) error

func (*Client) Do 

func (c *Client) Do(path string, params url.Values, file FileReader) ([]byte, error)

func (*Client) EditMessage 

func (c *Client) EditMessage(message *Message) error

func (*Client) GetChatAdmins 

func (c *Client) GetChatAdmins(chatID string) ([]ChatMember, error)

func (*Client) GetChatBlockedUsers 

func (c *Client) GetChatBlockedUsers(chatID string) ([]User, error)

func (*Client) GetChatInfo 

func (c *Client) GetChatInfo(chatID string) (*Chat, error)

func (*Client) GetChatMembers 

func (c *Client) GetChatMembers(chatID string) ([]ChatMember, error)

func (*Client) GetChatPendingUsers 

func (c *Client) GetChatPendingUsers(chatID string) ([]User, error)

func (*Client) GetEvents 

func (c *Client) GetEvents(lastEventID int, pollTime int) ([]*Event, error)

func (*Client) GetFileInfo 

func (c *Client) GetFileInfo(fileID string) (*File, error)

func (*Client) GetInfo 

func (c *Client) GetInfo() (*BotInfo, error)

func (*Client) GetVoiceInfo 

func (c *Client) GetVoiceInfo(fileID string) (*File, error)

func (*Client) PinMessage 

func (c *Client) PinMessage(message *Message) error

func (*Client) ResolveChatPending 

func (c *Client) ResolveChatPending(chatID, userID string, approve, everyone bool) error

func (*Client) SendAnswerCallbackQuery 

func (c *Client) SendAnswerCallbackQuery(answer *ButtonResponse) error

func (*Client) SendChatActions 

func (c *Client) SendChatActions(chatID string, actions ...ChatAction) error

func (*Client) SendFileMessage 

func (c *Client) SendFileMessage(message *Message) error

func (*Client) SendTextMessage 

func (c *Client) SendTextMessage(message *Message) error

func (*Client) SendVoiceMessage 

func (c *Client) SendVoiceMessage(message *Message) error

func (*Client) SetChatAbout 

func (c *Client) SetChatAbout(chatID, about string) error

func (*Client) SetChatRules 

func (c *Client) SetChatRules(chatID, rules string) error

func (*Client) SetChatTitle 

func (c *Client) SetChatTitle(chatID, title string) error

func (*Client) UnblockChatUser 

func (c *Client) UnblockChatUser(chatID, userID string) error

func (*Client) UnpinMessage 

func (c *Client) UnpinMessage(message *Message) error

func (*Client) UploadFile 

func (c *Client) UploadFile(message *Message) error

func (*Client) UploadVoice 

func (c *Client) UploadVoice(message *Message) error

type Contact 

type Contact struct {
	User
	FirstName string `json:"firstName"`
	LastName  string `json:"lastName"`
}

func (Contact) MarshalEasyJSON 

func (v Contact) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (Contact) MarshalJSON 

func (v Contact) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*Contact) UnmarshalEasyJSON 

func (v *Contact) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*Contact) UnmarshalJSON 

func (v *Contact) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type Event 

type Event struct {

	// Id of the event
	EventID int `json:"eventId"`

	// Type of the event: newMessage, editedMessage, deletedMessage, pinnedMessage, unpinnedMessage, newChatMembers
	Type EventType `json:"type"`

	// Payload of the event
	Payload EventPayload `json:"payload"`
	// contains filtered or unexported fields
}

func (Event) MarshalEasyJSON 

func (v Event) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (Event) MarshalJSON 

func (v Event) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*Event) UnmarshalEasyJSON 

func (v *Event) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*Event) UnmarshalJSON 

func (v *Event) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type EventPayload 

type EventPayload struct {

	// Id of the message.
	// Presented in newMessage, editedMessage, deletedMessage, pinnedMessage, unpinnedMessage events.
	MsgID string `json:"msgId"`

	// Chat info.
	// Presented in all events.
	Chat Chat `json:"chat"`

	// Author of the message
	// Presented in newMessage and editedMessage events.
	From Contact `json:"from"`

	// Text of the message.
	// Presented in newMessage, editedMessage and pinnedMessage events.
	Text string `json:"text"`

	// Parts of the message.
	// Presented only in newMessage event.
	Parts []Part `json:"parts"`

	// Timestamp of the event.
	Timestamp int `json:"timestamp"`

	// Id of the query.
	// Presented only in callbackQuery event.
	QueryID string `json:"queryId"`

	// CallbackData of the query (id of button).
	// Presented only in callbackQuery event.
	CallbackData string `json:"callbackData"`

	LeftMembers []Contact `json:"leftMembers"`

	NewMembers []Contact `json:"newMembers"`

	AddedBy Contact `json:"addedBy"`

	RemovedBy Contact `json:"removedBy"`
	// contains filtered or unexported fields
}

func (*EventPayload) CallbackQuery 

func (ep *EventPayload) CallbackQuery() *ButtonResponse

func (EventPayload) MarshalEasyJSON 

func (v EventPayload) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (EventPayload) MarshalJSON 

func (v EventPayload) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*EventPayload) Message 

func (ep *EventPayload) Message() *Message

func (*EventPayload) UnmarshalEasyJSON 

func (v *EventPayload) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*EventPayload) UnmarshalJSON 

func (v *EventPayload) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type EventType 

type EventType string

type File 

type File struct {
	// Id of the file
	ID string `json:"fileId"`

	// Type of the file
	Type string `json:"type"`

	// Size in bytes
	Size uint64 `json:"size"`

	// Name of file
	Name bool `json:"filename"`

	// URL to the file
	URL string `json:"url"`
}

func (File) MarshalEasyJSON 

func (v File) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (File) MarshalJSON 

func (v File) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*File) UnmarshalEasyJSON 

func (v *File) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*File) UnmarshalJSON 

func (v *File) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type FileReader 

type FileReader interface {
	// Name should return filename
	Name() string

	// io.Reader interface
	io.Reader
}

FileReader is lightweight interface wrap over `os.File` or any custom data

type MembersListResponse 

type MembersListResponse struct {
	// TODO: cursor
	List []ChatMember `json:"members"`
}

func (MembersListResponse) MarshalEasyJSON 

func (v MembersListResponse) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (MembersListResponse) MarshalJSON 

func (v MembersListResponse) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*MembersListResponse) UnmarshalEasyJSON 

func (v *MembersListResponse) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*MembersListResponse) UnmarshalJSON 

func (v *MembersListResponse) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type Message 

type Message struct {
	ContentType MessageContentType

	// Id of the message (for editing)
	ID string `json:"msgId"`

	// File contains file attachment of the message
	File FileReader `json:"-"`

	// Id of file to send
	FileID string `json:"fileId"`

	// Text of the message or caption for file
	Text string `json:"text"`

	// Chat where to send the message
	Chat Chat `json:"chat"`

	// Id of replied message
	// You can't use it with ForwardMsgID or ForwardChatID
	ReplyMsgID string `json:"replyMsgId"`

	// Id of forwarded message
	// You can't use it with ReplyMsgID
	ForwardMsgID string `json:"forwardMsgId"`

	// Id of a chat from which you forward the message
	// You can't use it with ReplyMsgID
	// You should use it with ForwardMsgID
	ForwardChatID string `json:"forwardChatId"`

	Timestamp int `json:"timestamp"`

	// The markup for the inline keyboard
	InlineKeyboard [][]Button `json:"inlineKeyboardMarkup"`
	// contains filtered or unexported fields
}

Message represents a text message

func (*Message) AttachExistingFile 

func (m *Message) AttachExistingFile(fileID string)

func (*Message) AttachExistingVoice 

func (m *Message) AttachExistingVoice(fileID string)

func (*Message) AttachInlineKeyboard 

func (m *Message) AttachInlineKeyboard(keyboard [][]Button)

func (*Message) AttachNewFile 

func (m *Message) AttachNewFile(file FileReader)

func (*Message) AttachNewVoice 

func (m *Message) AttachNewVoice(file FileReader)

func (*Message) Delete 

func (m *Message) Delete() error

Delete method deletes your message. Make sure you have ID in your message.

func (*Message) Edit 

func (m *Message) Edit() error

Edit method edits your message. Make sure you have ID in your message.

func (*Message) Forward 

func (m *Message) Forward(chatID string) error

Forward method forwards your message to chat. Make sure you have ID in your message.

func (Message) MarshalEasyJSON 

func (v Message) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (Message) MarshalJSON 

func (v Message) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*Message) Pin 

func (m *Message) Pin() error

Pin message in chat Make sure you are admin in this chat

func (*Message) Reply 

func (m *Message) Reply(text string) error

Reply method replies to the message. Make sure you have ID in the message.

func (*Message) Send 

func (m *Message) Send() error

Send method sends your message. Make sure you have Text or FileID in your message.

func (*Message) UnmarshalEasyJSON 

func (v *Message) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*Message) UnmarshalJSON 

func (v *Message) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

func (*Message) Unpin 

func (m *Message) Unpin() error

Unpin message in chat Make sure you are admin in this chat

type MessageContentType 

type MessageContentType uint8
const (
	Unknown MessageContentType = iota
	Text
	OtherFile
	Voice
)

type MockHandler 

type MockHandler struct {
	http.Handler
	// contains filtered or unexported fields
}

func (*MockHandler) GetEvents 

func (h *MockHandler) GetEvents(w http.ResponseWriter)

func (*MockHandler) SendMessage 

func (h *MockHandler) SendMessage(w http.ResponseWriter)

func (*MockHandler) ServeHTTP 

func (h *MockHandler) ServeHTTP(w http.ResponseWriter, r *http.Request)

func (*MockHandler) TokenError 

func (h *MockHandler) TokenError(w http.ResponseWriter)

type Part 

type Part struct {
	// Type of the part
	Type PartType `json:"type"`

	// Payload of the part
	Payload PartPayload `json:"payload"`
}

func (Part) MarshalEasyJSON 

func (v Part) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (Part) MarshalJSON 

func (v Part) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*Part) UnmarshalEasyJSON 

func (v *Part) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*Part) UnmarshalJSON 

func (v *Part) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type PartMessage 

type PartMessage struct {
	From      Contact `json:"from"`
	MsgID     string  `json:"msgId"`
	Text      string  `json:"text"`
	Timestamp int     `json:"timestamp"`
}

func (PartMessage) MarshalEasyJSON 

func (v PartMessage) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (PartMessage) MarshalJSON 

func (v PartMessage) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*PartMessage) UnmarshalEasyJSON 

func (v *PartMessage) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*PartMessage) UnmarshalJSON 

func (v *PartMessage) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type PartPayload 

type PartPayload struct {
	FirstName   string      `json:"firstName"`
	LastName    string      `json:"lastName"`
	UserID      string      `json:"userId"`
	FileID      string      `json:"fileId"`
	Caption     string      `json:"caption"`
	Type        string      `json:"type"`
	PartMessage PartMessage `json:"message"`
	Message     PartMessage `json:"-"`
}

func (PartPayload) MarshalEasyJSON 

func (v PartPayload) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (PartPayload) MarshalJSON 

func (v PartPayload) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*PartPayload) UnmarshalEasyJSON 

func (v *PartPayload) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*PartPayload) UnmarshalJSON 

func (v *PartPayload) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type PartType 

type PartType string

type Photo 

type Photo struct {
	URL string `json:"url"`
}

func (Photo) MarshalEasyJSON 

func (v Photo) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (Photo) MarshalJSON 

func (v Photo) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*Photo) UnmarshalEasyJSON 

func (v *Photo) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*Photo) UnmarshalJSON 

func (v *Photo) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type Response 

type Response struct {
	OK          bool   `json:"ok"`
	Description string `json:"description,omitempty"`
}

func (Response) MarshalEasyJSON 

func (v Response) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (Response) MarshalJSON 

func (v Response) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*Response) UnmarshalEasyJSON 

func (v *Response) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*Response) UnmarshalJSON 

func (v *Response) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type Updater 

type Updater struct {
	PollTime int
	// contains filtered or unexported fields
}

func NewUpdater 

func NewUpdater(client *Client, pollTime int, logger *logrus.Logger) *Updater

func (*Updater) GetLastEvents 

func (u *Updater) GetLastEvents(pollTime int) ([]*Event, error)

func (*Updater) NewMessageFromPayload 

func (u *Updater) NewMessageFromPayload(message EventPayload) *Message

NewMessageFromPart returns new message based on part message

func (*Updater) RunUpdatesCheck 

func (u *Updater) RunUpdatesCheck(ctx context.Context, ch chan<- Event)

type User 

type User struct {
	ID string `json:"userId"`
}

func (User) MarshalEasyJSON 

func (v User) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (User) MarshalJSON 

func (v User) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*User) UnmarshalEasyJSON 

func (v *User) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*User) UnmarshalJSON 

func (v *User) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type UsersListResponse 

type UsersListResponse struct {
	List []User `json:"users"`
}

func (UsersListResponse) MarshalEasyJSON 

func (v UsersListResponse) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (UsersListResponse) MarshalJSON 

func (v UsersListResponse) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*UsersListResponse) UnmarshalEasyJSON 

func (v *UsersListResponse) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*UsersListResponse) UnmarshalJSON 

func (v *UsersListResponse) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.