LoremCasiano

This gem describes the way to build a gem using bundler

Tutorial

  1. $ bundle gem lorem_casiano create lorem_casiano/Gemfile create lorem_casiano/Rakefile create lorem_casiano/LICENSE create lorem_casiano/README.md create lorem_casiano/.gitignore create lorem_casiano/lorem_casiano.gemspec create lorem_casiano/lib/lorem_casiano.rb create lorem_casiano/lib/lorem_casiano/version.rb Initializating git repo in /Users/casiano/Dropbox/src/ruby/makingagemwithbundler/lorem_casiano makingagemwithbundler$ cd lorem_casiano/

    As it says, it initializes a git repo

  2. The lorem_casiano.gemfile file looks like this:

$ cat lorem_casiano.gemspec # -- encoding: utf-8 -- require File.expand_path('../lib/lorem_casiano/version', FILE)

  Gem::Specification.new do |gem|
    gem.authors       = ["Casiano Rodriguez"]
    gem.email         = ["[email protected]"]
    gem.description   = %q{TODO: Write a gem description}
    gem.summary       = %q{TODO: Write a gem summary}
    gem.homepage      = ""

    gem.files         = `git ls-files`.split($\)
    gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
    gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
    gem.name          = "lorem_casiano"
    gem.require_paths = ["lib"]
    gem.version       = LoremCasiano::VERSION
  end

  1. The version for the project is taken from lib/lorem_casiano/version.rb

        $ cat lib/lorem_casiano/version.rb 
    module LoremCasiano
      VERSION = "0.0.1"
    end

modify it to "0.0.2"

  1. vi lib/lorem_casiano.rb. Introduce method ipsum

  2. Fill the TODOs in lorem_casiano.gemspec vi lorem_casiano.gemspec

  3. Generate the gem:

    $ gem build lorem_casiano.gemspec 
WARNING:  no homepage specified
  Successfully built RubyGem
  Name: lorem_casiano
  Version: 0.0.2
  File: lorem_casiano-0.0.2.gem

which generates a file "lorem_casiano-0.0.2.gem"

Usage

TODO: Write usage instructions here

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

See Also

  1. http://railscasts.com/episodes/245-new-gem-with-bundler "New Gem with Bundler"

  2. http://no-fucking-idea.com/blog/2012/04/11/building-gem-with-bundler/ "Building Gem With Bundler"

  3. http://pablotron.org/files/signing_gems.txt