Хранение номера версии в Ruby Gem

Question

Как сохранить номер версии моего кода внутри рубинового драгоценного камня?

Я видел две техники в дикой природе:

1. <gem root>/VERSION, который содержит только ваш semver.
2. <gem root>/lib/your_gem/version.rb который содержит следующий код:

 

module IfYourCodeIsInAModule 
    class YourGem 
    VERSION="0.0.1" 
    end 
end 

Мне нравится 1. потому что это действительно очевидно. Мне нравится 2. потому что это часть моего кода, я могу легко записывать в журналы с моим номером версии.

Мне не нравится 1. потому что, если я хочу получить доступ к номеру версии из моего кода, мне нужно сделать файл прочитанным (не самое худшее), мне не нравится 2. потому что если мое ядро класс распространяется из другого класса, тогда я должен иметь эту децентрацию в version.rb (или получить superclass mismatch) - например.

module IfYourCodeIsInAModule 
    class YourGem < OtherWork 
    VERSION = "0.0.1" 
    end 
end 

Если вам нужен этот файл из вашего фактического кода для выполнения, все в порядке. Когда вы включите его в свой gemspec, вам вдруг понадобится require 'other_work', чтобы получить номер вашей версии!

Я счастлив пойти и бросить свое решение, но это не может быть новой проблемой, что делает сообщество, и какова общая мудрость в этом вопросе?

Answer 1

Я не являюсь экспертом в области эссенции драгоценных камней VERSION, но, возможно, этот неспециалист делает меня все более средним и лучше подходит для ответа на вопросы об «общей мудрости».

Итак, общая мудрость есть, use Bundler. И как только вы создадите свой камень на bundle gem my_gem_name, вы увидите, что поставщик автоматически создает файл lib/my_gem_name/version.rb и требует его от вашего lib/my_gem_name.rb. Поэтому я хотел бы предложить, что если вы решили не использовать Bundler и свернуть свой собственный драгоценный камень по своему усмотрению, вы все равно должны иметь отдельный version.rb файл, содержащий только

module MyGemName 
    VERSION = "0.0.1" 
end 

То есть, прямо под главным модулем. Затем вы загружаете version.rb от lib/my_gem_name.rb. Конечно, если ваш код организован более чужими способами, вам нужно импровизировать больше.