Sha256: 9bab1112cc7d9545e330b133c9d89397c3c83867d73d45143b3702d3ad35159f
Contents?: true
Size: 1.62 KB
Versions: 8
Compression:
Stored size: 1.62 KB
Contents
# typed: strict
# frozen_string_literal: true
module URI
class Generic
extend T::Sig
# Avoid a deprecation warning with Ruby 3.4 where the default parser was changed to RFC3986.
# This condition must remain even after support for 3.4 has been dropped for users that have
# `uri` in their lockfile, decoupling it from the ruby version.
PARSER = T.let(const_defined?(:RFC2396_PARSER) ? RFC2396_PARSER : DEFAULT_PARSER, RFC2396_Parser)
class << self
extend T::Sig
sig { params(path: String, fragment: T.nilable(String), scheme: String).returns(URI::Generic) }
def from_path(path:, fragment: nil, scheme: "file")
# On Windows, if the path begins with the disk name, we need to add a leading slash to make it a valid URI
escaped_path = if /^[A-Z]:/i.match?(path)
PARSER.escape("/#{path}")
elsif path.start_with?("//?/")
# Some paths on Windows start with "//?/". This is a special prefix that allows for long file paths
PARSER.escape(path.delete_prefix("//?"))
else
PARSER.escape(path)
end
build(scheme: scheme, path: escaped_path, fragment: fragment)
end
end
sig { returns(T.nilable(String)) }
def to_standardized_path
parsed_path = path
return unless parsed_path
unescaped_path = PARSER.unescape(parsed_path)
# On Windows, when we're getting the file system path back from the URI, we need to remove the leading forward
# slash
if %r{^/[A-Z]:}i.match?(unescaped_path)
unescaped_path.delete_prefix("/")
else
unescaped_path
end
end
end
end
Version data entries
8 entries across 8 versions & 1 rubygems