ires 0.1.3 → 0.1.4

data/ext/vendor/golang.org/x/text/currency/common.go

@@ -0,0 +1,66 @@
+// Code generated by running "go generate" in golang.org/x/text. DO NOT EDIT.
+
+package currency
+
+import (
+	"time"
+
+	"golang.org/x/text/language"
+)
+
+// This file contains code common to gen.go and the package code.
+
+const (
+	cashShift = 3
+	roundMask = 0x7
+
+	nonTenderBit = 0x8000
+)
+
+// currencyInfo contains information about a currency.
+// bits 0..2: index into roundings for standard rounding
+// bits 3..5: index into roundings for cash rounding
+type currencyInfo byte
+
+// roundingType defines the scale (number of fractional decimals) and increments
+// in terms of units of size 10^-scale. For example, for scale == 2 and
+// increment == 1, the currency is rounded to units of 0.01.
+type roundingType struct {
+	scale, increment uint8
+}
+
+// roundings contains rounding data for currencies. This struct is
+// created by hand as it is very unlikely to change much.
+var roundings = [...]roundingType{
+	{2, 1}, // default
+	{0, 1},
+	{1, 1},
+	{3, 1},
+	{4, 1},
+	{2, 5}, // cash rounding alternative
+}
+
+// regionToCode returns a 16-bit region code. Only two-letter codes are
+// supported. (Three-letter codes are not needed.)
+func regionToCode(r language.Region) uint16 {
+	if s := r.String(); len(s) == 2 {
+		return uint16(s[0])<<8 | uint16(s[1])
+	}
+	return 0
+}
+
+func toDate(t time.Time) uint32 {
+	y := t.Year()
+	if y == 1 {
+		return 0
+	}
+	date := uint32(y) << 4
+	date |= uint32(t.Month())
+	date <<= 5
+	date |= uint32(t.Day())
+	return date
+}
+
+func fromDate(date uint32) time.Time {
+	return time.Date(int(date>>9), time.Month((date>>5)&0xf), int(date&0x1f), 0, 0, 0, 0, time.UTC)
+}

data/ext/vendor/golang.org/x/text/currency/currency.go

