1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
|
# go-querystring #
[](https://pkg.go.dev/github.com/google/go-querystring/query)
[](https://github.com/google/go-querystring/actions?query=workflow%3Atests)
[](https://codecov.io/gh/google/go-querystring)
go-querystring is a Go library for encoding structs into URL query parameters.
## Usage ##
```go
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:
```go
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.
[go-github]: https://github.com/google/go-github/commit/994f6f8405f052a117d2d0b500054341048fbb08
[package godocs]: https://pkg.go.dev/github.com/google/go-querystring/query
## Alternatives ##
If you are looking for a library that can both encode and decode query strings,
you might consider one of these alternatives:
- https://github.com/gorilla/schema
- https://github.com/pasztorpisti/qs
- https://github.com/hetiansu5/urlquery
|
