keysetpagination

Documentation

Index

• func Header(w http.ResponseWriter, u *url.URL, p *Paginator)
• func Paginate[I Item](p *Paginator) pop.ScopeFunc
• type Item
• type Option
  • func Parse(q *url.Values) ([]Option, error)
  • func WithDefaultSize(size int) Option
  • func WithDefaultToken(t string) Option
  • func WithMaxSize(size int) Option
  • func WithSize(size int) Option
  • func WithToken(t string) Option
• type Paginator
  • func GetPaginator(modifiers ...Option) *Paginator
  • func Result[I Item](items []I, p *Paginator) ([]I, *Paginator)
  • func (p *Paginator) IsLast() bool
  • func (p *Paginator) Size() int
  • func (p *Paginator) ToOptions() []Option
  • func (p *Paginator) Token() string
• type RequestParameters
• type ResponseHeaders

Functions

func Header

func Header(w http.ResponseWriter, u *url.URL, p *Paginator)

Header adds the Link header for the page encoded by the paginator. It contains links to the first and next page, if one exists.

func Paginate

func Paginate[I Item](p *Paginator) pop.ScopeFunc

Paginate returns a function that paginates a pop.Query. Usage:

q := c.Where("foo = ?", foo).Scope(keysetpagination.Paginate[Item](paginator))

Types

type Item

type Item interface{ PageToken() string }

type Option

type Option func(*Paginator) *Paginator

func Parse

func Parse(q *url.Values) ([]Option, error)

Parse returns the pagination options from the URL query.

func WithDefaultSize

func WithDefaultSize(size int) Option

func WithDefaultToken

func WithDefaultToken(t string) Option

func WithMaxSize

func WithMaxSize(size int) Option

func WithSize

func WithSize(size int) Option

func WithToken

func WithToken(t string) Option

type Paginator

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

func GetPaginator

func GetPaginator(modifiers ...Option) *Paginator

func Result

func Result[I Item](items []I, p *Paginator) ([]I, *Paginator)

Result removes the last item (if applicable) and returns the paginator for the next page.

func (*Paginator) IsLast

func (p *Paginator) IsLast() bool

func (*Paginator) Size

func (p *Paginator) Size() int

func (*Paginator) ToOptions

func (p *Paginator) ToOptions() []Option

func (*Paginator) Token

func (p *Paginator) Token() string

type RequestParameters

type RequestParameters struct {
	// Items per Page
	//
	// This is the number of items per page to return.
	// For details on pagination please head over to the [pagination documentation](https://www.ory.sh/docs/ecosystem/api-design#pagination).
	//
	// required: false
	// in: query
	// default: 250
	// min: 1
	// max: 1000
	PageSize int `json:"page_size"`

	// Next Page Token
	//
	// The next page token.
	// For details on pagination please head over to the [pagination documentation](https://www.ory.sh/docs/ecosystem/api-design#pagination).
	//
	// required: false
	// in: query
	PageToken string `json:"page_token"`
}

Pagination Request Parameters

The `Link` HTTP header contains multiple links (`first`, `next`) formatted as: `<https://{project-slug}.projects.oryapis.com/admin/sessions?page_size=250&page_token=>; rel="first"`

For details on pagination please head over to the [pagination documentation](https://www.ory.sh/docs/ecosystem/api-design#pagination).

swagger:model keysetPaginationRequestParameters

type ResponseHeaders

type ResponseHeaders struct {
	// The Link HTTP Header
	//
	// The `Link` header contains a comma-delimited list of links to the following pages:
	//
	// - first: The first page of results.
	// - next: The next page of results.
	//
	// Pages are omitted if they do not exist. For example, if there is no next page, the `next` link is omitted. Examples:
	//
	//	</admin/sessions?page_size=250&page_token={last_item_uuid}; rel="first",/admin/sessions?page_size=250&page_token=>; rel="next"
	//
	Link string `json:"link"`

	// The X-Total-Count HTTP Header
	//
	// The `X-Total-Count` header contains the total number of items in the collection.
	TotalCount int `json:"x-total-count"`
}

Pagination Response Header

The `Link` HTTP header contains multiple links (`first`, `next`) formatted as: `<https://{project-slug}.projects.oryapis.com/admin/sessions?page_size=250&page_token=>; rel="first"`

For details on pagination please head over to the [pagination documentation](https://www.ory.sh/docs/ecosystem/api-design#pagination).

swagger:model keysetPaginationResponseHeaders