i18n-js 3.9.2 → 4.2.2

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/bin/release

@@ -0,0 +1,81 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "optparse"
+require_relative "../lib/i18n-js/version"
+
+def write_file(path, contents)
+  File.open(File.expand_path(path), "w") do |io|
+    io << contents
+  end
+end
+
+changelog_path = "./CHANGELOG.md"
+version_path = "./lib/i18n-js/version.rb"
+
+version = nil
+segments = I18nJS::VERSION.split(".")
+major, minor, patch = *segments.take(3).map(&:to_i)
+pre = segments[4].to_s
+pre_version = pre.gsub(/[^\d]/m, "").to_i
+date = Time.now.strftime("%b %d, %Y")
+dry_run = false
+alpha = false
+
+OptionParser.new do |opts|
+  opts.on("--major") do
+    version = "#{major + 1}.0.0"
+  end
+
+  opts.on("--minor") do
+    version = "#{major}.#{minor + 1}.0"
+  end
+
+  opts.on("--patch") do
+    version = "#{major}.#{minor}.#{patch + 1}"
+  end
+
+  opts.on("--alpha") do
+    alpha = true
+  end
+
+  opts.on("--dry-run") do
+    dry_run = true
+  end
+end.parse!
+
+version = "#{version}.alpha#{pre_version + 1}" if alpha
+
+unless version
+  puts "ERROR: You need to use either one of: --major, --minor, --patch"
+  exit 1
+end
+
+puts "=> Current version: #{I18nJS::VERSION}"
+puts "=> Next version: #{version}"
+
+system "yarn", "install"
+system "yarn", "compile"
+
+write_file changelog_path,
+           File.read(changelog_path)
+               .gsub("Unreleased", "v#{version} - #{date}")
+
+puts "=> Updated #{changelog_path}"
+
+write_file version_path,
+           File.read(version_path)
+               .gsub(/VERSION = ".*?"/, %[VERSION = "#{version}"])
+
+puts "=> Updated #{version_path}"
+
+unless dry_run
+  system "git", "add", changelog_path, version_path
+  system "git", "commit", "-m", "Bump up version (v#{version})"
+  system "rake", "release"
+end
+
+if dry_run
+  system "rake", "build"
+  system "git", "checkout", changelog_path, version_path
+end

data/exe/i18n

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

data/i18n-js.gemspec

@@ -1,30 +1,52 @@
-# -*- 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    = "https://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")
+  spec.metadata = {"rubygems_mfa_required" => "true"}
+
+  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|images)/}) }
+  end
+
+  spec.files << "lib/i18n-js/lint.js"
+
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) {|f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "glob", ">= 0.4.0"
+  spec.add_dependency "i18n"
+
+  spec.add_development_dependency "activesupport"
+  spec.add_development_dependency "minitest"
+  spec.add_development_dependency "minitest-utils"
+  spec.add_development_dependency "mocha"
+  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/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/guard/i18n-js.rb

@@ -0,0 +1,95 @@
+# 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
+        capture do
+          system "i18n",
+                 "export",
+                 "--config",
+                 config_file.to_s,
+                 "--require",
+                 require_file.to_s,
+                 "--quiet"
+        end
+      end
+
+      current_thread.join
+    end
+
+    def capture
+      original = $stdout
+      $stdout = StringIO.new
+      yield
+    rescue StandardError
+      # noop
+    ensure
+      $stdout = original
+    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 "[i18n-js] #{message}"
+    end
+
+    def info(message)
+      ::Guard::UI.info "[i18n-js] #{message}"
+    end
+  end
+end

data/lib/i18n-js/clean_hash.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module I18nJS
+  def self.clean_hash(hash)
+    hash.keys.each_with_object({}) do |key, buffer|
+      value = hash[key]
+
+      next if value.is_a?(Proc)
+
+      buffer[key] = value.is_a?(Hash) ? clean_hash(value) : value
+    end
+  end
+end

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

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module I18nJS
+  class CLI
+    class CheckCommand < LintTranslationsCommand
+      command_name "check"
+      description "Check for missing translations based on the default " \
+                  "locale (DEPRECATED: Use `i18n lint:translations` instead)"
+
+      def command
+        ui.stderr_print "=> WARNING: `i18n check` has been deprecated in " \
+                        "favor of `i18n lint:translations`"
+        super
+      end
+    end
+  end
+end

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

@@ -0,0 +1,79 @@
+# 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
+
+      private def load_config_file(config_file)
+        config = Glob::SymbolizeKeys.call(YAML.load_file(config_file))
+
+        if config.key?(:check)
+          config[:lint_translations] ||= config.delete(:check)
+        end
+
+        config
+      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
+
+        load path
+      ensure
+        $VERBOSE = old_verbose
+      end
+    end
+  end
+end

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

@@ -0,0 +1,95 @@
+# 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 used"
+        ) 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(
+          "-q",
+          "--quiet",
+          "A Ruby file that must be loaded"
+        ) do |quiet|
+          options[:quiet] = quiet
+        end
+
+        opts.on("-h", "--help", "Prints this help") do
+          ui.exit_with opts.to_s
+        end
+      end
+
+      command do
+        set_defaults!
+
+        unless options[:config_file]
+          ui.fail_with("=> ERROR: you need to specify the config file")
+        end
+
+        log("=> Config file:", options[:config_file].inspect)
+        config_file = File.expand_path(options[:config_file])
+
+        if options[:require_file]
+          log("=> Require file:", options[:require_file].inspect)
+          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
+
+        log("=> Done in #{time.round(2)}s")
+      end
+
+      private def log(*args)
+        return if options[:quiet]
+
+        ui.stdout_print(*args)
+      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
+    end
+  end
+end

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

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module I18nJS
+  class CLI
+    class InitCommand < Command
+      command_name "init"
+      description "Initialize a project"
+
+      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("-h", "--help", "Prints this help") do
+          ui.exit_with opts.to_s
+        end
+      end
+
+      command do
+        file_path = File.expand_path(
+          options.fetch(:config_file, "config/i18n.yml")
+        )
+
+        if File.file?(file_path)
+          ui.fail_with("ERROR: #{file_path} already exists!")
+        end
+
+        FileUtils.mkdir_p(File.dirname(file_path))
+
+        File.open(file_path, "w") do |file|
+          file << <<~YAML
+            ---
+            translations:
+              - file: app/javascript/locales.json
+                patterns:
+                  - "*"
+                  - "!*.activerecord"
+                  - "!*.errors"
+                  - "!*.number.nth"
+
+          YAML
+        end
+      end
+    end
+  end
+end