js_from_routes 2.0.0 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 120fa96855c034323a664b851019f5d1df7bd418de5578af5fa074b80451ca3e
-  data.tar.gz: 7a39747149294d21f74568296c4cab44f2e93ea172c85bad0d721e686c16ce74
+  metadata.gz: 5663dc5fb9fd9062e81af864e59d7fb8ec61625d5db06c0f55c04307afde8314
+  data.tar.gz: 5dc7aa69994d396c22472c249e216045a4b6466b4041d7df6974f9bf6f6e5f75
 SHA512:
-  metadata.gz: 77d1b1b6bef1a59d68bc1452dcb8ade3de38123ae907687bab9017347897a440b6f8b57ce6874f46d8873c6fcddf0e0480e38aa46a02fd91c39600c5c9980eca
-  data.tar.gz: 993bf91cfd887d1c645313b305f2f5d1c095ed31f3232d34b7dcbf575eefafdbadaeb3fb6948e00f1b1614e8f38e86217dd6c5bb2c55c508df771584441bde53
+  metadata.gz: 782f8ee6ca92ab3bcb84220e4012bb235b8aeafeeff88e54499f93d35fa75fbfcde6799460a53f4dd6dd2990ac9a3934dd07632a7e1e4b7ecea527f66a324e1c
+  data.tar.gz: ebdc1552cfae84ce61f36ad7f70fc302c6b1994b29ad06956391ab9701cd8a639dbb4d8317d2122907b474b114f01dd36e61de22d7b3aa118f694349d64a2a12

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## [2.0.1](https://github.com/ElMassimo/js_from_routes/compare/js_from_routes@2.0.0...js_from_routes@2.0.1) (2021-03-14)
+
+
+
 # [2.0.0](https://github.com/ElMassimo/js_from_routes/compare/v1.0.3...js_from_routes@2.0.0) (2021-03-13)
 
 ### Features ⚡️

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2021 Máximo Mussini
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/lib/js_from_routes/generator.rb

@@ -8,12 +8,34 @@ require "pathname"
 # Public: Automatically generates JS for Rails routes with { export: true }.
 # Generates one file per controller, and one function per route.
 module JsFromRoutes
+  # Internal: Helper class used as a presenter for the all helpers template.
+  class AllRoutes
+    attr_reader :helpers
+
+    def initialize(helpers, config)
+      @helpers, @config = helpers, config
+    end
+
+    # Public: Used to check whether the file should be generated again, changes
+    # based on the configuration, and route definition.
+    def cache_key
+      helpers.map(&:import_filename).join + File.read(@config.template_all_path)
+    end
+
+    # Internal: Name of the JS file where all helpers will be exported.
+    def filename
+      path = @config.all_helpers_file
+      path = "index#{File.extname(@config.file_suffix)}" if path == true
+      @config.output_folder.join(path)
+    end
+  end
+
   # Internal: Helper class used as a presenter for the routes template.
-  class Routes
+  class ControllerRoutes
     attr_reader :routes
 
-    def initialize(routes, config)
-      @config = config
+    def initialize(controller, routes, config)
+      @controller, @config = controller, config
       @routes = routes
         .uniq { |route| route.requirements.fetch(:action) }
         .map { |route| Route.new(route, config.helper_mappings) }
@@ -22,7 +44,7 @@ module JsFromRoutes
     # Public: Used to check whether the file should be generated again, changes
     # based on the configuration, and route definition.
     def cache_key
-      Digest::MD5.hexdigest(routes.map(&:inspect).join + [File.read(@config.template_path), @config.helper_mappings.inspect].join)
+      routes.map(&:inspect).join + [File.read(@config.template_path), @config.helper_mappings.inspect].join
     end
 
     # Public: Exposes the preferred import library to the generator.
@@ -30,10 +52,24 @@ module JsFromRoutes
       @config.client_library
     end
 
-    # Internal: By performing the evaluation here, we ensure only "routes" is
-    # exposed to the ERB template as a local variable.
-    def evaluate(compiled_template)
-      instance_eval(compiled_template)
+    # Internal: Name of the JS file with helpers for the the given controller.
+    def filename
+      @config.output_folder.join(basename)
+    end
+
+    # Public: Name of the JS file with helpers for the the given controller.
+    def import_filename
+      @config.output_folder.basename.join((basename.split(".")[0]).to_s)
+    end
+
+    # Public: Name of the file as a valid JS variable.
+    def js_name
+      @controller.camelize(:lower).tr(":", "_")
+    end
+
+    # Internal: The base name of the JS file to be written.
+    def basename
+      "#{@controller.camelize}#{@config.file_suffix}".tr_s(":", "/")
     end
   end
 
@@ -70,6 +106,43 @@ module JsFromRoutes
     end
   end
 
+  # Internal: Represents a compiled template that can write itself to a file.
+  class Template
+    def initialize(template_path)
+      # NOTE: The compiled ERB template, used to generate JS code.
+      @compiled_template = Erubi::Engine.new(File.read(template_path), filename: template_path).src
+    end
+
+    # Public: Checks if the cache is fresh, or renders the template with the
+    # specified variables, and writes the updated result to a file.
+    def write_if_changed(object)
+      write_file_if_changed(object.filename, object.cache_key) { render_template(object) }
+    end
+
+    private
+
+    # Internal: Returns a String with the generated JS code.
+    def render_template(object)
+      object.instance_eval(@compiled_template)
+    end
+
+    # Internal: Writes if the file does not exist or the cache key has changed.
+    # The cache strategy consists of a comment on the first line of the file.
+    #
+    # Yields to receive the rendered file content when it needs to.
+    def write_file_if_changed(name, cache_key)
+      FileUtils.mkdir_p(name.dirname)
+      cache_key_comment = "// JsFromRoutes CacheKey #{Digest::MD5.hexdigest(cache_key)}\n"
+      File.open(name, "a+") { |file|
+        if file.gets != cache_key_comment
+          file.truncate(0)
+          file.write(cache_key_comment)
+          file.write(yield)
+        end
+      }
+    end
+  end
+
   class << self
     # Public: Configuration of the code generator.
     def config