@@ -0,0 +1,185 @@
+// Copyright 2015 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+//go:generate go run gen.go gen_common.go -output tables.go
+
+// Package currency contains currency-related functionality.
+//
+// NOTE: the formatting functionality is currently under development and may
+// change without notice.
+package currency // import "golang.org/x/text/currency"
+
+import (
+	"errors"
+	"sort"
+
+	"golang.org/x/text/internal/tag"
+	"golang.org/x/text/language"
+)
+
+// TODO:
+// - language-specific currency names.
+// - currency formatting.
+// - currency information per region
+// - register currency code (there are no private use area)
+
+// TODO: remove Currency type from package language.
+
+// Kind determines the rounding and rendering properties of a currency value.
+type Kind struct {
+	rounding rounding
+	// TODO: formatting type: standard, accounting. See CLDR.
+}
+
+type rounding byte
+
+const (
+	standard rounding = iota
+	cash
+)
+
+var (
+	// Standard defines standard rounding and formatting for currencies.
+	Standard Kind = Kind{rounding: standard}
+
+	// Cash defines rounding and formatting standards for cash transactions.
+	Cash Kind = Kind{rounding: cash}
+
+	// Accounting defines rounding and formatting standards for accounting.
+	Accounting Kind = Kind{rounding: standard}
+)
+
+// Rounding reports the rounding characteristics for the given currency, where
+// scale is the number of fractional decimals and increment is the number of
+// units in terms of 10^(-scale) to which to round to.
+func (k Kind) Rounding(cur Unit) (scale, increment int) {
+	info := currency.Elem(int(cur.index))[3]
+	switch k.rounding {
+	case standard:
+		info &= roundMask
+	case cash:
+		info >>= cashShift
+	}
+	return int(roundings[info].scale), int(roundings[info].increment)
+}
+
+// Unit is an ISO 4217 currency designator.
+type Unit struct {
+	index uint16
+}
+
+// String returns the ISO code of u.
+func (u Unit) String() string {
+	if u.index == 0 {
+		return "XXX"
+	}
+	return currency.Elem(int(u.index))[:3]
+}
+
+// Amount creates an Amount for the given currency unit and amount.
+func (u Unit) Amount(amount interface{}) Amount {
+	// TODO: verify amount is a supported number type
+	return Amount{amount: amount, currency: u}
+}
+
+var (
+	errSyntax = errors.New("currency: tag is not well-formed")
+	errValue  = errors.New("currency: tag is not a recognized currency")
+)
+
+// ParseISO parses a 3-letter ISO 4217 currency code. It returns an error if s
+// is not well-formed or not a recognized currency code.
+func ParseISO(s string) (Unit, error) {
+	var buf [4]byte // Take one byte more to detect oversize keys.
+	key := buf[:copy(buf[:], s)]
+	if !tag.FixCase("XXX", key) {
+		return Unit{}, errSyntax
+	}
+	if i := currency.Index(key); i >= 0 {
+		if i == xxx {
+			return Unit{}, nil
+		}
+		return Unit{uint16(i)}, nil
+	}
+	return Unit{}, errValue
+}
+
+// MustParseISO is like ParseISO, but panics if the given currency unit
+// cannot be parsed. It simplifies safe initialization of Unit values.
+func MustParseISO(s string) Unit {
+	c, err := ParseISO(s)
+	if err != nil {
+		panic(err)
+	}
+	return c
+}
+
+// FromRegion reports the currency unit that is currently legal tender in the
+// given region according to CLDR. It will return false if region currently does
+// not have a legal tender.
+func FromRegion(r language.Region) (currency Unit, ok bool) {
+	x := regionToCode(r)
+	i := sort.Search(len(regionToCurrency), func(i int) bool {
+		return regionToCurrency[i].region >= x
+	})
+	if i < len(regionToCurrency) && regionToCurrency[i].region == x {
+		return Unit{regionToCurrency[i].code}, true
+	}
+	return Unit{}, false
+}
+
+// FromTag reports the most likely currency for the given tag. It considers the
+// currency defined in the -u extension and infers the region if necessary.
+func FromTag(t language.Tag) (Unit, language.Confidence) {
+	if cur := t.TypeForKey("cu"); len(cur) == 3 {
+		c, _ := ParseISO(cur)
+		return c, language.Exact
+	}
+	r, conf := t.Region()
+	if cur, ok := FromRegion(r); ok {
+		return cur, conf
+	}
+	return Unit{}, language.No
+}
+
+var (
+	// Undefined and testing.
+	XXX Unit = Unit{}
+	XTS Unit = Unit{xts}
+
+	// G10 currencies https://en.wikipedia.org/wiki/G10_currencies.
+	USD Unit = Unit{usd}
+	EUR Unit = Unit{eur}
+	JPY Unit = Unit{jpy}
+	GBP Unit = Unit{gbp}
+	CHF Unit = Unit{chf}
+	AUD Unit = Unit{aud}
+	NZD Unit = Unit{nzd}
+	CAD Unit = Unit{cad}
+	SEK Unit = Unit{sek}
+	NOK Unit = Unit{nok}
+
+	// Additional common currencies as defined by CLDR.
+	BRL Unit = Unit{brl}
+	CNY Unit = Unit{cny}
+	DKK Unit = Unit{dkk}
+	INR Unit = Unit{inr}
+	RUB Unit = Unit{rub}
+	HKD Unit = Unit{hkd}
+	IDR Unit = Unit{idr}
+	KRW Unit = Unit{krw}
+	MXN Unit = Unit{mxn}
+	PLN Unit = Unit{pln}
+	SAR Unit = Unit{sar}
+	THB Unit = Unit{thb}
+	TRY Unit = Unit{try}
+	TWD Unit = Unit{twd}
+	ZAR Unit = Unit{zar}
+
+	// Precious metals.
+	XAG Unit = Unit{xag}
+	XAU Unit = Unit{xau}
+	XPT Unit = Unit{xpt}
+	XPD Unit = Unit{xpd}
+)

data/ext/vendor/golang.org/x/text/currency/currency_test.go

