data_porter 1.1.0 → 2.1.1

data/lib/data_porter/components/shared/pagination.rb

@@ -24,22 +24,26 @@ module DataPorter
         private
 
         def render_prev
+          label = "\u2190 #{I18n.t("data_porter.components.pagination.previous")}"
           if @page > 1
-            a(href: page_url(@page - 1), class: "dp-pagination__btn") { "\u2190 Previous" }
+            a(href: page_url(@page - 1), class: "dp-pagination__btn") { label }
           else
-            span(class: "dp-pagination__btn dp-pagination__btn--disabled") { "\u2190 Previous" }
+            span(class: "dp-pagination__btn dp-pagination__btn--disabled") { label }
           end
         end
 
         def render_indicator
-          span(class: "dp-pagination__info") { "Page #{@page} of #{@total_pages}" }
+          span(class: "dp-pagination__info") do
+            I18n.t("data_porter.components.pagination.page_info", page: @page, total: @total_pages)
+          end
         end
 
         def render_next
+          label = "#{I18n.t("data_porter.components.pagination.next")} \u2192"
           if @page < @total_pages
-            a(href: page_url(@page + 1), class: "dp-pagination__btn") { "Next \u2192" }
+            a(href: page_url(@page + 1), class: "dp-pagination__btn") { label }
           else
-            span(class: "dp-pagination__btn dp-pagination__btn--disabled") { "Next \u2192" }
+            span(class: "dp-pagination__btn dp-pagination__btn--disabled") { label }
           end
         end
 

data/lib/data_porter/components/shared/status_badge.rb

@@ -10,7 +10,9 @@ module DataPorter
         end
 
         def view_template
-          span(class: "dp-badge dp-badge--#{@status}") { @status.capitalize }
+          span(class: "dp-badge dp-badge--#{@status}") do
+            I18n.t("data_porter.components.status_badge.#{@status}", default: @status.capitalize)
+          end
         end
       end
     end

data/lib/data_porter/configuration.rb

@@ -16,8 +16,8 @@ module DataPorter
                   :transaction_mode
 
     def initialize
-      @parent_controller = "ApplicationController"
-      @queue_name = :imports
+      @parent_controller = "ActionController::Base"
+      @queue_name = :default
       @storage_service = :local
       @cable_channel_prefix = "data_porter"
       @context_builder = nil

data/lib/data_porter/engine.rb

@@ -4,6 +4,10 @@ module DataPorter
   class Engine < ::Rails::Engine
     isolate_namespace DataPorter
 
+    initializer "data_porter.i18n" do
+      config.i18n.load_path += Dir[root.join("config/locales/**/*.yml")]
+    end
+
     initializer "data_porter.assets.precompile" do |app|
       if app.config.respond_to?(:assets)
         app.config.assets.precompile += %w[

data/lib/data_porter/orchestrator/record_builder.rb

@@ -22,7 +22,7 @@ module DataPorter
         return unless max
         return if count <= max
 
-        raise Error, "File contains #{count} records, exceeds maximum of #{max}"
+        raise Error, I18n.t("data_porter.errors.max_records", count: count, max: max)
       end
 
       def build_record(row, index, columns, validator)

data/lib/data_porter/record_validator.rb

@@ -19,14 +19,14 @@ module DataPorter
     def validate_required(record, col, value)
       return unless col.required && value.to_s.strip.empty?
 
-      record.add_error("#{col.label} is required")
+      record.add_error(I18n.t("data_porter.errors.required", label: col.label))
     end
 
     def validate_type(record, col, value)
       return if value.to_s.strip.empty?
       return if TypeValidator.valid?(value, col.type, col.options)
 
-      record.add_error("#{col.label}: invalid #{col.type}")
+      record.add_error(I18n.t("data_porter.errors.invalid_type", label: col.label, type: col.type))
     end
   end
 end

data/lib/data_porter/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DataPorter
-  VERSION = "1.1.0"
+  VERSION = "2.1.1"
 end

data/lib/generators/data_porter/install/templates/initializer.rb

@@ -2,11 +2,12 @@
 
 DataPorter.configure do |config|
   # Parent controller for the engine's controllers to inherit from.
-  # This controls authentication, layouts, and helpers.
+  # Defaults to ActionController::Base. Set to "ApplicationController" to inherit
+  # authentication, layouts, and helpers from your app.
   # config.parent_controller = "ApplicationController"
 
   # ActiveJob queue name for import jobs.
-  # config.queue_name = :imports
+  # config.queue_name = :default
 
   # ActiveStorage service for uploaded files.
   # config.storage_service = :local

data/lib/generators/data_porter/locale/locale_generator.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module DataPorter
+  module Generators
+    class LocaleGenerator < Rails::Generators::Base
+      source_root File.expand_path("../../../../config/locales", __dir__)
+
+      argument :locale, type: :string, default: "en"
+
+      def copy_locale_file
+        source = source_file
+        destination = "config/locales/data_porter.#{locale}.yml"
+
+        copy_file(source, destination)
+        gsub_file(destination, /^#{source_locale}:/, "#{locale}:") unless locale == source_locale
+      end
+
+      def show_instructions
+        say ""
+        say "DataPorter locale file created: config/locales/data_porter.#{locale}.yml", :green
+        say ""
+        say "Next steps:"
+        say "  1. Translate the values in the generated file"
+        say "  2. Set your default locale in config/application.rb:"
+        say "       config.i18n.default_locale = :#{locale}"
+        say ""
+      end
+
+      private
+
+      def source_file
+        File.exist?(File.join(self.class.source_root, "#{locale}.yml")) ? "#{locale}.yml" : "en.yml"
+      end
+
+      def source_locale
+        source_file.delete_suffix(".yml")
+      end
+    end
+  end
+end

data/mkdocs.yml

@@ -0,0 +1,98 @@
+site_name: DataPorter
+site_description: A mountable Rails engine for data import workflows
+site_url: https://seryllns.github.io/data_porter
+repo_url: https://github.com/SerylLns/data_porter
+repo_name: SerylLns/data_porter
+edit_uri: edit/main/docs/
+
+theme:
+  name: material
+  palette:
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      primary: indigo
+      accent: indigo
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      primary: indigo
+      accent: indigo
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+  font:
+    text: Inter
+    code: JetBrains Mono
+  icon:
+    repo: fontawesome/brands/github
+    logo: material/database-import
+  features:
+    - navigation.sections
+    - navigation.expand
+    - navigation.top
+    - navigation.indexes
+    - navigation.footer
+    - search.highlight
+    - search.suggest
+    - content.code.copy
+    - content.code.annotate
+    - content.tabs.link
+    - toc.follow
+
+plugins:
+  - search
+  - exclude:
+      glob:
+        - blog/*
+        - blog_part_2/*
+        - V1_PLAN.md
+        - dev_to.md
+        - reddit_post.md
+
+markdown_extensions:
+  - admonition
+  - pymdownx.details
+  - pymdownx.superfences
+  - pymdownx.highlight:
+      anchor_linenums: true
+      line_spans: __span
+      pygments_lang_class: true
+  - pymdownx.inlinehilite
+  - pymdownx.tabbed:
+      alternate_style: true
+  - pymdownx.emoji:
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg
+  - pymdownx.snippets:
+      base_path: ["."]
+  - attr_list
+  - md_in_html
+  - tables
+  - toc:
+      permalink: true
+
+extra:
+  social:
+    - icon: fontawesome/brands/github
+      link: https://github.com/SerylLns/data_porter
+    - icon: fontawesome/brands/dev
+      link: https://dev.to/seryllns
+  generator: false
+
+extra_css:
+  - stylesheets/extra.css
+
+nav:
+  - Home: index.md
+  - Getting Started: getting-started.md
+  - Reference:
+      - Configuration: CONFIGURATION.md
+      - Targets: TARGETS.md
+      - Sources: SOURCES.md
+      - Column Mapping: MAPPING.md
+      - Routes: routes.md
+  - Roadmap: ROADMAP.md
+  - Changelog: changelog.md
+  - Contributing: contributing.md

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: data_porter
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 2.1.1
 platform: ruby
 authors:
 - Seryl Lounis
@@ -139,6 +139,8 @@ files:
 - app/views/data_porter/mapping_templates/index.html.erb
 - app/views/data_porter/mapping_templates/new.html.erb
 - app/views/layouts/data_porter/application.html.erb
+- config/locales/en.yml
+- config/locales/fr.yml
 - config/routes.rb
 - lib/data_porter.rb
 - lib/data_porter/broadcaster.rb
@@ -182,9 +184,11 @@ files:
 - lib/generators/data_porter/install/templates/create_data_porter_imports.rb.erb
 - lib/generators/data_porter/install/templates/create_data_porter_mapping_templates.rb.erb
 - lib/generators/data_porter/install/templates/initializer.rb
+- lib/generators/data_porter/locale/locale_generator.rb
 - lib/generators/data_porter/target/target_generator.rb
 - lib/generators/data_porter/target/templates/target.rb.tt
 - lib/tasks/data_porter.rake
+- mkdocs.yml
 - sig/data_porter.rbs
 homepage: https://github.com/SerylLns/data_porter
 licenses:
@@ -193,7 +197,7 @@ metadata:
   homepage_uri: https://github.com/SerylLns/data_porter
   source_code_uri: https://github.com/SerylLns/data_porter
   changelog_uri: https://github.com/SerylLns/data_porter/blob/main/CHANGELOG.md
-  documentation_uri: https://github.com/SerylLns/data_porter#readme
+  documentation_uri: https://seryllns.github.io/data_porter/
   bug_tracker_uri: https://github.com/SerylLns/data_porter/issues
   rubygems_mcp_server_uri: https://rubygems.org/gems/data_porter
   rubygems_mfa_required: 'true'