purl 1.2.0 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 519631a904ead8452084959edb20711e684c0fc9c0b0a848ff6775f86bc31675
-  data.tar.gz: cb82893be40a50ae28651b78ed293dd0303b6cc926b81985fe256d32f0b0fea7
+  metadata.gz: 6c6c3fd2d17a4601a4c296b18ce67d41c423a5893aeb2b79cd484c0028863abd
+  data.tar.gz: 2c5e92ca69e3bb8442df158f34944fad645319cdbac5fb45875c7c8521be5d0c
 SHA512:
-  metadata.gz: 5ef9defb2759c124020aa5d6ba88eb281e0bd1fbf256cafdd3ba7c4e17bca09aec0286fe2851b74e12313062a5d3e38a76db85376b60d3f645e9f4720e0cb2b8
-  data.tar.gz: 6399a94cf6bd5bd92fa6e5da30f7f9c6e056982728bc5828ead26e9d8c9c17b5beedbe4bdababebc0bee701bdeaf27f4ffa7b84e54a451d45e7dea7c9575c9b7
+  metadata.gz: 34e7c52f43f92146d605e06338f25b5d12f80f495e320901aed32206dc3e743029be9b51eb5bcd1f84ef46ca450a76ac45fa7c74da5b2506eb3d53b82db6c840
+  data.tar.gz: 7941f3f3cb65695448599c590e75ef06198fdafe4739e7587e0f7518f6e58fc948896452c38136a3c1a1e6e0d52acac4b766c2a5f2dd22d0a33f8b2e1b61feb1

data/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.3.1] - 2025-08-04
+
+### Fixed
+- Remove arbitrary business logic validation, follow PURL spec for namespace requirements
+
+## [1.3.0] - 2025-07-29
+
+### Added
+- RFC 6570 URI templates for registry URL generation
+- Advanced URL templating capabilities for dynamic registry URL construction
+
+### Enhanced
+- Registry URL generation now supports more flexible URL patterns
+- Improved templating system for custom registry configurations
+
 ## [1.2.0] - 2025-07-27
 
 ### Added

data/lib/purl/package_url.rb

@@ -74,13 +74,13 @@ module Purl
     def initialize(type:, name:, namespace: nil, version: nil, qualifiers: nil, subpath: nil)
       @type = validate_and_normalize_type(type)
       @name = validate_name(name)
-      @namespace = validate_namespace(namespace) if namespace
+      @namespace = validate_namespace(namespace)
       @version = validate_version(version) if version
       @qualifiers = validate_qualifiers(qualifiers) if qualifiers
       @subpath = validate_subpath(subpath) if subpath
       
-      # Type-specific validation
-      validate_type_specific_rules
+      # Apply post-validation normalization that depends on other components
+      apply_post_validation_normalization
     end
 
     # Parse a PURL string into a PackageURL object
@@ -407,7 +407,7 @@ module Purl
         # PyPI names are case-insensitive and _ should be normalized to -
         name_str.downcase.gsub("_", "-")
       when "mlflow"
-        # MLflow name normalization is deferred until after qualifiers are set
+        # MLflow name normalization happens after qualifiers are validated
         name_str
       when "composer"
         # Composer names should be lowercase
@@ -418,6 +418,16 @@ module Purl
     end
 
     def validate_namespace(namespace)
+      # Check namespace requirements from spec
+      if namespace_required_for_type?(@type) && namespace.nil?
+        raise ValidationError.new(
+          "#{@type.capitalize} PURLs require a namespace per the type definition",
+          component: :namespace,
+          value: namespace,
+          rule: "#{@type.downcase} packages need namespace"
+        )
+      end
+      
       return nil if namespace.nil?
       
       namespace_str = namespace.to_s.strip
@@ -516,111 +526,35 @@ module Purl
       subpath_str
     end
 
-    def validate_type_specific_rules
-      case @type.downcase
-      when "conan"
-        validate_conan_specific_rules
-      when "cran"
-        validate_cran_specific_rules
-      when "swift"
-        validate_swift_specific_rules
-      when "cpan"
-        validate_cpan_specific_rules
-      when "mlflow"
-        validate_mlflow_specific_rules
+    def apply_post_validation_normalization
+      # MLflow names are case sensitive or insensitive based on repository per spec
+      if @type&.downcase == "mlflow" && @qualifiers && @qualifiers["repository_url"] && @qualifiers["repository_url"].include?("azuredatabricks")
+        # Databricks MLflow is case insensitive - normalize to lowercase per spec
+        @name = @name.downcase
       end
+      # Other MLflow repositories (like Azure ML) are case sensitive - no normalization needed
     end
 
-    def validate_conan_specific_rules
-      # For conan packages, if a namespace is present WITHOUT any qualifiers at all, 
-      # it's ambiguous. However, any qualifiers (including build settings) make it unambiguous.
-      # According to the official spec, user/channel are only required if the package was published with them.
-      if @namespace && (@qualifiers.nil? || @qualifiers.empty?)
-        raise ValidationError.new(
-          "Conan PURLs with namespace require qualifiers to be unambiguous",
-          component: :qualifiers,
-          value: @qualifiers,
-          rule: "conan packages with namespace need qualifiers for disambiguation"
-        )
-      end
+    def namespace_required_for_type?(type)
+      return false unless type
       
-      # If channel qualifier is present without namespace, user qualifier is also needed (test case 31)
-      # But if namespace is present, channel alone can be valid (test case 29)
-      if @qualifiers && @qualifiers["channel"] && @qualifiers["user"].nil? && @namespace.nil?
-        raise ValidationError.new(
-          "Conan PURLs with 'channel' qualifier require 'user' qualifier to be unambiguous",
-          component: :qualifiers,
-          value: @qualifiers,
-          rule: "conan packages with channel need user qualifier"
-        )
-      end
-    end
-
-    def validate_cran_specific_rules
-      # CRAN packages require a version to be unambiguous
-      if @version.nil?
-        raise ValidationError.new(
-          "CRAN PURLs require a version to be unambiguous",
-          component: :version,
-          value: @version,
-          rule: "cran packages need version"
-        )
-      end
-    end
-
-    def validate_swift_specific_rules
-      # Swift packages require a namespace to be unambiguous
-      if @namespace.nil?
-        raise ValidationError.new(
-          "Swift PURLs require a namespace to be unambiguous",
-          component: :namespace,
-          value: @namespace,
-          rule: "swift packages need namespace"
-        )
-      end
+      # Read from purl-types.json (included in gem)
+      types_data = self.class.purl_types_data
+      type_config = types_data.dig("types", type.downcase)
+      return false unless type_config
       
-      # Swift packages require a version to be unambiguous
-      if @version.nil?
-        raise ValidationError.new(
-          "Swift PURLs require a version to be unambiguous",
-          component: :version,
-          value: @version,
-          rule: "swift packages need version"
-        )
-      end
-    end
-
-    def validate_mlflow_specific_rules
-      # MLflow names are case sensitive or insensitive based on repository
-      if @qualifiers && @qualifiers["repository_url"] && @qualifiers["repository_url"].include?("azuredatabricks")
-        # Azure Databricks MLflow is case insensitive - normalize to lowercase
-        @name = @name.downcase
-      end
-      # Other MLflow repositories are case sensitive - no normalization needed
+      # Check namespace_requirement field
+      type_config["namespace_requirement"] == "required"
     end
 
-    def validate_cpan_specific_rules
-      # CPAN has complex rules about module vs distribution names
-      # These test cases are checking for specific invalid patterns
-      
-      # Case 51: "Perl-Version" should be invalid (module name like distribution name)
-      if @name == "Perl-Version"
-        raise ValidationError.new(
-          "CPAN module name 'Perl-Version' conflicts with distribution naming",
-          component: :name,
-          value: @name,
-          rule: "cpan module vs distribution name conflict"
-        )
-      end
-      
-      # Case 52: namespace with distribution-like name should be invalid
-      if @namespace == "GDT" && @name == "URI::PackageURL"
-        raise ValidationError.new(
-          "CPAN distribution name 'GDT/URI::PackageURL' has invalid format",
-          component: :name,
-          value: "#{@namespace}/#{@name}",
-          rule: "cpan distribution vs module name conflict"
-        )
+    def self.purl_types_data
+      @purl_types_data ||= begin
+        require "json"
+        types_file = File.join(File.dirname(__FILE__), "..", "..", "purl-types.json")
+        JSON.parse(File.read(types_file))
+      rescue
+        # Fallback to empty structure if file can't be read
+        {"types" => {}}
       end
     end
 

data/lib/purl/registry_url.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "addressable/template"
+
 module Purl
   class RegistryURL
     # Load registry patterns from JSON configuration
@@ -27,8 +29,7 @@ module Purl
       # Get the default registry for this type from the extended config
       default_registry = type_config["default_registry"]
       
-      # Use route_patterns directly from our extended registry config
-      route_patterns = config["route_patterns"] || []
+      # Route patterns are replaced by URI templates
       
       # Build reverse regex from template or use legacy format
       reverse_regex = nil
@@ -45,10 +46,13 @@ module Purl
       
       {
         base_url: config["base_url"] || (default_registry ? default_registry + config["path_template"]&.split('/:').first : nil),
-        route_patterns: route_patterns,
         reverse_regex: reverse_regex,
         pattern: build_generation_lambda(type, config, default_registry),
-        reverse_parser: reverse_regex ? build_reverse_parser(type, config) : nil
+        reverse_parser: reverse_regex ? build_reverse_parser(type, config) : nil,
+        uri_template: config["uri_template"] ? Addressable::Template.new(config["uri_template"]) : nil,
+        uri_template_no_namespace: config["uri_template_no_namespace"] ? Addressable::Template.new(config["uri_template_no_namespace"]) : nil,
+        uri_template_with_version: config["uri_template_with_version"] ? Addressable::Template.new(config["uri_template_with_version"]) : nil,
+        uri_template_with_version_no_namespace: config["uri_template_with_version_no_namespace"] ? Addressable::Template.new(config["uri_template_with_version_no_namespace"]) : nil
       }
     end
 
@@ -376,18 +380,41 @@ module Purl
       pattern_config = REGISTRY_PATTERNS[type.to_s.downcase]
       return [] unless pattern_config
       
-      pattern_config[:route_patterns] || []
+      # Generate route patterns from URI templates
+      patterns = []
+      
+      if pattern_config[:uri_template]
+        patterns << uri_template_to_route_pattern(pattern_config[:uri_template])
+      end
+      
+      if pattern_config[:uri_template_no_namespace]
+        patterns << uri_template_to_route_pattern(pattern_config[:uri_template_no_namespace])
+      end
+      
+      if pattern_config[:uri_template_with_version]
+        patterns << uri_template_to_route_pattern(pattern_config[:uri_template_with_version])
+      end
+      
+      if pattern_config[:uri_template_with_version_no_namespace]
+        patterns << uri_template_to_route_pattern(pattern_config[:uri_template_with_version_no_namespace])
+      end
+      
+      patterns.uniq
     end
 
     def self.all_route_patterns
       result = {}
       REGISTRY_PATTERNS.each do |type, config|
-        if config[:route_patterns]
-          result[type] = config[:route_patterns]
-        end
+        patterns = route_patterns_for(type)
+        result[type] = patterns unless patterns.empty?
       end
       result
     end
+    
+    private_class_method def self.uri_template_to_route_pattern(template)
+      # Convert URI template format {variable} to route pattern format :variable
+      template.pattern.gsub(/\{([^}]+)\}/, ':\1')
+    end
 
     def initialize(purl)
       @purl = purl
@@ -408,8 +435,12 @@ module Purl
         if base_url
           # Use custom base URL with the same URL structure
           generate_with_custom_base_url(base_url, pattern_config)
+        elsif pattern_config[:uri_template]
+          # Use URI template if available
+          template = select_uri_template(pattern_config, include_version: false)
+          generate_with_uri_template(template)
         else
-          # Use default base URL
+          # Fall back to legacy lambda pattern
           pattern_config[:pattern].call(@purl)
         end
       rescue MissingRegistryInfoError
@@ -420,27 +451,121 @@ module Purl
     end
 
     def generate_with_version(base_url: nil)
