Go Text

Этот репозиторий содержит дополнительные пакеты Go для обработки текста, многие из которых связаны с Unicode.

Версии CLDR

Важно, чтобы версия Unicode, используемая в x/text, совпадала с версией, используемой вашим компилятором Go. Репозиторий x/text поддерживает несколько версий Unicode и подбирает версию Unicode в соответствии с версией компилятора Go. На данный момент это поддерживается для компиляторов Go начиная с версии 1.7.

Участие в разработке

Чтобы отправить изменения в этот репозиторий, см. http://go.dev/doc/contribute.

Git-репозиторий: https://go.googlesource.com/text.

Чтобы сгенерировать таблицы в этом репозитории (кроме таблиц кодировок), выполните go generate из этого каталога. По умолчанию таблицы генерируются для версии Unicode из core и версии CLDR, определённой в golang.org/x/text/unicode/cldr.

Побочным эффектом выполнения go generate будет создание подкаталога DATA в этом каталоге, в котором хранятся все файлы, используемые в качестве источника для генерации таблиц. Этот каталог также будет служить кэшем.

Тестирование

Выполните

go test ./...

из этого каталога, чтобы запустить все тесты. Добавьте флаг "-tags icu", чтобы также запустить тесты на соответствие ICU (если доступно). Для этого на вашей системе должна быть установлена соответствующая версия ICU.

TODO:

• обновление файлов без указания версии.

Генерация таблиц

Чтобы сгенерировать таблицы в этом репозитории (кроме таблиц кодировок), выполните go generate из этого каталога. По умолчанию таблицы генерируются для версии Unicode из core и версии CLDR, определённой в golang.org/x/text/unicode/cldr.

Побочным эффектом выполнения go generate будет создание подкаталога DATA в этом каталоге, в котором хранятся все файлы, используемые в качестве источника для генерации таблиц. Этот каталог также будет служить кэшем.

Версии

Чтобы обновить версию Unicode, выполните

UNICODE_VERSION=x.x.x go generate

где x.x.x должна соответствовать каталогу в https://www.unicode.org/Public/. Если эта версия новее, чем версия в core, она также обновит соответствующие пакеты там. Пакет idna в x/net будет обновляться всегда.

Чтобы обновить версию CLDR, выполните

CLDR_VERSION=version go generate

где version должна соответствовать каталогу в https://www.unicode.org/Public/cldr/.

Обратите внимание, что код со временем адаптируется к изменениям в данных, и обратная совместимость не поддерживается. Поэтому обновление до другой версии может не работать.

Файлы в DATA/{iana|icu|w3|whatwg} в настоящее время не имеют версий.

Сообщение о проблемах

Основной трекер проблем для репозитория text находится по адресу https://go.dev/issues. Добавьте префикс "x/text:" в теме вашего обращения, чтобы его было легко найти.