prod

Documentation

Overview

Package prod provides an implementation of services/* which backs to AppEngine Classic (Go version <=1.11).

Index

• func Use(c context.Context, r *http.Request) context.Context
• Bugs

Functions

func Use

func Use(c context.Context, r *http.Request) context.Context

Use adds production implementations for all the gae services to the context. The implementations are all backed by the real appengine SDK functionality.

The services added are:

• github.com/luci-go/common/logging
• go.chromium.org/luci/gae/service/datastore
• go.chromium.org/luci/gae/service/info
• go.chromium.org/luci/gae/service/mail
• go.chromium.org/luci/gae/service/memcache
• go.chromium.org/luci/gae/service/module
• go.chromium.org/luci/gae/service/taskqueue
• go.chromium.org/luci/gae/service/urlfetch
• go.chromium.org/luci/gae/service/user

These can be retrieved with the <service>.Get functions.

It is important to note that this DOES NOT install the AppEngine SDK into the supplied Context. In general, using the raw AppEngine SDK to access a service that is covered by luci/gae is dangerous, leading to a number of potential pitfalls including inconsistent transaction management and data corruption.

Users who wish to access the raw AppEngine SDK must derive their own AppEngine Context at their own risk.

Notes

Bugs

• *datastore.Key objects have their AppID dropped when this package

  converts them internally to use with the underlying datastore. In
  practice this shouldn't be much of an issue, since you normally
  have no control over the AppID field of a Key anyway (aside from
  deserializing one directly from a proto).