| Current Path : /usr/share/ruby/vendor_ruby/puppet/network/ |
Linux gator3171.hostgator.com 4.19.286-203.ELK.el7.x86_64 #1 SMP Wed Jun 14 04:33:55 CDT 2023 x86_64 |
| Current File : //usr/share/ruby/vendor_ruby/puppet/network/format_handler.rb |
require 'yaml'
require 'puppet/network'
require 'puppet/network/format'
module Puppet::Network::FormatHandler
class FormatError < Puppet::Error; end
ALL_MEDIA_TYPES = '*/*'.freeze
@formats = {}
def self.create(*args, &block)
instance = Puppet::Network::Format.new(*args, &block)
@formats[instance.name] = instance
instance
end
def self.create_serialized_formats(name,options = {},&block)
["application/x-#{name}", "application/#{name}", "text/x-#{name}", "text/#{name}"].each { |mime_type|
create name, {:mime => mime_type}.update(options), &block
}
end
def self.format(name)
@formats[name.to_s.downcase.intern]
end
def self.format_for(name)
name = format_to_canonical_name(name)
format(name)
end
def self.format_by_extension(ext)
@formats.each do |name, format|
return format if format.extension == ext
end
nil
end
# Provide a list of all formats.
def self.formats
@formats.keys
end
# Return a format capable of handling the provided mime type.
def self.mime(mimetype)
mimetype = mimetype.to_s.downcase
@formats.values.find { |format| format.mime == mimetype }
end
# Return a format name given:
# * a format name
# * a mime-type
# * a format instance
def self.format_to_canonical_name(format)
case format
when Puppet::Network::Format
out = format
when %r{\w+/\w+}
out = mime(format)
else
out = format(format)
end
raise ArgumentError, "No format match the given format name or mime-type (#{format})" if out.nil?
out.name
end
# Determine which of the accepted formats should be used given what is supported.
#
# @param accepted [Array<String, Symbol>] the accepted formats in a form a
# that generally conforms to an HTTP Accept header. Any quality specifiers
# are ignored and instead the formats are simply in strict preference order
# (most preferred is first)
# @param supported [Array<Symbol>] the names of the supported formats (the
# most preferred format is first)
# @return [Puppet::Network::Format, nil] the most suitable format
# @api private
def self.most_suitable_format_for(accepted, supported)
format_name = accepted.collect do |accepted|
accepted.to_s.sub(/;q=.*$/, '')
end.collect do |accepted|
if accepted == ALL_MEDIA_TYPES
supported.first
else
format_to_canonical_name_or_nil(accepted)
end
end.find do |accepted|
supported.include?(accepted)
end
if format_name
format_for(format_name)
end
end
# @api private
def self.format_to_canonical_name_or_nil(format)
format_to_canonical_name(format)
rescue ArgumentError
nil
end
end
require 'puppet/network/formats'