Error handling. Vendoring

Signed-off-by: Ettore Dreucci <ettore.dreucci@gmail.com>

vendor/gopkg.in/tucnak/telebot.v2/options.go

@@ -0,0 +1,146 @@
+package telebot
+
+// Option is a shorcut flag type for certain message features
+// (so-called options). It means that instead of passing
+// fully-fledged SendOptions* to Send(), you can use these
+// flags instead.
+//
+// Supported options are defined as iota-constants.
+type Option int
+
+const (
+	// NoPreview = SendOptions.DisableWebPagePreview
+	NoPreview Option = iota
+
+	// Silent = SendOptions.DisableNotification
+	Silent
+
+	// ForceReply = ReplyMarkup.ForceReply
+	ForceReply
+
+	// OneTimeKeyboard = ReplyMarkup.OneTimeKeyboard
+	OneTimeKeyboard
+)
+
+// SendOptions has most complete control over in what way the message
+// must be sent, providing an API-complete set of custom properties
+// and options.
+//
+// Despite its power, SendOptions is rather inconvenient to use all
+// the way through bot logic, so you might want to consider storing
+// and re-using it somewhere or be using Option flags instead.
+type SendOptions struct {
+	// If the message is a reply, original message.
+	ReplyTo *Message
+
+	// See ReplyMarkup struct definition.
+	ReplyMarkup *ReplyMarkup
+
+	// For text messages, disables previews for links in this message.
+	DisableWebPagePreview bool
+
+	// Sends the message silently. iOS users will not receive a notification, Android users will receive a notification with no sound.
+	DisableNotification bool
+
+	// ParseMode controls how client apps render your message.
+	ParseMode ParseMode
+}
+
+func (og *SendOptions) copy() *SendOptions {
+	cp := *og
+	if cp.ReplyMarkup != nil {
+		cp.ReplyMarkup = cp.ReplyMarkup.copy()
+	}
+
+	return &cp
+}
+
+// ReplyMarkup controls two convenient options for bot-user communications
+// such as reply keyboard and inline "keyboard" (a grid of buttons as a part
+// of the message).
+type ReplyMarkup struct {
+	// InlineKeyboard is a grid of InlineButtons displayed in the message.
+	//
+	// Note: DO NOT confuse with ReplyKeyboard and other keyboard properties!
+	InlineKeyboard [][]InlineButton `json:"inline_keyboard,omitempty"`
+
+	// ReplyKeyboard is a grid, consisting of keyboard buttons.
+	//
+	// Note: you don't need to set HideCustomKeyboard field to show custom keyboard.
+	ReplyKeyboard [][]ReplyButton `json:"keyboard,omitempty"`
+
+	// ForceReply forces Telegram clients to display
+	// a reply interface to the user (act as if the user
+	// has selected the bot‘s message and tapped "Reply").
+	ForceReply bool `json:"force_reply,omitempty"`
+
+	// Requests clients to resize the keyboard vertically for optimal fit
+	// (e.g. make the keyboard smaller if there are just two rows of buttons).
+	//
+	// Defaults to false, in which case the custom keyboard is always of the
+	// same height as the app's standard keyboard.
+	ResizeReplyKeyboard bool `json:"resize_keyboard,omitempty"`
+
+	// Requests clients to hide the reply keyboard as soon as it's been used.
+	//
+	// Defaults to false.
+	OneTimeKeyboard bool `json:"one_time_keyboard,omitempty"`
+
+	// Requests clients to remove the reply keyboard.
+	//
+	// Dafaults to false.
+	ReplyKeyboardRemove bool `json:"remove_keyboard,omitempty"`
+
+	// Use this param if you want to force reply from
+	// specific users only.
+	//
+	// Targets:
+	// 1) Users that are @mentioned in the text of the Message object;
+	// 2) If the bot's message is a reply (has SendOptions.ReplyTo),
+	//       sender of the original message.
+	Selective bool `json:"selective,omitempty"`
+}
+
+func (og *ReplyMarkup) copy() *ReplyMarkup {
+	cp := *og
+
+	cp.ReplyKeyboard = make([][]ReplyButton, len(og.ReplyKeyboard))
+	for i, row := range og.ReplyKeyboard {
+		cp.ReplyKeyboard[i] = make([]ReplyButton, len(row))
+		for j, btn := range row {
+			cp.ReplyKeyboard[i][j] = btn
+		}
+	}
+
+	cp.InlineKeyboard = make([][]InlineButton, len(og.InlineKeyboard))
+	for i, row := range og.InlineKeyboard {
+		cp.InlineKeyboard[i] = make([]InlineButton, len(row))
+		for j, btn := range row {
+			cp.InlineKeyboard[i][j] = btn
+		}
+	}
+
+	return &cp
+}
+
+// ReplyButton represents a button displayed in reply-keyboard.
+//
+// Set either Contact or Location to true in order to request
+// sensitive info, such as user's phone number or current location.
+// (Available in private chats only.)
+type ReplyButton struct {
+	Text string `json:"text"`
+
+	Contact  bool `json:"request_contact,omitempty"`
+	Location bool `json:"request_location,omitempty"`
+
+	Action func(*Callback) `json:"-"`
+}
+
+// InlineKeyboardMarkup represents an inline keyboard that appears
+// right next to the message it belongs to.
+type InlineKeyboardMarkup struct {
+	// Array of button rows, each represented by
+	// an Array of KeyboardButton objects.
+	InlineKeyboard [][]InlineButton `json:"inline_keyboard,omitempty"`
+}