validator

func DetectFormat ¶

func DetectFormat(data []byte) Format

DetectFormat attempts to detect the data format by analyzing the content. Uses simple heuristics to identify various data formats.

Detection rules:

• JSON: Starts with '{' or '['
• XML: Starts with '<?xml' or '<'
• YAML: Contains '---' or has key:value pattern
• TOML: Contains '[section]' pattern with key=value pairs
• CSV: Has comma-separated values with consistent columns
• GraphQL: Contains query/mutation/type/schema keywords
• INI: Has [section] headers or key=value pairs
• Dockerfile: Starts with FROM instruction
• Markdown: Contains markdown syntax like #, *, -, ```
• Requirements.txt: Contains package names with version specifiers

Returns FormatUnknown if the format cannot be determined.

func DetectFormatFromFilename ¶

func DetectFormatFromFilename(filename string) Format

DetectFormatFromFilename attempts to detect format from filename extension.

Supported extensions:

• .json → FormatJSON
• .yaml, .yml → FormatYAML
• .xml → FormatXML
• .toml → FormatTOML

Example:

format := DetectFormatFromFilename("config.json")
// format == FormatJSON

Returns FormatUnknown if the extension is not recognized.

func DetectFormatParallel ¶ added in v0.2.1

func DetectFormatParallel(data []byte) Format

DetectFormatParallel attempts to detect the data format using parallel detection. Uses GOMAXPROCS goroutines to check different format families concurrently. This is mainly useful for educational purposes as the overhead usually exceeds benefits.

func ValidateAuto ¶

func ValidateAuto(data []byte) Result

ValidateAuto validates data with automatic format detection. It first attempts to detect the format, then validates using the appropriate validator.

Example:

data := []byte(`{"name": "test"}`)
result := ValidateAuto(data)
fmt.Printf("Format: %s, Valid: %v\n", result.Format, result.Valid)
// Output: Format: json, Valid: true

Returns a Result with Format=FormatUnknown if the format cannot be detected.

func NewValidator ¶

func NewValidator(format Format) (Validator, error)

NewValidator creates a new validator for the specified format.

Example:

validator, err := NewValidator(FormatJSON)
if err != nil {
	log.Fatal(err)
}
result := validator.ValidateString(`{"key": "value"}`)
if result.Valid {
	fmt.Println("Valid JSON!")
}

Supported formats: FormatJSON, FormatYAML, FormatXML, FormatTOML, FormatCSV, FormatGraphQL, FormatINI, FormatHCL, FormatProtobuf, FormatMarkdown, FormatJSONL, FormatJupyter, FormatRequirements, FormatDockerfile Returns an error if an unsupported format is specified.