Упаковка групп примеров Rspec в качестве самоцвета - PullRequest
Новая
       16

Упаковка групп примеров Rspec в качестве самоцвета

3 голосов
/ 08 января 2012

Я создал несколько общих примеров групп для Rspec, которые я хотел бы использовать в других приложениях. Лучший подход к достижению этого, кажется, состоит в том, чтобы упаковать их в драгоценный камень. Однако я не могу найти хорошее руководство, чтобы начать меня. Есть несколько различных способов сделать это, и все прочитанные мной руководства выглядят устаревшими. Кто-нибудь может указать мне правильное направление?

Ответы [ 2 ]

3 голосов
/ 08 января 2012

Необходимые знания

Драгоценные камни довольно просты, но с точки зрения документации в течение очень долгого времени существовал огромный пробел. К счастью, это уже не так.

В конечном итоге это не что иное, как файл .gemspec и понимание путей и зависимостей (о которых вам нужно знать только, если вы зависите от других драгоценных камней), хотя люди ожидают, что вы будете следовать определенным правилам.

Лучшее прохождение, которое я видел, это руководства .

Для соглашений у руководств есть хороший список здесь , а стандарт упаковки также действительно хорош.

Дальнейшие мысли

В наши дни, когда я хочу сделать драгоценный камень, я начинаю с Bundler (который я предпочитаю мотыге / новый камень / ювелир / и т. Д.). В этом Railscast рассказывается, как это сделать. Теперь Bundler будет предполагать, что вы знаете все виды вещей (git, bundler, rake), которые я делаю, так что это меня больше не беспокоит, но когда-то это было слишком много.

Простой факт в том, что вам не нужен Bundler (в будущем, если у вас есть зависимости и вы хотите сохранить свой драгоценный камень, тогда это сделает вашу жизнь проще, но сейчас вам это не нужно) , И вам не нужен git или какой-либо контроль версий, если вы еще этого не понимаете (добавьте его в свой список допуска). И вам не нужны rake (это просто CLI для общих задач, но если вы не понимаете всю хрень, которую он делает, вам это не нужно, вы можете напрямую протестировать с помощью бинарного файла rspec, вы можете упаковать свои драгоценные камни напрямую с помощью бинарного файла gem , вы можете сами управлять своим .gemspec, а не делать это для Rake и т. д.).

Хитрость заключается в том, чтобы отделить то, что все эти инструменты делают для вас, от того, что вы действительно хотите, чтобы они делали для вас. Это может быть сложно, когда вы не знаете, как они работают / что они делают, так как они хотят сделать все. Я смог преодолеть это невежество, используя действительно простой инструмент под названием gem this , который немного устарел в прошлый раз, когда я его использовал, но, в конечном счете, настолько прост, насколько вы можете его получить. Вот отличное видео от его автора.

0 голосов
/ 05 июня 2018

Создать общий пример в spec/shared/foo.rb

RSpec.shared_examples 'a foo class' do
...
end

require файл в ваших драгоценных камнях spec/spec_helper.rb, чтобы вы могли использовать его в тестовых спецификациях ваших драгоценных камней

Теперь, чтобы сделать пример доступным для проектов, устанавливающих гем, вам нужно добавить их в ваш gemspec файл 

Gem::Specification.new do |s|
 ...

 s.files         =  `git ls-files`.split("\n")
 s.files         += `git ls-files -- spec/shared/*.rb`.split("\n")
end

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

if ENV['RAILS_ENV'] == 'test'
  require File.expand_path('../spec/shared/foo.rb', __dir__)
end

Теперь, после установки gem в ваш проект rails, вы можете надежно использовать общий пример в своих тестах. (при условии, что гем разрешен в тестовой среде в вашем гемфайле) 

RSpec.describe FKlass do
  subject { described_class }

  it_behaves_like 'a foo class'
end
...