bs-react-intl-extractor

Extracts messages for localization from ReScript or Reason source files. This assumes that you are using the bs-react-intl 2.x bindings for react-intl.

Installation

Binaries for macOS, Linux and Windows can be installed via npm or yarn. For global installation, run

1npm install -g bs-react-intl-extractor-bin

Alternatively, the binaries are also available for download on the releases page.

Usage

1bs-react-intl-extractor [--allow-duplicates] [path...]

where path is a ReScript (*.res) or Reason (*.re) source file or a directory containing such source files. Multiple files/directories may be specified.

The --allow-duplicates option allows messages with identical id props if the defaultMessage props are identical as well.

Output

The output (a JSON array of all extracted messages sorted by id) is written to stdout. It will look like this:

1[
2  {
3    "id": "message.hello",
4    "defaultMessage": "Hello"
5  },
6  {
7    "id": "message.world",
8    "defaultMessage": "World"
9  },
10  {
11    "id": "some.message.id",
12    "defaultMessage": "Some message"
13  }
14]

Message Definition (ReScript Syntax)

Formatted messages may be defined in your source files in one of the following ways:

1. inline in FormattedMessage:

1<ReactIntl.FormattedMessage id="some.message.id" defaultMessage="Some message" />

or

1open ReactIntl;
2...
3<FormattedMessage id="some.message.id" defaultMessage="Some message" />

2. within a module with the [@intl.messages] attribute:

1open ReactIntl
2
3module Msg = {
4  @@intl.messages
5
6  let hello = {id: "message.hello", defaultMessage: "Hello"}
7  let world = {id: "message.world", defaultMessage: "World"}
8}

You also can pass descriptions to the records with:

1let foo = @intl.description("Hello description") {id: "message.hello", defaultMessage: "Hello"}

Message Definition (Reason Syntax)

Formatted messages may be defined in your source files in one of the following ways:

1. inline in FormattedMessage:

1<ReactIntl.FormattedMessage id="some.message.id" defaultMessage="Some message" />

or

1open ReactIntl;
2...
3<FormattedMessage id="some.message.id" defaultMessage="Some message" />

2. within a module with the [@intl.messages] attribute:

1open ReactIntl;
2
3module Msg = {
4  [@intl.messages];
5
6  let hello = {id: "message.hello", defaultMessage: "Hello"};
7  let world = {id: "message.world", defaultMessage: "World"};
8};

You also can pass descriptions to the records with:

1let foo = [@intl.description "Hello description"] {id: "message.hello", defaultMessage: "Hello"};

Building and Testing

The ReScript parser is included as a git submodule. Therefore, after checking out the sources, first run

git submodule update --init --recursive

Install esy as follows:

% npm install -g esy

Then you can install the project dependencies using:

% esy install

Then build the project dependencies along with the project itself:

% esy build

Run the compiled executable:

% esy x Extract.exe

Run the tests:

% esy test