Faça uma joia

Criar e publicar suas próprias joias é incrivelmente simples. Aqui está o meu processo passo a passo quando desejo publicar um:

Faça uma conta Rubygems

curl -u username https://rubygems.org/api/v1/api_key.yaml > ~/.gem/credentials
Enter host password for user 'username':

chmod
0600 ~/.gem/credentials

Prepare o código

Essas etapas são meu caminho típico, nada é realmente obrigatório aí.

  • crie um repo no github (ou onde quiser)
  • criar um esqueleto de gema base bundle gem mycoolgem
  • atualize o README.md, adicione algumas informações mínimas. Quanto mais claro você explicar o que ele faz, maiores as chances de que as pessoas o adotem. Adicionar informação de ciclo
  • crie um CHANGELOG.md porque quando você publica algo você precisa de um registro claro das mudanças de sua versão
  • permitir o rastreamento em codeclimate , travis , macacões , gemnasium
  • adicione emblemas de http://shields.io no README.md porque ajuda a qualificar o estado do código rapidamente
  • quando o código gem não precisa ter acesso ao número da versão, achei conveniente apenas remover o arquivo de versão e adicionar a versão no .gemspec do arquivo changelog com (então, quando eu alterar a versão, há apenas um arquivo para editar)spec.version = File.read(File.expand_path('../CHANGELOG.md', __FILE__))[/([0-9]+.[0-9]+.[0-9]+)/]
  • escrever o código (ou copiá-lo do aplicativo privado de onde você o extraiu)
  • adicione uma especificação / ou teste / dir e escreva alguns testes e tente alcançar uma cobertura decente

Libere

  • adicione a data no changelog para a versão atual
  • rake release
  • aumentar a versão para o próximo incremento no log de mudanças (e arquivo de versão, se houver)

No geral, com o comando de pacote inicial e a tarefa de rake final para o lançamento, é bastante direto.

Verifique também http://guides.rubygems.org/make-your-own-gem/