gmail 0.4.0 → 0.4.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d3e753fcd22946f3ad280435f97d76e1eb4ec7e0
+  data.tar.gz: 4bfe8802c7750714025da3b52a1e15bfdc46ea02
+SHA512:
+  metadata.gz: 084f0398746da01275b728cee3a700c02c6f43a8fd67e6e3826da737c51547cf1a547cae8073adf48f0c582df66a80b98025c3b686d4100ef478d76d8b31df1c
+  data.tar.gz: 5a7c3721ed3e94d74ea092d756d2826b63496c8f4ec5f8abdcda1ed6b7ea6c441ba602a9b089e40e2ca11facbfc487733c292d97961d6f30cce9120b1c5f9e99

data/.gitignore

@@ -1,25 +1,26 @@
-## MAC OS
-.DS_Store
-
-## TEXTMATE
-*.tmproj
-tmtags
-
-## EMACS
-*~
-\#*
-.\#*
-
-## VIM
-*.swp
-
-## PROJECT::GENERAL
-coverage
-rdoc
-pkg
-
-## PROJECT::SPECIFIC
-*.rdb
-
-## Test Account details
-spec/account.yml
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+Gemfile.lock
+
+## PROJECT::SPECIFIC
+*.rdb
+
+## Test Account details
+spec/account.yml

data/.rspec

@@ -0,0 +1,2 @@
+--colour
+--backtrace

data/CHANGELOG.md

