docs

package
v0.1.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 4, 2026 License: MIT Imports: 7 Imported by: 0

Documentation

Index

Constants

View Source
const (
	FormatMarkdown = "markdown"
	FormatYAML     = "yaml"
)

Define output format types

Variables

This section is empty.

Functions

func GenerateMarkdown

func GenerateMarkdown(writer io.Writer, appInfo AppInfo) error

GenerateMarkdown is a convenience function to generate markdown documentation directly

func GenerateYAML

func GenerateYAML(writer io.Writer) error

GenerateYAML is a convenience function to generate YAML configuration template directly

Types

type AppInfo

type AppInfo struct {
	BinaryName  string
	EnvPrefix   string
	ConfigPaths struct {
		DefaultPath     string
		DefaultFullName string
	}
}

AppInfo contains information about the application needed for documentation generation

type Config

type Config struct {
	OutputFormat string
	OutputFile   string
	Writer       io.Writer
	Registry     RegistryFunc
}

Config holds all configuration for document generation

type Generator

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

Generator handles document generation based on configuration

func NewGenerator

func NewGenerator(cfg Config) *Generator

NewGenerator creates a new document generator with the given configuration

func (*Generator) Generate

func (g *Generator) Generate() error

Generate produces documentation in the configured format

func (*Generator) GenerateMarkdownDocs

func (g *Generator) GenerateMarkdownDocs(w io.Writer, appInfo AppInfo) error

GenerateMarkdownDocs generates Markdown documentation for all configuration options

func (*Generator) GenerateYAMLDocs

func (g *Generator) GenerateYAMLDocs(w io.Writer) error

GenerateYAMLDocs generates a YAML configuration template

func (*Generator) SetAppInfo

func (g *Generator) SetAppInfo(info AppInfo)

SetAppInfo sets the application information used for documentation

type RegistryFunc

type RegistryFunc func() []config.ConfigOption

RegistryFunc defines a function that returns a configuration registry This is primarily used for testing to mock the registry

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL