lowload 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ff485e94bc43e900c70c84618b8291a7f329f65f5c77f800e4f63441abea255a
-  data.tar.gz: a0791c307b326183ad64da9a094e2591e368edd1871b075eff8432cef79a8467
+  metadata.gz: 47cc7e9bc1bf7d856e12c1a91d6cd4ab388a973d73bb8fb7d2a8498ea3631cf4
+  data.tar.gz: '04864e7a3f9ab0644ebf3356095369859eb025f19087892f3c86b5b54bba35ed'
 SHA512:
-  metadata.gz: 3a91ef3b898d28435381872dfe19589699ab7fe396969780001d4c5d27e144518cd3cb5eb9165ebb3e46c5149a28fd2d511b698f3beb760e95d58fe45a0b0ef9
-  data.tar.gz: fee30da0af61c8160415a6017a9baac910fb529ecb66239b4198c1a068d58054372e8fb00df64823cd6b4a335c4754919fda61a3316b9a471ea26b6ac301ea4c
+  metadata.gz: 81e0d64d2f3ab72619663d2f6649c8affe284fe106989aad6c98dd5d7d760b5407f28171af96447c241c55e86cd444fef9f7702b748a35bab1dfa77c408c2497
+  data.tar.gz: fed385baed2a6d64c26051f34d42e24d022a78823cbd128790c4cfa90e82b32a07576edb475e3c89c2942dc9950b267d2311b8fa718b81247bd5e063dfda5e80

data/lib/adapters/adapter.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module LowLoad
+  class Adapter
+    EXTENSIONS = []
+
+    def metadata(file_path:)
+    end
+
+    def preload(file_path:)
+    end
+
+    def evaluate(file_path:, top_level_binding: nil)
+    end
+  end
+end

data/lib/adapters/markdown_adapter.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'yaml'
+require 'lowkey'
+require_relative 'adapter'
+
+module LowLoad
+  class MarkdownAdapter < Adapter
+    EXTENSIONS = ['md', 'rd', 'markdown', 'raindown']
+
+    def metadata(file_path:)
+      meta_lines = []
+      yaml_lines = []
+
+      File.foreach(file_path).with_index do |line, index|
+        if line.strip == '---'
+          meta_lines << index + 1
+          break if meta_lines.count > 1
+        else
+          yaml_lines << line
+        end
+      end
+
+      YAML.safe_load(yaml_lines.join, symbolize_names: true)
+    end
+  end
+end

data/lib/adapters/rbx_adapter.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require 'lowkey'
+require_relative 'adapter'
+require_relative '../loader'
+
+def top_level_binding
+  binding
+end
+
+module LowLoad
+  class RBXAdapter < Adapter
+    EXTENSIONS = ['rbx']
+
+    # Map all definitions and dependencies.
+    def metadata(file_path:)
+      Lowkey.load(file_path)
+
+      { file_path: }
+    end
+
+    # Then autoload all dependencies for those files.
+    def preload(file_path:)
+      Loader.add_autoloads(file_proxy: Lowkey[file_path])
+    end
+
+    # Now we can load the file into Ruby.
+    def evaluate(file_path:)
+      # 1. "File Load" phase.
+      file_proxy = Lowkey[file_path] || Lowkey.load(file_path)
+      templates = wrap_render_methods(file_proxy:)
+
+      # 2. "Class Load" phase.
+      # Not a security risk because "eval" is equivalent to "load" or "require_relative" in this context.
+      eval(file_proxy.export, top_level_binding, file_proxy.file_path, 0) # rubocop:disable Security/Eval
+
+      # 3. "Runtime" phase (before low nodes are rendered).
+      # Templates only exist if antlers gem has been required by another gem (such as LowNode) and the template contains antlers syntax.
+      templates.each do |namespace, method_template|
+        klass = Object.const_get(namespace)
+        method, template = method_template
+        # TODO: If params contain "**props" or similar then send that, so that LowNode can replicate it.
+        params = method.params.map(&:name)
+
+        next unless supports_templates?(klass) || raise(UnsupportedTemplate, "Template for '#{namespace}' identified but not implemented")
+
+        # TODO: Make template engine configurable.
+        klass.build_template(template:, params:, engine: Antlers, namespace:)
+      end
+    end
+
+    private
+
+    def supports_templates?(klass)
+      klass.respond_to?(:render) && klass.respond_to?(:template) && klass.respond_to?(:build_template)
+    end
+
+    def wrap_render_methods(file_proxy:)
+      # GOAL: Templates could be organised by method and template rendering engine.
+      templates = {}
+
+      file_proxy.definitions.each_value do |class_proxy|
+        render_method = class_proxy.respond_to?(:instance_methods) ? class_proxy.instance_methods[:render] : nil
+
+        next unless render_method
+
+        render_method_body = render_method.body.export
+
+        if defined?(Antlers) && ['{', '<{'].any? { |needle| render_method_body.include?(needle) }
+          templates[class_proxy.namespace] = [render_method, render_method_body]
+        end
+
+        # Intended to target HTML or Antlers tags. Use HEREDOC "<<~" in a plain Ruby (".rb") file, not RBX.
+        render_method.body.wrap(prefix: '%q{', suffix: '}') if render_method_body.strip.start_with?('<')
+      end
+
+      templates
+    end
+  end
+end

