dirload 0.6.2 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 96c8cec00fefea226ccd40b45b876c674ab1c58782033134d42b202c3b4fe27e
-  data.tar.gz: 52bd411227f4d22d78162e0a4a90eb1c23a80d9b63ce434d88e274eb173b4dec
+  metadata.gz: 1b730495cdf58d9fd471583c4860289c6de962384bf69060c577fd768351f1c3
+  data.tar.gz: c24de8fccddb64f0f8bb16c5250206e6ee06f5be45833ee1a91ab866be291338
 SHA512:
-  metadata.gz: 70624c6d69e6a945a3e1cb18c55483ca07724cc683641dfe6ff1a3d2b733c5079c3294e1e4dada1c1612be38c7292cd064882cc0d8efb79eddcf52b2ebf74d73
-  data.tar.gz: 86c1ea5c9d70fe629351f2b07a6f1441c3bef6ff71ac6b7df2d8350e417c2dbebe09eb9f2025fe8d01aa56b01c268682d364e3ba9d3383fdec286da7b8a9e97b
+  metadata.gz: 72201134942139589a3133ba434431100d1d4ed8256806277227e427aea4c72e4a2ac46b42d4dae29f88b840fe680642b2f5aba6a54a77cca2b696f2d92705bf
+  data.tar.gz: 1e6c599bc9ecfa5a1294ba706f0fa65ddc67326f58c59cff4730818e48aff299413df2858412c817870f41712e1d1389ba36511fb5c3e5e3fd792847b9943abd

data/lib/adapters/adapter.rb

@@ -3,13 +3,17 @@
 # rubocop:disable Lint/UnusedMethodArgument
 
 module Dirload
+  # A step is run on all files before moving on to the next step.
   class Adapter
     EXTENSIONS = [].freeze
 
+    # Map definitions and dependencies.
     def mapload(file_path:) = nil
 
+    # Then autoload all dependencies for those files.
     def preload(file_path:) = nil
 
+    # Now we can load the file into Ruby.
     def evaluate(file_path:, top_level_binding: nil) = nil
   end
 end

data/lib/adapters/markdown_adapter.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require 'yaml'
-require 'lowkey'
 require_relative 'adapter'
 
 module Dirload

data/lib/adapters/rbx_adapter.rb

@@ -12,20 +12,18 @@ module Dirload
   class RBXAdapter < Adapter
     EXTENSIONS = ['rbx'].freeze
 
-    # Map all definitions and dependencies.
     def mapload(file_path:)
       Lowkey.load(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)
+      # Load fresh because wrapping render methods mutates the file proxy, which would break re-evaluating a cached one.
+      file_proxy = Lowkey.load(file_path)
       templates = wrap_render_methods(file_proxy:)
 
       # 2. "Class Load" phase.
@@ -33,7 +31,7 @@ module Dirload
       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 (like LowNode) and the template contains antlers syntax.
+      # Templates only exist when there's a template engine and the template contains template syntax.
       templates.each do |namespace, method_template|
         klass = Object.const_get(namespace)
         method, template = method_template
@@ -42,8 +40,7 @@ module Dirload
 
         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:)
+        klass.build_template(template:, params:, engine: Dirload.template_engine, namespace:)
       end
     end
 
@@ -64,7 +61,7 @@ module Dirload
 
         render_method_body = render_method.body.export
 
-        if defined?(Antlers) && ['{', '<{'].any? { |needle| render_method_body.include?(needle) }
+        if Dirload.template_engine && ['{', '<{'].any? { |needle| render_method_body.include?(needle) }
           templates[class_proxy.namespace] = [render_method, render_method_body]
         end
 

data/lib/adapters/ruby_adapter.rb

@@ -8,17 +8,14 @@ module Dirload
   class RubyAdapter < Adapter
     EXTENSIONS = ['rb'].freeze
 
-    # Map all definitions and dependencies.
     def mapload(file_path:)
       Lowkey.load(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

data/lib/dirload.rb

@@ -7,45 +7,62 @@ require_relative 'loader'
 require_relative 'metadata'
 
 module Dirload
+  module_function
+
   class UnsupportedFileType < StandardError; end
   class UnsupportedTemplate < StandardError; end
 
   ADAPTERS = [MarkdownAdapter.new, RBXAdapter.new, RubyAdapter.new].freeze
 
-  def dirload(path, pwd = Dir.pwd, error: false) # rubocop:disable Metrics/AbcSize
-    absolute_path = File.expand_path(path, pwd)
+  Config = Struct.new(:template_engine)
 
-    return adapter_load(file_path: absolute_path) unless File.directory?(absolute_path)
+  def config
+    @config ||= Config.new(nil)
+  end
 
-    loaded_paths = {}
-    missed_paths = []
-    file_types = {}
+  def configure
+    yield(config)
+  end
 
-    file_paths(absolute_path:).each do |file_path|
-      if (adapter = find_adapter(file_path:))
-        loaded_paths[file_path] = adapter
-      else
-        missed_paths << adapter
-      end
+  # The engine that RBX templates are built with. Defaults to Antlers when another gem (such as LowNode) requires it.
+  def template_engine
+    config.template_engine || (Antlers if defined?(Antlers))
+  end
 
-      file_types[extension(file_path:)] ||= []
-      file_types[extension(file_path:)] << file_path
-    end
+  module KernelMethods
+    def dirload(path, pwd = Dir.pwd, error: false) # rubocop:disable Metrics/AbcSize
+      absolute_path = File.expand_path(path, pwd)
 
-    step(:mapload, loaded_paths:)
-    step(:preload, loaded_paths:)
-    step(:evaluate, loaded_paths:)
+      return Dirload.file_load(file_path: absolute_path) unless File.directory?(absolute_path)
 
-    Metadata.new(loaded_paths:, missed_paths:, file_types:)
-  end
+      loaded_paths = {}
+      missed_paths = []
+      file_types = {}
 
-  private
+      Dirload.file_paths(absolute_path:).each do |file_path|
+        if (adapter = Dirload.find_adapter(file_path:))
+          loaded_paths[file_path] = adapter
+        else
+          missed_paths << adapter
+        end
+
+        file_types[Dirload.extension(file_path:)] ||= []
+        file_types[Dirload.extension(file_path:)] << file_path
+      end
+
+      Dirload.step(:mapload, loaded_paths:)
+      Dirload.step(:preload, loaded_paths:)
+      Dirload.step(:evaluate, loaded_paths:)
+
+      Metadata.new(loaded_paths:, missed_paths:, file_types:)
+    end
+  end
 
   def file_paths(absolute_path:)
     Dir["#{absolute_path}/**/*"].filter { !File.directory?(it) }
   end
 
-  def adapter_load(file_path:)
+  def file_load(file_path:)
     adapter = find_adapter(file_path:)
 
     raise(UnsupportedFileType, "Could not load #{file_path}") if adapter.nil?
@@ -68,4 +85,4 @@ module Dirload
   end
 end
 
-Kernel.send(:include, Dirload)
+Kernel.send(:include, Dirload::KernelMethods)

data/lib/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Dirload
-  VERSION = '0.6.2'
+  VERSION = '0.7.0'
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: dirload
 version: !ruby/object:Gem::Version
-  version: 0.6.2
+  version: 0.7.0
 platform: ruby
 authors:
 - maedi
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-10-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: lowkey
@@ -58,7 +58,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 3.6.2
 specification_version: 4
 summary: An autoloader without namespace and folder structure conventions
 test_files: []