Ruby: Метод fetch и извлечение значений из хеша

В Ruby значения из хеша по ключу извлекает метод [] и fetch(). В чем же принципиальное отличие между ними?

Если запрашивать значение по несуществующему ключу, метод [] молча возвращает nil.

env = {
  host: 'localhost',
  port: 3000 
}
puts env[:user] # -> nil

Метод fetch() же действует иначе - если ключа нет, получим ошибку КеуError.

env = {
  host: 'localhost',
  port: 3000 
}
puts env.fetch(:user) # ->  получим ошибку key not found (KeyError)

Но это поведение можно переопределить, так как метод fetch() принимает вторым параметром значение по умолчанию:

env = {
  host: 'localhost',
  port: 3000 
}
puts env.fetch(:user, nil) # -> nil
puts env.fetch(:user, 'guest') # ->  'guest'

И даже блок или лямбда-функцию:

env = { host: 'localhost' }

env.fetch(:user) {  |key| env[key] = 'guest' }
puts env # -> { host: 'localhost', user: 'guest' }

Пример конфигурации почтовой рассылки из приложения на Ruby on Rails:

config.action_mailer.smtp_settings = {
  user_name: ENV.fetch('MAIL_USERNAME', nil),
  password: ENV.fetch('MAIL_PASSWORD', nil),
  address: ENV.fetch('MAIL_HOST', nil),
  domain: ENV.fetch('MAIL_HOST', nil),
  port: ENV.fetch('SMTP_PORT', '25'),
  authentication: :cram_md5
}

Ruby style guide советует использовать метод fetch() вместо метода [].

Задание

Реализуйте функцию setup_env().

Функция принимает: ключ, хеш и блок который тоже принимает два параметра: хеш и ключ из параметров функции.

Если переданного ключа нет в хеше, то вызываем блок и передаем в него параметры: хеш и ключ, в результате функция должна вернуть обработанный хеш.

Eсли ключ присутствует, то функция должна вернуть хеш в неизменном виде.

env = { api_key: 123 }
setup_env(:host, env) { |env, key|  env[key] = 'localhost' } # -> { api_key: 123, host: 'localhost' }
setup_env(:api_key, env) { |env, key|  env[key] = 'localhost' } # -> { api_key: 123 }
env == { api_key: 123 } # -> true

Функция не должна мутировать исходный объект.

Полезное

• yield

• fetch()