a685e3fc98
Vndr has a simpler configuration and allows pointing to forked packages. Additionally other docker projects are now using vndr making vendoring in distribution more consistent. Updates letsencrypt to use fork. No longer uses sub-vendored packages. Signed-off-by: Derek McGowan <derek@mcgstyle.net> (github: dmcgowan)
77 lines
2.6 KiB
Go
77 lines
2.6 KiB
Go
// Copyright 2011 Google Inc. All rights reserved.
|
|
// Use of this source code is governed by the Apache 2.0
|
|
// license that can be found in the LICENSE file.
|
|
|
|
// Package appengine provides basic functionality for Google App Engine.
|
|
//
|
|
// For more information on how to write Go apps for Google App Engine, see:
|
|
// https://cloud.google.com/appengine/docs/go/
|
|
package appengine // import "google.golang.org/appengine"
|
|
|
|
import (
|
|
"net/http"
|
|
|
|
"github.com/golang/protobuf/proto"
|
|
"golang.org/x/net/context"
|
|
|
|
"google.golang.org/appengine/internal"
|
|
)
|
|
|
|
// IsDevAppServer reports whether the App Engine app is running in the
|
|
// development App Server.
|
|
func IsDevAppServer() bool {
|
|
return internal.IsDevAppServer()
|
|
}
|
|
|
|
// NewContext returns a context for an in-flight HTTP request.
|
|
// This function is cheap.
|
|
func NewContext(req *http.Request) context.Context {
|
|
return WithContext(context.Background(), req)
|
|
}
|
|
|
|
// WithContext returns a copy of the parent context
|
|
// and associates it with an in-flight HTTP request.
|
|
// This function is cheap.
|
|
func WithContext(parent context.Context, req *http.Request) context.Context {
|
|
return internal.WithContext(parent, req)
|
|
}
|
|
|
|
// TODO(dsymonds): Add a Call function here? Otherwise other packages can't access internal.Call.
|
|
|
|
// BlobKey is a key for a blobstore blob.
|
|
//
|
|
// Conceptually, this type belongs in the blobstore package, but it lives in
|
|
// the appengine package to avoid a circular dependency: blobstore depends on
|
|
// datastore, and datastore needs to refer to the BlobKey type.
|
|
type BlobKey string
|
|
|
|
// GeoPoint represents a location as latitude/longitude in degrees.
|
|
type GeoPoint struct {
|
|
Lat, Lng float64
|
|
}
|
|
|
|
// Valid returns whether a GeoPoint is within [-90, 90] latitude and [-180, 180] longitude.
|
|
func (g GeoPoint) Valid() bool {
|
|
return -90 <= g.Lat && g.Lat <= 90 && -180 <= g.Lng && g.Lng <= 180
|
|
}
|
|
|
|
// APICallFunc defines a function type for handling an API call.
|
|
// See WithCallOverride.
|
|
type APICallFunc func(ctx context.Context, service, method string, in, out proto.Message) error
|
|
|
|
// WithAPICallFunc returns a copy of the parent context
|
|
// that will cause API calls to invoke f instead of their normal operation.
|
|
//
|
|
// This is intended for advanced users only.
|
|
func WithAPICallFunc(ctx context.Context, f APICallFunc) context.Context {
|
|
return internal.WithCallOverride(ctx, internal.CallOverrideFunc(f))
|
|
}
|
|
|
|
// APICall performs an API call.
|
|
//
|
|
// This is not intended for general use; it is exported for use in conjunction
|
|
// with WithAPICallFunc.
|
|
func APICall(ctx context.Context, service, method string, in, out proto.Message) error {
|
|
return internal.Call(ctx, service, method, in, out)
|
|
}
|