asimov-config 25.0.0.dev.5 → 25.0.0.dev.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 82b3c0af7c4d692d74f1119d544bd63059b08f4960bdee86f83831bdb7cb147d
-  data.tar.gz: a582c8495e6d9d62da3a3fe413690640d6c77e56938fbcb5612ad9c9af701d19
+  metadata.gz: fdf9109315728f900b38ace479e7771baa6e8948755648e7950655e3a0d57b1f
+  data.tar.gz: dceef3edcb6df12259af3e856abddc8654a3be537fb7784a1867eaf685a32792
 SHA512:
-  metadata.gz: 9354be1c6f0dd26d5ab9a74bffbad3de0910b40598a3d4bded9bcbf3443a7171cbb708da6fd780baa259654975af54cb6aa223b4424eef23c81ad5304d72772e
-  data.tar.gz: bbd27178dadfd2e5f2117e13c0078890cdbb97bc3e6ee6c560f495568f67ad25e277b215b7e210e3923284fc35136a84caf21a5dd7b4d984fe6f6f5d131b8353
+  metadata.gz: 8283efc1b79cf70326ba13b57fc122a213544aff1f59048914abfefd877bf2ab242f6ddd3e4ea17b6e70753213afda9618eb75c302ebb383f863be8e21b51bc6
+  data.tar.gz: c1342f03f53e1a1cdee6b97a54dc9d05ad1fae432046ccdb584978686abac2a2816c5f3ab65c34a5bfef45ee35ca2bd1249c6b91bb619de5eb513557237cfde4

data/CHANGES.md

@@ -5,6 +5,11 @@ 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).
 
+## 25.0.0.dev.6 - 2025-06-13
+### Added
+- asimov-config: `ASIMOV::Config::ModuleManifest`
+- asimov-config: `ASIMOV::Config::Resolver`
+
 ## 25.0.0.dev.5 - 2025-06-11
 
 ## 25.0.0.dev.4 - 2025-02-15

data/VERSION

@@ -1 +1 @@
-25.0.0.dev.5
+25.0.0.dev.6

data/lib/asimov/config/module_manifest.rb

@@ -0,0 +1,67 @@
+# This is free and unencumbered software released into the public domain.
+
+require 'yaml'
+
+module ASIMOV; end
+module ASIMOV::Config; end
+
+##
+# ASIMOV module manifest.
+class ASIMOV::Config::ModuleManifest
+  ##
+  # @param [Pathname, #to_s] path
+  # @return [ModuleManifest]
+  def self.load_file(path)
+    self.load_yaml(File.read(path.to_s))
+  end
+
+  ##
+  # @param [String, #to_s] yaml
+  # @return [ModuleManifest]
+  def self.load_yaml(yaml_string)
+    self.new(YAML.safe_load(yaml_string, symbolize_names: true))
+  end
+
+  ##
+  # @return [String]
+  attr_reader :name
+  def name() @yaml[:name] end
+
+  ##
+  # @return [String]
+  attr_reader :label
+  def label() @yaml[:label] end
+
+  ##
+  # @return [String]
+  attr_reader :summary
+  def summary() @yaml[:summary] end
+
+  ##
+  # @return [Array<String>]
+  attr_reader :links
+  def links() @yaml[:links] end
+
+  ##
+  # @return [Hash{Symbol => Object}]
+  attr_reader :provides
+  def provides() @yaml[:provides] end
+
+  ##
+  # @return [Hash{Symbol => Object}]
+  attr_reader :handles
+  def handles() @yaml[:handles] end
+
+  ##
+  # @param [Hash{Symbol => Object}] yaml
+  # @return [void]
+  def initialize(yaml)
+    @yaml = yaml
+  end
+
+  ##
+  # @return [Hash{Symbol => Object}]
+  def to_h
+    @yaml
+  end
+end # ASIMOV::Config::ModuleManifest

data/lib/asimov/config/resolver.rb

