multiparser

README

multiparser

Parse raw data into concrete types unburdened by serialization standards.

Example usage

Current multiparser example uses JSON and YAML parsers.

package main

import (
    "github.com/ramizpolic/multiparser"
    "github.com/ramizpolic/multiparser/parser"
)

type object struct {
    Data string `json:"data" yaml:"data"`
}

func main() {
    parser, _ := multiparser.New(parser.JSON, parser.YAML)

    // Parse JSON
    var jsonObj object
    _ = parser.Parse([]byte(`{"data": "data"}`), &jsonObj)
	
    // Parse YAML
    var yamlObj object
    _ = parser.Parse([]byte(`data: data`), &yamlObj)
}

Supported parsers

• JSON - encoding.json
• YAML - gopkg.in/yaml.v3

Bring your own parser

All you have to do is implement multiparser.Parser interface, e.g.

type parser struct {}

// Parse converts raw to object
func (p *parser) Parse(from []byte, to interface{}) error {
    panic("implement me")
}

Documentation

Index

• Variables
• type Parser
  • func New(parsers ...Parser) (Parser, error)
• type ParserError
  • func (e *ParserError) Error() string
  • func (e *ParserError) Unwrap() error

Variables

var (
	ErrEmptyParsers  = errors.New("no Parser passed, at least one required")
	ErrInvalidObject = errors.New("object must be non-nil pointer")
)

Types

type Parser

type Parser interface {
	Parse(from []byte, to interface{}) error
}

Parser implements raw data to object deserialization.

func New

func New(parsers ...Parser) (Parser, error)

New creates a new Parser which can be used to serialize data from different formats.

type ParserError

type ParserError struct {
	Parser string
	Err    error
}

func (*ParserError) Error

func (e *ParserError) Error() string

func (*ParserError) Unwrap

func (e *ParserError) Unwrap() error