i18n-migrations 2.0.1 → 2.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 053d7282ee9ff71a5208ab798f26bc52545f0a6efea6122371e6a8fa1ab088d5
-  data.tar.gz: 92271dac44fff97ed25c200bd33ff0fbd000cdc391b54480a409763f87c4d43d
+  metadata.gz: 274cc2afe088dd6f3222a02373b5e7cffe919a49aa927a837bc73170f06ad4e9
+  data.tar.gz: 15bae7e096587080bab7333d8ec2e6cb5e6c94e664ade5f62b67dc5fed284673
 SHA512:
-  metadata.gz: 67e99b9e00a2cfc83105c813e5bcd09aecdd89fb2314e7f8490d82bc3e730b098991bddf7b2ddfb0ed554a912922be2b61068399141dfe81b435ce92fffa8fef
-  data.tar.gz: '039751914e92608313ff570365910ce05472124e582711b67bf55382412f333d6e51c83109a34aae91f8d1c0b5866282886cc57b69146196165587244993e010'
+  metadata.gz: 7b346021869b4ac4c8fb89c0798589bd9102380181d6c5b0c2bce095a5bbf249c1d1447227714dff46fa4534e7fdc90688ef8d1ebbc8a6e23b72dd370390941c
+  data.tar.gz: 444444d2a9ee2f2e0fa60330a1505f01746b7e1eadd6e8f2dc662f10c22f94ead1ad5a7b91d623d4536177b5c15d2a6667b77c9b3977a8bf7fe4bad45451270a

data/README.md

@@ -47,20 +47,10 @@ Let's imagine that your config file look like this:
 
 In your project file, you should then have all your english terms in ```config/locales/en.yml```
 
-To create a new locale (like es.yml):
-
-1. Translate all the terms w/ google translate
-
-    > i18n-migrate new_locale es
-    
-2. Create a spreadsheet that is world editable (for now). You'll want to add the link to it to your config file. It should look like:
-
-    | key | en | es | notes | 
-
-2. Push this to your google spreadsheet (the -f means it won't try to pull first)
-
-    > i18n-migrate push -f es
+You can:
 
+* [Create a new locale](https://github.com/transparentclassroom/i18n-migrations/wiki/Create-a-new-locale-(language))
+* [Add a migration](https://github.com/transparentclassroom/i18n-migrations/wiki/Add-a-migration)
 
 ## Development
 
@@ -71,8 +61,9 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 ## 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
+1. Create your feature branch (`git checkout -b my-new-feature`)
+1. Make sure tests are passing (`rake`)
+1. Commit your changes (`git commit -am 'Add some feature'`)
+1. Push to the branch (`git push origin my-new-feature`)
+1. Create a new Pull Request
 

data/bin/i18n-migrate

@@ -10,59 +10,60 @@ def extract_option(name)
   !!ARGV.delete(name)
 end
 
-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(ARGV[0] || 'all')
-
-when 'rollback'
-  migrator.rollback(ARGV[0] || 'all')
-
-when 'redo'
-  migrator.rollback(ARGV[0] || 'all')
-  migrator.migrate(ARGV[0] || 'all')
-
-when 'pull'
-  migrator.pull(ARGV[0] || 'all')
+begin
+  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(ARGV[0] || 'all')
+
+  when 'rollback'
+    migrator.rollback(ARGV[0] || 'all')
+
+  when 'redo'
+    migrator.rollback(ARGV[0] || 'all')
+    migrator.migrate(ARGV[0] || 'all')
+
+  when 'pull'
+    migrator.pull(ARGV[0] || 'all')
+
+  when 'push'
+    force = extract_option('-f')
+    migrator.push(ARGV[0] || 'all', force)
+
+  when 'validate'
+    migrator.validate(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
 
-when 'push'
-  force = extract_option('-f')
-  migrator.push(ARGV[0] || 'all', force)
-
-when 'validate'
-  migrator.validate(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
+    puts <<-USAGE
 Usage: i18n-migrate [command]
 
 Commands:
@@ -78,5 +79,9 @@ Commands:
   version - Print version of locales.
 
 i18n-migrations version #{I18n::Migrations::VERSION}
-  USAGE
+    USAGE
+  end
+rescue Exception
+  puts "Error\n#{$!.message}".red
+  exit 1
 end

data/lib/i18n/migrations/backends/crowd_translate_backend.rb

@@ -53,9 +53,7 @@ module I18n
               begin
                 client.put_migration(version: version, ruby_file: migrations.get_migration(version: version))
               rescue
-                puts "There was an error updating migration:".red
-                puts "  #{migrations.migration_file(version: version)}".bold
-                raise
+                raise CrowdTranslateError, "... while updating migration: #{migrations.migration_file(version: version)}\n#{$!.message}"
               end
             end
           end

data/lib/i18n/migrations/backends/crowd_translate_client.rb

@@ -4,16 +4,16 @@ require 'active_support/core_ext/object'
 module I18n
   module Migrations
     module Backends
+      class CrowdTranslateError < StandardError
+      end
+
       class CrowdTranslateClient
         def initialize
           token = ENV['CROWD_TRANSLATE_API_TOKEN']
           raise("You must define CROWD_TRANSLATE_API_TOKEN in order to talk to Crowd Translate") unless token.present?
 
-          server = ENV['CROWD_TRANSLATE_SERVER'] || 'https://crowd-translate.herokuapp.com'
-          @faraday = Faraday.new(
-            url: "#{server}/api/v1",
-            headers: { 'X-CrowdTranslateApiToken' => token },
-          )
+          @server = ENV['CROWD_TRANSLATE_SERVER'] || 'https://crowd-translate.herokuapp.com'
+          @faraday = Faraday.new(url: base_url, headers: { 'X-CrowdTranslateApiToken' => token })
         end
 
         def get_locale_file(locale_code)
@@ -37,26 +37,34 @@ module I18n
 
         def get(path)
           puts "GET #{path}".bold
-          parse_response @faraday.get path
+          parse_response 'GET', path, @faraday.get(path)
         end
 
         def put(path, params = {})
           puts "PUT #{path} #{params.to_s[0..50]}#{'...' if params.to_s.length > 50}".bold
-          parse_response @faraday.put path, params
+          parse_response 'PUT', path, @faraday.put(path, params)
         end
 
-        def parse_response(response)
+        def parse_response(method, path, response)
           if response.success?
             response.body
           else
-            error = begin
-                      JSON.parse(response.body)['error']
-                    rescue
-                      response.body
+            error = if response.status == 503
+                      'Server timed out - your request may have succeed, check the server for more details'
+                    else
+                      begin
+                        JSON.parse(response.body)['error']
+                      rescue
+                        response.body
+                      end
                     end
-            raise error
+            raise CrowdTranslateError, "... while calling #{method} #{File.join(base_url, path)}\n#{error}"
           end
         end
+
+        def base_url
+          "#{@server}/api/v1"
+        end
       end
     end
   end

data/lib/i18n/migrations/locale.rb

@@ -212,7 +212,7 @@ module I18n
       end
 
       def parse_yaml(string)
-        YAML.load(string)
+        YAML.load(string) || {}
       end
 
       # flattens new_hash and adds it to hash

data/lib/i18n/migrations/metadata.rb

@@ -20,7 +20,9 @@ class Metadata
   end
 
   def delete(key)
+    metadatum = self[key]
     @hash.delete(key)
+    metadatum
   end
 
   def to_h

data/lib/i18n/migrations/migration_factory.rb

@@ -27,15 +27,15 @@ module I18n
         raise("Can't parse version: #{version}") unless version =~ /^(\d{12})_(.*)/
         migration_class_name = "#{$2.camelcase}#{$1}"
 
-        translations = Translations.new(data: data, metadata: metadata)
+        translations = Translations.new(locale_code: locale, data: data, metadata: metadata)
         migration = begin
-          migration_class_name.constantize.new(locale_code: locale,
-                                               translations: translations,
-                                               dictionary: dictionary,
-                                               direction: direction)
-        rescue
-          raise "Couldn't load migration #{migration_class_name} in #{filename}"
-        end
+                      migration_class_name.constantize.new(locale_code: locale,
+                                                           translations: translations,
+                                                           dictionary: dictionary,
+                                                           direction: direction)
+                    rescue
+                      raise "Couldn't load migration #{migration_class_name} in #{filename}"
+                    end
 
         migration.change
       end
@@ -44,8 +44,8 @@ module I18n
       # data = all keys -> all translations in this locale
       # metadata = some keys -> metadata about the translation in this locale
       class Translations
-        def initialize(data:, metadata:)
-          @data, @metadata = data, metadata
+        def initialize(locale_code:, data:, metadata:)
+          @locale_code, @data, @metadata = locale_code, data, metadata
         end
 
         def get_term(key)
@@ -63,6 +63,17 @@ module I18n
           @metadata[key].errors = errors
           @metadata[key].notes = nil
           @metadata[key].autotranslated = autotranslated
+          if errors.present?
+            puts [
+                   "=" * 100,
+                   "#{@locale_code}: #{key}",
+                   value,
+                   errors.map { |e| "Error: #{e}".red }.join("\n"),
+                   "=" * 100,
+                 ].compact.join("\n")
+            # puts ["Error with #{@locale_code}: #{key}: \n  #{errors.join("\n  ")}".red,
+            #       value].compact.join("\n")
+          end
         end
 
         def delete_term(key)

data/lib/i18n/migrations/migrator.rb

@@ -72,7 +72,7 @@ end
 
       def pull(locale_or_all)
         each_locale(locale_or_all) do |locale|
-          next if locale.main_locale?
+          # next if locale.main_locale?
           backend.pull(locale)
         end
       end
@@ -104,23 +104,44 @@ end
         end
       end
 
+      private def report_locale_on_error(locale, &block)
+        begin
+          block.call locale
+        rescue Backends::CrowdTranslateError
+          puts "Error\n... while working with #{locale.name}\n#{$!.message}".red
+          # we want a readable error for our users, and the error happened in an external system,
+          # so don't give them a stack trace
+        rescue
+          puts "Error\n... while working with #{locale.name}\n#{$!.message}".red
+          raise
+        end
+      end
+
       private def each_locale(name = 'all',
                               async: true,
-                              concurrency: config.concurrency)
+                              concurrency: config.concurrency,
+                              &block)
         locale_names = name == 'all' ? all_locale_names : [name]
 
+        # do the main locale first, so we aren't updating it and reading it for other locales at the same time
+        if locale_names.include?(config.main_locale)
+          locale_names -= [config.main_locale]
+
+          report_locale_on_error(locale_for(config.main_locale), &block)
+        end
+
         if async
           puts "Using #{concurrency} concurrency"
           locale_names.each_slice(concurrency) do |some_locale_names|
             threads = some_locale_names.map do |l|
               locale = locale_for(l)
-              Thread.new { yield locale }
+              Thread.new { report_locale_on_error(locale, &block) }
             end
             threads.each(&:join)
           end
         else
           locale_names.each do |l|
-            yield locale_for(l)
+            report_locale_on_error(locale_for(l), &block)
           end
         end
       end

data/lib/i18n/migrations/version.rb

@@ -1,5 +1,5 @@
 module I18n
   module Migrations
-    VERSION = "2.0.1"
+    VERSION = "2.0.6"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: i18n-migrations
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 2.0.6
 platform: ruby
 authors:
 - Jeremy Lightsmith
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-03-18 00:00:00.000000000 Z
+date: 2020-07-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler