Tworzenie własnego gema

Ruby pozwala programistom tworzyć własne biblioteki wielokrotnego użytku, nazywane gemami.

W tej lekcji nauczą się Państwo tworzyć i publikować gema Ruby.

Rozpoczynanie nowego projektu gema

Użyj Bundlera, aby wygenerować strukturę nowego gema:

bundle gem my_gem

Poznawanie struktury plików gema

Wygenerowany projekt gema zawiera:

• lib/: zawiera główny kod gema.
• my_gem.gemspec: definiuje metadane gema.
• Rakefile: służy do zadań automatyzujących.

Pisanie kodu gema

Edytuj plik lib/my_gem.rb, aby zdefiniować funkcje gema.

module MyGem
  def self.hello
    'Hello from MyGem!'
  end
end

Edycja pliku .gemspec

Plik my_gem.gemspec zawiera metadane gema.

Gem::Specification.new do |spec|
  spec.name        = 'my_gem'
  spec.version     = '0.1.0'
  spec.summary     = 'A simple example gem'
  spec.authors     = ['Your Name']
  spec.files       = Dir['lib/**/*.rb']
end

Budowanie gema

Uruchom następujące polecenie, aby utworzyć pakiet gema:

gem build my_gem.gemspec

Lokalne instalowanie i testowanie gema

Zainstaluj gema lokalnie przed opublikowaniem:

gem install ./my_gem-0.1.0.gem

Publikowanie gema w RubyGems.org

Aby opublikować gema, najpierw uwierzytelnij się, a następnie wypchnij gema:

gem push my_gem-0.1.0.gem

Gratulacje!

Nauczyli się Państwo tworzyć i publikować własnego gema Ruby.

To kończy sekcję „Praca z gemami i Bundlerem”.