expand 1.0.4 → 1.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f98f240f7a6d7b3912beedba4414dd8488ab84a79c8da8e987ea76f624c862ef
-  data.tar.gz: 5ed64f4889cd305c8c131213613b5c7558ef1a5274989ae3822589ea75a77a61
+  metadata.gz: 2f6ea4357fdc4411d7c50e3254b7dafc2fa805a5dabdcee9797c371e1a0c3061
+  data.tar.gz: cda6a8448977b174723223ad38dd9af7709d2ff6d20f2fb5d6ec5a90dbd8203a
 SHA512:
-  metadata.gz: c08ae5d1c6d495364ee299c40565af87246fc37976d40bdb0f0bf02298e651206062a6ba4accfbce2d99575bc24b316a56e0bef7f3071233eed14bdedc65d14e
-  data.tar.gz: 5cdf7a8d3d945e8fb4b85ee9390b101fbc32d4f4cd7b5519a520fe8af5e1b67fa53c842b5026b496d10902da5af882d55a27b483df1c6e03fa2b2188abf84413
+  metadata.gz: 8d2d514212cd0907017e548a3726e2f8a2bab2fbaee0f60c537762ed1592fca4b70167bc39b34b00abd6674d100e9040ab39253aa4aec21a87137318a6f18466
+  data.tar.gz: 8b99003304539699643196d8108ec7023fe544a6a271442fe832d0547f9972cfc8e0e67d5a76cbf6f1a4d5e8df4e8b10401c2e18eb0ad3fa513f9902b7599829

data/CHANGELOG.md

@@ -1,3 +1,12 @@
+## 1.0.6
+
+- pass the managed namespace to the `namespace` method as an argument
+
+## 1.0.5
+
+- use pattern matching in the `namespace` method
+- add an `apply` method to eval blocks in the Manager object
+
 ## 1.0.4
 
 - use a module function `Expand.namespace` so you don't need to extend

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2016 'Jim Gay'
+Copyright (c) 2016-2023 'Jim Gay'
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -63,6 +63,18 @@ namespace SomeGem::Thing do
 end
 ```
 
+## Gotchas
+
+Unfortunately, due to the scoping of the blocks passed to the main `namespace` or `expand` methods, you are unable to directly reference classes nested in your namespace.
+
+You can, however, pass an argument to the block to use as a reference:
+
+```ruby
+namespace SomeGem::Thing do |klass|
+  puts klass #=> yields "SomeGem::Thing"
+end
+```
+
 ## Installation
 
 Add this line to your application's Gemfile:

data/Rakefile

@@ -4,7 +4,7 @@ require "rake/testtask"
 Rake::TestTask.new(:test) do |t|
   t.libs << "test"
   t.libs << "lib"
-  t.test_files = FileList['test/**/*_test.rb']
+  t.test_files = FileList["test/**/*_test.rb"]
 end
 
-task :default => :test
+task default: :test

data/lib/expand/version.rb

@@ -1,3 +1,3 @@
 module Expand
-  VERSION = "1.0.4"
+  VERSION = "1.0.6"
 end

data/lib/expand.rb

@@ -2,13 +2,12 @@ require "expand/version"
 
 # Extend your classes or modules to use the Expand methods
 module Expand
-
   # The primary way to access Manager objects is to use the Expand namespace method.
   # @see Expand#namespace
   #
   class Manager
     # @see Expand#namespace
-    def initialize(namespace, **class_or_module, &block)
+    def initialize(namespace)
       @managed = namespace
     end
 
@@ -48,6 +47,20 @@ module Expand
       @managed.const_set(name, klass)
       klass
     end
+
+    def apply(&block)
+      instance_exec(@managed, &block)
+      @managed
+    end
+
+    def self.for(context)
+      unless context.is_a?(Module)
+        context = context.to_s.split("::").inject(Object) do |base, mod|
+          base.const_get(mod)
+        end
+      end
+      new(context)
+    end
   end
 
   # Allows you to open a module namespace to add constants
@@ -82,29 +95,25 @@ module Expand
   # @see Expand::Manager#create_module
   #
   def namespace(context, **class_or_module, &block)
-    unless context.is_a?(Module)
-      context = context.to_s.split('::').inject(Object) do |base, mod|
-        base.const_get(mod)
-      end
-    end
-    manager = Manager.new(context)
-
-    creating_class, creating_module = class_or_module[:class], class_or_module[:module]
-    raise ArgumentError, "You must choose either class: or module: but not both." if creating_class && creating_module
+    manager = Manager.for(context)
 
-    case
-    when creating_class
+    case class_or_module
+    in { module: Symbol => _creating_module, class: Symbol => _creating_class }
+      raise ArgumentError, "You must choose either class: or module: but not both."
+    in { class: Symbol => creating_class, ** }
       parent = class_or_module[:parent] || Object
+
       manager.create_class(creating_class, parent: parent, &block)
-    when creating_module
-      if class_or_module[:parent]
-        warn "An option for :parent was provided as `#{class_or_module[:parent]}' but was ignored when creating the module: #{class_or_module[:module]}"
+    in { module: Symbol => creating_module, ** }
+      if parent = class_or_module[:parent]
+        warn "An option for :parent was provided as `#{parent}' but was ignored when creating the module: #{creating_module}"
       end
