Отделение Bundler: тщательный взгляд на утилиты Bundler

 $ bundle gem bundler bundle gem my-new-gem Creating gem 'my-new-gem'... create my-new-gem/Gemfile create my-new-gem/.gitignore create my-new-gem/lib/my/new/gem.rb create my-new-gem/lib/my/new/gem/version.rb create my-new-gem/my-new-gem.gemspec create my-new-gem/Rakefile create my-new-gem/README.md create my-new-gem/bin/console create my-new-gem/bin/setup create my-new-gem/.travis.yml create my-new-gem/.rspec create my-new-gem/spec/spec_helper.rb create my-new-gem/spec/my/new/gem_spec.rb Initializing git repo in /path/my-new-gem 

Вы можете увидеть все, что создала команда:

• Конечно, мы получаем Gemfile
• Мы также получаем инициализированный репозиторий git, дополненный .gitignore . О, и все новые файлы git add в индекс.
• Стандартные файлы gem, включая gemspec, Rakefile, файлы версий, двоичные файлы для console и setup .
• В моем случае он генерировал файлы RSpec для тестирования. Это означает, что некоторое время назад я запускал bundle gem , мне было предложено выбрать rspec тестирования (RSpec или Minitest) и выбрал rspec .
• Файл конфигурации Travis CI, который, честно говоря, я понятия не имею, почему он является частью вывода bundle gem по умолчанию. Я чувствую, что должен что-то сделать, чтобы это произошло.

Кроме того, есть пара пунктов, не показанных выше: кодекс поведения и лицензия. Опять же, я должен отказаться от тех, в какой-то момент, когда я bundle gem камни в прошлом.

С точки зрения опций, большинство опций заключается в переопределении создания (или пропуска) частей драгоценного камня. Существуют варианты создания или пропуска следующего: исполняемый файл для --exe ( --exe или --exe --no-exe ), кодекс поведения (RO) ( --coc , --coc --no-coc ), шаблон расширения C ( --ext , --no-ext ), лицензия MIT (RO) ( --mit , --mit --no-mit ).

Единственными двумя другими параметрами являются -e чтобы открыть .gemspec в вашем $EDITOR и --test=TEST (RO), чтобы указать rspec или minitest .

расслоение платформы

bundle platform сообщит вам, какие платформы Ruby вы указали или какие платформы использует ваш гем:

 $ bundle platform Your platform is: x86_64-darwin15 Your app has gems that work on these platforms: * ruby Your Gemfile does not specify a Ruby version requirement. 

Итак, я бегу на Mac, используя МРТ. Если я добавлю ruby "2.3.0" в мой Gemfile, вот что произойдет:

 $ bundle platform our platform is: x86_64-darwin15 Your app has gems that work on these platforms: * ruby Your Gemfile specifies a Ruby version requirement: * ruby 2.3.0 Your current platform satisfies the Ruby version requirement. 

Существует опция --ruby , которая просто возвращает версию Ruby, указанную в Gemfile, если таковая имеется.

чистый комплект

Иногда вы устанавливаете гемы (случайно или специально), которые не используются вашим приложением. Кроме того, если вы используете RVM, в какой-то момент я знаю, что неиспользуемые гемы после установки никогда не удаляются из гемсета. Таким образом, bundle clean позаботится об этом:

 $ bundle clean Cleaning all the gems on your system is dangerous! If you're sure you want to remove every system gem not in this bundle, run `bundle clean --force`. 

Вау, это страшное сообщение. закрывает глаза

 $ bundle clean --force Removing ruby-graphviz (1.2.2) 

Ах, это только что ruby-graphviz гем ruby-graphviz из моего текущего набора гемов, который я установил, чтобы показать вам bundle viz .

расслоение binstubs

Binstubs — это сценарии, которые используются для переноса исполняемых файлов, чтобы установить среду для этого исполняемого файла. Это как шаблон Decorator, но для исполняемых файлов. Если вы когда-нибудь запускали bundle exec <some command> , это почти то же самое. Bundler достаточно любезен, чтобы предложить bundler binstub <a gem in the bundle> чтобы сгенерировать файл, который вы можете вызвать, который упаковывает вещи по мере необходимости:

 $ bundle binstubs rack 

Это создаст каталог bin и напишет binstubs для всех исполняемых файлов в геме стойки. В этом случае есть только один ( rackup ). Итак, теперь мы можем вызвать bin/rackup и он будет запущен в контексте нашего пакета.

Кстати, если вы запустите bundle install --binstubs (RO) , то Bundler сгенерирует binstub для каждого гема с исполняемыми файлами при каждой bundle install .

пучок инъекций

Это странно. bundle inject принимает имя и версию гема и внедряет их в Gemfile и Gemfile.lock:

 $ bundle inject rspec ">0" ...performs resolution... Added to Gemfile: rspec (> 0) 

rspec не устанавливается до тех пор, пока не будет запущена bundle install . Я понятия не имею, почему кто-то будет использовать это, но держу пари, что есть веская причина (пожалуйста, сообщите нам в комментариях, если вы знаете, что это такое)

версия пакета

Для полноты картины есть bundle version в bundle version :

 $ bundle version Bundler version 1.12.5 

Кстати, 1.12.5 является последней версией Bundler на момент написания этой статьи? Какую версию вы используете? Могу поспорить, что некоторые из вас не обновили Bundler за долгое время …

Выполнено

Это вкратце утилиты Bundler. Что ж, если под «ореховой скорлупой» я подразумеваю «отчасти дольше, чем я намеревался написать в блоге». Тем не менее, я узнал довольно много вещей и, вероятно, кое-что понял неправильно. Итак, если вы видите ошибку, дайте мне знать. Идите вперед и расслоение.