data/lib/adapters/ruby_adapter.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require 'lowkey'
+require_relative 'adapter'
+require_relative '../loader'
+
+module LowLoad
+  class RubyAdapter < Adapter
+    EXTENSIONS = ['rb']
+
+    # Map all definitions and dependencies.
+    def metadata(file_path:)
+      Lowkey.load(file_path)
+
+      { file_path: }
+    end
+
+    # Then autoload all dependencies for those files.
+    def preload(file_path:)
+      Loader.add_autoloads(file_proxy: Lowkey[file_path])
+    end
+
+    # Now we can load the file into Ruby.
+    def evaluate(file_path:)
+      load(file_path)
+    end
+  end
+end

data/lib/lowload.rb

@@ -1,99 +1,51 @@
 # frozen_string_literal: true
 
-require 'antlers'
-require 'lowkey'
-
+require_relative 'adapters/markdown_adapter'
+require_relative 'adapters/rbx_adapter'
+require_relative 'adapters/ruby_adapter'
 require_relative 'loader'
-
-def top_level_binding
-  binding
-end
+require_relative 'metadata'
 
 module LowLoad
+  class UnsupportedFileType < StandardError; end
   class UnsupportedTemplate < StandardError; end
 
   class << self
-    # Files are mapped, autoloaded, then loaded into Ruby in 3 separate stages.
+    ADAPTERS = [MarkdownAdapter.new, RBXAdapter.new, RubyAdapter.new]
+
     def dirload(path, pwd = Dir.pwd)
       absolute_path = File.expand_path(path, pwd)
-      file_paths = Dir["#{absolute_path}/**/*"]
+      file_paths = Dir["#{absolute_path}/**/*"].filter { !File.directory?(it) }
 
-      # Map all definitions and dependencies first.
-      file_paths.each do |file_path|
-        Lowkey.load(file_path)
+      file_path_adapters = file_paths.each_with_object({}) do |file_path, hash|
+        hash[file_path] = find_adapter(file_path:)
       end
 
-      # Then autoload all dependencies for those files.
-      file_paths.each do |file_path| # rubocop:disable Style/CombinableLoops
-        Loader.add_autoloads(file_proxy: Lowkey[file_path])
-      end
+      metadata = Metadata.new
+      metadata.process(file_path_adapters:)
+      step(:preload, file_path_adapters:)
+      step(:evaluate, file_path_adapters:)
 
-      # Now we can load the files into Ruby.
-      file_paths.each do |file_path| # rubocop:disable Style/CombinableLoops
-        lowload(file_path)
-      end
+      metadata
     end
 
-    # Dependencies must first be loaded by dirload() or required by the file.
     def lowload(file_path)
-      case File.extname(file_path).delete_prefix('.')
-      when 'rb'
-        load(file_path)
-      when 'rbx'
-        load_rbx(file_path)
-      end
-    end
-
-    private
-
-    def load_rbx(file_path)
-      # 1. "File Load" phase.
-      file_proxy = Lowkey[file_path] || Lowkey.load(file_path)
-      templates = wrap_render_methods(file_proxy:)
-
-      # 2. "Class Load" phase.
-      # Not a security risk because "eval" is equivalent to "load" or "require_relative" in this context.
-      eval(file_proxy.export, top_level_binding, file_proxy.file_path, 0) # rubocop:disable Security/Eval
+      adapter = find_adapter(file_path:)
 
