Configurar RSpec para probar una gema (no Rails)

La solución de Iain anterior funciona muy bien!

Si también quieres un Rakefile, esto es todo lo que necesitas:

require 'rspec/core/rake_task'

RSpec::Core::RakeTask.new(:spec)

# If you want to make this the default task
task default: :spec

Compruebe el RDoc para RakeTask para varias opciones que puede pasar opcionalmente a la definición de la tarea.

Puede generar su nueva gema con rspec ejecutando bundler gem --test=rspec my_gem. No hay configuración adicional!

Siempre olvido esto. Se implementa aquí: https://github.com/bundler/bundler/blob/33d2f67d56fe8bf00b0189c26125d27527ef1516/lib/bundler/cli/gem.rb#L36

Aquí hay una manera barata y fácil (aunque no se recomienda oficialmente):

Haga un dir en la raíz de su gema llamado spec, ponga sus especificaciones allí. Probablemente ya tenga instalado rspec, pero si no lo tiene, simplemente haga un gem install rspec y olvídese de Gemfiles y bundler.

A continuación, harás una especificación, y necesitas indicarle dónde está tu aplicación, dónde están tus archivos e incluir el archivo que deseas probar (junto con cualquier dependencia que tenga):

# spec/awesome_gem/awesome.rb
APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..', '..'))
$: << File.join(APP_ROOT, 'lib/awesome_gem') # so rspec knows where your file could be
require 'some_file_in_the_above_dir' # this loads the class you want to test

describe AwesomeGem::Awesome do
  before do
    @dog = AwesomeGem::Awesome.new(name: 'woofer!')
  end
  it 'should have a name' do
    @dog.name.should eq 'woofer!'
  end
  context '#lick_things' do
    it 'should return the dog\'s name in a string' do
      @dog.lick_things.should include 'woofer!:'
    end
  end
end

Abra la terminal y ejecute rspec:

~/awesome_gem $ rspec
..

Finished in 0.56 seconds
2 examples, 0 failures

Si quieres algunas opciones de .rspec love, ve a crear un archivo .rspec y ponlo en la ruta raíz de tu gema. El mío se ve así:

# .rspec
--format documentation --color --debug --fail-fast

, Fácil, rápido, limpio!

Me gusta esto porque no tienes que añadir ninguna dependencia a tu proyecto, y todo sigue siendo muy rápido. bundle exec ralentiza un poco las cosas, que es lo que tendría que hacer para asegurarse de que está utilizando la misma versión de rspec todo el tiempo. Que 0.56 segundos tomó para ejecutar dos pruebas fue 99% ocupado por el tiempo que tomó mi computadora para cargar rspec. Ejecutar cientos de especificaciones debería ser extremadamente rápido. El único problema que podría encontrar que estoy al tanto es que si cambia las versiones de rspec y la nueva versión no es compatible con algunas funciones que utilizó en su prueba, es posible que tenga que volver a escribir algunas pruebas.

Esto es bueno si está haciendo especificaciones únicas o tiene alguna buena razón para NO incluir rspec en su gemspec, sin embargo, no es muy bueno para permitir compartir o hacer cumplir la compatibilidad.