Documentation update (#19)

* Release 1.0.1 (#16)

* Using the ClientOptions provided at App initialization to create the … (#12)

* Using the ClientOptions provided at App initialization to create the HTTPClient in auth package.

* Fixed context import

* Updated test case

* Fixing a test failure; Calling transport.NewHTTPClient() only when ctx and opts are available to avoid an unnecessary default credentials lookup.

* Passing a non-nil context to AuthConfig during testing; Replacing Print+Exit calls with log.Fatal() (#13)

* Bumped version to 1.0.1 (#15)

* Removed unused package variable; Updated godocs

Author: hiranya911

auth/auth_test.go

@@ -33,7 +33,6 @@ import (
 	"firebase.google.com/go/internal"
 )
 
-var creds *google.DefaultCredentials
 var client *Client
 var testIDToken string
 
@@ -255,7 +254,7 @@ func TestVerifyIDTokenError(t *testing.T) {
 }
 
 func TestNoProjectID(t *testing.T) {
-	c, err := NewClient(&internal.AuthConfig{Ctx: context.Background(), Creds: creds})
+	c, err := NewClient(&internal.AuthConfig{Ctx: context.Background()})
 	if err != nil {
 		t.Fatal(err)
 	}
@@ -287,6 +286,9 @@ func TestCertificateRequestError(t *testing.T) {
 	}
 }
 
+// aeKeySource provides access to the public keys associated with App Engine apps. This
+// is used in tests to verify custom tokens and mock ID tokens when they are signed with
+// App Engine private keys.
 type aeKeySource struct {
 	keys []*publicKey
 }

auth/crypto.go

@@ -37,11 +37,13 @@ import (
 	"google.golang.org/api/transport"
 )
 
+// publicKey represents a parsed RSA public key along with its unique key ID.
 type publicKey struct {
 	Kid string
 	Key *rsa.PublicKey
 }
 
+// clock is used to query the current local time.
 type clock interface {
 	Now() time.Time
 }
@@ -60,6 +62,8 @@ func (m *mockClock) Now() time.Time {
 	return m.now
 }
 
+// keySource is used to obtain a set of public keys, which can be used to verify cryptographic
+// signatures.
 type keySource interface {
 	Keys() ([]*publicKey, error)
 }