import_from 0.1.0

data/.rubocop.yml

@@ -0,0 +1,77 @@
+plugins:
+  - rubocop-performance
+  - rubocop-rake
+  - rubocop-rspec
+
+AllCops:
+  TargetRubyVersion: 4.0
+  DisplayCopNames: true
+  NewCops: enable
+
+# ----------------------- Gemspec -----------------------
+
+Gemspec/DevelopmentDependencies:
+  Enabled: false
+
+# ----------------------- Style -----------------------
+
+
+Style/DocumentDynamicEvalDefinition:
+  Exclude:
+    - lib/import_from/core_ext/kernel.rb
+
+Style/MixinUsage:
+  Exclude:
+    - bin/console
+
+Style/StringLiterals:
+  Enabled: true
+  EnforcedStyle: single_quotes
+
+Style/StringLiteralsInInterpolation:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+# ----------------------- Layout ----------------------
+
+Layout/LineLength:
+  Max: 120
+  Exclude:
+    - import_from.gemspec
+
+# ---------------------- Metrics ----------------------
+
+Metrics/AbcSize:
+  Enabled: false
+
+Metrics/BlockLength:
+  Enabled: false
+
+Metrics/CyclomaticComplexity:
+  Enabled: false
+
+Metrics/ClassLength:
+  Enabled: false
+
+Metrics/MethodLength:
+  Enabled: false
+
+Metrics/ParameterLists:
+  CountKeywordArgs: false
+
+Metrics/PerceivedComplexity:
+  Enabled: false
+
+# ----------------------- RSpec -----------------------
+
+RSpec/ExampleLength:
+  Enabled: false
+
+RSpec/NestedGroups:
+  Enabled: false
+
+RSpec/MultipleMemoizedHelpers:
+  Enabled: false
+
+RSpec/MultipleExpectations:
+  Enabled: false

data/.yardstick.yml

@@ -0,0 +1,22 @@
+threshold: 100
+rules:
+  ApiTag::Presence:
+    enabled: true
+  ApiTag::Inclusion:
+    enabled: true
+  ApiTag::ProtectedMethod:
+    enabled: true
+  ApiTag::PrivateMethod:
+    enabled: true
+  ExampleTag:
+    enabled: true
+  ReturnTag:
+    enabled: true
+  Summary::Presence:
+    enabled: true
+  Summary::Length:
+    enabled: false
+  Summary::Delimiter:
+    enabled: true
+  Summary::SingleLine:
+    enabled: false

data/AGENTS.md

