foca / tinder forked from collectiveidea/tinder

Tinder is an Ruby API for interfacing with Campfire, the 37Signals chat application.

This URL has Read+Write access

tinder /
name age
history
message
file .gitignore Thu Mar 06 23:34:14 -0800 2008 added .gitignore [brandon]
file CHANGELOG.txt Tue Dec 09 22:46:31 -0800 2008 Updating changelog. [queso]
file Manifest.txt Loading commit data...
file README.txt Sat Sep 06 08:10:03 -0700 2008 Added room access with guest URL [elliterate]
file Rakefile
file init.rb Tue Jan 23 16:20:48 -0800 2007 moved stuff around added contributions from Ter... [brandon]
directory lib/
directory site/ Thu Oct 23 12:08:20 -0700 2008 update rubyforge styles [brandon]
directory spec/ Tue Dec 09 22:24:51 -0800 2008 Finding rooms by name, even when full. With te... [queso]
directory test/ Fri Apr 25 14:32:16 -0700 2008 Added a get request to login method to check if... [jjones]
README.txt
= Tinder - get the Campfire started

Tinder is a library for interfacing with Campfire, the chat application from 37Signals. Unlike Marshmallow, it is 
designed to be a full-featured API (since 37Signals doesn't provide a real one), allowing you to programatically manage 
and speak/listen in chat rooms.

== Usage

  campfire = Campfire.new 'mysubdomain'
  campfire.login 'myemail@example.com', 'mypassword'

  room = campfire.create_room 'New Room', 'My new campfire room to test tinder'
  room.rename 'New Room Name'
  room.speak 'Hello world!'
  room.paste "my pasted\ncode"
  room.destroy

  room = campfire.find_room_by_guest_hash 'abc123', 'John Doe'
  room.speak 'Hello world!'
  
  See the RDoc for more details.

== Requirements

* Active Support
  gem install activesupport
* Hpricot
  gem install hpricot
  
== Installation

Tinder can be installed as a gem or a Rails plugin:

  gem install tinder
  
  script/plugin install http://source.collectiveidea.com/public/tinder/trunk
  
== Development

The source for Tinder is available at http://source.collectiveidea.com/public/tinder/trunk. Development can be followed 
at http://opensoul.org/tags/tinder.  Contributions are welcome!

== ToDo

* Tests! (unit and remote)
* Marshmallow-style integration scripts for exception notification and continuous integration