i18n-migrations 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1d5b7ed6e5c2a76bacd9a1d12916d0f7fbba5c0d
+  data.tar.gz: ba7a796930572af0d6fa2f6f8ff9433c1f0b9032
+SHA512:
+  metadata.gz: 1ce65173fa1d15de262b216f589eeec8885780a329a65e03866b1066e677546e56f88c2e52b84c2e3dac9c4ccf93aa4db0ca09bf2bab8798b929500a676f63aa
+  data.tar.gz: 7dd74b2511050c59a71e679009a07997d0a11183ca17c0d1c76e40f15ea7c5afbb49406fc3cdc71272d3fcb2485a93855e52f352227087b213f7ac8758154938

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/.ruby-gemset
+/.idea

data/.i18n-migrations.default.yml

@@ -0,0 +1,22 @@
+# this is where your migration files will live. it will be relative to your config file
+migration_dir: i18n/migrate
+
+# this is where your locale files will live (en.yml, es.yml, etc). it will be relative to your config file
+locales_dir: config/locales
+
+# this is the locale you will be translating from
+main_locale: en
+
+# put all other locales you want to use here, if they don't already exist, add them with i18n-migrations new-locale es
+other_locales:
+  - es
+
+# you need a service account key in order to access google spreadsheets. This is the path to it, relative to your config file
+google_service_account_key_path: i18n/google_drive_key.json
+
+# each locale will have a spreadsheet that translators will use to do their work, these are the links to them
+google_spreadsheets:
+  es: https://docs.google.com/spreadsheets/d/1QGCzMbTyxF2gSUpWwRKAq-mMFIgJwsOLp1lfXsSF5X0/edit
+
+# this is your api key to use google translate
+google_translate_api_key: [INSERT_GOOGLE_TRANSLATE_API_KEY]

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.ruby-gemset

