| commit | b6e79f1232c697d589dde6da2dd13b4de75b8af9 | [log] [tgz] |
|---|---|---|
| author | Will Norris <will@willnorris.com> | Thu Dec 02 17:03:21 2021 |
| committer | Will Norris <will@willnorris.com> | Thu Dec 02 17:03:21 2021 |
| tree | 3b6c9a0ae13ac96415c5003713671266522234af | |
| parent | 9392084f0fd11c8727f6c6710d2b73661c9be4c7 [diff] |
docs: clarify behavior of nested structs relates to #62
go-querystring is a Go library for encoding structs into URL query parameters.
import "github.com/google/go-querystring/query"
go-querystring is designed to assist in scenarios where you want to construct a URL using a struct that represents the URL query parameters. You might do this to enforce the type safety of your parameters, for example, as is done in the go-github library.
The query package exports a single Values() function. A simple example:
type Options struct { Query string `url:"q"` ShowAll bool `url:"all"` Page int `url:"page"` } opt := Options{ "foo", true, 2 } v, _ := query.Values(opt) fmt.Print(v.Encode()) // will output: "q=foo&all=true&page=2"
See the package godocs for complete documentation on supported types and formatting options.
If you are looking for a library that can both encode and decode query strings, you might consider one of these alternatives: