im 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 844192c05246f7a6fdf91f2999e1af62ffa0124fafc26666b0215bebbb276645
-  data.tar.gz: a077e568115fc13153de58c087288c465c1f7be1851499f511c2a5372e83d5ca
+  metadata.gz: 3f60f56fa26101e6aeec8d3a9123f1ce8196a60ff559931ec91418316cef13e2
+  data.tar.gz: 445bf0961717077dd35e5ab900b1ab235b25a834a0b1123ed6936c2770439872
 SHA512:
-  metadata.gz: a6769bba616d834f2869366bdd072120cacf0e596e59a390433dd3b8380ab14e501e1e88254ff11f281e8a7df7e5a48706712669d01fef711ed3832c84ad6af8
-  data.tar.gz: 8857482df7b59722dae014fa5f5b789e16f5407dae62643907cd9578329fcc4c83bc0cdca817c74d712479401562ad615c84599c2a987e5c97f981c0a1c17730
+  metadata.gz: d0c2063a12bc66f6e86565a27d1e58e2079a88466a61c42a9830fbb0705864ee33f1c780f367dbe61e55b1e21a741cd6c05fc2e4cb7c50ee2bca1625096898c1
+  data.tar.gz: 4ba1c608ba252e26625ddd136fcaddb3ac8b9f6a5f79db80796ce82ebd8b96da1560b946c79d31a8e658c1fbe5e727d6e68c793dd6a8944e6ceb60b62dd01182

data/CHANGELOG.md

@@ -0,0 +1,19 @@
+## [Unreleased]
+
+## [0.1.2] - 2022-09-16
+- Fix gemspec
+
+## [0.1.1] - 2022-09-16
+
+- Fix TracePoint event
+- Simplify import inspect
+- Remove unnecessary Kernel#autoload patch
+- Encode comprehensive list of top-level constants
+
+## [0.1.0] - 2022-09-15
+
+- Initial release, requires patched version of Ruby.
+
+## [0.0.1] - 2022-07-13
+
+- Stub

data/Gemfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in im.gemspec
+gemspec
+
+gem "rspec", "~> 3.0"

data/Gemfile.lock

@@ -0,0 +1,37 @@
+PATH
+  remote: .
+  specs:
+    im (0.1.2)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.5.0)
+    rake (13.0.6)
+    rake-compiler (1.2.0)
+      rake
+    rspec (3.11.0)
+      rspec-core (~> 3.11.0)
+      rspec-expectations (~> 3.11.0)
+      rspec-mocks (~> 3.11.0)
+    rspec-core (3.11.0)
+      rspec-support (~> 3.11.0)
+    rspec-expectations (3.11.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.11.0)
+    rspec-mocks (3.11.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.11.0)
+    rspec-support (3.11.0)
+
+PLATFORMS
+  x86_64-linux
+
+DEPENDENCIES
+  im!
+  rake (~> 13.0)
+  rake-compiler
+  rspec (~> 3.0)
+
+BUNDLED WITH
+   2.4.0.dev

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2022 Chris Salzberg
+
+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/README.md

@@ -0,0 +1,64 @@
+# Im
+
+Im is a (currently) experimental implementation of import modules in Ruby,
+similar to systems like CommonJS, ESmodules, and RequireJS in Javascript. It
+requires a patched version of Ruby which you will need to build in order to use
+the gem.
+
+## Installation
+
+Im requires a patched version of Ruby to use; if not installed, the gem will raise and exit.
+
+You can find the patched version of Ruby here:
+
+https://github.com/shioyama/ruby/tree/import_modules
+
+Once installed, install the gem and the error should go away.
+
+## Usage
+
+Extend `Im` and use `import` to import files or gems under an anonymous module namespace:
+
+```ruby
+require "im"
+
+extend Im
+
+mod = import "activemodel"
+#=> #<Im::Import:0x00007f2d34dfd0c8 root: active_model>
+```
+
+Constants in the imported files are under the returned module, not the root namespace:
+
+```ruby
+ActiveModel
+#=> uninitialized constant ActiveModel (NameError)
+
+mod::ActiveModel
+#=> ActiveModel
+```
+
+You can now assign your custom parent namespace and use the gem constants as always:
+
+```ruby
+MyRails = mod
+
+class EmailContact
+  include MyRails::ActiveModel::API
+
+  attr_accessor :name
+  validates :name, presence: true
+end
+
+contact = EmailContact.new
+contact.valid?
+#=> false
+
+contact.name = "foo"
+contact.valid?
+#=> true
+```
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/lib/im/autoload.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Im
+  module Autoload
+    def autoload(name, path)
+      Im.autoloads[path] = Im.current_import if Im.current_import
+      super(name, path)
+    end
+  end
+end

