Repository files navigation

This repository holds supplementary Go packages for text processing,many involving Unicode.

It is important that the Unicode version used inx/text matches the one usedby your Go compiler. Thex/text repository supports multiple versions ofUnicode and will match the version of Unicode to that of the Go compiler. At themoment this is supported for Go compilers from version 1.7.

To submit changes to this repository, seehttp://go.dev/doc/contribute.

The git repository ishttps://go.googlesource.com/text.

To generate the tables in this repository (except for the encoding tables),run go generate from this directory. By default tables are generated for theUnicode version in core and the CLDR version defined ingolang.org/x/text/unicode/cldr.

Running go generate will as a side effect create a DATA subdirectory in thisdirectory, which holds all files that are used as a source for generating thetables. This directory will also serve as a cache.

Run

go test ./...

from this directory to run all tests. Add the "-tags icu" flag to also runICU conformance tests (if available). This requires that you have the correctICU version installed on your system.

TODO:

• updating unversioned source files.

To generate the tables in this repository (except for the encodingtables), rungo generate from this directory. By default tables aregenerated for the Unicode version in core and the CLDR version defined ingolang.org/x/text/unicode/cldr.

Running go generate will as a side effect create a DATA subdirectory in thisdirectory which holds all files that are used as a source for generating thetables. This directory will also serve as a cache.

To update a Unicode version run

UNICODE_VERSION=x.x.x go generate

wherex.x.x must correspond to a directory inhttps://www.unicode.org/Public/.If this version is newer than the version in core it will also update therelevant packages there. The idna package in x/net will always be updated.

To update a CLDR version run

CLDR_VERSION=version go generate

whereversion must correspond to a directory inhttps://www.unicode.org/Public/cldr/.

Note that the code gets adapted over time to changes in the data and thatbackwards compatibility is not maintained.So updating to a different version may not work.

The files in DATA/{iana|icu|w3|whatwg} are currently not versioned.

The main issue tracker for the text repository is located athttps://go.dev/issues. Prefix your issue with "x/text:" in thesubject line, so it is easy to find.