https://github.com/ruby-i18n/i18n

Internationalization (i18n) library for Ruby
https://github.com/ruby-i18n/i18n

Keywords

i18n ruby

Keywords from Contributors

activerecord activejob mvc rubygems rack rspec sinatra crash-reporting background-jobs rubocop

Last synced: about 16 hours ago
JSON representation

Repository metadata

Internationalization (i18n) library for Ruby

Host: GitHub
URL: https://github.com/ruby-i18n/i18n
Owner: ruby-i18n
License: mit
Created: 2008-06-13T12:47:13.000Z (over 17 years ago)
Default Branch: master
Last Pushed: 2025-11-16T22:18:30.000Z (24 days ago)
Last Synced: 2025-11-22T06:02:24.780Z (18 days ago)
Topics: i18n, ruby
Language: Ruby
Homepage:
Size: 1.71 MB
Stars: 1,009
Watchers: 17
Forks: 417
Open Issues: 59
Releases: 51
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/funding.yml
- License: MIT-LICENSE

Ruby I18n

Ruby internationalization and localization (i18n) solution.

Currently maintained by @radar.

Usage

Rails

You will most commonly use this library within a Rails app.

We support Rails versions from 6.0 and up.

See the Rails Guide for an example of its usage.

Ruby (without Rails)

We support Ruby versions from 3.0 and up.

If you want to use this library without Rails, you can simply add i18n to your Gemfile:

gem 'i18n'

Then configure I18n with some translations, and a default locale:

I18n.load_path += Dir[File.expand_path("config/locales") + "/*.yml"]
I18n.default_locale = :en # (note that `en` is already the default!)

A simple translation file in your project might live at config/locales/en.yml and look like:

en:
  test: "This is a test"

You can then access this translation by doing:

I18n.t(:test)

You can switch locales in your project by setting I18n.locale to a different value:

I18n.locale = :de
I18n.t(:test) # => "Dies ist ein Test"

Features

Translation and localization
Interpolation of values to translations
Pluralization (CLDR compatible)
Customizable transliteration to ASCII
Flexible defaults
Bulk lookup
Lambdas as translation data
Custom key/scope separator
Custom exception handlers
Extensible architecture with a swappable backend

Pluggable Features

Cache
Pluralization: lambda pluralizers stored as translation data
Locale fallbacks, RFC4647 compliant (optionally: RFC4646 locale validation)
Gettext support
Translation metadata

Alternative Backend

Chain
ActiveRecord (optionally: ActiveRecord::Missing and ActiveRecord::StoreProcs)
KeyValue (uses active_support/json and cannot store procs)

For more information and lots of resources see the 'Resources' page on the wiki.

Tests

You can run tests both with

rake test or just rake
run any test file directly, e.g. ruby -Ilib:test test/api/simple_test.rb

You can run all tests against all Gemfiles with

ruby test/run_all.rb

The structure of the test suite is a bit unusual as it uses modules to reuse
particular tests in different test cases.

The reason for this is that we need to enforce the I18n API across various
combinations of extensions. E.g. the Simple backend alone needs to support
the same API as any combination of feature and/or optimization modules included
to the Simple backend. We test this by reusing the same API definition (implemented
as test methods) in test cases with different setups.

You can find the test cases that enforce the API in test/api. And you can find
the API definition test methods in test/api/tests.

All other test cases (e.g. as defined in test/backend, test/core_ext) etc.
follow the usual test setup and should be easy to grok.

Contributors

@radar
@carlosantoniodasilva
@josevalim
@knapo
@tigrish
and many more

License

MIT License. See the included MIT-LICENSE file.

Owner metadata

Name: ruby-i18n
Login: ruby-i18n
Email:
Kind: organization
Description:
Website:
Location:
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/8200960?v=4
Repositories: 3
Last ynced at: 2024-03-25T19:32:13.361Z
Profile URL: https://github.com/ruby-i18n

GitHub Events

Total

Create event: 1
Commit comment event: 2
Release event: 1
Issues event: 10
Watch event: 24
Issue comment event: 31
Push event: 8
Pull request review event: 6
Pull request review comment event: 1
Pull request event: 10
Fork event: 9

Last Year

Create event: 1
Commit comment event: 2
Release event: 1
Issues event: 9
Watch event: 18
Issue comment event: 30
Push event: 8
Pull request event: 7
Pull request review event: 5
Fork event: 8