@@ -0,0 +1,157 @@
+# AGENTS.md
+
+This file provides guidance to WARP (warp.dev), Gemini CLI and Claude Code when working with code in this repository.
+
+## Project Overview
+
+`import_from` is a Ruby gem that provides Python-like import syntax for Ruby modules and classes. It leverages Ruby::Box (Ruby 4.0+ feature) to create isolated namespaces, preventing conflicts between different versions of gems and their dependencies.
+
+**Critical requirement**: All code execution requires Ruby 4.0+ with `RUBY_BOX=1` environment variable set.
+
+## Common Commands
+
+### Running Code
+All Ruby code must be executed with Ruby::Box enabled:
+```bash
+RUBY_BOX=1 ruby -W:no-experimental <file.rb>
+```
+
+The `-W:no-experimental` flag suppresses the experimental feature warning.
+
+### Development Setup
+```bash
+bin/setup                      # Install dependencies
+bin/console                    # Interactive console with gem loaded
+```
+
+### Testing
+```bash
+bundle exec rake spec          # Run all tests
+bundle exec rake coverage      # Run tests with coverage report
+```
+
+### Code Quality
+```bash
+bundle exec rake               # Run default task (spec + rubocop)
+bundle exec rake qa            # Full quality audit (rspec, rubocop, yard:junk, verify_measurements, bundle:audit)
+bundle exec rake rubocop       # Run RuboCop linter
+bundle exec rake rubocop:autocorrect      # Auto-fix safe RuboCop offenses
+bundle exec rake rubocop:autocorrect_all  # Auto-fix all RuboCop offenses
+```
+
+### Type Checking
+```bash
+bundle exec steep check        # Validate RBS type definitions
+bundle exec typeprof <file>    # Generate RBS definition for a Ruby file
+```
+
+### Documentation
+```bash
+bundle exec rake yard          # Generate YARD documentation
+bundle exec rake yard:format   # Format YARD documentation tags
+bundle exec rake yard:junk     # Check for documentation issues
+bundle exec rake yardstick_measure        # Measure documentation coverage
+bundle exec rake verify_measurements      # Verify 100% documentation coverage
+```
+
+### Security & Dependencies
+```bash
+bundle exec rake bundle:audit:check   # Check for security vulnerabilities
+bundle exec rake bundle:audit:update  # Update vulnerability database
+```
+
+### Release
+```bash
+bundle exec rake release       # Create tag, build gem, push to rubygems.org
+```
+
+## Architecture
+
+### Core Components
+
+**Ruby::Box Integration** (`lib/import_from.rb`)
+- Entry point that enforces `RUBY_BOX=1` is set
+- Raises an error immediately if Ruby::Box is not enabled
+- Loads the Kernel extensions that provide import syntax
+
+**Kernel Extensions** (`lib/import_from/core_ext/kernel.rb`)
+- Defines two main methods: `from()` and `import()`
+- Creates isolated Ruby::Box instances to load gems/modules
+- Handles constant extraction and namespace injection
+
+### How It Works
+
+The gem extends Ruby's `Kernel` module with two methods that mimic Python's import patterns:
+
+1. **`from(gem_name, import:, as:)`** - Import specific constants from a gem
+  - Creates a new isolated Ruby::Box
+  - Copies `$LOAD_PATH` into the box
+  - Requires the gem inside the box
+  - Extracts requested constants and injects them into `Object`
+  - Supports wildcard imports with `import: '*'`
+
+2. **`import(imports, from:, as:)`** - Flexible import with optional aliasing
+  - Wrapper around `from()` with more Pythonic parameter order
+  - When `from:` is nil, imports entire gem namespace
+  - Allows aliasing the box itself with `as:`
+
+### Ruby::Box Isolation
+
+Ruby::Box (experimental Ruby 4.0 feature) provides process-level namespace isolation:
+- Each box has its own set of constants, class variables, and global variables
+- Built-in classes can be monkey-patched within a box without affecting other boxes
+- Changes made in one box don't leak to other boxes or the main namespace
+- All code in a single `.rb` file runs in the same box
+
+Key limitations to be aware of:
+- Experimental feature requiring `RUBY_BOX=1` at Ruby process startup
+- Native extension installation may fail (stack level too deep)
+- `require 'active_support/core_ext'` may fail under Ruby::Box
+- Built-in methods won't see monkey-patched methods from user boxes
+
+## Code Style Guidelines
+
+### RuboCop Configuration
+- Target Ruby version: 4.0
+- String literals: Single quotes (enforced)
+- String interpolation: Double quotes (enforced)
+- Line length: 120 characters max
+- Most Metrics cops disabled (AbcSize, BlockLength, CyclomaticComplexity, MethodLength, etc.)
+
+### Documentation Standards
+- YARD documentation required for all public APIs
+- Project enforces 100% documentation coverage via yardstick
+- Use `bundle exec rake yard:format` to auto-format YARD tags
+- YARD tags are grouped (e.g., `@param` tags together with no blank lines between them)
+- Blank lines separate different tag types
+
+## Testing Approach
+
+### Framework
+- RSpec 3.13+
+- Monkey patching disabled (`config.disable_monkey_patching!`)
+- Expect syntax only (no `should`)
+- Example status persistence enabled (`.rspec_status`)
+
+### Running Single Tests
+```bash
+bundle exec rspec spec/specific_spec.rb
+bundle exec rspec spec/specific_spec.rb:42  # Run specific line
+```
+
+### Coverage
+SimpleCov is configured to generate coverage reports. Run `bundle exec rake coverage` to generate and automatically open the HTML report.
+
+## Project Constraints
+
+### Ruby Version
+Requires Ruby 4.0.0+ due to dependency on Ruby::Box. This is an experimental feature and may have breaking changes.
+
+### Runtime Environment
+Must run with `RUBY_BOX=1` environment variable set at process startup. Setting it after Ruby starts has no effect.
+
+### Known Issues with Ruby::Box
+- Stack overflow issues when installing native extensions
+- Compatibility problems with Active Support's core extensions
+- Built-in Ruby methods may not call overridden methods in boxes
+- No way to expose top-level methods defined in boxes to other boxes

data/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2025-12-28
+
+### Added
+- `import 'x'`
+- `from 'x', import: '*'`
+
+[0.1.0]: https://github.com/wilsonsilva/import_from/compare/27b35d...v0.1.0