-      # 3. "Runtime" phase (before LowNode instances are rendered).
-      # Templates only exist if antlers gem has been required by another gem (such as LowNode) and the template contains antlers syntax.
-      templates.each do |namespace, method_template|
-        klass = const_get(namespace)
-        method, template = method_template
-        # TODO: If params contain "**props" or similar then send that, so that LowNode can replicate it.
-        params = method.params.map(&:name)
+      raise(UnsupportedFileType, "Could not load #{file_path}") if adapter.nil?
 
-        next unless supports_templates?(klass) || raise(UnsupportedTemplate, "Template for '#{namespace}' identified but not implemented")
-
-        # TODO: Make template engine configurable.
-        klass.build_template(template:, params:, engine: Antlers, namespace:)
-      end
+      adapter.evaluate(file_path:)
     end
 
-    def supports_templates?(klass)
-      klass.respond_to?(:render) && klass.respond_to?(:template) && klass.respond_to?(:build_template)
-    end
-
-    def wrap_render_methods(file_proxy:)
-      # GOAL: Templates could be organised by method and template rendering engine.
-      templates = {}
-
-      file_proxy.definitions.each_value do |class_proxy|
-        render_method = class_proxy.respond_to?(:instance_methods) ? class_proxy.instance_methods[:render] : nil
-
-        next unless render_method
-
-        render_method_body = render_method.body.export
-
-        if defined?(Antlers) && ['{', '<{'].any? { |needle| render_method_body.include?(needle) }
-          templates[class_proxy.namespace] = [render_method, render_method_body]
-        end
-
-        # Intended to target HTML or Antlers tags. Use HEREDOC "<<~" in a plain Ruby (".rb") file, not RBX.
-        render_method.body.wrap(prefix: '%q{', suffix: '}') if render_method_body.strip.start_with?('<')
+    def step(step, file_path_adapters:)
+      file_path_adapters.each do |file_path, adapter|
+        adapter&.send(step, file_path:)
       end
+    end
 
-      templates
+    def find_adapter(file_path:)
+      extension = File.extname(file_path).delete_prefix('.')
+      ADAPTERS.find { |adapter| adapter.class::EXTENSIONS.include?(extension) }
     end
   end
 end

data/lib/metadata.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require_relative 'adapters/markdown_adapter'
+
+module LowLoad
+  class Metadata
+    EXTENSIONS = [
+      *::LowLoad::MarkdownAdapter::EXTENSIONS,
+      *::LowLoad::RBXAdapter::EXTENSIONS,
+      *::LowLoad::RubyAdapter::EXTENSIONS,
+    ]
+
+    attr_accessor :file_paths, :file_types, :tags
+
+    def initialize
+      @file_paths = []
+
+      @file_types = EXTENSIONS.each_with_object({}) do |extension, hash|
+        hash[extension] = []
+      end
+
+      @tags = {}
+    end
+    
+    def process(file_path_adapters:)
+      file_path_adapters.each do |file_path, adapter|
+        if (metadata = adapter&.metadata(file_path:))
+          metadata.merge!({
+            file_path:,
+            file_type: File.extname(file_path).delete_prefix('.'),
+            file_loaded: true,
+          })
+        else
+          metadata = { file_loaded: false }
+        end
+
+        append(metadata:)
+      end
+    end
+
+    def append(metadata:)
+      @file_paths << metadata[:file_path]
+      @file_types[metadata[:file_type]] = metadata[:file_path]
+
+      metadata[:tags]&.each do |tag|
+        @tags[tag] ||= []
+        @tags[tag] = metadata[:file_path]
+      end
+    end
+  end
+end

data/lib/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LowLoad
-  VERSION = '0.5.0'
+  VERSION = '0.6.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lowload
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - maedi
@@ -31,8 +31,13 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- lib/adapters/adapter.rb
+- lib/adapters/markdown_adapter.rb
+- lib/adapters/rbx_adapter.rb
+- lib/adapters/ruby_adapter.rb
 - lib/loader.rb
 - lib/lowload.rb
+- lib/metadata.rb
 - lib/version.rb
 homepage: https://github.com/low-rb/lowload
 licenses: []
@@ -53,7 +58,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.6
 specification_version: 4
 summary: An autoloader without namespace and folder structure conventions
 test_files: []