Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

api

package

Go to main page

Versions in this module

v0

v0.7.0

Jul 10, 2025

Changes in this version

+ const DefaultPageNumber

+ const DefaultPageSize

+ const DefaultSortDesc

type Page

+ func NewEmptyPage[T any]() Page[T]

type PageParams

+ func NewPageParams(idColumn string, opts ...PageOpt) (PageParams, error)

v0.6.1

Jun 24, 2025

v0.6.0

Jun 11, 2025

Changes in this version

+ var ErrInvalidPageSize = errors.New("invalid page size")

+ type CRUD interface

+ Create func(ctx context.Context, e *T) (sql.Result, error)

+ Delete func(ctx context.Context, id I) (sql.Result, error)

+ DeleteAll func(ctx context.Context) (sql.Result, error)

+ GetAll func(ctx context.Context) ([]T, error)

+ GetByID func(ctx context.Context, id I) (T, error)

+ GetByIDs func(ctx context.Context, ids []I) ([]T, error)

+ Update func(ctx context.Context, id I, e *T) (sql.Result, error)

+ type DebugFunc func(sql string, args ...any)

+ type Page struct

+ Content []T

+ Number uint

+ Size uint

+ Total uint64

+ TotalPages uint

+ type PageOpt func(*PageParams)

+ func WithPageNumber(number uint) PageOpt

+ func WithPageSize(size uint) PageOpt

+ func WithSortBy(column string) PageOpt

+ func WithSortDesc(column string) PageOpt

+ type PageParams struct

+ PageNumber uint

+ PageSize uint

+ SortBy []string

+ SortDesc bool

+ func (p PageParams) Validate() error

+ type PageResolver interface

+ Count func(ctx context.Context) (uint64, error)

+ GetPage func(ctx context.Context, opts ...PageOpt) (Page[T], error)

+ type SQLExecutor interface

+ BeginTx func(ctx context.Context, opts *sql.TxOptions) (*sql.Tx, error)

+ Exec func(ctx context.Context, query string, args ...any) (sql.Result, error)

+ SelectMany func(ctx context.Context, dest any, query string, args ...any) error

+ SelectOne func(ctx context.Context, dest any, query string, args ...any) error