safe

README

safe

safe provides a concurrency-safe safe.Buffer io.Writer for use in unit testing, without setting off Go's race detector.

DevContainer

[!CAUTION]

Do not use VSCode's "Dev Containers: Clone Repository in Container Volume" command, as it is utterly broken by design, ignoring .devcontainer/devcontainer.json.

1. git clone https://github.com/thediveo/safe
2. in VSCode: Ctrl+Shift+P, "Dev Containers: Open Workspace in Container..."
3. select safe.code-workspace and off you go...

Supported Go Versions

safe supports versions of Go that are noted by the Go release policy, that is, major versions N and N-1 (where N is the current major version).

Contributing

Please see CONTRIBUTING.md.

Copyright and License

safe is Copyright 2024, 2026 Harald Albrecht, and licensed under the Apache License, Version 2.0.

Documentation

Overview

Package safe provides a concurrency-safe buffer io.Writer.

Index

• type Buffer
  • func (b *Buffer) String() string
  • func (b *Buffer) Write(p []byte) (n int, err error)

Types

type Buffer

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

Buffer is the concurrency-safe variant of bytes.Buffer.

func (*Buffer) String

func (b *Buffer) String() string

String returns the current contents of the buffer.

func (*Buffer) Write

func (b *Buffer) Write(p []byte) (n int, err error)

Write the contents specified in p to the buffer, returning the amount of bytes written.