https://github.com/moigagoo/loco

Loco: Localization Package for Nim Apps
https://github.com/moigagoo/loco

i18n localization nim nim-lang translation

Last synced: 5 months ago
JSON representation

Loco: Localization Package for Nim Apps

• Host: GitHub
• URL: https://github.com/moigagoo/loco
• Owner: moigagoo
• License: mit
• Created: 2018-12-19T13:23:09.000Z (almost 7 years ago)
• Default Branch: develop
• Last Pushed: 2021-04-26T08:56:35.000Z (over 4 years ago)
• Last Synced: 2025-06-27T23:40:36.397Z (6 months ago)
• Topics: i18n, localization, nim, nim-lang, translation
• Language: Nim
• Homepage: https://loco.nim.town
• Size: 113 KB
• Stars: 21
• Watchers: 3
• Forks: 2
• Open Issues: 3
• Metadata Files:
  • Readme: README.rst
  • Changelog: changelog.rst
  • License: LICENSE

Awesome Lists containing this project

README

          
**********************************

Loco: Localization Package for Nim

**********************************

.. image:: https://travis-ci.com/moigagoo/loco.svg?branch=develop

    :alt: Build Status

    :target: https://travis-ci.com/moigagoo/loco

.. image:: https://raw.githubusercontent.com/yglukhov/nimble-tag/master/nimble.png

    :alt: Nimble

    :target: https://nimble.directory/pkg/loco

Loco helps localize Nim apps. Uses classic declaratively defined "zero-one-few-many" language variables, but thanks to Nim's superpowers, you also have code completion and compilation checks for language variables.

*   `Repo `__

    -   `Issues `__

    -   `Pull requests `__

*   `API index `__

*   `Changelog `__

Quickstart

==========

1.  Install Loco with Nimble:

.. code-block::

    $ nimble install loco

2.  Define localizations with ``loco`` macro:

.. code-block:: nim

    # en_US.nim

    import loco

    loco en:

      hello: "hello"

      users:

        zero: "no users"

        one: "{n} user"

        many: "{n} users"

Argument ``en`` is the name of a *pluralizer*. Pluralizer is a module in ``loco`` that defines pluralization rules for a particural language.

3.  Use them in your code as regular functions:

.. code-block:: nim

    # app.nim

    import en_US

    echo hello() & " world"     # → "hello world"

    echo "there's " & 0.users   # → "there's no users"

    echo "there's " & 1.users   # → "there's 1 user"

    echo "there's " & 12.users  # → "there's 12 users"

Contributing

============

Any contributions are welcome, be it pull requests, code reviews, documentation improvements, bug reports, or feature requests.

If you decide to contribute through code, please run the tests after you change the code:

.. code-block::

    $ docker-compose run tests                  # run all tests in Docker

    $ docker-compose run test tests/testen.nim  # run a single test suite in Docker

    $ nimble test                               # run all tests natively

    $ nim c -r tests/testen.nim                 # run a single test suite natively

❤ Contributors ❤

==================

- `@moigagoo `__

- `@Nindaleth `__