Committers metadata

Last synced: 3 days ago

Total Commits: 1,175
Total Committers: 206
Avg Commits per committer: 5.704
Development Distribution Score (DDS): 0.711

Commits in past year: 18
Committers in past year: 7
Avg Commits per committer in past year: 2.571
Development Distribution Score (DDS) in past year: 0.667

Name	Email	Commits
Sven Fuchs	s**s@a**e	339
Ryan Bigg	me@r****m	183
Carlos Antonio da Silva	c**a@g**m	84
José Valim	j**m@g**m	69
knapo	k**o@k**t	27
Christopher Dell	c**s@t**m	23
Lawrence Pit	l**t@g**m	22
Akira Matsuda	r**e@d**p	21
Michael Overmeyer	m**r@s**m	19
Jeremy Kemper	j**y@b**t	12
fatkodima	f**3@g**m	11
Paarth Madan	p**n@s**m	11
Clemens Kofler	c**s@r**t	8
Ryan Bigg	r**g@c**m	8
Vít Ondruch	v**h@r**m	7
Theo Cushion	t**o@j**m	7
Krzysztof Rybka	k**a@g**m	6
Olle Jonsson	o**n@g**m	6
Will Jordan	w**l@c**g	6
Yaroslav Markin	y**v@m**t	6
tom-lord	l**m@g**m	6
Chris Stringer	c**r@g**m	6
José Valim	j**m@p**r	6
thedarkone	t**2@g**m	5
Jean Boussier	j**r@g**m	5
Aaron Patterson	a**n@g**m	5
Nikos Dimitrakopoulos	n**s@p**r	5
jonian	j**n@h**u	5
Romulo A. Ceccon	r**n@g**m	4
michael	m**l@m**m	4
and 176 more...

Committer domains:

Issue and Pull Request metadata

Last synced: 15 days ago

Total issues: 77
Total pull requests: 117
Average time to close issues: 2 months
Average time to close pull requests: 3 months
Total issue authors: 69
Total pull request authors: 55
Average comments per issue: 3.22
Average comments per pull request: 1.83
Merged pull request: 92
Bot issues: 0
Bot pull requests: 0

Past year issues: 9
Past year pull requests: 17
Past year average time to close issues: 1 day
Past year average time to close pull requests: about 2 months
Past year issue authors: 9
Past year pull request authors: 9
Past year average comments per issue: 1.33
Past year average comments per pull request: 1.29
Past year merged pull request: 8
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/ruby-i18n/i18n

Top Issue Authors

movermeyer (8)
viralpraxis (2)
arianf (1)
nakwa (1)
hardik-plume (1)
lavrovdv (1)
toncid (1)
aaronfrary (1)
tubaxenor (1)
yheuhtozr (1)
domingo2000 (1)
jrizmal (1)
aliahmadexe (1)
qbantek (1)
dmitrue (1)

Top Pull Request Authors

radar (11)
movermeyer (10)
amatsuda (7)
fatkodima (6)
paarthmadan (6)
voxik (4)
olleolleolle (4)
stereobooster (3)
tom-lord (3)
casperisfine (2)
j0sh3rs (2)
Earlopain (2)
lee266 (2)
mishina2228 (2)
Bilka2 (2)

Top Issue Labels

no-repro (4)
pr-required (3)
has-repro-steps (1)

Top Pull Request Labels

Package metadata

Total packages: 11
Total downloads:
- rubygems: 2,497,593,212 total
Total docker downloads: 7,463,578,786
Total dependent packages: 1,845 (may contain duplicates)
Total dependent repositories: 1,412,742 (may contain duplicates)
Total versions: 269
Total maintainers: 10
Total advisories: 2

gem.coop: i18n

New wave Internationalization support for Ruby.

Homepage: https://github.com/ruby-i18n/i18n
Documentation: http://www.rubydoc.info/gems/i18n/
Licenses: MIT
Latest release: 1.14.7 (published 11 months ago)
Last Synced: 2025-12-08T12:32:44.504Z (2 days ago)
Versions: 85
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 1,248,466,115 Total
Docker Downloads: 3,731,789,393
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Downloads: 0.003%
- Average: 0.004%
- Docker downloads count: 0.015%
Maintainers (9)
- cantoniodasilva
- svenfuchs
- clemensk
- Tigrish
- matt_a
- ryanbigg
- saimon
- arkanis
- sfuchs