toolmantim / teapot
watch download tarball
public
Forks0Right
Watchers6Right
Description: Rack middleware to help you, as a teapot, comply with HTCPCP/1.0: the Hyper Text Coffee Pot Control Protocol
Homepage:
Clone URL: git://github.com/toolmantim/teapot.git
teapot /
name age
history
message
file .gitignore Thu Jan 15 05:19:56 -0800 2009 Initial commit [toolmantim]
file Changelog.rdoc Thu Jan 15 06:08:13 -0800 2009 Fixed case issues in the gemspec so it actually... [toolmantim]
file License Thu Jan 15 05:19:56 -0800 2009 Initial commit [toolmantim]
file Rakefile Thu Jan 15 05:19:56 -0800 2009 Initial commit [toolmantim]
file Readme.rdoc Thu Jan 15 05:23:42 -0800 2009 Update install instructions to use github's gem... [toolmantim]
directory lib/ Thu Jan 15 06:08:13 -0800 2009 Fixed case issues in the gemspec so it actually... [toolmantim]
file teapot.gemspec Thu Jan 15 06:08:13 -0800 2009 Fixed case issues in the gemspec so it actually... [toolmantim]
directory test/ Thu Jan 15 05:19:56 -0800 2009 Initial commit [toolmantim]
Readme.rdoc

teapot

It’s imperative to respond correctly to coffee machine BREW requests when you are, in fact, a teapot. This piece of Rack middleware will ensure you comply with HTCPCP/1.0: the Hyper Text Coffee Pot Control Protocol.

For more information see www.ietf.org/rfc/rfc2324.txt

INSTALL

  sudo gem install toolmantim-teapot --source http://gems.github.com

USAGE

Simply require and use from your rackup file (e.g. config.ru): 

  require 'rubygems'
  require 'teapot'

  use Teapot

Your Rack application will now serve English Breakfast and respond with a 418 I’m a teapot if it receives any BREW or application/coffee-pot-command requests.

Tea connoisseurs may wish to refer to Teapot for a finer selection of tea.

BREWING

You can perform a BREW request using curl’s request method flag -X: 

  curl -i -X BREW myrackapp.com