CLDR Tools
About this page
This page is designed for general consumers of CLDR. Members of the CLDR-TC doing development on CLDR itself, or other curious parties, should see New CLDR Developers and the CLDR Development pages instead.
Obtaining CLDR Tools
You can either obtain CLDR tools by 1. downloading the pre-built cldr-tools.jar from the CLDR Releases/Downloads page, or 2. checking out the CLDR source tree as per the CLDR Repository Access page.
Prerequisites
Most of the CLDR tooling is written in Java. The Java JDK version 1.8 or newer is required
Building from Source
Using a pre-built cldr-code.jar
Obtain a list of available tools
To verify your build of the CLDR tools, run the following command. It will print out a list of installed tools.
Note: Here and below, replace "cldr-code.jar" with the full path to the cldr-code.jar.
Within a CLDR source build, the .jar will have the location cldr/tools/cldr-code/target/cldr-code.jar
java -jar cldr-code.jar
Adding the -l option will list otherwise-undocumented or hidden tools.
Running a specific tool
A tool is run by entering its alias name or full package name after "cldr.jar", followed by any other arguments or options.
The following two command lines are identical:
java -jar cldr-code.jar validate path/to/somefile.xml
java -jar cldr-code.jar org.unicode.cldr.util.XMLValidator path/to/somefile.xml
Tool environment settings
Many of the tools need to know where the CLDR data is located. This is accomplished by setting the CLDR_DIR variable. For example, if you have your CLDR data in /somewhere/cldr you can run the ConsoleCheckCLDR against that data with this command:
java -DCLDR_DIR=/somewhere/cldr -jar cldr-code.jar check
If you run out of memory (which might happen with CLDR!), you might need to prepend -Xmx or other options. See your JDK documentation.
java -Xmx700M -DCLDR_DIR=/somewhere/cldr -jar cldr-code.jar ...
Tool Help
Many tools support the "-h" or "-?" options to display full help.
Try adding these options if you are unsure of how to use a tool.
Specific Tools
CLDR has a lot of tools. See the list of subpages below for specific documentation. If a tool is not documented here, you might try the CLDR Development Site page or else file a bug.
Developers: Document your tool!