magic-lookup 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 165ed4c613f3808aa064d20eecc5137a20b74ffca108e4b4edaab39e1de5c710
-  data.tar.gz: 8c57c00e753425063568765d62f4879a3848de727431663b4199c1e2cc119cd2
+  metadata.gz: 89553c6220236db6f6b88312bb5a8097718f383a107ab2a85e7c7e9c8ee9ebf1
+  data.tar.gz: 865c7c71973d94e809374270428b2532960a3b4a8a64dfd9393927942d140141
 SHA512:
-  metadata.gz: a42291c47d5e2c2d4545f0c7cbb842c03c39ae4f683b177c339832864c1a33fc98b1cc2deadb15e16e87b069cf557fce80e5f8b70ee6bb479921b658704ae208
-  data.tar.gz: 04b6aaf11baa0644333869e36a0045503b996f13bb1854cc8670d2510220865310e8f01a8b406b56d424328dde9e0690d3d5d5b81cf58cd9c59079fa9eda56fa
+  metadata.gz: 6496b67373aada9b47a0e6af847dca2485da0bb2d683b9eeed46dfbb15f55dedb78cf522da5ed03bc428de427ec60701629e377c1d9a786fe98a46a64b13347b
+  data.tar.gz: 9b9fe4f56b6d5ed85e957ec1bba331574a4f38677c0cf5e9c2225808ba00edac760256978b51ebd644a70bf68aee771bbc8dd0ffca519d38c46c6a2565ea30df

data/CHANGELOG.md

@@ -1,5 +1,15 @@
-## [Unreleased]
+## [0.2.0] — 2024-10-19
 
-## [0.1.0] - 2024-10-07
+### Added
 
-- Initial release
+- Optional `namespace` parameter to `Magic::Lookup#for` for class lookups within a namespace.
+- `Magic::Lookup#namespaces` to set default lookup namespaces.
+
+
+## [0.1.0] — 2024-10-10
+
+### Added
+
+- `Magic::Lookup#for` for name-based class lookups.
+- `Magic::Lookup::Error` to be used when lookup fails.
+- `Magic::Lookup::Error.for` factory helper.

data/README.md

@@ -19,19 +19,17 @@ So, meet
 
 # 🔮 Magic Lookup
 
-It's meant to be The One to Rule Them All — the library to provide a generic name-based lookup for a plenty of cases.
+It’s meant to be The One to Rule Them All — the library to provide a generic name-based lookup for a plenty of cases.
 
 ## Installation
 
-TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
-
 Install the gem and add to the application's Gemfile by executing:
 
-    $ bundle add UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+    $ bundle add magic-lookup
 
 If bundler is not being used to manage dependencies, install the gem by executing:
 
-    $ gem install UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+    $ gem install magic-lookup
 
 ## Usage
 
@@ -70,7 +68,7 @@ scope_class = Scope.for(object.class) or
 
 `Magic::Lookup::Error` is never raised internally and is meant to be used in your code that implements the lookup logic.
 
-## Features
+## 🔮 Magic
 
 ### Inheritance
 
@@ -80,6 +78,20 @@ Lookup is provided not only for the class itself, but to any of its ancestors as
 
 Both of matching classes — the target and its match — may be namespaced independently.
 
+One can specify a namespace to look in:
+
+```ruby
+Scope.for MyModel              # => MyScope
+Scope.for MyModel, MyNamespace # => MyNamespace::MyScope
+```
+
+Multiple default lookup namespaces may be set for the base class:
+
+```ruby
+Scope.namespaces << MyNamespace # => [nil, MyNamespace]
+Scope.for MyModel               # => MyNamespace::MyScope
+```
+
 > [!TIP]
 > Until a comprehensive documentation on all the use cases is released, the spec is recommended as further reading.
 > One can access it by running `rake` in the gem directory.

data/lib/magic/lookup/namespaces.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Magic
+	module Lookup
+		module Namespaces
+			attr_writer :namespaces
+
+			def namespaces = @namespaces ||= [ nil ]
+
+			def for object_class, *namespaces
+				return super unless namespaces.empty?
+
+				self.namespaces
+						.reverse # recently added first
+						.lazy    # optimization
+						.filter_map { super object_class, _1 }
+						.first
+			end
+		end
+	end
+end

data/lib/magic/lookup/version.rb

@@ -2,6 +2,6 @@
 
 module Magic
 	module Lookup
-		VERSION = '0.1.0'
+		VERSION = '0.2.0'
 	end
 end

data/lib/magic/lookup.rb

@@ -6,11 +6,12 @@ require 'memery'
 
 module Magic
 	module Lookup
-		autoload :Error, 'magic/lookup/error'
+		autoload :Error,      'magic/lookup/error'
+		autoload :Namespaces, 'magic/lookup/namespaces'
 
 		include Memery
 
-		memoize def for object_class
+		memoize def for object_class, namespace = nil
 			descendants = self.descendants # cache
 					.reverse # most specific first
 
@@ -18,12 +19,15 @@ module Magic
 					.lazy # optimization
 					.filter(&:name)
 					.map { name_for _1 }
+					.map { [ *namespace, _1 ] * '::' }
 					.filter_map do |class_name|
 						descendants.find { _1.name == class_name }
 					end
 					.first
 		end
 
+		prepend Namespaces
+
 		def name_for(object_class) = raise NotImplementedError
 
 		def descendants

data/sig/magic/lookup.rbs

@@ -3,7 +3,7 @@ module Magic
 		VERSION: String
 		AUTHORS: Array[Gem::Author]
 
-		def for: (Class) -> Class?
+		def for: (Class, ?(Module | interned) namespace) -> Class?
 
 		def name_for: (Module) -> String
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: magic-lookup
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Alexander Senko
 bindir: bin
 cert_chain: []
-date: 2024-10-10 00:00:00.000000000 Z
+date: 2024-10-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: memery
@@ -41,6 +41,7 @@ files:
 - lib/magic/lookup.rb
 - lib/magic/lookup/authors.rb
 - lib/magic/lookup/error.rb
+- lib/magic/lookup/namespaces.rb
 - lib/magic/lookup/version.rb
 - sig/gem.rbs
 - sig/magic/lookup.rbs
@@ -51,7 +52,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/Alexander-Senko/magic-lookup
   source_code_uri: https://github.com/Alexander-Senko/magic-lookup
-  changelog_uri: https://github.com/Alexander-Senko/magic-lookup/blob/v0.1.0/CHANGELOG.md
+  changelog_uri: https://github.com/Alexander-Senko/magic-lookup/blob/v0.2.0/CHANGELOG.md
 rdoc_options: []
 require_paths:
 - lib