## Introduction

Aigu processes Rails YAML localization files and generates a single JSON file
that can be imported into the Accent service. It can also process a JSON file
generated by Accent and convert it back to multiple YAML files.

## Installation

Add these lines to your application’s Gemfile as development dependancies:

```ruby
group :development do
  gem 'aigu'
end
```

## Usage

Aigu provides an executable named `aigu`.

### Exporting the JSON file for Accent

The `export` command looks for YAML localization files and generates a JSON
file. This file will then be compatible with Accent.

```bash
$ aigu export --locale=fr --input-directory=config/locales --output-file=my-project.json
```

#### Options

| Option            | Description                                                                                                               |
|-------------------|---------------------------------------------------------------------------------------------------------------------------|
| `locale`          | The locale used to find localization files. Files that match `*.<locale>.yml` in the input directory will be processed. |
| `input-directory` | The directory used to find localization files                                                                             |
| `output-file`     | The path to the JSON file that will be written by `aigu`                                                                  |
| `ignore`          | The patterns `aigu` will use to skip ignored files (eg. `routes.yml`)

### Importing the JSON file from Accent

The `import` command takes a generated JSON file from Accent and generates
the original YAML file structure.

```bash
$ aigu import --locale=fr --input-file=file-from-accent.json --output-directory=config/locales
```

#### Options

| Option             | Description                                                                                                               |
|--------------------|---------------------------------------------------------------------------------------------------|
| `locale`           | The locale used to generate localization files. Files will be generated as `<file>.<locale>.yml`  |
| `input-file`       | The path to the Accent-generated JSON file                                                        |
| `output-directory` | The directory where the localization YAML files will be generated                                 |

### Using `aigu.yml`

Instead of using command-line arguments when running the `aigu` command, you
can create a `aigu.yml` file at the root of your project and hard-code options
in that file.

```yaml
ignore:
  - routes.yml
  - rails/**/*.yml
output-directory: config/locales
input-directory: config/locales
```

## License

`Aigu` is © 2014 [Mirego](http://www.mirego.com) and may be freely distributed under the [New BSD license](http://opensource.org/licenses/BSD-3-Clause).  See the [`LICENSE.md`](https://github.com/mirego/aigu/blob/master/LICENSE.md) file.

## About Mirego

[Mirego](http://mirego.com) is a team of passionate people who believe that work is a place where you can innovate and have fun. We're a team of [talented people](http://life.mirego.com) who imagine and build beautiful Web and mobile applications. We come together to share ideas and [change the world](http://mirego.org).

We also [love open-source software](http://open.mirego.com) and we try to give back to the community as much as we can.