Class: Puppet::Indirector::FileMetadata::Rest

Inherits:
REST show all
Defined in:
lib/puppet/indirector/file_metadata/rest.rb

Constant Summary

Constants inherited from REST

REST::EXCLUDED_FORMATS, REST::IndirectedRoutes, REST::MAJOR_VERSION_JSON_DEFAULT

Constants included from Util

Util::AbsolutePathPosix, Util::AbsolutePathWindows, Util::DEFAULT_POSIX_MODE, Util::DEFAULT_WINDOWS_MODE, Util::PUPPET_STACK_INSERTION_FRAME, Util::RFC_3986_URI_REGEX

Constants included from Util::SymbolicFileMode

Util::SymbolicFileMode::SetGIDBit, Util::SymbolicFileMode::SetUIDBit, Util::SymbolicFileMode::StickyBit, Util::SymbolicFileMode::SymbolicMode, Util::SymbolicFileMode::SymbolicSpecialToBit

Constants included from Util::POSIX

Util::POSIX::LOCALE_ENV_VARS, Util::POSIX::USER_ENV_VARS

Constants included from Util::Docs

Util::Docs::HEADER_LEVELS

Instance Attribute Summary

Attributes included from Util::Docs

#doc, #nodoc

Instance Method Summary collapse

Methods inherited from REST

#add_profiling_header, #destroy, #do_request, #handle_response, #head, #headers, #http_delete, #http_get, #http_head, #http_post, #http_put, #http_request, #network, port, #save, server, srv_service, #use_http_client?, use_port_setting, use_server_setting, use_srv_service, #validate_key

Methods inherited from Terminus

abstract_terminus?, #allow_remote_requests?, const2name, #indirection, indirection_name, inherited, #initialize, mark_as_abstract_terminus, #model, model, #name, name2const, register_terminus_class, terminus_class, terminus_classes, #terminus_type, #validate, #validate_key, #validate_model

Methods included from Util::InstanceLoader

#instance_hash, #instance_load, #instance_loader, #instance_loading?, #loaded_instance, #loaded_instances

Methods included from Util

absolute_path?, benchmark, chuser, clear_environment, default_env, deterministic_rand, deterministic_rand_int, exit_on_fail, format_backtrace_array, format_puppetstack_frame, get_env, get_environment, logmethods, merge_environment, path_to_uri, pretty_backtrace, replace_file, resolve_stackframe, safe_posix_fork, set_env, skip_external_facts, symbolizehash, thinmark, uri_encode, uri_query_encode, uri_to_path, uri_unescape, which, withenv, withumask

Methods included from Util::SymbolicFileMode

#normalize_symbolic_mode, #symbolic_mode_to_int, #valid_symbolic_mode?

Methods included from Util::POSIX

#get_posix_field, #gid, groups_of, #idfield, #methodbyid, #methodbyname, #search_posix_field, #uid

Methods included from Util::Docs

#desc, #dochook, #doctable, #markdown_definitionlist, #markdown_header, #nodoc?, #pad, scrub

Constructor Details

This class inherits a constructor from Puppet::Indirector::Terminus

Instance Method Details

#find(request) ⇒ Object


10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
# File 'lib/puppet/indirector/file_metadata/rest.rb', line 10

def find(request)
  return super unless use_http_client?

  url = URI.parse(Puppet::Util.uri_encode(request.uri))
  session = Puppet.lookup(:http_session)
  api = session.route_to(:fileserver, url: url)

  _,  = api.(
    path: Puppet::Util.uri_unescape(url.path),
    environment: request.environment.to_s,
    links: request.options[:links],
    checksum_type: request.options[:checksum_type],
    source_permissions: request.options[:source_permissions]
  )
  
rescue Puppet::HTTP::ResponseError => e
  if e.response.code == 404
    return nil unless request.options[:fail_on_404]

    _, body = parse_response(e.response.nethttp)
    msg = _("Find %{uri} resulted in 404 with the message: %{body}") % { uri: elide(e.response.url.path, 100), body: body }
    raise Puppet::Error, msg
  else
    raise convert_to_http_error(e.response.nethttp)
  end
end

#search(request) ⇒ Object


37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
# File 'lib/puppet/indirector/file_metadata/rest.rb', line 37

def search(request)
  return super unless use_http_client?

  url = URI.parse(Puppet::Util.uri_encode(request.uri))
  session = Puppet.lookup(:http_session)
  api = session.route_to(:fileserver, url: url)

  _, file_metadatas = api.get_file_metadatas(
    path: Puppet::Util.uri_unescape(url.path),
    environment: request.environment.to_s,
    recurse: request.options[:recurse],
    recurselimit: request.options[:recurselimit],
    ignore: request.options[:ignore],
    links: request.options[:links],
    checksum_type: request.options[:checksum_type],
    source_permissions: request.options[:source_permissions],
  )
  file_metadatas
rescue Puppet::HTTP::ResponseError => e
  # since it's search, return empty array instead of nil
  return [] if e.response.code == 404

  raise convert_to_http_error(e.response.nethttp)
end