i18n-js 4.0.0 → 4.1.0

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

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module I18nJS
+  class CLI
+    class PluginsCommand < Command
+      command_name "plugins"
+      description "List plugins that will be activated"
+
+      parse do |opts|
+        opts.banner = "Usage: i18n #{name} [options]"
+
+        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
+        set_defaults!
+        ui.colored = options[:colored]
+
+        if options[:require_file]
+          ui.stdout_print("=> Require file:", options[:require_file].inspect)
+          require_file = File.expand_path(options[:require_file])
+        end
+
+        if require_file && !File.file?(require_file)
+          ui.fail_with(
+            "=> ERROR: require file doesn't exist at",
+            require_file.inspect
+          )
+        end
+
+        load_require_file!(require_file) if require_file
+
+        files = I18nJS.plugin_files
+
+        if files.empty?
+          ui.stdout_print("=> No plugins have been detected.")
+        else
+          ui.stdout_print("=> Plugins that will be activated:")
+
+          files.each do |file|
+            file = file.gsub("#{Dir.home}/", "~/")
+
+            ui.stdout_print("   * #{file}")
+          end
+        end
+      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.rb

@@ -6,6 +6,9 @@ require_relative "cli/ui"
 require_relative "cli/init_command"
 require_relative "cli/version_command"
 require_relative "cli/export_command"
+require_relative "cli/plugins_command"
+require_relative "cli/lint_translations_command"
+require_relative "cli/lint_scripts_command"
 require_relative "cli/check_command"
 
 module I18nJS
@@ -27,7 +30,15 @@ module I18nJS
     end
 
     private def command_classes
-      [InitCommand, ExportCommand, VersionCommand, CheckCommand]
+      [
+        InitCommand,
+        ExportCommand,
+        VersionCommand,
+        PluginsCommand,
+        LintTranslationsCommand,
+        LintScriptsCommand,
+        CheckCommand
+      ]
     end
 
     private def commands

data/lib/i18n-js/embed_fallback_translations_plugin.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module I18nJS
+  require "i18n-js/plugin"
+
+  class EmbedFallbackTranslationsPlugin < I18nJS::Plugin
+    CONFIG_KEY = :embed_fallback_translations
+
+    # This method must set up the basic plugin configuration, like adding the
+    # config's root key in case your plugin accepts configuration (defined via
+    # the config file).
+    #
+    # If you don't add this key, the linter will prevent non-default keys from
+    # being added to the configuration file.
+    def self.setup
+      I18nJS::Schema.root_keys << CONFIG_KEY
+    end
+
+    # In case your plugin accepts configuration, this is where you must validate
+    # the configuration, making sure only valid keys and type is provided.
+    # If the configuration contains invalid data, then you must raise an
+    # exception using something like
+    # `raise I18nJS::Schema::InvalidError, error_message`.
+    def self.validate_schema(config:)
+      return unless config.key?(CONFIG_KEY)
+
+      plugin_config = config[CONFIG_KEY]
+      valid_keys = %i[enabled]
+      schema = I18nJS::Schema.new(config)
+
+      schema.expect_required_keys(valid_keys, plugin_config)
+      schema.reject_extraneous_keys(valid_keys, plugin_config)
+      schema.expect_enabled_config(CONFIG_KEY, plugin_config[:enabled])
+    end
+
+    # This method is responsible for transforming the translations. The
+    # translations you'll receive may be already be filtered by other plugins
+    # and by the default filtering itself. If you need to access the original
+    # translations, use `I18nJS.translations`.
+    #
+    # Make sure you always check whether your plugin is active before
+    # transforming translations; otherwise, opting out transformation won't be
+    # possible.
+    def self.transform(translations:, config:)
+      return translations unless config.dig(CONFIG_KEY, :enabled)
+
+      translations_glob = Glob.new(translations)
+      translations_glob << "*"
+
+      mapping = translations.keys.each_with_object({}) do |locale, buffer|
+        buffer[locale] = Glob.new(translations[locale]).tap do |glob|
+          glob << "*"
+        end
+      end
+
+      default_locale = I18n.default_locale
+      default_locale_glob = mapping.delete(default_locale)
+      default_locale_paths = default_locale_glob.paths
+
+      mapping.each do |locale, glob|
+        missing_keys = default_locale_paths - glob.paths
+
+        missing_keys.each do |key|
+          components = key.split(".").map(&:to_sym)
+          fallback_translation = translations.dig(default_locale, *components)
+
+          next unless fallback_translation
+
+          translations_glob.set([locale, key].join("."), fallback_translation)
+        end
+      end
+
+      translations_glob.to_h
+    end
+  end
+
+  I18nJS.register_plugin(EmbedFallbackTranslationsPlugin)
+end