rawconv

package module
v0.4.1 Latest Latest
Warning

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

 Go to latest Published: Sep 26, 2023 License: BSD-3-Clause Imports: 6 Imported by: 2

README

rawconv

Latest release Build status Go Report Card Documentation

Package rawconv implements conversions to and from raw string representations of any (custom) data types in Go.

go get github.com/go-pogo/rawconv

import "github.com/go-pogo/rawconv"

Basic conversions

Basic conversions are done using the strconv package and are implemented as methods on the Value type. The following conversions are supported:

  • string
  • bool
  • int, int8, int16, int32, int64
  • uint, uint8, uint16, uint32, uint64
  • float32, float64
  • complex64, complex128
  • time.Duration
  • url.URL

Custom types

Conversions for global custom types are done by registering a MarshalFunc and/or UnmarshalFunc using the RegisterMarshalFunc and RegisterUnmarshalFunc functions. It is also possible to use Marshaler and/or Unmarshaler if you do not want to expose the MarshalFunc or UnmarshalFunc implementations.

Documentation

Additional detailed documentation is available at pkg.go.dev

Created with

License

Copyright © 2022-2023 Roel Schut. All rights reserved.

This project is governed by a BSD-style license that can be found in the LICENSE file.

Documentation

Overview

Package rawconv implements conversions to and from raw string representations of any (custom) data type in Go.

Basic conversions

Basic conversions are done using the strconv package and are implemented as methods on the Value type. The following conversions are supported: - string - bool - int, int8, int16, int32, int64 - uint, uint8, uint16, uint32, uint64 - float32, float64 - complex64, complex128 - time.Duration - url.URL

Custom types

Conversions for global custom types are done by registering a MarshalFunc and/or UnmarshalFunc using the RegisterMarshalFunc and RegisterUnmarshalFunc functions. It is also possible to use Marshaler and/or Unmarshaler if you do not want to expose the MarshalFunc or UnmarshalFunc implementations.

Index

Examples

Constants

View Source 
const (
	ErrPointerExpected errors.Msg = "expected a non-nil pointer to a value"
	ErrUnableToSet     errors.Msg = "unable to set value"
	ErrUnableToAddr    errors.Msg = "unable to addr value"

	// ImplementationError indicates the programmer made a mistake implementing
	// the package and this should be fixed.
	ImplementationError errors.Kind = "implementation error"
)
View Source 
const (
	ParseError      errors.Kind = "parse error"
	ValidationError errors.Kind = "validation error"
)

Variables

This section is empty.

Functions

func RegisterMarshalFunc 

func RegisterMarshalFunc(typ reflect.Type, fn MarshalFunc)

RegisterMarshalFunc registers the MarshalFunc for typ, making it globally available for Marshal, MarshalValue, MarshalReflect and any Marshaler.

func RegisterUnmarshalFunc 

func RegisterUnmarshalFunc(typ reflect.Type, fn UnmarshalFunc)

RegisterUnmarshalFunc registers the UnmarshalFunc for typ, making it globally available for Unmarshal and any Unmarshaler.

func Unmarshal 

func Unmarshal(val Value, v any) error

Unmarshal parses Value and stores the result in the value pointed to by v. If v is nil or not a pointer, Unmarshal returns an ErrPointerExpected error. If v is not a supported type an UnsupportedTypeError is returned. By default, the following types are supported: - encoding.TextUnmarshaler - time.Duration - url.URL - string - bool - int, int8, int16, int32, int64 - uint, uint8, uint16, uint32, uint64 - float32, float64 - complex64, complex128 Use RegisterUnmarshalFunc to add additional (custom) types.

Example 
var duration time.Duration
if err := Unmarshal("1h2m3s", &duration); err != nil {
	panic(err)
}

fmt.Println(duration)

Output:

1h2m3s

Types

type MarshalFunc 

type MarshalFunc func(v any) (string, error)

func GetMarshalFunc 

func GetMarshalFunc(typ reflect.Type) MarshalFunc

GetMarshalFunc returns the globally registered MarshalFunc for reflect.Type typ or nil if there is none registered with RegisterMarshalFunc.

func (MarshalFunc) Exec 

func (fn MarshalFunc) Exec(val reflect.Value) (Value, error)

Exec executes the MarshalFunc for the given reflect.Value.

type Marshaler 

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

Marshaler is a type which can marshal any reflect.Value to its raw string representation as long as it's registered with Register. It wil always fallback to the global Marshaler when a type is not registered.

Example 
var m Marshaler
target, _ := url.ParseRequestURI("https://example.com")
val, err := m.Marshal(reflect.ValueOf(target))
if err != nil {
	panic(err)
}

fmt.Println(val.String())

Output:

https://example.com

func (*Marshaler) Func 

func (m *Marshaler) Func(typ reflect.Type) MarshalFunc

Func returns the (globally) registered MarshalFunc for reflect.Type typ or nil if there is none registered with Register or RegisterMarshalFunc.

func (*Marshaler) Marshal 

func (m *Marshaler) Marshal(val reflect.Value) (Value, error)

Marshal returns the string representation of the value. If the underlying reflect.Value is nil, it returns an empty string.

func (*Marshaler) Register 

func (m *Marshaler) Register(typ reflect.Type, fn MarshalFunc) *Marshaler

Register the MarshalFunc for typ but only for this Marshaler.

type UnmarshalFunc 

type UnmarshalFunc func(val Value, dest any) error

UnmarshalFunc is a function which can unmarshal a Value to any type. Argument dest is always a pointer to the value to unmarshal to.

func GetUnmarshalFunc 

func GetUnmarshalFunc(typ reflect.Type) UnmarshalFunc

GetUnmarshalFunc returns the globally registered UnmarshalFunc for reflect.Type typ or nil if there is none registered with RegisterUnmarshalFunc.

func (UnmarshalFunc) Exec 

func (fn UnmarshalFunc) Exec(v Value, dest reflect.Value) error

Exec executes the UnmarshalFunc by taking the address of dest, and passing it as an interface to UnmarshalFunc. It will return an error when the address of reflect.Value dest cannot be taken, or when it is unable to set. Any error returned by UnmarshalFunc is wrapped with ParseError.

type Unmarshaler 

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

Unmarshaler is a type which can unmarshal a Value to any type that's registered with Register. It wil always fallback to the global Unmarshaler when a type is not registered.

Example 
var u Unmarshaler
var target *url.URL
if err := u.Unmarshal("https://example.com", reflect.ValueOf(&target)); err != nil {
	panic(err)
}

fmt.Println(target.String())

Output:

https://example.com

func (*Unmarshaler) Func 

func (u *Unmarshaler) Func(typ reflect.Type) UnmarshalFunc

Func returns the (globally) registered UnmarshalFunc for reflect.Type typ or nil if there is none registered with Register or RegisterUnmarshalFunc.

func (*Unmarshaler) Register 

func (u *Unmarshaler) Register(typ reflect.Type, fn UnmarshalFunc) *Unmarshaler

Register the UnmarshalFunc for typ but only for this Unmarshaler.

Example 
type myType struct {
	something string
}

var u Unmarshaler
u.Register(reflect.TypeOf(myType{}), func(val Value, dest any) error {
	mt := dest.(*myType)
	mt.something = val.String()
	return nil
})

var target myType
if err := u.Unmarshal("some value", reflect.ValueOf(&target)); err != nil {
	panic(err)
}

spew.Dump(target)

Output:

(rawconv.myType) {
 something: (string) (len=10) "some value"
}

func (*Unmarshaler) Unmarshal 

func (u *Unmarshaler) Unmarshal(val Value, v reflect.Value) error

Unmarshal tries to unmarshal Value to a supported type which matches the type of v, and sets the parsed value to it. See Unmarshal for additional details.

type UnsupportedTypeError 

type UnsupportedTypeError struct {
	Type reflect.Type
}

func (*UnsupportedTypeError) Error 

func (e *UnsupportedTypeError) Error() string

func (*UnsupportedTypeError) Is 

func (e *UnsupportedTypeError) Is(err error) bool

type Value 

type Value string

Value is a textual representation of a raw value which is able to cast itself to any of the supported types using its corresponding method. 

boolVal, err := rawconv.Value("true").Bool()

func Marshal 

func Marshal(v any) (Value, error)

Marshal formats the value pointed to by v to a raw string Value. If v is not a supported type an UnsupportedTypeError is returned. By default, the following types are supported: - encoding.TextUnmarshaler - time.Duration - url.URL - string - bool - int, int8, int16, int32, int64 - uint, uint8, uint16, uint32, uint64 - float32, float64 - complex64, complex128 Use RegisterMarshalFunc to add additional (custom) types.

Example 
duration := time.Hour + (time.Minute * 2) + (time.Second * 3)
val, err := Marshal(duration)
if err != nil {
	panic(err)
}

fmt.Println(val.String())

Output:

1h2m3s

func (Value) Bool 

func (v Value) Bool() (bool, error)

Bool tries to parse Value as a bool using strconv.ParseBool. It accepts 1, t, T, TRUE, true, True, 0, f, F, FALSE, false, False. Any other value returns an error.

func (Value) BoolVar 

func (v Value) BoolVar(p *bool) (err error)

BoolVar sets the value p points to using Bool.

func (Value) Bytes 

func (v Value) Bytes() []byte

Bytes returns Value as raw bytes.

func (Value) BytesVar 

func (v Value) BytesVar(p *[]byte)

BytesVar sets the value p points to, to Value as raw bytes.