@@ -0,0 +1 @@
+transparentclassroom

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.4.1

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.0.0

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](http:contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/Gemfile

@@ -0,0 +1,12 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in i18n-migrations.gemspec
+gemspec
+
+gem "google_drive"
+gem 'mechanize'
+gem 'ruby-gmail'
+gem 'activesupport'
+gem 'rspec'
+gem 'colorize'
+gem 'rest-client'

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Jeremy Lightsmith
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,48 @@
+# I18n Migrations
+
+We help you manage your locale translations with migrations, just the way Active Record helps you manage your db with migrations.
+
+There are several tools out there that allow you to dynamically store / load / translate strings in your app. We prefer to deploy our app with static files using the excellent i18n gem. But how to translate?
+
+Our flow is:
+
+1. Use a migration to make a change (add/remove/update/move) to your translations locally. In this state, we will use google translate to quickly guess at translations.
+1. When ready to deploy, push these changes to google spreadsheets, one for each translation, there, your translators can fix google translate's mistakes.
+1. Pull to replace your translations with what's in those google spreadsheets.
+1. Migrate to play back any changes after pulling / merging / etc.
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'i18n-migrations'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install i18n-migrations
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, 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` to create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/i18n-migrations/fork )
+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
+

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "i18n/migrations"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/i18n-migrate

@@ -0,0 +1,74 @@
+#!/usr/bin/env ruby
+
+require_relative '../lib/i18n/migrations/migrator'
+require_relative '../lib/i18n/migrations/config'
+
+migrator = I18n::Migrations::Migrator.new
+
+case ARGV.shift
+  when 'setup'
+    puts 'Where should we create a default config file? [.]'
+    dir = gets.chomp
+    dir = dir == '' ? '.' : dir
+    file = I18n::Migrations::Config.copy_default_config_file(dir)
+
+    puts 'You will need to configure this file before you can get going.'
+    puts File.expand_path(file)
+
+  when 'new'
+    name = ARGV.shift
+    if name
+      migrator.new_migration name
+    else
+      STDERR.puts 'Usage: im new [name]'
+      exit 1
+    end
+
+  when 'migrate'
+    migrator.migrate
+
+  when 'rollback'
+    migrator.rollback(ARGV[0] || 'all')
+
+  when 'redo'
+    migrator.rollback(ARGV[0] || 'all')
+    migrator.migrate
+
+  when 'pull'
+    migrator.pull ARGV[0] || 'all'
+
+  when 'push'
+    migrator.push ARGV[0] || 'all'
+
+  when 'new_locale'
+    locale = ARGV.shift
+    if locale
+      migrator.new_locale(locale)
+    else
+      STDERR.puts 'Usage: im new_locale [name]'
+      exit 1
+    end
+
+  when 'version'
+    migrator.version
+
+  else
+    puts <<-USAGE
+Usage: im [command]
+
+Commands:
+  setup - Setup a new project w/ i18n-migrations.
+  new - Create a new migration.
+  migrate - Migrate to current version.
+  rollback - Rollback to previous version.
+  redo - Rollback and then migrate again.
+  pull - Pull latest translation spreadsheet. 
+  push - Push to translation spreadsheet.
+  new_locale - Copy your current main locale file to a new language, translating all keys.
+  version - Print version of locales.
+
+    USAGE
+    puts
+    puts "Commands:"
+    puts
+end

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/i18n-migrations.gemspec

@@ -0,0 +1,31 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'i18n/migrations/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "i18n-migrations"
+  spec.version       = I18n::Migrations::VERSION
+  spec.authors       = ["Jeremy Lightsmith"]
+  spec.email         = ["jeremy.lightsmith@gmail.com"]
+
+  spec.summary       = %q{Migrations for doing i18n.}
+  spec.description   = %q{We help you manage your locale translations with migrations, just the way Active Record helps you manage your db with migrations.}
+  spec.homepage      = "https://github.com/transparentclassroom/i18n-migrations"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "bin"
+  # spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.executables   = ["i18n-migrate"]
+  spec.require_paths = ["lib"]
+
+  spec.required_ruby_version = '~> 2.4'
+
+  spec.add_development_dependency "bundler", "~> 1.9"
+  spec.add_development_dependency "rake", "~> 10.0"
+
+  spec.add_dependency 'google_drive'
+  spec.add_dependency 'activesupport'
+  spec.add_dependency 'rest-client'
+end

data/lib/i18n/migrations/config.rb

@@ -0,0 +1,94 @@
+require 'yaml'
+
+module I18n
+  module Migrations
+    class Config
+      CONFIG_FILE_NAME = '.i18n-migrations.yml'
+
+      def migration_dir
+        get_file(:migration_dir)
+      end
+
+      def locales_dir
+        get_file(:locales_dir)
+      end
+
+      def main_locale
+        get_value(:main_locale)
+      end
+
+      def other_locales
+        get_value(:other_locales)
+      end
+
+      def google_service_account_key_path
+        get_file(:google_service_account_key_path)
+      end
+
+      def google_spreadsheets
+        get_value(:google_spreadsheets)
+      end
+
+      def google_translate_api_key
+        get_value(:google_translate_api_key)
+      end
+
+      def read!
+        yaml_file = find_config_file(CONFIG_FILE_NAME)
+        unless yaml_file
+          STDERR.puts "Can't find a #{CONFIG_FILE_NAME} file. Try running 'i18n-migrations setup'"
+          exit(1)
+        end
+
+        @root_dir = File.dirname(yaml_file)
+
+        @config = begin
+          YAML::load(File.read(yaml_file))
+        rescue Psych::SyntaxError
+          STDERR.puts("YAML configuration file contains invalid syntax.")
+          STDERR.puts($!.message)
+          exit(1)
+        end
+
+        # todo check for required keys
+        self
+      end
+
+      def self.copy_default_config_file(dir)
+        File.open(File.join(dir, CONFIG_FILE_NAME), 'w') do |f|
+          f << File.read(File.join(File.dirname(__FILE__), '../../../.i18n-migrations.default.yml'))
+        end
+      end
+
+      private
+
+      def get_value(key)
+        if @config.has_key?(key.to_s)
+          @config[key.to_s]
+        else
+          STDERR.puts "You must have defined #{key} in #{@root_dir}/#{CONFIG_FILE_NAME}"
+          exit(1)
+        end
+      end
+
+      def get_file(key)
+        file = File.join(@root_dir, get_value(key))
+        unless File.exist?(file)
+          STDERR.puts "#{File.expand_path(file)} does not exist"
+          exit(1)
+        end
+        file
+      end
+
+      def find_config_file(name)
+        file = File.expand_path(name)
+        loop do
+          return file if File.exist?(file)
+          next_file = File.join(File.dirname(File.dirname(file)), name)
+          return nil if file == next_file
+          file = next_file
+        end
+      end
+    end
+  end
+end

data/lib/i18n/migrations/google_spreadsheet.rb

@@ -0,0 +1,22 @@
+require 'google_drive'
+require 'config'
+
+module I18n
+  module Migrations
+    class GoogleSpreadsheet
+      attr_reader :sheet
+
+      def initialize(locale)
+        @session = GoogleDrive::Session.from_service_account_key(Config.google_service_account_key_path)
+
+        url = Config.google_spreadsheets[locale] || raise("Can't find google spreadsheet for #{locale}")
+        @spreadsheet = @session.spreadsheet_by_url(url)
+        @sheet = sheet_for("Sheet1")
+      end
+
+      def sheet_for(name)
+        @spreadsheet.worksheet_by_title(name) || raise("couldn't find worksheet for #{name}")
+      end
+    end
+  end
+end

data/lib/i18n/migrations/google_translate_dictionary.rb

@@ -0,0 +1,23 @@
+require 'rest-client'
+
+module I18n
+  module Migrations
+    class GoogleTranslateDictionary
+      def initialize(key, from_locale, to_locale)
+        @key, @from_locale, @to_locale = key, from_locale, to_locale
+      end
+
+      def lookup(term)
+        return term if @from_locale == @to_locale
+
+        response = RestClient.get 'https://www.googleapis.com/language/translate/v2', {
+            accept: :json,
+            params: { key: @key, source: @from_locale, target: @to_locale, q: term }
+        }
+        JSON.parse(response.body)['data']['translations'].first['translatedText']
+      end
+
+      # we should validate translations based on reasonable rules
+    end
+  end
+end

data/lib/i18n/migrations/migration.rb

@@ -0,0 +1,95 @@
+module I18n
+  module Migrations
+    class Migration
+      # locale = en | es | ...
+      # data = all keys -> all translations in this locale
+      # notes = some keys -> notes about the translation in this locale
+      # dictionary = call dictionary.lookup(term) to get localized version of a term
+      # direction = :up | :down (up when migrating, down when rolling back)
+      def initialize(locale, data, notes, dictionary, direction = :up, verbose = false)
+        @locale, @data, @notes, @dictionary, @direction, @verbose = locale, data, notes, dictionary, direction, verbose
+      end
+
+      # Overrides can be provided, e.g. { es: 'El foo de la barro' }
+      def add(key, term, overrides = {})
+        if @direction == :up
+          info "adding #{key}"
+          _add key, term, overrides
+        else
+          info "unadding #{key}"
+          _rm key
+        end
+      end
+
+      def mv(old_key, new_key)
+        if @direction == :up
+          info "moving #{old_key} => #{new_key}"
+          _mv old_key, new_key
+        else
+          info "moving back #{new_key} => #{old_key}"
+          _mv new_key, old_key
+        end
+      end
+
+      # Overrides can be provided, e.g. { es: 'El foo de la barro' }
+      def rm(key, old_term, overrides = {})
+        if @direction == :up
+          info "removing #{key}"
+          _rm key
+        else
+          info "unremoving #{key}"
+          _add key, old_term, overrides
+        end
+      end
+
+      # Overrides can be provided, e.g. { es: 'El foo de la barro' }
+      def update(key, new_term, old_term, overrides = {})
+        if @direction == :up
+          info "updating #{key}"
+          _update key, new_term, overrides
+        else
+          info "unupdating #{key}"
+          _update key, old_term, {}
+        end
+      end
+
+      private
+
+      def _add(key, term, overrides)
+        assert_does_not_exist! key
+        @data[key] = overrides[@locale.to_sym] || @dictionary.lookup(term)
+        @notes[key] = "[autotranslated]"
+      end
+
+      def _mv(from, to)
+        assert_exists! from
+        assert_does_not_exist! to
+        @data[to] = @data.delete(from)
+      end
+
+      def _update(key, term, overrides)
+        assert_exists! key
+        @data[key] = overrides[@locale.to_sym] || @dictionary.lookup(term)
+        @notes[key] = "[autotranslated]"
+      end
+
+      def _rm(key)
+        assert_exists! key
+        @data.delete(key)
+        @notes.delete(key)
+      end
+
+      def info(message)
+        puts message if @verbose
+      end
+
+      def assert_exists!(key)
+        raise "#{key} doesn't exist in #{@locale}" unless @data.has_key?(key)
+      end
+
+      def assert_does_not_exist!(key)
+        raise "#{key} already exists in #{@locale}" if @data.has_key?(key)
+      end
+    end
+  end
+end

data/lib/i18n/migrations/migrator.rb

@@ -0,0 +1,278 @@
+require 'fileutils'
+require 'yaml'
+require 'active_support/inflector'
+require 'active_support/core_ext/object'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'google_translate_dictionary'
+require 'google_spreadsheet'
+require 'config'
+
+module I18n
+  module Migrations
+    class Migrator
+      def config
+        @config ||= Config.new.read!
+      end
+
+      def new_migration(name)
+        name = name.parameterize(separator: '_')
+        file_name = "#{Time.now.strftime('%Y%m%d%H%M')}_#{name.downcase.gsub(' ', '_')}.rb"
+        unless Dir.exist?(config.migration_dir)
+          puts "Creating migration directory #{config.migration_dir} because it didn't exist."
+          FileUtils.mkdir_p(config.migration_dir)
+        end
+        File.open(File.join(config.migration_dir, file_name), 'w') do |f|
+          f << <<-CONTENTS
+require 'i18n-migrations'
+
+class #{name.camelcase} < I18n::Migrations::Migration
+  def change
+    # add('foo.bar', 'The foo of the bar')
+  end
+end
+          CONTENTS
+        end
+        puts "Wrote new migration to #{file_name}"
+      end
+
+      def migrate(locale_or_all = 'all')
+        each_locale(locale_or_all) do |locale|
+          update_locale_info(locale) do |data, notes|
+            migrate_locale(locale, data, notes)
+          end
+        end
+      end
+
+      def rollback(locale_or_all)
+        each_locale(locale_or_all) do |locale|
+          update_locale_info(locale) do |data, notes|
+            rollback_locale(locale, data, notes)
+          end
+        end
+      end
+
+      def pull(locale_or_all)
+        each_locale(locale_or_all) do |locale|
+          next if locale == config.main_locale
+          sheet = GoogleSpreadsheet.new(locale).sheet
+          pull_locale(locale, sheet)
+          migrate(locale)
+        end
+      end
+
+      def push(locale_or_all)
+        each_locale(locale_or_all) do |locale|
+          next if locale == config.main_locale
+          sheet = GoogleSpreadsheet.new(locale).sheet
+          pull_locale(locale, sheet)
+          migrate(locale)
+          push_locale(locale, sheet)
+        end
+      end
+
+      def new_locale(new_locale)
+        dictionary = GoogleTranslateDictionary.new(config.google_translate_api_key, config.main_locale, new_locale)
+        new_data, new_notes = {}, {}
+        read_locale_data(config.main_locale).each do |key, term|
+          new_data[key] = dictionary.lookup(term)
+          new_notes[key] = '[autotranslated]'
+          print '.'.green
+        end
+        write_locale_data_and_notes(new_locale, new_data, new_notes)
+      end
+
+      def version
+        each_locale do |locale|
+          puts "#{locale}: #{locale_versions(read_locale_data(locale)).last}"
+        end
+      end
+
+      private
+
+      def update_locale_info(locale)
+        data, notes = read_locale_data_and_notes(locale)
+        yield data, notes
+        write_locale_data_and_notes(locale, data, notes)
+      end
+
+      def read_locale_data_and_notes(locale)
+        data = read_locale_data(locale)
+        notes = locale == config.main_locale ? {} : read_locale_from_file(locale, "../#{locale}_notes.yml")
+        [data, notes]
+      end
+
+      def read_locale_data(locale)
+        read_locale_from_file(locale, "#{locale}.yml")
+      end
+
+      def write_locale_data_and_notes(locale, data, notes)
+        write_locale_to_file(locale, "#{locale}.yml", data)
+        write_locale_to_file(locale, "../#{locale}_notes.yml", notes) unless locale == config.main_locale
+      end
+
+      def pull_locale(locale, sheet)
+        puts "Pulling #{locale}"
+        data = {}
+        notes = {}
+        count = 0
+
+        (2..sheet.num_rows).each do |row|
+          key, value, note = sheet[row, 1], sheet[row, 3], sheet[row, 4]
+          if key.present?
+            assign_complex_key(data, key.split('.'), value.present? ? value : '')
+            if note.present?
+              assign_complex_key(notes, key.split('.'), note)
+            end
+            count += 1
+            print '.'
+          end
+        end
+
+        write_locale_data_and_notes(locale, data, notes)
+        write_locale_remote_version(locale, data)
+
+        puts "\n#{count} keys"
+      end
+
+      def write_locale_remote_version(locale, data)
+        write_locale_to_file(locale,
+                             "../#{locale}_remote_version.yml",
+                             { 'VERSION' => locale_versions(data) })
+      end
+
+      def push_locale(locale, sheet)
+        main_data = read_locale_data(config.main_locale)
+        data, notes = read_locale_data_and_notes(locale)
+        row = 2
+
+        puts "Pushing #{locale}"
+
+        main_data.each do |key, value|
+          sheet[row, 1] = key
+          sheet[row, 2] = value
+          sheet[row, 3] = data[key]
+          sheet[row, 4] = notes[key]
+          row += 1
+          print '.'
+        end
+
+        sheet.synchronize
+        write_locale_remote_version(locale, data)
+
+        puts "\n#{main_data.keys.length} keys"
+      end
+
+      def migrate_locale(locale, data, notes)
+        missing_versions = all_versions - locale_versions(data)
+        if missing_versions.empty?
+          puts "#{locale}: up-to-date"
+          return
+        end
+        puts "#{locale}: Migrating #{missing_versions.join(', ')}"
+        missing_versions.each do |version|
+          migrate_locale_to_version(locale, data, notes, version, :up)
+        end
+      end
+
+      def rollback_locale(locale, data, notes)
+        last_version = locale_versions(data).last
+        if last_version == nil
+          puts "#{locale}: no more migrations to roll back"
+          return
+        end
+        puts "#{locale}: Rolling back #{last_version}"
+        raise "Can't find #{last_version}.rb to rollback" unless all_versions.include?(last_version)
+
+        migrate_locale_to_version(locale, data, notes, last_version, :down)
+      end
+
+      def migrate_locale_to_version(locale, data, notes, version, direction)
+        filename = File.join(config.migration_dir, "#{version}.rb")
+        require filename
+        migration_class_name = version.gsub(/^\d{12}_/, '').camelcase
+        dictionary = GoogleTranslateDictionary.new(config.google_translate_api_key, config.main_locale, locale)
+
+        migration = begin
+          migration_class_name.constantize.new(locale, data, notes, dictionary, direction)
+        rescue
+          raise "Couldn't load migration #{migration_class_name} in #{filename}"
+        end
+
+        migration.change
+
+        if direction == :up
+          data['VERSION'] = (locale_versions(data) + [version]).join("\n")
+        else
+          data['VERSION'] = (locale_versions(data) - [version]).join("\n")
+        end
+      end
+
+      def locale_versions(data)
+        (data['VERSION'] && data['VERSION'].split("\n")) || []
+      end
+
+      def read_locale_from_file(locale, filename)
+        filename = File.join(config.locales_dir, filename)
+        begin
+          hash = {}
+          add_to_hash(hash, YAML.load(File.read(filename))[locale.to_s])
+          hash
+        rescue
+          puts "Error loading #{filename}"
+          raise
+        end
+      end
+
+      def write_locale_to_file(locale, filename, hash)
+        # we have to go from flat keys -> values to a hash that contains other hashes
+        complex_hash = {}
+        hash.keys.sort.each do |key|
+          value = hash[key]
+          assign_complex_key(complex_hash, key.split('.'), value.present? ? value : '')
+        end
+        File.open(File.join(config.locales_dir, filename), 'w') do |file|
+          file << { locale => complex_hash }.to_yaml
+        end
+      end
+
+      def assign_complex_key(hash, key, value)
+        if key.length == 0
+          # should never get here
+        elsif key.length == 1
+          hash[key[0]] = value
+        else
+          hash[key[0]] ||= {}
+          assign_complex_key(hash[key[0]], key[1..-1], value)
+        end
+      end
+
+      # flattens new_hash and adds it to hash
+      def add_to_hash(hash, new_hash, prefix = [])
+        return unless new_hash
+
+        new_hash.each do |key, value|
+          if value.is_a?(Hash)
+            add_to_hash(hash, value, prefix + [key])
+          else
+            hash[(prefix + [key]).join('.')] = value
+          end
+        end
+      end
+
+      def each_locale(locale = 'all')
+        (locale == 'all' ? all_locales : [locale]).each do |l|
+          yield l
+        end
+      end
+
+      def all_locales
+        [config.main_locale] + config.other_locales
+      end
+
+      def all_versions
+        Dir[config.migration_dir + '/*.rb'].map { |name| File.basename(name).gsub('.rb', '') }
+      end
+    end
+  end
+end

data/lib/i18n/migrations/version.rb

@@ -0,0 +1,5 @@
+module I18n
+  module Migrations
+    VERSION = "0.1.1"
+  end
+end

data/lib/i18n-migrations.rb

@@ -0,0 +1,7 @@
+require 'i18n/migrations/version'
+require 'i18n/migrations/migration'
+
+module I18n
+  module Migrations
+  end
+end

metadata

@@ -0,0 +1,138 @@
+--- !ruby/object:Gem::Specification
+name: i18n-migrations
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Jeremy Lightsmith
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-11-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: google_drive
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: We help you manage your locale translations with migrations, just the
+  way Active Record helps you manage your db with migrations.
+email:
+- jeremy.lightsmith@gmail.com
+executables:
+- i18n-migrate
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".i18n-migrations.default.yml"
+- ".rspec"
+- ".ruby-gemset"
+- ".ruby-version"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/i18n-migrate
+- bin/setup
+- i18n-migrations.gemspec
+- lib/i18n-migrations.rb
+- lib/i18n/migrations/config.rb
+- lib/i18n/migrations/google_spreadsheet.rb
+- lib/i18n/migrations/google_translate_dictionary.rb
+- lib/i18n/migrations/migration.rb
+- lib/i18n/migrations/migrator.rb
+- lib/i18n/migrations/version.rb
+homepage: https://github.com/transparentclassroom/i18n-migrations
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.4'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.11
+signing_key: 
+specification_version: 4
+summary: Migrations for doing i18n.
+test_files: []