Build a Ruby Gem

This deck covers the basics of getting started contributing to OSS and building a Ruby Gem. It goes a long with my Book, Build a Ruby gem (http://brandonhilkert.com/books/build-a-ruby-gem/).

Transcript

1. Build a Ruby Gem Brandon Hilkert @brandonhilkert http://brandonhilkert.com
2. Topics
3. March 27
5. My Background 2009 - Started Ruby/Rails 2010 - Wrote first gem 2011 - Contributed to Sidekiq 2013 - Sucker Punch 2014 - Book
8. What did i learn?
10. Hit a nerve?
11. Painpoint #2 (i think…)
15. 1 - Introduction 2 - Structure 3 - Testing 4 - Code 5 - Release 6 - Versioning 7 - Changelog 8 - Responsibility 9 - Loading 10 - Command-line Utilities ! 11 - Configuration Patterns 12 - Rails Hooks 13 - Rails View Helpers 14 - Rails Controller Includes 15 - Rails Model Includes 16 - Rails Rake Tasks 17 - Rails Generators 18 - Rails Engines 19 - Open Source Management 20 - Summary Chapter list
16. $ MegaLotto.new.draw #=> [23, 22, 3, 7, 16] $ MegaLotto.new.draw #=> [13, 20, 26, 1, 9] Codebase
17. class MegaLotto NUMBERS = 5 def draw NUMBERS.times.map do single_draw end end def single_draw rand(0…60) end end Codebase
18. getting started $ bundle help ... bundle gem(1) Create a simple gem, suitable for development with bundler ... ! $ bundle gem mega_lotto
19. getting started . "## Gemfile "## LICENSE.txt "## README.md "## Rakefile "## lib $ "## mega_lotto $ $ &## version.rb $ &## mega_lotto.rb &## mega_lotto.gemspec 
 2 directories, 7 files Main dir. Entry file Gemspec
20. # lib/mega_lotto.rb require “mega_lotto/version" ! module MegaLotto # Your code goes here... end Entry file
21. # coding: utf-8 lib = File.expand_path('../lib', __FILE__) $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib) require 'mega_lotto/version' gemspec
22. spec.files = `git ls-files`.split($/) spec.executables = spec.files.grep(%r{^bin/}) { |f| File.basename(f) } spec.test_files = spec.files.grep(%r{^(test|spec|features)/}) spec.require_paths = ["lib"] gemspec
23. spec.add_development_dependency "bundler", "~> 1.3" spec.add_development_dependency "rake" spec.add_development_dependency "rspec" spec.add_dependency "rails" gemspec
24. # lib/mega_lotto/version.rb module MegaLotto VERSION = "0.0.1" end version
25. # Rakefile require "bundler/gem_tasks" Rakefile $ rake -T rake build # Build mega_lotto-0.0.1.gem into the pkg directory rake install # Build and install mega_lotto-0.0.1.gem into system gems rake release # Create tag v0.0.1 and build and push mega_lotto-0.0.1.gem to Rubygem
26. Release! $ rake release mega_lotto 0.0.1 built to pkg/mega_lotto-0.0.1.gem. Tagged v0.0.1. Pushed git commits and tags. Pushed mega_lotto 0.0.1 to rubygems.org.
27. $ rake release mega_lotto 0.0.2 built to pkg/mega_lotto-0.0.2.gem. Tagged v0.0.2. Pushed git commits and tags. Pushed mega_lotto 0.0.2 to rubygems.org. Next Release # lib/mega_lotto/version.rb module MegaLotto VERSION = “0.0.2" # was “0.0.1” end
28. How to get started Fix a bug in an existing gem because it affects you 1 Improve an existing gem to learn more 2 Create new gem by extracting code 3
29. M arch 27 Questions? http://brandonhilkert.com http://brandonhilkert.com/ blog/3-ways-to-get-started- contributing-to-open-source/