expand 1.0.3 → 1.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2ea9a1efdd9f3eb0013dcf094347e32d3c48aeb6d819d95d76a368c14de20862
-  data.tar.gz: d21f446e4e5a1d793da4cc23c9017d6e15ba80066905cd302e9be33e25cfff2f
+  metadata.gz: f98f240f7a6d7b3912beedba4414dd8488ab84a79c8da8e987ea76f624c862ef
+  data.tar.gz: 5ed64f4889cd305c8c131213613b5c7558ef1a5274989ae3822589ea75a77a61
 SHA512:
-  metadata.gz: 0660ff8939459c77f34920c14d5b678ed5a8703bc3dfab0b2a523afd75a07b516e9d25596b0ca333ad3c3f52ae1fd623047bb4033961a68e306fef25970f8401
-  data.tar.gz: 3e51316a7a7a0b7c5ca31de138b6c09ebba2446f450166ce1a43ec4a1912b86f1cce7baf3c3e063bd05bd55c34513b67304a8ac99ddeb068b830102afde4d0ad
+  metadata.gz: c08ae5d1c6d495364ee299c40565af87246fc37976d40bdb0f0bf02298e651206062a6ba4accfbce2d99575bc24b316a56e0bef7f3071233eed14bdedc65d14e
+  data.tar.gz: 5cdf7a8d3d945e8fb4b85ee9390b101fbc32d4f4cd7b5519a520fe8af5e1b67fa53c842b5026b496d10902da5af882d55a27b483df1c6e03fa2b2188abf84413

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 1.0.4
+
+- use a module function `Expand.namespace` so you don't need to extend
+
 ## 1.0.3
 
 - allow the creation of a module or class in the namespace/expand method itself.

data/README.md

@@ -19,22 +19,19 @@ end
 SomeGem::Thing::NewThing #=> warning: toplevel constant NewThing referenced by SomeGem::Thing::NewThing
 ```
 
-To make this simpler, you can require `expand` and extend your current context with Expand.
+To make this simpler, you can require `expand` and specify the namespace and the new class or module.
 
 ```ruby
 require 'expand'
-extend Expand
 
-namespace SomeGem::Thing do
-  create_class :NewThing do
-    # define methods here
-  end
+Expand.namespace SomeGem::Thing, class: :NewThing do
+  # define methods for your class here
 end
 
 SomeGem::Thing::NewThing #=> SomeGem::Thing::NewThing
 ```
 
-And even simpler, you can do it all in one line:
+You can also extend an class or object to add the `namespace` method.
 
 ```ruby
 require 'expand'
@@ -44,11 +41,28 @@ namespace SomeGem::Thing, class: :NewThing, parent: SomeExistingOtherClass do
   # define methods here
 end
 
-namespace SomeGem::Thing, class: :NewModule do
+namespace SomeGem::Thing, module: :NewModule do
   # define methods here
 end
 ```
 
+If you want more explicit code or to create multiple modules or classes under a sinngle namespace you can use `create_class` and `create_module`
+
+```ruby
+require 'expand'
+extend Expand
+
+namespace SomeGem::Thing do
+  create_class :NewClass do
+    # define methods here
+  end
+
+  create_module :NewModule do
+    # define methods here
+  end
+end
+```
+
 ## Installation
 
 Add this line to your application's Gemfile:

data/lib/expand/version.rb

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

data/lib/expand.rb

@@ -63,7 +63,17 @@ module Expand
   #     end
   #   end
   #
+  #   namespace SomeGem::Thing, class: :Other do
+  #     # add methods here
+  #   end
+  #   namespace SomeGem::Thing, module: :Another do
+  #     # add methods here
+  #   end
+  #
   # @param context [Module, String, or any object responding to to_s] representing a module namespace.
+  # @param module: module name to create
+  # @param class: class name to create
+  # @param parent: optional parent class for the created class, defaults to Object
   # @yield the provided block is executed against an instance of Expand::Manager using instance_eval
   #
   # @return [Expand::Manager] instance which can allow you to create classes and modules in the given context.
@@ -96,4 +106,5 @@ module Expand
     end
   end
   alias 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.3
+  version: 1.0.4
 platform: ruby
 authors:
 - "'Jim Gay'"
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-07-20 00:00:00.000000000 Z
+date: 2022-07-22 00:00:00.000000000 Z
 dependencies: []
 description: Create classes and modules under an existing namespace
 email: