featured

Documentation

Overview

Package featured contains featured stickers iteration helper.

Index

• type Elem
• type GetOldFeaturedStickersQueryBuilder
  • func (b *GetOldFeaturedStickersQueryBuilder) BatchSize(batchSize int) *GetOldFeaturedStickersQueryBuilder
  • func (b *GetOldFeaturedStickersQueryBuilder) Collect(ctx context.Context) ([]Elem, error)
  • func (b *GetOldFeaturedStickersQueryBuilder) Count(ctx context.Context) (int, error)
  • func (b *GetOldFeaturedStickersQueryBuilder) ForEach(ctx context.Context, cb func(context.Context, Elem) error) error
  • func (b *GetOldFeaturedStickersQueryBuilder) Iter() *Iterator
  • func (b *GetOldFeaturedStickersQueryBuilder) Query(ctx context.Context, req Request) (tg.MessagesFeaturedStickersClass, error)
• type Iterator
  • func NewIterator(query Query, limit int) *Iterator
  • func (m *Iterator) Err() error
  • func (m *Iterator) FetchTotal(ctx context.Context) (int, error)
  • func (m *Iterator) Next(ctx context.Context) bool
  • func (m *Iterator) Offset(offset int) *Iterator
  • func (m *Iterator) Total(ctx context.Context) (int, error)
  • func (m *Iterator) Value() Elem
• type Query
• type QueryBuilder
  • func NewQueryBuilder(raw *tg.Client) *QueryBuilder
  • func (q *QueryBuilder) GetOldFeaturedStickers() *GetOldFeaturedStickersQueryBuilder
• type QueryFunc
  • func (q QueryFunc) Query(ctx context.Context, req Request) (tg.MessagesFeaturedStickersClass, error)
• type Request

Types

type Elem

type Elem struct {
	Sticker tg.StickerSetCoveredClass
	// IDs of new featured stickersets
	Unread []int64
}

Elem is a sticker iterator element.

type GetOldFeaturedStickersQueryBuilder

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

GetOldFeaturedStickersQueryBuilder is query builder of MessagesGetOldFeaturedStickers.

func (*GetOldFeaturedStickersQueryBuilder) BatchSize

func (b *GetOldFeaturedStickersQueryBuilder) BatchSize(batchSize int) *GetOldFeaturedStickersQueryBuilder

BatchSize sets buffer of message loaded from one request. Be carefully, when set this limit, because Telegram does not return error if limit is too big, so results can be incorrect.

func (*GetOldFeaturedStickersQueryBuilder) Collect

func (b *GetOldFeaturedStickersQueryBuilder) Collect(ctx context.Context) ([]Elem, error)

Collect creates iterator and collects all elements to slice.

func (*GetOldFeaturedStickersQueryBuilder) Count

func (b *GetOldFeaturedStickersQueryBuilder) Count(ctx context.Context) (int, error)

Count fetches remote state to get number of elements.

func (*GetOldFeaturedStickersQueryBuilder) ForEach

func (b *GetOldFeaturedStickersQueryBuilder) ForEach(ctx context.Context, cb func(context.Context, Elem) error) error

ForEach calls given callback on each iterator element.

func (*GetOldFeaturedStickersQueryBuilder) Iter

func (b *GetOldFeaturedStickersQueryBuilder) Iter() *Iterator

Iter returns iterator using built query.

func (*GetOldFeaturedStickersQueryBuilder) Query

func (b *GetOldFeaturedStickersQueryBuilder) Query(ctx context.Context, req Request) (tg.MessagesFeaturedStickersClass, error)

Query implements Query interface.

type Iterator

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

Iterator is a featured stickers stream iterator.

func NewIterator

func NewIterator(query Query, limit int) *Iterator

NewIterator creates new iterator.

func (*Iterator) Err

func (m *Iterator) Err() error

Err returns the error, if any, that was encountered during iteration.

func (*Iterator) FetchTotal

func (m *Iterator) FetchTotal(ctx context.Context) (int, error)

FetchTotal fetches and returns count of elements.

func (*Iterator) Next

func (m *Iterator) Next(ctx context.Context) bool

Next prepares the next message for reading with the Value method. It returns true on success, or false if there is no next message or an error happened while preparing it. Err should be consulted to distinguish between the two cases.

func (*Iterator) Offset

func (m *Iterator) Offset(offset int) *Iterator

Offset sets Offset request parameter.

func (*Iterator) Total

func (m *Iterator) Total(ctx context.Context) (int, error)

Total returns last fetched count of elements. If count was not fetched before, it requests server using FetchTotal.

func (*Iterator) Value

func (m *Iterator) Value() Elem

Value returns current message.

type Query

type Query interface {
	Query(ctx context.Context, req Request) (tg.MessagesFeaturedStickersClass, error)
}

Query is an abstraction for featured request. NB: iterator mutates returned data (sorts, at least).

type QueryBuilder

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

QueryBuilder is a helper to create message queries.

func NewQueryBuilder

func NewQueryBuilder(raw *tg.Client) *QueryBuilder

NewQueryBuilder creates new QueryBuilder.

func (*QueryBuilder) GetOldFeaturedStickers

func (q *QueryBuilder) GetOldFeaturedStickers() *GetOldFeaturedStickersQueryBuilder

GetOldFeaturedStickers creates query builder of MessagesGetOldFeaturedStickers.

type QueryFunc

type QueryFunc func(ctx context.Context, req Request) (tg.MessagesFeaturedStickersClass, error)

QueryFunc is a function adapter for Query.

func (QueryFunc) Query

func (q QueryFunc) Query(ctx context.Context, req Request) (tg.MessagesFeaturedStickersClass, error)

Query implements Query interface.

type Request

type Request struct {
	Offset int
	Limit  int
}

Request is a parameter for Query.