Gemfile Mining: Погружение в Gemfile Бандлера

Bundler просто великолепен, поэтому он стал де-факто менеджером пакетов и зависимостей для приложений на Ruby. Я использовал npm и golang vendoring и другие менеджеры языковых зависимостей, но ни один из них даже не может удержать свечу от той простоты, которую предлагает Bundler.

Как я уверен, вы знаете, в основе доброты Бундлера лежит Gemfile . Gemfile содержит список драгоценных камней, которые необходимы нашему приложению для выполнения своей работы. Если вы похожи на меня, я научился использовать Gemfile и Bundler из различных руководств по Rails (и другим). Я видел, как люди печатали

  gem "a_gem"

Затем запустите bundle install Эти два шага настолько очевидны, что мне никогда не удавалось исследовать намного больше. Не говоря уже о том, что Бандлер был такой находкой после многих лет продаж зависимостей и других крайне неприятных подходов. разглагольствовать о старых днях и о том, как легко вы, бунтовщики, имеете это сейчас

После первоначальных руководств по Bundler для слепого следования пошаговым инструкциям я выбрал другие параметры Gemfile, такие как grouppathgithub Однако на днях я решил прочитать документы Bundler, в частности, о Gemfile, и был поражен всеми вариантами, которые я не использовал. Я научился нескольким вещам, поэтому решил, что другие тоже могут.

В сегодняшнем посте я собираюсь найти варианты в Gemfile. Здесь действительно нет ничего, что вы не могли бы увидеть в превосходной документации Bundler, но вы этого не читали, не так ли ??? разглагольствовать о том, почему мы не можем иметь хорошие вещи

Основы

Всегда хорошее место для начала, это то, что вы, вероятно, уже знаете.

Источник

В верхней части всех Gemfiles есть строка вроде этой:

 source "https://rubygems.org"

Эта строка указывает Bundler использовать сайт Rubygems в качестве единственного источника для всех драгоценных камней, перечисленных здесь. Вот что вы можете не знать:

• Вы можете иметь несколько строк sourceобратном порядке, в котором они перечислены. Мне это не очень нравится, но оно есть.
• Если вы используете частный гем-сервер, вам нужно установить имя пользователя и пароль, используя source Не кладите его в GEMFILE, потому что он окажется на Github, и тогда ваши личные жемчужины станут открытыми, и наступит хаос.
• Хорошо, вы можете поместить пользователя и пароль в сам URL ( bundle config В любом случае, ты собираешься это сделать? разглагольствовать о том, что молодые люди никогда не слушают

Драгоценные камни

Правильно. Мы все знаем, как указать драгоценный камень в Gemfile, верно?

 https://user:pass@gem.server.com

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

• Используйте конкретную версию: gem "name-of-gem"
Вы можете найти конкретные версии на Rubygems.org (при условии, что это gem "name-of-gem", "1.0"выполнив поиск вашего драгоценного камня и просмотрев перечисленные «Версии».
• Используйте оператор версии: source Это тянет в любой драгоценный камень, который после 1.0.
• Используйте этот странный оператор squiggly-stabby: gem "name-of-gem", ">1.0" Этот оператор, который некоторые называют «тиддл-чёрт», в основном говорит «любая версия больше этой, но меньше следующей незначительной ревизии». Поскольку я уверен, что вы знаете, что такое семантическое управление версиями , мне не нужно объяснять, что второстепенная версия — это второе число. В этом примере это означает «любая версия больше или равна 1,3, но меньше 1,4». Он также работает с основными версиями, поэтому gem "name-of-gem", "~>1.3"~>12~>1.0.rc.1
• Используйте составное требование: 1.0.rc Здесь мы хотим конкретную версию, но все в порядке с более новыми незначительными выпусками Никто не делает это.

группы

Bundler позволяет вам распределить ваши зависимости в разные группы. Это чаще всего используется для установки в среду разработки других драгоценных камней, чем те, которые установлены в производственной среде. Вы можете указать группы для драгоценного камня в той же строке, что и драгоценный камень, или поместив драгоценный камень в gem "name-of-gem", "~>2.2", ">=2.2.1"

 group

Затем вы можете избежать установки определенной группы (или групп) в определенную среду, используя gem "my-dev-tool", group: :development

group :development, :test do
gem "my-test-tool"
end
--withoutbundle install

Редкие Находки

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

 gem "my-java-gem", platform: jruby

 install_if -> { RUBY_PLATFORM =~ /darwin/ } do
  gem "pasteboard"
end

 gem "rspec", require: "spec"

 gem 'rspec', require: false

 gem "a-gem", source: "https://my-private-gem-server.com" 

source "https://my-private-gem-server.com" do
  gem "a-gem"
  gem "b-gem"
end

 gem "my-git-gem", git: "https://github.com/me/my-git-gem.git"

 git "http://github.com/me/many_gems.git" do
  gem "a-gem"
  gem "b-gem"
end

 gem "my-git-gem-with-on-spec", "0.1", git: "https://github.com/me/my-git-gem-with-no-spec.git"

 gem "my-git-gem", git: "https://github.com/me/my-git-gem.git", branch: "the_new_stuff"
gem "my-git-gem", git: "https://github.com/me/my-git-gem.git", tag: "1.0.rc2"
gem "my-git-gem", git: "https://github.com/me/my-git-gem.git", ref: "5acdb"

 gem "my-gem-of-submodules", git: "https://github.com/me/my-gem-of-submodules.git", submodules: true

 gem "my-git-gem", github: "me/my-git-gem.git"

 gem "rails", github: "rails" # Works b/c the repo is https://github.com/rails/rails.git

 gem "my-private-gem", git: "https://<the_token>:x-oauth-basic@github.com/me/my-private-gem.git"

 bundle config

 bundle config github.com <the_token>

 ~/.bundle/config

 git_source(:stash){ |repo_name| "https://stash.corp.acme.pl/#{repo_name}.git" }
gem "rails", :stash => "forks/rails"

 path

 path "~/my-gems" do
  gem "mine-mine-all-mine"
  gem "acts-as-myspace"
end

 ruby "~>2.1"

 ruby "~>2.1", engine: "jruby", engine_version: "9.0.3.0"

 ruby