project

Documentation

Overview

Package project defines global project helpers.

Index

• Constants
• Variables
• func AllDigits(val string) bool
• func CanonicalPhoneNumber(phone string, defaultRegion string) (string, error)
• func DefaultHTTPTransport() *http.Transport
• func DevMode() bool
• func ErrorsToStrings(errs []error) []string
• func RandomBase64String(length int) (string, error)
• func RandomBytes(length int) ([]byte, error)
• func RandomHexString(length int) (string, error)
• func Root(more ...string) string
• func TestContext(tb testing.TB) context.Context
• func TestLogger(tb testing.TB) *zap.SugaredLogger
• func TestTimeout() time.Duration
• func TrimSpace(s string) string
• func TrimSpaceAndNonPrintable(s string) string
• func TruncateUTCHour(t time.Time) time.Time

Constants

const (
	// RFC3339Date formats time as RFC3339 but without a time component (e.g.
	// 2020-11-24 for November 24, 20202).
	RFC3339Date = "2006-01-02"

	// RFC3339Squish is the RFC3339 datetime but all dashes and timezone
	// indicators are removed. This is useful for filenames.
	RFC3339Squish = "20060102150405"
)

const (
	// PasswordSentinel is the password string inserted into forms.
	PasswordSentinel = "very-nice-try-maybe-next-time"
)

const StatsDisplayDays = 90

StatsDisplayDays is the number of days for which to display statistics. This is separate from stats retention, which is controlled by the cleanup job.

const TestPhoneNumber = "+18558361987"

TestPhoneNumber is a test phone number to use for tests. It's a "real" phone number (Google's support phone number), but none of the tests actually send SMS.

Variables

var DebugGoogleCloudResponses, _ = strconv.ParseBool(os.Getenv("DEBUG_GOOGLE_CLOUD_RESPONSES"))

DebugGoogleCloudResponses controls whether HTTP requests should request GFE debug headers. This should be off by default as it greatly increases the size of response payloads.

var SkipE2ESMS, _ = strconv.ParseBool(os.Getenv("E2E_SKIP_SMS"))

SkipE2ESMS controls whether the e2e runners use SMS.

Functions

func AllDigits

func AllDigits(val string) bool

AllDigits returns true if all runes of a string are digits.

func CanonicalPhoneNumber

func CanonicalPhoneNumber(phone string, defaultRegion string) (string, error)

CanonicalPhoneNumber returns the E.164 formatted phone number.

func DefaultHTTPTransport

func DefaultHTTPTransport() *http.Transport

DefaultHTTPTransport returns a clean, non-globally-modifiable HTTP transport with similar defaults as http.DefaultTransport.

func DevMode

func DevMode() bool

DevMode indicates whether the project is running in development mode.

func ErrorsToStrings

func ErrorsToStrings(errs []error) []string

ErrorsToStrings converts a list of errors to a list of strings of those error's Error() value, excluding any nil errors.

func RandomBase64String

func RandomBase64String(length int) (string, error)

RandomBase64String encodes a random base64 string of a given length.

func RandomBytes

func RandomBytes(length int) ([]byte, error)

RandomBytes returns a byte slice of random values of the given length.

func RandomHexString

func RandomHexString(length int) (string, error)

RandomHexString generates a random string of the provided length.

func Root

func Root(more ...string) string

Root returns the filepath to the root of this project.

func TestContext

func TestContext(tb testing.TB) context.Context

TestContext returns a context with test values pre-populated.

func TestLogger

func TestLogger(tb testing.TB) *zap.SugaredLogger

TestLogger returns a logger configured for test. See the following link for more information:

https://pkg.go.dev/go.uber.org/zap/zaptest

func TestTimeout

func TestTimeout() time.Duration

TestTimeout controls the individual test timeout, primarily used on a context for chromedp tests. By default, it's 1min, but it can be controlled with the TEST_TIMEOUT environment variable.

func TrimSpace

func TrimSpace(s string) string

TrimSpace trims space and "zero-width no-break space"

func TrimSpaceAndNonPrintable

func TrimSpaceAndNonPrintable(s string) string

TrimSpaceAndNonPrintable trims spaces and non-printable chars from the beginning and end of a string.

func TruncateUTCHour

func TruncateUTCHour(t time.Time) time.Time

TruncateUTCHour returns a new time value that is truncated to the hour. The resulting time be in UTC and will have no minutes, seconds, or nanoseconds.