diff options
Diffstat (limited to 'vendor/google.golang.org/api/googleapi')
5 files changed, 865 insertions, 0 deletions
| diff --git a/vendor/google.golang.org/api/googleapi/googleapi.go b/vendor/google.golang.org/api/googleapi/googleapi.go new file mode 100644 index 0000000..858537e --- /dev/null +++ b/vendor/google.golang.org/api/googleapi/googleapi.go @@ -0,0 +1,432 @@ +// Copyright 2011 Google Inc. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +// Package googleapi contains the common code shared by all Google API +// libraries. +package googleapi + +import ( +	"bytes" +	"encoding/json" +	"fmt" +	"io" +	"io/ioutil" +	"net/http" +	"net/url" +	"strings" + +	"google.golang.org/api/googleapi/internal/uritemplates" +) + +// ContentTyper is an interface for Readers which know (or would like +// to override) their Content-Type. If a media body doesn't implement +// ContentTyper, the type is sniffed from the content using +// http.DetectContentType. +type ContentTyper interface { +	ContentType() string +} + +// A SizeReaderAt is a ReaderAt with a Size method. +// An io.SectionReader implements SizeReaderAt. +type SizeReaderAt interface { +	io.ReaderAt +	Size() int64 +} + +// ServerResponse is embedded in each Do response and +// provides the HTTP status code and header sent by the server. +type ServerResponse struct { +	// HTTPStatusCode is the server's response status code. +	// When using a resource method's Do call, this will always be in the 2xx range. +	HTTPStatusCode int +	// Header contains the response header fields from the server. +	Header http.Header +} + +const ( +	Version = "0.5" + +	// UserAgent is the header string used to identify this package. +	UserAgent = "google-api-go-client/" + Version + +	// The default chunk size to use for resumable uplods if not specified by the user. +	DefaultUploadChunkSize = 8 * 1024 * 1024 + +	// The minimum chunk size that can be used for resumable uploads.  All +	// user-specified chunk sizes must be multiple of this value. +	MinUploadChunkSize = 256 * 1024 +) + +// Error contains an error response from the server. +type Error struct { +	// Code is the HTTP response status code and will always be populated. +	Code int `json:"code"` +	// Message is the server response message and is only populated when +	// explicitly referenced by the JSON server response. +	Message string `json:"message"` +	// Body is the raw response returned by the server. +	// It is often but not always JSON, depending on how the request fails. +	Body string +	// Header contains the response header fields from the server. +	Header http.Header + +	Errors []ErrorItem +} + +// ErrorItem is a detailed error code & message from the Google API frontend. +type ErrorItem struct { +	// Reason is the typed error code. For example: "some_example". +	Reason string `json:"reason"` +	// Message is the human-readable description of the error. +	Message string `json:"message"` +} + +func (e *Error) Error() string { +	if len(e.Errors) == 0 && e.Message == "" { +		return fmt.Sprintf("googleapi: got HTTP response code %d with body: %v", e.Code, e.Body) +	} +	var buf bytes.Buffer +	fmt.Fprintf(&buf, "googleapi: Error %d: ", e.Code) +	if e.Message != "" { +		fmt.Fprintf(&buf, "%s", e.Message) +	} +	if len(e.Errors) == 0 { +		return strings.TrimSpace(buf.String()) +	} +	if len(e.Errors) == 1 && e.Errors[0].Message == e.Message { +		fmt.Fprintf(&buf, ", %s", e.Errors[0].Reason) +		return buf.String() +	} +	fmt.Fprintln(&buf, "\nMore details:") +	for _, v := range e.Errors { +		fmt.Fprintf(&buf, "Reason: %s, Message: %s\n", v.Reason, v.Message) +	} +	return buf.String() +} + +type errorReply struct { +	Error *Error `json:"error"` +} + +// CheckResponse returns an error (of type *Error) if the response +// status code is not 2xx. +func CheckResponse(res *http.Response) error { +	if res.StatusCode >= 200 && res.StatusCode <= 299 { +		return nil +	} +	slurp, err := ioutil.ReadAll(res.Body) +	if err == nil { +		jerr := new(errorReply) +		err = json.Unmarshal(slurp, jerr) +		if err == nil && jerr.Error != nil { +			if jerr.Error.Code == 0 { +				jerr.Error.Code = res.StatusCode +			} +			jerr.Error.Body = string(slurp) +			return jerr.Error +		} +	} +	return &Error{ +		Code:   res.StatusCode, +		Body:   string(slurp), +		Header: res.Header, +	} +} + +// IsNotModified reports whether err is the result of the +// server replying with http.StatusNotModified. +// Such error values are sometimes returned by "Do" methods +// on calls when If-None-Match is used. +func IsNotModified(err error) bool { +	if err == nil { +		return false +	} +	ae, ok := err.(*Error) +	return ok && ae.Code == http.StatusNotModified +} + +// CheckMediaResponse returns an error (of type *Error) if the response +// status code is not 2xx. Unlike CheckResponse it does not assume the +// body is a JSON error document. +func CheckMediaResponse(res *http.Response) error { +	if res.StatusCode >= 200 && res.StatusCode <= 299 { +		return nil +	} +	slurp, _ := ioutil.ReadAll(io.LimitReader(res.Body, 1<<20)) +	res.Body.Close() +	return &Error{ +		Code: res.StatusCode, +		Body: string(slurp), +	} +} + +type MarshalStyle bool + +var WithDataWrapper = MarshalStyle(true) +var WithoutDataWrapper = MarshalStyle(false) + +func (wrap MarshalStyle) JSONReader(v interface{}) (io.Reader, error) { +	buf := new(bytes.Buffer) +	if wrap { +		buf.Write([]byte(`{"data": `)) +	} +	err := json.NewEncoder(buf).Encode(v) +	if err != nil { +		return nil, err +	} +	if wrap { +		buf.Write([]byte(`}`)) +	} +	return buf, nil +} + +// endingWithErrorReader from r until it returns an error.  If the +// final error from r is io.EOF and e is non-nil, e is used instead. +type endingWithErrorReader struct { +	r io.Reader +	e error +} + +func (er endingWithErrorReader) Read(p []byte) (n int, err error) { +	n, err = er.r.Read(p) +	if err == io.EOF && er.e != nil { +		err = er.e +	} +	return +} + +// countingWriter counts the number of bytes it receives to write, but +// discards them. +type countingWriter struct { +	n *int64 +} + +func (w countingWriter) Write(p []byte) (int, error) { +	*w.n += int64(len(p)) +	return len(p), nil +} + +// ProgressUpdater is a function that is called upon every progress update of a resumable upload. +// This is the only part of a resumable upload (from googleapi) that is usable by the developer. +// The remaining usable pieces of resumable uploads is exposed in each auto-generated API. +type ProgressUpdater func(current, total int64) + +type MediaOption interface { +	setOptions(o *MediaOptions) +} + +type contentTypeOption string + +func (ct contentTypeOption) setOptions(o *MediaOptions) { +	o.ContentType = string(ct) +	if o.ContentType == "" { +		o.ForceEmptyContentType = true +	} +} + +// ContentType returns a MediaOption which sets the Content-Type header for media uploads. +// If ctype is empty, the Content-Type header will be omitted. +func ContentType(ctype string) MediaOption { +	return contentTypeOption(ctype) +} + +type chunkSizeOption int + +func (cs chunkSizeOption) setOptions(o *MediaOptions) { +	size := int(cs) +	if size%MinUploadChunkSize != 0 { +		size += MinUploadChunkSize - (size % MinUploadChunkSize) +	} +	o.ChunkSize = size +} + +// ChunkSize returns a MediaOption which sets the chunk size for media uploads. +// size will be rounded up to the nearest multiple of 256K. +// Media which contains fewer than size bytes will be uploaded in a single request. +// Media which contains size bytes or more will be uploaded in separate chunks. +// If size is zero, media will be uploaded in a single request. +func ChunkSize(size int) MediaOption { +	return chunkSizeOption(size) +} + +// MediaOptions stores options for customizing media upload.  It is not used by developers directly. +type MediaOptions struct { +	ContentType           string +	ForceEmptyContentType bool + +	ChunkSize int +} + +// ProcessMediaOptions stores options from opts in a MediaOptions. +// It is not used by developers directly. +func ProcessMediaOptions(opts []MediaOption) *MediaOptions { +	mo := &MediaOptions{ChunkSize: DefaultUploadChunkSize} +	for _, o := range opts { +		o.setOptions(mo) +	} +	return mo +} + +func ResolveRelative(basestr, relstr string) string { +	u, _ := url.Parse(basestr) +	rel, _ := url.Parse(relstr) +	u = u.ResolveReference(rel) +	us := u.String() +	us = strings.Replace(us, "%7B", "{", -1) +	us = strings.Replace(us, "%7D", "}", -1) +	return us +} + +// has4860Fix is whether this Go environment contains the fix for +// http://golang.org/issue/4860 +var has4860Fix bool + +// init initializes has4860Fix by checking the behavior of the net/http package. +func init() { +	r := http.Request{ +		URL: &url.URL{ +			Scheme: "http", +			Opaque: "//opaque", +		}, +	} +	b := &bytes.Buffer{} +	r.Write(b) +	has4860Fix = bytes.HasPrefix(b.Bytes(), []byte("GET http")) +} + +// SetOpaque sets u.Opaque from u.Path such that HTTP requests to it +// don't alter any hex-escaped characters in u.Path. +func SetOpaque(u *url.URL) { +	u.Opaque = "//" + u.Host + u.Path +	if !has4860Fix { +		u.Opaque = u.Scheme + ":" + u.Opaque +	} +} + +// Expand subsitutes any {encoded} strings in the URL passed in using +// the map supplied. +// +// This calls SetOpaque to avoid encoding of the parameters in the URL path. +func Expand(u *url.URL, expansions map[string]string) { +	expanded, err := uritemplates.Expand(u.Path, expansions) +	if err == nil { +		u.Path = expanded +		SetOpaque(u) +	} +} + +// CloseBody is used to close res.Body. +// Prior to calling Close, it also tries to Read a small amount to see an EOF. +// Not seeing an EOF can prevent HTTP Transports from reusing connections. +func CloseBody(res *http.Response) { +	if res == nil || res.Body == nil { +		return +	} +	// Justification for 3 byte reads: two for up to "\r\n" after +	// a JSON/XML document, and then 1 to see EOF if we haven't yet. +	// TODO(bradfitz): detect Go 1.3+ and skip these reads. +	// See https://codereview.appspot.com/58240043 +	// and https://codereview.appspot.com/49570044 +	buf := make([]byte, 1) +	for i := 0; i < 3; i++ { +		_, err := res.Body.Read(buf) +		if err != nil { +			break +		} +	} +	res.Body.Close() + +} + +// VariantType returns the type name of the given variant. +// If the map doesn't contain the named key or the value is not a []interface{}, "" is returned. +// This is used to support "variant" APIs that can return one of a number of different types. +func VariantType(t map[string]interface{}) string { +	s, _ := t["type"].(string) +	return s +} + +// ConvertVariant uses the JSON encoder/decoder to fill in the struct 'dst' with the fields found in variant 'v'. +// This is used to support "variant" APIs that can return one of a number of different types. +// It reports whether the conversion was successful. +func ConvertVariant(v map[string]interface{}, dst interface{}) bool { +	var buf bytes.Buffer +	err := json.NewEncoder(&buf).Encode(v) +	if err != nil { +		return false +	} +	return json.Unmarshal(buf.Bytes(), dst) == nil +} + +// A Field names a field to be retrieved with a partial response. +// See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// +// Partial responses can dramatically reduce the amount of data that must be sent to your application. +// In order to request partial responses, you can specify the full list of fields +// that your application needs by adding the Fields option to your request. +// +// Field strings use camelCase with leading lower-case characters to identify fields within the response. +// +// For example, if your response has a "NextPageToken" and a slice of "Items" with "Id" fields, +// you could request just those fields like this: +// +//     svc.Events.List().Fields("nextPageToken", "items/id").Do() +// +// or if you were also interested in each Item's "Updated" field, you can combine them like this: +// +//     svc.Events.List().Fields("nextPageToken", "items(id,updated)").Do() +// +// More information about field formatting can be found here: +// https://developers.google.com/+/api/#fields-syntax +// +// Another way to find field names is through the Google API explorer: +// https://developers.google.com/apis-explorer/#p/ +type Field string + +// CombineFields combines fields into a single string. +func CombineFields(s []Field) string { +	r := make([]string, len(s)) +	for i, v := range s { +		r[i] = string(v) +	} +	return strings.Join(r, ",") +} + +// A CallOption is an optional argument to an API call. +// It should be treated as an opaque value by users of Google APIs. +// +// A CallOption is something that configures an API call in a way that is +// not specific to that API; for instance, controlling the quota user for +// an API call is common across many APIs, and is thus a CallOption. +type CallOption interface { +	Get() (key, value string) +} + +// QuotaUser returns a CallOption that will set the quota user for a call. +// The quota user can be used by server-side applications to control accounting. +// It can be an arbitrary string up to 40 characters, and will override UserIP +// if both are provided. +func QuotaUser(u string) CallOption { return quotaUser(u) } + +type quotaUser string + +func (q quotaUser) Get() (string, string) { return "quotaUser", string(q) } + +// UserIP returns a CallOption that will set the "userIp" parameter of a call. +// This should be the IP address of the originating request. +func UserIP(ip string) CallOption { return userIP(ip) } + +type userIP string + +func (i userIP) Get() (string, string) { return "userIp", string(i) } + +// Trace returns a CallOption that enables diagnostic tracing for a call. +// traceToken is an ID supplied by Google support. +func Trace(traceToken string) CallOption { return traceTok(traceToken) } + +type traceTok string + +func (t traceTok) Get() (string, string) { return "trace", "token:" + string(t) } + +// TODO: Fields too diff --git a/vendor/google.golang.org/api/googleapi/internal/uritemplates/LICENSE b/vendor/google.golang.org/api/googleapi/internal/uritemplates/LICENSE new file mode 100644 index 0000000..de9c88c --- /dev/null +++ b/vendor/google.golang.org/api/googleapi/internal/uritemplates/LICENSE @@ -0,0 +1,18 @@ +Copyright (c) 2013 Joshua Tacoma + +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of +the Software, and to permit persons to whom the Software is furnished to do so, +subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS +FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR +COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER +IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN +CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/vendor/google.golang.org/api/googleapi/internal/uritemplates/uritemplates.go b/vendor/google.golang.org/api/googleapi/internal/uritemplates/uritemplates.go new file mode 100644 index 0000000..7c103ba --- /dev/null +++ b/vendor/google.golang.org/api/googleapi/internal/uritemplates/uritemplates.go @@ -0,0 +1,220 @@ +// Copyright 2013 Joshua Tacoma. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +// Package uritemplates is a level 3 implementation of RFC 6570 (URI +// Template, http://tools.ietf.org/html/rfc6570). +// uritemplates does not support composite values (in Go: slices or maps) +// and so does not qualify as a level 4 implementation. +package uritemplates + +import ( +	"bytes" +	"errors" +	"regexp" +	"strconv" +	"strings" +) + +var ( +	unreserved = regexp.MustCompile("[^A-Za-z0-9\\-._~]") +	reserved   = regexp.MustCompile("[^A-Za-z0-9\\-._~:/?#[\\]@!$&'()*+,;=]") +	validname  = regexp.MustCompile("^([A-Za-z0-9_\\.]|%[0-9A-Fa-f][0-9A-Fa-f])+$") +	hex        = []byte("0123456789ABCDEF") +) + +func pctEncode(src []byte) []byte { +	dst := make([]byte, len(src)*3) +	for i, b := range src { +		buf := dst[i*3 : i*3+3] +		buf[0] = 0x25 +		buf[1] = hex[b/16] +		buf[2] = hex[b%16] +	} +	return dst +} + +func escape(s string, allowReserved bool) string { +	if allowReserved { +		return string(reserved.ReplaceAllFunc([]byte(s), pctEncode)) +	} +	return string(unreserved.ReplaceAllFunc([]byte(s), pctEncode)) +} + +// A uriTemplate is a parsed representation of a URI template. +type uriTemplate struct { +	raw   string +	parts []templatePart +} + +// parse parses a URI template string into a uriTemplate object. +func parse(rawTemplate string) (*uriTemplate, error) { +	split := strings.Split(rawTemplate, "{") +	parts := make([]templatePart, len(split)*2-1) +	for i, s := range split { +		if i == 0 { +			if strings.Contains(s, "}") { +				return nil, errors.New("unexpected }") +			} +			parts[i].raw = s +			continue +		} +		subsplit := strings.Split(s, "}") +		if len(subsplit) != 2 { +			return nil, errors.New("malformed template") +		} +		expression := subsplit[0] +		var err error +		parts[i*2-1], err = parseExpression(expression) +		if err != nil { +			return nil, err +		} +		parts[i*2].raw = subsplit[1] +	} +	return &uriTemplate{ +		raw:   rawTemplate, +		parts: parts, +	}, nil +} + +type templatePart struct { +	raw           string +	terms         []templateTerm +	first         string +	sep           string +	named         bool +	ifemp         string +	allowReserved bool +} + +type templateTerm struct { +	name     string +	explode  bool +	truncate int +} + +func parseExpression(expression string) (result templatePart, err error) { +	switch expression[0] { +	case '+': +		result.sep = "," +		result.allowReserved = true +		expression = expression[1:] +	case '.': +		result.first = "." +		result.sep = "." +		expression = expression[1:] +	case '/': +		result.first = "/" +		result.sep = "/" +		expression = expression[1:] +	case ';': +		result.first = ";" +		result.sep = ";" +		result.named = true +		expression = expression[1:] +	case '?': +		result.first = "?" +		result.sep = "&" +		result.named = true +		result.ifemp = "=" +		expression = expression[1:] +	case '&': +		result.first = "&" +		result.sep = "&" +		result.named = true +		result.ifemp = "=" +		expression = expression[1:] +	case '#': +		result.first = "#" +		result.sep = "," +		result.allowReserved = true +		expression = expression[1:] +	default: +		result.sep = "," +	} +	rawterms := strings.Split(expression, ",") +	result.terms = make([]templateTerm, len(rawterms)) +	for i, raw := range rawterms { +		result.terms[i], err = parseTerm(raw) +		if err != nil { +			break +		} +	} +	return result, err +} + +func parseTerm(term string) (result templateTerm, err error) { +	// TODO(djd): Remove "*" suffix parsing once we check that no APIs have +	// mistakenly used that attribute. +	if strings.HasSuffix(term, "*") { +		result.explode = true +		term = term[:len(term)-1] +	} +	split := strings.Split(term, ":") +	if len(split) == 1 { +		result.name = term +	} else if len(split) == 2 { +		result.name = split[0] +		var parsed int64 +		parsed, err = strconv.ParseInt(split[1], 10, 0) +		result.truncate = int(parsed) +	} else { +		err = errors.New("multiple colons in same term") +	} +	if !validname.MatchString(result.name) { +		err = errors.New("not a valid name: " + result.name) +	} +	if result.explode && result.truncate > 0 { +		err = errors.New("both explode and prefix modifers on same term") +	} +	return result, err +} + +// Expand expands a URI template with a set of values to produce a string. +func (t *uriTemplate) Expand(values map[string]string) string { +	var buf bytes.Buffer +	for _, p := range t.parts { +		p.expand(&buf, values) +	} +	return buf.String() +} + +func (tp *templatePart) expand(buf *bytes.Buffer, values map[string]string) { +	if len(tp.raw) > 0 { +		buf.WriteString(tp.raw) +		return +	} +	var first = true +	for _, term := range tp.terms { +		value, exists := values[term.name] +		if !exists { +			continue +		} +		if first { +			buf.WriteString(tp.first) +			first = false +		} else { +			buf.WriteString(tp.sep) +		} +		tp.expandString(buf, term, value) +	} +} + +func (tp *templatePart) expandName(buf *bytes.Buffer, name string, empty bool) { +	if tp.named { +		buf.WriteString(name) +		if empty { +			buf.WriteString(tp.ifemp) +		} else { +			buf.WriteString("=") +		} +	} +} + +func (tp *templatePart) expandString(buf *bytes.Buffer, t templateTerm, s string) { +	if len(s) > t.truncate && t.truncate > 0 { +		s = s[:t.truncate] +	} +	tp.expandName(buf, t.name, len(s) == 0) +	buf.WriteString(escape(s, tp.allowReserved)) +} diff --git a/vendor/google.golang.org/api/googleapi/internal/uritemplates/utils.go b/vendor/google.golang.org/api/googleapi/internal/uritemplates/utils.go new file mode 100644 index 0000000..eff260a --- /dev/null +++ b/vendor/google.golang.org/api/googleapi/internal/uritemplates/utils.go @@ -0,0 +1,13 @@ +// Copyright 2016 The Go Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +package uritemplates + +func Expand(path string, values map[string]string) (string, error) { +	template, err := parse(path) +	if err != nil { +		return "", err +	} +	return template.Expand(values), nil +} diff --git a/vendor/google.golang.org/api/googleapi/types.go b/vendor/google.golang.org/api/googleapi/types.go new file mode 100644 index 0000000..a02b4b0 --- /dev/null +++ b/vendor/google.golang.org/api/googleapi/types.go @@ -0,0 +1,182 @@ +// Copyright 2013 Google Inc. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +package googleapi + +import ( +	"encoding/json" +	"strconv" +) + +// Int64s is a slice of int64s that marshal as quoted strings in JSON. +type Int64s []int64 + +func (q *Int64s) UnmarshalJSON(raw []byte) error { +	*q = (*q)[:0] +	var ss []string +	if err := json.Unmarshal(raw, &ss); err != nil { +		return err +	} +	for _, s := range ss { +		v, err := strconv.ParseInt(s, 10, 64) +		if err != nil { +			return err +		} +		*q = append(*q, int64(v)) +	} +	return nil +} + +// Int32s is a slice of int32s that marshal as quoted strings in JSON. +type Int32s []int32 + +func (q *Int32s) UnmarshalJSON(raw []byte) error { +	*q = (*q)[:0] +	var ss []string +	if err := json.Unmarshal(raw, &ss); err != nil { +		return err +	} +	for _, s := range ss { +		v, err := strconv.ParseInt(s, 10, 32) +		if err != nil { +			return err +		} +		*q = append(*q, int32(v)) +	} +	return nil +} + +// Uint64s is a slice of uint64s that marshal as quoted strings in JSON. +type Uint64s []uint64 + +func (q *Uint64s) UnmarshalJSON(raw []byte) error { +	*q = (*q)[:0] +	var ss []string +	if err := json.Unmarshal(raw, &ss); err != nil { +		return err +	} +	for _, s := range ss { +		v, err := strconv.ParseUint(s, 10, 64) +		if err != nil { +			return err +		} +		*q = append(*q, uint64(v)) +	} +	return nil +} + +// Uint32s is a slice of uint32s that marshal as quoted strings in JSON. +type Uint32s []uint32 + +func (q *Uint32s) UnmarshalJSON(raw []byte) error { +	*q = (*q)[:0] +	var ss []string +	if err := json.Unmarshal(raw, &ss); err != nil { +		return err +	} +	for _, s := range ss { +		v, err := strconv.ParseUint(s, 10, 32) +		if err != nil { +			return err +		} +		*q = append(*q, uint32(v)) +	} +	return nil +} + +// Float64s is a slice of float64s that marshal as quoted strings in JSON. +type Float64s []float64 + +func (q *Float64s) UnmarshalJSON(raw []byte) error { +	*q = (*q)[:0] +	var ss []string +	if err := json.Unmarshal(raw, &ss); err != nil { +		return err +	} +	for _, s := range ss { +		v, err := strconv.ParseFloat(s, 64) +		if err != nil { +			return err +		} +		*q = append(*q, float64(v)) +	} +	return nil +} + +func quotedList(n int, fn func(dst []byte, i int) []byte) ([]byte, error) { +	dst := make([]byte, 0, 2+n*10) // somewhat arbitrary +	dst = append(dst, '[') +	for i := 0; i < n; i++ { +		if i > 0 { +			dst = append(dst, ',') +		} +		dst = append(dst, '"') +		dst = fn(dst, i) +		dst = append(dst, '"') +	} +	dst = append(dst, ']') +	return dst, nil +} + +func (s Int64s) MarshalJSON() ([]byte, error) { +	return quotedList(len(s), func(dst []byte, i int) []byte { +		return strconv.AppendInt(dst, s[i], 10) +	}) +} + +func (s Int32s) MarshalJSON() ([]byte, error) { +	return quotedList(len(s), func(dst []byte, i int) []byte { +		return strconv.AppendInt(dst, int64(s[i]), 10) +	}) +} + +func (s Uint64s) MarshalJSON() ([]byte, error) { +	return quotedList(len(s), func(dst []byte, i int) []byte { +		return strconv.AppendUint(dst, s[i], 10) +	}) +} + +func (s Uint32s) MarshalJSON() ([]byte, error) { +	return quotedList(len(s), func(dst []byte, i int) []byte { +		return strconv.AppendUint(dst, uint64(s[i]), 10) +	}) +} + +func (s Float64s) MarshalJSON() ([]byte, error) { +	return quotedList(len(s), func(dst []byte, i int) []byte { +		return strconv.AppendFloat(dst, s[i], 'g', -1, 64) +	}) +} + +/* + * Helper routines for simplifying the creation of optional fields of basic type. + */ + +// Bool is a helper routine that allocates a new bool value +// to store v and returns a pointer to it. +func Bool(v bool) *bool { return &v } + +// Int32 is a helper routine that allocates a new int32 value +// to store v and returns a pointer to it. +func Int32(v int32) *int32 { return &v } + +// Int64 is a helper routine that allocates a new int64 value +// to store v and returns a pointer to it. +func Int64(v int64) *int64 { return &v } + +// Float64 is a helper routine that allocates a new float64 value +// to store v and returns a pointer to it. +func Float64(v float64) *float64 { return &v } + +// Uint32 is a helper routine that allocates a new uint32 value +// to store v and returns a pointer to it. +func Uint32(v uint32) *uint32 { return &v } + +// Uint64 is a helper routine that allocates a new uint64 value +// to store v and returns a pointer to it. +func Uint64(v uint64) *uint64 { return &v } + +// String is a helper routine that allocates a new string value +// to store v and returns a pointer to it. +func String(v string) *string { return &v } | 