+
       manager.create_module(creating_module, &block)
     else
-      manager.instance_eval(&block)
+      manager.apply(&block)
     end
   end
-  alias expand namespace
+  alias_method :expand, :namespace
   module_function :expand, :namespace
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: expand
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 1.0.6
 platform: ruby
 authors:
-- "'Jim Gay'"
+- Jim Gay
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-07-22 00:00:00.000000000 Z
+date: 2023-01-03 00:00:00.000000000 Z
 dependencies: []
 description: Create classes and modules under an existing namespace
 email:
@@ -17,18 +17,11 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".github/dependabot.yml"
-- ".github/workflows/test.yml"
-- ".gitignore"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
-- Gemfile
 - LICENSE.txt
 - README.md
 - Rakefile
-- bin/console
-- bin/setup
-- expand.gemspec
 - lib/expand.rb
 - lib/expand/version.rb
 homepage: https://github.com/saturnflyer/expand
@@ -50,7 +43,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.17
+rubygems_version: 3.4.1
 signing_key:
 specification_version: 4
 summary: Create classes and modules under an existing namespace

data/.github/dependabot.yml

@@ -1,8 +0,0 @@
-version: 2
-updates:
-- package-ecosystem: bundler
-  directory: "/"
-  schedule:
-    interval: daily
-    time: "10:00"
-  open-pull-requests-limit: 10

data/.github/workflows/test.yml

@@ -1,37 +0,0 @@
-# This workflow uses actions that are not certified by GitHub.
-# They are provided by a third-party and are governed by
-# separate terms of service, privacy policy, and support
-# documentation.
-# This workflow will download a prebuilt Ruby version, install dependencies and run tests with Rake
-# For more information see: https://github.com/marketplace/actions/setup-ruby-jruby-and-truffleruby
-
-name: Ruby
-
-on:
-  push:
-    branches: [ "master" ]
-  pull_request:
-    branches: [ "master" ]
-
-permissions:
-  contents: read
-
-jobs:
-  test:
-
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        ruby-version: ['2.6', '2.7', '3.0', '3.1']
-
-    steps:
-    - uses: actions/checkout@v3
-    - name: Set up Ruby
-    # To automatically get bug fixes and new Ruby versions for ruby/setup-ruby,
-    # change this to (see https://github.com/ruby/setup-ruby#versioning):
-      uses: ruby/setup-ruby@v1
-      with:
-        ruby-version: ${{ matrix.ruby-version }}
-        bundler-cache: true # runs 'bundle install' and caches installed gems automatically
-    - name: Run tests
-      run: bundle exec rake

data/.gitignore

@@ -1,9 +0,0 @@
-/.bundle/
-/.yardoc
-/Gemfile.lock
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/

data/Gemfile

@@ -1,8 +0,0 @@
-source 'https://rubygems.org'
-
-# Specify your gem's dependencies in expand.gemspec
-gemspec
-
-gem "minitest"
-gem "simplecov"
-gem "rake"

data/bin/console

@@ -1,14 +0,0 @@
-#!/usr/bin/env ruby
-
-require "bundler/setup"
-require "expand"
-
-# You can add fixtures and/or initialization code here to make experimenting
-# with your gem easier. You can also use a different console, if you like.
-
-# (If you use this, don't forget to add pry to your Gemfile!)
-# require "pry"
-# Pry.start
-
-require "irb"
-IRB.start

data/bin/setup

@@ -1,8 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-IFS=$'\n\t'
-set -vx
-
-bundle install
-
-# Do any other automated setup that you need to do here

data/expand.gemspec

@@ -1,21 +0,0 @@
-# coding: utf-8
-lib = File.expand_path('../lib', __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'expand/version'
-
-Gem::Specification.new do |spec|
-  spec.name          = "expand"
-  spec.version       = Expand::VERSION
-  spec.authors       = ["'Jim Gay'"]
-  spec.email         = ["jim@saturnflyer.com"]
-
-  spec.summary       = %q{Create classes and modules under an existing namespace}
-  spec.description   = %q{Create classes and modules under an existing namespace}
-  spec.homepage      = "https://github.com/saturnflyer/expand"
-  spec.license       = "MIT"
-
-  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
-  spec.bindir        = "exe"
-  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-end