types

Library for types conversion.

go get github.com/worldline-go/types

Usage

types.Map

Map based on map[string]interface{} and null values stay as nil.

This type not convert to base64 when marshaling, it is directly a json string.

type Train struct {
	Details types.Map `db:"details"`
}

types.RawJSON

[]byte type behind, same as json.RawMessage with scan and value methods.

type Train struct {
	Details types.RawJSON `db:"details"`
}

types.Slice[T]

Slice based on []T and null values stay as nil.

type Train struct {
	Slice types.Slice[string] `db:"slice"`
}

types.JSON[T]

For any type of json nullable value. Useful for struct values.

type Details struct {
	Name string `json:"name"`
}

type Train struct {
	Details types.JSON[Details] `db:"details"`
}

types.Null[T]

Wrapper of sql.Null[T] with additional json marshal and unmarshal methods.

types.Time and types.Null[types.Time]

Wrapper of time.Time with additional json marshal and unmarshal methods with database scan and value methods.

---

string, json.Number OR decimal.Decimal

Use decimal.Decimal always for calculations.

To use decimal.Decimal type from github.com/shopspring/decimal package.
Use json.Number type for json number values and after that convert to decimal.Decimal.
Use string type to direct get numeric values as string and convert to decimal.Decimal.

Use with nullable sql.Null[decimal.Decimal] package or pointer or decimal.NullDecimal type.

In struct use like this:

type Train struct {
	ID          int64                     `db:"id"          goqu:"skipinsert"`
	Details     types.Map                 `db:"details"     json:"details,omitempty"`
	Additionals types.RawJSON             `db:"additionals" json:"additionals,omitempty"`
	Price       sql.Null[json.Number]     `db:"price"`
	LastPrice   decimal.NullDecimal       `db:"last_price"`
}

Development

Go to example folder and run make command and fallow usage.