require_relative é um subconjunto conveniente de require
require_relative('path')
é igual a:
require(File.expand_path('path', File.dirname(__FILE__)))
se __FILE__for definido ou suscitar o LoadErrorcontrário.
Isso implica que:
require_relative 'a'e require_relative './a'exigir em relação ao arquivo atual ( __FILE__).
É isso que você deseja usar ao solicitar dentro da sua biblioteca, pois não deseja que o resultado dependa do diretório atual do chamador.
eval('require_relative("a.rb")')aumenta LoadErrorporque __FILE__não está definido por dentro eval.
É por isso que você não pode usar require_relativenos testes do RSpec, que são evaleditados.
As seguintes operações são possíveis apenas com require:
require './a.rb'requer em relação ao diretório atual
require 'a.rb'usa o caminho de pesquisa ( $LOAD_PATH) para exigir. Ele não encontra arquivos relativos ao diretório ou caminho atual.
Isso não é possível require_relativeporque os documentos dizem que a pesquisa de caminho ocorre apenas quando "o nome do arquivo não é resolvido para um caminho absoluto" (ou seja, começa com /ou ./ou ../), o que é sempre o caso File.expand_path.
A operação a seguir é possível com os dois, mas você deseja usá- requirelo, pois é mais curto e mais eficiente:
require '/a.rb'e require_relative '/a.rb'ambos exigem o caminho absoluto.
Lendo a fonte
Quando os documentos não estiverem claros, recomendo que você dê uma olhada nas fontes (alterne a fonte nos documentos). Em alguns casos, ajuda a entender o que está acontecendo.
exigir:
VALUE rb_f_require(VALUE obj, VALUE fname) {
return rb_require_safe(fname, rb_safe_level());
}
require_relative:
VALUE rb_f_require_relative(VALUE obj, VALUE fname) {
VALUE base = rb_current_realfilepath();
if (NIL_P(base)) {
rb_loaderror("cannot infer basepath");
}
base = rb_file_dirname(base);
return rb_require_safe(rb_file_absolute_path(fname, base), rb_safe_level());
}
Isso nos permite concluir que
require_relative('path')
é o mesmo que:
require(File.expand_path('path', File.dirname(__FILE__)))
Porque:
rb_file_absolute_path =~ File.expand_path
rb_file_dirname1 =~ File.dirname
rb_current_realfilepath =~ __FILE__
$:. Veja stackoverflow.com/questions/2900370