Help us shape the future of Go! Take the 2026 Go Developer Survey

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
- API
  
  Reference documentation for the pkg.go.dev API
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

basic

package

Go to main page

Versions in this module

v0

v0.3.0

Oct 10, 2026

Changes in this version

+ var ErrClosed = errSentinel("execute: executor is closed")

+ var ErrPaused = errSentinel("execute: executor is paused")

+ var ErrQueueFull = errSentinel("execute: queue is full")

+ var ErrStaleCollector = errSentinel("execute: collector is stale")

+ type Context = context.Context

+ type DropEvent struct

+ At time.Time

+ PendingItems int

+ Reason string

+ type Duration = time.Duration

+ type ErrorRecord struct

+ At time.Time

+ Err string

+ Items int

+ Panicked bool

+ type ExecuteEvent struct

+ Duration Duration

+ Err error

+ Items int

+ Panicked bool

+ Time time.Time

+ func (e ExecuteEvent) OK() bool

+ type Executor interface

+ Close func()

+ Collect func(item ITEM) error

+ Flush func() error

+ Pause func()

+ Resume func()

+ Start func()

+ Stats func() Stats

+ Status func() Status

+ TryCollect func(item ITEM) error

+ Wait func(ctx Context) error

+ type Handler func(items []ITEM) error

+ type Semaphore struct

+ func NewSemaphore(n int) *Semaphore

+ func (s *Semaphore) Acquire(ctx context.Context) (bool, error)

+ func (s *Semaphore) AcquireWait() bool

+ func (s *Semaphore) Available() int

+ func (s *Semaphore) Cap() int

+ func (s *Semaphore) InUse() int

+ func (s *Semaphore) Limit() int

+ func (s *Semaphore) Release()

+ func (s *Semaphore) Resize(n int) int

+ func (s *Semaphore) TryAcquire() bool

+ type Stats struct

+ DroppedItems uint64

+ Executions uint64

+ FailedExecutions uint64

+ FailedItems uint64

+ InFlight int64

+ LastError string

+ LastErrorAt time.Time

+ PendingItems int

+ ProcessedItems uint64

+ ReceivedItems uint64

+ RecentErrors []ErrorRecord

+ SucceededItems uint64

+ func (s Stats) ErrorRate() float64

+ type Status int32

+ const StatusClosing

+ const StatusCreated

+ const StatusPaused

+ const StatusRunning

+ const StatusStopped

+ func (s Status) Runnable() bool

+ func (s Status) String() string

+ func (s Status) Terminal() bool

+ type Time = time.Time

v0.2.2

Aug 4, 2023

v0.2.1

Aug 4, 2023

v0.2.0

Aug 4, 2023

v0.1.1

Aug 1, 2023

v0.1.0

Aug 1, 2023

v0.0.4

Aug 1, 2023

Changes in this version

+ type RecoverFunc struct

+ RecoverDo func(ierr any)

+ func (rf *RecoverFunc) SetRecover(rdo func(ierr any))