-      registry_url = generate(base_url: base_url)
+      return generate(base_url: base_url) unless @purl.version
+      
+      pattern_config = REGISTRY_PATTERNS[@purl.type.downcase]
+      
+      if base_url
+        # Use custom base URL with version
+        generate_with_custom_base_url_and_version(base_url, pattern_config)
+      elsif pattern_config[:uri_template_with_version] || pattern_config[:uri_template]
+        # Use version-specific URI template if available
+        template = select_uri_template(pattern_config, include_version: true)
+        generate_with_uri_template(template, include_version: true)
+      else
+        # Fall back to legacy version handling
+        registry_url = generate(base_url: base_url)
+        
+        case @purl.type.downcase
+        when "npm"
+          "#{registry_url}/v/#{@purl.version}"
+        when "pypi"
+          "#{registry_url}#{@purl.version}/"
+        when "gem"
+          "#{registry_url}/versions/#{@purl.version}"
+        when "maven"
+          "#{registry_url}/#{@purl.version}"
+        when "nuget"
+          "#{registry_url}/#{@purl.version}"
+        else
+          registry_url
+        end
+      end
+    end
+
+    private
+
+    def select_uri_template(pattern_config, include_version: false)
+      if include_version
+        if @purl.namespace && pattern_config[:uri_template_with_version]
+          pattern_config[:uri_template_with_version]
+        elsif !@purl.namespace && pattern_config[:uri_template_with_version_no_namespace]
+          pattern_config[:uri_template_with_version_no_namespace]
+        elsif pattern_config[:uri_template_with_version]
+          pattern_config[:uri_template_with_version]
+        elsif @purl.namespace && pattern_config[:uri_template]
+          pattern_config[:uri_template]
+        elsif !@purl.namespace && pattern_config[:uri_template_no_namespace]
+          pattern_config[:uri_template_no_namespace]
+        else
+          pattern_config[:uri_template]
+        end
+      else
+        if @purl.namespace && pattern_config[:uri_template]
+          pattern_config[:uri_template]
+        elsif !@purl.namespace && pattern_config[:uri_template_no_namespace]
+          pattern_config[:uri_template_no_namespace]
+        else
+          pattern_config[:uri_template]
+        end
+      end
+    end
+
+    def generate_with_uri_template(template, include_version: false)
+      variables = {
+        name: @purl.name
+      }
+      
+      # Add namespace if present and required
+      if @purl.namespace
+        variables[:namespace] = @purl.namespace
+      end
+      
+      # Add version if requested and present
+      if include_version && @purl.version
+        variables[:version] = @purl.version
+      end
+      
+      # Handle namespace requirements based on package type
+      case @purl.type.downcase
+      when "composer", "maven", "swift", "elm"
+        unless @purl.namespace
+          raise MissingRegistryInfoError.new(
+            "#{@purl.type.capitalize} packages require a namespace",
+            type: @purl.type,
+            missing: "namespace"
+          )
+        end
+      end
+      
+      # Build the URL manually to avoid encoding issues with special characters like @
+      result = template.pattern
+      
+      variables.each do |key, value|
+        result = result.gsub("{#{key}}", value.to_s)
+      end
+      
+      result
+    end
+
+    def generate_with_custom_base_url_and_version(custom_base_url, pattern_config)
+      # For now, fall back to the existing custom base URL method and add version
+      base_result = generate_with_custom_base_url(custom_base_url, pattern_config)
       
       case @purl.type.downcase
       when "npm"
-        @purl.version ? "#{registry_url}/v/#{@purl.version}" : registry_url
+        "#{base_result}/v/#{@purl.version}"
       when "pypi"
-        @purl.version ? "#{registry_url}#{@purl.version}/" : registry_url
+        "#{base_result}#{@purl.version}/"
       when "gem"
-        @purl.version ? "#{registry_url}/versions/#{@purl.version}" : registry_url
-      when "maven"
-        @purl.version ? "#{registry_url}/#{@purl.version}" : registry_url
-      when "nuget"
-        @purl.version ? "#{registry_url}/#{@purl.version}" : registry_url
+        "#{base_result}/versions/#{@purl.version}"
+      when "maven", "nuget"
+        "#{base_result}/#{@purl.version}"
       else
