milo: buildbucket builer view

appengine/gaeauth/client/client.go

 // Copyright 2015 The LUCI Authors. All rights reserved.
 // Use of this source code is governed under the Apache License, Version 2.0
 // that can be found in the LICENSE file.
 
 // Package client implements OAuth2 authentication for outbound connections
 // from Appengine using service account keys. It supports native GAE service
 // account credentials and external ones provided via JSON keys. It caches
 // access tokens in memcache.
 package client
 
@@ skipping 51 matching lines @@
                 opts.ServiceAccountJSON = serviceAccountJSON
         } else {
                 opts.Method = auth.CustomMethod
                 opts.CustomTokenMinter = tokenMinter{c}
         }
         return auth.NewAuthenticator(c, auth.SilentLogin, opts), nil
 }
 
 // Transport returns http.RoundTripper that injects Authorization headers into
 // requests. It uses an authenticator returned by Authenticator.
+// If scopes is empty, uses auth.OAuthScopeEmail scope.
 func Transport(c context.Context, scopes []string, serviceAccountJSON []byte) (http.RoundTripper, error) {
         a, err := Authenticator(c, scopes, serviceAccountJSON)
         if err != nil {
                 return nil, err
         }
         return a.Transport()
 }
 
 // UseServiceAccountTransport injects authenticating transport into
 // context.Context. It can be extracted back via transport.Get(c). It will be
 // lazy-initialized on a first use.
+// If scopes is empty, uses auth.OAuthScopeEmail scope.
 func UseServiceAccountTransport(c context.Context, scopes []string, serviceAccountJSON []byte) context.Context {
         var cached http.RoundTripper
         var once sync.Once
         return transport.SetFactory(c, func(ic context.Context) http.RoundTripper {
                 once.Do(func() {
                         t, err := Transport(ic, scopes, serviceAccountJSON)
                         if err != nil {
                                 cached = failTransport{err}
                         } else {
                                 cached = t
@@ skipping 104 matching lines @@
         return errors.WrapTransient(err)
 }
 
 func (c tokenCache) Clear() error {
         err := memcache.Get(c.c).Delete(c.key)
         if err != nil && err != memcache.ErrCacheMiss {
                 return errors.WrapTransient(err)
         }
         return nil
 }