lowload 0.3.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9c841ed28307b4d9211362f9e30c4d73d0cf662ce537d2f448a36e030dc3c55e
+  data.tar.gz: 69e0f32e92d565083b51d2758d8f8acd3b28ea334b32e2143a9614a50f6c4f2d
+SHA512:
+  metadata.gz: 82a9791ac47f662317e94bdbda71c036efe6d5c13896a8a20a712fba57bca88b1461cf2318f56fc7a205ed2bbfb29331398a22c434406d2a2bad76a298a3c101
+  data.tar.gz: 8306cba1fd04398aa6ed5d83f56a389aa643e091679a71d034ef981c3699f9d10f1e7895dc8e88a2cfbddd67be6005f6c6019197584c9bd9e59bce84f1ce5465

data/lib/loader.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module LowLoad
+  class Loader
+    class MissingDependencyError < StandardError; end
+
+    class << self
+      def add_autoloads(file_proxy:)
+        autoloads = []
+
+        file_proxy.dependencies.each do |namespace_with_dependency|
+          *namespace, dependency = namespace_with_dependency.split('::')
+
+          definition_proxies = find_definition_proxies(namespace:, dependency:)
+
+          current_namespace = Object
+          namespace.each do |module_name|
+            current_namespace.const_set(module_name, Module.new) unless current_namespace.const_defined?(module_name)
+            current_namespace = current_namespace.const_get(module_name)
+          end
+
+          definition_proxies.each do |definition_proxy|
+            autoloads << { origin: file_proxy.file_path, current_namespace:, dependency:, file_path: definition_proxy.file_path }
+            current_namespace.autoload(dependency.to_sym, definition_proxy.file_path)
+          end
+        end
+
+        autoloads
+      end
+
+      def find_definition_proxies(namespace:, dependency:)
+        return Lowkey[dependency] || raise(MissingDependencyError) if namespace.empty?
+
+        namespace_with_dependency = [namespace, dependency].join('::')
+        return Lowkey[namespace_with_dependency] if Lowkey[namespace_with_dependency]
+
+        namespace.pop
+        find_definition_proxies(namespace:, dependency:)
+      end
+    end
+  end
+end

data/lib/lowload.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require 'lowkey'
+require_relative 'loader'
+
+def top_level_binding
+  binding
+end
+
+module LowLoad
+  class << self
+    # Files are mapped, autoloaded, then loaded into Ruby in 3 separate stages.
+    def dirload(path, pwd = Dir.pwd)
+      absolute_path = File.expand_path(path, pwd)
+      file_paths = Dir["#{absolute_path}/**/*"]
+
+      # Map all definitions and dependencies first.
+      file_paths.each do |file_path|
+        Lowkey.load(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
+
+      # Now we can load the files into Ruby.
+      file_paths.each do |file_path| # rubocop:disable Style/CombinableLoops
+        lowload(file_path)
+      end
+    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_proxy: Lowkey[file_path] || Lowkey.load(file_path))
+      end
+    end
+
+    private
+
+    def load_rbx(file_proxy:)
+      file_proxy.definitions.each_value do |class_proxy|
+        next unless class_proxy[:render]
+
+        class_proxy[:render].body.wrap(prefix: '%q{', suffix: '}')
+      end
+
+      # 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
+    end
+  end
+end

data/lib/maps/dependency_map.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module LowLoad
+  class FileProxy
+    attr_reader :path, :scope
+    attr_accessor :start_line, :end_line
+
+    def initialize(path:, scope:, start_line:, end_line: nil)
+      @path = path
+      @start_line = start_line
+      @end_line = end_line || start_line
+      @scope = scope
+    end
+
+    def lines?
+      start_line && end_line
+    end
+  end
+end

data/lib/version.rb

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

metadata

@@ -0,0 +1,60 @@
+--- !ruby/object:Gem::Specification
+name: lowload
+version: !ruby/object:Gem::Version
+  version: 0.3.0
+platform: ruby
+authors:
+- maedi
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: lowkey
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: LowLoad lets you use any module namespace convention and mix in manual
+  require statements.
+email:
+- maediprichard@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/loader.rb
+- lib/lowload.rb
+- lib/maps/dependency_map.rb
+- lib/version.rb
+homepage: https://github.com/low-rb/lowload
+licenses: []
+metadata:
+  homepage_uri: https://github.com/low-rb/lowload
+  source_code_uri: https://github.com/low-rb/lowload/src/branch/main
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.2
+specification_version: 4
+summary: An autoloader that is dumb but lets you do you
+test_files: []