-        # For other types, just return the base URL since version-specific URLs vary
-        registry_url
+        base_result
       end
     end
 
-    private
-
     def generate_with_custom_base_url(custom_base_url, pattern_config)
       
       # Replace the base URL in the pattern lambda

data/lib/purl/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Purl
-  VERSION = "1.2.0"
+  VERSION = "1.3.1"
 end

data/purl-types.json

@@ -50,10 +50,8 @@
       ],
       "registry_config": {
         "base_url": "https://crates.io/crates",
-        "route_patterns": [
-          "https://crates.io/crates/:name"
-        ],
         "reverse_regex": "^https://crates\\.io/crates/([^/?#]+)",
+        "uri_template": "https://crates.io/crates/{name}",
         "components": {
           "namespace": false,
           "version_in_url": false
@@ -70,10 +68,8 @@
       ],
       "registry_config": {
         "base_url": "https://cocoapods.org/pods",
-        "route_patterns": [
-          "https://cocoapods.org/pods/:name"
-        ],
         "reverse_regex": "^https://cocoapods\\.org/pods/([^/?#]+)",
+        "uri_template": "https://cocoapods.org/pods/{name}",
         "components": {
           "namespace": false,
           "version_in_url": false
@@ -83,6 +79,7 @@
     "composer": {
       "description": "Composer PHP packages",
       "default_registry": "https://packagist.org",
+      "namespace_requirement": "required",
       "examples": [
         "pkg:composer/symfony/console@6.1.7",
         "pkg:composer/laravel/framework@9.42.2",
@@ -90,10 +87,8 @@
       ],
       "registry_config": {
         "base_url": "https://packagist.org/packages",
-        "route_patterns": [
-          "https://packagist.org/packages/:namespace/:name"
-        ],
         "reverse_regex": "^https://packagist\\.org/packages/([^/?#]+)/([^/?#]+)",
+        "uri_template": "https://packagist.org/packages/{namespace}/{name}",
         "components": {
           "namespace": true,
           "namespace_required": true,
@@ -111,10 +106,8 @@
       ],
       "registry_config": {
         "base_url": "https://conan.io/center/recipes",
-        "route_patterns": [
-          "https://conan.io/center/recipes/:name"
-        ],
         "reverse_regex": "^https://conan\\.io/center/recipes/([^/?#]+)",
+        "uri_template": "https://conan.io/center/recipes/{name}",
         "components": {
           "namespace": false,
           "version_in_url": false
@@ -131,10 +124,8 @@
       ],
       "registry_config": {
         "base_url": "https://anaconda.org/conda-forge",
-        "route_patterns": [
-          "https://anaconda.org/conda-forge/:name"
-        ],
         "reverse_regex": "^https://anaconda\\.org/conda-forge/([^/?#]+)",
+        "uri_template": "https://anaconda.org/conda-forge/{name}",
         "components": {
           "namespace": false,
           "version_in_url": false
@@ -151,10 +142,8 @@
       ],
       "registry_config": {
         "base_url": "https://metacpan.org/dist",
-        "route_patterns": [
-          "https://metacpan.org/dist/:name"
-        ],
         "reverse_regex": "^https://metacpan\\.org/dist/([^/?#]+)",
+        "uri_template": "https://metacpan.org/dist/{name}",
         "components": {
           "namespace": false,
           "version_in_url": false
@@ -164,6 +153,7 @@
     "cran": {
       "description": "CRAN R packages",
       "default_registry": "https://cran.r-project.org",
+      "namespace_requirement": "prohibited",
       "examples": [
         "pkg:cran/ggplot2@3.4.0",
         "pkg:cran/dplyr@1.0.10",
@@ -193,6 +183,7 @@
     "gem": {
       "description": "RubyGems",
       "default_registry": "https://rubygems.org",
+      "namespace_requirement": "prohibited",
       "examples": [
         "pkg:gem/ruby-advisory-db-check@0.12.4",
         "pkg:gem/rails@7.0.4",
@@ -200,11 +191,9 @@
       ],
       "registry_config": {
         "base_url": "https://rubygems.org/gems",
-        "route_patterns": [
-          "https://rubygems.org/gems/:name",
-          "https://rubygems.org/gems/:name/versions/:version"
-        ],
         "reverse_regex": "^https://rubygems\\.org/gems/([^/?#]+)(?:/versions/([^/?#]+))?",
+        "uri_template": "https://rubygems.org/gems/{name}",
+        "uri_template_with_version": "https://rubygems.org/gems/{name}/versions/{version}",
         "components": {
           "namespace": false,
           "version_in_url": true,
@@ -240,11 +229,8 @@
       ],
       "registry_config": {
         "base_url": "https://pkg.go.dev",
-        "route_patterns": [
-          "https://pkg.go.dev/:namespace/:name",
-          "https://pkg.go.dev/:full_path"
-        ],
         "reverse_regex": "^https://pkg\\.go\\.dev/(.+)",
+        "uri_template": "https://pkg.go.dev/{namespace}/{name}",
         "components": {
           "namespace": true,
           "namespace_required": true,
@@ -263,11 +249,9 @@
       ],
       "registry_config": {
         "base_url": "https://hackage.haskell.org/package",
-        "route_patterns": [
-          "https://hackage.haskell.org/package/:name",
-          "https://hackage.haskell.org/package/:name-:version"
-        ],
         "reverse_regex": "^https://hackage\\.haskell\\.org/package/([^/?#-]+)(?:-([^/?#]+))?",
+        "uri_template": "https://hackage.haskell.org/package/{name}",
+        "uri_template_with_version": "https://hackage.haskell.org/package/{name}-{version}",
         "components": {
           "namespace": false,
           "version_in_url": true,
@@ -285,10 +269,8 @@
       ],
       "registry_config": {
         "base_url": "https://hex.pm/packages",
-        "route_patterns": [
-          "https://hex.pm/packages/:name"
-        ],
         "reverse_regex": "^https://hex\\.pm/packages/([^/?#]+)",
+        "uri_template": "https://hex.pm/packages/{name}",
         "components": {
           "namespace": false,
           "version_in_url": false
@@ -299,16 +281,14 @@
       "description": "Hugging Face ML models",
       "default_registry": "https://huggingface.co",
       "examples": [
-        "pkg:huggingface/distilbert-base-uncased@043235d6088ecd3dd5fb5ca3592b6913fd516027",
+        "pkg:huggingface/huggingface/distilbert-base-uncased@043235d6088ecd3dd5fb5ca3592b6913fd516027",
         "pkg:huggingface/microsoft/deberta-v3-base@559062ad13d311b87b2c455e67dcd5f1c8f65111?repository_url=https://hub-ci.huggingface.co"
       ],
       "registry_config": {
         "base_url": "https://huggingface.co",
-        "route_patterns": [
-          "https://huggingface.co/:namespace/:name",
-          "https://huggingface.co/:name"
-        ],
         "reverse_regex": "^https://huggingface\\.co/(?:([^/?#]+)/)?([^/?#]+)",
+        "uri_template": "https://huggingface.co/{namespace}/{name}",
+        "uri_template_no_namespace": "https://huggingface.co/{name}",
         "components": {
           "namespace": true,
           "namespace_required": false,
@@ -326,11 +306,9 @@
       ],
       "registry_config": {
         "base_url": "https://luarocks.org/modules",
-        "route_patterns": [
-          "https://luarocks.org/modules/:namespace/:name",
-          "https://luarocks.org/modules/:name"
-        ],
         "reverse_regex": "^https://luarocks\\.org/modules/(?:([^/?#]+)/)?([^/?#]+)",
+        "uri_template": "https://luarocks.org/modules/{namespace}/{name}",
+        "uri_template_no_namespace": "https://luarocks.org/modules/{name}",
         "components": {
           "namespace": true,
           "namespace_required": false,
@@ -341,6 +319,7 @@
     "maven": {
       "description": "PURL type for Maven JARs and related artifacts.",
       "default_registry": "https://repo.maven.apache.org/maven2",
+      "namespace_requirement": "required", 
       "examples": [
         "pkg:maven/org.apache.commons/commons-lang3@3.12.0",
         "pkg:maven/junit/junit@4.13.2",
@@ -348,11 +327,9 @@
       ],
       "registry_config": {
         "base_url": "https://mvnrepository.com/artifact",
-        "route_patterns": [
-          "https://mvnrepository.com/artifact/:namespace/:name",
-          "https://mvnrepository.com/artifact/:namespace/:name/:version"
-        ],
         "reverse_regex": "^https://mvnrepository\\.com/artifact/([^/?#]+)/([^/?#]+)(?:/([^/?#]+))?",
+        "uri_template": "https://mvnrepository.com/artifact/{namespace}/{name}",
+        "uri_template_with_version": "https://mvnrepository.com/artifact/{namespace}/{name}/{version}",
         "components": {
           "namespace": true,
           "namespace_required": true,
@@ -372,6 +349,7 @@
     "npm": {
       "description": "PURL type for npm packages.",
       "default_registry": "https://registry.npmjs.org",
+      "namespace_requirement": "optional",
       "examples": [
         "pkg:npm/@babel/core@7.20.0",
         "pkg:npm/lodash@4.17.21",
@@ -379,13 +357,11 @@
       ],
       "registry_config": {
         "base_url": "https://www.npmjs.com/package",
-        "route_patterns": [
-          "https://www.npmjs.com/package/:namespace/:name",
-          "https://www.npmjs.com/package/:name",
-          "https://www.npmjs.com/package/:namespace/:name/v/:version",
-          "https://www.npmjs.com/package/:name/v/:version"
-        ],
         "reverse_regex": "^https://(?:www\\.)?npmjs\\.com/package/(?:(@[^/]+)/)?([^/?#]+)(?:/v/([^/?#]+))?",
+        "uri_template": "https://www.npmjs.com/package/{namespace}/{name}",
+        "uri_template_no_namespace": "https://www.npmjs.com/package/{name}",
+        "uri_template_with_version": "https://www.npmjs.com/package/{namespace}/{name}/v/{version}",
+        "uri_template_with_version_no_namespace": "https://www.npmjs.com/package/{name}/v/{version}",
         "components": {
           "namespace": true,
           "namespace_required": false,
@@ -405,11 +381,9 @@
       ],
       "registry_config": {
         "base_url": "https://www.nuget.org/packages",
-        "route_patterns": [
-          "https://www.nuget.org/packages/:name",
-          "https://www.nuget.org/packages/:name/:version"
-        ],
         "reverse_regex": "^https://(?:www\\.)?nuget\\.org/packages/([^/?#]+)(?:/([^/?#]+))?",
+        "uri_template": "https://www.nuget.org/packages/{name}",
+        "uri_template_with_version": "https://www.nuget.org/packages/{name}/{version}",
         "components": {
           "namespace": false,
           "version_in_url": true,
@@ -437,10 +411,8 @@
       ],
       "registry_config": {
         "base_url": "https://pub.dev/packages",
-        "route_patterns": [
-          "https://pub.dev/packages/:name"
-        ],
         "reverse_regex": "^https://pub\\.dev/packages/([^/?#]+)",
+        "uri_template": "https://pub.dev/packages/{name}",
         "components": {
           "namespace": false,
           "version_in_url": false
@@ -457,11 +429,9 @@
       ],
       "registry_config": {
         "base_url": "https://pypi.org/project",
-        "route_patterns": [
-          "https://pypi.org/project/:name/",
-          "https://pypi.org/project/:name/:version/"
-        ],
         "reverse_regex": "^https://pypi\\.org/project/([^/?#]+)/?(?:([^/?#]+)/?)?",
+        "uri_template": "https://pypi.org/project/{name}/",
+        "uri_template_with_version": "https://pypi.org/project/{name}/{version}/",
         "components": {
           "namespace": false,
           "version_in_url": true,
@@ -483,7 +453,7 @@
       "default_registry": null,
       "examples": [
         "pkg:rpm/fedora/curl@7.50.3-1.fc25?arch=i386&distro=fedora-25",
-        "pkg:rpm/centerim@4.22.10-1.el6?arch=i686&epoch=1&distro=fedora-25"
+        "pkg:rpm/fedora/centerim@4.22.10-1.el6?arch=i686&epoch=1&distro=fedora-25"
       ]
     },
     "swid": {
@@ -498,16 +468,15 @@
     "swift": {
       "description": "Swift packages",
       "default_registry": "https://swiftpackageindex.com",
+      "namespace_requirement": "required",
       "examples": [
         "pkg:swift/github.com/Alamofire/Alamofire@5.6.4",
         "pkg:swift/github.com/apple/swift-package-manager@1.7.0"
       ],
       "registry_config": {
         "base_url": "https://swiftpackageindex.com",
-        "route_patterns": [
-          "https://swiftpackageindex.com/:namespace/:name"
-        ],
         "reverse_regex": "^https://swiftpackageindex\\.com/([^/?#]+)/([^/?#]+)",
+        "uri_template": "https://swiftpackageindex.com/{namespace}/{name}",
         "components": {
           "namespace": true,
           "namespace_required": true,
@@ -524,11 +493,9 @@
       ],
       "registry_config": {
         "base_url": "https://clojars.org",
-        "route_patterns": [
-          "https://clojars.org/:namespace/:name",
-          "https://clojars.org/:name"
-        ],
         "reverse_regex": "^https://clojars\\.org/(?:([^/?#]+)/)?([^/?#]+)",
+        "uri_template": "https://clojars.org/{namespace}/{name}",
+        "uri_template_no_namespace": "https://clojars.org/{name}",
         "components": {
           "namespace": true,
           "namespace_required": false,
@@ -545,11 +512,9 @@
       ],
       "registry_config": {
         "base_url": "https://package.elm-lang.org/packages",
-        "route_patterns": [
-          "https://package.elm-lang.org/packages/:namespace/:name/latest",
-          "https://package.elm-lang.org/packages/:namespace/:name/:version"
-        ],
         "reverse_regex": "^https://package\\.elm-lang\\.org/packages/([^/?#]+)/([^/?#]+)(?:/([^/?#]+))?",
+        "uri_template": "https://package.elm-lang.org/packages/{namespace}/{name}/latest",
+        "uri_template_with_version": "https://package.elm-lang.org/packages/{namespace}/{name}/{version}",
         "components": {
           "namespace": true,
           "namespace_required": true,
@@ -567,11 +532,9 @@
       ],
       "registry_config": {
         "base_url": "https://deno.land/x",
-        "route_patterns": [
-          "https://deno.land/x/:name",
-          "https://deno.land/x/:name@:version"
-        ],
         "reverse_regex": "^https://deno\\.land/x/([^/?#@]+)(?:@([^/?#]+))?",
+        "uri_template": "https://deno.land/x/{name}",
+        "uri_template_with_version": "https://deno.land/x/{name}@{version}",
         "components": {
           "namespace": false,
           "version_in_url": true,
@@ -588,10 +551,8 @@
       ],
       "registry_config": {
         "base_url": "https://formulae.brew.sh/formula",
-        "route_patterns": [
-          "https://formulae.brew.sh/formula/:name"
-        ],
         "reverse_regex": "^https://formulae\\.brew\\.sh/formula/([^/?#]+)",
+        "uri_template": "https://formulae.brew.sh/formula/{name}",
         "components": {
           "namespace": false,
           "version_in_url": false
@@ -607,10 +568,8 @@
       ],
       "registry_config": {
         "base_url": "https://bioconductor.org/packages",
-        "route_patterns": [
-          "https://bioconductor.org/packages/:name"
-        ],
         "reverse_regex": "^https://bioconductor\\.org/packages/([^/?#]+)",
+        "uri_template": "https://bioconductor.org/packages/{name}",
         "components": {
           "namespace": false,
           "version_in_url": false

metadata

@@ -1,14 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: purl
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.1
 platform: ruby
 authors:
 - Andrew Nesbitt
 bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies: []
+dependencies:
+- !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'
 description: |-
   This library features comprehensive error handling with namespaced error types, bidirectional registry URL conversion, and JSON-based configuration for cross-language compatibility.
   It supports 37 package types (32 official + 5 additional ecosystems) and is fully compliant with the official PURL specification test suite.