Documentation
¶
Overview ¶
Package document provides structured document I/O for YAML and JSON files. It encapsulates the read-deserialize and serialize-write patterns used throughout the codebase, with consistent error wrapping, permission modes, directory creation, and format detection.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Read ¶
Read deserializes a structured document from a reader. YAML decoding is used unconditionally since JSON is a valid subset of YAML.
Type Parameters:
- T: the target type for deserialization
Parameters:
- r: the reader to read from
Returns:
- *T: pointer to the deserialized value
- error: wraps read and parse errors
func ReadFile ¶
ReadFile deserializes a structured document from disk. Format is inferred from the file extension: .json → JSON, .yaml/.yml/anything else → YAML.
Type Parameters:
- T: the target type for deserialization
Parameters:
- path: filesystem path to the document
Returns:
- *T: pointer to the deserialized value
- error: wraps both I/O and parse errors with the file path for context
func Write ¶
Write serializes v to disk as a structured document. Format is inferred from the file extension. Creates parent directories (0o750) if needed. Default file permission is 0o600; override with WithPerm.
Parameters:
- path: filesystem path for the output document
- v: value to serialize
- opts: optional configuration (WithPerm, WithIndent, WithHeader)
Returns:
- error: wraps marshal, directory creation, and write errors with the file path for context
Types ¶
type Option ¶
type Option func(*writeOpts)
Option configures Write behavior.
func WithHeader ¶
WithHeader prepends a literal string before the serialized content. A trailing newline is appended if not present.
Parameters:
- header: text to prepend (e.g., a generated-file comment or disclaimer)
Returns:
- Option: a write option that sets the header
func WithIndent ¶
WithIndent controls JSON indentation. Ignored for YAML. Default is 2-space indent with no prefix.
Parameters:
- prefix: prefix string prepended to each line (typically empty)
- indent: indent string used for each level of nesting
Returns:
- Option: a write option that sets JSON indentation
Source Files