data/lib/im/constants.rb

@@ -0,0 +1,103 @@
+module Im
+  # It's faster to just hard-code constants than to introspect them at runtime
+  CONSTANTS = [
+    :ArgumentError,
+    :Array,
+    :BasicObject,
+    :Binding,
+    :Class,
+    :ClosedQueueError,
+    :Comparable,
+    :Complex,
+    :ConditionVariable,
+    :DidYouMean,
+    :Dir,
+    :Encoding,
+    :EncodingError,
+    :Enumerable,
+    :Enumerator,
+    :EOFError,
+    :Errno,
+    :ErrorHighlight,
+    :Exception,
+    :FalseClass,
+    :Fiber,
+    :FiberError,
+    :File,
+    :FileTest,
+    :Float,
+    :FloatDomainError,
+    :FrozenError,
+    :GC,
+    :Gem,
+    :Hash,
+    :IndexError,
+    :Integer,
+    :Interrupt,
+    :IO,
+    :IOError,
+    :Kernel,
+    :KeyError,
+    :LoadError,
+    :LocalJumpError,
+    :Marshal,
+    :MatchData,
+    :Math,
+    :Method,
+    :Module,
+    :Monitor,
+    :MonitorMixin,
+    :Mutex,
+    :NameError,
+    :NilClass,
+    :NoMatchingPatternError,
+    :NoMatchingPatternKeyError,
+    :NoMemoryError,
+    :NoMethodError,
+    :NotImplementedError,
+    :Numeric,
+    :Object,
+    :ObjectSpace,
+    :Proc,
+    :Process,
+    :Queue,
+    :Ractor,
+    :Random,
+    :Range,
+    :RangeError,
+    :Rational,
+    :RbConfig,
+    :Refinement,
+    :Regexp,
+    :RegexpError,
+    :RubyVM,
+    :RuntimeError,
+    :ScriptError,
+    :SecurityError,
+    :Set,
+    :Signal,
+    :SignalException,
+    :SizedQueue,
+    :StandardError,
+    :StopIteration,
+    :String,
+    :Struct,
+    :Symbol,
+    :SyntaxError,
+    :SystemCallError,
+    :SystemExit,
+    :SystemStackError,
+    :Thread,
+    :ThreadError,
+    :ThreadGroup,
+    :Time,
+    :TracePoint,
+    :TrueClass,
+    :TypeError,
+    :UnboundMethod,
+    :UncaughtThrowError,
+    :UnicodeNormalize,
+    :Warning,
+    :ZeroDivisionError,
+  ]
+end

data/lib/im/kernel.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Kernel
+  alias_method :im_original_require, :require
+
+  def require(path)
+    if Im.autoloads.key?(path)
+      return Im.with_context(Im.autoloads.delete(path)) do |_context|
+        !!Im.import(path)
+      end
+    end
+
+    loaded = im_original_require(path)
+    return loaded unless Im.current_import
+
+    if resolved = $LOAD_PATH.resolve_feature_path(path)
+      if Im.registry.key?(resolved_path = resolved[1])
+        _, modules = Im.registry[resolved_path]
+
+        modules.each do |m|
+          next unless name = m.name
+
+          # Do not assign constants that are aliased to root namespace
+          root = name.split("::", 2)[0]
+          next if Object.const_defined?(root) &&
+            Im.current_import.const_defined?(root, false) &&
+            Object.const_get(root) == Im.current_import.const_get(root)
+
+          Im.current_import.const_set(name, m) unless Im.current_import.const_defined?(name, false)
+        end
+      else
+        Im.registry[resolved_path] ||= [Im.current_import, []] if Im.current_import
+      end
+    end
+
+    return loaded
+  end
+end

data/lib/im/module.rb

@@ -0,0 +1,8 @@
+class Module
+  alias_method :im_original_autoload, :autoload
+
+  def autoload(name, path)
+    Im.autoloads[path] = Im.current_import if Im.current_import
+    im_original_autoload(name, path)
+  end
+end

data/lib/im/ruby_version_check.rb

