lib/grape/path.rb
# frozen_string_literal: true
module Grape
# Represents a path to an endpoint.
class Path
attr_reader :raw_path, :namespace, :settings
def initialize(raw_path, namespace, settings)
@raw_path = raw_path
@namespace = namespace
@settings = settings
end
def mount_path
settings[:mount_path]
end
def root_prefix
settings[:root_prefix]
end
def uses_specific_format?
return false unless settings.key?(:format) && settings.key?(:content_types)
settings[:format] && Array(settings[:content_types]).size == 1
end
def uses_path_versioning?
return false unless settings.key?(:version) && settings[:version_options]&.key?(:using)
settings[:version] && settings[:version_options][:using] == :path
end
def namespace?
namespace&.match?(/^\S/) && not_slash?(namespace)
end
def path?
raw_path&.match?(/^\S/) && not_slash?(raw_path)
end
def suffix
if uses_specific_format?
"(.#{settings[:format]})"
elsif !uses_path_versioning? || (namespace? || path?)
'(.:format)'
else
'(/.:format)'
end
end
def path
PartsCache[parts]
end
def path_with_suffix
"#{path}#{suffix}"
end
def to_s
path_with_suffix
end
private
class PartsCache < Grape::Util::Cache
def initialize
super
@cache = Hash.new do |h, parts|
h[parts] = Grape::Router.normalize_path(parts.join('/'))
end
end
end
def parts
[].tap do |parts|
add_part(parts, mount_path)
add_part(parts, root_prefix)
parts << ':version' if uses_path_versioning?
add_part(parts, namespace)
add_part(parts, raw_path)
end
end
def add_part(parts, value)
parts << value if value && not_slash?(value)
end
def not_slash?(value)
value != '/'
end
end
end