func (Value) Complex128 

func (v Value) Complex128() (complex128, error)

Complex128 tries to parse Value as a complex128 using strconv.ParseComplex.

func (Value) Complex128Var 

func (v Value) Complex128Var(p *complex128) (err error)

Complex128Var sets the value p points to using Complex128.

func (Value) Complex64 

func (v Value) Complex64() (complex64, error)

Complex64 tries to parse Value as a complex64 using strconv.ParseComplex.

func (Value) Complex64Var 

func (v Value) Complex64Var(p *complex64) (err error)

Complex64Var sets the value p points to using Complex64.

func (Value) Duration 

func (v Value) Duration() (time.Duration, error)

Duration tries to parse Value as a time.Duration using time.ParseDuration.

func (Value) DurationVar 

func (v Value) DurationVar(p *time.Duration) (err error)

DurationVar sets the value p points to using Duration.

func (Value) Float32 

func (v Value) Float32() (float32, error)

Float32 tries to parse Value as a float32 using strconv.ParseFloat.

func (Value) Float32Var 

func (v Value) Float32Var(p *float32) (err error)

Float32Var sets the value p points to using Float32.

func (Value) Float64 

func (v Value) Float64() (float64, error)

Float64 tries to parse Value as a float64 using strconv.ParseFloat.

func (Value) Float64Var 

func (v Value) Float64Var(p *float64) (err error)

Float64Var sets the value p points to using Float64.

func (Value) GoString 

func (v Value) GoString() string

func (Value) Int 

func (v Value) Int() (int, error)

Int tries to parse Value as an int using strconv.ParseInt.

func (Value) Int16 

func (v Value) Int16() (int16, error)

Int16 tries to parse Value as an int16 using strconv.ParseInt.

func (Value) Int16Var 

func (v Value) Int16Var(p *int16) (err error)

Int16Var sets the value p points to using Int16.

func (Value) Int32 

func (v Value) Int32() (int32, error)

Int32 tries to parse Value as an int32 using strconv.ParseInt.

func (Value) Int32Var 

func (v Value) Int32Var(p *int32) (err error)

Int32Var sets the value p points to using Int32.

func (Value) Int64 

func (v Value) Int64() (int64, error)

Int64 tries to parse Value as an int64 using strconv.ParseInt.

func (Value) Int64Var 

func (v Value) Int64Var(p *int64) (err error)

Int64Var sets the value p points to using Int64.

func (Value) Int8 

func (v Value) Int8() (int8, error)

Int8 tries to parse Value as an int8 using strconv.ParseInt.

func (Value) Int8Var 

func (v Value) Int8Var(p *int8) (err error)

Int8Var sets the value p points to using Int8.

func (Value) IntVar 

func (v Value) IntVar(p *int) (err error)

IntVar sets the value p points to using Int.

func (Value) IsEmpty 

func (v Value) IsEmpty() bool

IsEmpty indicates if Value is an empty string.

func (Value) String 

func (v Value) String() string

String returns Value as a raw string.

func (Value) StringVar 

func (v Value) StringVar(p *string)

StringVar sets the value p points to, to Value as raw string.

func (Value) Uint 

func (v Value) Uint() (uint, error)

Uint tries to parse Value as an uint using strconv.ParseUint

func (Value) Uint16 

func (v Value) Uint16() (uint16, error)

Uint16 tries to parse Value as an uint16 using strconv.ParseUint.

func (Value) Uint16Var 

func (v Value) Uint16Var(p *uint16) (err error)

Uint16Var sets the value p points to using Uint16.

func (Value) Uint32 

func (v Value) Uint32() (uint32, error)

Uint32 tries to parse Value as an uint32 using strconv.ParseUint.

func (Value) Uint32Var 

func (v Value) Uint32Var(p *uint32) (err error)

Uint32Var sets the value p points to using Uint32.

func (Value) Uint64 

func (v Value) Uint64() (uint64, error)

Uint64 tries to parse Value as an uint64 using strconv.ParseUint.

func (Value) Uint64Var 

func (v Value) Uint64Var(p *uint64) (err error)

Uint64Var sets the value p points to using Uint64.

func (Value) Uint8 

func (v Value) Uint8() (uint8, error)

Uint8 tries to parse Value as an uint8 using strconv.ParseUint.

func (Value) Uint8Var 

func (v Value) Uint8Var(p *uint8) (err error)

Uint8Var sets the value p points to using Uint8.

func (Value) UintVar 

func (v Value) UintVar(p *uint) (err error)

UintVar sets the value p points to using Uint.

func (Value) Url 

func (v Value) Url() (*url.URL, error)

Url tries to parse Value as an *url.URL using url.ParseRequestURI.

func (Value) UrlVar 

func (v Value) UrlVar(p *url.URL) error

UrlVar sets the value p points to using Url.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.