@@ -0,0 +1,22 @@
+RubyVersionCheck = Module.new
+
+unless RubyVersionCheck.name == "RubyVersionCheck"
+  raise RuntimeError, <<~MSG
+
+
+\e[33m!!! RUNNING INCOMPATIBLE VERSION OF RUBY !!!\e[0m
+
+In order to implement module imports, Im depends on features not currently
+available in Ruby. To use it, you must build a custom version of Ruby,
+currently available at:
+
+https://github.com/shioyama/ruby/tree/import_modules
+
+Install this Ruby following the instructions here:
+
+https://docs.ruby-lang.org/en/master/contributing/building_ruby_md.html
+
+Once installed, ensure you are using this patched version and then gem install Im,
+and this message should no longer appear.
+MSG
+end

data/lib/im/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Im
+  VERSION = "0.1.3"
+end

data/lib/im.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+module Im
+  load $LOAD_PATH.resolve_feature_path("im/ruby_version_check")[1], true
+  require "im/version"
+  require "im/kernel"
+
+  class << self
+    attr_reader :current_import
+    attr_reader :tracer
+
+    def with_context(context)
+      original_context = current_import
+      @current_import = context
+      yield(context)
+    ensure
+      @current_import = original_context
+    end
+
+    def registry
+      @registry ||= {}
+    end
+
+    def autoloads
+      @autoloads ||= {}
+    end
+  end
+
+  class Import < Module
+    def initialize(root)
+      @root = root
+      super()
+      Im::CONSTANTS.each do |const|
+        self.const_set(const, Object.const_get(const))
+      end
+    end
+
+    def inspect
+      @inspect ||= "<#Im::Import root: #{@root}>"
+    end
+  end
+
+  def import(path)
+    if resolved = $LOAD_PATH.resolve_feature_path(path)
+      resolved_path = resolved[1]
+      raise LoadError, "import can only import ruby files" unless resolved[0] == :rb
+    else
+      raise LoadError, "cannot load such file -- #{path}"
+    end
+
+    Im.registry.fetch(resolved_path) do
+      # handle autoload within import
+      return nil if $LOADED_FEATURES.include?(resolved_path)
+
+      $LOADED_FEATURES << resolved_path
+
+      context = Im.current_import || Import.new(path)
+
+      Im.with_context(context) do
+        originally_enabled = Im.tracer.enabled?
+        Im.tracer.enable
+        load resolved_path, context
+        Im.tracer.disable unless originally_enabled
+      end
+
+      Im.registry[resolved_path] ||= [context, []]
+    end[0]
+  end
+
+  module RootNamespaceRedirect
+    def const_missing(name)
+      if Im.current_import && Im.current_import.const_defined?(name)
+        Im.current_import.const_get(name)
+      else
+        super
+      end
+    end
+  end
+
+  @tracer = TracePoint.new(:class) do |event|
+    if resolved = $LOAD_PATH.resolve_feature_path(event.path)
+      resolved_path = resolved[1]
+      if Im.registry.key?(resolved_path)
+        (Im.registry[resolved_path][1] << event.self).uniq!
+      else
+        Im.registry[resolved_path] = [Im.current_import, [event.self]]
+      end
+    end
+  end
+
+  require "im/module"
+  require "im/autoload"
+  require "im/constants"
+
+  extend self
+end
+
+Object.extend Im::RootNamespaceRedirect

metadata

@@ -1,12 +1,12 @@
 --- !ruby/object:Gem::Specification
 name: im
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.3
 platform: ruby
 authors:
 - Chris Salzberg
 autorequire:
-bindir: bin
+bindir: exe
 cert_chain: []
 date: 2022-09-16 00:00:00.000000000 Z
 dependencies:
@@ -58,14 +58,29 @@ email:
 executables: []
 extensions: []
 extra_rdoc_files: []
-files: []
+files:
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/im.rb
+- lib/im/autoload.rb
+- lib/im/constants.rb
+- lib/im/kernel.rb
+- lib/im/module.rb
+- lib/im/ruby_version_check.rb
+- lib/im/version.rb
 homepage: https://github.com/shioyama/im
 licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/shioyama/im
   source_code_uri: https://github.com/shioyama/im
+  bug_tracker_uri: https://github.com/shioyama/im/issues
   changelog_uri: https://github.com/shioyama/im/CHANGELOG.md
+  rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
 require_paths: