Awesome Open Source
Awesome Open Source


GitHub release Lens CI Docs

A multi-format internationalization (i18n) shard for Crystal.

Lens is designed to be fast, versatile and simple to use! Supports the likes of Gettext, Ruby YAML and more.

Why use Lens?

Lens was conceived due to various problems within crystal's internationalization ecosystem. As such, Lens aspires to overcome those issues. With lens:

  • Support of multiple different formats
  • Constant development of new features
  • And soon, actual full number and time localization through CLDR

In short, Lens is packed full of features and designed for internationalization.

Note: Documentation below is for Master. For the stable release version, please see v0.1.0.

Getting started

Lens supports numerous different formats:

Format Backend Documentation
GNU Gettext PO Gettext::POBackend Here
GNU Gettext MO Gettext::MOBackend Here
Ruby YAML RubyI18n::Yaml Here

To get started, simply initialize a backend:

backend ="locales")

And begin translating!

catalogue = backend.create["en_US"]

# Basic
catalogue.gettext("A message")     # => "Translated message"
# Plurals
catalogue.ngettext("I have %d apple", "I have %d apples", 1) # => "Translated I have %d apples"
# Context
catalogue.pgettext("CopyPasteMenu", "copy")          # => "Translated copy"
# Context w/ Plurals
catalogue.npgettext("CopyPasteMenu", "Export %d file", "Export %d files", 1) # => "Translated message with plural-form 0"

Note that each backend has a slightly different API.

See Getting Started for more information


  1. Add the dependency to your shard.yml:

        github: syeopite/lens
        version: ~> 0.1.0
  2. Run shards install



Library API


  1. Fork it (
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request



Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Language (30,062
Translation (13,575
Localization (5,322
I18n (4,834
Crystal (4,385
Internationalization (3,328
Gettext (896
L10n (657
Locale (194
L18n (8