rosette 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '03866ba93b8b990e22574cb0d1f84a6e2059988ca1bd8e091ab8551aaa4db1d9'
-  data.tar.gz: 26c70b8d2e6999dde21bd11fe0972505d2fc9b31b554ece1528f2f50aedd9dae
+  metadata.gz: dffb250e67fdc3f3935d85dbbe875fa56b8843629b138cb4444f7e5f2166cb6b
+  data.tar.gz: d2dcf4ab94c13916db15b7739661b86fcf06ad1f8fa16e73fffbd8f1d51793b5
 SHA512:
-  metadata.gz: d29a828701e75efa5654cacdfc353c34066dae80befff846f326ecf24611aa27396fdd8f0da8f233fd59fc818c9cb9867d1993b35e72d0c02aca392bb0acb171
-  data.tar.gz: f8a993fe6be29486261e7495e2992610e14af47d9e7538ed54ac95ddf992f7122c661cf617a4fa650e008767b9327dc19a4ee6ee17b3ff896ef5a1e99204cc6a
+  metadata.gz: f559af7434bb4ccff09fa5eb0ba4532559fe424621846ea910bf050facce940b61b3e0edf1e09f37e2862b8f2e0083482d25e46b3412d8769aeba41c90a2f2d9
+  data.tar.gz: 99f57b0c1edf0b156d76aec004fe200430940f4318229ca2d34d0b1b2d3cc57124bacffab894252bf7f3ff58a5eb5edd8b452067fad0d7f2b0dfa4101196bda4

data/README.md

@@ -1,10 +1,9 @@
 # Rosette
-Short description and motivation.
 
-## Usage
-How to use my plugin.
+Rosette is a Ruby on Rails engine that helps you add missing translations to your application. If your main app is configured to raise on missing translations, Rosette will catch any `I18n::MissingTranslationData` error and display a form to add the missing translations. The form includes an input for each available locale set by `config.i18n.available_locales`.
 
 ## Installation
+
 Add this line to your application's Gemfile:
 
 ```ruby
@@ -16,13 +15,22 @@ And then execute:
 $ bundle
 ```
 