data/CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,10 @@
+# Code of Conduct
+
+"import_from" follows [The Ruby Community Conduct Guideline](https://www.ruby-lang.org/en/conduct) in all "collaborative space", which is defined as community communications channels (such as mailing lists, submitted patches, commit comments, etc.):
+
+* Participants will be tolerant of opposing views.
+* Participants must ensure that their language and actions are free of personal attacks and disparaging personal remarks.
+* When interpreting the words and actions of others, participants should always assume good intentions.
+* Behaviour which can be reasonably considered harassment will not be tolerated.
+
+If you have any concerns about behaviour within this project, please contact us at ["wilson.dsigns@gmail.com"](mailto:"wilson.dsigns@gmail.com").

data/Guardfile

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+guard 'bundler' do
+  watch('import_from.gemspec')
+end
+
+guard 'bundler_audit', run_on_start: true do
+  watch('Gemfile.lock')
+end
+
+group 'tests' do
+  guard 'rspec', all_on_start: true, failed_mode: :focus,
+                 cmd: 'RUBY_BOX=1 COVERAGE=false bundle exec rspec --format progress' do
+    watch(%r{^spec/.+_spec\.rb$})
+    watch(%r{^lib/(.+)\.rb$}) { |m| "spec/#{m[1]}_spec.rb" }
+    watch('spec/spec_helper.rb') { 'spec' }
+  end
+end
+
+guard 'rubocop' do
+  watch(/.+\.rb$/)
+  watch(%r{(?:.+/)?\.rubocop\.yml$}) { |m| File.dirname(m[0]) }
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Wilson Silva
+
+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,129 @@
+# ImportFrom
+
+<div align="center">
+
+[![Gem Version](https://badge.fury.io/rb/import_from.svg)](https://badge.fury.io/rb/import_from)
+![Build](https://github.com/wilsonsilva/import_from/actions/workflows/main.yml/badge.svg)
+[![Maintainability](https://qlty.sh/gh/wilsonsilva/projects/import_from/maintainability.svg)](https://qlty.sh/gh/wilsonsilva/projects/import_from)
+[![Code Coverage](https://qlty.sh/gh/wilsonsilva/projects/import_from/coverage.svg)](https://qlty.sh/gh/wilsonsilva/projects/import_from)
+
+</div>
+
+Provides a Python-like syntax for importing modules and from Ruby gems and files.
+
+## Table of contents
+
+- [Key features](#-key-features)
+- [Installation](#-installation)
+- [Quickstart](#-quickstart)
+- [Examples](#-examples)
+- [Documentation](#-documentation)
+- [Development](#-development)
+  * [Type checking](#-type-checking)
+- [Contributing](#-contributing)
+- [License](#-license)
+- [Code of Conduct](#-code-of-conduct)
+
+## 🔑 Key features
+
+- **TODO**: TODO
+
+## 📦 Installation
+
+Install the gem and add to the application's Gemfile by executing:
+
+    $ bundle add import_from
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+    $ gem install import_from
+
+## ⚡️ Quickstart
+
+Create a file called `main.rb` and run it with `RUBY_BOX=1 ruby -W:no-experimental main.rb`:
+
+```ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'import_from'
+
+# Simple import
+import 'money'
+
+# Import with alias
+import 'money', as: 'Mon'
+```
+
+## 📚 Documentation
+
+- [YARD documentation](https://rubydoc.info/gems/import_from)
+
+## 📜 Examples
+
+All examples can be found [here](https://github.com/wilsonsilva/import_from/blob/main/examples/README.md)
+
+## 🔨 Development
+
+After checking out the repo, run `bin/setup` to install dependencies.
+
+To install this gem onto your local machine, run `bundle exec rake install`.
+
+You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`,
+which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file
+to [rubygems.org](https://rubygems.org).
+
+The health and maintainability of the codebase is ensured through a set of
+Rake tasks to test, lint and audit the gem for security vulnerabilities and documentation:
+
+```
+rake build                    # Build import_from.gem into the pkg directory
+rake build:checksum           # Generate SHA512 checksum of import_from.gem into the checksums directory
+rake bundle:audit:check       # Checks the Gemfile.lock for insecure dependencies
+rake bundle:audit:update      # Updates the bundler-audit vulnerability database
+rake clean                    # Remove any temporary products
+rake clobber                  # Remove any generated files
+rake coverage                 # Run spec with coverage
+rake install                  # Build and install import_from.gem into system gems
+rake install:local            # Build and install import_from.gem into system gems without network access
+rake qa                       # Test, lint and perform security and documentation audits
+rake release[remote]          # Create tag and build and push import_from.gem to rubygems.org
+rake rubocop                  # Run RuboCop
+rake rubocop:autocorrect      # Autocorrect RuboCop offenses (only when it's safe)
+rake rubocop:autocorrect_all  # Autocorrect RuboCop offenses (safe and unsafe)
+rake spec                     # Run RSpec code examples
+rake verify_measurements      # Verify that yardstick coverage is at least 100%
+rake yard                     # Generate YARD Documentation
+rake yard:format              # Format YARD documentation
+rake yard:junk                # Check the junk in your YARD Documentation
+rake yardstick_measure        # Measure docs in lib/**/*.rb with yardstick
+```
+
+### 🧪 Type checking
+
+This gem leverages [RBS](https://github.com/ruby/rbs), a language to describe the structure of Ruby programs. It is
+used to provide type checking and autocompletion in your editor. Run `bundle exec typeprof FILENAME` to generate
+an RBS definition for the given Ruby file. And validate all definitions using [Steep](https://github.com/soutaro/steep)
+with the command `bundle exec steep check`.
+
+## 🐞 Issues & Bugs
+
+If you find any issues or bugs, please report them [here](https://github.com/wilsonsilva/import_from/issues), I will be happy
+to have a look at them and fix them as soon as possible.
+
+## 🤝 Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/wilsonsilva/import_from.
+This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere
+to the [code of conduct](https://github.com/wilsonsilva/import_from/blob/main/CODE_OF_CONDUCT.md).
+
+## 📜 License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## 👔 Code of Conduct
+
+Everyone interacting in the ImportFrom Ruby project's codebases, issue trackers, chat rooms and mailing lists is expected
+to follow the [code of conduct](https://github.com/wilsonsilva/import_from/blob/main/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+require 'bundler/audit/task'
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+require 'yaml'
+require 'yard/rake/yardoc_task'
+require 'yard-junk/rake'
+require 'yardstick/rake/measurement'
+require 'yardstick/rake/verify'
+
+yardstick_options = YAML.load_file('.yardstick.yml')
+
+Bundler::Audit::Task.new
+RSpec::Core::RakeTask.new(:spec)
+RuboCop::RakeTask.new
+YARD::Rake::YardocTask.new
+YardJunk::Rake.define_task
+Yardstick::Rake::Measurement.new(:yardstick_measure, yardstick_options)
+Yardstick::Rake::Verify.new(:verify_measurements, yardstick_options)
+
+task default: %i[spec rubocop]
+
+# Remove the report on rake clobber
+CLEAN.include('measurements', 'doc', '.yardoc', 'tmp')
+
+# Delete these files and folders when running rake clobber.
+CLOBBER.include('coverage', '.rspec_status')
+
+desc 'Run spec with coverage'
+task :coverage do
+  ENV['COVERAGE'] = 'true'
+  Rake::Task['spec'].execute
+  `open coverage/index.html`
+end
+
+desc 'Test, lint and perform security and documentation audits'
+task qa: %w[spec rubocop yard:junk verify_measurements bundle:audit]
+
+namespace :yard do
+  desc 'Format YARD documentation'
+  task :format do
+    require 'fileutils'
+
+    ruby_files = Dir.glob(File.join(Dir.pwd, 'lib', '**', '*.rb'))
+
+    puts "Found #{ruby_files.length} Ruby files in lib directory"
+    puts
+
+    ruby_files.each do |file_path|
+      puts "Processing #{file_path}..."
+
+      content = File.read(file_path)
+      lines = content.split("\n")
+      result = []
+
+      lines.each_with_index do |line, index|
+        result << line
+
+        current_is_yard = line.strip.match?(/^\s*#\s*@\w+/)
+        next_line_exists = index + 1 < lines.length
+
+        # Process YARD tag spacing
+        next unless current_is_yard && next_line_exists
+
+        next_line = lines[index + 1]
+
+        next unless next_line.strip.match?(/^\s*#\s*@\w+/)
+
+        current_tag = line.strip.match(/^\s*#\s*@(\w+)/)[1]
+        next_tag = next_line.strip.match(/^\s*#\s*@(\w+)/)[1]
+
+        groupable = %w[param option]
+        should_group = groupable.include?(current_tag) && groupable.include?(next_tag)
+
+        # Add blank line between different tag types
+        unless should_group
+          indentation = line.match(/^(\s*)/)[1]
+          result << "#{indentation}#"
+        end
+      end
+
+      formatted_content = "#{result.join("\n")}\n"
+
+      if content == formatted_content
+        puts '  - No changes needed'
+      else
+        File.write(file_path, formatted_content)
+        puts '  ✓ Updated'
+      end
+    end
+
+    puts
+    puts 'Done!'
+  end
+end

data/Steepfile

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+target :lib do
+  signature 'sig'
+
+  check 'lib'
+end