50 lines
1.9 KiB
Go
50 lines
1.9 KiB
Go
|
// Copyright 2014 Google Inc. All Rights Reserved.
|
||
|
|
//
|
||
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
||
|
|
// you may not use this file except in compliance with the License.
|
||
|
|
// You may obtain a copy of the License at
|
||
|
|
//
|
||
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
||
|
|
//
|
||
|
|
// Unless required by applicable law or agreed to in writing, software
|
||
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
||
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
|
|
// See the License for the specific language governing permissions and
|
||
|
|
// limitations under the License.
|
||
|
|
|
||
|
|
// Package cloud contains Google Cloud Platform APIs related types
|
||
|
|
// and common functions.
|
||
|
|
package cloud // import "google.golang.org/cloud"
|
||
|
|
|
||
|
|
import (
|
||
|
|
"net/http"
|
||
|
|
|
||
|
|
"golang.org/x/net/context"
|
||
|
|
"google.golang.org/cloud/internal"
|
||
|
|
)
|
||
|
|
|
||
|
|
// NewContext returns a new context that uses the provided http.Client.
|
||
|
|
// Provided http.Client is responsible to authorize and authenticate
|
||
|
|
// the requests made to the Google Cloud APIs.
|
||
|
|
// It mutates the client's original Transport to append the cloud
|
||
|
|
// package's user-agent to the outgoing requests.
|
||
|
|
// You can obtain the project ID from the Google Developers Console,
|
||
|
|
// https://console.developers.google.com.
|
||
|
|
func NewContext(projID string, c *http.Client) context.Context {
|
||
|
|
if c == nil {
|
||
|
|
panic("invalid nil *http.Client passed to NewContext")
|
||
|
|
}
|
||
|
|
return WithContext(context.Background(), projID, c)
|
||
|
|
}
|
||
|
|
|
||
|
|
// WithContext returns a new context in a similar way NewContext does,
|
||
|
|
// but initiates the new context with the specified parent.
|
||
|
|
func WithContext(parent context.Context, projID string, c *http.Client) context.Context {
|
||
|
|
// TODO(bradfitz): delete internal.Transport. It's too wrappy for what it does.
|
||
|
|
// Do User-Agent some other way.
|
||
|
|
if _, ok := c.Transport.(*internal.Transport); !ok {
|
||
|
|
c.Transport = &internal.Transport{Base: c.Transport}
|
||
|
|
}
|
||
|
|
return internal.WithContext(parent, projID, c)
|
||
|
|
}
|