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

common

package

Go to main page

Versions in this module

v0

v0.1.5

Aug 29, 2026

v0.1.4

Aug 29, 2026

v0.1.3

Aug 28, 2026

v0.1.2

Aug 28, 2026

v0.1.1

Aug 26, 2026

Changes in this version

+ const LaunchAgentCodexExecutableEnvironment

+ const LaunchAgentControlExecutable

+ const LaunchAgentLabel

+ const LaunchAgentPathEnvironment

+ const LaunchAgentPiExecutableEnvironment

+ const LaunchAgentProviderCodex

+ const LaunchAgentProviderPi

+ const MaxProcessLaunchAggregateBytes

+ const MaxProcessLaunchItems

+ var ErrIDCollision = errors.New("resource id collision")

+ var ErrLaunchAgentInstalledNotRunning = errors.New(installedNotRunningGuidance)

+ var ErrLaunchAgentNotInstalled = errors.New(notInstalledGuidance)

+ var ErrLaunchAgentNotLoaded = errors.New("LaunchAgent is not loaded")

+ var ErrLaunchAgentUnsupported = errors.New(LaunchAgentForegroundGuidance)

+ var ErrProcessOutputOverflow = errors.New("process output unread backlog exceeded") — darwin/amd64, linux/amd64

+ var ErrUnsupportedRaster = errors.New("unsupported raster image")

+ var LaunchAgentForegroundGuidance = unsupportedGuidance(runtime.GOOS)

+ func GenerateLaunchAgentPlist(config LaunchAgentConfig, home string) ([]byte, error)

+ func HasCode(err error, code ErrorCode) bool

+ func IsExpired(now time.Time, expiresAt *time.Time) bool

+ func IsNil(value any) bool

+ func ResolveCreateExpiration(now time.Time, defaultSeconds int64, supplied *int64) (*time.Time, error)

+ func ResolveUpdateExpiration(now time.Time, current *time.Time, supplied *int64) (*time.Time, error)

+ func SupportedRasterMediaType(mediaType string) bool

+ func ValidPageURL(value string) bool

+ func ValidateID(id string) error

+ type Clock interface

+ Now func() time.Time

+ type CryptoIDGenerator struct

+ func (CryptoIDGenerator) NewID() (string, error)

+ type Error struct

+ Code ErrorCode

+ Err error

+ Message string

+ func NewError(code ErrorCode, message string, cause error) *Error

+ func (e *Error) Error() string

+ func (e *Error) Unwrap() error

+ type ErrorCode string

+ const CodeContentTooLarge

+ const CodeInternal

+ const CodeInvalidRequest

+ const CodeNotFound

+ const CodeStorageUnavailable

+ const CodeUnsupportedMediaType

+ type IDGenerator interface

+ NewID func() (string, error)

+ type LaunchAgentCommitUncertainError struct — darwin/amd64

+ Err error

+ func (err *LaunchAgentCommitUncertainError) Error() string

+ func (err *LaunchAgentCommitUncertainError) Unwrap() error

+ type LaunchAgentConfig struct

+ ConfigPath string

+ EnvironmentPath string

+ Executable string

+ ExecutableResolver LaunchAgentExecutableResolver

+ Providers []LaunchAgentProviderDescriptor

+ type LaunchAgentExecRunner struct

+ func (LaunchAgentExecRunner) Run(ctx context.Context, command string, args ...string) ([]byte, error)

+ type LaunchAgentExecutableResolver interface

+ LookPath func(string) (string, error)

+ type LaunchAgentManager interface

+ Install func(context.Context, LaunchAgentConfig) error

+ Restart func(context.Context) error

+ Status func(context.Context) (LaunchAgentStatus, error)

+ Stop func(context.Context) error

+ Uninstall func(context.Context) error

+ func NewLaunchAgentManager(LaunchAgentRunner) (LaunchAgentManager, error)

+ func NewLaunchAgentManager(runner LaunchAgentRunner) (LaunchAgentManager, error)

+ type LaunchAgentProviderDescriptor interface

+ ExecutableName func() string

+ ProviderName func() string

+ type LaunchAgentRunner interface

+ Run func(context.Context, string, ...string) ([]byte, error)

+ type LaunchAgentStatus struct

+ Installed bool

+ Loaded bool

+ PID int

+ Running bool

+ type ManagedProcess interface

+ Errors func() io.Reader

+ Input func() io.WriteCloser

+ Kill func() error

+ Output func() io.Reader

+ Terminate func() error

+ Wait func() error

+ type ProcessError struct

+ Err error

+ Kind ProcessErrorKind

+ Op string

+ func (e *ProcessError) Error() string

+ func (e *ProcessError) Unwrap() error

+ type ProcessErrorKind string

+ const ProcessErrorCanceled

+ const ProcessErrorExecutable

+ const ProcessErrorInvalidRequest

+ const ProcessErrorSignal

+ const ProcessErrorStart

+ const ProcessErrorUnsafeProcessGroup

+ const ProcessErrorUnsupported

+ const ProcessErrorWorkingDirectory

+ type ProcessGroupLauncher struct

+ func NewProcessGroupLauncher() *ProcessGroupLauncher

+ func (*ProcessGroupLauncher) Launch(context.Context, ProcessRequest) (ManagedProcess, error)

+ func (*ProcessGroupLauncher) Launch(ctx context.Context, request ProcessRequest) (ManagedProcess, error)

+ type ProcessLauncher interface

+ Launch func(context.Context, ProcessRequest) (ManagedProcess, error)

+ type ProcessRequest struct

+ Arguments []string

+ Environment []string

+ Executable string

+ WorkingDirectory string

+ func (r ProcessRequest) Validate() error

+ type RasterFormat struct

+ Extension string

+ MediaType string

+ func DetectRaster(content []byte) (RasterFormat, error)

+ type SystemClock struct

+ func (SystemClock) Now() time.Time