-Or install it yourself as:
-```bash
-$ gem install rosette
+Make sure your app raises error for missing translations in development:
+
+```ruby
+# config/environments/development.rb
+
+config.i18n.raise_on_missing_translations = true
 ```
 
-## Contributing
-Contribution directions go here.
+Whether you currently use or are interested in starting to use [i18n-task to normalize](https://github.com/glebm/i18n-tasks#normalize-data) your locales files, add this initializer:
+
+```ruby
+# config/initializers/rosette.rb
+
+Rosette.normalize = true
+```
 
 ## License
+
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/app/assets/stylesheets/rosette/application.css

@@ -1,15 +1,83 @@
-/*
- * This is a manifest file that'll be compiled into application.css, which will include all the files
- * listed below.
- *
- * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
- * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
- *
- * You're free to add application-wide styles to this file and they'll appear at the bottom of the
- * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
- * files in this directory. Styles in this file should be added after the last require_* statement.
- * It is generally better to create a new file per style scope.
- *
- *= require_tree .
- *= require_self
- */
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500');
+
+.text-center {
+  text-align: center;
+}
+
+body {
+  font-family: 'Inter', sans-serif;
+  background-color: white;
+  margin: 5rem;
+}
+
+.form-wrapper {
+  background-color: rgb(241, 237, 237);
+  padding: 2.5rem;
+  margin: 32px auto;
+  border-radius: 0.5rem;
+  max-width: 38rem;
+  box-shadow: rgba(0, 0, 0, 0.05) 0px 1px 2px 0px;
+  position: relative;
+}
+
+.form {
+  display: flex;
+  flex-direction: column;
+}
+
+.input-text {
+  margin-bottom: 1rem;
+  padding: 1rem;
+  border-radius: .375rem;
+  border-color: rgb(211, 211, 211);
+  border: solid 1px rgba(0, 0, 0, 0.16);
+  box-shadow: rgba(0, 0, 0, 0.05) 0px 1px 2px 0px;
+  background-color: rgb(251, 249, 249);
+}
+
+.input-text:focus {
+  outline: 1rem solid transparent;
+  outline-offset: 1rem;
+  border-color: rgb(163, 163, 163);
+}
+
+label {
+  margin-bottom: 1rem;
+}
+
+.button {
+  background-color: rgb(220, 38, 38);
+  color: white;
+  padding: 0.75rem 5rem;
+  border-color: transparent;
+  border-radius: .375rem;
+  margin: 1rem auto 0 auto;
+  font-size: 1rem;
+  line-height: 1.25rem;
+  cursor: pointer;
+  transition: background-color 0.8s;
+}
+
+.button:hover {
+  background-color: rgb(235, 63, 54);
+}
+
+.note {
+  font-size: .75rem;
+  color: rgb(107, 114, 128);
+  margin-top: 1rem;
+}
+
+.error {
+  color: #856404;
+  background-color: #fff3cd;
+  border-color: #ffeeba;
+  padding: 0.75rem 1.25rem;
+  margin-bottom: 1rem;
+  border-radius: 0.25rem;
+}
+
+.locale {
+  color: rgb(220, 38, 38);
+  font-weight: 500;
+}

data/app/controllers/rosette/translations_controller.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Rosette
+  class TranslationsController < ApplicationController
+    def create
+      available_locales.each { |locale, translation| Manager.create(locale, key, translation) }
+
+      Manager.normalize!
+
+      redirect_to redirect_path, notice: 'Translation(s) added'
+    rescue StandardError => e
+      @error_message = e.message
+      render_rosette_new(key, redirect_path)
+    end
+
+    private
+
+    def translations_params
+      params.require(:translations).permit(:key, :redirect_path, available_locales: {})
+    end
+
+    def available_locales
+      translations_params[:available_locales]
+    end
+
+    def key
+      translations_params[:key]
+    end
+
+    def redirect_path
+      URI.parse(translations_params[:redirect_path]).to_s
+    end
+  end
+end

data/app/views/layouts/rosette/application.html.erb

@@ -1,15 +1,15 @@
 <!DOCTYPE html>
 <html>
-<head>
-  <title>Rosette</title>
-  <%= csrf_meta_tags %>
-  <%= csp_meta_tag %>
+  <head>
+    <title>Rosette</title>
+    <%= csrf_meta_tags %>
+    <%= csp_meta_tag %>
 
-  <%= stylesheet_link_tag    "rosette/application", media: "all" %>
-</head>
-<body>
+    <%= stylesheet_link_tag "rosette/application", media: "all" %>
+  </head>
+  <body>
 
-<%= yield %>
+  <%= yield %>
 
-</body>
+  </body>
 </html>

data/app/views/rosette/new.html.erb

@@ -0,0 +1,28 @@
+<h1 class="text-center">Add missing translation</h1>
+
+<p class="text-center locale"><%= key %></p>
+
+<div class="form-wrapper">
+  <%= form_with scope: :translations, url: rosette.translations_path, class: 'form' do |f| %>
+    <% if @error_message %>
+      <p class="error"><%= @error_message %></p>
+    <% end %>
+
+    <%= f.hidden_field :key, value: key %>
+    <%= f.hidden_field :redirect_path, value: redirect_path %>
+
+    <%= f.fields_for :available_locales do |a| %>
+      <% Rails.configuration.i18n.available_locales.each do |locale| %>
+        <%= a.label locale, "#{locale.capitalize} translation:" %>
+        <%= a.text_field locale, required: false, label: false, class: 'input-text' %>
+      <% end %>
+    <% end %>
+
+    <%= f.button 'Submit', class: 'button' %>
+  <% end %>
+
+</div>
+
+<div class="note text-center">
+  If you prefer to add the translation directly to the yaml file, you can choose not to fill in the input field.
+</div>

data/config/routes.rb

@@ -1,2 +1,3 @@
 Rosette::Engine.routes.draw do
+  resources :translations, only: [:create]
 end

data/lib/rosette/controller.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Rosette
+  module Controller
+    extend ActiveSupport::Concern
+
+    included { rescue_from I18n::MissingTranslationData, with: :add_missing_translation_data }
+
+    private
+
+    def add_missing_translation_data(exception)
+      key = exception.message.sub(/translation missing:.+?\./, '')
+
+      render_rosette_new(key, request.fullpath)
+    end
+
+    def render_rosette_new(key, redirect_path)
+      render 'rosette/new', layout: 'rosette/application', locals: { key: key, redirect_path: redirect_path }
+    end
+  end
+end

data/lib/rosette/engine.rb

@@ -1,5 +1,17 @@
+# frozen_string_literal: true
+
 module Rosette
   class Engine < ::Rails::Engine
     isolate_namespace Rosette
+
+    config.after_initialize do |app|
+      app.routes.prepend do
+        mount Rosette::Engine, at: '/rosette'
+      end
+    end
+
+    ActiveSupport.on_load(:action_controller_base) do
+      include Rosette::Controller
+    end
   end
 end

data/lib/rosette/manager.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+class Manager
+  %w[create read delete].each do |verb|
+    class_eval <<-METHOD, __FILE__, __LINE__ + 1
+      def self.#{verb}(*args)
+        new(*args).send('#{verb}')
+      end
+    METHOD
+  end
+
+  private
+
+  def initialize(locale, key, translation = nil)
+    @file_path   = Rails.root.join("config/locales/#{locale}.yml")
+    @keys        = normalize "#{locale}.#{key}"
+    @translation = translation
+  end
+
+  def create
+    new_translation      = @keys.reverse.inject(@translation) { |v, k| { k => v } }
+    updated_translations = deep_merge(stored_translations, new_translation)
+    persist(updated_translations)
+  end
+
+  def read
+    stored_translations.dig(*@keys)
+  end
+
+  def delete
+    updated_translations = delete_translation(stored_translations, @keys)
+    persist(updated_translations)
+  end
+
+  def delete_translation(translations, keys)
+    return translations.delete(keys.first) if keys.length == 1
+
+    head, *tail = keys
+    delete_translation(translations[head], tail)
+
+    translations
+  end
+
+  def persist(translations)
+    File.write(@file_path, translations.deep_stringify_keys.to_yaml)
+  end
+
+  def stored_translations
+    YAML.safe_load(File.read(@file_path), symbolize_names: true)
+  end
+
+  def deep_merge(hash, other_hash)
+    hash.merge(other_hash) do |_key, this_val, other_val|
+      if this_val.is_a?(Hash) && other_val.is_a?(Hash)
+        deep_merge(this_val, other_val)
+      else
+        other_val
+      end
+    end
+  end
+
+  def normalize(key)
+    key.split('.').map(&:to_sym)
+  end
+
+  def self.normalize!
+    I18n::Tasks::CLI.start(['normalize']) if Rosette.normalize
+  end
+end

data/lib/rosette/version.rb

@@ -1,3 +1,3 @@
 module Rosette
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

data/lib/rosette.rb

@@ -1,6 +1,13 @@
-require "rosette/version"
+# frozen_string_literal: true
+
+require "rosette/controller"
 require "rosette/engine"
+require "rosette/manager"
+require "rosette/version"
+
+require "i18n/tasks/cli"
+require "yaml"
 
 module Rosette
-  # Your code goes here...
+  mattr_accessor :normalize
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rosette
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Alexandre Platteeuw
@@ -10,6 +10,20 @@ bindir: bin
 cert_chain: []
 date: 2023-04-17 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: i18n-tasks
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.12
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.12
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
@@ -51,12 +65,16 @@ files:
 - app/assets/config/rosette_manifest.js
 - app/assets/stylesheets/rosette/application.css
 - app/controllers/rosette/application_controller.rb
+- app/controllers/rosette/translations_controller.rb
 - app/helpers/rosette/application_helper.rb
 - app/models/rosette/application_record.rb
 - app/views/layouts/rosette/application.html.erb
+- app/views/rosette/new.html.erb
 - config/routes.rb
 - lib/rosette.rb
+- lib/rosette/controller.rb
 - lib/rosette/engine.rb
+- lib/rosette/manager.rb
 - lib/rosette/version.rb
 - lib/tasks/rosette_tasks.rake
 homepage: https://rubygems.org/gems/rosette