import_from 0.1.0

data/lib/import_from/core_ext/kernel.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+# Kernel extensions providing Python-like import syntax for Ruby.
+module Kernel
+  # Imports constants from a gem into an isolated Ruby::Box namespace
+  #
+  # This method creates a new isolated Ruby::Box, loads the specified gem
+  # within that box, and extracts requested constants into the Object namespace.
+  # This prevents namespace collisions and allows multiple versions of gems
+  # to coexist.
+  #
+  # @api public
+  #
+  # @example Import specific classes from a gem
+  #   from 'active_support', import: 'HashWithIndifferentAccess'
+  #   HashWithIndifferentAccess.new # => Available in global namespace
+  #
+  # @example Import multiple constants
+  #   from 'my_gem', import: ['User', 'Post']
+  #
+  # @example Import all constants with wildcard and alias the box
+  #   from 'my_gem', import: '*', as: :MyGem
+  #   MyGem.const_get('User') # => Access via box
+  #
+  # @example Import from relative path
+  #   from './lib/my_module', import: 'MyClass'
+  #
+  # @param gem_name [String] The name of the gem to load, or a relative path starting with '.'
+  # @param import [String, Array<String>] The constant name(s) to import, or '*' for wildcard import
+  # @param as [Symbol, String, nil] Optional alias name to assign the Ruby::Box instance to
+  #
+  # @return [Object, Array<Object>, Ruby::Box] Returns the imported constant, an array of constants if multiple, or the
+  #   Ruby::Box if wildcard import
+  #
+  # @raise [NameError] If the requested constant does not exist in the gem
+  #
+  # @raise [LoadError] If the gem cannot be loaded
+  #
+  def from(gem_name, import:, as: nil)
+    # Create a new isolated box
+    box = Ruby::Box.new
+
+    require 'bundler/setup'
+
+    # Copy the load path into the box
+    $LOAD_PATH.each do |path|
+      # $LOAD_PATH << path
+      box.eval("$LOAD_PATH << #{path.inspect}")
+    end
+
+    # Load the library into the box
+    # If it's a relative path, use require_relative, otherwise require
+    if gem_name.start_with?('.')
+      box.require_relative(gem_name)
+    else
+      require gem_name
+      box.require(gem_name)
+    end
+
+    Object.const_set(as, box) if as
+
+    return box if import == '*'
+
+    # Extract the requested constants
+    targets = Array(import)
+    results = targets.map do |const_name|
+      # Fetch the constant from the box namespace
+      klass = box.const_get(const_name)
+
+      # Inject the constant into the caller's namespace (Object by default)
+      # This makes it look like it was imported globally/locally
+      Object.const_set(const_name, klass)
+      klass
+    end
+
+    results.size == 1 ? results.first : results
+  end
+
+  # Imports constants with Python-style syntax supporting flexible parameter order
+  #
+  # This method provides a more Pythonic interface to the +from+ method, allowing
+  # either "import 'gem_name'" to import entire namespaces or "import 'Class', from: 'gem_name'"
+  # to import specific constants.
+  #
+  # @api public
+  #
+  # @example Import entire gem namespace
+  #   import 'active_support', as: :AS
+  #   AS.const_get('HashWithIndifferentAccess')
+  #
+  # @example Import specific constants from a gem
+  #   import ['User', 'Post'], from: 'my_gem'
+  #
+  # @example Import with alias
+  #   import 'MyClass', from: 'my_gem', as: :MyAlias
+  #
+  # @param imports [String, Array<String>] The gem name (when from: is nil) or constant name(s) to import
+  # @param from [String, nil] The gem name to import from, or nil to import entire namespace
+  # @param as [Symbol, String, nil] Optional alias name for the imported constant or Ruby::Box
+  #
+  # @return [Object, Array<Object>, Ruby::Box] Returns the imported constant(s) or Ruby::Box instance
+  #
+  # @raise [NameError] If the requested constant does not exist in the gem
+  #
+  # @raise [LoadError] If the gem cannot be loaded
+  #
+  def import(imports, from: nil, as: nil)
+    if from.nil?
+      from(imports, import: '*', as: as)
+    else
+      from(from, import: imports, as: as)
+    end
+  end
+end

data/lib/import_from/version.rb

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

data/lib/import_from.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require_relative 'import_from/version'
+require_relative 'import_from/core_ext/kernel'
+
+ENV['RUBY_BOX'] = '1' unless Ruby::Box.enabled?
+
+# Entry point
+module ImportFrom
+end

data/mise.toml

@@ -0,0 +1,2 @@
+[tools]
+ruby = "4.0.0"

data/sig/import_from.rbs

@@ -0,0 +1,4 @@
+module ImportFrom
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification
+name: import_from
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Wilson Silva
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: A Ruby gem that provides a Python-like syntax for importing modules from
+  Ruby gems and files, making it easier to manage dependencies and imports in your
+  Ruby applications.
+email:
+- wilson.dsigns@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".claude/commands/document.md"
+- ".claude/commands/gemfile/update.md"
+- ".claude/commands/test.md"
+- ".claude/docs/yard.md"
+- ".claude/settings.local.json"
+- ".editorconfig"
+- ".env"
+- ".overcommit.yml"
+- ".rspec"
+- ".rubocop.yml"
+- ".yardstick.yml"
+- AGENTS.md
+- CHANGELOG.md
+- CLAUDE.md
+- CODE_OF_CONDUCT.md
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- Steepfile
+- docs/ruby-box.md
+- docs/todo.md
+- examples/Gemfile
+- examples/Gemfile.lock
+- examples/README.md
+- examples/from_x_import_star.rb
+- examples/from_x_import_star_as_y.rb
+- examples/from_x_import_y.rb
+- examples/from_x_import_y_as_z.rb
+- examples/from_x_y_import_a.rb
+- examples/from_x_y_import_a_as_b.rb
+- examples/import_x.rb
+- examples/import_x_as_y.rb
+- examples/import_x_as_y_scoped.rb
+- examples/import_x_y_z.rb
+- lib/import_from.rb
+- lib/import_from/core_ext/kernel.rb
+- lib/import_from/version.rb
+- mise.toml
+- sig/import_from.rbs
+homepage: https://github.com/wilsonsilva/import_from
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/wilsonsilva/import_from
+  source_code_uri: https://github.com/wilsonsilva/import_from
+  changelog_uri: https://github.com/wilsonsilva/import_from/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 4.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: Provides a Python-like syntax for importing modules from Ruby gems and files.
+test_files: []