Crear su propia gema

Ruby permite a los desarrolladores crear sus propias bibliotecas reutilizables, llamadas gemas.

En esta lección, aprenderá a crear y publicar una gema de Ruby.

Iniciar un proyecto de gema nuevo

Utilice Bundler para generar la estructura de una gema nueva:

bundle gem my_gem

Comprender la estructura de archivos de una gema

Un proyecto de gema generado incluye:

• lib/: contiene el código principal de la gema.
• my_gem.gemspec: define los metadatos de la gema.
• Rakefile: se utiliza para tareas de automatización.

Escribir el código de la gema

Edite el archivo lib/my_gem.rb para definir la funcionalidad de la gema.

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

Editar el archivo .gemspec

El archivo my_gem.gemspec contiene los metadatos de la 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

Crear la gema

Ejecute el siguiente comando para crear un paquete de gema:

gem build my_gem.gemspec

Instalar y probar su gema localmente

Instale su gema localmente antes de publicarla:

gem install ./my_gem-0.1.0.gem

Publicar su gema en RubyGems.org

Para publicar su gema, autentíquese primero y, a continuación, suba la gema:

gem push my_gem-0.1.0.gem

¡Enhorabuena!

Ha aprendido a crear y publicar su propia gema de Ruby.

Con esto concluye la sección «Trabajo con gemas y Bundler».