module WebTranslateIt # Handles the configuration of your project, both via the the configuration file # and via the API. # Implementation example, assuming you have a valid config/translation.yml file: # # configuration = WebTranslateIt::Configuration.new # class Configuration require 'yaml' require 'fileutils' attr_accessor :path, :api_key, :source_locale, :target_locales, :files, :ignore_locales, :logger # Load configuration file from the path. def initialize(root_path = Rails.root, path_to_config_file = "config/translation.yml") self.path = root_path self.logger = logger configuration = YAML.load_file(File.join(self.path, path_to_config_file)) self.api_key = configuration['api_key'] project_info = YAML.load WebTranslateIt::Project.fetch_info(api_key) set_locales_to_ignore(configuration) set_files(project_info['project']) set_locales(project_info['project']) end # Set the project locales from the Project API. # Implementation example: # # configuration = WebTranslateIt::Configuration.new # locales = configuration.locales # returns an array of locales: ['en', 'fr', 'es', ...] def set_locales(project) self.source_locale = project['source_locale']['code'] self.target_locales = project['target_locales'].map{|locale| locale['code']} end # Set the project files from the Project API. # Implementation example: # # configuration = WebTranslateIt::Configuration.new # files = configuration.files # returns an array of TranslationFile def set_files(project) self.files = [] project['project_files'].each do |project_file| self.files.push TranslationFile.new(project_file['id'], project_file['name'], project_file['locale_code'], self.api_key) end end # Set locales to ignore from the configuration file, if set. def set_locales_to_ignore(configuration) self.ignore_locales = Array(configuration['ignore_locales']).map{ |locale| locale.to_s } end # Convenience method which returns the endpoint for fetching a list of locales for a project. def api_url "/api/projects/#{api_key}.yaml" end # Returns a logger. If RAILS_DEFAULT_LOGGER is defined, use it, else, define a new logger. def logger if defined?(Rails.logger) Rails.logger elsif defined?(RAILS_DEFAULT_LOGGER) RAILS_DEFAULT_LOGGER end end end end