Ruby Language
Tworzenie / zarządzanie klejnotami

Pliki Gemspec

Każdy klejnot ma plik w formacie <gem name>.gemspec który zawiera metadane dotyczące klejnotu i jego plików. Format gemspec jest następujący:

Gem::Specification.new do |s|
  # Details about gem. They are added in the format:
  s.<detail name> = <detail value>
end

Pola wymagane przez RubyGems to:

Albo author = string lub authors = array

Użyj author = jeśli jest tylko jeden autor, a authors = gdy jest wielu. Dla authors= użyj tablicy z nazwiskami autorów.

files = array

Tutaj array zawiera listę wszystkich plików w klejnocie. Można tego również użyć z funkcją Dir[] , na przykład jeśli wszystkie twoje pliki znajdują się w katalogu /lib/ , możesz użyć files = Dir["/lib/"] .

name = string

Tutaj string to tylko nazwa twojego klejnotu. Rubygems zaleca kilka zasad, których powinieneś przestrzegać, nazywając swój klejnot.

1. Używaj podkreślników, BEZ PRZESTRZENI
2. Używaj tylko małych liter
3. Używaj łączników do przedłużania klejnotów (np. Jeśli twój klejnot nosi nazwę example rozszerzenia, nazwałbyś go example-extension ), aby wtedy, gdy wymagane jest rozszerzenie, może być wymagane jako require "example/extension" .

RubyGems dodaje również: „Jeśli opublikujesz klejnot na rubygems.org, może on zostać usunięty, jeśli nazwa jest nieodpowiednia, narusza własność intelektualną lub zawartość klejnotu spełnia te kryteria. Możesz zgłosić taki klejnot na stronie wsparcia RubyGems”.

platform=

Nie wiem

require_paths=

Nie wiem

summary= string

Sznurek jest letnim celem klejnotów i wszystkim, czym chciałbyś się podzielić o klejnocie.

version= string

Aktualny numer wersji klejnotu.

Zalecane pola to:

email = string

Adres e-mail, który zostanie powiązany z klejnotem.

homepage= string

Strona internetowa, na której mieszka klejnot.

Albo license= lub licenses=

Nie wiem

Budowanie klejnotu

Po utworzeniu klejnotu, aby go opublikować, musisz wykonać kilka kroków:

1. Zbuduj swój klejnot za pomocą gem build <gem name>.gemspec (plik gemspec musi istnieć)
2. Tworzenie a RubyGems Konta Jeżeli nie masz jeszcze tutaj
3. Sprawdź, aby upewnić się, że nie istnieją żadne klejnoty, które mają taką samą nazwę
4. Opublikuj swój klejnot za pomocą gem publish <gem name>.<gem version number>.gem

Zależności

Aby wyświetlić drzewo zależności:

gem dependency

Aby wyświetlić listę klejnotów zależnych od konkretnego klejnotu (na przykład pakiet)

gem dependency bundler --reverse-dependencies