DEPRECATED. Please use the transilator library instead which also added JSON support.
Hstorly is a small translation library for translating database values for Active Support/Rails 4 using the Hstore datatype of your Postgres database.
This project is a fork of the amazing bithavoc/multilang-hstore with some remarkable differences.
- Focus on performance. Especially when dealing with millions of records, every operation counts.
- Remove a lot of features, focus on the core features.
- Due to focus on core features, better thread safety.
1,000,000 translation read operations
hstorly:
1.310000 0.020000 1.330000 ( 1.342136)
multilang-hstore:
3.350000 0.040000 3.390000 ( 3.383317)
Setting a new translation entry, 100,000 times
hstorly:
6.650000 0.030000 6.680000 ( 6.681483)
multilang-hstore:
6.860000 0.030000 6.890000 ( 6.892723)
Setting a completely new object with translations 100,000 times
hstorly:
6.980000 0.020000 7.000000 ( 7.000557)
multilang-hstore:
7.620000 0.040000 7.660000 ( 7.669240)
Add this line to your application's Gemfile:
gem 'hstorly'And then execute:
$ bundle
Or install it yourself as:
$ gem install hstorly
This is a walkthrough with all steps you need to setup multilang translated attributes, including model and migration.
We're assuming here you want a Post model with some multilang attributes, as outlined below:
class Post < ActiveRecord::Base
hstore_translate :title
end
The multilang translations are stored in the same model attributes (eg. title):
You may need to create migration for Post as usual, but multilang attributes should be in hstore type:
create_table(:posts) do |t|
t.hstore :title
t.timestamps
end
Thats it!
Now you are able to translate values for the attributes :title and :description per locale:
I18n.locale = :en
post.title = 'Hstorly rocks!'
I18n.locale = :de
post.title = 'Hstorly pferdefleisch!'
I18n.locale = :en
post.title #=> Hstorly rocks!
I18n.locale = :de
post.title #=> Hstorly pferdefleisch!
If this is not enough, and sometimes you want to access one of the attributes directly you can also do:
post.title_en = 'Hulk > Time punch'
post.title_en #=> Hulk > Time punch
You may use initialization if needed:
Post.new(title: {en: 'Cows rock', de: 'Kühe rocken'})
Use http://github.com/hendricius/hstorly/issues
After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.
Bug reports and pull requests are welcome on GitHub at https://github.com/hendricius/hstorly.
- Copyright (c) 2015 Hendrik Kleinwaechter and Contributors