i18n-js 3.8.3 → 4.0.0.alpha1

data/Rakefile

@@ -1,25 +1,15 @@
-require "appraisal"
-require "rubygems"
-require "bundler"
-require "rspec/core/rake_task"
+# frozen_string_literal: true
 
-Bundler::GemHelper.install_tasks
+require "bundler/gem_tasks"
+require "rake/testtask"
+require "rubocop/rake_task"
 
-RSpec::Core::RakeTask.new(:"spec:ruby")
-
-desc "Run JavaScript specs"
-task "spec:js" do
-  # Need to call `exit!` manually to propogate exit status
-  system "npm", "test" or exit!(1)
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
 end
 
-desc "Run all specs"
-task :spec => ["spec:ruby", "spec:js"]
+RuboCop::RakeTask.new
 
-if !ENV["APPRAISAL_INITIALIZED"] && !ENV["TRAVIS"]
-  task :default do
-    sh "appraisal install && rake appraisal spec"
-  end
-else
-  task :default => :spec
-end
+task default: %i[test rubocop]

data/exe/i18n

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/i18n-js"
+I18nJS::CLI.new(argv: ARGV, stdout: $stdout, stderr: $stderr).call

data/i18n-js.gemspec

@@ -1,30 +1,48 @@
-# -*- encoding: utf-8 -*-
-$:.push File.expand_path("../lib", __FILE__)
-require "i18n/js/version"
-
-Gem::Specification.new do |s|
-  s.name        = "i18n-js"
-  s.version     = I18n::JS::VERSION
-  s.platform    = Gem::Platform::RUBY
-  s.authors     = ["Nando Vieira"]
-  s.email       = ["fnando.vieira@gmail.com"]
-  s.homepage    = "http://rubygems.org/gems/i18n-js"
-  s.summary     = "It's a small library to provide the Rails I18n translations on the Javascript."
-  s.description = s.summary
-  s.license       = "MIT"
-
-  s.files         = `git ls-files`.split("\n")
-  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
-  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
-  s.require_paths = ["lib"]
-
-  s.add_dependency "i18n", ">= 0.6.6"
-
-  s.add_development_dependency "appraisal", "~> 2.3"
-  s.add_development_dependency "rspec", "~> 3.0"
-  s.add_development_dependency "rake", "~> 12.0"
-  s.add_development_dependency "gem-release", ">= 0.7"
-  s.add_development_dependency "coveralls", ">= 0.7"
-
-  s.required_ruby_version = ">= 2.1.0"
+# frozen_string_literal: true
+
+require_relative "./lib/i18n-js/version"
+
+Gem::Specification.new do |spec|
+  spec.name    = "i18n-js"
+  spec.version = I18nJS::VERSION
+  spec.authors = ["Nando Vieira"]
+  spec.email   = ["me@fnando.com"]
+
+  spec.summary     = "Export i18n translations and use them on JavaScript."
+  spec.description = spec.summary
+  spec.license     = "MIT"
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.6.0")
+
+  github_url = "https://github.com/fnando/i18n-js"
+  github_tree_url = "#{github_url}/tree/v#{spec.version}"
+
+  spec.homepage = github_url
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["bug_tracker_uri"] = "#{github_url}/issues"
+  spec.metadata["source_code_uri"] = github_tree_url
+  spec.metadata["changelog_uri"] = "#{github_tree_url}/CHANGELOG.md"
+  spec.metadata["documentation_uri"] = "#{github_tree_url}/README.md"
+  spec.metadata["license_uri"] = "#{github_tree_url}/LICENSE.md"
+
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`
+      .split("\x0")
+      .reject {|f| f.match(%r{^(test|spec|features)/}) }
+  end
+
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) {|f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "glob"
+  spec.add_dependency "i18n"
+
+  spec.add_development_dependency "activesupport"
+  spec.add_development_dependency "minitest"
+  spec.add_development_dependency "minitest-utils"
+  spec.add_development_dependency "pry-meta"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rubocop"
+  spec.add_development_dependency "rubocop-fnando"
+  spec.add_development_dependency "simplecov"
 end

data/lib/guard/i18n-js.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+gem "guard"
+gem "guard-compat"
+require "guard/compat/plugin"
+
+require "i18n-js"
+
+module Guard
+  class I18njs < Plugin
+    attr_reader :config_file, :require_file, :current_thread
+
+    def initialize(options = {})
+      @config_file = options.delete(:config_file)
+      @require_file = options.delete(:require_file)
+      super
+    end
+
+    def start
+      export_files
+    end
+
+    def stop
+      current_thread&.exit
+    end
+
+    def reload
+      export_files
+    end
+
+    def run_all
+      export_files
+    end
+
+    def run_on_additions(paths)
+      export_files(paths)
+    end
+
+    def run_on_modifications(paths)
+      export_files(paths)
+    end
+
+    def run_on_removals(paths)
+      export_files(paths)
+    end
+
+    def export_files(changes = nil)
+      return unless validate_file(:config_file, config_file)
+      return unless validate_file(:require_file, require_file)
+
+      current_thread&.exit
+
+      info("Changes detected: #{changes.join(', ')}") if changes
+
+      @current_thread = Thread.new do
+        require @require_file
+        ::I18nJS.call(config_file: @config_file)
+      end
+
+      current_thread.join
+    end
+
+    def validate_file(key, file)
+      return true if file && File.file?(file)
+
+      error("#{key.inspect} must be a file")
+      false
+    end
+
+    def error(message)
+      ::Guard::UI.error "[guard-i18n-js] #{message}"
+    end
+
+    def info(message)
+      ::Guard::UI.info "[guard-i18n-js] #{message}"
+    end
+  end
+end

data/lib/guard/i18n-js/templates/Guardfile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+guard(:"i18n-js",
+      run_on_start: true,
+      config_file: "./config/i18n.yml",
+      require_file: "./config/environment.rb") do
+  watch(%r{^(app|config)/locales/.+\.(yml|po)$})
+  watch(%r{^config/i18n.yml$})
+  watch("Gemfile")
+end

data/lib/guard/i18n-js/version.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+gem "guard"
+gem "guard-compat"
+require "guard/compat/plugin"
+
+require "i18n-js"
+
+module Guard
+  class I18njsVersion < Plugin
+    VERSION = I18nJS::VERSION
+  end
+end

data/lib/i18n-js.rb

@@ -1 +1,66 @@
-require "i18n/js"
+# frozen_string_literal: true
+
+require "i18n"
+require "json"
+require "yaml"
+require "glob"
+require "fileutils"
+require "optparse"
+
+require_relative "./i18n-js/cli"
+require_relative "./i18n-js/cli/command"
+require_relative "./i18n-js/cli/ui"
+require_relative "./i18n-js/cli/init_command"
+require_relative "./i18n-js/cli/version_command"
+require_relative "./i18n-js/cli/export_command"
+require_relative "./i18n-js/schema"
+require_relative "./i18n-js/version"
+
+module I18nJS
+  MissingConfigError = Class.new(StandardError)
+
+  def self.call(config_file: nil, config: nil)
+    if !config_file && !config
+      raise MissingConfigError,
+            "you must set either `config_file` or `config`"
+    end
+
+    config = Glob::SymbolizeKeys.call(config || YAML.load_file(config_file))
+    Schema.validate!(config)
+
+    config[:translations].each do |group|
+      export_group(group)
+    end
+  end
+
+  def self.export_group(group)
+    filtered_translations = Glob.filter(translations, group[:patterns])
+    output_file_path = File.expand_path(group[:file])
+
+    if output_file_path.include?(":locale")
+      filtered_translations.each_key do |locale|
+        locale_file_path = output_file_path.gsub(/:locale/, locale.to_s)
+        write_file(locale_file_path, locale => filtered_translations[locale])
+      end
+    else
+      write_file(output_file_path, filtered_translations)
+    end
+  end
+
+  def self.write_file(file_path, translations)
+    FileUtils.mkdir_p(File.dirname(file_path))
+
+    File.open(file_path, "w") do |file|
+      file << ::JSON.pretty_generate(translations)
+    end
+  end
+
+  def self.translations
+    ::I18n.backend.instance_eval do
+      has_been_initialized_before =
+        respond_to?(:initialized?, true) && initialized?
+      init_translations unless has_been_initialized_before
+      translations
+    end
+  end
+end

data/lib/i18n-js/cli.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module I18nJS
+  class CLI
+    attr_reader :ui
+
+    def initialize(argv:, stdout:, stderr:)
+      @argv = argv.dup
+      @ui = UI.new(stdout: stdout, stderr: stderr)
+    end
+
+    def call
+      command_name = @argv.shift
+      command = commands.find {|cmd| cmd.name == command_name }
+
+      ui.fail_with(root_help) unless command
+
+      command.call
+    end
+
+    private def command_classes
+      [InitCommand, ExportCommand, VersionCommand]
+    end
+
+    private def commands
+      command_classes.map do |command_class|
+        command_class.new(argv: @argv, ui: ui)
+      end
+    end
+
+    private def root_help
+      commands_list = commands
+                      .map {|cmd| "- #{cmd.name}: #{cmd.description}" }
+                      .join("\n")
+
+      <<~TEXT
+        Usage: i18n COMMAND FLAGS
+
+        Commands:
+
+        #{commands_list}
+
+        Run `i18n COMMAND --help` for more information on specific commands.
+      TEXT
+    end
+  end
+end

data/lib/i18n-js/cli/command.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module I18nJS
+  class CLI
+    class Command
+      attr_reader :ui, :argv
+
+      def self.command_name(name)
+        define_method(:name) { name }
+      end
+
+      def self.description(description)
+        define_method(:description) { description }
+      end
+
+      def self.parse(&block)
+        define_method(:parse) do
+          OptionParser
+            .new {|opts| instance_exec(opts, &block) }
+            .parse!(argv)
+        end
+      end
+
+      def self.command(&block)
+        define_method(:command, &block)
+      end
+
+      def initialize(argv:, ui:)
+        @argv = argv.dup
+        @ui = ui
+      end
+
+      def call
+        parse
+        command
+      end
+
+      def options
+        @options ||= {}
+      end
+    end
+  end
+end

data/lib/i18n-js/cli/export_command.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+require "benchmark"
+
+module I18nJS
+  class CLI
+    class ExportCommand < Command
+      command_name "export"
+      description "Export translations as JSON files"
+
+      parse do |opts|
+        opts.banner = "Usage: i18n #{name} [options]"
+
+        opts.on(
+          "-cCONFIG_FILE",
+          "--config=CONFIG_FILE",
+          "The configuration file that will be generated"
+        ) do |config_file|
+          options[:config_file] = config_file
+        end
+
+        opts.on(
+          "-rREQUIRE_FILE",
+          "--require=REQUIRE_FILE",
+          "A Ruby file that must be loaded"
+        ) do |require_file|
+          options[:require_file] = require_file
+        end
+
+        opts.on("-h", "--help", "Prints this help") do
+          ui.exit_with opts.to_s
+        end
+      end
+
+      command do # rubocop:disable Metrics/BlockLength
+        set_defaults!
+
+        ui.stdout_print("=> config file:", options[:config_file].inspect)
+        ui.stdout_print("=> require file:", options[:require_file].inspect)
+
+        unless options[:config_file]
+          ui.fail_with("=> ERROR: you need to specify the config file")
+        end
+
+        config_file = File.expand_path(options[:config_file])
+
+        if options[:require_file]
+          require_file = File.expand_path(options[:require_file])
+        end
+
+        unless File.file?(config_file)
+          ui.fail_with(
+            "=> ERROR: config file doesn't exist at",
+            config_file.inspect
+          )
+        end
+
+        if require_file && !File.file?(require_file)
+          ui.fail_with(
+            "=> ERROR: require file doesn't exist at",
+            require_file.inspect
+          )
+        end
+
+        time = Benchmark.realtime do
+          load_require_file!(require_file) if require_file
+          I18nJS.call(config_file: config_file)
+        end
+
+        ui.stdout_print("=> done in #{time.round(2)}s")
+      end
+
+      private def set_defaults!
+        config_file = "./config/i18n.yml"
+        require_file = "./config/environment.rb"
+
+        options[:config_file] ||= config_file if File.file?(config_file)
+        options[:require_file] ||= require_file if File.file?(require_file)
+      end
+
+      private def load_require_file!(require_file)
+        require_without_warnings(require_file)
+      rescue Exception => error # rubocop:disable Lint/RescueException
+        ui.stderr_print("=> ERROR: couldn't load",
+                        options[:require_file].inspect)
+        ui.fail_with(
+          "\n#{error_description(error)}\n#{error.backtrace.join("\n")}"
+        )
+      end
+
+      private def error_description(error)
+        [
+          error.class.name,
+          error.message
+        ].reject(&:empty?).join(" => ")
+      end
+
+      private def require_without_warnings(path)
+        old_verbose = $VERBOSE
+        $VERBOSE = nil
+
+        require path
+      ensure
+        $VERBOSE = old_verbose
+      end
+    end
+  end
+end