@@ -0,0 +1,118 @@
+# This is free and unencumbered software released into the public domain.
+
+require 'addressable/uri'
+
+module ASIMOV; end
+module ASIMOV::Config; end
+
+##
+# ASIMOV resolver.
+class ASIMOV::Config::Resolver
+  ##
+  # @return [Hash{Symbol, Array<Symbol>}]
+  attr_reader :url_protocols
+
+  ##
+  # @return [Hash{Regexp, Array<Symbol>}]
+  attr_reader :url_patterns
+
+  ##
+  # @return [Hash{String, Array<Symbol>}]
+  attr_reader :url_prefixes
+
+  ##
+  # @return [void]
+  def initialize
+    @url_protocols = {}
+    @url_patterns = {}
+    @url_prefixes = {}
+  end
+
+  ##
+  # @param [ModuleManifest, #to_h] module_manifest
+  # @return [void]
+  def register_module!(module_manifest)
+    module_manifest = module_manifest.to_h
+
+    module_name = module_manifest[:name].to_sym
+    module_handles = module_manifest[:handles] || {}
+
+    (module_handles[:url_protocols] || []).each do |url_protocol|
+      (@url_protocols[url_protocol.to_sym] ||= []) << module_name
+    end
+
+    (module_handles[:url_patterns] || []).each do |url_pattern|
+      url_regexp = compile_url_pattern(url_pattern)
+      (@url_patterns[url_regexp] ||= []) << module_name
+
+      www_pattern = url_pattern.sub('https://', 'https://www.')
+      next unless www_pattern != url_pattern
+      www_regexp = compile_url_pattern(www_pattern)
+      (@url_patterns[www_regexp] ||= []) << module_name
+    end
+
+    (module_handles[:url_prefixes] || []).each do |url_prefix|
+      (@url_prefixes[url_prefix] ||= []) << module_name
+      www_prefix = url_prefix.sub('https://', 'https://www.')
+      (@url_prefixes[www_prefix] ||= []) << module_name
+    end
+
+    self
+  end
+
+  ##
+  # @param [Addressable::URI, #to_s] input_url
+  # @return [Symbol]
+  def resolve_url(input_url)
+    input_url_scheme = Addressable::URI.parse(input_url).scheme.to_sym
+    input_url_string = input_url.to_s
+
+    @url_protocols.each do |url_protocol, module_names|
+      return module_names.last if url_protocol == input_url_scheme
+    end
+
+    @url_patterns.each do |url_pattern, module_names|
+      return module_names.last if url_pattern === input_url_string
+    end
+
+    @url_prefixes.each do |url_prefix, module_names|
+      return module_names.last if input_url_string.start_with?(url_prefix)
+    end
+
+    nil # no match
+  end
+  alias_method :resolve_uri, :resolve_url
+
+  ##
+  # @param [Addressable::URI, #to_s] input_url
+  # @return [Array<Symbol>]
+  def lookup_url(input_url)
+    input_url_scheme = Addressable::URI.parse(input_url).scheme.to_sym
+    input_url_string = input_url.to_s
+    output_module_names = []
+
+    @url_protocols.each do |url_protocol, module_names|
+      output_module_names += module_names if url_protocol == input_url_scheme
+    end
+
+    @url_patterns.each do |url_pattern, module_names|
+      output_module_names += module_names if url_pattern === input_url_string
+    end
+
+    @url_prefixes.each do |url_prefix, module_names|
+      output_module_names += module_names if input_url_string.start_with?(url_prefix)
+    end
+
+    output_module_names.uniq
+  end
+  alias_method :lookup_uri, :lookup_url
+
+  protected
+
+  def compile_url_pattern(pattern)
+    temp_pattern = pattern.gsub(/:([a-zA-Z_][a-zA-Z0-9_]*)/, 'PLACEHOLDER\1PLACEHOLDER')
+    escaped_pattern = Regexp.escape(temp_pattern)
+    final_pattern = escaped_pattern.gsub(/PLACEHOLDER([a-zA-Z_][a-zA-Z0-9_]*)PLACEHOLDER/, '(?<\1>[^/]+)')
+    Regexp.new("\\A#{final_pattern}\\z")
+  end
+end # ASIMOV::Config::Resolver

data/lib/asimov/config.rb

@@ -4,6 +4,8 @@ require "pathname"
 
 module ASIMOV; end
 
+##
+# ASIMOV configuration.
 module ASIMOV::Config
   ##
   # @return [Pathname]
@@ -61,3 +63,6 @@ module ASIMOV::Config
     end
   end
 end # ASIMOV::Config
+
+require_relative "config/resolver"
+require_relative "config/module_manifest"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: asimov-config
 version: !ruby/object:Gem::Version
-  version: 25.0.0.dev.5
+  version: 25.0.0.dev.6
 platform: ruby
 authors:
 - ASIMOV Protocol
 bindir: bin
 cert_chain: []
-date: 2025-06-11 00:00:00.000000000 Z
+date: 2025-06-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -51,6 +51,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
 - !ruby/object:Gem::Dependency
   name: pathname
   requirement: !ruby/object:Gem::Requirement
@@ -78,6 +92,8 @@ files:
 - VERSION
 - lib/asimov-config.rb
 - lib/asimov/config.rb
+- lib/asimov/config/module_manifest.rb
+- lib/asimov/config/resolver.rb
 homepage: https://sdk.asimov.so
 licenses:
 - Unlicense