Ruby can haz Everyone

Ruby Can Haz
EVERYONE!
Mikel Lindsaar
@raasdnil

Friday, 22 April 2011

Working in Rails & Ruby for 5+ Years

Author of Mail, maintain TMail

Rails Committer

Entrepreneur

http://stillalive.com/

http://rubyx.com/


Example of StillAlive.com
Full stack production
monitoring for your app


Ruby Wants You


MINSWAN
Matz is nice, so we are nice


Scratch Your Own Itch


How do I start?

Patch a library

Write a library


Patch a Library


6 Steps to Patch
Fork on GitHub
Clone
Write a failing test case
Run the tests { Fix the code }
Push to your fork
Send a pull request


Fork


Clone


Write a Failing Test Case


Fix the Code


Run the tests

Multiple Rubies?

Make it greener than you started


Push to your fork

Detailed commit message

Don’t push changes to the version


Send a Pull Request


Proﬁt


Write a Library


README Driven Dev


README Driven Dev

tom.preston-werner.com

Google “README Driven Development”

2010/08/23/readme-driven-development.html


Write your Wish List


Research as Needed


Research as Needed

RFCs


Setup Your Gem

Read http://docs.rubygems.org/read/book/7

Create a simple directory structure

Get your tests failing


Simple Gem Creation
You don’t need no tools

http://github.com/rubyx/nugget

Builds a gem skeleton with ruby

$ ruby -s <(curl -s https://github.com/rubyx/nugget/raw/master/install.rb)


More on Nugget

Need to do lots of things to get started

Lowers barrier to entry to release a gem

5 minutes => Nothing to published on rubygems


Nugget File Structure


Nugget Patches Wanted

Add test unit support

Rails gem support?

Make it a gem


Test First Development
I use RSpec because I am lazy and forget stuff

EVERYTHING in Mail is BDD

Regressions Caught

Seriously - do it


Testing for Libraries
Start Simple

Comments in Spec Files are OK

Use Custom Matchers

Break Down Your Spec Files

Spec in Multiple Rubies


Start Somewhere


Start Simple


Comments are OK


Use Custom Matchers
when appropriate


Break Down Spec Files


Break Down Spec Files
26 Sub Directories

79 Ruby Spec Files

73 Edge Case Emails

Many Many Lines of Specs

1,289 examples

No Failures :)

Spec in Multiple Rubies
Have to be a good Ruby Citizen

MRI - 1.8.7, 1.9.2

JRuby

REE

Rubinius


Devil is in the Detail


And Thats It!

Simple Hey?


Header Errors Legacy Emails
Parsers rfc822 Delivery Agents
And Thats It! SMTP
Body Decoding
SPAM PGP Signing POP3 File Types
Mbox Simple Hey? Network
IMAP Language Support
Sendmail Delivery Bad Emails Encoding
Edge Cases
Pattern Matching
OMGMIME! Decoding Attachments
Interceptors
File IO Domain Key Emails
Observers Status Reports
Inline Attachments

Listen to your Users


Listen to your Users
(but not blindly)


Have Good Specs


Encourage Participation
MIT License

Clear “How to Test” Instructions

Clear “How to Contribute” Instructions

Modular Design

Mail has 53 contributors


Release Often


Questions?
Mikel Lindsaar
@raasdnil

RubyX.com StillAlive.com

We are hiring!

I can ﬁx thiz: http://netherregionoftheearthii.blogspot.com/2010_04_18_archive.html
Video Cat: http://www.coolfunnycats.com/?p=1954
Repair Cat: http://www.mike2.com/category/animals/cats/page/4/
All Other Cats: http://icanhascheezburger.com/


Ruby can haz Everyone

Recommended

Recommended

More Related Content

Similar to Ruby can haz Everyone

Similar to Ruby can haz Everyone (20)

Recently uploaded

Recently uploaded (20)

Ruby can haz Everyone