@@ -1,82 +1,82 @@
-# Gmail gem changelog
-
-## 0.4.0
-
-* Added XOAUTH authentication method (Thanks Stefano Bernardi and Nicolas Fouché)
-* Separated clients
-* Fixed specs
-
-## 0.3.4
-
-* Fixes in mailbox filters shortcuts (Thanks Benjamin Bock)
-
-## 0.3.3
-
-* Added #expunge to Mailbox (Thanks Benjamin Bock)
-* Added more mailbox filters (Thanks Benjamin Bock)
-* Added shortcuts for mailbox filters
-* Minor bugfixes
-
-## 0.3.2
-
-* Added envelope fetching
-* Minor bugfixes
-
-## 0.3.0
-
-* Refactoring
-* Fixed bugs
-* API improvements
-* Better documentation
-* Code cleanup
-* RSpec for everything
-
-## 0.1.1 / 2010-05-11
-
-* Added explicit tmail dependency in gemspec
-* Added better README tutorial content
-
-## 0.0.9 / 2010-04-17
-
-* Fixed content-transfer-encoding when sending email
-
-## 0.0.8 / 2009-12-23
-
-* Fixed attaching a file to an empty message
-
-## 0.0.7 / 2009-12-23
-
-* Improved multipart message parsing reliability
-
-## 0.0.6 / 2009-12-21
-
-* Fixed multipart parsing for when the boundary is marked in quotes.
-
-## 0.0.5 / 2009-12-16
-
-* Fixed IMAP initializer to work with Ruby 1.9's net/imap
-* Better logout depending on the IMAP connection itself
-* Added MIME::Message#text and MIME::Message#html for easier access to an email body
-* Improved the MIME-parsing API slightly
-* Added some tests
-
-## 0.0.4 / 2009-11-30
-
-* Added label creation (thanks to Justin Perkins / http://github.com/justinperkins)
-* Made the gem login automatically when first needed
-* Added an optional block on the Gmail.new object that will login and logout for you
-* Added several search options (thanks to Mikkel Malmberg / http://github.com/mikker)
-
-## 0.0.3 / 2009-11-19
-
-* Fixed MIME::Message#content= for messages without an encoding
-* Added Gmail#new_message
-
-## 0.0.2 / 2009-11-18
-
-* Made all of the examples in the README possible
-
-## 0.0.1 / 2009-11-18
-
-* Birthday!
-
+# Gmail gem changelog
+
+## 0.4.0
+
+* Added XOAUTH authentication method (Thanks Stefano Bernardi and Nicolas Fouché)
+* Separated clients
+* Fixed specs
+
+## 0.3.4
+
+* Fixes in mailbox filters shortcuts (Thanks Benjamin Bock)
+
+## 0.3.3
+
+* Added #expunge to Mailbox (Thanks Benjamin Bock)
+* Added more mailbox filters (Thanks Benjamin Bock)
+* Added shortcuts for mailbox filters
+* Minor bugfixes
+
+## 0.3.2
+
+* Added envelope fetching
+* Minor bugfixes
+
+## 0.3.0
+
+* Refactoring
+* Fixed bugs
+* API improvements
+* Better documentation
+* Code cleanup
+* RSpec for everything
+
+## 0.1.1 / 2010-05-11
+
+* Added explicit tmail dependency in gemspec
+* Added better README tutorial content
+
+## 0.0.9 / 2010-04-17
+
+* Fixed content-transfer-encoding when sending email
+
+## 0.0.8 / 2009-12-23
+
+* Fixed attaching a file to an empty message
+
+## 0.0.7 / 2009-12-23
+
+* Improved multipart message parsing reliability
+
+## 0.0.6 / 2009-12-21
+
+* Fixed multipart parsing for when the boundary is marked in quotes.
+
+## 0.0.5 / 2009-12-16
+
+* Fixed IMAP initializer to work with Ruby 1.9's net/imap
+* Better logout depending on the IMAP connection itself
+* Added MIME::Message#text and MIME::Message#html for easier access to an email body
+* Improved the MIME-parsing API slightly
+* Added some tests
+
+## 0.0.4 / 2009-11-30
+
+* Added label creation (thanks to Justin Perkins / http://github.com/justinperkins)
+* Made the gem login automatically when first needed
+* Added an optional block on the Gmail.new object that will login and logout for you
+* Added several search options (thanks to Mikkel Malmberg / http://github.com/mikker)
+
+## 0.0.3 / 2009-11-19
+
+* Fixed MIME::Message#content= for messages without an encoding
+* Added Gmail#new_message
+
+## 0.0.2 / 2009-11-18
+
+* Made all of the examples in the README possible
+
+## 0.0.1 / 2009-11-18
+
+* Birthday!
+

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/LICENSE

@@ -1,21 +1,21 @@
-Copyrignt (c) 2010 Kriss 'nu7hatch' Kowalik
-Copyright (c) 2009-2010 BehindLogic
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+Copyrignt (c) 2010 Kriss 'nu7hatch' Kowalik
+Copyright (c) 2009-2010 BehindLogic
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -1,251 +1,271 @@
-# GMail for Ruby
-
-A Rubyesque interface to Google's GMail, with all the tools you'll need. Search, 
-read and send multipart emails, archive, mark as read/unread, delete emails, 
-and manage labels.
-
-It's based on Daniel Parker's ruby-gmail gem. This version has more friendy
-API, is well tested, better documented and have many other improvements.  
-
-## Author(s)
-
-* Kriss 'nu7hatch' Kowalik
-* [Daniel Parker of BehindLogic.com](http://github.com/dcparker)
-
-Extra thanks for specific feature contributions from:
-
-* [Nicolas Fouché](http://github.com/nfo)
-* [Stefano Bernardi](http://github.com/stefanobernardi)
-* [Benjamin Bock](http://github.com/bb)
-* [Arthur Chiu](http://github.com/achiu)
-* [Justin Perkins](http://github.com/justinperkins)
-* [Mikkel Malmberg](http://github.com/mikker)
-* [Julien Blanchard](http://github.com/julienXX)
-* [Federico Galassi](http://github.com/fgalassi)
-
-## Installation
-
-You can install it easy using rubygems:
-
-    sudo gem install gmail
-    
-Or install it manualy:
-
-    git clone git://github.com/nu7hatch/gmail.git
-    cd gmail
-    rake install
-
-To install gmail gem you have to met following requirements (with rubygems all 
-will be installed automatically):
-
-* mail
-* mime
-* smpt_tls (Ruby < 1.8.7)
-
-## Features
-
-* Search emails
-* Read emails (handles attachments)
-* Emails: label, archive, delete, mark as read/unread/spam, star
-* Manage labels
-* Create and send multipart email messages in plaintext and/or html, with inline 
-  images and attachments
-* Utilizes Gmail's IMAP & SMTP, MIME-type detection and parses and generates 
-  MIME properly.
-
-## Basic usage
-
-First of all require the `gmail` library.
-
-    require 'gmail'
-    
-### Authenticating gmail sessions
-
-This will you automatically log in to your account. 
-
-    gmail = Gmail.connect(username, password)
-    # play with your gmail...
-    gmail.logout
-
-If you pass a block, the session will be passed into the block, and the session 
-will be logged out after the block is executed.
-
-    Gmail.connect(username, password) do |gmail|
-      # play with your gmail...
-    end
-    
-Examples above are "quiet", it means that it will not raise any errors when 
-session couldn't be started (eg. because of connection error or invalid 
-authorization data). You can use connection which handles errors raising:
-
-    Gmail.connect!(username, password)
-    Gmail.connect!(username, password) {|gmail| ... play with gmail ... }
-    
-You can also check if you are logged in at any time:
-
-    Gmail.connect(username, password) do |gmail|
-      gmail.logged_in?
-    end
-
-### Counting and gathering emails
-    
-Get counts for messages in the inbox:
-
-    gmail.inbox.count
-    gmail.inbox.count(:unread)
-    gmail.inbox.count(:read)
-
-Count with some criteria:
-
-    gmail.inbox.count(:after => Date.parse("2010-02-20"), :before => Date.parse("2010-03-20"))
-    gmail.inbox.count(:on => Date.parse("2010-04-15"))
-    gmail.inbox.count(:from => "myfriend@gmail.com")
-    gmail.inbox.count(:to => "directlytome@gmail.com")
-
-Combine flags and options:
-
-    gmail.inbox.count(:unread, :from => "myboss@gmail.com")
-    
-Browsing labeled emails is similar to work with inbox.
-
-    gmail.mailbox('Urgent').count
-    
-Getting messages works the same way as counting: Remember that every message in a 
-conversation/thread will come as a separate message.
-
-    gmail.inbox.emails(:unread, :before => Date.parse("2010-04-20"), :from => "myboss@gmail.com")
-
-You can use also one of aliases:
-
-    gmail.inbox.find(...)
-    gmail.inbox.search(...)
-    gmail.inbox.mails(...)    
-    
-Also you can manipulate each message using block style:
-
-    gmail.inbox.find(:unread) do |email|
-      email.read!
-    end
-    
-### Working with emails!
-
-Any news older than 4-20, mark as read and archive it:
-
-    gmail.inbox.find(:before => Date.parse("2010-04-20"), :from => "news@nbcnews.com") do |email|
-      email.read! # can also unread!, spam! or star!
-      email.archive!
-    end
-
-Delete emails from X:
-
-    gmail.inbox.find(:from => "x-fiance@gmail.com").each do |email|
-      email.delete!
-    end
-
-Save all attachments in the "Faxes" label to a local folder:
-
-    folder = "/where/ever"
-    gmail.mailbox("Faxes").emails do |email|
-      if !email.message.attachments.empty?
-        email.message.save_attachments_to(folder)
-      end
-    end
-     
-You can use also `#label` method instead of `#mailbox`: 
-
-    gmail.label("Faxes").emails {|email| ... }
-
-Save just the first attachment from the newest unread email (assuming pdf):
-
-    email = gmail.inbox.find(:unread).first
-    email.attachments[0].save_to_file("/path/to/location")
-
-Add a label to a message:
-
-    email.label("Faxes")
-    
-Example above will raise error when you don't have the `Faxes` label. You can 
-avoid this using:
-
-    email.label!("Faxes") # The `Faxes` label will be automatically created now
-
-You can also move message to a label/mailbox:
- 
-    email.move_to("Faxes")
-    email.move_to!("NewLabel")
-    
-There is also few shortcuts to mark messages quickly:
-
-    email.read!
-    email.unread!
-    email.spam!
-    email.star!
-    email.unstar!
-
-### Managing labels
-
-With Gmail gem you can also manage your labels. You can get list of defined 
-labels:
-
-    gmail.labels.all
-
-Create new label:
-  
-    gmail.labels.new("Uregent")
-    gmail.labels.add("AnotherOne")
-    
-Remove labels:
-
-    gmail.labels.delete("Uregent")
-    
-Or check if given label exists:
-
-    gmail.labels.exists?("Uregent") # => false
-    gmail.labels.exists?("AnotherOne") # => true
-
-### Composing and sending emails
-
-Creating emails now uses the amazing [Mail](http://rubygems.org/gems/mail) rubygem. 
-See its [documentation here](http://github.com/mikel/mail). The Ruby Gmail will 
-automatically configure your Mail emails to be sent via your Gmail account's SMTP, 
-so they will be in your Gmail's "Sent" folder. Also, no need to specify the "From" 
-email either, because ruby-gmail will set it for you.
-
-    gmail.deliver do
-      to "email@example.com"
-      subject "Having fun in Puerto Rico!"
-      text_part do
-        body "Text of plaintext message."
-      end
-      html_part do
-        body "<p>Text of <em>html</em> message.</p>"
-      end
-      add_file "/path/to/some_image.jpg"
-    end
-
-Or, generate the message first and send it later
-
-    email = gmail.generate_message do
-      to "email@example.com"
-      subject "Having fun in Puerto Rico!"
-      body "Spent the day on the road..."
-    end
-    email.deliver! # or: gmail.deliver(email)
-
-## Note on Patches/Pull Requests
- 
-* Fork the project.
-* Make your feature addition or bug fix.
-* Add tests for it. This is important so I don't break it in a
-  future version unintentionally.
-* Commit, do not mess with rakefile, version, or history.
-  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
-* Send me a pull request. Bonus points for topic branches.
-
-## Copyright
-
-* Copyrignt (c) 2010 Kriss 'nu7hatch' Kowalik
-* Copyright (c) 2009-2010 BehindLogic
-
-See LICENSE for details.
-
+# GMail for Ruby
+
+A Rubyesque interface to Google's GMail, with all the tools you'll need. Search, 
+read and send multipart emails, archive, mark as read/unread, delete emails, 
+and manage labels.
+
+It's based on Daniel Parker's ruby-gmail gem. This version has more friendy
+API, is well tested, better documented and have many other improvements.  
+
+## Author(s)
+
+* Kriss 'nu7hatch' Kowalik
+* [Daniel Parker of BehindLogic.com](http://github.com/dcparker)
+
+Extra thanks for specific feature contributions from:
+
+* [abhishiv](http://github.com/abhishiv)
+* [Michael Young](http://github.com/myoung8)
+* [Nicolas Fouché](http://github.com/nfo)
+* [Stefano Bernardi](http://github.com/stefanobernardi)
+* [Benjamin Bock](http://github.com/bb)
+* [Arthur Chiu](http://github.com/achiu)
+* [Justin Perkins](http://github.com/justinperkins)
+* [Mikkel Malmberg](http://github.com/mikker)
+* [Julien Blanchard](http://github.com/julienXX)
+* [Federico Galassi](http://github.com/fgalassi)
+* [Alex Genco](http://github.com/alexgenco)
+* [Justin Grevich](http://github.com/jgrevich)
+
+## Installation
+
+You can install it easy using rubygems:
+
+    sudo gem install gmail
+    
+Or install it manually:
+
+    git clone git://github.com/nu7hatch/gmail.git
+    cd gmail
+    rake install
+
+gmail gem has the following dependencies (with Bundler all will be installed automatically):
+
+* mail (Ruby 1.8.7 users should lock mail gem version at 2.5.3)
+* mime
+* gmail_xoauth
+* smpt_tls (Ruby < 1.8.7)
+
+## Features
+
+* Search emails
+* Read emails (handles attachments)
+* Emails: label, archive, delete, mark as read/unread/spam, star
+* Manage labels
+* Create and send multipart email messages in plaintext and/or html, with inline 
+  images and attachments
+* Utilizes Gmail's IMAP & SMTP, MIME-type detection and parses and generates 
+  MIME properly.
+
+## Basic usage
+
+First of all require the `gmail` library.
+
+    require 'gmail'
+    
+### Authenticating gmail sessions
+
+This will you automatically log in to your account. 
+
+    gmail = Gmail.connect(username, password)
+    # play with your gmail...
+    gmail.logout
+
+If you pass a block, the session will be passed into the block, and the session 
+will be logged out after the block is executed.
+
+    Gmail.connect(username, password) do |gmail|
+      # play with your gmail...
+    end
+    
+Examples above are "quiet", it means that it will not raise any errors when 
+session couldn't be started (eg. because of connection error or invalid 
+authorization data). You can use connection which handles errors raising:
+
+    Gmail.connect!(username, password)
+    Gmail.connect!(username, password) {|gmail| ... play with gmail ... }
+    
+You can also check if you are logged in at any time:
+
+    Gmail.connect(username, password) do |gmail|
+      gmail.logged_in?
+    end
+
+### XOAuth authentication
+
+From v0.4.0 it's possible to authenticate with your Gmail account using XOAuth
+method. It's very simple:
+
+    gmail = Gmail.connect(:xoauth, "email@domain.com", 
+      :token           => 'TOKEN',
+      :secret          => 'TOKEN_SECRET',
+      :consumer_key    => 'CONSUMER_KEY',
+      :consumer_secret => 'CONSUMER_SECRET'
+    )
+    
+For more information check out the [gmail_xoauth](https://github.com/nfo/gmail_xoauth)
+gem from Nicolas Fouché.
+
+### Counting and gathering emails
+    
+Get counts for messages in the inbox:
+
+    gmail.inbox.count
+    gmail.inbox.count(:unread)
+    gmail.inbox.count(:read)
+
+Count with some criteria:
+
+    gmail.inbox.count(:after => Date.parse("2010-02-20"), :before => Date.parse("2010-03-20"))
+    gmail.inbox.count(:on => Date.parse("2010-04-15"))
+    gmail.inbox.count(:from => "myfriend@gmail.com")
+    gmail.inbox.count(:to => "directlytome@gmail.com")
+
+Combine flags and options:
+
+    gmail.inbox.count(:unread, :from => "myboss@gmail.com")
+    
+Browsing labeled emails is similar to work with inbox.
+
+    gmail.mailbox('Urgent').count
+    
+Getting messages works the same way as counting: Remember that every message in a 
+conversation/thread will come as a separate message.
+
+    gmail.inbox.emails(:unread, :before => Date.parse("2010-04-20"), :from => "myboss@gmail.com")
+
+You can use also one of aliases:
+
+    gmail.inbox.find(...)
+    gmail.inbox.search(...)
+    gmail.inbox.mails(...)    
+    
+Also you can manipulate each message using block style:
+
+    gmail.inbox.find(:unread).each do |email|
+      email.read!
+    end
+    
+### Working with emails!
+
+Any news older than 4-20, mark as read and archive it:
+
+    gmail.inbox.find(:before => Date.parse("2010-04-20"), :from => "news@nbcnews.com").each do |email|
+      email.read! # can also unread!, spam! or star!
+      email.archive!
+    end
+
+Delete emails from X:
+
+    gmail.inbox.find(:from => "x-fiance@gmail.com").each do |email|
+      email.delete!
+    end
+
+Save all attachments in the "Faxes" label to a local folder:
+
+    folder = "/where/ever"
+    gmail.mailbox("Faxes").emails.each do |email|
+      if !email.message.attachments.empty?
+        email.message.save_attachments_to(folder)
+      end
+    end
+     
+You can use also `#label` method instead of `#mailbox`: 
+
+    gmail.label("Faxes").emails {|email| ... }
+
+Save just the first attachment from the newest unread email (assuming pdf):
+
+    email = gmail.inbox.find(:unread).first
+    email.attachments[0].save_to_file("/path/to/location")
+
+Add a label to a message:
+
+    email.label("Faxes")
+    
+Example above will raise error when you don't have the `Faxes` label. You can 
+avoid this using:
+
+    email.label!("Faxes") # The `Faxes` label will be automatically created now
+
+You can also move message to a label/mailbox:
+ 
+    email.move_to("Faxes")
+    email.move_to!("NewLabel")
+    
+There is also few shortcuts to mark messages quickly:
+
+    email.read!
+    email.unread!
+    email.spam!
+    email.star!
+    email.unstar!
+
+### Managing labels
+
+With Gmail gem you can also manage your labels. You can get list of defined 
+labels:
+
+    gmail.labels.all
+
+Create new label:
+  
+    gmail.labels.new("Urgent")
+    gmail.labels.add("AnotherOne")
+    
+Remove labels:
+
+    gmail.labels.delete("Urgent")
+    
+Or check if given label exists:
+
+    gmail.labels.exists?("Urgent") # => false
+    gmail.labels.exists?("AnotherOne") # => true
+
+### Composing and sending emails
+
+Creating emails now uses the amazing [Mail](http://rubygems.org/gems/mail) rubygem. 
+See its [documentation here](http://github.com/mikel/mail). The Ruby Gmail will 
+automatically configure your Mail emails to be sent via your Gmail account's SMTP, 
+so they will be in your Gmail's "Sent" folder. Also, no need to specify the "From" 
+email either, because ruby-gmail will set it for you.
+
+    gmail.deliver do
+      to "email@example.com"
+      subject "Having fun in Puerto Rico!"
+      text_part do
+        body "Text of plaintext message."
+      end
+      html_part do
+        content_type 'text/html; charset=UTF-8'
+        body "<p>Text of <em>html</em> message.</p>"
+      end
+      add_file "/path/to/some_image.jpg"
+    end
+
+Or, compose the message first and send it later
+
+    email = gmail.compose do
+      to "email@example.com"
+      subject "Having fun in Puerto Rico!"
+      body "Spent the day on the road..."
+    end
+    email.deliver! # or: gmail.deliver(email)
+
+## Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+## Copyright
+
+* Copyrignt (c) 2010 Kriss 'nu7hatch' Kowalik
+* Copyright (c) 2009-2010 BehindLogic
+
+See LICENSE for details.
+