@@ -0,0 +1,171 @@
+// Copyright 2015 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package currency
+
+import (
+	"fmt"
+	"testing"
+
+	"golang.org/x/text/internal/testtext"
+	"golang.org/x/text/language"
+)
+
+var (
+	cup = MustParseISO("CUP")
+	czk = MustParseISO("CZK")
+	xcd = MustParseISO("XCD")
+	zwr = MustParseISO("ZWR")
+)
+
+func TestParseISO(t *testing.T) {
+	testCases := []struct {
+		in  string
+		out Unit
+		ok  bool
+	}{
+		{"USD", USD, true},
+		{"xxx", XXX, true},
+		{"xts", XTS, true},
+		{"XX", XXX, false},
+		{"XXXX", XXX, false},
+		{"", XXX, false},       // not well-formed
+		{"UUU", XXX, false},    // unknown
+		{"\u22A9", XXX, false}, // non-ASCII, printable
+
+		{"aaa", XXX, false},
+		{"zzz", XXX, false},
+		{"000", XXX, false},
+		{"999", XXX, false},
+		{"---", XXX, false},
+		{"\x00\x00\x00", XXX, false},
+		{"\xff\xff\xff", XXX, false},
+	}
+	for i, tc := range testCases {
+		if x, err := ParseISO(tc.in); x != tc.out || err == nil != tc.ok {
+			t.Errorf("%d:%s: was %s, %v; want %s, %v", i, tc.in, x, err == nil, tc.out, tc.ok)
+		}
+	}
+}
+
+func TestFromRegion(t *testing.T) {
+	testCases := []struct {
+		region   string
+		currency Unit
+		ok       bool
+	}{
+		{"NL", EUR, true},
+		{"BE", EUR, true},
+		{"AG", xcd, true},
+		{"CH", CHF, true},
+		{"CU", cup, true},   // first of multiple
+		{"DG", USD, true},   // does not have M49 code
+		{"150", XXX, false}, // implicit false
+		{"CP", XXX, false},  // explicit false in CLDR
+		{"CS", XXX, false},  // all expired
+		{"ZZ", XXX, false},  // none match
+	}
+	for _, tc := range testCases {
+		cur, ok := FromRegion(language.MustParseRegion(tc.region))
+		if cur != tc.currency || ok != tc.ok {
+			t.Errorf("%s: got %v, %v; want %v, %v", tc.region, cur, ok, tc.currency, tc.ok)
+		}
+	}
+}
+
+func TestFromTag(t *testing.T) {
+	testCases := []struct {
+		tag      string
+		currency Unit
+		conf     language.Confidence
+	}{
+		{"nl", EUR, language.Low},      // nl also spoken outside Euro land.
+		{"nl-BE", EUR, language.Exact}, // region is known
+		{"pt", BRL, language.Low},
+		{"en", USD, language.Low},
+		{"en-u-cu-eur", EUR, language.Exact},
+		{"tlh", XXX, language.No}, // Klingon has no country.
+		{"es-419", XXX, language.No},
+		{"und", USD, language.Low},
+	}
+	for _, tc := range testCases {
+		cur, conf := FromTag(language.MustParse(tc.tag))
+		if cur != tc.currency || conf != tc.conf {
+			t.Errorf("%s: got %v, %v; want %v, %v", tc.tag, cur, conf, tc.currency, tc.conf)
+		}
+	}
+}
+
+func TestTable(t *testing.T) {
+	for i := 4; i < len(currency); i += 4 {
+		if a, b := currency[i-4:i-1], currency[i:i+3]; a >= b {
+			t.Errorf("currency unordered at element %d: %s >= %s", i, a, b)
+		}
+	}
+	// First currency has index 1, last is numCurrencies.
+	if c := currency.Elem(1)[:3]; c != "ADP" {
+		t.Errorf("first was %c; want ADP", c)
+	}
+	if c := currency.Elem(numCurrencies)[:3]; c != "ZWR" {
+		t.Errorf("last was %c; want ZWR", c)
+	}
+}
+
+func TestKindRounding(t *testing.T) {
+	testCases := []struct {
+		kind  Kind
+		cur   Unit
+		scale int
+		inc   int
+	}{
+		{Standard, USD, 2, 1},
+		{Standard, CHF, 2, 1},
+		{Cash, CHF, 2, 5},
+		{Standard, TWD, 2, 1},
+		{Cash, TWD, 0, 1},
+		{Standard, czk, 2, 1},
+		{Cash, czk, 0, 1},
+		{Standard, zwr, 2, 1},
+		{Cash, zwr, 0, 1},
+		{Standard, KRW, 0, 1},
+		{Cash, KRW, 0, 1}, // Cash defaults to standard.
+	}
+	for i, tc := range testCases {
+		if scale, inc := tc.kind.Rounding(tc.cur); scale != tc.scale && inc != tc.inc {
+			t.Errorf("%d: got %d, %d; want %d, %d", i, scale, inc, tc.scale, tc.inc)
+		}
+	}
+}
+
+const body = `package main
+import (
+	"fmt"
+	"golang.org/x/text/currency"
+)
+func main() {
+	%s
+}
+`
+
+func TestLinking(t *testing.T) {
+	base := getSize(t, `fmt.Print(currency.CLDRVersion)`)
+	symbols := getSize(t, `fmt.Print(currency.Symbol(currency.USD))`)
+	if d := symbols - base; d < 2*1024 {
+		t.Errorf("size(symbols)-size(base) was %d; want > 2K", d)
+	}
+}
+
+func getSize(t *testing.T, main string) int {
+	size, err := testtext.CodeSize(fmt.Sprintf(body, main))
+	if err != nil {
+		t.Skipf("skipping link size test; binary size could not be determined: %v", err)
+	}
+	return size
+}
+
+func BenchmarkString(b *testing.B) {
+	for i := 0; i < b.N; i++ {
+		USD.String()
+	}
+}

data/ext/vendor/golang.org/x/text/currency/example_test.go

@@ -0,0 +1,27 @@
+// Copyright 2016 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package currency_test
+
+import (
+	"fmt"
+	"time"
+
+	"golang.org/x/text/currency"
+)
+
+func ExampleQuery() {
+	t1799, _ := time.Parse("2006-01-02", "1799-01-01")
+	for it := currency.Query(currency.Date(t1799)); it.Next(); {
+		from := ""
+		if t, ok := it.From(); ok {
+			from = t.Format("2006-01-01")
+		}
+		fmt.Printf("%v is used in %v since: %v\n", it.Unit(), it.Region(), from)
+	}
+	// Output:
+	// GBP is used in GB since: 1694-07-07
+	// GIP is used in GI since: 1713-01-01
+	// USD is used in US since: 1792-01-01
+}