https://github.com/elixir-gettext/expo

Low-level Elixir parser for GNU Gettext files (PO, POT, MO).
https://github.com/elixir-gettext/expo

elixir gettext mo parser po pot

Last synced: 7 days ago
JSON representation

Low-level Elixir parser for GNU Gettext files (PO, POT, MO).

• Host: GitHub
• URL: https://github.com/elixir-gettext/expo
• Owner: elixir-gettext
• License: apache-2.0
• Created: 2022-03-29T16:45:42.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-09-10T08:22:32.000Z (2 months ago)
• Last Synced: 2024-09-10T08:51:08.912Z (2 months ago)
• Topics: elixir, gettext, mo, parser, po, pot
• Language: Elixir
• Homepage:
• Size: 354 KB
• Stars: 13
• Watchers: 3
• Forks: 5
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Expo

[![hex.pm badge](https://img.shields.io/badge/Package%20on%20hex.pm-informational)](https://hex.pm/packages/expo)

[![Documentation badge](https://img.shields.io/badge/Documentation-ff69b4)][docs]

[![.github/workflows/branch_main.yml](https://github.com/elixir-gettext/expo/actions/workflows/branch_main.yml/badge.svg)](https://github.com/elixir-gettext/expo/actions/workflows/branch_main.yml)

[![Coverage Status](https://coveralls.io/repos/github/elixir-gettext/expo/badge.svg?branch=main)](https://coveralls.io/github/elixir-gettext/expo?branch=main)

> Low-level [GNU gettext][gettext] file handling (for `.po`, `.pot`, and `.mo`

> files), including writing and parsing.

See [the documentation][docs].

For a full Gettext integration, see the [Gettext library][elixir-gettext].

## Usage

Expo can *parse* PO, POT, and MO files from [GNU gettext][gettext]:

```elixir

Expo.PO.parse_file!("priv/gettext/default.pot")

#=> %Expo.Messages{...}

```

It can also *write* well-formed PO, POT, and MO files:

```elixir

"priv/gettext/default.pot"

|> Expo.PO.parse_file!()

|> Expo.PO.compose()

|> then(fn content -> File.write!("priv/gettext/copy.pot", content) end)

```

This library can also parse [`Plural-Form`

headers](https://www.gnu.org/software/gettext/manual/html_node/Plural-forms.html)

in PO or POT files, and ships with a built-in list of languages and their plural

forms. You can find which plural form to use for a given *amount* by using

`Expo.PluralForms.index/2`:

```elixir

{:ok, plural_form} = Expo.PluralForms.plural_form("de")

Expo.PluralForms.index(plural_form, 1)

#=> 0

Expo.PluralForms.index(plural_form, 213)

#=> 1

```

## License

Copyright 2015 Plataformatec Copyright 2020 Dashbit 2022 JOSHMARTIN GmbH

  Licensed under the Apache License, Version 2.0 (the "License");

  you may not use this file except in compliance with the License.

  You may obtain a copy of the License at:

  > 

  Unless required by applicable law or agreed to in writing, software

  distributed under the License is distributed on an "AS IS" BASIS,

  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

  See the License for the specific language governing permissions and

  limitations under the License.

[docs]: https://hexdocs.pm/expo

[elixir-gettext]: https://github.com/elixir-gettext/gettext

[gettext]: https://www.gnu.org/software/gettext/