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

oneenv

package module

Go to main page

Versions in this module

v1

v1.1.0

Jul 18, 2026

Changes in this version

+ func Example[T any](w io.Writer, opts ...Option) error

+ func FilesFor(opts ...Option) []string

+ func Redacted(v any, opts ...Option) ([]byte, error)

+ func RedactedMap(v any, opts ...Option) (map[string]string, error)

type Option

+ func WithEnvFiles() Option

+ func WithEnvVar(names ...string) Option

+ type Secret struct

+ func NewSecret[T any](v T) Secret[T]

+ func (s *Secret[T]) UnmarshalText(text []byte) error

+ func (s Secret[T]) GoString() string

+ func (s Secret[T]) MarshalJSON() ([]byte, error)

+ func (s Secret[T]) MarshalText() ([]byte, error)

+ func (s Secret[T]) String() string

+ func (s Secret[T]) Value() T

v1.0.2

Jul 18, 2026

v1.0.1

Jul 18, 2026

v1.0.0

Jul 18, 2026

Changes in this version

+ var ErrEmpty = errors.New("oneenv: variable is set but empty")

+ var ErrNotAStruct = errors.New("oneenv: target must be a non-nil pointer to struct")

+ var ErrRequired = errors.New("oneenv: required variable is not set")

+ var ErrSecretFile = errors.New("oneenv: cannot read secret file")

+ var ErrUnsupportedType = errors.New("oneenv: unsupported field type")

+ func Load(v any, opts ...Option) error

+ func LoadContext(ctx context.Context, v any, opts ...Option) error

+ func LoadEnv(filenames ...string) error

+ func Marshal(v any, opts ...Option) ([]byte, error)

+ func MarshalMap(v any, opts ...Option) (map[string]string, error)

+ func Overload(filenames ...string) error

+ func ParseContext[T any](ctx context.Context, opts ...Option) (*T, error)

+ func Parse[T any](opts ...Option) (*T, error)

+ func Read(filenames ...string) (map[string]string, error)

+ func Unmarshal(data []byte, v any, opts ...Option) error

+ func Usage[T any](w io.Writer, opts ...Option) error

+ type FieldError struct

+ Err error

+ Field string

+ Key string

+ func (e *FieldError) Error() string

+ func (e *FieldError) Unwrap() error

+ type Lookuper interface

+ Lookup func(key string) (value string, ok bool)

+ type MapLookuper map[string]string

+ func (m MapLookuper) Lookup(key string) (string, bool)

+ type Mutator func(ctx context.Context, key, value string) (string, error)

+ type OSLookuper struct

+ func (OSLookuper) Lookup(key string) (string, bool)

+ type Option func(*config)

+ func WithContext(ctx context.Context) Option

+ func WithExpand() Option

+ func WithFiles(names ...string) Option

+ func WithLookuper(l Lookuper) Option

+ func WithMutator(m Mutator) Option

+ func WithOverride() Option

+ func WithPrefix(prefix string) Option

+ func WithRequired() Option

+ func WithTagKey(key string) Option

+ func WithTypeParser[T any](fn func(string) (T, error)) Option

+ func WithValidator(fn func(v any) error) Option

+ type ParseError struct

+ File string

+ Line int

+ Msg string

+ func (e *ParseError) Error() string

+ type PrefixLookuper struct

+ Next Lookuper

+ Prefix string

+ func (p PrefixLookuper) Lookup(key string) (string, bool)