@@ -82,23 +155,36 @@ module JsFromRoutes
     def generate!(app_or_routes = Rails.application)
       raise ArgumentError, "A Rails app must be defined, or you must specify a custom `output_folder`" if config.output_folder.blank?
       rails_routes = app_or_routes.is_a?(::Rails::Engine) ? app_or_routes.routes.routes : app_or_routes
-      @compiled_template = nil # Clear on every code reload in case the template changed.
-      exported_routes_by_controller(rails_routes).each do |controller, controller_routes|
-        routes = Routes.new(controller_routes, config)
-        write_if_changed(filename_for(controller), routes.cache_key) { render_template(routes) }
-      end
+      generate_files exported_routes_by_controller(rails_routes)
     end
 
     private
 
+    def generate_files(exported_routes)
+      template = Template.new(config.template_path)
+      generate_file_for_all exported_routes.map { |controller, routes|
+        ControllerRoutes.new(controller, routes, config).tap do |routes|
+          template.write_if_changed routes
+        end
+      }
+    end
+
+    def generate_file_for_all(routes)
+      return unless config.all_helpers_file && !routes.empty?
+
+      Template.new(config.template_all_path).write_if_changed AllRoutes.new(routes, config)
+    end
+
     def default_config(root)
       dir = %w[frontend packs javascript assets].find { |dir| root.join("app", dir).exist? }
       {
+        all_helpers_file: true,
         client_library: "@js-from-routes/client",
         file_suffix: "Api.js",
         helper_mappings: {"index" => "list", "show" => "get"},
         output_folder: root.join("app", dir, "api"),
         template_path: File.expand_path("template.js.erb", __dir__),
+        template_all_path: File.expand_path("template_all.js.erb", __dir__),
       }
     end
 
@@ -110,39 +196,5 @@ module JsFromRoutes
         route.requirements.fetch(:controller)
       }
     end
-
-    # Internal: Name of the JS file with helpers for the the given controller.
-    def filename_for(controller)
-      config.output_folder.join("#{controller.camelize}#{config.file_suffix}".tr_s(":", "/"))
-    end
-
-    # Internal: Returns a String with the JS generated for a controller's routes.
-    def render_template(routes)
-      routes.evaluate(compiled_template)
-    end
-
-    # Internal: Returns the compiled ERB to generate JS from a set of routes.
-    def compiled_template
-      @compiled_template ||= begin
-        template = File.read(config.template_path)
-        Erubi::Engine.new(template, filename: config.template_path).src
-      end
-    end
-
-    # Internal: Writes if the file does not exist or the cache key has changed.
-    # The cache strategy consists of a comment on the first line of the file.
-    #
-    # Yields to receive the rendered file content when it needs to.
-    def write_if_changed(name, cache_key)
-      FileUtils.mkdir_p(name.dirname)
-      cache_key_comment = "// JsFromRoutes CacheKey #{cache_key}\n"
-      File.open(name, "a+") { |file|
-        if file.gets != cache_key_comment
-          file.truncate(0)
-          file.write(cache_key_comment)
-          file.write(yield)
-        end
-      }
-    end
   end
 end

data/lib/js_from_routes/railtie.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "rails/railtie"
+
 # NOTE: Not strictly required, but it helps to simplify the setup.
 class JsFromRoutes::Railtie < Rails::Railtie
   railtie_name :js_from_routes

data/lib/js_from_routes/template.js.erb

@@ -3,7 +3,7 @@
 import { definePathHelper } from '<%= client_library %>'
 
 export default {
-<% routes.each_with_index do |route, index| %>
+<% routes.each do |route| %>
   <%= route.helper %>: definePathHelper('<%= route.verb %>', '<%= route.path %>'),
 <% end %>
 }

data/lib/js_from_routes/template_all.js.erb

@@ -0,0 +1,11 @@
+//
+// DO NOT MODIFY: This file was automatically generated by JsFromRoutes.
+<% helpers.each do |helper| %>
+import <%= helper.js_name %> from '~/<%= helper.import_filename %>'
+<% end %>
+
+export default {
+<% helpers.each do |helper| %>
+  <%= helper.js_name %>,
+<% end %>
+}

data/lib/js_from_routes/version.rb

@@ -4,5 +4,5 @@
 # Generates one file per controller, and one function per route.
 module JsFromRoutes
   # Public: This library adheres to semantic versioning.
-  VERSION = "2.0.0"
+  VERSION = "2.0.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: js_from_routes
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.0.1
 platform: ruby
 authors:
 - Máximo Mussini
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-03-13 00:00:00.000000000 Z
+date: 2021-03-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -139,11 +139,13 @@ extra_rdoc_files:
 - README.md
 files:
 - CHANGELOG.md
+- LICENSE.txt
 - README.md
 - lib/js_from_routes.rb
 - lib/js_from_routes/generator.rb
 - lib/js_from_routes/railtie.rb
 - lib/js_from_routes/template.js.erb
+- lib/js_from_routes/template_all.js.erb
 - lib/js_from_routes/version.rb
 homepage: https://github.com/ElMassimo/js_from_routes
 licenses: