ires 0.1.3 → 0.1.4

data/ext/vendor/golang.org/x/text/language/testdata/GoLocaleMatcherTest.txt

@@ -0,0 +1,226 @@
+# basics
+fr, en-GB, en ; 	en-GB ; 	en-GB
+fr, en-GB, en ; 	en-US ; 	en
+fr, en-GB, en ; 	fr-FR ; 	fr
+fr, en-GB, en ; 	ja-JP ; 	fr
+
+# script fallbacks
+zh-CN, zh-TW, iw ; 	zh-Hant ; 	zh-TW
+zh-CN, zh-TW, iw ; 	zh ; 	zh-CN
+zh-CN, zh-TW, iw ; 	zh-Hans-CN ; 	zh-CN
+zh-CN, zh-TW, iw ; 	zh-Hant-HK ; 	zh-TW
+zh-CN, zh-TW, iw ; 	he-IT ; 	iw ; iw
+
+# language-specific script fallbacks 1
+en, sr, nl ; 	sr-Latn ; 	sr
+en, sr, nl ; 	sh ; 	sr   # different script, but seems okay and is as CLDR suggests
+en, sr, nl ; 	hr ; 	en
+en, sr, nl ; 	bs ; 	en
+en, sr, nl ; 	nl-Cyrl ; 	sr
+
+# language-specific script fallbacks 2
+en, sh ; 	sr ; 	sh
+en, sh ; 	sr-Cyrl ; 	sh
+en, sh ; 	hr ; 	sh
+
+# don't match hr to sr-Latn
+en, sr-Latn ; 	hr ; 	en
+
+# both deprecated and not
+fil, tl, iw, he ; 	he-IT ; 	he
+fil, tl, iw, he ; 	he ; 	he
+fil, tl, iw, he ; 	iw ; 	iw
+fil, tl, iw, he ; 	fil-IT ; 	fil
+fil, tl, iw, he ; 	fil ; 	fil
+fil, tl, iw, he ; 	tl ; 	tl
+
+# nearby languages
+en, fil, ro, nn ; 	tl ; 	fil
+en, fil, ro, nn ; 	mo ; 	ro
+en, fil, ro, nn ; 	nb ; 	nn
+en, fil, ro, nn ; 	ja ; 	en
+
+# nearby languages: Nynorsk to Bokmål
+en, nb ; 	nn ; 	nb
+
+# nearby languages: Danish does not match nn
+en, nn ; 	da ; 	en
+
+# nearby languages: Danish matches no
+en, no ; 	da ; 	no
+
+# nearby languages: Danish matches nb
+en, nb ; 	da ; 	nb
+
+# prefer matching languages over language variants.
+nn, en-GB ; 	no, en-US ; 	en-GB
+nn, en-GB ; 	nb, en-US ; 	en-GB
+
+# deprecated version is closer than same language with other differences
+nl, he, en-GB ; 	iw, en-US ; 	he
+
+# macro equivalent is closer than same language with other differences
+nl, zh, en-GB, no ; 	cmn, en-US ; 	zh
+nl, zh, en-GB, no ; 	nb, en-US ; 	no
+
+# legacy equivalent is closer than same language with other differences
+nl, fil, en-GB ; 	tl, en-US ; 	fil
+
+# distinguish near equivalents
+en, ro, mo, ro-MD ; 	ro ; 	ro
+en, ro, mo, ro-MD ; 	mo ; 	mo
+en, ro, mo, ro-MD ; 	ro-MD ; 	ro-MD
+
+# maximization of legacy
+sr-Cyrl, sr-Latn, ro, ro-MD ; 	sh ; 	sr-Latn
+sr-Cyrl, sr-Latn, ro, ro-MD ; 	mo ; 	ro-MD
+
+# empty
+ ; 	fr ; 	und
+ ; 	en ; 	und
+
+# private use subtags
+fr, en-GB, x-bork, es-ES, es-419 ; 	x-piglatin ; 	fr
+fr, en-GB, x-bork, es-ES, es-419 ; 	x-bork ; 	x-bork
+
+# grandfathered codes
+fr, i-klingon, en-Latn-US ; 	en-GB-oed ; 	en-Latn-US
+fr, i-klingon, en-Latn-US ; 	i-klingon ; 	tlh
+
+
+# simple variant match
+fr, en-GB, ja, es-ES, es-MX ; 	de, en-US ; 	en-GB
+fr, en-GB, ja, es-ES, es-MX ; 	de, zh ; 	fr
+
+# best match for traditional Chinese
+fr, zh-Hans-CN, en-US ; 	zh-TW ; 	zh-Hans-CN
+fr, zh-Hans-CN, en-US ; 	zh-Hant ; 	zh-Hans-CN
+fr, zh-Hans-CN, en-US ; 	zh-TW, en ; 	en-US
+fr, zh-Hans-CN, en-US ; 	zh-Hant-CN, en ; 	en-US
+fr, zh-Hans-CN, en-US ; 	zh-Hans, en ; 	zh-Hans-CN
+
+# more specific script should win in case regions are identical
+af, af-Latn, af-Arab ; 	af ; 	af
+af, af-Latn, af-Arab ; 	af-ZA ; 	af
+af, af-Latn, af-Arab ; 	af-Latn-ZA ; 	af-Latn
+af, af-Latn, af-Arab ; 	af-Latn ; 	af-Latn
+
+# more specific region should win
+nl, nl-NL, nl-BE ; 	nl ; 	nl
+nl, nl-NL, nl-BE ; 	nl-Latn ; 	nl
+nl, nl-NL, nl-BE ; 	nl-Latn-NL ; 	nl-NL
+nl, nl-NL, nl-BE ; 	nl-NL ; 	nl-NL
+
+# region may replace matched if matched is enclosing
+es-419,es ; 	es-MX ; 	es-419 ; es-MX
+es-419,es ; 	es-SG ; 	es
+
+# more specific region wins over more specific script
+nl, nl-Latn, nl-NL, nl-BE ; 	nl ; 	nl
+nl, nl-Latn, nl-NL, nl-BE ; 	nl-Latn ; 	nl-Latn
+nl, nl-Latn, nl-NL, nl-BE ; 	nl-NL ; 	nl-NL
+nl, nl-Latn, nl-NL, nl-BE ; 	nl-Latn-NL ; 	nl-NL
+
+# region distance Portuguese
+pt, pt-PT ; 	pt-ES ; 	pt-PT
+
+# if no preferred locale specified, pick top language, not regional
+en, fr, fr-CA, fr-CH ; 	fr-US ; 	fr #TODO: ; fr-u-rg-US
+
+# region distance German
+de-AT, de-DE, de-CH ; 	de ; 	de-DE
+
+# en-AU is closer to en-GB than to en (which is en-US)
+en, en-GB, es-ES, es-419 ; 	en-AU ; 	en-GB
+en, en-GB, es-ES, es-419 ; 	es-MX ; 	es-419 ; es-MX
+en, en-GB, es-ES, es-419 ; 	es-PT ; 	es-ES
+
+# undefined
+it, fr ; 	und ; 	it
+
+# und does not match en
+it, en ; 	und ; 	it
+
+# undefined in priority list
+it, und ; 	und ; 	und
+it, und ; 	en ; 	it
+
+# undefined
+it, fr, zh ; 	und-FR ; 	fr
+it, fr, zh ; 	und-CN ; 	zh
+it, fr, zh ; 	und-Hans ; 	zh
+it, fr, zh ; 	und-Hant ; 	zh
+it, fr, zh ; 	und-Latn ; 	it
+
+# match on maximized tag
+fr, en-GB, ja, es-ES, es-MX ; 	ja-JP, en-GB ; 	ja
+fr, en-GB, ja, es-ES, es-MX ; 	ja-Jpan-JP, en-GB ; 	ja
+
+# pick best maximized tag
+ja, ja-Jpan-US, ja-JP, en, ru ; 	ja-Jpan, ru ; 	ja
+ja, ja-Jpan-US, ja-JP, en, ru ; 	ja-JP, ru ; 	ja-JP
+ja, ja-Jpan-US, ja-JP, en, ru ; 	ja-US, ru ; 	ja-Jpan-US
+
+# termination: pick best maximized match
+ja, ja-Jpan, ja-JP, en, ru ; 	ja-Jpan-JP, ru ; 	ja-JP
+ja, ja-Jpan, ja-JP, en, ru ; 	ja-Jpan, ru ; 	ja-Jpan
+
+# same language over exact, but distinguish when user is explicit
+fr, en-GB, ja, es-ES, es-MX ; 	ja, de ; 	ja
+en, de, fr, ja ; 	de-CH, fr ; 	de # TODO: ; de-u-rg-CH
+en-GB, nl ; 	en, nl ; en-GB
+en-GB, nl ; 	en, nl, en-GB ; nl
+
+# parent relation preserved
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	en-150 ; 	en-GB
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	en-AU ; 	en-GB
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	en-BE ; 	en-GB
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	en-GG ; 	en-GB
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	en-GI ; 	en-GB
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	en-HK ; 	en-GB
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	en-IE ; 	en-GB
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	en-IM ; 	en-GB
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	en-IN ; 	en-GB
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	en-JE ; 	en-GB
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	en-MT ; 	en-GB
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	en-NZ ; 	en-GB
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	en-PK ; 	en-GB
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	en-SG ; 	en-GB
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	en-DE ; 	en-GB
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	en-MT ; 	en-GB
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	es-AR ; 	es-419 ; es-AR
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	es-BO ; 	es-419 ; es-BO
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	es-CL ; 	es-419 ; es-CL
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	es-CO ; 	es-419 ; es-CO
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	es-CR ; 	es-419 ; es-CR
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	es-CU ; 	es-419 ; es-CU
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	es-DO ; 	es-419 ; es-DO
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	es-EC ; 	es-419 ; es-EC
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	es-GT ; 	es-419 ; es-GT
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	es-HN ; 	es-419 ; es-HN
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	es-MX ; 	es-419 ; es-MX
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	es-NI ; 	es-419 ; es-NI
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	es-PA ; 	es-419 ; es-PA
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	es-PE ; 	es-419 ; es-PE
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	es-PR ; 	es-419 ; es-PR
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	es-PT ; 	es
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	es-PY ; 	es-419 ; es-PY
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	es-SV ; 	es-419 ; es-SV
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	es-US ; 	es-419
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	es-UY ; 	es-419 ; es-UY
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	es-VE ; 	es-419 ; es-VE
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	pt-AO ; 	pt-PT
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	pt-CV ; 	pt-PT
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	pt-GW ; 	pt-PT
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	pt-MO ; 	pt-PT
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	pt-MZ ; 	pt-PT
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	pt-ST ; 	pt-PT
+en, en-US, en-GB, es, es-419, pt, pt-BR, pt-PT, zh,  zh-Hant, zh-Hant-HK ; 	pt-TL ; 	pt-PT
+
+# preserve extensions
+en, de, sl-nedis ; 	de-FR-u-co-phonebk ; 	de ; de-u-co-phonebk
+en, de, sl-nedis ; 	sl-nedis-u-cu-eur ; 	sl-nedis ; sl-nedis-u-cu-eur
+en, de, sl-nedis ; 	sl-u-cu-eur ; 	sl-nedis ; sl-nedis-u-cu-eur
+en, de, sl-nedis ; 	sl-HR-nedis-u-cu-eur ; 	sl-nedis ; sl-nedis-u-cu-eur
+en, de, sl-nedis ; 	de-t-m0-iso-i0-pinyin ; 	de ; de-t-m0-iso-i0-pinyin
+

data/ext/vendor/golang.org/x/text/message/catalog.go

@@ -0,0 +1,28 @@
+// 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 message
+
+// TODO: some types in this file will need to be made public at some time.
+// Documentation and method names will reflect this by using the exported name.
+
+import (
+	"golang.org/x/text/language"
+	"golang.org/x/text/message/catalog"
+)
+
+// DefaultCatalog is used by SetString.
+var DefaultCatalog *catalog.Catalog = defaultCatalog
+
+var defaultCatalog = catalog.New()
+
+// SetString calls SetString on the initial default Catalog.
+func SetString(tag language.Tag, key string, msg string) error {
+	return defaultCatalog.SetString(tag, key, msg)
+}
+
+// Set calls Set on the initial default Catalog.
+func Set(tag language.Tag, key string, msg ...catalog.Message) error {
+	return defaultCatalog.Set(tag, key, msg...)
+}

data/ext/vendor/golang.org/x/text/message/catalog/catalog.go

@@ -0,0 +1,292 @@
+// Copyright 2017 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 catalog defines collections of translated format strings.
+//
+// This package mostly defines types for populating catalogs with messages. The
+// catmsg package contains further definitions for creating custom message and
+// dictionary types as well as packages that use Catalogs.
+//
+// Package catalog defines various interfaces: Dictionary, Loader, and Message.
+// A Dictionary maintains a set of translations of format strings for a single
+// language. The Loader interface defines a source of dictionaries. A
+// translation of a format string is represented by a Message.
+//
+//
+// Catalogs
+//
+// A Catalog defines a programmatic interface for setting message translations.
+// It maintains a set of per-language dictionaries with translations for a set
+// of keys. For message translation to function properly, a translation should
+// be defined for each key for each supported language. A dictionary may be
+// underspecified, though, if there is a parent language that already defines
+// the key. For example, a Dictionary for "en-GB" could leave out entries that
+// are identical to those in a dictionary for "en".
+//
+//
+// Messages
+//
+// A Message is a format string which varies on the value of substitution
+// variables. For instance, to indicate the number of results one could want "no
+// results" if there are none, "1 result" if there is 1, and "%d results" for
+// any other number. Catalog is agnostic to the kind of format strings that are
+// used: for instance, messages can follow either the printf-style substitution
+// from package fmt or use templates.
+//
+// A Message does not substitute arguments in the format string. This job is
+// reserved for packages that render strings, such as message, that use Catalogs
+// to selected string. This separation of concerns allows Catalog to be used to
+// store any kind of formatting strings.
+//
+//
+// Selecting messages based on linguistic features of substitution arguments
+//
+// Messages may vary based on any linguistic features of the argument values.
+// The most common one is plural form, but others exist.
+//
+// Selection messages are provided in packages that provide support for a
+// specific linguistic feature. The following snippet uses plural.Select:
+//
+//   catalog.Set(language.English, "You are %d minute(s) late.",
+//       plural.Select(1,
+//           "one", "You are 1 minute late.",
+//           "other", "You are %d minutes late."))
+//
+// In this example, a message is stored in the Catalog where one of two messages
+// is selected based on the first argument, a number. The first message is
+// selected if the argument is singular (identified by the selector "one") and
+// the second message is selected in all other cases. The selectors are defined
+// by the plural rules defined in CLDR. The selector "other" is special and will
+// always match. Each language always defines one of the linguistic categories
+// to be "other." For English, singular is "one" and plural is "other".
+//
+// Selects can be nested. This allows selecting sentences based on features of
+// multiple arguments or multiple linguistic properties of a single argument.
+//
+//
+// String interpolation
+//
+// There is often a lot of commonality between the possible variants of a
+// message. For instance, in the example above the word "minute" varies based on
+// the plural catogory of the argument, but the rest of the sentence is
+// identical. Using interpolation the above message can be rewritten as:
+//
+//   catalog.Set(language.English, "You are %d minute(s) late.",
+//       catalog.Var("minutes",
+//           plural.Select(1, "one", "minute", "other", "minutes")),
+//       catalog.String("You are %[1]d ${minutes} late."))
+//
+// Var is defined to return the variable name if the message does not yield a
+// match. This allows us to further simplify this snippet to
+//
+//   catalog.Set(language.English, "You are %d minute(s) late.",
+//       catalog.Var("minutes", plural.Select(1, "one", "minute")),
+//       catalog.String("You are %d ${minutes} late."))
+//
+// Overall this is still only a minor improvement, but things can get a lot more
+// unwieldy if more than one linguistic feature is used to determine a message
+// variant. Consider the following example:
+//
+//   // argument 1: list of hosts, argument 2: list of guests
+//   catalog.Set(language.English, "%[1]v invite(s) %[2]v to their party.",
+//     catalog.Var("their",
+//         plural.Select(1,
+//             "one", gender.Select(1, "female", "her", "other", "his"))),
+//     catalog.Var("invites", plural.Select(1, "one", "invite"))
+//     catalog.String("%[1]v ${invites} %[2]v to ${their} party.")),
+//
+// Without variable substitution, this would have to be written as
+//
+//   // argument 1: list of hosts, argument 2: list of guests
+//   catalog.Set(language.English, "%[1]v invite(s) %[2]v to their party.",
+//     plural.Select(1,
+//         "one", gender.Select(1,
+//             "female", "%[1]v invites %[2]v to her party."
+//             "other", "%[1]v invites %[2]v to his party."),
+//         "other", "%[1]v invites %[2]v to their party.")
+//
+// Not necessarily shorter, but using variables there is less duplication and
+// the messages are more maintenance friendly. Moreover, languages may have up
+// to six plural forms. This makes the use of variables more welcome.
+//
+// Different messages using the same inflections can reuse variables by moving
+// them to macros. Using macros we can rewrite the message as:
+//
+//   // argument 1: list of hosts, argument 2: list of guests
+//   catalog.SetString(language.English, "%[1]v invite(s) %[2]v to their party.",
+//       "%[1]v ${invites(1)} %[2]v to ${their(1)} party.")
+//
+// Where the following macros were defined separately.
+//
+//   catalog.SetMacro(language.English, "invites", plural.Select(1, "one", "invite"))
+//   catalog.SetMacro(language.English, "their", plural.Select(1,
+//      "one", gender.Select(1, "female", "her", "other", "his"))),
+//
+// Placeholders use parentheses and the arguments to invoke a macro.
+//
+//
+// Looking up messages
+//
+// Message lookup using Catalogs is typically only done by specialized packages
+// and is not something the user should be concerned with. For instance, to
+// express the tardiness of a user using the related message we defined earlier,
+// the user may use the package message like so:
+//
+//   p := message.NewPrinter(language.English)
+//   p.Printf("You are %d minute(s) late.", 5)
+//
+// Which would print:
+//   You are 5 minutes late.
+//
+//
+// This package is UNDER CONSTRUCTION and its API may change.
+package catalog // import "golang.org/x/text/message/catalog"
+
+// TODO:
+// Some way to freeze a catalog.
+// - Locking on each lockup turns out to be about 50% of the total running time
+//   for some of the benchmarks in the message package.
+// Consider these:
+// - Sequence type to support sequences in user-defined messages.
+// - Garbage collection: Remove dictionaries that can no longer be reached
+//   as other dictionaries have been added that cover all possible keys.
+
+import (
+	"errors"
+	"fmt"
+
+	"golang.org/x/text/internal/catmsg"
+	"golang.org/x/text/language"
+)
+
+// A Catalog holds translations for messages for supported languages.
+type Catalog struct {
+	options
+
+	index  store
+	macros store
+}
+
+type options struct{}
+
+// An Option configures Catalog behavior.
+type Option func(*options)
+
+// TODO:
+// // Catalogs specifies one or more sources for a Catalog.
+// // Lookups are in order.
+// // This can be changed inserting a Catalog used for setting, which implements
+// // Loader, used for setting in the chain.
+// func Catalogs(d ...Loader) Option {
+// 	return nil
+// }
+//
+// func Delims(start, end string) Option {}
+//
+// func Dict(tag language.Tag, d ...Dictionary) Option
+
+// New returns a new Catalog.
+func New(opts ...Option) *Catalog {
+	c := &Catalog{}
+	for _, o := range opts {
+		o(&c.options)
+	}
+	return c
+}
+
+// Languages returns all languages for which the Catalog contains variants.
+func (c *Catalog) Languages() []language.Tag {
+	return c.index.languages()
+}
+
+// SetString is shorthand for Set(tag, key, String(msg)).
+func (c *Catalog) SetString(tag language.Tag, key string, msg string) error {
+	return c.set(tag, key, &c.index, String(msg))
+}
+
+// Set sets the translation for the given language and key.
+//
+// When evaluation this message, the first Message in the sequence to msgs to
+// evaluate to a string will be the message returned.
+func (c *Catalog) Set(tag language.Tag, key string, msg ...Message) error {
+	return c.set(tag, key, &c.index, msg...)
+}
+
+// SetMacro defines a Message that may be substituted in another message.
+// The arguments to a macro Message are passed as arguments in the
+// placeholder the form "${foo(arg1, arg2)}".
+func (c *Catalog) SetMacro(tag language.Tag, name string, msg ...Message) error {
+	return c.set(tag, name, &c.macros, msg...)
+}
+
+// ErrNotFound indicates there was no message for the given key.
+var ErrNotFound = errors.New("catalog: message not found")
+
+// A Message holds a collection of translations for the same phrase that may
+// vary based on the values of substitution arguments.
+type Message interface {
+	catmsg.Message
+}
+
+// String specifies a plain message string. It can be used as fallback if no
+// other strings match or as a simple standalone message.
+//
+// It is an error to pass more than one String in a message sequence.
+func String(name string) Message {
+	return catmsg.String(name)
+}
+
+// Var sets a variable that may be substituted in formatting patterns using
+// named substitution of the form "${name}". The name argument is used as a
+// fallback if the statements do not produce a match. The statement sequence may
+// not contain any Var calls.
+//
+// The name passed to a Var must be unique within message sequence.
+func Var(name string, msg ...Message) Message {
+	return &catmsg.Var{Name: name, Message: firstInSequence(msg)}
+}
+
+// firstInSequence is a message type that prints the first message in the
+// sequence that resolves to a match for the given substitution arguments.
+type firstInSequence []Message
+
+func (s firstInSequence) Compile(e *catmsg.Encoder) error {
+	e.EncodeMessageType(catmsg.First)
+	err := catmsg.ErrIncomplete
+	for i, m := range s {
+		if err == nil {
+			return fmt.Errorf("catalog: message argument %d is complete and blocks subsequent messages", i-1)
+		}
+		err = e.EncodeMessage(m)
+	}
+	return err
+}
+
+// Context returns a Context for formatting messages.
+// Only one Message may be formatted per context at any given time.
+func (c *Catalog) Context(tag language.Tag, r catmsg.Renderer) *Context {
+	return &Context{
+		cat: c,
+		tag: tag,
+		dec: catmsg.NewDecoder(tag, r, &dict{&c.macros, tag}),
+	}
+}
+
+// A Context is used for evaluating Messages.
+// Only one Message may be formatted per context at any given time.
+type Context struct {
+	cat *Catalog
+	tag language.Tag
+	dec *catmsg.Decoder
+}
+
+// Execute looks up and executes the message with the given key.
+// It returns ErrNotFound if no message could be found in the index.
+func (c *Context) Execute(key string) error {
+	data, ok := c.cat.index.lookup(c.tag, key)
+	if !ok {
+		return ErrNotFound
+	}
+	return c.dec.Execute(data)
+}